Read AGENTS.md first. It is the full guide for working in this repository — the session loop, the branch model, build and validate, post-back, voice, and the DO/DON'T lists. The session mechanics are specified, RFC-2119 style, in prompts/agent-router.md. The work queue is ROADMAP.md.
This file is a short pointer plus the rules that get broken most often.
- Never push to
main. Branch fromdevelopmentasagent/<slug>; the PR targetsdevelopment; squash-merge there. Promotion tomainis a human decision. - One ROADMAP item per session, one PR. Implement the first unchecked ROADMAP.md item only. Do not start a second item or open a second PR.
- Read the spec first. Before writing code, read the item's
.kiro/specs/<spec>/requirements.mdanddesign.md, and find its tasks intasks.md. Do not skip this because an item "looks trivial". - Finish the loop before merge. After CI is green, tick the ROADMAP checkbox (with the PR
number) and the matching
tasks.mdcheckboxes on the branch, then squash-merge. - Don't poll CI. After every push, stop and wait. CI posts results back as a PR comment
and a
check_runevent, which wakes the session. Nogh run watch/view/listloops. - Voice. No emoji. No AI-chat filler ("Sure!", "Great question!", "As an AI"). Direct, technical prose, in code, comments, commits, PR bodies, and docs alike.