Files
planning-with-files/docs/kiro.md
T
v-yichenxi 402d929564 feat(kiro): add Kiro Agent Skill and align Mastra/Cursor hooks (v2.23.1)
IDE hook follow-up (v2.23.0 gaps):

- Mastra Code: hooks.json is the hook source — add UserPromptSubmit, refresh PostToolUse.
- Cursor: .cursor/hooks/ — add user-prompt-submit, update post-tool-use and stop scripts.

Kiro workspace skill:

- Add .kiro/skills/planning-with-files/ (SKILL.md, references, templates, scripts).
- Bootstrap creates .kiro/plan and auto steering planning-context.md (#[[file:]]).
- Add session-catchup.py; check-complete/bootstrap for sh and PowerShell.
- Remove duplicate .kiro/scripts and always-on steering; sync script skips .kiro.
- Update docs/kiro.md and README (Kiro = Agent Skill + Steering).
2026-03-20 11:40:00 +08:00

3.5 KiB

Kiro

Use planning-with-files with Kiro: Agent Skills, optional Steering (created by bootstrap), and on-disk markdown under .kiro/plan/.

Official references:


What ships in this repo

Only the workspace skill folder:

.kiro/skills/planning-with-files/
├── SKILL.md
├── references/          # manus-principles, planning-rules, planning-templates
└── assets/
    ├── scripts/         # bootstrap, session-catchup, check-complete (.sh + .ps1 + .py)
    └── templates/       # task_plan, findings, progress, planning-context (steering)

Running bootstrap (from the project root) creates:

Path Role
.kiro/plan/task_plan.md Goal, phases, decisions, errors
.kiro/plan/findings.md Research and technical decisions
.kiro/plan/progress.md Session log
.kiro/steering/planning-context.md inclusion: auto + #[[file:.kiro/plan/…]]

Design note: hooks are not installed by default. Hooks are workspace-wide. This integration uses the skill, generated steering, and the [Planning Active] reminder in SKILL.md.


Install into your project

git clone https://github.com/OthmanAdi/planning-with-files.git
mkdir -p .kiro/skills
cp -r planning-with-files/.kiro/skills/planning-with-files ./.kiro/skills/

Then from your project root:

sh .kiro/skills/planning-with-files/assets/scripts/bootstrap.sh

Windows (PowerShell):

pwsh -ExecutionPolicy Bypass -File .kiro/skills/planning-with-files/assets/scripts/bootstrap.ps1

Import the skill in Kiro

  1. Open Agent Steering & Skills in the Kiro panel.
  2. Import a skill → local folder → .kiro/skills/planning-with-files
  3. Or copy that folder to ~/.kiro/skills/planning-with-files for a global skill (scope).

Scripts (under the skill)

All paths are relative to the project root after you have copied .kiro/skills/planning-with-files/ into the project.

Script Purpose
assets/scripts/bootstrap.sh / bootstrap.ps1 Create .kiro/plan/* and planning-context.md (idempotent)
assets/scripts/session-catchup.py Print mtime + short summary of planning files
assets/scripts/check-complete.sh / check-complete.ps1 Report phase completion vs .kiro/plan/task_plan.md

Examples:

sh .kiro/skills/planning-with-files/assets/scripts/check-complete.sh
$(command -v python3 || command -v python) \
  .kiro/skills/planning-with-files/assets/scripts/session-catchup.py "$(pwd)"
pwsh -File .kiro/skills/planning-with-files/assets/scripts/check-complete.ps1
python .kiro/skills/planning-with-files/assets/scripts/session-catchup.py (Get-Location)

Manus-style context engineering

The skill description and references/manus-principles.md document the filesystem-as-memory pattern discussed in Manus-style agent context engineering.


Template reference

See references/planning-templates.md for compact paste-friendly skeletons. To use them as manual steering in Kiro, copy that file into .kiro/steering/ and add the YAML front matter described at the top of that file.