@warren-dean/code-kit 0.3.4

package/templates/agent.md

@@ -0,0 +1,29 @@
+---
+name: {{agent}}
+description: {{what this lane builds, in one sentence}} Use for {{the paths or kinds of work it owns}}.
+tools: Read, Grep, Glob, Edit, Write, Bash
+---
+
+You are the {{lane}} engineer for this repository.
+
+**Owned paths:** {{lane paths from .claude/code-kit.json}}
+**Layers:** {{the layers in these paths, and what each may depend on}}
+**Specs:** {{the spec files this lane reads}}
+**Skills to use:** spec-check{{, project skills for this lane}}
+**Prove your work with:** `{{the command that proves this lane's work}}`
+
+Lane rules:
+{{- one line per rule the docs set for this lane}}
+
+Always:
+
+- 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.
+- 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.
+- Read every file you change in full, plus its imports and its callers.
+- Search before you build; reuse existing services, providers, components and schemas.
+- Write only in your owned paths. For anything else, write a short change request for the lead and stop.
+- A new dependency needs a person's approval for your lane. If the install is refused, put the package, why it's needed and the approval command from the refusal in a change request for the lead, and stop.
+- Build every feature end to end. No mocks, stubs, placeholder screens or "coming soon".
+- Prove each acceptance criterion with a test whose title names the requirement ID, e.g. `BOOK-4 …`.
+- Commit your work on your branch before finishing; the stop hook runs the checks and requires it.
+- Finish with: what you did, the spec section, the commands you ran with their output, open questions.

package/templates/brief.md

@@ -0,0 +1,45 @@
+# {{Name}}
+
+**Status:** framed | explored | scoped | specified | planned | ready
+**Updated:** {{date}}
+
+## Problem
+
+{{What's wrong or missing today, for whom, and how they cope now.}}
+
+## Users
+
+| Actor     | Trying to get done |
+| --------- | ------------------ |
+| {{actor}} | {{goal}}           |
+
+## Outcome
+
+{{What's different when this works, and how anyone will know.}}
+
+## Constraints
+
+{{Deadline, budget, team, platforms and technology, regulation and data residency, systems it must fit.}}
+
+## Non-goals
+
+- {{what this deliberately won't do}}
+
+## Scope
+
+| Area     | Spec                 | First release | Later     |
+| -------- | -------------------- | ------------- | --------- |
+| {{area}} | `specs/NN-<area>.md` | {{summary}}   | {{later}} |
+
+**Quality targets:** {{scale, response times, availability, security and privacy, accessibility, devices, languages}}
+
+## Decision log
+
+| Date     | Decision     | Why     | Rejected, and why |
+| -------- | ------------ | ------- | ----------------- |
+| {{date}} | {{decision}} | {{why}} | {{alternatives}}  |
+
+## Open questions
+
+| Question | Owner | Blocks |
+| -------- | ----- | ------ |

package/templates/claude-md.md

@@ -0,0 +1,23 @@
+## Enforced, not advised
+
+The code-kit plugin enforces the rules in `.claude/code-kit.json` on every tool call:
+
+- who writes where (the lead delegates lane work to the lane agents in `.claude/agents/`);
+- the layer rules ({{layer names, in order}});
+- spec-check before lane code{{; designs approved before screens}};
+- an audit log of every change to protected paths (`.claude/approval-log.jsonl`), which the person reviews in the pull request;
+- a person's approval for every new dependency, per package and per lane. When a lane asks for one, give the person the package, the reason and the approval command from the refusal, and resume the lane once they've run it;
+- the project's checks before any agent finishes.
+
+If a hook blocks you, fix the cause; never work around it.
+
+The build runs from the specs in {{docs.specs}} and the stories in {{docs.plan}}. `/code-kit:next` picks the right step from the project's state; the steps are:
+
+- `/code-kit:dispatch` starts ready stories on their lanes, each on its own `<lane>/st-<n>` branch;
+- `/code-kit:review` checks a finished branch against its requirements before the lead merges it;
+- `/code-kit:status` shows what's done, in review, ready and blocked, and what's untested;
+- `/code-kit:spec-design` changes the specs when a decision changes. It updates the spec, the decision log and the plan together.
+
+{{If the CI workflow is installed: pull requests run `code-kit verify`, and it must pass before a person merges to a protected branch.}}
+
+Changing the rules means editing `.claude/code-kit.json` (the lead only), then running the `code-kit:check` skill.

package/templates/github-workflow.yml

@@ -0,0 +1,23 @@
+# code-kit verify: the project's rules for every pull request, including work done outside Claude Code.
+name: code-kit
+
+on:
+  pull_request:
+
+jobs:
+  verify:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0 # verify compares the branch with where it left the base
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22
+      # {{init replaces this line with the steps that install what the project's checks need,
+      #   e.g. pnpm/action-setup and `pnpm install --frozen-lockfile`}}
+      - name: Verify
+        run: >
+          npx --yes @warren-dean/code-kit@{{code-kit version}} verify
+          --base origin/${{ github.base_ref }}
+          --branch ${{ github.head_ref }}

package/templates/plan.md

@@ -0,0 +1,30 @@
+# Plan
+
+`code-kit status` reads this file. Keep each story's heading and its four `**…:**` lines in this form.
+
+## Lanes
+
+| Lane     | Agent     | Owns      | Proves its work with |
+| -------- | --------- | --------- | -------------------- |
+| {{lane}} | {{agent}} | {{globs}} | `{{command}}`        |
+
+## Milestone 1: {{name}}
+
+{{The usable increment this milestone delivers, in a sentence.}}
+
+### ST-1 {{Story title}}
+
+**Lane:** {{lane}}
+**Requirements:** {{AREA-1, AREA-2}}
+**Depends on:** {{ST-n, or none}}
+**Status:** todo
+
+{{What gets built, in two or three sentences. The acceptance criteria are the cited requirements'.}}
+
+### ST-2 {{Story title}}
+
+…
+
+## Milestone 2: {{name}}
+
+…

package/templates/spec.md

@@ -0,0 +1,52 @@
+# {{NN}}. {{Capability area}}
+
+**Status:** draft | agreed | building | done
+**Outcome:** {{what this area makes possible, for whom, in a sentence}}
+**Actors:** {{who uses it: kinds of users, admins, other systems, scheduled jobs}}
+**Depends on:** {{other spec files this area relies on}}
+
+## In scope
+
+- {{what the first release delivers}}
+
+## Later
+
+- {{agreed for a later release, and why it waits}}
+
+## Data
+
+| Entity     | Field     | Type     | Required | Rules                                 |
+| ---------- | --------- | -------- | -------- | ------------------------------------- |
+| {{entity}} | {{field}} | {{type}} | yes / no | {{uniqueness, limits, format, owner}} |
+
+## States
+
+{{For each entity with a lifecycle: the states, the allowed transitions, and what triggers each. Leave this section out if nothing changes state.}}
+
+## Requirements
+
+### {{AREA}}-1 {{short name}}
+
+{{What the system does, stated so someone can check whether the code does it. Real values, not "reasonable".}}
+
+- **Who:** {{the actors allowed, and anyone explicitly not allowed}}
+- **Errors:** {{each failure case and what the actor sees}}
+- **Events:** {{what other parts of the system or external services are told}}
+
+**Acceptance**
+
+- Given {{context}}, when {{action}}, then {{observable result}}.
+- Given {{an error case}}, when {{action}}, then {{observable result}}.
+
+### {{AREA}}-2 {{short name}}
+
+…
+
+## Quality targets
+
+{{Only the ones that change how this area is built: scale, response times, privacy, accessibility, audit.}}
+
+## Open questions
+
+| Question | Owner | Blocks |
+| -------- | ----- | ------ |