Fix final review items: uv sync --dev, reference table, polish

- uv sync --dev → --group dev in docs workflow (consistency with CI)
- Add 07-common-mistakes.md to SKILL.md reference table
- Add fallback cross-reference in scaffold __init__.py example
- Fix warnings.warn() closing paren indentation in lifecycle

Round 3 review: 9.4/10, zero critical issues, ready to ship.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: Naareman

SKILL.md

@@ -31,6 +31,7 @@ relevant reference file from `references/`:
 | Setting up or writing documentation | [references/04-docs.md](references/04-docs.md) |
 | Adding deprecations or managing versions | [references/05-lifecycle.md](references/05-lifecycle.md) |
 | Releasing to PyPI or setting up CI/CD | [references/06-release.md](references/06-release.md) |
+| Auditing for common anti-patterns | [references/07-common-mistakes.md](references/07-common-mistakes.md) |
 
 Read only what's relevant to the current task. Don't load everything at once.
 

references/01-scaffold.md

@@ -136,7 +136,7 @@ __all__ = [
     "ValidationError",
 ]
 
-__version__ = version("my-package")
+__version__ = version("my-package")  # add PackageNotFoundError fallback if needed (see 07-common-mistakes.md)
 ```
 
 R equivalent: the `NAMESPACE` file — explicit exports only.

references/05-lifecycle.md

@@ -49,7 +49,7 @@ def read_data(path):  # OLD name
         "'read_data()' is deprecated, use 'read_csv()' instead.",
         DeprecationWarning,
         stacklevel=2,  # points to the caller, not this function
-        )
+    )
     return read_csv(path)
 ```
 

references/06-release.md

@@ -165,7 +165,7 @@ jobs:
         uses: astral-sh/setup-uv@v4
 
       - name: Install dependencies
-        run: uv sync --dev
+        run: uv sync --group dev
 
       - name: Deploy docs
         run: uv run mkdocs gh-deploy --force