Migrate project documentation from legacy system to token-efficient tracking
Converts project documentation to token-efficient tracking system by creating CONTEXT.md, compressing IMPLEMENTATION.md, and reformatting DECISIONS.md
/plugin marketplace add pborenstein/plinth/plugin install pborenstein-plinth@pborenstein/plinthMigrate an existing project-tracking setup to the new token-efficient system.
This command should be run ONCE per project.
Converts legacy documentation (split or traditional) to the token-efficient system:
docs/CONTEXT.md with current session statedocs/IMPLEMENTATION.mddocs/DECISIONS.md from table format to heading-based formatdocs/CHRONICLES.md (preserves unique content)Before running this migration, ensure:
Read the current phase section from docs/IMPLEMENTATION.md:
Write docs/CONTEXT.md:
skills/project-tracking/templates/CONTEXT.mdRead docs/IMPLEMENTATION.md to identify completed phases
For each completed phase:
Keep:
Target: Reduce file from 800-1000 lines to 400-600 lines
Read existing docs/DECISIONS.md
If it uses table format:
### DEC-XXX: Title (YYYY-MM-DD)
**Status**: Active
**Context**: [from chronicle entry or table]
**Decision**: [what was decided]
**Alternatives considered**: [if available]
**Consequences**: [impact]
Write new docs/DECISIONS.md:
skills/project-tracking/templates/DECISIONS.mdIf decisions are currently in chronicle entries only:
Read docs/CHRONICLES.md if it exists
Check for unique content:
If unique content exists:
If using split documentation (chronicles/ directory exists):
ls docs/chronicles/Delete docs/CHRONICLES.md:
Check if project has custom templates
If docs/templates/ or .project-templates/ exists:
skills/project-tracking/templates/Check the following:
docs/CONTEXT.md exists and is < 50 linesdocs/IMPLEMENTATION.md is < 600 linesdocs/DECISIONS.md uses heading-based formatdocs/CHRONICLES.md is deletedCreate commit:
refactor: migrate to token-efficient documentation system
- Created CONTEXT.md for session pickup (~40 lines vs ~200)
- Compressed completed phases in IMPLEMENTATION.md
- Converted DECISIONS.md to heading-based format
- Eliminated CHRONICLES.md (preserved unique content in project docs)
- Updated to slim chronicle templates
Migration reduces session pickup from ~200 lines to ~50 lines.
See: docs/PLAN-token-efficient-tracking.md
Run session-pickup command:
Run session-wrapup command next session:
Update team/collaborators:
Adjust workflow:
If you need to rollback:
git revert HEAD # Revert migration commit
Or manually:
docs/CONTEXT.mddocs/CHRONICLES.md from git historydocs/DECISIONS.md from git historydocs/IMPLEMENTATION.md from git history$ARGUMENTS