@warren-dean/code-kit 0.31.0 → 0.32.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -17,6 +17,7 @@ It returns `step`, `why`, `args`, `then` (steps that can follow straight after)
17
17
 
18
18
  | State | Step |
19
19
  | ------------------------------------------------------------ | --------------------------------------------------------- |
20
+ | This is a working session (another session leads) | working: the step is the lead's, not this session's |
20
21
  | Invalid config | `check`, then fix the config |
21
22
  | No config, a draft waiting | `init`, to show it for approval |
22
23
  | No config, a spec still being shaped (brief not `ready`) | `spec-design`, resuming |
@@ -47,6 +48,7 @@ Run the named skill with the Skill tool: `code-kit:<step>`, with `args` (and the
47
48
  - **`update`:** run `code-kit:init`. `why` names what the setup is missing (the design gate, design stories, a QA lane, a security reviewer); init adds those, shows the person the difference, and sets `"setup": 3`. Until then no new story starts; work already started goes on to review and merge.
48
49
  - **`instructions`:** there's no skill to run. With `args` `write`, run `code-kit instructions --write`. With `merge`, some files were written before code-kit marked its part: run `code-kit instructions` to list them, replace each old part with what `code-kit instructions show lead` (CLAUDE.md) or `show lane <lane>` (that lane's agent file) prints, keep every line the project wrote itself outside the markers, then run `--write` for the rest. Commit it on a branch and merge it like your own stories.
49
50
  - **`lead`:** there's no skill to run. Build each story yourself, on the branch `lead/st-<n>`: spec-check it first if it cites requirements, do the work, commit, then run `code-kit:review` on the branch like any other. A spike's result goes in the docs it names.
51
+ - **`working`:** another session leads the project, and the step (`lead.step` in the JSON) is its own, not this one's. Don't dispatch, review, merge or write contracts here. Tell the person which session leads and what its step is. If they gave this session a task, do it in a worktree of its own after recording it with `code-kit task`. If they want this session to lead instead, they make it the lead.
50
52
  - **`wait`:** say which stories are being built and on which branches, and which ready stories wait for their lane (a lane runs one story at a time), then stop. When a lane agent finishes, its notification arrives in this session; run this skill again then. If a story has been in progress with no agent running (the session ended, or the agent stopped without committing), dispatch it again.
51
53
  - **`done`:** give the `status` summary in a few lines, then offer to run spec-design for the next milestone or feature.
52
54
 
@@ -57,7 +59,7 @@ After a step finishes, run `next --json` again and carry on with the new step, w
57
59
  - a skill asks the person questions (spec-design's rounds, spec-check's blocking questions, review's scope questions);
58
60
  - something needs the person's approval (init's draft, an approval that's theirs: `requests --json` marks it `by: "person"`). What a lane asks for that's yours (`by: "lead"`) you decide with `/code-kit:decide`, without stopping. If the config has `approvals.lead`, ask for it in chat: when they approve in their own message, record it with the `code-kit approve` command the refusal names (their words as the reason) and carry on;
59
61
  - a person has to act: merge a pull request to a protected branch, add a CI secret;
60
- - the step is `wait` or `done`;
62
+ - the step is `wait`, `done` or `working`;
61
63
  - the same step comes back twice in a row with nothing changed. Report what's stuck instead of looping.
62
64
 
63
65
  **Under vibe** (`harness.autonomy` is `vibe`), you're the product owner too, and only the last two stop you. Answer spec-design's, spec-check's and review's questions yourself, from the brief, the specs and the principles, and record each in the brief's decision log with why. Every approval is yours (`by: "lead"`, with `--delegated`); merge and push as the queue says. What only the person can give (an account with a service provider, an API key or secret, a payment, an act outside the repository) you ask with `code-kit ask "…" --needs account|key|payment|outside`, and you build everything else meanwhile: behind the setting the key will fill, against a local or test stand-in, with the step to switch it on in the story's notes.
@@ -18,7 +18,7 @@ Lane rules:
18
18
 
19
19
  Always:
20
20
 
21
- - Work on the branch the brief names (`<lane>/st-<n>`). Start every task with the spec-check skill and save its report to .claude/state/spec-check/<branch>.md; the path guard blocks code until it exists.
21
+ - Work on the branch the brief names (`<lane>/st-<n>`). Start every task with the spec-check skill and save its report to .claude/state/spec-check/<branch>.md, as the skill writes it: a table whose header row starts `| Requirement |`, one row per requirement. The path guard blocks code until it exists, and reads a report without that table as none.
22
22
  - Follow `{{docs.principles}}`, including the rules for AI agents. Hooks enforce ownership, layers and the project's checks; if one blocks you, fix the cause, never work around it.
23
23
  - {{if standards}}Build to the project's standards for your layers, from `{{docs.standards}}` (read a standard's why and evidence there when you need it). A required one that review checks sends your branch back if it's broken; advice is yours to weigh:{{standards}}{{end}}
24
24
  - Read every file you change in full. Of what it imports and what calls it, read what your change needs: the definitions it uses and the call sites it changes. A context tool's fresh card for a file stands for reading it whole; read the source where the card is missing, stale or not enough.