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
|
@@ -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
|
Invoke the `task-coach` subagent via the Task tool.
|
|
@@ -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
|
-
Invoke the `
|
|
49
|
+
Invoke the `tester` subagent via the Task tool.
|
|
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
|
-
Invoke the `
|
|
59
|
+
Invoke the `implementer` subagent via the Task tool.
|
|
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,7 +10,29 @@ 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
|
Invoke the `task-coach` subagent via the Task tool.
|
|
16
38
|
|
|
@@ -25,7 +47,7 @@ continuing.**
|
|
|
25
47
|
|
|
26
48
|
---
|
|
27
49
|
|
|
28
|
-
## Step
|
|
50
|
+
## Step 3 — Technical Plan (Architect role)
|
|
29
51
|
|
|
30
52
|
Invoke the `architect` subagent via the Task tool.
|
|
31
53
|
|
|
@@ -43,7 +65,20 @@ not proceed to implementation until the plan is approved.**
|
|
|
43
65
|
|
|
44
66
|
---
|
|
45
67
|
|
|
46
|
-
## Step
|
|
68
|
+
## Step 4 — Test coverage (Tester role)
|
|
69
|
+
|
|
70
|
+
Invoke the `tester` subagent via the Task tool.
|
|
71
|
+
|
|
72
|
+
Use the Implementation Summary and the Task Card.
|
|
73
|
+
|
|
74
|
+
1. Write or extend failing tests for the new behavior before implementation (RED).
|
|
75
|
+
2. Ensure all acceptance criteria from the Task Card have at least one test.
|
|
76
|
+
3. Run the full test suite and confirm it passes.
|
|
77
|
+
4. Produce a Test Report: test files added or modified, cases covered.
|
|
78
|
+
|
|
79
|
+
---
|
|
80
|
+
|
|
81
|
+
## Step 5 — Implementation (Implementer role)
|
|
47
82
|
|
|
48
83
|
Invoke the `implementer` subagent via the Task tool.
|
|
49
84
|
|
|
@@ -52,26 +87,13 @@ Implementer creates a Git Worktree before touching any file; all edits happen in
|
|
|
52
87
|
|
|
53
88
|
1. Read the Technical Plan before touching any file.
|
|
54
89
|
2. Apply the minimal diff — only what the plan specifies.
|
|
55
|
-
3. Run the project test suite
|
|
90
|
+
3. Run the project test suite and make the previously written failing tests pass.
|
|
56
91
|
4. Produce an Implementation Summary: what changed, which files, how to verify
|
|
57
92
|
locally.
|
|
58
93
|
|
|
59
94
|
---
|
|
60
95
|
|
|
61
|
-
## Step
|
|
62
|
-
|
|
63
|
-
Invoke the `tester` subagent via the Task tool.
|
|
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)
|
|
96
|
+
## Step 6 — Code review (Reviewer role)
|
|
75
97
|
|
|
76
98
|
Invoke the `reviewer` subagent via the Task tool.
|
|
77
99
|
|
|
@@ -85,7 +107,7 @@ they are resolved and the diff is re-reviewed.
|
|
|
85
107
|
|
|
86
108
|
---
|
|
87
109
|
|
|
88
|
-
## Step
|
|
110
|
+
## Step 7 — Documentation (Docs role)
|
|
89
111
|
|
|
90
112
|
Invoke the `docs` subagent via the Task tool.
|
|
91
113
|
|
|
@@ -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
|
Invoke the `task-coach` subagent via the Task tool.
|
|
24
46
|
|
|
@@ -32,11 +54,16 @@ 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
|
|
66
|
+
## Step 3 — Route by risk
|
|
40
67
|
|
|
41
68
|
Read the risk field from the Task Card and follow the corresponding route.
|
|
42
69
|
|
|
@@ -45,16 +72,16 @@ Read the risk field from the Task Card and follow the corresponding route.
|
|
|
45
72
|
Applies when: the bug is isolated to a single component, existing tests cover
|
|
46
73
|
the affected code, and no public API or shared state is involved.
|
|
47
74
|
|
|
48
|
-
Route: Task Coach →
|
|
75
|
+
Route: Task Coach → Tester → Implementer
|
|
49
76
|
|
|
50
|
-
Proceed directly to Step
|
|
77
|
+
Proceed directly to Step 3 (tests), then Step 4a.
|
|
51
78
|
|
|
52
79
|
### Medium or high-risk route
|
|
53
80
|
|
|
54
81
|
Applies when: the bug touches shared state, a public API, auth or payment paths,
|
|
55
82
|
database writes, or the root cause is not yet understood.
|
|
56
83
|
|
|
57
|
-
Route: Task Coach → Architect →
|
|
84
|
+
Route: Task Coach → Architect → Tester → Implementer → Reviewer
|
|
58
85
|
|
|
59
86
|
Invoke the `architect` subagent before implementation. Architect must:
|
|
60
87
|
|
|
@@ -68,19 +95,30 @@ before continuing.**
|
|
|
68
95
|
|
|
69
96
|
---
|
|
70
97
|
|
|
71
|
-
## Step
|
|
98
|
+
## Step 4 — Regression tests (Tester role)
|
|
99
|
+
|
|
100
|
+
Invoke the `tester` subagent via the Task tool. Apply for all risk levels.
|
|
101
|
+
|
|
102
|
+
1. Write a regression test that reproduces the original bug and confirm it fails
|
|
103
|
+
before any fix (RED).
|
|
104
|
+
2. Verify that existing tests still pass.
|
|
105
|
+
3. Produce a Test Report: test added, case covered.
|
|
106
|
+
|
|
107
|
+
---
|
|
108
|
+
|
|
109
|
+
## Step 5a — Implementation, low-risk (Implementer role)
|
|
72
110
|
|
|
73
111
|
Invoke the `implementer` subagent via the Task tool. Use the Task Card.
|
|
74
112
|
Implementer creates a Git Worktree before touching any file; all edits happen inside it.
|
|
75
113
|
|
|
76
114
|
1. Locate the defect using the reproduction steps.
|
|
77
115
|
2. Apply the minimal fix — no unrelated changes.
|
|
78
|
-
3. Run the test
|
|
116
|
+
3. Run the suite and make the RED regression test pass.
|
|
79
117
|
4. Produce an Implementation Summary: root cause, fix applied, files changed.
|
|
80
118
|
|
|
81
119
|
---
|
|
82
120
|
|
|
83
|
-
## Step
|
|
121
|
+
## Step 5b — Implementation, medium/high-risk (Implementer role)
|
|
84
122
|
|
|
85
123
|
Invoke the `implementer` subagent via the Task tool. Use the approved
|
|
86
124
|
Technical Plan and the Task Card.
|
|
@@ -91,18 +129,7 @@ After implementation, run the full test suite.
|
|
|
91
129
|
|
|
92
130
|
---
|
|
93
131
|
|
|
94
|
-
## Step
|
|
95
|
-
|
|
96
|
-
Invoke the `tester` subagent via the Task tool. 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
|
|
132
|
+
## Step 6 — Review (Reviewer role) — medium/high-risk only
|
|
106
133
|
|
|
107
134
|
Invoke the `reviewer` subagent via the Task tool. Use the diff and Task
|
|
108
135
|
Card.
|
|
@@ -0,0 +1,41 @@
|
|
|
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, and the next `/cc:` command.
|
|
34
|
+
|
|
35
|
+
Do not edit source or tests.
|
|
36
|
+
|
|
37
|
+
---
|
|
38
|
+
|
|
39
|
+
## Completion
|
|
40
|
+
|
|
41
|
+
Report the handoff path. Another session should be able to continue from that file alone.
|
|
@@ -0,0 +1,133 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: >-
|
|
3
|
+
[cc: alias] Run the advanced iterative workflow — Wayfinding AST discovery,
|
|
4
|
+
Relentless Grilling, contract and spec design, TDD, council review, and docs.
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# Advanced Iterative Workflow
|
|
8
|
+
|
|
9
|
+
Iterative request: $ARGUMENTS
|
|
10
|
+
|
|
11
|
+
---
|
|
12
|
+
|
|
13
|
+
## Step 0 — CCEP Bootstrap
|
|
14
|
+
|
|
15
|
+
Command: `iterative` (fixed for this workflow — do not infer from user text)
|
|
16
|
+
|
|
17
|
+
1. Run: `npx cc-codeconductor ccep parse --command iterative "$ARGUMENTS" --output json`
|
|
18
|
+
2. Run: `npx cc-codeconductor ccep resolve --command iterative "$ARGUMENTS" --output json`
|
|
19
|
+
3. Run: `npx cc-codeconductor ccep profile iterative --output json`
|
|
20
|
+
4. After planner/intake JSON is available, run: `npx cc-codeconductor ccep evaluate --command iterative --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 two modules or one concept need a
|
|
30
|
+
scoped subgraph). Then invoke the `repo-explorer` subagent via the Task tool
|
|
31
|
+
with that graph output.
|
|
32
|
+
|
|
33
|
+
repo-explorer maps directory trees, conventions, god nodes, and affected
|
|
34
|
+
modules. Do not write code in this step. Write a short phase handoff (scope,
|
|
35
|
+
files, open questions) before the next phase — do not chain agents on unspoken
|
|
36
|
+
context.
|
|
37
|
+
|
|
38
|
+
---
|
|
39
|
+
|
|
40
|
+
## Step 2 — Relentless Grilling & Task Card (task-coach)
|
|
41
|
+
|
|
42
|
+
Invoke the `task-coach` subagent via the Task tool.
|
|
43
|
+
|
|
44
|
+
Produce a complete Task Card. The Task Card is ready when it contains: title,
|
|
45
|
+
type, risk classification, scope, context, acceptance criteria, and
|
|
46
|
+
constraints, and every assumption behind it has survived one grilling
|
|
47
|
+
question (Grilling protocol).
|
|
48
|
+
|
|
49
|
+
If any field is missing or ambiguous, ask one clarifying question at a time and
|
|
50
|
+
wait for the answer. Do not proceed with an incomplete Task Card.
|
|
51
|
+
|
|
52
|
+
**STOP here.** Unresolved grilling questions or missing fields populate
|
|
53
|
+
`questionsForUser` in the CCEP-1 `planner-output`; the `ConfirmationGate`
|
|
54
|
+
(`ccep evaluate`) reads that field and halts the workflow until a human
|
|
55
|
+
answers. Show the completed Task Card and wait for that confirmation before
|
|
56
|
+
continuing.
|
|
57
|
+
|
|
58
|
+
---
|
|
59
|
+
|
|
60
|
+
## Step 3 — Contract & Technical Plan (contract-builder & architect)
|
|
61
|
+
|
|
62
|
+
Invoke `contract-builder` then `architect` via the Task tool.
|
|
63
|
+
|
|
64
|
+
1. Define API contracts, JSON Schemas, or TypeScript interfaces.
|
|
65
|
+
2. Formulate the Technical Plan (chosen approach, affected files, trade-offs).
|
|
66
|
+
3. Apply YAGNI, Simplicity First, and Stdlib-First.
|
|
67
|
+
|
|
68
|
+
**STOP here. Show the Technical Plan and wait for explicit human approval. Do
|
|
69
|
+
not proceed to tests until the plan is approved.**
|
|
70
|
+
|
|
71
|
+
---
|
|
72
|
+
|
|
73
|
+
## Step 4 — Test coverage (Tester role)
|
|
74
|
+
|
|
75
|
+
Invoke the `tester` subagent via the Task tool.
|
|
76
|
+
|
|
77
|
+
1. Write or extend failing tests for the new behavior before implementation (RED).
|
|
78
|
+
2. Ensure all acceptance criteria from the Task Card have at least one test.
|
|
79
|
+
3. Produce a Test Report: test files added or modified, cases covered.
|
|
80
|
+
|
|
81
|
+
---
|
|
82
|
+
|
|
83
|
+
## Step 5 — Implementation (Implementer role)
|
|
84
|
+
|
|
85
|
+
Invoke the `implementer` subagent via the Task tool.
|
|
86
|
+
|
|
87
|
+
Use the approved Technical Plan, contracts, and the failing tests.
|
|
88
|
+
Implementer creates a Git Worktree before touching any file; all edits happen
|
|
89
|
+
inside it.
|
|
90
|
+
|
|
91
|
+
1. Read the Technical Plan before touching any file.
|
|
92
|
+
2. Apply the minimal diff — only what the plan specifies.
|
|
93
|
+
3. Run the project test suite and make the previously written failing tests pass.
|
|
94
|
+
4. If tests fail, run up to 3 repair cycles (`implementer` → `tester`).
|
|
95
|
+
5. Produce an Implementation Summary: what changed, which files, how to verify
|
|
96
|
+
locally.
|
|
97
|
+
|
|
98
|
+
---
|
|
99
|
+
|
|
100
|
+
## Step 6 — Multi-Perspective Council Review
|
|
101
|
+
|
|
102
|
+
Invoke the `council` skill on the generated diff (`council-review` phase).
|
|
103
|
+
|
|
104
|
+
The council evaluates Architecture, Security, Product, Delivery, DataOps, and
|
|
105
|
+
Devil. `security-reviewer` may set `securityVeto: true`; that REJECTED verdict
|
|
106
|
+
overrides majority consensus.
|
|
107
|
+
|
|
108
|
+
If ANY agent votes CRITICAL:
|
|
109
|
+
- The Review Report status is **BLOCKED**.
|
|
110
|
+
- Return to Step 5 with the feedback.
|
|
111
|
+
|
|
112
|
+
If APPROVED (no CRITICAL findings), continue.
|
|
113
|
+
|
|
114
|
+
---
|
|
115
|
+
|
|
116
|
+
## Step 7 — Documentation (Docs role)
|
|
117
|
+
|
|
118
|
+
Invoke the `docs` subagent via the Task tool when a public API, public module,
|
|
119
|
+
or user-visible behavior changed.
|
|
120
|
+
|
|
121
|
+
Update: README (if applicable), OpenAPI spec (if applicable), CHANGELOG
|
|
122
|
+
(always when implementation changed), ADR (if an architectural decision was
|
|
123
|
+
made).
|
|
124
|
+
|
|
125
|
+
If `graphify-out/` is in use, run `graphify update .` (AST-only).
|
|
126
|
+
|
|
127
|
+
---
|
|
128
|
+
|
|
129
|
+
## Completion
|
|
130
|
+
|
|
131
|
+
The iterative workflow is complete only when: all tests pass, the council
|
|
132
|
+
approves the spec and the diff, no CRITICAL findings remain, and documentation
|
|
133
|
+
and the knowledge graph reflect the implemented behavior.
|
|
@@ -12,7 +12,22 @@ Orchestrate FIFO delivery from `BACKLOG.md`. CodeConductor owns planning; agents
|
|
|
12
12
|
|
|
13
13
|
---
|
|
14
14
|
|
|
15
|
-
|
|
15
|
+
---
|
|
16
|
+
|
|
17
|
+
## Step 0 — CCEP Bootstrap
|
|
18
|
+
|
|
19
|
+
Command: `openspec` (fixed for this workflow — do not infer from user text)
|
|
20
|
+
|
|
21
|
+
1. Run: `npx cc-codeconductor ccep parse --command openspec "$ARGUMENTS" --output json`
|
|
22
|
+
2. Run: `npx cc-codeconductor ccep resolve --command openspec "$ARGUMENTS" --output json`
|
|
23
|
+
3. Run: `npx cc-codeconductor ccep profile openspec --output json`
|
|
24
|
+
4. After planner/intake JSON is available, run: `npx cc-codeconductor ccep evaluate --command openspec --input <planner.json> --output json`. If `stop` is true, show questions or risks and wait for human input.
|
|
25
|
+
5. Delegate to subagents using compiled CCEP prompts — never forward raw `$ARGUMENTS` to planners.
|
|
26
|
+
Canonical delivery order is test-before-implement whenever both phases apply.
|
|
27
|
+
|
|
28
|
+
---
|
|
29
|
+
|
|
30
|
+
## Step 1 — Validate (mandatory gate)
|
|
16
31
|
|
|
17
32
|
Run:
|
|
18
33
|
|
|
@@ -28,7 +43,7 @@ If validation fails:
|
|
|
28
43
|
|
|
29
44
|
---
|
|
30
45
|
|
|
31
|
-
## Step
|
|
46
|
+
## Step 2 — Scan
|
|
32
47
|
|
|
33
48
|
Run:
|
|
34
49
|
|
|
@@ -40,7 +55,7 @@ Report: new items, modified items, closed/archived items, and whether the file c
|
|
|
40
55
|
|
|
41
56
|
---
|
|
42
57
|
|
|
43
|
-
## Step
|
|
58
|
+
## Step 3 — Select item
|
|
44
59
|
|
|
45
60
|
If `$ARGUMENTS` contains a `BC-xxx` ID, use that item. Otherwise run:
|
|
46
61
|
|
|
@@ -54,7 +69,7 @@ Pick the next `READY` item with satisfied dependencies (FIFO by priority). Skip
|
|
|
54
69
|
|
|
55
70
|
---
|
|
56
71
|
|
|
57
|
-
## Step
|
|
72
|
+
## Step 4 — Plan
|
|
58
73
|
|
|
59
74
|
Run:
|
|
60
75
|
|
|
@@ -71,7 +86,22 @@ Update BACKLOG item status to `PLANNED` (CLI does this automatically).
|
|
|
71
86
|
|
|
72
87
|
---
|
|
73
88
|
|
|
74
|
-
##
|
|
89
|
+
## Drive card status (CLI)
|
|
90
|
+
|
|
91
|
+
Do not edit `.codeconductor/openspec-state.json` by hand.
|
|
92
|
+
|
|
93
|
+
```bash
|
|
94
|
+
npx cc-codeconductor openspec start <cardId>
|
|
95
|
+
npx cc-codeconductor openspec done <cardId>
|
|
96
|
+
npx cc-codeconductor openspec block <cardId> --reason "waiting on design"
|
|
97
|
+
npx cc-codeconductor openspec archive <itemId>
|
|
98
|
+
```
|
|
99
|
+
|
|
100
|
+
`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. `archive` requires all cards done (and review evidence when Global review is required) and moves `openspec/changes/<slug>` to `archive/`.
|
|
101
|
+
|
|
102
|
+
---
|
|
103
|
+
|
|
104
|
+
## Step 5 — Model matrix and execute loop
|
|
75
105
|
|
|
76
106
|
Before executing phases, show resolved models:
|
|
77
107
|
|
|
@@ -100,13 +130,13 @@ Use the model configured in the installed preset for each agent role.
|
|
|
100
130
|
After each phase:
|
|
101
131
|
|
|
102
132
|
- Mark progress in deliverable summary.
|
|
103
|
-
-
|
|
133
|
+
- Run `npx cc-codeconductor openspec done <cardId>` when the phase completes. Do not edit openspec-state.json by hand.
|
|
104
134
|
|
|
105
135
|
Implementer: create a Git worktree before editing (`git worktree add ../<branch>-session <branch>`).
|
|
106
136
|
|
|
107
137
|
---
|
|
108
138
|
|
|
109
|
-
## Step
|
|
139
|
+
## Step 6 — Review gate
|
|
110
140
|
|
|
111
141
|
Run regression when BACKLOG Global `Review required: yes`:
|
|
112
142
|
|
|
@@ -127,7 +157,7 @@ If **approved**: proceed to Step 6.
|
|
|
127
157
|
|
|
128
158
|
---
|
|
129
159
|
|
|
130
|
-
## Step
|
|
160
|
+
## Step 7 — Scorecard and update backlog
|
|
131
161
|
|
|
132
162
|
1. `npx cc-codeconductor scorecard create --task <BC-id> --from-diff`
|
|
133
163
|
2. Complete criteria; `scorecard record` with verdict and optional cost/tokens
|
|
@@ -4,6 +4,18 @@ Audit web performance using the PageSpeed Insights API. Applies the 80/20
|
|
|
4
4
|
principle: identify the 20% of changes that produce 80% of the performance gain.
|
|
5
5
|
Produces a prioritized report in the current working directory.
|
|
6
6
|
|
|
7
|
+
## Step 0 — CCEP Bootstrap
|
|
8
|
+
|
|
9
|
+
Command: `pagespeed` (fixed for this workflow — do not infer from user text)
|
|
10
|
+
|
|
11
|
+
1. Run: `npx cc-codeconductor ccep parse --command pagespeed "$ARGUMENTS" --output json`
|
|
12
|
+
2. Run: `npx cc-codeconductor ccep resolve --command pagespeed "$ARGUMENTS" --output json`
|
|
13
|
+
3. Run: `npx cc-codeconductor ccep profile pagespeed --output json`
|
|
14
|
+
4. After planner/intake JSON is available, run: `npx cc-codeconductor ccep evaluate --command pagespeed --input <planner.json> --output json`. If `stop` is true, show questions or risks and wait for human input.
|
|
15
|
+
5. Delegate to subagents using compiled CCEP prompts — never forward raw `$ARGUMENTS` to planners.
|
|
16
|
+
|
|
17
|
+
---
|
|
18
|
+
|
|
7
19
|
## Usage
|
|
8
20
|
|
|
9
21
|
```
|
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: >-
|
|
3
|
+
[cc: alias] Disposable spike in an isolated worktree. Not a merge candidate.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Prototype Workflow
|
|
7
|
+
|
|
8
|
+
Prototype request: $ARGUMENTS
|
|
9
|
+
|
|
10
|
+
## Step 0 — CCEP Bootstrap
|
|
11
|
+
|
|
12
|
+
Command: `prototype` (fixed for this workflow — do not infer from user text)
|
|
13
|
+
|
|
14
|
+
1. Run: `npx cc-codeconductor ccep parse --command prototype "$ARGUMENTS" --output json`
|
|
15
|
+
2. Run: `npx cc-codeconductor ccep resolve --command prototype "$ARGUMENTS" --output json`
|
|
16
|
+
3. Run: `npx cc-codeconductor ccep profile prototype --output json`
|
|
17
|
+
4. After planner/intake JSON is available, run: `npx cc-codeconductor ccep evaluate --command prototype --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 — Bounds (architect)
|
|
23
|
+
|
|
24
|
+
Invoke `architect`. Define what the spike may touch, time-box, and what must not leak into main. Do not treat this as a production Technical Plan.
|
|
25
|
+
|
|
26
|
+
**STOP here. Wait for approval of the spike bounds.**
|
|
27
|
+
|
|
28
|
+
---
|
|
29
|
+
|
|
30
|
+
## Step 2 — Spike (implementer)
|
|
31
|
+
|
|
32
|
+
Invoke `implementer` in a Git worktree that is not a merge candidate. Label the Implementation Summary as disposable. Do not open a PR against protected branches.
|
|
33
|
+
|
|
34
|
+
---
|
|
35
|
+
|
|
36
|
+
## Completion
|
|
37
|
+
|
|
38
|
+
Report bounds, worktree path, and what was learned. Recommend `/cc:feature` or `/cc:fix` if the spike should become real work.
|
|
@@ -33,6 +33,18 @@ If coverage is insufficient:
|
|
|
33
33
|
|
|
34
34
|
---
|
|
35
35
|
|
|
36
|
+
## Step 0 — CCEP Bootstrap
|
|
37
|
+
|
|
38
|
+
Command: `refactor` (fixed for this workflow — do not infer from user text)
|
|
39
|
+
|
|
40
|
+
1. Run: `npx cc-codeconductor ccep parse --command refactor "$ARGUMENTS" --output json`
|
|
41
|
+
2. Run: `npx cc-codeconductor ccep resolve --command refactor "$ARGUMENTS" --output json`
|
|
42
|
+
3. Run: `npx cc-codeconductor ccep profile refactor --output json`
|
|
43
|
+
4. After planner/intake JSON is available, run: `npx cc-codeconductor ccep evaluate --command refactor --input <planner.json> --output json`. If `stop` is true, show questions or risks and wait for human input.
|
|
44
|
+
5. Delegate to subagents using compiled CCEP prompts — never forward raw `$ARGUMENTS` to planners.
|
|
45
|
+
|
|
46
|
+
---
|
|
47
|
+
|
|
36
48
|
## Step 1 — Architectural justification (Architect role)
|
|
37
49
|
|
|
38
50
|
Invoke the `architect` subagent via the Task tool. Always invoke this step
|
|
@@ -17,6 +17,18 @@ Specify what to review. Accepted formats:
|
|
|
17
17
|
|
|
18
18
|
---
|
|
19
19
|
|
|
20
|
+
## Step 0 — CCEP Bootstrap
|
|
21
|
+
|
|
22
|
+
Command: `review` (fixed for this workflow — do not infer from user text)
|
|
23
|
+
|
|
24
|
+
1. Run: `npx cc-codeconductor ccep parse --command review "$ARGUMENTS" --output json`
|
|
25
|
+
2. Run: `npx cc-codeconductor ccep resolve --command review "$ARGUMENTS" --output json`
|
|
26
|
+
3. Run: `npx cc-codeconductor ccep profile review --output json`
|
|
27
|
+
4. After planner/intake JSON is available, run: `npx cc-codeconductor ccep evaluate --command review --input <planner.json> --output json`. If `stop` is true, show questions or risks and wait for human input.
|
|
28
|
+
5. Delegate to subagents using compiled CCEP prompts — never forward raw `$ARGUMENTS` to planners.
|
|
29
|
+
|
|
30
|
+
---
|
|
31
|
+
|
|
20
32
|
## Step 1 — Diff collection
|
|
21
33
|
|
|
22
34
|
Before adopting the Reviewer role, collect the diff for the specified target.
|