doc-triagelisted

# Doc Triage — Convert Markdown Debt to Beads Find internal documentation files that aren't meant for external consumers, review them against the actual code, create beads for anything real, and archive the originals. ## Arguments $ARGUMENTS Arguments format: `[repo-path] [--dry-run] [--skip-archive]` - **repo-path**: Path to the repo to triage (default: current working directory) - **--dry-run**: Show what would be beaded/archived without doing it - **--skip-archive**: Create beads but don't archive the source files ## What This Solves Repos accumulate internal markdown files over time: `TODO.md`, `KNOWN_ISSUES.md`, `INVESTIGATION_LOG.md`, `_agent_log/*.md`, `HANDOFF.md`, `EXPLORATION_SUMMARY.md`. These contain a mix of: - Real work items (should be beads) - Already-fixed issues (should be deleted) - Historical context (useful but stale) - Aspirational plans (may or may not be relevant) This skill converts the real items into beads and archives the rest so they stop cluttering the repo. ## Workflow ### Phase 1: Discovery — Find Internal Docs Scan for files that are NOT meant for external consumers: ``` INCLUDE patterns (internal docs): - TODO.md, TODOS.md - KNOWN_ISSUES.md, KNOWN_BUGS.md - INVESTIGATION_LOG.md - HANDOFF*.md - EXPLORATION_SUMMARY.md - MIGRATION_PLAN.md - HYPOTHESIS.md - _agent_log/*.md - experiments/**/NOTES.md - *_COMPREHENSIVE_OVERVIEW.md - COHESIVE_INVESTIGATION_NOTES.md - *_QUICK_REFERENCE.md EXCLUDE patterns (external