Files
Claude-Code-Workflow/.claude/skills/team-tech-debt/role-specs/scanner.md
catlog22 26bda9c634 feat: Add coordinator commands and role specifications for UI design team
- Implemented the 'monitor' command for coordinator role to handle monitoring events, task completion, and pipeline management.
- Created role specifications for the coordinator, detailing responsibilities, command execution protocols, and session management.
- Added role specifications for the analyst, discussant, explorer, and synthesizer in the ultra-analyze skill, defining their context loading, analysis, and synthesis processes.
2026-03-03 23:35:41 +08:00

3.2 KiB

prefix, inner_loop, subagents, message_types
prefix inner_loop subagents message_types
TDSCAN false
success error info
scan_complete error debt_items_found

Tech Debt Scanner

Multi-dimension tech debt scanner. Scan codebase across 5 dimensions (code, architecture, testing, dependency, documentation), produce structured debt inventory with severity rankings.

Phase 2: Context & Environment Detection

Input Source Required
Scan scope task description (regex: scope:\s*(.+)) No (default: **/*)
Session path task description (regex: session:\s*(.+)) Yes
.msg/meta.json /.msg/meta.json Yes
  1. Extract session path and scan scope from task description
  2. Read .msg/meta.json for team context
  3. Detect project type and framework:
Signal File Project Type
package.json + React/Vue/Angular Frontend Node
package.json + Express/Fastify/NestJS Backend Node
pyproject.toml / requirements.txt Python
go.mod Go
No detection Generic
  1. Determine scan dimensions (default: code, architecture, testing, dependency, documentation)
  2. Detect perspectives from task description:
Condition Perspective
security|auth|inject|xss security
performance|speed|optimize performance
quality|clean|maintain|debt code-quality
architect|pattern|structure architecture
Default code-quality + architecture
  1. Assess complexity:
Score Complexity Strategy
>= 4 High Triple Fan-out: subagent explore + CLI 5 dimensions + multi-perspective Gemini
2-3 Medium Dual Fan-out: subagent explore + CLI 3 dimensions
0-1 Low Inline: ACE search + Grep

Phase 3: Multi-Dimension Scan

Low Complexity (inline):

  • Use mcp__ace-tool__search_context for code smells, TODO/FIXME, deprecated APIs, complex functions, dead code, missing tests
  • Classify findings into dimensions

Medium/High Complexity (Fan-out):

  • Fan-out A: Subagent exploration (structure, patterns, dependencies angles) via cli-explore-agent
  • Fan-out B: CLI dimension analysis (parallel gemini per dimension -- code, architecture, testing, dependency, documentation)
  • Fan-out C (High only): Multi-perspective Gemini analysis (security, performance, code-quality, architecture)
  • Fan-in: Merge results, cross-deduplicate by file:line, boost severity for multi-source findings

Standardize each finding:

Field Description
id TD-NNN (sequential)
dimension code, architecture, testing, dependency, documentation
severity critical, high, medium, low
file File path
line Line number
description Issue description
suggestion Fix suggestion
estimated_effort small, medium, large, unknown

Phase 4: Aggregate & Save

  1. Deduplicate findings across Fan-out layers (file:line key), merge cross-references
  2. Sort by severity (cross-referenced items boosted)
  3. Write <session>/scan/debt-inventory.json with scan_date, dimensions, total_items, by_dimension, by_severity, items
  4. Update .msg/meta.json with debt_inventory array and debt_score_before count