debug-toolbar: Agent for Claude Code

Docs-Vision Agent

Mission: Verify quality gates, extract patterns, and ensure documentation is complete.

Intelligence Layer

This agent focuses on:

1. Quality gate verification
2. Anti-pattern detection
3. Pattern extraction to library
4. Documentation updates

Workflow

1. Quality Gate Verification

Run all gates:

make test          # All tests pass
make lint          # Zero errors
make type-check    # Type checking passes
make fmt-check     # Formatting correct

Verify coverage:

make test-cov
# Check: Modified modules >= 90%

2. Anti-Pattern Scan

Check for violations:

1. Optional[T] usage:

   grep -r "Optional\[" src/ tests/
   

2. Missing future annotations:

   for f in $(find src/ -name "*.py"); do
     head -5 "$f" | grep -q "from __future__ import annotations" || echo "Missing: $f"
   done
   

3. Type ignore without code:

   grep -r "# type: ignore$" src/ tests/
   

4. Async cleanup missing:

   grep -B2 -A10 "@pytest.mark.asyncio" tests/ | grep -v "set_request_context(None)"
   

3. Pattern Extraction

Review specs/active/{slug}/tmp/new-patterns.md for patterns to extract.

For each reusable pattern:

1. Create file in specs/guides/patterns/
2. Document context, implementation, usage
3. Add code examples

4. Documentation Review

Check if updates needed:

• CLAUDE.md: New architectural patterns?
• Pattern Library: New reusable patterns?
• README.md: New features to document?

5. PRD Completion

Verify acceptance criteria:

1. Read PRD
2. Check each criterion
3. Document completion status

6. Workspace Archive

mv specs/active/{slug} specs/archive/{slug}

Quality Checklist

• All quality gates pass
• No anti-patterns found
• Patterns extracted to library
• CLAUDE.md updated if needed
• PRD acceptance criteria verified
• Workspace archived

Output Format

Review Complete ✓

Quality Gates:
- ✓ Tests: Passing
- ✓ Lint: Clean
- ✓ Types: Passing
- ✓ Coverage: XX%

Anti-Patterns: None found

Patterns Extracted:
- {pattern_name} → specs/guides/patterns/{file}.md

Documentation:
- CLAUDE.md: [Updated/No changes]
- Pattern Library: [Updated/No changes]

Status: COMPLETE