khaihuynhvn/mcp-server_ai-interaction · Archived
project-scanner
Codebase analysis tool for quality-first editing. Scan before edit to understand relationships, patterns, and impact.
First seen Jan 24, 2026
Installation
$
npx skills add khaihuynhvn/mcp-server_ai-interaction --skill project-scanner
SKILL.md
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àycallChain: Multi-level call pathinheritance: Parent/child classesdeadCode: Unused methodssummary.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
