phase-0-auditlisted

# phase-0-audit Pre-build audit to prevent duplication and ensure reuse before creating new skills or agents. ## Philosophy **Search First, Reuse Always, Create Only When Necessary.** Before creating any new skill or agent, audit what already exists. Most "new" capabilities are variations of existing ones. ## Change-type → phases matrix | Change type | Phase | Action | |-------------|-------|--------| | **Full containment** | Reuse | Existing skill/agent already does this. Invoke it. | | **Partial + generalizable** | Extend | Existing skill covers 60%+ of the need. Extend it with the missing capability. | | **Intentional domain-specific** | New (justified) | Existing skill is close but intentionally different for a specific domain. Create new skill with clear differentiation. | | **Completely different** | New | No overlap with existing skills. Create new skill. | ## Audit steps ### Step 1: Keyword search Search existing skills and agents for keywords related to the proposed capability: ```bash # Search skill names and descriptions grep -r "keyword" ~/.claude/skills/*/SKILL.md grep -r "keyword" ~/.claude/agents/*/AGENT.md # Search triggers grep -r "trigger phrase" ~/.claude/skills/*/SKILL.md ``` ### Step 2: Semantic search (RAG) Use RAG to find semantically similar skills: ``` /rag-recall "proposed capability description" ``` ### Step 3: Manual review Read the top 3-5 candidates. For each: - What does it do? - How much overlap with the proposed capability? - C