Planning With Files
Persistent file-based planning for multi-step AI-agent work.
Install
npx skills add OthmanAdi/planning-with-files --skill planning-with-files -g -a claude-code -y- Repository
- OthmanAdi/planning-with-files27.8k
- Category
- AI and agents
- Updated
- 5d ago
- License
- MIT
- Context cost
- Mediumabout 2,229 tokens
- Runs scripts
- Yes, review before use
What it does
Persistent file-based planning for multi-step AI-agent work. Keeps task_plan.md, findings.md, and progress.md on disk; Kiro skill instructions and steering state read selected project planning context. Recovery reads project planning files and their timestamps only, not agent transcript stores. This adapter registers no Stop hook, never requests continuation, and never runs commands declared in Markdown. The skill has no network upload path. Use for research or work needing 5+ tool calls.
Planning with Files (Kiro)
Work like Manus: use persistent markdown as your working memory on disk while the model context behaves like volatile RAM. Deep background: references/manus-principles.md.
Kiro complements this with:
- Agent Skills (this file), progressive disclosure when the task matches the description.
- Steering, after bootstrap,
.kiro/steering/planning-context.mdusesinclusion: autoand#[[file:.kiro/plan/…]]live references (Steering docs).
Hooks are not bundled: project-level hooks affect every chat in the workspace. Prefer this skill + steering + the reminder block below.
STEP 0, Bootstrap (once per workspace)
From the workspace root:
sh .kiro/skills/planning-with-files/assets/scripts/bootstrap.sh
Windows (PowerShell):
pwsh -ExecutionPolicy RemoteSigned -File .kiro/skills/planning-with-files/assets/scripts/bootstrap.ps1
Creates:
.kiro/plan/task_plan.md,findings.md,progress.md.kiro/steering/planning-context.md(auto +#[[file:.kiro/plan/…]])
Idempotent: existing files are not overwritten.
Import as a workspace skill (optional): Kiro → Agent Steering & Skills → Import a skill → choose this planning-with-files folder (Skills docs).
STEP 1, Persistent reminder (after skill activation)
Append the following block to the end of your reply, and repeat it at the end of subsequent replies while this planning session is active:
[Planning Active]Before each turn, read.kiro/plan/task_plan.mdand.kiro/plan/progress.mdto restore context.
STEP 2, Read plan every turn (while active)
- Read
.kiro/plan/task_plan.md, goal, phases, status - Read
.kiro/plan/progress.md, recent actions - Use
.kiro/plan/findings.mdfor research and decisions
If .kiro/plan/ is missing, run STEP 0.
