project-scanner

Original：🇺🇸 English
Translated

Codebase analysis tool for quality-first editing. Scan before edit to understand relationships, patterns, and impact.

1installs
Sourcekhaihuynhvn/mcp-server_ai-interaction
Added on

NPX Install

npx skill4agent add khaihuynhvn/mcp-server_ai-interaction project-scanner

Tags

Translated version includes tags in frontmatter
codebase-analysisproject-scannercode-qualityangular-developmentpre-edit-check

SKILL.md Content

View Translation Comparison →

Project Scanner Workflow

Scanner Location

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

Commands

bash
# 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

FileWhen
output.json
Full scan
output-query.json
Query mode

When to Scan

SituationAction
First time với projectFull scan
Edit shared service/utilityQuery class
Change method signatureQuery class → check calledBy
Delete/renameQuery → check all references
Create new codeQuery 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)

TriggerMUST Check
Change method signature
calledBy
Class extends another
inheritance
Shared service
summary.mostUsedServices
Delete/renameAll 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