Issue Management
Manage the project's persistent work tracker in thoughts/shared/issues/.
Issue & Plan Storage
Issues and plans are tracked in ./issues/ with numbered phases:
./issues/
├── 10-phase-name/ # Single issue = flat folder
│ └── plan.md
├── 20-another-phase/
│ ├── plan.md
│ └── design.md # Optional
├── 30-multi-issue-phase/ # Multiple parallel issues = nested
│ ├── feature-a/
│ │ ├── plan.md
│ │ └── design.md
│ └── feature-b/
│ └── plan.md
└── done/ # Completed issues moved here
Conventions:
- Single issue phase →
NN-phase-name/(flat) - Multi-issue phase →
NN-phase/issue-name/(nested, all parallel) - Gaps in numbers (10, 20...) = room to insert phases later
- Each issue has
plan.md+ optionaldesign.md - Completed issues → move to
done/
Workflow:
- Work through phases in order (10 → 20 → 30...)
- Within a phase folder, pick any issue - they're independent
- Read issue's
plan.mdfor scope
Commands
List Active Issues
ls -1d thoughts/shared/issues/*/ 2>/dev/null | grep -v done/
Show What's Next
ls -1d thoughts/shared/issues/*/ 2>/dev/null | grep -v done/ | head -1
Create Issue
- Check existing phases:
ls thoughts/shared/issues/ - Pick phase number (use gaps like 10, 20, 30 for flexibility)
- Create folder:
- Single issue:
thoughts/shared/issues/NN-issue-name/ - Multi-issue phase:
thoughts/shared/issues/NN-phase/issue-name/
- Single issue:
- Add
plan.mdwith scope and implementation details - Optionally add
design.mdfor design notes
Complete Issue
Move to done when fully implemented:
mkdir -p thoughts/shared/issues/done
mv thoughts/shared/issues/NN-issue-name thoughts/shared/issues/done/
Show Progress
echo "Active:" && ls -1d thoughts/shared/issues/*/ 2>/dev/null | grep -v done/ | wc -l
echo "Done:" && ls -1d thoughts/shared/issues/done/*/ 2>/dev/null | wc -l
Triage/Prioritize
- Review all phases:
ls -la thoughts/shared/issues/ - Check recent work to identify completed issues:
git log --oneline -20 git diff main~10..main --stat - Move completed issues to done
- Renumber folders to reorder priority
- Move items between phases as needed
- Update any
plan.mdfiles with new scope
$ARGUMENTS
Converted and distributed by TomeVault — claim your Tome and manage your conversions.