Project Scanner Workflow Skill

Project Scanner Workflow

Scanner Location

C:\Users\BLogic\.cursor\user-scripts\project-scanner\

Commands

# Full scan
npx tsx scan.ts --path "<project-src-path>" --framework angular

# Query specific
npx tsx scan.ts --path "<project-src-path>" --framework angular --query "ClassName"

Output Files

| File | When | |------|------| | output.json | Full scan | | output-query.json | Query mode |

When to Scan

| Situation | Action | |-----------|--------| | First time với project | Full scan | | Edit shared service/utility | Query class | | Change method signature | Query class → check calledBy | | Delete/rename | Query → check all references | | Create new code | Query similar existing |

When NOT to Scan

Simple typo fix
Private method internal change
New isolated code (0 callers)
Already have context
Comment/doc updates

Quality Gates (MANDATORY)

| Trigger | MUST Check | |---------|------------| | Change method signature | calledBy | | Class extends another | inheritance | | Shared service | summary.mostUsedServices | | Delete/rename | All references |

Reading Output (Token-Efficient)

Full scan → Read ONLY summary section first
Query → Read calledBy + inheritance

Key sections:

calledBy: Ai gọi method này
callChain: Multi-level call path
inheritance: Parent/child classes
deadCode: Unused methods
summary.mostUsedServices: High-impact services

Pattern-First Principle

Before CREATE → Query similar existing code
Before EDIT → Check existing patterns
Follow 100% existing style

Example Workflow

User: "Sửa SalonService.list()"

1. Query SalonService
2. Read calledBy → Biết SalonsComponent gọi
3. Check signature → Không đổi thì OK
4. Edit safely

Integration

Scanner được reference từ:

angular-coding/SKILL.md → Pre-edit analysis

Agent Skills: Project Scanner Workflow

Install this agent skill to your local

Skill Files