diff --git a/lib/devtools/src/crewai_devtools/docs_check.py b/lib/devtools/src/crewai_devtools/docs_check.py
index 8a4432fb5..a58f2c5c8 100644
--- a/lib/devtools/src/crewai_devtools/docs_check.py
+++ b/lib/devtools/src/crewai_devtools/docs_check.py
@@ -34,9 +34,6 @@ _LANGUAGE_NAMES: Final[dict[DocLang, str]] = {
 }
 
 
-# --- Structured output models ---
-
-
 class DocAction(BaseModel):
     """A single documentation action to take."""
 
@@ -66,8 +63,6 @@ class DocsAnalysis(BaseModel):
     )
 
 
-# --- Prompts ---
-
 _ANALYZE_SYSTEM: Final[str] = """\
 You are a documentation analyst for the CrewAI open-source framework.
 
diff --git a/lib/devtools/tests/test_toml_updates.py b/lib/devtools/tests/test_toml_updates.py
index a13eb0f96..80b18648d 100644
--- a/lib/devtools/tests/test_toml_updates.py
+++ b/lib/devtools/tests/test_toml_updates.py
@@ -13,9 +13,6 @@ from crewai_devtools.cli import (
 )
 
 
-# --- update_pyproject_version ---
-
-
 class TestUpdatePyprojectVersion:
     def test_updates_version(self, tmp_path: Path) -> None:
         pyproject = tmp_path / "pyproject.toml"
@@ -82,9 +79,6 @@ class TestUpdatePyprojectVersion:
         assert 'description = "A package"' in result
 
 
-# --- _pin_crewai_deps ---
-
-
 class TestPinCrewaiDeps:
     def test_pins_exact_version(self) -> None:
         content = dedent("""\
@@ -195,9 +189,6 @@ class TestPinCrewaiDeps:
         assert "==" not in result
 
 
-# --- _repin_crewai_install ---
-
-
 class TestRepinCrewaiInstall:
     def test_repins_a2a_extra(self) -> None:
         result = _repin_crewai_install('uv pip install "crewai[a2a]==1.14.0"', "2.0.0")
@@ -228,9 +219,6 @@ class TestRepinCrewaiInstall:
         assert _repin_crewai_install(cmd, "2.0.0") == cmd
 
 
-# --- update_pyproject_dependencies ---
-
-
 class TestUpdatePyprojectDependencies:
     def test_default_packages_cover_all_workspace_members(self) -> None:
         """Every workspace member must be in the default rewrite list.
@@ -320,9 +308,6 @@ class TestUpdatePyprojectDependencies:
         assert '"crewai-core==2.0.0"' in result
 
 
-# --- update_template_dependencies ---
-
-
 class TestUpdateTemplateDependencies:
     def test_updates_jinja_template(self, tmp_path: Path) -> None:
         """Template pyproject.toml files with Jinja placeholders should not break."""