cc-codeconductor 0.5.0 → 1.1.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 +387 -150
- package/dist/cli/errors.d.ts +65 -0
- package/dist/core/compilation/compile-checker.d.ts +53 -0
- package/dist/core/config/codeconductor-config.d.ts +42 -0
- package/dist/core/config/config-loader.d.ts +11 -0
- package/dist/core/filesystem/credential-guard.d.ts +18 -0
- package/dist/core/goal/goal-planner.d.ts +8 -0
- package/dist/core/goal/goal-state.d.ts +15 -0
- package/dist/core/loop/git-stats.d.ts +13 -0
- package/dist/core/loop/loop-engine.d.ts +82 -0
- package/dist/core/memory/episodic-store.d.ts +6 -0
- package/dist/core/memory/operational-state.d.ts +6 -0
- package/dist/core/orchestrator/runtime-orchestrator.d.ts +25 -0
- package/dist/core/planner/product-planner.d.ts +18 -0
- package/dist/core/presets/package-paths.d.ts +4 -0
- package/dist/core/product-graph/graph-store.d.ts +11 -0
- package/dist/core/product-graph/paths.d.ts +18 -0
- package/dist/core/verification/verification-runner.d.ts +57 -0
- package/dist/domain/loop/loop-state.d.ts +74 -0
- package/dist/domain/product/entities.d.ts +11 -0
- package/dist/index.d.ts +15 -0
- package/dist/index.js +24165 -15800
- package/dist/library.js +2744 -0
- package/dist/utils/result.d.ts +36 -0
- package/dist/validation/schemas.d.ts +4006 -0
- package/package.json +18 -2
- package/policy.yml +12 -11
- package/presets/agy/AGENTS.md +14 -5
- package/presets/agy/gates/pre-commit/GATE.md +137 -0
- package/presets/agy/skills/backlog/SKILL.md +91 -0
- package/presets/agy/skills/cc-fix/SKILL.md +2 -2
- package/presets/agy/skills/cc-tdd-cycle/SKILL.md +11 -0
- package/presets/agy/skills/openspec/SKILL.md +5 -1
- package/presets/agy/skills/security-ai-llm/SKILL.md +43 -0
- package/presets/agy/skills/security-blue-team/SKILL.md +43 -0
- package/presets/agy/skills/security-cloud/SKILL.md +43 -0
- package/presets/agy/skills/security-crypto/SKILL.md +43 -0
- package/presets/agy/skills/security-exploit-dev/SKILL.md +45 -0
- package/presets/agy/skills/security-grc/SKILL.md +43 -0
- package/presets/agy/skills/security-incident-response/SKILL.md +45 -0
- package/presets/agy/skills/security-log-analysis/SKILL.md +43 -0
- package/presets/agy/skills/security-malware-analysis/SKILL.md +44 -0
- package/presets/agy/skills/security-mobile/SKILL.md +43 -0
- package/presets/agy/skills/security-network/SKILL.md +43 -0
- package/presets/agy/skills/security-ot-ics/SKILL.md +43 -0
- package/presets/agy/skills/security-recon/SKILL.md +45 -0
- package/presets/agy/skills/security-red-team/SKILL.md +44 -0
- package/presets/agy/skills/security-reverse-engineering/SKILL.md +44 -0
- package/presets/agy/skills/security-soc-automation/SKILL.md +43 -0
- package/presets/agy/skills/security-threat-hunting/SKILL.md +43 -0
- package/presets/agy/skills/security-vuln-assessment/SKILL.md +45 -0
- package/presets/agy/skills/security-web/SKILL.md +44 -0
- package/presets/agy/workflows/cc-api-contract.md +12 -0
- package/presets/agy/workflows/cc-ask.md +56 -0
- package/presets/agy/workflows/cc-backlog.md +69 -0
- package/presets/agy/workflows/cc-clarify.md +33 -0
- package/presets/agy/workflows/cc-council.md +31 -7
- package/presets/agy/workflows/cc-db-migration.md +22 -9
- package/presets/agy/workflows/cc-explore.md +37 -0
- package/presets/agy/workflows/cc-feature.md +41 -19
- package/presets/agy/workflows/cc-fix.md +50 -23
- package/presets/agy/workflows/cc-handoff.md +42 -0
- package/presets/agy/workflows/cc-iterative.md +128 -0
- package/presets/agy/workflows/cc-openspec.md +16 -1
- package/presets/agy/workflows/cc-pagespeed.md +12 -0
- package/presets/agy/workflows/cc-prototype.md +39 -0
- package/presets/agy/workflows/cc-refactor.md +12 -0
- package/presets/agy/workflows/cc-review.md +12 -0
- package/presets/agy/workflows/cc-scorecard.md +12 -0
- package/presets/agy/workflows/cc-security.md +180 -0
- package/presets/agy/workflows/cc-tdd-cycle.md +24 -0
- package/presets/agy/workflows/cc-test-plan.md +12 -0
- package/presets/agy/workflows/cc-triage.md +35 -0
- package/presets/claude/CLAUDE.md +68 -0
- package/presets/claude/commands/cc/api-contract.md +12 -0
- package/presets/claude/commands/cc/ask.md +56 -0
- package/presets/claude/commands/cc/backlog.md +104 -0
- package/presets/claude/commands/cc/clarify.md +32 -0
- package/presets/claude/commands/cc/council.md +87 -0
- package/presets/claude/commands/cc/db-migration.md +22 -9
- package/presets/claude/commands/cc/explore.md +36 -0
- package/presets/claude/commands/cc/feature.md +49 -22
- package/presets/claude/commands/cc/fix.md +74 -20
- package/presets/claude/commands/cc/handoff.md +44 -0
- package/presets/claude/commands/cc/iterative.md +132 -0
- package/presets/claude/commands/cc/openspec.md +41 -1
- package/presets/claude/commands/cc/pagespeed.md +12 -0
- package/presets/claude/commands/cc/prototype.md +38 -0
- package/presets/claude/commands/cc/refactor.md +152 -1
- package/presets/claude/commands/cc/review.md +78 -16
- package/presets/claude/commands/cc/scorecard.md +12 -0
- package/presets/claude/commands/cc/security.md +179 -0
- package/presets/claude/commands/cc/tdd-cycle.md +53 -3
- package/presets/claude/commands/cc/test-plan.md +12 -0
- package/presets/claude/commands/cc/triage.md +34 -0
- package/presets/claude/gates/pre-commit/GATE.md +137 -0
- package/presets/claude/settings.json +8 -46
- package/presets/claude/skills/backlog/SKILL.md +91 -0
- package/presets/claude/skills/openspec/SKILL.md +5 -1
- package/presets/claude/skills/security/SKILL.md +382 -0
- package/presets/claude/skills/security-ai-llm/SKILL.md +43 -0
- package/presets/claude/skills/security-blue-team/SKILL.md +43 -0
- package/presets/claude/skills/security-cloud/SKILL.md +43 -0
- package/presets/claude/skills/security-crypto/SKILL.md +43 -0
- package/presets/claude/skills/security-exploit-dev/SKILL.md +45 -0
- package/presets/claude/skills/security-grc/SKILL.md +43 -0
- package/presets/claude/skills/security-incident-response/SKILL.md +45 -0
- package/presets/claude/skills/security-log-analysis/SKILL.md +43 -0
- package/presets/claude/skills/security-malware-analysis/SKILL.md +44 -0
- package/presets/claude/skills/security-mobile/SKILL.md +43 -0
- package/presets/claude/skills/security-network/SKILL.md +43 -0
- package/presets/claude/skills/security-ot-ics/SKILL.md +43 -0
- package/presets/claude/skills/security-recon/SKILL.md +45 -0
- package/presets/claude/skills/security-red-team/SKILL.md +44 -0
- package/presets/claude/skills/security-reverse-engineering/SKILL.md +44 -0
- package/presets/claude/skills/security-soc-automation/SKILL.md +43 -0
- package/presets/claude/skills/security-threat-hunting/SKILL.md +43 -0
- package/presets/claude/skills/security-vuln-assessment/SKILL.md +45 -0
- package/presets/claude/skills/security-web/SKILL.md +44 -0
- package/presets/codex/AGENTS.md +6 -6
- package/presets/codex/commands/cc-ask.md +56 -0
- package/presets/codex/gates/pre-commit/GATE.md +137 -0
- package/presets/cursor/AGENTS.md +8 -8
- package/presets/cursor/agents/business-agent.md +44 -0
- package/presets/cursor/agents/continuous-architect.md +37 -0
- package/presets/cursor/agents/docs.md +1 -0
- package/presets/cursor/agents/goal-planner.md +1 -1
- package/presets/cursor/agents/impact-analyst.md +43 -0
- package/presets/cursor/agents/orchestrator.md +6 -6
- package/presets/cursor/commands/cc/api-contract.md +12 -0
- package/presets/cursor/commands/cc/ask.md +56 -0
- package/presets/cursor/commands/cc/backlog.md +105 -0
- package/presets/cursor/commands/cc/clarify.md +32 -0
- package/presets/cursor/commands/cc/council.md +87 -0
- package/presets/cursor/commands/cc/db-migration.md +22 -9
- package/presets/cursor/commands/cc/explore.md +36 -0
- package/presets/cursor/commands/cc/feature.md +41 -19
- package/presets/cursor/commands/cc/fix.md +47 -20
- package/presets/cursor/commands/cc/handoff.md +41 -0
- package/presets/cursor/commands/cc/iterative.md +133 -0
- package/presets/cursor/commands/cc/openspec.md +38 -8
- package/presets/cursor/commands/cc/pagespeed.md +12 -0
- package/presets/cursor/commands/cc/prototype.md +38 -0
- package/presets/cursor/commands/cc/refactor.md +12 -0
- package/presets/cursor/commands/cc/review.md +12 -0
- package/presets/cursor/commands/cc/scorecard.md +12 -0
- package/presets/cursor/commands/cc/security.md +179 -0
- package/presets/cursor/commands/cc/tdd-cycle.md +24 -0
- package/presets/cursor/commands/cc/test-plan.md +12 -0
- package/presets/cursor/commands/cc/triage.md +34 -0
- package/presets/cursor/gates/pre-commit/GATE.md +137 -0
- package/presets/cursor/rules/orchestration.mdc +1 -1
- package/presets/cursor/skills/backlog/SKILL.md +91 -0
- package/presets/cursor/skills/openspec/SKILL.md +5 -1
- package/presets/cursor/skills/security-ai-llm/SKILL.md +43 -0
- package/presets/cursor/skills/security-blue-team/SKILL.md +43 -0
- package/presets/cursor/skills/security-cloud/SKILL.md +43 -0
- package/presets/cursor/skills/security-crypto/SKILL.md +43 -0
- package/presets/cursor/skills/security-exploit-dev/SKILL.md +45 -0
- package/presets/cursor/skills/security-grc/SKILL.md +43 -0
- package/presets/cursor/skills/security-incident-response/SKILL.md +45 -0
- package/presets/cursor/skills/security-log-analysis/SKILL.md +43 -0
- package/presets/cursor/skills/security-malware-analysis/SKILL.md +44 -0
- package/presets/cursor/skills/security-mobile/SKILL.md +43 -0
- package/presets/cursor/skills/security-network/SKILL.md +43 -0
- package/presets/cursor/skills/security-ot-ics/SKILL.md +43 -0
- package/presets/cursor/skills/security-recon/SKILL.md +45 -0
- package/presets/cursor/skills/security-red-team/SKILL.md +44 -0
- package/presets/cursor/skills/security-reverse-engineering/SKILL.md +44 -0
- package/presets/cursor/skills/security-soc-automation/SKILL.md +43 -0
- package/presets/cursor/skills/security-threat-hunting/SKILL.md +43 -0
- package/presets/cursor/skills/security-vuln-assessment/SKILL.md +45 -0
- package/presets/cursor/skills/security-web/SKILL.md +44 -0
- package/presets/opencode/agents/architect.md +22 -1
- package/presets/opencode/agents/complexity-auditor.md +16 -1
- package/presets/opencode/agents/contract-builder.md +17 -1
- package/presets/opencode/agents/devil.md +158 -0
- package/presets/opencode/agents/docs.md +19 -1
- package/presets/opencode/agents/goal-planner.md +32 -2
- package/presets/opencode/agents/implementer.md +32 -2
- package/presets/opencode/agents/orchestrator.md +79 -12
- package/presets/opencode/agents/planner.md +61 -0
- package/presets/opencode/agents/repo-explorer.md +16 -0
- package/presets/opencode/agents/reviewer.md +33 -3
- package/presets/opencode/agents/security-reviewer.md +31 -1
- package/presets/opencode/agents/task-coach.md +69 -1
- package/presets/opencode/agents/tester.md +18 -1
- package/presets/opencode/commands/cc-api-contract.md +12 -0
- package/presets/opencode/commands/cc-ask.md +56 -0
- package/presets/opencode/commands/cc-backlog.md +68 -0
- package/presets/opencode/commands/cc-clarify.md +31 -0
- package/presets/opencode/commands/cc-council.md +87 -0
- package/presets/opencode/commands/cc-db-migration.md +22 -9
- package/presets/opencode/commands/cc-explore.md +35 -0
- package/presets/opencode/commands/cc-feature.md +41 -19
- package/presets/opencode/commands/cc-fix.md +50 -23
- package/presets/opencode/commands/cc-handoff.md +40 -0
- package/presets/opencode/commands/cc-iterative.md +127 -0
- package/presets/opencode/commands/cc-openspec.md +16 -1
- package/presets/opencode/commands/cc-pagespeed.md +12 -0
- package/presets/opencode/commands/cc-prototype.md +37 -0
- package/presets/opencode/commands/cc-refactor.md +12 -0
- package/presets/opencode/commands/cc-review.md +12 -0
- package/presets/opencode/commands/cc-scorecard.md +12 -0
- package/presets/opencode/commands/cc-security.md +179 -0
- package/presets/opencode/commands/cc-tdd-cycle.md +24 -0
- package/presets/opencode/commands/cc-test-plan.md +12 -0
- package/presets/opencode/commands/cc-triage.md +33 -0
- package/presets/opencode/gates/pre-commit/GATE.md +137 -0
- package/presets/opencode/prompts/v0.1.0/DEPRECATED.md +11 -0
- package/presets/opencode/prompts/v0.2.0/DEPRECATED.md +11 -0
- package/presets/opencode/prompts/v0.3.0/DEPRECATED.md +11 -0
- package/presets/opencode/prompts/v0.4.0/DEPRECATED.md +11 -0
- package/presets/opencode/prompts/v0.5.0/goal-planner.md +1 -1
- package/presets/opencode/prompts/v0.5.0/orchestrator.md +6 -6
- package/presets/opencode/prompts/v0.6.0/implementer.md +35 -0
- package/presets/opencode/prompts/v0.6.0/planner.md +36 -0
- package/presets/opencode/prompts/v0.6.0/reviewer.md +40 -0
- package/presets/opencode/prompts/v1.0.0/README.md +47 -0
- package/presets/opencode/prompts/v1.0.0/architect.md +259 -0
- package/presets/opencode/prompts/v1.0.0/complexity-auditor.md +116 -0
- package/presets/opencode/prompts/v1.0.0/contract-builder.md +120 -0
- package/presets/opencode/prompts/v1.0.0/devil.md +169 -0
- package/presets/opencode/prompts/v1.0.0/docs.md +229 -0
- package/presets/opencode/prompts/v1.0.0/goal-planner.md +123 -0
- package/presets/opencode/prompts/v1.0.0/implementer.md +228 -0
- package/presets/opencode/prompts/v1.0.0/orchestrator.md +474 -0
- package/presets/opencode/prompts/v1.0.0/planner.md +72 -0
- package/presets/opencode/prompts/v1.0.0/repo-explorer.md +147 -0
- package/presets/opencode/prompts/v1.0.0/reviewer.md +295 -0
- package/presets/opencode/prompts/v1.0.0/security-reviewer.md +170 -0
- package/presets/opencode/prompts/v1.0.0/task-coach.md +235 -0
- package/presets/opencode/prompts/v1.0.0/tester.md +298 -0
- package/presets/opencode/skills/backlog/SKILL.md +91 -0
- package/presets/opencode/skills/openspec/SKILL.md +5 -1
- package/presets/opencode/skills/security-ai-llm/SKILL.md +43 -0
- package/presets/opencode/skills/security-blue-team/SKILL.md +43 -0
- package/presets/opencode/skills/security-cloud/SKILL.md +43 -0
- package/presets/opencode/skills/security-crypto/SKILL.md +43 -0
- package/presets/opencode/skills/security-exploit-dev/SKILL.md +45 -0
- package/presets/opencode/skills/security-grc/SKILL.md +43 -0
- package/presets/opencode/skills/security-incident-response/SKILL.md +45 -0
- package/presets/opencode/skills/security-log-analysis/SKILL.md +43 -0
- package/presets/opencode/skills/security-malware-analysis/SKILL.md +44 -0
- package/presets/opencode/skills/security-mobile/SKILL.md +43 -0
- package/presets/opencode/skills/security-network/SKILL.md +43 -0
- package/presets/opencode/skills/security-ot-ics/SKILL.md +43 -0
- package/presets/opencode/skills/security-recon/SKILL.md +45 -0
- package/presets/opencode/skills/security-red-team/SKILL.md +44 -0
- package/presets/opencode/skills/security-reverse-engineering/SKILL.md +44 -0
- package/presets/opencode/skills/security-soc-automation/SKILL.md +43 -0
- package/presets/opencode/skills/security-threat-hunting/SKILL.md +43 -0
- package/presets/opencode/skills/security-vuln-assessment/SKILL.md +45 -0
- package/presets/opencode/skills/security-web/SKILL.md +44 -0
- package/presets/seo-hotel/settings.json +0 -17
- package/src/presets/council/council.yml +12 -0
- package/src/presets/manifests/agy.yml +2 -2
- package/src/presets/manifests/claude.yml +2 -2
- package/src/presets/manifests/codex.yml +2 -2
- package/src/presets/manifests/cursor.yml +2 -2
- package/src/presets/manifests/gemini.yml +2 -2
- package/src/presets/manifests/opencode.yml +2 -2
- package/src/presets/models/agy.yml +93 -66
- package/src/presets/models/claude.yml +79 -53
- package/src/presets/models/codex.yml +79 -54
- package/src/presets/models/cursor.yml +72 -58
- package/src/presets/models/gemini.yml +79 -53
- package/src/presets/models/opencode.yml +72 -46
|
@@ -0,0 +1,104 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: >-
|
|
3
|
+
[cc: alias] Author BACKLOG.md — wayfinding, grilling, create or append items,
|
|
4
|
+
validate with openspec, and plan OpenSpec change folders for /cc:openspec.
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# Backlog Authoring Workflow
|
|
8
|
+
|
|
9
|
+
Objectives: $ARGUMENTS
|
|
10
|
+
|
|
11
|
+
Create or append valid `BACKLOG.md` items and OpenSpec change docs. Do **not**
|
|
12
|
+
deliver implementation — that is `/cc:openspec`.
|
|
13
|
+
|
|
14
|
+
---
|
|
15
|
+
|
|
16
|
+
## Step 0 — CCEP Bootstrap
|
|
17
|
+
|
|
18
|
+
Command: `backlog` (fixed for this workflow — do not infer from user text)
|
|
19
|
+
|
|
20
|
+
1. Run: `npx cc-codeconductor ccep parse --command backlog "$ARGUMENTS" --output json`
|
|
21
|
+
2. Run: `npx cc-codeconductor ccep resolve --command backlog "$ARGUMENTS" --output json`
|
|
22
|
+
3. Run: `npx cc-codeconductor ccep profile backlog --output json`
|
|
23
|
+
4. After planner/intake JSON is available, run: `npx cc-codeconductor ccep evaluate --command backlog --input <planner.json> --output json`. If `stop` is true, show questions or risks and wait for human input.
|
|
24
|
+
5. Delegate to subagents using compiled CCEP prompts — never forward raw `$ARGUMENTS` to planners.
|
|
25
|
+
|
|
26
|
+
---
|
|
27
|
+
|
|
28
|
+
## Step 1 — Wayfinding (Repo Explorer role)
|
|
29
|
+
|
|
30
|
+
If `graphify-out/graph.json` exists, run `graphify query "$ARGUMENTS"` (and
|
|
31
|
+
`graphify path` / `graphify explain` when needed). Then adopt the **Repo
|
|
32
|
+
Explorer** role. Do not write `BACKLOG.md` in this step. Record a Repo Map so
|
|
33
|
+
Scope names real files or modules.
|
|
34
|
+
|
|
35
|
+
---
|
|
36
|
+
|
|
37
|
+
## Step 2 — Relentless Grilling (Task Coach role)
|
|
38
|
+
|
|
39
|
+
Adopt the **Task Coach** role. Produce complete backlog item fields: title,
|
|
40
|
+
type, risk, scope, description, out of scope, measurable acceptance criteria.
|
|
41
|
+
|
|
42
|
+
Every assumption must survive one grilling question. Reject vague acceptance
|
|
43
|
+
("improve UX", "fix bugs").
|
|
44
|
+
|
|
45
|
+
If any field is missing or ambiguous, ask one clarifying question at a time.
|
|
46
|
+
|
|
47
|
+
**STOP here.** Unresolved grilling questions populate `questionsForUser` in the
|
|
48
|
+
CCEP-1 `planner-output`; `ccep evaluate --command backlog` halts until a human
|
|
49
|
+
answers. Do not write `BACKLOG.md` until that confirmation.
|
|
50
|
+
|
|
51
|
+
---
|
|
52
|
+
|
|
53
|
+
## Step 3 — Write or append BACKLOG.md (Docs role)
|
|
54
|
+
|
|
55
|
+
Apply skill `backlog`.
|
|
56
|
+
|
|
57
|
+
- If `BACKLOG.md` is absent, create it from the canonical template. Set Global
|
|
58
|
+
`Product` from `package.json` `name` when present.
|
|
59
|
+
- If it exists, append new `### BC-xxx` items under `## Items`. Do not rewrite
|
|
60
|
+
`## Global` or `## Archive`.
|
|
61
|
+
- Next ID = max `BC-NNN` across Items and Archive, plus one.
|
|
62
|
+
- New items: Status `READY`, Progress `0%`, measurable Acceptance checklist.
|
|
63
|
+
|
|
64
|
+
Do **not** `git add` `BACKLOG.md` or `openspec/`.
|
|
65
|
+
|
|
66
|
+
---
|
|
67
|
+
|
|
68
|
+
## Step 4 — Validate (mandatory gate)
|
|
69
|
+
|
|
70
|
+
Run:
|
|
71
|
+
|
|
72
|
+
```bash
|
|
73
|
+
npx cc-codeconductor openspec validate
|
|
74
|
+
```
|
|
75
|
+
|
|
76
|
+
If validation fails:
|
|
77
|
+
|
|
78
|
+
1. List all errors and recommendations from the CLI output.
|
|
79
|
+
2. Show the canonical BACKLOG.md structure (## Global, ## Items, ### BC-001 | Title, Priority, Status, Type, Depends on, Description, Scope, Acceptance).
|
|
80
|
+
3. Fix the file and re-run validate. **STOP** planning until valid.
|
|
81
|
+
|
|
82
|
+
---
|
|
83
|
+
|
|
84
|
+
## Step 5 — Plan new items
|
|
85
|
+
|
|
86
|
+
For each **new** `BC-xxx` from this run:
|
|
87
|
+
|
|
88
|
+
```bash
|
|
89
|
+
npx cc-codeconductor openspec plan <BC-id>
|
|
90
|
+
```
|
|
91
|
+
|
|
92
|
+
Show TaskCards and `openspec/changes/<slug>/` (proposal, design, tasks, specs).
|
|
93
|
+
|
|
94
|
+
---
|
|
95
|
+
|
|
96
|
+
## Completion
|
|
97
|
+
|
|
98
|
+
Report: item IDs added, validate result, change folder paths.
|
|
99
|
+
|
|
100
|
+
Tell the user to run `/cc:openspec` (optionally `/cc:openspec BC-xxx`) to
|
|
101
|
+
deliver. Do not start delivery in this workflow.
|
|
102
|
+
|
|
103
|
+
Apply skill `backlog` for create/append rules. Apply skill `openspec` only for
|
|
104
|
+
format and state-machine reference.
|
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: >-
|
|
3
|
+
[cc: alias] Re-explain the last deliverable in Task Card vocabulary when it did not land.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Clarify Workflow
|
|
7
|
+
|
|
8
|
+
Clarify request: $ARGUMENTS
|
|
9
|
+
|
|
10
|
+
## Step 0 — CCEP Bootstrap
|
|
11
|
+
|
|
12
|
+
Command: `clarify` (fixed for this workflow — do not infer from user text)
|
|
13
|
+
|
|
14
|
+
1. Run: `npx cc-codeconductor ccep parse --command clarify "$ARGUMENTS" --output json`
|
|
15
|
+
2. Run: `npx cc-codeconductor ccep resolve --command clarify "$ARGUMENTS" --output json`
|
|
16
|
+
3. Run: `npx cc-codeconductor ccep profile clarify --output json`
|
|
17
|
+
4. After planner/intake JSON is available, run: `npx cc-codeconductor ccep evaluate --command clarify --input <planner.json> --output json`. If `stop` is true, show questions or risks and wait for human input.
|
|
18
|
+
5. Delegate to subagents using compiled CCEP prompts — never forward raw `$ARGUMENTS` to planners.
|
|
19
|
+
|
|
20
|
+
---
|
|
21
|
+
|
|
22
|
+
## Step 1 — Re-explain (task-coach)
|
|
23
|
+
|
|
24
|
+
Invoke `task-coach` / `orchestrator`. Restate the last Task Card, plan, or review in the project's vocabulary. Do not add new scope. If questions remain, one question per branch.
|
|
25
|
+
|
|
26
|
+
**STOP if ConfirmationGate reports questions.**
|
|
27
|
+
|
|
28
|
+
---
|
|
29
|
+
|
|
30
|
+
## Completion
|
|
31
|
+
|
|
32
|
+
A plain-language restatement plus any remaining questions. Then resume the previous workflow.
|
|
@@ -0,0 +1,87 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: Council-driven workflow with CCEP-1 bootstrap
|
|
3
|
+
---
|
|
4
|
+
|
|
5
|
+
# Council-Driven Workflow
|
|
6
|
+
|
|
7
|
+
Task request: $ARGUMENTS
|
|
8
|
+
|
|
9
|
+
## Step 0 — CCEP Bootstrap
|
|
10
|
+
|
|
11
|
+
Command: `council` (fixed for this workflow — do not infer from user text)
|
|
12
|
+
command: council
|
|
13
|
+
|
|
14
|
+
1. Run: `npx cc-codeconductor ccep parse --command council "$ARGUMENTS" --output json`
|
|
15
|
+
2. Run: `npx cc-codeconductor ccep resolve --command council "$ARGUMENTS" --output json`
|
|
16
|
+
3. Run: `npx cc-codeconductor ccep profile council --output json`
|
|
17
|
+
4. After planner/intake JSON is available, run: `npx cc-codeconductor ccep evaluate --command council --input <planner.json> --output json`. If `stop` is true, show questions or risks and wait for human input.
|
|
18
|
+
5. Delegate to subagents using compiled CCEP prompts — never forward raw `$ARGUMENTS` to planners.
|
|
19
|
+
|
|
20
|
+
---
|
|
21
|
+
|
|
22
|
+
## Step 1 — Wayfinding (repo-explorer)
|
|
23
|
+
|
|
24
|
+
If `graphify-out/graph.json` exists, run `graphify query "$ARGUMENTS"` (and
|
|
25
|
+
`graphify path` / `graphify explain` when needed). Then invoke `repo-explorer`
|
|
26
|
+
to map impact radius before deliberation. Do not write code in this step.
|
|
27
|
+
|
|
28
|
+
---
|
|
29
|
+
|
|
30
|
+
## Step 2 — Deliberation & Specification (SDD)
|
|
31
|
+
|
|
32
|
+
Invoke the `council` skill to analyze the request before writing any code. The council must act as a steering committee involving `task-coach` (Product), `architect`, and `devil`.
|
|
33
|
+
|
|
34
|
+
The council must:
|
|
35
|
+
1. Clarify the prompt and define the absolute minimum scope (Simplicity Gate).
|
|
36
|
+
2. Explicitly document all assumptions and run the Grilling protocol on each one (Think Before Coding).
|
|
37
|
+
3. Draft a Task Card & Technical Plan (The Specification).
|
|
38
|
+
|
|
39
|
+
**STOP here.** Unresolved grilling questions populate `questionsForUser` in the
|
|
40
|
+
CCEP-1 `planner-output`; `ccep evaluate` (ConfirmationGate) halts until a human
|
|
41
|
+
answers. Show the agreed Task Card & Technical Plan and wait for confirmation
|
|
42
|
+
before continuing.
|
|
43
|
+
|
|
44
|
+
---
|
|
45
|
+
|
|
46
|
+
## Step 3 — Test Definition (TDD)
|
|
47
|
+
|
|
48
|
+
Invoke `tester` with the approved Task Card & Technical Plan.
|
|
49
|
+
|
|
50
|
+
tester must:
|
|
51
|
+
1. Write failing tests based on the Acceptance Criteria defined in the Task Card.
|
|
52
|
+
2. Confirm the tests fail as expected (Red state).
|
|
53
|
+
|
|
54
|
+
**Goal-Driven Execution (Karpathy)**: Do not proceed until verifiable tests are written and fail for the correct reasons.
|
|
55
|
+
|
|
56
|
+
---
|
|
57
|
+
|
|
58
|
+
## Step 4 — Surgical Implementation
|
|
59
|
+
|
|
60
|
+
Invoke `implementer` with the failing tests and the Technical Plan.
|
|
61
|
+
|
|
62
|
+
implementer must:
|
|
63
|
+
1. Write the minimal code required to pass the tests.
|
|
64
|
+
2. Touch ONLY the files specified in the Technical Plan (Surgical Changes).
|
|
65
|
+
3. NOT refactor adjacent code, change existing styles, or build speculative features.
|
|
66
|
+
4. Run the tests. Loop `implementer` -> `tester` until all tests pass (Green state).
|
|
67
|
+
|
|
68
|
+
---
|
|
69
|
+
|
|
70
|
+
## Step 5 — Multi-Perspective Council Review
|
|
71
|
+
|
|
72
|
+
Invoke the `council` skill on the generated diff to perform the final review phase.
|
|
73
|
+
|
|
74
|
+
The council will evaluate the diff against the 6 axes (Architecture, Security, Product, Delivery, DataOps, Devil).
|
|
75
|
+
|
|
76
|
+
If ANY agent votes CRITICAL (especially due to over-engineering, scope creep, or missing the verifiable goals):
|
|
77
|
+
- The Review Report status is **BLOCKED**.
|
|
78
|
+
- Return to Step 4 with the feedback.
|
|
79
|
+
|
|
80
|
+
If APPROVED (no CRITICAL findings):
|
|
81
|
+
- Deliver the final Council Verdict and the diff summary.
|
|
82
|
+
|
|
83
|
+
---
|
|
84
|
+
|
|
85
|
+
## Completion
|
|
86
|
+
|
|
87
|
+
Deliver the complete Council Verdict. The feature is only complete when tests pass and the council explicitly approves the implementation according to the specification.
|
|
@@ -8,6 +8,19 @@ description: >-
|
|
|
8
8
|
|
|
9
9
|
Migration request: $ARGUMENTS
|
|
10
10
|
|
|
11
|
+
## Step 0 — CCEP Bootstrap
|
|
12
|
+
|
|
13
|
+
Command: `db-migration` (fixed for this workflow — do not infer from user text)
|
|
14
|
+
|
|
15
|
+
1. Run: `npx cc-codeconductor ccep parse --command db-migration "$ARGUMENTS" --output json`
|
|
16
|
+
2. Run: `npx cc-codeconductor ccep resolve --command db-migration "$ARGUMENTS" --output json`
|
|
17
|
+
3. Run: `npx cc-codeconductor ccep profile db-migration --output json`
|
|
18
|
+
4. After planner/intake JSON is available, run: `npx cc-codeconductor ccep evaluate --command db-migration --input <planner.json> --output json`. If `stop` is true, show questions or risks and wait for human input.
|
|
19
|
+
5. Delegate to subagents using compiled CCEP prompts — never forward raw `$ARGUMENTS` to planners.
|
|
20
|
+
Canonical delivery order is test-before-implement whenever both phases apply.
|
|
21
|
+
|
|
22
|
+
---
|
|
23
|
+
|
|
11
24
|
## Step 1 — Task Card validation (Task Coach role)
|
|
12
25
|
|
|
13
26
|
Adopt the **Task Coach** role as defined in `CLAUDE.md`.
|
|
@@ -31,22 +44,22 @@ rollback/forward-fix notes, and test approach.
|
|
|
31
44
|
|
|
32
45
|
---
|
|
33
46
|
|
|
34
|
-
## Step 3 —
|
|
47
|
+
## Step 3 — Migration Tests (Tester role)
|
|
35
48
|
|
|
36
|
-
Adopt the **
|
|
49
|
+
Adopt the **Tester** role as defined in `CLAUDE.md`.
|
|
37
50
|
|
|
38
|
-
|
|
39
|
-
|
|
51
|
+
Cover migration-sensitive behavior where the stack supports it, including
|
|
52
|
+
existing-data edge cases and rollback/forward-fix notes when automated rollback
|
|
53
|
+
tests are not practical.
|
|
40
54
|
|
|
41
55
|
---
|
|
42
56
|
|
|
43
|
-
## Step 4 —
|
|
57
|
+
## Step 4 — Implementation (Implementer role)
|
|
44
58
|
|
|
45
|
-
Adopt the **
|
|
59
|
+
Adopt the **Implementer** role as defined in `CLAUDE.md`.
|
|
46
60
|
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
tests are not practical.
|
|
61
|
+
Keep model and migration changes together, avoid unrelated refactors, and
|
|
62
|
+
preserve the deployment order specified by architect.
|
|
50
63
|
|
|
51
64
|
---
|
|
52
65
|
|
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: >-
|
|
3
|
+
[cc: alias] Map the repository and recommend the next CodeConductor slash command. Read-only.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Explore Workflow
|
|
7
|
+
|
|
8
|
+
Explore request: $ARGUMENTS
|
|
9
|
+
|
|
10
|
+
## Step 0 — CCEP Bootstrap
|
|
11
|
+
|
|
12
|
+
Command: `explore` (fixed for this workflow — do not infer from user text)
|
|
13
|
+
|
|
14
|
+
1. Run: `npx cc-codeconductor ccep parse --command explore "$ARGUMENTS" --output json`
|
|
15
|
+
2. Run: `npx cc-codeconductor ccep resolve --command explore "$ARGUMENTS" --output json`
|
|
16
|
+
3. Run: `npx cc-codeconductor ccep profile explore --output json`
|
|
17
|
+
4. After planner/intake JSON is available, run: `npx cc-codeconductor ccep evaluate --command explore --input <planner.json> --output json`. If `stop` is true, show questions or risks and wait for human input.
|
|
18
|
+
5. Delegate to subagents using compiled CCEP prompts — never forward raw `$ARGUMENTS` to planners.
|
|
19
|
+
|
|
20
|
+
---
|
|
21
|
+
|
|
22
|
+
## Step 1 — Map (repo-explorer)
|
|
23
|
+
|
|
24
|
+
If `graphify-out/graph.json` exists, run `graphify query "$ARGUMENTS"`. Invoke `repo-explorer`. Produce a Repo Map. Do not write code.
|
|
25
|
+
|
|
26
|
+
---
|
|
27
|
+
|
|
28
|
+
## Step 2 — Suggest next command (orchestrator)
|
|
29
|
+
|
|
30
|
+
Recommend exactly one next slash command (`/cc:feature`, `/cc:fix`, `/cc:refactor`, `/cc:review`, `/cc:backlog`, `/cc:openspec`, `/cc:triage`, …) with a one-sentence rationale. Do not start that workflow.
|
|
31
|
+
|
|
32
|
+
---
|
|
33
|
+
|
|
34
|
+
## Completion
|
|
35
|
+
|
|
36
|
+
Report the Repo Map and the recommended next `/cc:` command.
|
|
@@ -10,22 +10,49 @@ Feature request: $ARGUMENTS
|
|
|
10
10
|
|
|
11
11
|
---
|
|
12
12
|
|
|
13
|
-
## Step
|
|
13
|
+
## Step 0 — CCEP Bootstrap
|
|
14
|
+
|
|
15
|
+
Command: `feature` (fixed for this workflow — do not infer from user text)
|
|
16
|
+
|
|
17
|
+
1. Run: `npx cc-codeconductor ccep parse --command feature "$ARGUMENTS" --output json`
|
|
18
|
+
2. Run: `npx cc-codeconductor ccep resolve --command feature "$ARGUMENTS" --output json`
|
|
19
|
+
3. Run: `npx cc-codeconductor ccep profile feature --output json`
|
|
20
|
+
4. After planner/intake JSON is available, run: `npx cc-codeconductor ccep evaluate --command feature --input <planner.json> --output json`. If `stop` is true, show questions or risks and wait for human input.
|
|
21
|
+
5. Delegate to subagents using compiled CCEP prompts — never forward raw `$ARGUMENTS` to planners.
|
|
22
|
+
Canonical delivery order is test-before-implement whenever both phases apply.
|
|
23
|
+
|
|
24
|
+
---
|
|
25
|
+
|
|
26
|
+
## Step 1 — Wayfinding (repo-explorer)
|
|
27
|
+
|
|
28
|
+
If `graphify-out/graph.json` exists, run `graphify query "$ARGUMENTS"` (and
|
|
29
|
+
`graphify path` / `graphify explain` when needed). Then invoke `repo-explorer`
|
|
30
|
+
to map modules, conventions, and impact radius. Do not write code in this step.
|
|
31
|
+
Record a Repo Map artifact before intake.
|
|
32
|
+
|
|
33
|
+
---
|
|
34
|
+
|
|
35
|
+
## Step 2 — Task Card validation (Task Coach role)
|
|
14
36
|
|
|
15
37
|
Adopt the **Task Coach** role as defined in `CLAUDE.md`.
|
|
16
38
|
|
|
17
39
|
Produce a complete Task Card. The Task Card is ready when it contains: title,
|
|
18
|
-
type, risk classification, scope, context, acceptance criteria, and
|
|
40
|
+
type, risk classification, scope, context, acceptance criteria, and
|
|
41
|
+
constraints, and every assumption behind it has survived one grilling
|
|
42
|
+
question (Grilling protocol).
|
|
19
43
|
|
|
20
44
|
If any field is missing or ambiguous, ask one clarifying question at a time and
|
|
21
45
|
wait for the answer. Do not proceed with an incomplete Task Card.
|
|
22
46
|
|
|
23
|
-
**STOP here
|
|
24
|
-
|
|
47
|
+
**STOP here.** Unresolved grilling questions or missing fields populate
|
|
48
|
+
`questionsForUser` in the CCEP-1 `planner-output`; the `ConfirmationGate`
|
|
49
|
+
(`ccep evaluate`) reads that field and halts the workflow until a human
|
|
50
|
+
answers. Show the completed Task Card and wait for that confirmation before
|
|
51
|
+
continuing.
|
|
25
52
|
|
|
26
53
|
---
|
|
27
54
|
|
|
28
|
-
## Step
|
|
55
|
+
## Step 3 — Technical Plan (Architect role)
|
|
29
56
|
|
|
30
57
|
Adopt the **Architect** role as defined in `CLAUDE.md`.
|
|
31
58
|
|
|
@@ -43,7 +70,20 @@ not proceed to implementation until the plan is approved.**
|
|
|
43
70
|
|
|
44
71
|
---
|
|
45
72
|
|
|
46
|
-
## Step
|
|
73
|
+
## Step 4 — Test coverage (Tester role)
|
|
74
|
+
|
|
75
|
+
Adopt the **Tester** role as defined in `CLAUDE.md`.
|
|
76
|
+
|
|
77
|
+
Use the Implementation Summary and the Task Card.
|
|
78
|
+
|
|
79
|
+
1. Write or extend failing tests for the new behavior before implementation (RED).
|
|
80
|
+
2. Ensure all acceptance criteria from the Task Card have at least one test.
|
|
81
|
+
3. Run the full test suite and confirm it passes.
|
|
82
|
+
4. Produce a Test Report: test files added or modified, cases covered.
|
|
83
|
+
|
|
84
|
+
---
|
|
85
|
+
|
|
86
|
+
## Step 5 — Implementation (Implementer role)
|
|
47
87
|
|
|
48
88
|
Adopt the **Implementer** role as defined in `CLAUDE.md`.
|
|
49
89
|
|
|
@@ -52,26 +92,13 @@ Implementer creates a Git Worktree before touching any file; all edits happen in
|
|
|
52
92
|
|
|
53
93
|
1. Read the Technical Plan before touching any file.
|
|
54
94
|
2. Apply the minimal diff — only what the plan specifies.
|
|
55
|
-
3. Run the project test suite
|
|
95
|
+
3. Run the project test suite and make the previously written failing tests pass.
|
|
56
96
|
4. Produce an Implementation Summary: what changed, which files, how to verify
|
|
57
97
|
locally.
|
|
58
98
|
|
|
59
99
|
---
|
|
60
100
|
|
|
61
|
-
## Step
|
|
62
|
-
|
|
63
|
-
Adopt the **Tester** role as defined in `CLAUDE.md`.
|
|
64
|
-
|
|
65
|
-
Use the Implementation Summary and the Task Card.
|
|
66
|
-
|
|
67
|
-
1. Write or extend tests to cover the new behavior.
|
|
68
|
-
2. Ensure all acceptance criteria from the Task Card have at least one test.
|
|
69
|
-
3. Run the full test suite and confirm it passes.
|
|
70
|
-
4. Produce a Test Report: test files added or modified, cases covered.
|
|
71
|
-
|
|
72
|
-
---
|
|
73
|
-
|
|
74
|
-
## Step 5 — Code review (Reviewer role)
|
|
101
|
+
## Step 6 — Code review (Reviewer role)
|
|
75
102
|
|
|
76
103
|
Adopt the **Reviewer** role as defined in `CLAUDE.md`.
|
|
77
104
|
|
|
@@ -85,7 +112,7 @@ they are resolved and the diff is re-reviewed.
|
|
|
85
112
|
|
|
86
113
|
---
|
|
87
114
|
|
|
88
|
-
## Step
|
|
115
|
+
## Step 7 — Documentation (Docs role)
|
|
89
116
|
|
|
90
117
|
Adopt the **Docs** role as defined in `CLAUDE.md`.
|
|
91
118
|
|
|
@@ -18,7 +18,29 @@ Provide the following information in $ARGUMENTS:
|
|
|
18
18
|
|
|
19
19
|
---
|
|
20
20
|
|
|
21
|
-
## Step
|
|
21
|
+
## Step 0 — CCEP Bootstrap
|
|
22
|
+
|
|
23
|
+
Command: `fix` (fixed for this workflow — do not infer from user text)
|
|
24
|
+
|
|
25
|
+
1. Run: `npx cc-codeconductor ccep parse --command fix "$ARGUMENTS" --output json`
|
|
26
|
+
2. Run: `npx cc-codeconductor ccep resolve --command fix "$ARGUMENTS" --output json`
|
|
27
|
+
3. Run: `npx cc-codeconductor ccep profile fix --output json`
|
|
28
|
+
4. After planner/intake JSON is available, run: `npx cc-codeconductor ccep evaluate --command fix --input <planner.json> --output json`. If `stop` is true, show questions or risks and wait for human input.
|
|
29
|
+
5. Delegate to subagents using compiled CCEP prompts — never forward raw `$ARGUMENTS` to planners.
|
|
30
|
+
Canonical delivery order is test-before-implement whenever both phases apply.
|
|
31
|
+
|
|
32
|
+
---
|
|
33
|
+
|
|
34
|
+
## Step 1 — Wayfinding (repo-explorer)
|
|
35
|
+
|
|
36
|
+
If `graphify-out/graph.json` exists, run `graphify query "$ARGUMENTS"` (and
|
|
37
|
+
`graphify path` / `graphify explain` when needed). Then invoke `repo-explorer`
|
|
38
|
+
to map modules, conventions, and impact radius. Do not write code in this step.
|
|
39
|
+
Record a Repo Map artifact before intake.
|
|
40
|
+
|
|
41
|
+
---
|
|
42
|
+
|
|
43
|
+
## Step 2 — Task Card validation (Task Coach role)
|
|
22
44
|
|
|
23
45
|
Adopt the **Task Coach** role as defined in `CLAUDE.md`.
|
|
24
46
|
|
|
@@ -32,11 +54,43 @@ Produce a Task Card that includes:
|
|
|
32
54
|
If reproduction steps are missing, ask for them before classifying risk. A bug
|
|
33
55
|
without a reproduction path cannot be classified reliably.
|
|
34
56
|
|
|
57
|
+
Capture evidence before tests: reproduction, logs or stack traces, and one
|
|
58
|
+
falsifiable hypothesis of the root cause. Do not patch without that evidence.
|
|
59
|
+
Redact secrets, tokens, and credential dumps from logs before they enter the
|
|
60
|
+
Task Card. Summarize stack traces; do not paste env files.
|
|
61
|
+
|
|
35
62
|
**STOP here. Show the Task Card and wait for human confirmation.**
|
|
36
63
|
|
|
37
64
|
---
|
|
38
65
|
|
|
39
|
-
## Step 2 —
|
|
66
|
+
## Step 2.5 — Red loop gate
|
|
67
|
+
|
|
68
|
+
Before hypothesizing about the root cause, produce a reproduction command:
|
|
69
|
+
one deterministic, tight command that exercises the real bug path and asserts
|
|
70
|
+
the exact symptom the user reported (not a proxy or a related error).
|
|
71
|
+
|
|
72
|
+
Requirements:
|
|
73
|
+
|
|
74
|
+
- The command must be **deterministic** — running it twice produces the same
|
|
75
|
+
result.
|
|
76
|
+
- The command's assertion must match the exact user-reported symptom (actual
|
|
77
|
+
vs. expected from the Task Card), not a generic failure.
|
|
78
|
+
- Run it at least once before continuing. Do not proceed to Step 3 until you
|
|
79
|
+
have run it and it reproduces the bug (RED).
|
|
80
|
+
|
|
81
|
+
Record the run as evidence so `cc verify` can see it: write a JSON file to
|
|
82
|
+
`.codeconductor/evidence/` matching `EvidenceSchema` with `type: 'test'` and a
|
|
83
|
+
`data` payload shaped like `ImplementerTestsSchema` (`runner`, `result`,
|
|
84
|
+
`failedTests`), e.g. `{ "runner": "<reproduction command>", "result": "failed" }`
|
|
85
|
+
for this red run. After the fix (Step 3/4a/4b), re-run the same command and
|
|
86
|
+
update the evidence to `"result": "passed"` — `cc verify --task <id>` reads
|
|
87
|
+
this evidence directly, no code changes required.
|
|
88
|
+
|
|
89
|
+
**Do not proceed to Step 2 without a reproduction command that has been run.**
|
|
90
|
+
|
|
91
|
+
---
|
|
92
|
+
|
|
93
|
+
## Step 3 — Route by risk
|
|
40
94
|
|
|
41
95
|
Read the risk field from the Task Card and follow the corresponding route.
|
|
42
96
|
|
|
@@ -45,16 +99,16 @@ Read the risk field from the Task Card and follow the corresponding route.
|
|
|
45
99
|
Applies when: the bug is isolated to a single component, existing tests cover
|
|
46
100
|
the affected code, and no public API or shared state is involved.
|
|
47
101
|
|
|
48
|
-
Route: Task Coach →
|
|
102
|
+
Route: Task Coach → Tester → Implementer
|
|
49
103
|
|
|
50
|
-
Proceed directly to Step
|
|
104
|
+
Proceed directly to Step 3 (tests), then Step 4a.
|
|
51
105
|
|
|
52
106
|
### Medium or high-risk route
|
|
53
107
|
|
|
54
108
|
Applies when: the bug touches shared state, a public API, auth or payment paths,
|
|
55
109
|
database writes, or the root cause is not yet understood.
|
|
56
110
|
|
|
57
|
-
Route: Task Coach → Architect →
|
|
111
|
+
Route: Task Coach → Architect → Tester → Implementer → Reviewer
|
|
58
112
|
|
|
59
113
|
Adopt the **Architect** role before implementation. Architect must:
|
|
60
114
|
|
|
@@ -68,19 +122,30 @@ before continuing.**
|
|
|
68
122
|
|
|
69
123
|
---
|
|
70
124
|
|
|
71
|
-
## Step
|
|
125
|
+
## Step 4 — Regression tests (Tester role)
|
|
126
|
+
|
|
127
|
+
Adopt the **Tester** role as defined in `CLAUDE.md`. Apply for all risk levels.
|
|
128
|
+
|
|
129
|
+
1. Write a regression test that reproduces the original bug and confirm it fails
|
|
130
|
+
before any fix (RED).
|
|
131
|
+
2. Verify that existing tests still pass.
|
|
132
|
+
3. Produce a Test Report: test added, case covered.
|
|
133
|
+
|
|
134
|
+
---
|
|
135
|
+
|
|
136
|
+
## Step 5a — Implementation, low-risk (Implementer role)
|
|
72
137
|
|
|
73
138
|
Adopt the **Implementer** role as defined in `CLAUDE.md`. Use the Task Card.
|
|
74
139
|
Implementer creates a Git Worktree before touching any file; all edits happen inside it.
|
|
75
140
|
|
|
76
141
|
1. Locate the defect using the reproduction steps.
|
|
77
142
|
2. Apply the minimal fix — no unrelated changes.
|
|
78
|
-
3. Run the test
|
|
143
|
+
3. Run the suite and make the RED regression test pass.
|
|
79
144
|
4. Produce an Implementation Summary: root cause, fix applied, files changed.
|
|
80
145
|
|
|
81
146
|
---
|
|
82
147
|
|
|
83
|
-
## Step
|
|
148
|
+
## Step 5b — Implementation, medium/high-risk (Implementer role)
|
|
84
149
|
|
|
85
150
|
Adopt the **Implementer** role as defined in `CLAUDE.md`. Use the approved
|
|
86
151
|
Technical Plan and the Task Card.
|
|
@@ -91,18 +156,7 @@ After implementation, run the full test suite.
|
|
|
91
156
|
|
|
92
157
|
---
|
|
93
158
|
|
|
94
|
-
## Step
|
|
95
|
-
|
|
96
|
-
Adopt the **Tester** role as defined in `CLAUDE.md`. Apply for all risk levels.
|
|
97
|
-
|
|
98
|
-
1. Write a regression test that reproduces the original bug (fails before the
|
|
99
|
-
fix, passes after).
|
|
100
|
-
2. Verify that existing tests still pass.
|
|
101
|
-
3. Produce a Test Report: test added, case covered.
|
|
102
|
-
|
|
103
|
-
---
|
|
104
|
-
|
|
105
|
-
## Step 5 — Review (Reviewer role) — medium/high-risk only
|
|
159
|
+
## Step 6 — Review (Reviewer role) — medium/high-risk only
|
|
106
160
|
|
|
107
161
|
Adopt the **Reviewer** role as defined in `CLAUDE.md`. Use the diff and Task
|
|
108
162
|
Card.
|
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: >-
|
|
3
|
+
[cc: alias] Compact the session into gitignored `.codeconductor/sessions/handoff.md` (redact secrets).
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Handoff Workflow
|
|
7
|
+
|
|
8
|
+
Handoff request: $ARGUMENTS
|
|
9
|
+
|
|
10
|
+
## Step 0 — CCEP Bootstrap
|
|
11
|
+
|
|
12
|
+
Command: `handoff` (fixed for this workflow — do not infer from user text)
|
|
13
|
+
|
|
14
|
+
1. Run: `npx cc-codeconductor ccep parse --command handoff "$ARGUMENTS" --output json`
|
|
15
|
+
2. Run: `npx cc-codeconductor ccep resolve --command handoff "$ARGUMENTS" --output json`
|
|
16
|
+
3. Run: `npx cc-codeconductor ccep profile handoff --output json`
|
|
17
|
+
4. After planner/intake JSON is available, run: `npx cc-codeconductor ccep evaluate --command handoff --input <planner.json> --output json`. If `stop` is true, show questions or risks and wait for human input.
|
|
18
|
+
5. Delegate to subagents using compiled CCEP prompts — never forward raw `$ARGUMENTS` to planners.
|
|
19
|
+
|
|
20
|
+
---
|
|
21
|
+
|
|
22
|
+
## Step 1 — Compact (docs)
|
|
23
|
+
|
|
24
|
+
Invoke `docs`. Write **only** `.codeconductor/sessions/handoff.md` (gitignored).
|
|
25
|
+
Do not write `.codeconductor/handoff.md` or any tracked path.
|
|
26
|
+
|
|
27
|
+
Before writing, redact secrets, tokens, API keys, passwords, connection strings,
|
|
28
|
+
`.env` contents, and log/stack-trace lines that embed those values. Summarize
|
|
29
|
+
errors instead of pasting dumps. If unresolved credential material remains, stop
|
|
30
|
+
and wait for a human (CCEP `stopOnHighRisk`).
|
|
31
|
+
|
|
32
|
+
Include: goal, Task Card status (no secret fields), files touched, test
|
|
33
|
+
pass/fail (not log dumps), open questions, the next `/cc:` command, and the
|
|
34
|
+
recommended `context_scope` (`isolated` | `continuation` | `full`) for the next
|
|
35
|
+
session — derived from the Task Card status above, not invented, with a
|
|
36
|
+
one-sentence justification.
|
|
37
|
+
|
|
38
|
+
Do not edit source or tests.
|
|
39
|
+
|
|
40
|
+
---
|
|
41
|
+
|
|
42
|
+
## Completion
|
|
43
|
+
|
|
44
|
+
Report the handoff path. Another session should be able to continue from that file alone.
|