fay-i

bk-behaviors

Decompose acceptance criteria into atomic, testable behaviors. Invoke after /bk-plan, before /bk-implement.

bk-constitution

Create or update project constitution with behavior-first principles. Invoke when the user wants to set up behavior-kit in a project for the first time, or amend the constitution's articles.

bk-iterate

Address PR review feedback one comment at a time. Invoke per review round after pushing the branch and opening a PR. Requires gh CLI authenticated.

Research existing codebase context and current implementation guidance for a feature spec. Invoke after /bk-specify, before /bk-behaviors. Read-only research pass with recommendations only — no architecture decisions, no new code.

bk-session

Start a lightweight pairing session — branch + worktree, no spec/plan/behaviors workflow. Invoke for one-off fixes, refactors, QA passes, or interactive tweaks that don't warrant a full spec.

bk-specify

Generate a behavior-first spec with Given/When/Then acceptance criteria. Invoke when the user wants to start a new feature — they will provide a feature description as arguments.

bk-implement

Implement behaviors one at a time using test-first development. Invoke after /bk-behaviors. Red → green → refactor, one commit per behavior.