
planning-with-files
Persist task plans for long-running work.
- version
- 0.1.9
- GitHub stars
- 347
Install
/plugin install planning-with-files@khanelinix-ai-toolsRun it inside Claude Code after adding the marketplace with /plugin marketplace add khaneliman/khanelinix.
Contents
Discovered from sourceSkills 1
Planning with Files
Codex session attachment
Codex hooks require an explicit attachment before relying on planning context or Stop gating:
scripts/attach-session.sh <session-id> <plan-id>
Use . to intentionally attach the repository-root legacy task_plan.md.
Unattached sessions receive no planning context or planning Stop gate.
Use persistent markdown files as working memory when a task intentionally opts into cross-session or compaction recovery. Hook behavior is provider-specific; this canonical package is the provider-neutral routing layer. Harness adapters may add hooks without changing the workflow contract.
Restore First
When the current task has intentionally adopted planning state, read:
task_plan.mdfindings.mdprogress.md
Recover missing execution evidence from the relevant task session. The bundled
scripts/session-catchup.py searches project-wide history; use it only for an
intentional historical investigation, not automatic session recovery.
Start or Continue
- New persistent plan: create
task_plan.md,findings.md, andprogress.mdfrom templates after choosing this workflow. - Existing plan: re-read the files before major decisions.
- After each phase: update phase status and append progress.
- After research or external content: record facts in
findings.md, nottask_plan.md. - Existing plan files do not activate this workflow for unrelated tasks.
References
- Detailed workflow and security notes: reference.md
- Example plans and logs: examples.md
- Templates: templates/task_plan.md, templates/findings.md, templates/progress.md
Sponsors
Details
- Marketplace
- khaneliman/khanelinix
- Source
- modules/common/ai-tools/skills/planning-with-files
- Author
- khaneliman
- Category
- Developer Tools
More from khaneliman/khanelinix
All 43- program-orchestrationv0.1.5
- recallv0.1.7
- requirements-interviewv0.1.4
- researchv0.1.3
- rust-toolkitv0.1.6
- sarif-toolkitv0.1.5
- security-toolkitv0.1.7
- show-me-your-workv0.1.7
- skill-creatorv0.1.8
- software-engineeringv0.1.9
- tddv0.1.4
- technical-writingv0.2.0
- to-specv0.1.1
- to-ticketsv0.1.1
- typescript-best-practicesv0.1.6
- unslopv0.1.7
- verification-harnessv0.1.5
- whyv0.1.6
- ai-tools-architectv0.1.21
- architectv0.1.7
- arenav0.1.5
- bevy-toolkitv0.1.6
- blast-radiusv0.1.6
- blender-toolkitv0.3.2