[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7E5D7RTWVRT2R8QJ9AWWT6A":3,"skill-same:01M7E5D7RTWVRT2R8QJ9AWWT6A":49},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":28,"commitSha":29,"skillDirectory":30,"forksCount":31,"repositoryHtmlUrl":32,"repositoryHomepageUrl":6,"ownerHtmlUrl":33,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":34,"install":35,"resources":48},"01M7E5D7RTWVRT2R8QJ9AWWT6A","speckit-ext-cleanup",null,"Clean up completed feature spec directories with intelligent content review","stefanwalther\u002Fghn","stefanwalther","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F669728?v=4","01M7E59BWN972ZZWN6SJ3RBZS8","Stefan Walther","01M7E59BX6XCFE72NWR5BN5M78",1,"MIT","https:\u002F\u002Fgithub.com\u002Fstefanwalther\u002Fghn\u002Fblob\u002Fmain\u002F.specify\u002Fextensions\u002Fext\u002F.specify-dev\u002Fagent-commands\u002Fclaude\u002Fspeckit-ext-cleanup\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: speckit-ext-cleanup\ndescription: Clean up completed feature spec directories with intelligent content review\ncompatibility: Requires spec-kit project structure with .specify\u002F directory\nmetadata:\n  author: github-spec-kit\n  source: ext:commands\u002Fspeckit.ext.cleanup.md\n---\n\n## User Input\n\n```text\n$ARGUMENTS\n```\n\nYou **MUST** consider the user input before proceeding (if not empty).\n\n## Outline\n\nThis extension performs intelligent cleanup of completed feature specification directories. Unlike blind pattern matching, it **reviews file contents** before deletion to ensure truly transient files are removed while preserving any unique information.\n\n**Core Principle**: Pattern-guided content review - patterns suggest candidates, LLM validates safety.\n\n### Execution Steps\n\n1. **Parse Arguments**\n\nParse `$ARGUMENTS` to extract:\n- Target directory (required, first argument)\n- Flags: `--dry-run` (preview mode), `--force` (skip git warning)\n- If `--help` or no arguments: Display usage and exit\n\n2. **Workspace CHANGELOG Check** (if exists)\n\nCheck if workspace has CHANGELOG.md in repository root:\n\na. **Detect Workspace CHANGELOG**:\n   - Use Glob to check for `\u003Crepo-root>\u002FCHANGELOG.md`\n   - If found: Suggest updating it with this feature's completion\n   - If not found: Continue (workspace CHANGELOG optional)\n\nb. **Suggest Entry** (if CHANGELOG exists):\n   - Read feature spec.md summary\n   - Suggest CHANGELOG entry format:\n     ```\n     ## [Unreleased] or [Version]\n     ### Added\n     - [Feature name from spec.md]\n     ```\n   - Prompt: \"Update workspace CHANGELOG.md with this feature? [Y\u002Fn]\"\n   - If yes: Provide entry text, user adds it manually (or use Edit tool)\n   - If no: Continue to cleanup\n\n3. **Safety Checks**\n\nBefore file analysis:\n\na. **Git Status Check** (unless --force):\n   - Use Bash tool: `git status --porcelain \u003Ctarget-dir>`\n   - If uncommitted changes found: Display warning with file list\n   - Show recommendation: \"Run 'git add . && git commit' first\"\n   - Continue (don't block, just warn)\n\nb. **Tasks Completion Check**:\n   - Read `\u003Ctarget-dir>\u002Ftasks.md` using Read tool\n   - Count unchecked tasks: `grep -c '^\\- \\[ \\]'`\n   - If unchecked tasks found: Warn \"Feature appears incomplete (X unchecked tasks)\"\n   - Continue (don't block, just warn)\n\nc. **Directory Validation**:\n   - Use Glob to check for spec.md, plan.md, or tasks.md\n   - If none found: Warn \"No spec files found\"\n   - Continue if at least one exists\n\n3. **File Discovery and Pattern Matching**\n\nUse Glob tool to find all files in target directory:\n```\nGlob: \u003Ctarget-dir>\u002F*\n```\n\nCategorize each file by pattern:\n\n**KEEP Patterns** (Always preserve):\n- Core: `spec.md`, `plan.md`, `tasks.md`\n- Learning: `COMPLETION.md`, `HANDOVER.md`, `research.md`, `data-model.md`, `quickstart.md`, `CHANGELOG.md`\n- Active work: `BACKLOG-*.md`\n- Directories: `checklists\u002F`, `contracts\u002F`, `decisions\u002F`\n\n**DELETE Pattern Candidates** (Review content before deletion):\n- Session noise: `SESSION*.md`, `*-NEXT-SESSION*.md`, `STATUS-*.md`\n- Phase tracking: `COMPLETION-PHASE*.md`, `HANDOVER-PHASE*.md`, `*-COMPLETE.md`, `GREEN-STATUS.md`, `REBASE-COMPLETE.md`\n- PR artifacts: `PR_*.md`, `PR-*.md`, `PRs-CREATED.md`\n- Drafts: `*-draft-*.md`, `archive\u002F` directories\n\n**Unknown** (Review and prompt user):\n- Any file not matching KEEP or DELETE patterns\n\n4. **Intelligent Content Review for DELETE Candidates (Parallel)**\n\n**Threshold Check**: If DELETE candidate count ≤ 2, process sequentially (skip parallelization).\n\nFor 3+ DELETE candidate files, analyze in parallel using sub-agents:\n\na. **Group files into batches** of 3-5 files each\n\nb. **Launch parallel sub-agents** for each batch:\n\n**CRITICAL**: Launch these as PARALLEL Task calls in a single tool call block.\n\nFor each batch, use Task tool with:\n- subagent_type: \"general-purpose\"\n- description: \"Analyze files for cleanup\"\n- prompt: |\n    You are analyzing files for cleanup decisions.\n\n    ## Files to Analyze\n    {list of 3-5 file paths from this batch}\n\n    ## Instructions\n    For each file:\n    1. Read the file using the Read tool\n    2. Analyze content for:\n       - Is it truly transient? (handover, status snapshot, draft)\n       - Does it contain unique information not in other files?\n       - Is it superseded by other documents?\n       - Are there red flags? (words like \"IMPORTANT\", \"CRITICAL\", \"ARCHITECTURE\", \"DECISION\")\n    3. Return decision: SAFE_TO_DELETE, KEEP, or UNCERTAIN\n\n    ## Output Format (JSON)\n    Return your findings as JSON:\n    ```json\n    {\n      \"files\": [\n        {\n          \"path\": \"filename.md\",\n          \"pattern\": \"Why it matched DELETE pattern\",\n          \"content_summary\": \"1-2 sentence summary\",\n          \"unique_info\": true\u002Ffalse,\n          \"red_flags\": [\"list of any red flag words found\"],\n          \"decision\": \"SAFE_TO_DELETE|KEEP|UNCERTAIN\",\n          \"reasoning\": \"Brief explanation of why this decision is safe\"\n        }\n      ]\n    }\n    ```\n\nc. **Wait for all agents to complete** before proceeding.\n\nd. **Aggregate results**:\n   - Parse JSON from each agent\n   - Merge all file decisions into unified list\n   - Group by decision: SAFE_TO_DELETE, KEEP, UNCERTAIN\n\ne. **Error handling**:\n   - If an agent fails: Mark its files as UNCERTAIN (user decides)\n   - If all agents fail: Fall back to sequential processing with warning\n   - Report errors clearly: \"Agent failed for batch N. Files marked for manual review.\"\n\n**Display progress** during execution:\n```\nAnalyzing files in parallel (batch 1 of 3)...\nAnalyzing files in parallel (batch 2 of 3)...\nAnalyzing files in parallel (batch 3 of 3)...\nAll batches complete. Aggregating results...\n```\n\n**Provide reasoning** for each decision with format:\n```\n[Filename]\n  Pattern: [Why it matched DELETE pattern]\n  Content: [1-2 sentence summary of what's in the file]\n  Unique info: [Yes\u002FNo - is there information not elsewhere?]\n  Decision: [DELETE\u002FKEEP\u002FUNCERTAIN]\n  Reasoning: [Why this decision is safe]\n```\n\n**Example**: `SESSION1.md` → Pattern match (SESSION*) → Read content → \"Generic handover duplicated in COMPLETION.md\" → SAFE TO DELETE\n\n5. **Display Categorization with Reasoning**\n\nShow complete analysis grouped by decision with brief reasoning:\n\n```\nWILL KEEP (X): spec.md, plan.md, tasks.md, COMPLETION.md, SESSION-ARCH.md*\n  *Contains unique decisions, suggest moving to decisions\u002F\n\nWILL DELETE (Y): SESSION1.md (duplicated), PR_123.md (in GitHub), STATUS.md (superseded)\n\nUNCERTAIN (Z): custom-notes.md [K\u002FD?]\n```\n\n6. **User Confirmation**\n\n- In dry-run mode: Skip to summary (no confirmation needed)\n- In normal mode: Single confirmation for all deletions\n  ```\n  Proceed with deletion of Y files? [y\u002FN]:\n  ```\n- If user confirms: Continue to deletion\n- If user cancels: Exit with \"Cleanup cancelled\"\n\n7. **Execute Deletion** (if not dry-run and confirmed)\n\nUse Bash tool to delete validated files:\n```bash\nrm -rf \u003Cfile1> \u003Cfile2> ...\n```\n\nTrack:\n- Files successfully deleted\n- Files that failed to delete (permission errors, etc.)\n- Report errors clearly\n\n8. **Link Maintenance**\n\nAfter deletion, fix broken markdown links in kept files:\n\na. **Identify deleted filenames**\nb. **For each kept .md file**:\n   - Read file using Read tool\n   - Search for links to deleted files: `[text](deleted-file.md)`\n   - If found: Use Edit tool to remove link (convert to plain text)\n   - Track how many links fixed\n\n9. **Summary Report**\n\nDisplay final summary:\n```\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n📊 CLEANUP SUMMARY\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\nFiles kept:      X\nFiles deleted:   Y (after content review)\nLinks fixed:     Z\nErrors:          N (if any)\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n\nContent Review Highlights:\n- X files validated as safe to delete\n- Y files kept due to unique information\n- Z files moved user decision\n\nNext: git add . && git commit -m \"Clean up spec directory\"\n```\n\n### Batch Mode\n\nIf target contains `###-*\u002F` subdirectories: process all with content review, consolidate display, single confirmation.\n\n## File Categorization Patterns\n\n### KEEP (Always preserve)\n\n**Core Blueprint**:\n- `spec.md` - Feature specification\n- `plan.md` - Implementation plan\n- `tasks.md` - Task breakdown\n\n**Valuable Learnings**:\n- `COMPLETION.md` - Final summary and learnings\n- `HANDOVER.md` - Operational knowledge\n- `research.md` - Discovery and constraints\n- `data-model.md` - Schema documentation\n- `quickstart.md` - Usage guide\n- `CHANGELOG.md` - Version history (required by constitution)\n\n**Active Work**:\n- `BACKLOG-*.md` - Deferred work items\n\n**Structural Directories**:\n- `checklists\u002F` - Requirements validation\n- `contracts\u002F` - API\u002Fschema contracts\n- `decisions\u002F` - Architectural decision records\n\n### DELETE Candidates (Review content before deletion)\n\n**Session Noise**:\n- `SESSION*.md` - Session handovers (usually transient)\n- `*-NEXT-SESSION*.md` - Session prompts\n- `STATUS-*.md` - Point-in-time status snapshots\n\n**Phase Tracking**:\n- `COMPLETION-PHASE*.md` - Interim phase completions\n- `HANDOVER-PHASE*.md` - Phase handovers\n- `*-COMPLETE.md` - Completion markers\n- `GREEN-STATUS.md`, `REBASE-COMPLETE.md` - One-time events\n\n**PR Artifacts**:\n- `PR_*.md`, `PR-*.md` - PR descriptions (already in GitHub)\n- `PRs-CREATED.md` - Transient tracking\n\n**Superseded Drafts**:\n- `archive\u002F` - Archived old versions\n- `*-draft-*.md` - Draft versions\n\n### Unknown Files\n\nAny file not matching KEEP or DELETE patterns:\n- Read content\n- Analyze purpose and value\n- Prompt user for decision\n\n## Usage\n\n```bash\n\u002Fspeckit.ext.cleanup specs\u002F001-feature\u002F              # Single directory\n\u002Fspeckit.ext.cleanup specs\u002F001-feature\u002F --dry-run    # Preview first\n\u002Fspeckit.ext.cleanup specs\u002F                          # Batch mode\n\u002Fspeckit.ext.cleanup specs\u002F001-feature\u002F --force      # Skip git warning\n```\n\n## Notes\n\n**Content Review**: Never blindly delete by filename. Read file contents and validate: truly transient, information captured elsewhere, no unique decisions\u002Fcontext.\n\n**Red flags** (KEEP): Words like IMPORTANT\u002FCRITICAL\u002FARCHITECTURE\u002FDECISION, unique technical details, detailed rationale.\n\n**Safe to DELETE**: Generic handovers, status snapshots, duplicate info, superseded versions.\n\n**Workflow**: Complete tasks → **Update workspace CHANGELOG** (if exists) → Commit → Run cleanup → Confirm → Commit cleaned spec\n\n**CHANGELOG Integration**: Cleanup detects workspace CHANGELOG.md and prompts to add feature entry before cleanup. Ensures shipped features are documented.\n\n**Patterns**: Case-sensitive glob (SESSION*.md matches SESSION1.md, not session.md). Patterns suggest, content validates.\n\n**Dry-run**: Shows full content review without executing deletions.\n\n**Errors**: Report but continue with other files.","## User Input\n\n```text\n$ARGUMENTS\n```\n\nYou **MUST** consider the user input before proceeding (if not empty).\n\n## Outline\n\nThis extension performs intelligent cleanup of completed feature specification directories. Unlike blind pattern matching, it **reviews file contents** before deletion to ensure truly transient files are removed while preserving any unique information.\n\n**Core Principle**: Pattern-guided content review - patterns suggest candidates, LLM validates safety.\n\n### Execution Steps\n\n1. **Parse Arguments**\n\nParse `$ARGUMENTS` to extract:\n- Target directory (required, first argument)\n- Flags: `--dry-run` (preview mode), `--force` (skip git warning)\n- If `--help` or no arguments: Display usage and exit\n\n2. **Workspace CHANGELOG Check** (if exists)\n\nCheck if workspace has CHANGELOG.md in repository root:\n\na. **Detect Workspace CHANGELOG**:\n   - Use Glob to check for `\u003Crepo-root>\u002FCHANGELOG.md`\n   - If found: Suggest updating it with this feature's completion\n   - If not found: Continue (workspace CHANGELOG optional)\n\nb. **Suggest Entry** (if CHANGELOG exists):\n   - Read feature spec.md summary\n   - Suggest CHANGELOG entry format:\n     ```\n     ## [Unreleased] or [Version]\n     ### Added\n     - [Feature name from spec.md]\n     ```\n   - Prompt: \"Update workspace CHANGELOG.md with this feature? [Y\u002Fn]\"\n   - If yes: Provide entry text, user adds it manually (or use Edit tool)\n   - If no: Continue to cleanup\n\n3. **Safety Checks**\n\nBefore file analysis:\n\na. **Git Status Check** (unless --force):\n   - Use Bash tool: `git status --porcelain \u003Ctarget-dir>`\n   - If uncommitted changes found: Display warning with file list\n   - Show recommendation: \"Run 'git add . && git commit' first\"\n   - Continue (don't block, just warn)\n\nb. **Tasks Completion Check**:\n   - Read `\u003Ctarget-dir>\u002Ftasks.md` using Read tool\n   - Count unchecked tasks: `grep -c '^\\- \\[ \\]'`\n   - If unchecked tasks found: Warn \"Feature appears incomplete (X unchecked tasks)\"\n   - Continue (don't block, just warn)\n\nc. **Directory Validation**:\n   - Use Glob to check for spec.md, plan.md, or tasks.md\n   - If none found: Warn \"No spec files found\"\n   - Continue if at least one exists\n\n3. **File Discovery and Pattern Matching**\n\nUse Glob tool to find all files in target directory:\n```\nGlob: \u003Ctarget-dir>\u002F*\n```\n\nCategorize each file by pattern:\n\n**KEEP Patterns** (Always preserve):\n- Core: `spec.md`, `plan.md`, `tasks.md`\n- Learning: `COMPLETION.md`, `HANDOVER.md`, `research.md`, `data-model.md`, `quickstart.md`, `CHANGELOG.md`\n- Active work: `BACKLOG-*.md`\n- Directories: `checklists\u002F`, `contracts\u002F`, `decisions\u002F`\n\n**DELETE Pattern Candidates** (Review content before deletion):\n- Session noise: `SESSION*.md`, `*-NEXT-SESSION*.md`, `STATUS-*.md`\n- Phase tracking: `COMPLETION-PHASE*.md`, `HANDOVER-PHASE*.md`, `*-COMPLETE.md`, `GREEN-STATUS.md`, `REBASE-COMPLETE.md`\n- PR artifacts: `PR_*.md`, `PR-*.md`, `PRs-CREATED.md`\n- Drafts: `*-draft-*.md`, `archive\u002F` directories\n\n**Unknown** (Review and prompt user):\n- Any file not matching KEEP or DELETE patterns\n\n4. **Intelligent Content Review for DELETE Candidates (Parallel)**\n\n**Threshold Check**: If DELETE candidate count ≤ 2, process sequentially (skip parallelization).\n\nFor 3+ DELETE candidate files, analyze in parallel using sub-agents:\n\na. **Group files into batches** of 3-5 files each\n\nb. **Launch parallel sub-agents** for each batch:\n\n**CRITICAL**: Launch these as PARALLEL Task calls in a single tool call block.\n\nFor each batch, use Task tool with:\n- subagent_type: \"general-purpose\"\n- description: \"Analyze files for cleanup\"\n- prompt: |\n    You are analyzing files for cleanup decisions.\n\n    ## Files to Analyze\n    {list of 3-5 file paths from this batch}\n\n    ## Instructions\n    For each file:\n    1. Read the file using the Read tool\n    2. Analyze content for:\n       - Is it truly transient? (handover, status snapshot, draft)\n       - Does it contain unique information not in other files?\n       - Is it superseded by other documents?\n       - Are there red flags? (words like \"IMPORTANT\", \"CRITICAL\", \"ARCHITECTURE\", \"DECISION\")\n    3. Return decision: SAFE_TO_DELETE, KEEP, or UNCERTAIN\n\n    ## Output Format (JSON)\n    Return your findings as JSON:\n    ```json\n    {\n      \"files\": [\n        {\n          \"path\": \"filename.md\",\n          \"pattern\": \"Why it matched DELETE pattern\",\n          \"content_summary\": \"1-2 sentence summary\",\n          \"unique_info\": true\u002Ffalse,\n          \"red_flags\": [\"list of any red flag words found\"],\n          \"decision\": \"SAFE_TO_DELETE|KEEP|UNCERTAIN\",\n          \"reasoning\": \"Brief explanation of why this decision is safe\"\n        }\n      ]\n    }\n    ```\n\nc. **Wait for all agents to complete** before proceeding.\n\nd. **Aggregate results**:\n   - Parse JSON from each agent\n   - Merge all file decisions into unified list\n   - Group by decision: SAFE_TO_DELETE, KEEP, UNCERTAIN\n\ne. **Error handling**:\n   - If an agent fails: Mark its files as UNCERTAIN (user decides)\n   - If all agents fail: Fall back to sequential processing with warning\n   - Report errors clearly: \"Agent failed for batch N. Files marked for manual review.\"\n\n**Display progress** during execution:\n```\nAnalyzing files in parallel (batch 1 of 3)...\nAnalyzing files in parallel (batch 2 of 3)...\nAnalyzing files in parallel (batch 3 of 3)...\nAll batches complete. Aggregating results...\n```\n\n**Provide reasoning** for each decision with format:\n```\n[Filename]\n  Pattern: [Why it matched DELETE pattern]\n  Content: [1-2 sentence summary of what's in the file]\n  Unique info: [Yes\u002FNo - is there information not elsewhere?]\n  Decision: [DELETE\u002FKEEP\u002FUNCERTAIN]\n  Reasoning: [Why this decision is safe]\n```\n\n**Example**: `SESSION1.md` → Pattern match (SESSION*) → Read content → \"Generic handover duplicated in COMPLETION.md\" → SAFE TO DELETE\n\n5. **Display Categorization with Reasoning**\n\nShow complete analysis grouped by decision with brief reasoning:\n\n```\nWILL KEEP (X): spec.md, plan.md, tasks.md, COMPLETION.md, SESSION-ARCH.md*\n  *Contains unique decisions, suggest moving to decisions\u002F\n\nWILL DELETE (Y): SESSION1.md (duplicated), PR_123.md (in GitHub), STATUS.md (superseded)\n\nUNCERTAIN (Z): custom-notes.md [K\u002FD?]\n```\n\n6. **User Confirmation**\n\n- In dry-run mode: Skip to summary (no confirmation needed)\n- In normal mode: Single confirmation for all deletions\n  ```\n  Proceed with deletion of Y files? [y\u002FN]:\n  ```\n- If user confirms: Continue to deletion\n- If user cancels: Exit with \"Cleanup cancelled\"\n\n7. **Execute Deletion** (if not dry-run and confirmed)\n\nUse Bash tool to delete validated files:\n```bash\nrm -rf \u003Cfile1> \u003Cfile2> ...\n```\n\nTrack:\n- Files successfully deleted\n- Files that failed to delete (permission errors, etc.)\n- Report errors clearly\n\n8. **Link Maintenance**\n\nAfter deletion, fix broken markdown links in kept files:\n\na. **Identify deleted filenames**\nb. **For each kept .md file**:\n   - Read file using Read tool\n   - Search for links to deleted files: `[text](deleted-file.md)`\n   - If found: Use Edit tool to remove link (convert to plain text)\n   - Track how many links fixed\n\n9. **Summary Report**\n\nDisplay final summary:\n```\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n📊 CLEANUP SUMMARY\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\nFiles kept:      X\nFiles deleted:   Y (after content review)\nLinks fixed:     Z\nErrors:          N (if any)\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n\nContent Review Highlights:\n- X files validated as safe to delete\n- Y files kept due to unique information\n- Z files moved user decision\n\nNext: git add . && git commit -m \"Clean up spec directory\"\n```\n\n### Batch Mode\n\nIf target contains `###-*\u002F` subdirectories: process all with content review, consolidate display, single confirmation.\n\n## File Categorization Patterns\n\n### KEEP (Always preserve)\n\n**Core Blueprint**:\n- `spec.md` - Feature specification\n- `plan.md` - Implementation plan\n- `tasks.md` - Task breakdown\n\n**Valuable Learnings**:\n- `COMPLETION.md` - Final summary and learnings\n- `HANDOVER.md` - Operational knowledge\n- `research.md` - Discovery and constraints\n- `data-model.md` - Schema documentation\n- `quickstart.md` - Usage guide\n- `CHANGELOG.md` - Version history (required by constitution)\n\n**Active Work**:\n- `BACKLOG-*.md` - Deferred work items\n\n**Structural Directories**:\n- `checklists\u002F` - Requirements validation\n- `contracts\u002F` - API\u002Fschema contracts\n- `decisions\u002F` - Architectural decision records\n\n### DELETE Candidates (Review content before deletion)\n\n**Session Noise**:\n- `SESSION*.md` - Session handovers (usually transient)\n- `*-NEXT-SESSION*.md` - Session prompts\n- `STATUS-*.md` - Point-in-time status snapshots\n\n**Phase Tracking**:\n- `COMPLETION-PHASE*.md` - Interim phase completions\n- `HANDOVER-PHASE*.md` - Phase handovers\n- `*-COMPLETE.md` - Completion markers\n- `GREEN-STATUS.md`, `REBASE-COMPLETE.md` - One-time events\n\n**PR Artifacts**:\n- `PR_*.md`, `PR-*.md` - PR descriptions (already in GitHub)\n- `PRs-CREATED.md` - Transient tracking\n\n**Superseded Drafts**:\n- `archive\u002F` - Archived old versions\n- `*-draft-*.md` - Draft versions\n\n### Unknown Files\n\nAny file not matching KEEP or DELETE patterns:\n- Read content\n- Analyze purpose and value\n- Prompt user for decision\n\n## Usage\n\n```bash\n\u002Fspeckit.ext.cleanup specs\u002F001-feature\u002F              # Single directory\n\u002Fspeckit.ext.cleanup specs\u002F001-feature\u002F --dry-run    # Preview first\n\u002Fspeckit.ext.cleanup specs\u002F                          # Batch mode\n\u002Fspeckit.ext.cleanup specs\u002F001-feature\u002F --force      # Skip git warning\n```\n\n## Notes\n\n**Content Review**: Never blindly delete by filename. Read file contents and validate: truly transient, information captured elsewhere, no unique decisions\u002Fcontext.\n\n**Red flags** (KEEP): Words like IMPORTANT\u002FCRITICAL\u002FARCHITECTURE\u002FDECISION, unique technical details, detailed rationale.\n\n**Safe to DELETE**: Generic handovers, status snapshots, duplicate info, superseded versions.\n\n**Workflow**: Complete tasks → **Update workspace CHANGELOG** (if exists) → Commit → Run cleanup → Confirm → Commit cleaned spec\n\n**CHANGELOG Integration**: Cleanup detects workspace CHANGELOG.md and prompts to add feature entry before cleanup. Ensures shipped features are documented.\n\n**Patterns**: Case-sensitive glob (SESSION*.md matches SESSION1.md, not session.md). Patterns suggest, content validates.\n\n**Dry-run**: Shows full content review without executing deletions.\n\n**Errors**: Report but continue with other files.",{"name":5,"metadata":24,"description":7,"compatibility":27},{"author":25,"source":26},"github-spec-kit","ext:commands\u002Fspeckit.ext.cleanup.md","Requires spec-kit project structure with .specify\u002F directory","main","2045797696f3923d9e47519e2302e944260b2266",".specify\u002Fextensions\u002Fext\u002F.specify-dev\u002Fagent-commands\u002Fclaude\u002Fspeckit-ext-cleanup",0,"https:\u002F\u002Fgithub.com\u002Fstefanwalther\u002Fghn","https:\u002F\u002Fgithub.com\u002Fstefanwalther","2026-11-15 06:19:35",{"source":8,"skillName":5,"commands":36,"prompt":46,"zipAvailable":47},[37,40,43],{"tool":38,"command":39},"npx","npx skills add stefanwalther\u002Fghn --skill speckit-ext-cleanup",{"tool":41,"command":42},"bunx","bunx skills add stefanwalther\u002Fghn --skill speckit-ext-cleanup",{"tool":44,"command":45},"pnpm","pnpm dlx skills add stefanwalther\u002Fghn --skill speckit-ext-cleanup","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fstefanwalther\u002Fghn\u002Fblob\u002Fmain\u002F.specify\u002Fextensions\u002Fext\u002F.specify-dev\u002Fagent-commands\u002Fclaude\u002Fspeckit-ext-cleanup\u002FSKILL.md",true,[],[50,57,64,71,78,85],{"skillNo":51,"name":52,"nameZh":6,"description":53,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":54,"categories":55,"keywords":56,"publishedAt":19},"01M7E5EJAJD6R57EE4YSMDJWMP","speckit-ext-validate","Pre-merge validation and quality gate for feature completion","https:\u002F\u002Fgithub.com\u002Fstefanwalther\u002Fghn\u002Fblob\u002Fmain\u002F.specify\u002Fextensions\u002Fext\u002F.specify-dev\u002Fagent-commands\u002Fclaude\u002Fspeckit-ext-validate\u002FSKILL.md",[],[],{"skillNo":58,"name":59,"nameZh":6,"description":60,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":61,"categories":62,"keywords":63,"publishedAt":19},"01M7E5EFW37C0QJ0VZZG7SAWHD","speckit-ext-update-workspace","Update workspace documentation after feature completion","https:\u002F\u002Fgithub.com\u002Fstefanwalther\u002Fghn\u002Fblob\u002Fmain\u002F.specify\u002Fextensions\u002Fext\u002F.specify-dev\u002Fagent-commands\u002Fclaude\u002Fspeckit-ext-update-workspace\u002FSKILL.md",[],[],{"skillNo":65,"name":66,"nameZh":6,"description":67,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":68,"categories":69,"keywords":70,"publishedAt":19},"01M7E5EBDFYZPMJ1HM484EH8K8","speckit-ext-session-handover","Mid-implementation context handover with proactive monitoring and continuation prompts","https:\u002F\u002Fgithub.com\u002Fstefanwalther\u002Fghn\u002Fblob\u002Fmain\u002F.specify\u002Fextensions\u002Fext\u002F.specify-dev\u002Fagent-commands\u002Fclaude\u002Fspeckit-ext-session-handover\u002FSKILL.md",[],[],{"skillNo":72,"name":73,"nameZh":6,"description":74,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":75,"categories":76,"keywords":77,"publishedAt":19},"01M7E5E92Y08ME10QRAW8T0ES9","speckit-ext-scope-change","Document scope changes and ad-hoc additions during feature implementation","https:\u002F\u002Fgithub.com\u002Fstefanwalther\u002Fghn\u002Fblob\u002Fmain\u002F.specify\u002Fextensions\u002Fext\u002F.specify-dev\u002Fagent-commands\u002Fclaude\u002Fspeckit-ext-scope-change\u002FSKILL.md",[],[],{"skillNo":79,"name":80,"nameZh":6,"description":81,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":82,"categories":83,"keywords":84,"publishedAt":19},"01M7E5E3DJ0B3B0FHF0YQAE2JV","speckit-ext-pr","Create a pull request for spec-kit features with agent-based workflow and spec-kit context awareness","https:\u002F\u002Fgithub.com\u002Fstefanwalther\u002Fghn\u002Fblob\u002Fmain\u002F.specify\u002Fextensions\u002Fext\u002F.specify-dev\u002Fagent-commands\u002Fclaude\u002Fspeckit-ext-pr\u002FSKILL.md",[],[],{"skillNo":86,"name":87,"nameZh":6,"description":88,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":89,"categories":90,"keywords":91,"publishedAt":19},"01M7E5E1B26HH69228R8MD54H5","speckit-ext-post-merge","Spec-kit workflow command: speckit-ext-post-merge","https:\u002F\u002Fgithub.com\u002Fstefanwalther\u002Fghn\u002Fblob\u002Fmain\u002F.specify\u002Fextensions\u002Fext\u002F.specify-dev\u002Fagent-commands\u002Fclaude\u002Fspeckit-ext-post-merge\u002FSKILL.md",[],[]]