cc-codeconductor 1.6.1 → 1.7.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.
- package/README.md +22 -7
- package/dist/core/compilation/compile-checker.d.ts +3 -2
- package/dist/core/goal/goal-state.d.ts +1 -0
- package/dist/core/orchestrator/runtime-orchestrator.d.ts +1 -0
- package/dist/core/queue/lock.d.ts +3 -0
- package/dist/core/verification/rdd-receipt.d.ts +6 -0
- package/dist/core/verification/verification-runner.d.ts +11 -2
- package/dist/index.js +1217 -596
- package/dist/library.js +391 -140
- package/dist/validation/schemas.d.ts +65 -26
- package/docs/generated/cli.md +8 -0
- package/package.json +1 -1
- package/presets/agy/AGENTS.md +1 -1
- package/presets/agy/scripts/invoke-hook.cjs +43 -24
- package/presets/agy/skills/backlog/SKILL.md +1 -1
- package/presets/agy/skills/cc-spec-mutation/SKILL.md +1 -1
- package/presets/agy/skills/cc-tdd-cycle/SKILL.md +1 -1
- package/presets/agy/skills/evaluation/SKILL.md +1 -1
- package/presets/agy/skills/openspec/SKILL.md +10 -6
- package/presets/agy/skills/testing-tdd/SKILL.md +3 -3
- package/presets/agy/workflows/cc-api-contract.md +1 -1
- package/presets/agy/workflows/cc-ask.md +2 -2
- package/presets/agy/workflows/cc-db-migration.md +1 -1
- package/presets/agy/workflows/cc-feature.md +1 -1
- package/presets/agy/workflows/cc-fix.md +1 -1
- package/presets/agy/workflows/cc-iterative.md +1 -1
- package/presets/agy/workflows/cc-odd.md +2 -2
- package/presets/agy/workflows/cc-openspec.md +1 -1
- package/presets/agy/workflows/cc-spec-mutation.md +2 -2
- package/presets/agy/workflows/cc-tdd-cycle.md +2 -2
- package/presets/claude/CLAUDE.md +1 -1
- package/presets/claude/commands/cc/api-contract.md +1 -1
- package/presets/claude/commands/cc/ask.md +2 -2
- package/presets/claude/commands/cc/db-migration.md +1 -1
- package/presets/claude/commands/cc/feature.md +1 -1
- package/presets/claude/commands/cc/fix.md +1 -1
- package/presets/claude/commands/cc/iterative.md +1 -1
- package/presets/claude/commands/cc/odd.md +2 -2
- package/presets/claude/commands/cc/openspec.md +5 -5
- package/presets/claude/commands/cc/spec-mutation.md +2 -2
- package/presets/claude/commands/cc/tdd-cycle.md +3 -3
- package/presets/claude/settings.json +6 -101
- package/presets/claude/skills/backlog/SKILL.md +1 -1
- package/presets/claude/skills/evaluation/SKILL.md +1 -1
- package/presets/claude/skills/openspec/SKILL.md +10 -6
- package/presets/claude/skills/testing-tdd/SKILL.md +3 -3
- package/presets/codex/AGENTS.md +1 -1
- package/presets/codex/commands/cc-ask.md +2 -2
- package/presets/codex/skills/backlog/SKILL.md +1 -1
- package/presets/codex/skills/cc-api-contract/SKILL.md +1 -1
- package/presets/codex/skills/cc-db-migration/SKILL.md +1 -1
- package/presets/codex/skills/cc-feature/SKILL.md +1 -1
- package/presets/codex/skills/cc-fix/SKILL.md +1 -1
- package/presets/codex/skills/cc-iterative/SKILL.md +1 -1
- package/presets/codex/skills/cc-odd/SKILL.md +2 -2
- package/presets/codex/skills/cc-openspec/SKILL.md +10 -8
- package/presets/codex/skills/cc-spec-mutation/SKILL.md +2 -2
- package/presets/codex/skills/cc-tdd-cycle/SKILL.md +2 -2
- package/presets/codex/skills/django-testing/SKILL.md +1 -1
- package/presets/codex/skills/evaluation/SKILL.md +1 -1
- package/presets/codex/skills/openspec/SKILL.md +10 -6
- package/presets/codex/skills/python-django-stack/SKILL.md +1 -1
- package/presets/codex/skills/testing-tdd/SKILL.md +3 -3
- package/presets/cursor/AGENTS.md +1 -1
- package/presets/cursor/commands/cc/api-contract.md +1 -1
- package/presets/cursor/commands/cc/ask.md +2 -2
- package/presets/cursor/commands/cc/db-migration.md +1 -1
- package/presets/cursor/commands/cc/feature.md +1 -1
- package/presets/cursor/commands/cc/fix.md +1 -1
- package/presets/cursor/commands/cc/iterative.md +1 -1
- package/presets/cursor/commands/cc/odd.md +2 -2
- package/presets/cursor/commands/cc/openspec.md +10 -8
- package/presets/cursor/commands/cc/spec-mutation.md +2 -2
- package/presets/cursor/commands/cc/tdd-cycle.md +2 -2
- package/presets/cursor/skills/backlog/SKILL.md +1 -1
- package/presets/cursor/skills/evaluation/SKILL.md +1 -1
- package/presets/cursor/skills/openspec/SKILL.md +10 -6
- package/presets/cursor/skills/testing-tdd/SKILL.md +3 -3
- package/presets/gemini/GEMINI.md +1 -1
- package/presets/gemini/commands/cc/api-contract.toml +1 -1
- package/presets/gemini/commands/cc/ask.toml +2 -2
- package/presets/gemini/commands/cc/db-migration.toml +1 -1
- package/presets/gemini/commands/cc/feature.toml +1 -1
- package/presets/gemini/commands/cc/fix.toml +1 -1
- package/presets/gemini/commands/cc/iterative.toml +1 -1
- package/presets/gemini/commands/cc/odd.toml +2 -2
- package/presets/gemini/commands/cc/openspec.toml +10 -8
- package/presets/gemini/commands/cc/spec-mutation.toml +2 -2
- package/presets/gemini/commands/cc/tdd-cycle.toml +2 -2
- package/presets/muse/AGENTS.md +1 -1
- package/presets/opencode/agents/implementer.md +1 -1
- package/presets/opencode/agents/tester.md +1 -1
- package/presets/opencode/commands/cc-api-contract.md +1 -1
- package/presets/opencode/commands/cc-ask.md +2 -2
- package/presets/opencode/commands/cc-db-migration.md +1 -1
- package/presets/opencode/commands/cc-feature.md +1 -1
- package/presets/opencode/commands/cc-fix.md +1 -1
- package/presets/opencode/commands/cc-iterative.md +1 -1
- package/presets/opencode/commands/cc-odd.md +2 -2
- package/presets/opencode/commands/cc-openspec.md +2 -2
- package/presets/opencode/commands/cc-spec-mutation.md +2 -2
- package/presets/opencode/commands/cc-tdd-cycle.md +2 -2
- package/presets/opencode/prompts/v1.0.0/implementer.md +1 -1
- package/presets/opencode/prompts/v1.0.0/tester.md +1 -1
- package/presets/opencode/skills/backlog/SKILL.md +1 -1
- package/presets/opencode/skills/django-testing/SKILL.md +1 -0
- package/presets/opencode/skills/evaluation/SKILL.md +1 -1
- package/presets/opencode/skills/openspec/SKILL.md +10 -6
- package/presets/opencode/skills/python-django-stack/SKILL.md +1 -0
- package/presets/opencode/skills/python-fastapi-stack/SKILL.md +1 -0
- package/presets/opencode/skills/spring-boot-kotlin/SKILL.md +1 -0
- package/presets/opencode/skills/sqlalchemy/SKILL.md +1 -0
- package/presets/opencode/skills/testing-tdd/SKILL.md +3 -3
- package/presets/pi/AGENTS.md +1 -1
- package/presets/shared/invoke-hook.cjs +43 -24
- package/src/presets/manifests/claude.yml +1 -1
- package/src/presets/shared-skills.yml +30 -0
- package/src/presets/targets/pi.yml +1 -1
|
@@ -66,7 +66,7 @@ If `openspec status` reports an active change folder:
|
|
|
66
66
|
3. If analyze `stop` is true or any finding is CRITICAL, stop. Do not delegate to implementer.
|
|
67
67
|
4. Next command spelling on this runner: `$cc-openspec`
|
|
68
68
|
|
|
69
|
-
|
|
69
|
+
Run the CLI as `npx cc-codeconductor <same argv>`.
|
|
70
70
|
|
|
71
71
|
---
|
|
72
72
|
|
|
@@ -150,11 +150,13 @@ npx cc-codeconductor openspec verify <itemId>
|
|
|
150
150
|
npx cc-codeconductor openspec archive <itemId>
|
|
151
151
|
```
|
|
152
152
|
|
|
153
|
-
`start` moves the card `pending → doing` and the item `PLANNED → IN_PROGRESS`. `done` marks the card complete, updates Progress, and moves the item to `REVIEW` when every card is done and review is required. `sync` merges delta specs into `openspec/specs/` without closing the item (optional before archive). `verify` is the advisory pre-archive checklist: exit 0 with `archiveReady` plus Completeness/Correctness/Coherence issues. `archive` requires all cards done (and review evidence when Global review is required), re-checks planning artifacts and analyze CRITICALs,
|
|
153
|
+
`start` moves the card `pending → doing` and the item `PLANNED → IN_PROGRESS`. `done` marks the card complete, updates Progress, and moves the item to `REVIEW` when every card is done and review is required. `sync` merges delta specs into `openspec/specs/` without closing the item (optional before archive). `verify` is the advisory pre-archive checklist: exit 0 with `archiveReady` plus Completeness/Correctness/Coherence issues. `archive` requires all cards done (and review evidence when Global review is required), re-checks planning artifacts and analyze CRITICALs, fails on unchecked `tasks.md` boxes (override: `--allow-unchecked`), ticks the BACKLOG acceptance criteria, then moves `openspec/changes/<slug>` to `archive/`.
|
|
154
154
|
|
|
155
|
-
For test and implementation cards, `done`
|
|
156
|
-
|
|
157
|
-
|
|
155
|
+
For test and implementation cards, `done` requires current runner-captured TDD
|
|
156
|
+
evidence: `npx cc-codeconductor tdd capture --task <cardId> --phase red|green --command "<test command>"`
|
|
157
|
+
(RED for the test card, GREEN for the implement card). It is `ev-tdd-*` evidence,
|
|
158
|
+
not an RDD receipt: do not pass it to `rdd verify`. Do not reuse evidence after
|
|
159
|
+
candidate files change; capture it again.
|
|
158
160
|
|
|
159
161
|
---
|
|
160
162
|
|
|
@@ -191,9 +193,9 @@ After each phase:
|
|
|
191
193
|
|
|
192
194
|
Implementer: create a Git worktree before editing (`git worktree add ../<branch>-session <branch>`).
|
|
193
195
|
|
|
194
|
-
Discover is read-only: `repo-explorer` never writes code.
|
|
195
|
-
|
|
196
|
-
done. If implementation reveals a design problem, pause and reconcile the
|
|
196
|
+
Discover is read-only: `repo-explorer` never writes code. `openspec done` ticks the boxes tagged
|
|
197
|
+
with that card and keeps your edits; the implementer ticks any other `tasks.md` box
|
|
198
|
+
it adds (`- [ ]` → `- [x]`) — only `x`/`X` counts as done. If implementation reveals a design problem, pause and reconcile the
|
|
197
199
|
planning artifacts first (any direction: a later artifact may force revising an
|
|
198
200
|
earlier one). Planning artifacts only in that step — never code — and confirm
|
|
199
201
|
each edit. If the item's intent changed rather than its details, open a fresh
|
|
@@ -41,7 +41,7 @@ If `openspec status` reports an active change folder:
|
|
|
41
41
|
3. If analyze `stop` is true or any finding is CRITICAL, stop. Do not delegate to implementer.
|
|
42
42
|
4. Next command spelling on this runner: `$cc-spec-mutation`
|
|
43
43
|
|
|
44
|
-
|
|
44
|
+
Run the CLI as `npx cc-codeconductor <same argv>`.
|
|
45
45
|
|
|
46
46
|
---
|
|
47
47
|
|
|
@@ -103,7 +103,7 @@ aborts the pipeline with scorecard 0 (Specification Gaming).
|
|
|
103
103
|
## Stage 3 — TDD under the three laws (`tdd_craftsman`)
|
|
104
104
|
|
|
105
105
|
Delegates to the `$cc-tdd-cycle` state machine (`tddCycleStateMachine` in
|
|
106
|
-
`domain/loop`). Evidence must be captured with `
|
|
106
|
+
`domain/loop`). Evidence must be captured with `npx cc-codeconductor tdd capture` — do
|
|
107
107
|
not hand-edit JSON under `.codeconductor/evidence/`.
|
|
108
108
|
|
|
109
109
|
1. **Law 1 (RED):** no production code except to make a failing test pass. A
|
|
@@ -41,7 +41,7 @@ If `openspec status` reports an active change folder:
|
|
|
41
41
|
3. If analyze `stop` is true or any finding is CRITICAL, stop. Do not delegate to implementer.
|
|
42
42
|
4. Next command spelling on this runner: `$cc-tdd-cycle`
|
|
43
43
|
|
|
44
|
-
|
|
44
|
+
Run the CLI as `npx cc-codeconductor <same argv>`.
|
|
45
45
|
|
|
46
46
|
---
|
|
47
47
|
|
|
@@ -61,7 +61,7 @@ Mixing phases invalidates the cycle.
|
|
|
61
61
|
## Verifiable phase gates
|
|
62
62
|
|
|
63
63
|
RED → GREEN and GREEN → REFACTOR are enforced by `tddCycleStateMachine` in
|
|
64
|
-
`domain/loop`. Evidence must be captured with `
|
|
64
|
+
`domain/loop`. Evidence must be captured with `npx cc-codeconductor tdd capture` (verification
|
|
65
65
|
runner) — do not hand-edit JSON under `.codeconductor/evidence/`.
|
|
66
66
|
|
|
67
67
|
- RED→GREEN requires runner evidence that the suite **failed**.
|
|
@@ -411,4 +411,4 @@ def test_order_creation(self, mock_atomic):
|
|
|
411
411
|
`apps/pos/tests/test_temporal_cart.py`
|
|
412
412
|
- **Multi-decorator bypass**: `apps/catalog/tests/test_api_catalog_products.py`
|
|
413
413
|
- **pytest config**: `pyproject.toml` → `[tool.pytest.ini_options]`
|
|
414
|
-
- **pytest-django docs**: https://pytest-django.readthedocs.io
|
|
414
|
+
- **pytest-django docs**: <https://pytest-django.readthedocs.io/>
|
|
@@ -24,7 +24,7 @@ coding rules.
|
|
|
24
24
|
|
|
25
25
|
## Process
|
|
26
26
|
|
|
27
|
-
|
|
27
|
+
The CLI is always `npx cc-codeconductor`.
|
|
28
28
|
|
|
29
29
|
1. `openspec validate` — must pass before delivery. If you reached this
|
|
30
30
|
workflow on your own (the user did not ask for OpenSpec) and there is no
|
|
@@ -40,9 +40,13 @@ Local CLI is `bun run dev`. Published package is `npx cc-codeconductor`.
|
|
|
40
40
|
5. Phases: discover (`repo-explorer`) → design (`architect`) → test (`tester`) →
|
|
41
41
|
implement (`implementer`) → review (`reviewer`). If Global `TDD required: yes`,
|
|
42
42
|
test runs before implement. Discover is read-only: it never writes code.
|
|
43
|
-
6. `openspec done` on test/implement
|
|
44
|
-
|
|
45
|
-
(
|
|
43
|
+
6. `openspec done` on test/implement needs runner evidence: run
|
|
44
|
+
`npx cc-codeconductor tdd capture --task <cardId> --phase red|green --command "<test command>"`
|
|
45
|
+
first (RED on the test card, GREEN on the implement card). Handmade evidence JSON is
|
|
46
|
+
rejected. It is `ev-tdd-*` evidence, not an RDD receipt (`ev-rdd-*`, `rdd verify`).
|
|
47
|
+
`done` ticks that card's `tasks.md` boxes and keeps your edits; the implementer ticks
|
|
48
|
+
any other box it adds (`- [ ]` → `- [x]`, only `x`/`X` counts). `archive` fails while
|
|
49
|
+
boxes stay unchecked (override: `--allow-unchecked`).
|
|
46
50
|
7. When implementation reveals a design problem, pause and reconcile the planning
|
|
47
51
|
artifacts first — in any direction (a later artifact may force revising an
|
|
48
52
|
earlier one). Planning artifacts only in that step, never code; confirm each
|
|
@@ -54,7 +58,7 @@ Local CLI is `bun run dev`. Published package is `npx cc-codeconductor`.
|
|
|
54
58
|
9. `scorecard create --task BC-xxx --from-diff` then record a verdict.
|
|
55
59
|
10. `openspec archive` only after human review when `Review required: yes` and
|
|
56
60
|
the scorecard is PASS. Archive re-checks planning artifacts and analyze
|
|
57
|
-
CRITICALs, and
|
|
61
|
+
CRITICALs, and fails on unchecked `tasks.md` boxes (override: `--allow-unchecked`), ticks the BACKLOG acceptance criteria.
|
|
58
62
|
|
|
59
63
|
Status machine: `TODO` → `READY` → `PLANNED` → `IN_PROGRESS` → `REVIEW` → `DONE`
|
|
60
64
|
→ Archive. `BLOCKED` returns to `READY`. Reviewer rejection: `REVIEW` →
|
|
@@ -111,4 +115,4 @@ delivery read-only and record unavailable visual or emulator evidence as pending
|
|
|
111
115
|
- [ ] `tasks.md` boxes ticked as FRs land
|
|
112
116
|
- [ ] `openspec verify --output json` checked before archive
|
|
113
117
|
- [ ] `scorecard create --from-diff` recorded
|
|
114
|
-
- [ ] Suite check (optional): `
|
|
118
|
+
- [ ] Suite check (optional): `npx cc-codeconductor scorecard suite-run --suite workflow-gates`
|
|
@@ -494,4 +494,4 @@ make migrate # migrate_schemas --shared + --tenant
|
|
|
494
494
|
- **PDF pattern**: `apps/catalog/reports.py`
|
|
495
495
|
- **Cart pattern**: `apps/pos/pos_cart.py`, `apps/cart/cart.py`
|
|
496
496
|
- **Pagination**: `apps/catalog/views.py` (api_catalog_products)
|
|
497
|
-
- **Django docs**: https://docs.djangoproject.com/en/5.2
|
|
497
|
+
- **Django docs**: <https://docs.djangoproject.com/en/5.2/>
|
|
@@ -11,7 +11,7 @@ description:
|
|
|
11
11
|
## Overview
|
|
12
12
|
|
|
13
13
|
Red (failing test) → Green (minimal code) → Refactor. Evidence comes from
|
|
14
|
-
`
|
|
14
|
+
`npx cc-codeconductor tdd capture`, not handmade JSON.
|
|
15
15
|
|
|
16
16
|
## When to Use
|
|
17
17
|
|
|
@@ -29,7 +29,7 @@ Red (failing test) → Green (minimal code) → Refactor. Evidence comes from
|
|
|
29
29
|
when TDD is required).
|
|
30
30
|
5. Cover happy path, edge, and error for each behavior.
|
|
31
31
|
|
|
32
|
-
|
|
32
|
+
Pyramid default: many unit, fewer integration, rare E2E.
|
|
33
33
|
|
|
34
34
|
## Common Rationalizations
|
|
35
35
|
|
|
@@ -50,4 +50,4 @@ Local: `bun run dev`. Pyramid default: many unit, fewer integration, rare E2E.
|
|
|
50
50
|
- [ ] Suite failed before implement
|
|
51
51
|
- [ ] Suite passed after implement
|
|
52
52
|
- [ ] Runner evidence exists (not handmade)
|
|
53
|
-
- [ ] Optional: `
|
|
53
|
+
- [ ] Optional: `npx cc-codeconductor scorecard suite-run --suite workflow-gates`
|
package/presets/cursor/AGENTS.md
CHANGED
|
@@ -461,7 +461,7 @@ docs | test **Risk:** low | medium | high **Scope:** [files or modules affected]
|
|
|
461
461
|
|
|
462
462
|
## Receipt integrity
|
|
463
463
|
|
|
464
|
-
- For any implementation, test, review, handoff, or delivery decision, capture or verify the current RDD receipt with `
|
|
464
|
+
- For any implementation, test, review, handoff, or delivery decision, capture or verify the current RDD receipt with `npx cc-codeconductor rdd`.
|
|
465
465
|
- A receipt is valid only for its exact candidate. If code, tests, contracts, or runner configuration changed, repeat the affected verification.
|
|
466
466
|
- TDD and Mutation Testing retain their existing gates; RDD verifies that their observed evidence still belongs to the current candidate.
|
|
467
467
|
|
|
@@ -28,7 +28,7 @@ If `openspec status` reports an active change folder:
|
|
|
28
28
|
3. If analyze `stop` is true or any finding is CRITICAL, stop. Do not delegate to implementer.
|
|
29
29
|
4. Next command spelling on this runner: `/cc:api-contract`
|
|
30
30
|
|
|
31
|
-
|
|
31
|
+
Run the CLI as `npx cc-codeconductor <same argv>`.
|
|
32
32
|
|
|
33
33
|
---
|
|
34
34
|
|
|
@@ -15,10 +15,10 @@ Do **not** run the recommended `/cc:` command unless the human confirms.
|
|
|
15
15
|
|
|
16
16
|
## Step 1 — Recommend (deterministic)
|
|
17
17
|
|
|
18
|
-
Run
|
|
18
|
+
Run `npx cc-codeconductor`:
|
|
19
19
|
|
|
20
20
|
```bash
|
|
21
|
-
|
|
21
|
+
npx cc-codeconductor ask "$ARGUMENTS" --output json
|
|
22
22
|
```
|
|
23
23
|
|
|
24
24
|
or:
|
|
@@ -29,7 +29,7 @@ If `openspec status` reports an active change folder:
|
|
|
29
29
|
3. If analyze `stop` is true or any finding is CRITICAL, stop. Do not delegate to implementer.
|
|
30
30
|
4. Next command spelling on this runner: `/cc:db-migration`
|
|
31
31
|
|
|
32
|
-
|
|
32
|
+
Run the CLI as `npx cc-codeconductor <same argv>`.
|
|
33
33
|
|
|
34
34
|
---
|
|
35
35
|
|
|
@@ -53,7 +53,7 @@ If `openspec status` reports an active change folder:
|
|
|
53
53
|
3. If analyze `stop` is true or any finding is CRITICAL, stop. Do not delegate to implementer.
|
|
54
54
|
4. Next command spelling on this runner: `/cc:feature`
|
|
55
55
|
|
|
56
|
-
|
|
56
|
+
Run the CLI as `npx cc-codeconductor <same argv>`.
|
|
57
57
|
|
|
58
58
|
Skills: `using-cc-skills`, `openspec`, `testing-tdd`, `evaluation`.
|
|
59
59
|
Do not skip `openspec analyze` when a change folder is active.
|
|
@@ -61,7 +61,7 @@ If `openspec status` reports an active change folder:
|
|
|
61
61
|
3. If analyze `stop` is true or any finding is CRITICAL, stop. Do not delegate to implementer.
|
|
62
62
|
4. Next command spelling on this runner: `/cc:fix`
|
|
63
63
|
|
|
64
|
-
|
|
64
|
+
Run the CLI as `npx cc-codeconductor <same argv>`.
|
|
65
65
|
|
|
66
66
|
---
|
|
67
67
|
|
|
@@ -31,7 +31,7 @@ If `openspec status` reports an active change folder:
|
|
|
31
31
|
3. If analyze `stop` is true or any finding is CRITICAL, stop. Do not delegate to implementer.
|
|
32
32
|
4. Next command spelling on this runner: `/cc:iterative`
|
|
33
33
|
|
|
34
|
-
|
|
34
|
+
Run the CLI as `npx cc-codeconductor <same argv>`.
|
|
35
35
|
|
|
36
36
|
---
|
|
37
37
|
|
|
@@ -7,8 +7,8 @@ description: Create or resume an opt-in Delivery Ledger for substantial authoriz
|
|
|
7
7
|
## Step 0 — CCEP Bootstrap
|
|
8
8
|
|
|
9
9
|
```bash
|
|
10
|
-
|
|
11
|
-
|
|
10
|
+
npx cc-codeconductor ccep profile odd --output json
|
|
11
|
+
npx cc-codeconductor ccep compile --command odd --phase <phase-id> "$ARGUMENTS" --view prompt --output json
|
|
12
12
|
```
|
|
13
13
|
|
|
14
14
|
Pass each subagent only the compiled `prompt` for its phase.
|
|
@@ -57,7 +57,7 @@ If `openspec status` reports an active change folder:
|
|
|
57
57
|
3. If analyze `stop` is true or any finding is CRITICAL, stop. Do not delegate to implementer.
|
|
58
58
|
4. Next command spelling on this runner: `/cc:openspec`
|
|
59
59
|
|
|
60
|
-
|
|
60
|
+
Run the CLI as `npx cc-codeconductor <same argv>`.
|
|
61
61
|
|
|
62
62
|
---
|
|
63
63
|
|
|
@@ -141,11 +141,13 @@ npx cc-codeconductor openspec verify <itemId>
|
|
|
141
141
|
npx cc-codeconductor openspec archive <itemId>
|
|
142
142
|
```
|
|
143
143
|
|
|
144
|
-
`start` moves the card `pending → doing` and the item `PLANNED → IN_PROGRESS`. `done` marks the card complete, updates Progress, and moves the item to `REVIEW` when every card is done and review is required. `sync` merges delta specs into `openspec/specs/` without closing the item (optional before archive). `verify` is the advisory pre-archive checklist: exit 0 with `archiveReady` plus Completeness/Correctness/Coherence issues. `archive` requires all cards done (and review evidence when Global review is required), re-checks planning artifacts and analyze CRITICALs,
|
|
144
|
+
`start` moves the card `pending → doing` and the item `PLANNED → IN_PROGRESS`. `done` marks the card complete, updates Progress, and moves the item to `REVIEW` when every card is done and review is required. `sync` merges delta specs into `openspec/specs/` without closing the item (optional before archive). `verify` is the advisory pre-archive checklist: exit 0 with `archiveReady` plus Completeness/Correctness/Coherence issues. `archive` requires all cards done (and review evidence when Global review is required), re-checks planning artifacts and analyze CRITICALs, fails on unchecked `tasks.md` boxes (override: `--allow-unchecked`), ticks the BACKLOG acceptance criteria, then moves `openspec/changes/<slug>` to `archive/`.
|
|
145
145
|
|
|
146
|
-
For test and implementation cards, `done`
|
|
147
|
-
|
|
148
|
-
|
|
146
|
+
For test and implementation cards, `done` requires current runner-captured TDD
|
|
147
|
+
evidence: `npx cc-codeconductor tdd capture --task <cardId> --phase red|green --command "<test command>"`
|
|
148
|
+
(RED for the test card, GREEN for the implement card). It is `ev-tdd-*` evidence,
|
|
149
|
+
not an RDD receipt: do not pass it to `rdd verify`. Do not reuse evidence after
|
|
150
|
+
candidate files change; capture it again.
|
|
149
151
|
|
|
150
152
|
---
|
|
151
153
|
|
|
@@ -182,9 +184,9 @@ After each phase:
|
|
|
182
184
|
|
|
183
185
|
Implementer: create a Git worktree before editing (`git worktree add ../<branch>-session <branch>`).
|
|
184
186
|
|
|
185
|
-
Discover is read-only: `repo-explorer` never writes code.
|
|
186
|
-
|
|
187
|
-
done. If implementation reveals a design problem, pause and reconcile the
|
|
187
|
+
Discover is read-only: `repo-explorer` never writes code. `openspec done` ticks the boxes tagged
|
|
188
|
+
with that card and keeps your edits; the implementer ticks any other `tasks.md` box
|
|
189
|
+
it adds (`- [ ]` → `- [x]`) — only `x`/`X` counts as done. If implementation reveals a design problem, pause and reconcile the
|
|
188
190
|
planning artifacts first (any direction: a later artifact may force revising an
|
|
189
191
|
earlier one). Planning artifacts only in that step — never code — and confirm
|
|
190
192
|
each edit. If the item's intent changed rather than its details, open a fresh
|
|
@@ -39,7 +39,7 @@ If `openspec status` reports an active change folder:
|
|
|
39
39
|
3. If analyze `stop` is true or any finding is CRITICAL, stop. Do not delegate to implementer.
|
|
40
40
|
4. Next command spelling on this runner: `/cc:spec-mutation`
|
|
41
41
|
|
|
42
|
-
|
|
42
|
+
Run the CLI as `npx cc-codeconductor <same argv>`.
|
|
43
43
|
|
|
44
44
|
---
|
|
45
45
|
|
|
@@ -101,7 +101,7 @@ aborts the pipeline with scorecard 0 (Specification Gaming).
|
|
|
101
101
|
## Stage 3 — TDD under the three laws (`tdd_craftsman`)
|
|
102
102
|
|
|
103
103
|
Delegates to the `/cc:tdd-cycle` state machine (`tddCycleStateMachine` in
|
|
104
|
-
`domain/loop`). Evidence must be captured with `
|
|
104
|
+
`domain/loop`). Evidence must be captured with `npx cc-codeconductor tdd capture` — do
|
|
105
105
|
not hand-edit JSON under `.codeconductor/evidence/`.
|
|
106
106
|
|
|
107
107
|
1. **Law 1 (RED):** no production code except to make a failing test pass. A
|
|
@@ -39,7 +39,7 @@ If `openspec status` reports an active change folder:
|
|
|
39
39
|
3. If analyze `stop` is true or any finding is CRITICAL, stop. Do not delegate to implementer.
|
|
40
40
|
4. Next command spelling on this runner: `/cc:tdd-cycle`
|
|
41
41
|
|
|
42
|
-
|
|
42
|
+
Run the CLI as `npx cc-codeconductor <same argv>`.
|
|
43
43
|
|
|
44
44
|
---
|
|
45
45
|
|
|
@@ -59,7 +59,7 @@ Mixing phases invalidates the cycle.
|
|
|
59
59
|
## Verifiable phase gates
|
|
60
60
|
|
|
61
61
|
RED → GREEN and GREEN → REFACTOR are enforced by `tddCycleStateMachine` in
|
|
62
|
-
`domain/loop`. Evidence must be captured with `
|
|
62
|
+
`domain/loop`. Evidence must be captured with `npx cc-codeconductor tdd capture` (verification
|
|
63
63
|
runner) — do not hand-edit JSON under `.codeconductor/evidence/`.
|
|
64
64
|
|
|
65
65
|
- RED→GREEN requires runner evidence that the suite **failed**.
|
|
@@ -29,7 +29,7 @@ the item here.
|
|
|
29
29
|
4. Create `BACKLOG.md` from `presets/templates/BACKLOG.md` or append under
|
|
30
30
|
`## Items`. Do not rewrite `## Global` or `## Archive`.
|
|
31
31
|
5. Next ID = max numeric suffix in Items + Archive + 1, zero-padded (`BC-013`).
|
|
32
|
-
6. `
|
|
32
|
+
6. `npx cc-codeconductor openspec validate`. Fix until valid.
|
|
33
33
|
7. `openspec plan BC-xxx` for each **new** item this run. Then tell the user
|
|
34
34
|
to run `/cc-openspec`.
|
|
35
35
|
|
|
@@ -24,7 +24,7 @@ coding rules.
|
|
|
24
24
|
|
|
25
25
|
## Process
|
|
26
26
|
|
|
27
|
-
|
|
27
|
+
The CLI is always `npx cc-codeconductor`.
|
|
28
28
|
|
|
29
29
|
1. `openspec validate` — must pass before delivery. If you reached this
|
|
30
30
|
workflow on your own (the user did not ask for OpenSpec) and there is no
|
|
@@ -40,9 +40,13 @@ Local CLI is `bun run dev`. Published package is `npx cc-codeconductor`.
|
|
|
40
40
|
5. Phases: discover (`repo-explorer`) → design (`architect`) → test (`tester`) →
|
|
41
41
|
implement (`implementer`) → review (`reviewer`). If Global `TDD required: yes`,
|
|
42
42
|
test runs before implement. Discover is read-only: it never writes code.
|
|
43
|
-
6. `openspec done` on test/implement
|
|
44
|
-
|
|
45
|
-
(
|
|
43
|
+
6. `openspec done` on test/implement needs runner evidence: run
|
|
44
|
+
`npx cc-codeconductor tdd capture --task <cardId> --phase red|green --command "<test command>"`
|
|
45
|
+
first (RED on the test card, GREEN on the implement card). Handmade evidence JSON is
|
|
46
|
+
rejected. It is `ev-tdd-*` evidence, not an RDD receipt (`ev-rdd-*`, `rdd verify`).
|
|
47
|
+
`done` ticks that card's `tasks.md` boxes and keeps your edits; the implementer ticks
|
|
48
|
+
any other box it adds (`- [ ]` → `- [x]`, only `x`/`X` counts). `archive` fails while
|
|
49
|
+
boxes stay unchecked (override: `--allow-unchecked`).
|
|
46
50
|
7. When implementation reveals a design problem, pause and reconcile the planning
|
|
47
51
|
artifacts first — in any direction (a later artifact may force revising an
|
|
48
52
|
earlier one). Planning artifacts only in that step, never code; confirm each
|
|
@@ -54,7 +58,7 @@ Local CLI is `bun run dev`. Published package is `npx cc-codeconductor`.
|
|
|
54
58
|
9. `scorecard create --task BC-xxx --from-diff` then record a verdict.
|
|
55
59
|
10. `openspec archive` only after human review when `Review required: yes` and
|
|
56
60
|
the scorecard is PASS. Archive re-checks planning artifacts and analyze
|
|
57
|
-
CRITICALs, and
|
|
61
|
+
CRITICALs, and fails on unchecked `tasks.md` boxes (override: `--allow-unchecked`), ticks the BACKLOG acceptance criteria.
|
|
58
62
|
|
|
59
63
|
Status machine: `TODO` → `READY` → `PLANNED` → `IN_PROGRESS` → `REVIEW` → `DONE`
|
|
60
64
|
→ Archive. `BLOCKED` returns to `READY`. Reviewer rejection: `REVIEW` →
|
|
@@ -111,4 +115,4 @@ delivery read-only and record unavailable visual or emulator evidence as pending
|
|
|
111
115
|
- [ ] `tasks.md` boxes ticked as FRs land
|
|
112
116
|
- [ ] `openspec verify --output json` checked before archive
|
|
113
117
|
- [ ] `scorecard create --from-diff` recorded
|
|
114
|
-
- [ ] Suite check (optional): `
|
|
118
|
+
- [ ] Suite check (optional): `npx cc-codeconductor scorecard suite-run --suite workflow-gates`
|
|
@@ -11,7 +11,7 @@ description:
|
|
|
11
11
|
## Overview
|
|
12
12
|
|
|
13
13
|
Red (failing test) → Green (minimal code) → Refactor. Evidence comes from
|
|
14
|
-
`
|
|
14
|
+
`npx cc-codeconductor tdd capture`, not handmade JSON.
|
|
15
15
|
|
|
16
16
|
## When to Use
|
|
17
17
|
|
|
@@ -29,7 +29,7 @@ Red (failing test) → Green (minimal code) → Refactor. Evidence comes from
|
|
|
29
29
|
when TDD is required).
|
|
30
30
|
5. Cover happy path, edge, and error for each behavior.
|
|
31
31
|
|
|
32
|
-
|
|
32
|
+
Pyramid default: many unit, fewer integration, rare E2E.
|
|
33
33
|
|
|
34
34
|
## Common Rationalizations
|
|
35
35
|
|
|
@@ -50,4 +50,4 @@ Local: `bun run dev`. Pyramid default: many unit, fewer integration, rare E2E.
|
|
|
50
50
|
- [ ] Suite failed before implement
|
|
51
51
|
- [ ] Suite passed after implement
|
|
52
52
|
- [ ] Runner evidence exists (not handmade)
|
|
53
|
-
- [ ] Optional: `
|
|
53
|
+
- [ ] Optional: `npx cc-codeconductor scorecard suite-run --suite workflow-gates`
|
package/presets/gemini/GEMINI.md
CHANGED
|
@@ -37,7 +37,7 @@ intent to the right slash command.
|
|
|
37
37
|
|
|
38
38
|
## Receipt integrity
|
|
39
39
|
|
|
40
|
-
- For any implementation, test, review, handoff, or delivery decision, capture or verify the current RDD receipt with `
|
|
40
|
+
- For any implementation, test, review, handoff, or delivery decision, capture or verify the current RDD receipt with `npx cc-codeconductor rdd`.
|
|
41
41
|
- A receipt is valid only for its exact candidate. If code, tests, contracts, or runner configuration changed, repeat the affected verification.
|
|
42
42
|
- TDD and Mutation Testing retain their existing gates; RDD verifies that their observed evidence still belongs to the current candidate.
|
|
43
43
|
|
|
@@ -25,7 +25,7 @@ If `openspec status` reports an active change folder:
|
|
|
25
25
|
3. If analyze `stop` is true or any finding is CRITICAL, stop. Do not delegate to implementer.
|
|
26
26
|
4. Next command spelling on this runner: `/cc:api-contract`
|
|
27
27
|
|
|
28
|
-
|
|
28
|
+
Run the CLI as `npx cc-codeconductor <same argv>`.
|
|
29
29
|
|
|
30
30
|
---
|
|
31
31
|
|
|
@@ -12,10 +12,10 @@ Do **not** run the recommended `/cc:` command unless the human confirms.
|
|
|
12
12
|
|
|
13
13
|
## Step 1 — Recommend (deterministic)
|
|
14
14
|
|
|
15
|
-
Run
|
|
15
|
+
Run `npx cc-codeconductor`:
|
|
16
16
|
|
|
17
17
|
```bash
|
|
18
|
-
|
|
18
|
+
npx cc-codeconductor ask "{{args}}" --output json
|
|
19
19
|
```
|
|
20
20
|
|
|
21
21
|
or:
|
|
@@ -26,7 +26,7 @@ If `openspec status` reports an active change folder:
|
|
|
26
26
|
3. If analyze `stop` is true or any finding is CRITICAL, stop. Do not delegate to implementer.
|
|
27
27
|
4. Next command spelling on this runner: `/cc:db-migration`
|
|
28
28
|
|
|
29
|
-
|
|
29
|
+
Run the CLI as `npx cc-codeconductor <same argv>`.
|
|
30
30
|
|
|
31
31
|
---
|
|
32
32
|
|
|
@@ -50,7 +50,7 @@ If `openspec status` reports an active change folder:
|
|
|
50
50
|
3. If analyze `stop` is true or any finding is CRITICAL, stop. Do not delegate to implementer.
|
|
51
51
|
4. Next command spelling on this runner: `/cc:feature`
|
|
52
52
|
|
|
53
|
-
|
|
53
|
+
Run the CLI as `npx cc-codeconductor <same argv>`.
|
|
54
54
|
|
|
55
55
|
Skills: `using-cc-skills`, `openspec`, `testing-tdd`, `evaluation`.
|
|
56
56
|
Do not skip `openspec analyze` when a change folder is active.
|
|
@@ -58,7 +58,7 @@ If `openspec status` reports an active change folder:
|
|
|
58
58
|
3. If analyze `stop` is true or any finding is CRITICAL, stop. Do not delegate to implementer.
|
|
59
59
|
4. Next command spelling on this runner: `/cc:fix`
|
|
60
60
|
|
|
61
|
-
|
|
61
|
+
Run the CLI as `npx cc-codeconductor <same argv>`.
|
|
62
62
|
|
|
63
63
|
---
|
|
64
64
|
|
|
@@ -28,7 +28,7 @@ If `openspec status` reports an active change folder:
|
|
|
28
28
|
3. If analyze `stop` is true or any finding is CRITICAL, stop. Do not delegate to implementer.
|
|
29
29
|
4. Next command spelling on this runner: `/cc:iterative`
|
|
30
30
|
|
|
31
|
-
|
|
31
|
+
Run the CLI as `npx cc-codeconductor <same argv>`.
|
|
32
32
|
|
|
33
33
|
---
|
|
34
34
|
|
|
@@ -6,8 +6,8 @@ prompt = """
|
|
|
6
6
|
## Step 0 — CCEP Bootstrap
|
|
7
7
|
|
|
8
8
|
```bash
|
|
9
|
-
|
|
10
|
-
|
|
9
|
+
npx cc-codeconductor ccep profile odd --output json
|
|
10
|
+
npx cc-codeconductor ccep compile --command odd --phase <phase-id> "{{args}}" --view prompt --output json
|
|
11
11
|
```
|
|
12
12
|
|
|
13
13
|
Pass each subagent only the compiled `prompt` for its phase.
|
|
@@ -54,7 +54,7 @@ If `openspec status` reports an active change folder:
|
|
|
54
54
|
3. If analyze `stop` is true or any finding is CRITICAL, stop. Do not delegate to implementer.
|
|
55
55
|
4. Next command spelling on this runner: `/cc:openspec`
|
|
56
56
|
|
|
57
|
-
|
|
57
|
+
Run the CLI as `npx cc-codeconductor <same argv>`.
|
|
58
58
|
|
|
59
59
|
---
|
|
60
60
|
|
|
@@ -138,11 +138,13 @@ npx cc-codeconductor openspec verify <itemId>
|
|
|
138
138
|
npx cc-codeconductor openspec archive <itemId>
|
|
139
139
|
```
|
|
140
140
|
|
|
141
|
-
`start` moves the card `pending → doing` and the item `PLANNED → IN_PROGRESS`. `done` marks the card complete, updates Progress, and moves the item to `REVIEW` when every card is done and review is required. `sync` merges delta specs into `openspec/specs/` without closing the item (optional before archive). `verify` is the advisory pre-archive checklist: exit 0 with `archiveReady` plus Completeness/Correctness/Coherence issues. `archive` requires all cards done (and review evidence when Global review is required), re-checks planning artifacts and analyze CRITICALs,
|
|
141
|
+
`start` moves the card `pending → doing` and the item `PLANNED → IN_PROGRESS`. `done` marks the card complete, updates Progress, and moves the item to `REVIEW` when every card is done and review is required. `sync` merges delta specs into `openspec/specs/` without closing the item (optional before archive). `verify` is the advisory pre-archive checklist: exit 0 with `archiveReady` plus Completeness/Correctness/Coherence issues. `archive` requires all cards done (and review evidence when Global review is required), re-checks planning artifacts and analyze CRITICALs, fails on unchecked `tasks.md` boxes (override: `--allow-unchecked`), ticks the BACKLOG acceptance criteria, then moves `openspec/changes/<slug>` to `archive/`.
|
|
142
142
|
|
|
143
|
-
For test and implementation cards, `done`
|
|
144
|
-
|
|
145
|
-
|
|
143
|
+
For test and implementation cards, `done` requires current runner-captured TDD
|
|
144
|
+
evidence: `npx cc-codeconductor tdd capture --task <cardId> --phase red|green --command "<test command>"`
|
|
145
|
+
(RED for the test card, GREEN for the implement card). It is `ev-tdd-*` evidence,
|
|
146
|
+
not an RDD receipt: do not pass it to `rdd verify`. Do not reuse evidence after
|
|
147
|
+
candidate files change; capture it again.
|
|
146
148
|
|
|
147
149
|
---
|
|
148
150
|
|
|
@@ -179,9 +181,9 @@ After each phase:
|
|
|
179
181
|
|
|
180
182
|
Implementer: create a Git worktree before editing (`git worktree add ../<branch>-session <branch>`).
|
|
181
183
|
|
|
182
|
-
Discover is read-only: `repo-explorer` never writes code.
|
|
183
|
-
|
|
184
|
-
done. If implementation reveals a design problem, pause and reconcile the
|
|
184
|
+
Discover is read-only: `repo-explorer` never writes code. `openspec done` ticks the boxes tagged
|
|
185
|
+
with that card and keeps your edits; the implementer ticks any other `tasks.md` box
|
|
186
|
+
it adds (`- [ ]` → `- [x]`) — only `x`/`X` counts as done. If implementation reveals a design problem, pause and reconcile the
|
|
185
187
|
planning artifacts first (any direction: a later artifact may force revising an
|
|
186
188
|
earlier one). Planning artifacts only in that step — never code — and confirm
|
|
187
189
|
each edit. If the item's intent changed rather than its details, open a fresh
|
|
@@ -35,7 +35,7 @@ If `openspec status` reports an active change folder:
|
|
|
35
35
|
3. If analyze `stop` is true or any finding is CRITICAL, stop. Do not delegate to implementer.
|
|
36
36
|
4. Next command spelling on this runner: `/cc:spec-mutation`
|
|
37
37
|
|
|
38
|
-
|
|
38
|
+
Run the CLI as `npx cc-codeconductor <same argv>`.
|
|
39
39
|
|
|
40
40
|
---
|
|
41
41
|
|
|
@@ -97,7 +97,7 @@ aborts the pipeline with scorecard 0 (Specification Gaming).
|
|
|
97
97
|
## Stage 3 — TDD under the three laws (`tdd_craftsman`)
|
|
98
98
|
|
|
99
99
|
Delegates to the `/cc:tdd-cycle` state machine (`tddCycleStateMachine` in
|
|
100
|
-
`domain/loop`). Evidence must be captured with `
|
|
100
|
+
`domain/loop`). Evidence must be captured with `npx cc-codeconductor tdd capture` — do
|
|
101
101
|
not hand-edit JSON under `.codeconductor/evidence/`.
|
|
102
102
|
|
|
103
103
|
1. **Law 1 (RED):** no production code except to make a failing test pass. A
|
|
@@ -35,7 +35,7 @@ If `openspec status` reports an active change folder:
|
|
|
35
35
|
3. If analyze `stop` is true or any finding is CRITICAL, stop. Do not delegate to implementer.
|
|
36
36
|
4. Next command spelling on this runner: `/cc:tdd-cycle`
|
|
37
37
|
|
|
38
|
-
|
|
38
|
+
Run the CLI as `npx cc-codeconductor <same argv>`.
|
|
39
39
|
|
|
40
40
|
---
|
|
41
41
|
|
|
@@ -55,7 +55,7 @@ Mixing phases invalidates the cycle.
|
|
|
55
55
|
## Verifiable phase gates
|
|
56
56
|
|
|
57
57
|
RED → GREEN and GREEN → REFACTOR are enforced by `tddCycleStateMachine` in
|
|
58
|
-
`domain/loop`. Evidence must be captured with `
|
|
58
|
+
`domain/loop`. Evidence must be captured with `npx cc-codeconductor tdd capture` (verification
|
|
59
59
|
runner) — do not hand-edit JSON under `.codeconductor/evidence/`.
|
|
60
60
|
|
|
61
61
|
- RED→GREEN requires runner evidence that the suite **failed**.
|
package/presets/muse/AGENTS.md
CHANGED
|
@@ -39,7 +39,7 @@ Where a step says "adopt the `X` role", read the matching skill under
|
|
|
39
39
|
|
|
40
40
|
## Receipt integrity
|
|
41
41
|
|
|
42
|
-
- For any implementation, test, review, handoff, or delivery decision, capture or verify the current RDD receipt with `
|
|
42
|
+
- For any implementation, test, review, handoff, or delivery decision, capture or verify the current RDD receipt with `npx cc-codeconductor rdd`.
|
|
43
43
|
- A receipt is valid only for its exact candidate. If code, tests, contracts, or runner configuration changed, repeat the affected verification.
|
|
44
44
|
- TDD and Mutation Testing retain their existing gates; RDD verifies that their observed evidence still belongs to the current candidate.
|
|
45
45
|
|
|
@@ -221,6 +221,6 @@ tests. On **REJECT**, stop and escalate to the orchestrator.
|
|
|
221
221
|
Invoke via `/cc-feature`, `/cc-fix`, `/cc-tdd-cycle`, or the orchestrator.
|
|
222
222
|
Do not invoke other agents. Invoke skill `testing-tdd`.
|
|
223
223
|
Deliverable is incomplete without a passing suite and runner TDD evidence when
|
|
224
|
-
TDD is required. Scorecard: `
|
|
224
|
+
TDD is required. Scorecard: `npx cc-codeconductor scorecard create --from-diff`.
|
|
225
225
|
Before handing work to review or delivery, verify the current RDD receipt. Do
|
|
226
226
|
not rely on a test result if its candidate has changed.
|