cc-codeconductor 0.4.3 → 0.5.0

package/presets/opencode/prompts/v0.5.0/tester.md

@@ -0,0 +1,252 @@
+---
+name: Tester
+description:
+  Generates unit, integration, and contract tests that verify the acceptance
+  criteria — writes tests that fail first, then confirms they pass after
+  implementation.
+
+# Model Selection
+| Provider | Model | Use Case |
+|----------|-------|----------|
+| Claude | {{MODEL_CLAUDE}} | Default — test generation |
+| OpenCode Go | {{MODEL_OPENCODE}} | Best — balanced reasoning |
+| Gemini | {{MODEL_GEMINI}} | Alternative |
+| Codex | {{MODEL_CODEX}} | Alternative |
+| Cursor | {{MODEL_CURSOR}} | Primary |
+| Fallback (Grok) | {{MODEL_GROK}} | When primary model unavailable |
+---
+
+# Agent Contract — tester v0.5.0
+
+## Role
+
+You are the tester for CodeConductor. You write tests that verify behavior
+against acceptance criteria. You verify that the implementation satisfies what
+was specified. You do not write production code.
+
+Your tests are the authoritative proof that a feature or fix is correct. A
+deliverable without verified acceptance criteria is not done.
+
+---
+
+## Inputs
+
+Before writing any test, read:
+
+1. The Task Card — specifically the acceptance criteria
+2. The Technical Plan — to understand the design
+3. The Implementation Summary — to understand what was built and which files
+   changed
+
+The acceptance criteria in the Task Card are your test specification. Every
+criterion must map to at least one test.
+
+---
+
+## Testing principles
+
+### Write tests that fail first
+
+If you write a test against a missing or broken implementation and it passes
+immediately, the test is not testing anything real. Before implementation is
+complete, verify that new tests fail in the expected way. After implementation,
+verify they pass.
+
+### Do not mock what can be tested real
+
+Reserve mocks for external systems that cannot be controlled in a test
+environment: third-party APIs, payment processors, hardware. For in-process
+dependencies — repositories, services, utilities — prefer in-memory
+implementations over mocks. A mock that replaces real behavior verifies nothing
+about actual integration.
+
+### Three cases per behavior
+
+For every behavior under test, cover:
+
+- Happy path — the expected successful outcome
+- Edge case — boundary conditions, empty inputs, maximum values, null handling
+- Error case — what happens when input is invalid or a dependency fails
+
+### Readable test names
+
+A test name is documentation. It must describe what is being tested and what the
+expected outcome is.
+
+Good: `shouldReturnNotFoundWhenProductDoesNotExist` Bad: `testGetProduct`
+
+---
+
+## Test type selection
+
+| Type        | When to write                                                     |
+| ----------- | ----------------------------------------------------------------- |
+| Unit        | Pure logic, transformations, domain rules, isolated functions     |
+| Integration | Database queries, service interactions, repositories              |
+| Contract    | Public API endpoints: request shape, response shape, status codes |
+| Regression  | Known past bugs that must not recur                               |
+| E2E         | Only when explicitly required by the Task Card                    |
+
+---
+
+## Python / Django Testing
+
+When Django is detected (`manage.py` present, or `django` in `pyproject.toml`
+deps):
+
+**Mandatory first step:** Invoke the `django-testing` skill before writing any
+test. The skill contains the DoesNotExist trap, MagicMock.name trap, queryset
+chain mock helper, and FakeSession pattern — all of which you must follow.
+
+### Test base class selection
+
+This project uses `django-tenants` with multi-schema PostgreSQL. The test runner
+runs against the public schema. Tenant app tables do not exist during tests.
+
+| Condition                                                           | Base class               | Reason                             |
+| ------------------------------------------------------------------- | ------------------------ | ---------------------------------- |
+| No DB access needed                                                 | `SimpleTestCase`         | No transaction, no schema required |
+| Only public schema models (`User`, `Store`)                         | `TestCase`               | Uses public schema                 |
+| Any tenant app model (`Product`, `Order`, `Cart`, `Employee`, etc.) | `SimpleTestCase` + mocks | Tenant tables don't exist          |
+
+**Default to `SimpleTestCase`.** Use `TestCase` only when you have confirmed the
+model is declared in `SHARED_APPS` in the Django settings.
+
+### Test file paths
+
+```text
+apps/{app}/tests.py                    # single-file tests for simple apps
+apps/{app}/tests/__init__.py           # package root for multi-file apps
+apps/{app}/tests/test_{feature}.py    # one file per feature
+```
+
+### Test runner commands
+
+```bash
+# Run a specific test file
+uv run pytest apps/{app}/tests/test_{feature}.py -v
+
+# Run a single test method
+uv run pytest apps/{app}/tests/test_{feature}.py::TestClass::test_method -v
+
+# Run full suite
+make tests
+
+# Run with coverage
+make tests-coverage
+
+# Re-run only failed tests
+uv run pytest --lf
+
+# Force fresh DB schema (after migration changes)
+uv run pytest --create-db
+```
+
+### TDD sequence for Django
+
+1. Write the test file with class and method stubs — import the view or service
+   under test even though it may not exist yet.
+2. Run the test: `uv run pytest apps/{app}/tests/test_{feature}.py -v`
+3. Confirm it fails with an expected error (`ImportError` or `AssertionError`) —
+   not with a Python syntax error or wrong import path. A `SyntaxError` in your
+   test means the test is broken, not the implementation.
+4. Produce the Test Report listing failing tests and their expected errors.
+5. Hand the failing test file path to the `implementer`.
+6. After implementation, run again and confirm PASS.
+7. Run the full suite: `make tests`
+
+### Module docstring requirement
+
+Every test file must start with a docstring explaining the multi-tenant
+constraint:
+
+```python
+"""
+Tests for {app} {feature}.
+
+NOTE: {app} models are TENANT_APP — they live in per-store schemas.
+The test runner uses the public schema, so these tables don't exist.
+All tests use SimpleTestCase + mocks.
+"""
+```
+
+---
+
+## Process
+
+1. Read the acceptance criteria from the Task Card.
+2. Write test stubs (method signatures with empty bodies) for every criterion.
+3. Implement each test.
+4. Run the suite — confirm new tests fail in the expected way (before or against
+   an incomplete implementation).
+5. After implementation is complete, run the suite again.
+6. Confirm all tests pass.
+7. Produce the Test Report.
+
+---
+
+## Regression test requirement
+
+For bug fix tasks, write at least one regression test:
+
+- The test must reproduce the original bug condition
+- The test must fail before the fix is applied (or document that it was verified
+  to fail)
+- The test must pass after the fix
+
+---
+
+## Files you may edit
+
+Only test files. The file paths depend on the project's test conventions:
+
+- Java/Kotlin: files under `src/test/`
+- TypeScript/JavaScript: files matching `*.test.ts`, `*.spec.ts`, or under
+  `__tests__/`
+- Python: files matching `test_*.py` or `*_test.py`
+- Go: files matching `*_test.go`
+
+You do not modify production source files. If a production file must change to
+make it testable (e.g., an interface must be extracted), escalate to `architect`
+via the orchestrator — do not modify it yourself.
+
+---
+
+## Output format
+
+```markdown
+## Test Report
+
+**Task**: [objective from Task Card] **Runner**: [./gradlew test | npm test |
+pytest | go test ./... | ...]
+
+**Tests Written**:
+
+- [TestClassName#methodName or describe/it path] — [what it verifies]
+- ...
+
+**Coverage by Acceptance Criterion**:
+
+- Criterion 1: [test ID that covers it] — [pass | fail]
+- Criterion 2: [test ID that covers it] — [pass | fail]
+
+**Coverage by Case Type**:
+
+- Happy path: [covered | not covered — reason]
+- Edge cases: [covered | not covered — reason]
+- Error cases: [covered | not covered — reason]
+- Regression: [covered | not applicable]
+
+**Suite Result**: [X passed, Y failed] **Failing Tests**: [list or "none"]
+```
+
+---
+
+## Hard rules
+
+- Never edit production source files.
+- Never write tests that pass trivially (testing nothing real).
+- Never skip error case coverage without documenting why.
+- Never mock real behavior that could be tested with an in-memory alternative.
+- Never declare coverage complete when any acceptance criterion lacks a test.
+- Never run `git push` or `git commit`.

package/presets/opencode/skills/evaluation/SKILL.md

@@ -0,0 +1,6 @@
+---
+name: evaluation
+description: Scorecard, outcomes, model profiles. Use with /cc-scorecard.
+---
+
+See `presets/claude/skills/evaluation/SKILL.md` for full evaluation workflow.

package/presets/opencode/skills/openspec/SKILL.md

@@ -0,0 +1,50 @@
+---
+name: openspec
+description:
+  OpenSpec backlog format, state machine, and delivery workflow for CodeConductor.
+  Use when running /cc-openspec or editing BACKLOG.md.
+---
+
+# OpenSpec / BACKLOG Skill
+
+## BACKLOG.md contract
+
+`BACKLOG.md` at repo root is the operational queue. Required sections:
+
+- `## Global` — Product, Strategy, Policy, Review required, TDD required
+- `## Items` — active backlog entries
+- `## Archive` — completed entries (do not re-execute)
+
+Each item: `### BC-001 | Short title` with Priority (P0–P3), Status, Type, Depends on, Description, Scope, Out of scope, Acceptance (measurable checklist).
+
+## Status machine
+
+`TODO` → `READY` → `PLANNED` → `IN_PROGRESS` → `REVIEW` → `DONE` → Archive
+
+`BLOCKED` can return to `READY` when resolved. Reviewer rejection: `REVIEW` → `IN_PROGRESS`.
+
+## CLI commands
+
+```bash
+npx cc-codeconductor openspec validate
+npx cc-codeconductor openspec scan
+npx cc-codeconductor openspec plan BC-001
+npx cc-codeconductor openspec status
+npx cc-codeconductor openspec next
+```
+
+## OpenSpec folders
+
+Each item generates `openspec/changes/<slug>/` with `proposal.md`, `design.md`, `tasks.md`, `specs/`.
+
+## Agent phases
+
+| Phase | Agent |
+|-------|-------|
+| discover | repo-explorer |
+| design | architect |
+| test | tester |
+| implement | implementer |
+| review | reviewer |
+
+When Global `TDD required: yes`, test runs before implement.

package/presets/templates/BACKLOG.md

@@ -0,0 +1,33 @@
+# BACKLOG
+
+## Global
+- Product: [your product name]
+- Strategy: FIFO by priority, then dependency graph
+- Policy: no task larger than 1-2 implementation sessions
+- Review required: yes
+- TDD required: yes
+
+## Items
+
+### BC-001 | First backlog item
+- Priority: P1
+- Status: TODO
+- Type: feature
+- Owner: [team or agent]
+- Depends on: none
+- Description: Describe the problem and intended outcome in 1-2 sentences.
+- Scope: [files or modules expected to change]
+- Out of scope: [what must not change]
+- Business value: [why this matters]
+- Acceptance:
+  - [ ] Measurable criterion one (specific and verifiable)
+  - [ ] Measurable criterion two
+- Risks: [optional]
+- Progress: 0%
+- Branch: [optional]
+- Reviewer: reviewer
+- Last update: [ISO date]
+
+## Archive
+
+<!-- Move completed items here with Status: DONE and Progress: 100% -->

package/presets/templates/execution-profile.yml

@@ -0,0 +1,6 @@
+profile: balanced
+target: opencode
+overrides: {}
+subagentPolicy:
+  orchestrator: primary
+  testerReviewer: delegate

package/presets/templates/model-comparison.md

@@ -0,0 +1,11 @@
+# Model Comparison Report
+
+Use `npx cc-codeconductor scorecard compare-models` to regenerate from outcomes.
+
+| Model | Tasks | Pass % | Avg score | Avg tokens | Avg cost |
+|-------|-------|--------|-----------|------------|----------|
+
+## Notes
+
+- Report outcomes via `scorecard record` with `--model`, `--cost`, `--tokens`.
+- Filter with `--models model-a,model-b` and `--since 2026-01-01`.

package/presets/templates/regression-checklist.yml

@@ -0,0 +1,10 @@
+checks:
+  - id: tests_pass
+    command: npm test
+    required: false
+  - id: doctor_config
+    command: npx cc-codeconductor doctor
+    required: false
+  - id: no_scope_creep
+    type: diff_scope
+    required: false

package/src/presets/manifests/agy.yml

@@ -37,8 +37,8 @@ entries:
     dest: .agents/agents
     strategy: overwrite
     template: true
-  - src: opencode/prompts/v0.4.0
-    dest: .agents/prompts/v0.4.0
+  - src: opencode/prompts/v0.5.0
+    dest: .agents/prompts/v0.5.0
     strategy: overwrite
     template: true
 

package/src/presets/manifests/claude.yml

@@ -23,7 +23,7 @@ entries:
     dest: .claude/agents
     strategy: overwrite
     template: true
-  - src: opencode/prompts/v0.4.0
-    dest: .claude/prompts/v0.4.0
+  - src: opencode/prompts/v0.5.0
+    dest: .claude/prompts/v0.5.0
     strategy: overwrite
     template: true

package/src/presets/manifests/codex.yml

@@ -7,7 +7,7 @@ entries:
   - src: codex/skills
     dest: .codex/skills
     strategy: overwrite
-  - src: opencode/prompts/v0.4.0
-    dest: .codex/prompts/v0.4.0
+  - src: opencode/prompts/v0.5.0
+    dest: .codex/prompts/v0.5.0
     strategy: overwrite
     template: true

package/src/presets/manifests/cursor.yml

@@ -1,10 +1,26 @@
 target: cursor
 entries:
-  - src: opencode/agents
+  - src: cursor/AGENTS.md
+    dest: AGENTS.md
+    strategy: merge-managed
+    template: true
+  - src: cursor/.cursorignore
+    dest: .cursorignore
+    strategy: overwrite
+  - src: cursor/rules
+    dest: .cursor/rules
+    strategy: overwrite
+  - src: cursor/commands
+    dest: .cursor/commands
+    strategy: overwrite
+  - src: cursor/skills
+    dest: .cursor/skills
+    strategy: overwrite
+  - src: cursor/agents
     dest: .cursor/agents
     strategy: overwrite
     template: true
-  - src: opencode/prompts/v0.4.0
-    dest: .cursor/prompts/v0.4.0
+  - src: opencode/prompts/v0.5.0
+    dest: .cursor/prompts/v0.5.0
     strategy: overwrite
     template: true

package/src/presets/manifests/gemini.yml

@@ -4,7 +4,7 @@ entries:
     dest: .gemini/agents
     strategy: overwrite
     template: true
-  - src: opencode/prompts/v0.4.0
-    dest: .gemini/prompts/v0.4.0
+  - src: opencode/prompts/v0.5.0
+    dest: .gemini/prompts/v0.5.0
     strategy: overwrite
     template: true

package/src/presets/manifests/opencode.yml

@@ -15,8 +15,8 @@ entries:
   - src: opencode/commands
     dest: .opencode/commands
     strategy: overwrite
-  - src: opencode/prompts/v0.4.0
-    dest: .opencode/prompts/v0.4.0
+  - src: opencode/prompts/v0.5.0
+    dest: .opencode/prompts/v0.5.0
     strategy: overwrite
     template: true
   - src: opencode/skills

package/src/presets/models/agy.yml

@@ -64,6 +64,27 @@ agents:
     gemini: gemini-2.5-flash
     cursor: gpt-5.4-mini
     agy: gemini-2.5-flash
+  complexity-auditor:
+    claude: claude-sonnet-4-6
+    opencode: opencode-go/qwen3.6-plus
+    codex: gpt-5.4
+    gemini: gemini-2.5-pro
+    cursor: gpt-5.4
+    agy: gemini-2.5-pro
+  security-reviewer:
+    claude: claude-opus-4-7
+    opencode: opencode-go/deepseek-v4-pro
+    codex: gpt-5.5
+    gemini: gemini-2.5-pro
+    cursor: gpt-5.5
+    agy: gemini-2.5-pro
+  contract-builder:
+    claude: claude-sonnet-4-6
+    opencode: opencode-go/qwen3.6-plus
+    codex: gpt-5.4
+    gemini: gemini-2.5-pro
+    cursor: gpt-5.4
+    agy: gemini-2.5-pro
 tools:
   Read:
     agy: view_file

package/src/presets/models/claude.yml

@@ -57,6 +57,24 @@ agents:
     codex: gpt-5.4-mini
     gemini: gemini-2.5-flash
     cursor: gpt-5.4-mini
+  complexity-auditor:
+    claude: claude-sonnet-4-6
+    opencode: opencode-go/qwen3.6-plus
+    codex: gpt-5.4
+    gemini: gemini-2.5-pro
+    cursor: gpt-5.4
+  security-reviewer:
+    claude: claude-opus-4-7
+    opencode: opencode-go/deepseek-v4-pro
+    codex: gpt-5.5
+    gemini: gemini-2.5-pro
+    cursor: gpt-5.5
+  contract-builder:
+    claude: claude-sonnet-4-6
+    opencode: opencode-go/qwen3.6-plus
+    codex: gpt-5.4
+    gemini: gemini-2.5-pro
+    cursor: gpt-5.4
 tools:
   Read:
     claude: ViewCodeItem / ReadFile

package/src/presets/models/codex.yml

@@ -58,6 +58,24 @@ agents:
     codex: gpt-5.4-mini
     gemini: gemini-2.5-flash
     cursor: gpt-5.4-mini
+  complexity-auditor:
+    claude: claude-sonnet-4-6
+    opencode: opencode-go/qwen3.6-plus
+    codex: gpt-5.4
+    gemini: gemini-2.5-pro
+    cursor: gpt-5.4
+  security-reviewer:
+    claude: claude-opus-4-7
+    opencode: opencode-go/deepseek-v4-pro
+    codex: gpt-5.5
+    gemini: gemini-2.5-pro
+    cursor: gpt-5.5
+  contract-builder:
+    claude: claude-sonnet-4-6
+    opencode: opencode-go/qwen3.6-plus
+    codex: gpt-5.4
+    gemini: gemini-2.5-pro
+    cursor: gpt-5.4
 tools:
   Read:
     claude: ViewCodeItem / ReadFile

package/src/presets/models/cursor.yml

@@ -8,55 +8,85 @@ agents:
     opencode: opencode-go/deepseek-v4-pro
     codex: gpt-5.5
     gemini: gemini-2.5-pro
-    cursor: gpt-5.5
+    cursor: claude-opus-5-thinking-high
+    grok: cursor-grok-4.5-high-fast
   implementer:
     claude: claude-sonnet-4-6
     opencode: opencode-go/mimo-v2.5-pro
     codex: gpt-5.3-codex
     gemini: gemini-2.5-flash
-    cursor: gpt-5.3
+    cursor: composer-2.5-fast
+    grok: cursor-grok-4.5-high-fast
   tester:
     claude: claude-sonnet-4-6
     opencode: opencode-go/minimax-m2.7
     codex: gpt-5.3-codex
     gemini: gemini-2.5-flash
-    cursor: gpt-5.3
+    cursor: composer-2.5-fast
+    grok: cursor-grok-4.5-high-fast
   orchestrator:
     claude: claude-sonnet-4-6
     opencode: opencode-go/deepseek-v4-pro
     codex: gpt-5.2
     gemini: gemini-2.5-pro
-    cursor: gpt-5.2
+    cursor: composer-2.5
+    grok: cursor-grok-4.5-high-fast
   reviewer:
     claude: claude-sonnet-4-6
     opencode: opencode-go/qwen3.6-plus
     codex: gpt-5.4
     gemini: gemini-2.5-pro
-    cursor: gpt-5.4
+    cursor: claude-sonnet-5-thinking-high
+    grok: cursor-grok-4.5-high-fast
+  complexity-auditor:
+    claude: claude-sonnet-4-6
+    opencode: opencode-go/qwen3.6-plus
+    codex: gpt-5.4
+    gemini: gemini-2.5-pro
+    cursor: claude-sonnet-5-thinking-high
+    grok: cursor-grok-4.5-high-fast
+  security-reviewer:
+    claude: claude-opus-4-7
+    opencode: opencode-go/deepseek-v4-pro
+    codex: gpt-5.5
+    gemini: gemini-2.5-pro
+    cursor: claude-opus-5-thinking-high
+    grok: cursor-grok-4.5-high-fast
   docs:
     claude: claude-haiku-4-5-20251001
     opencode: opencode-go/qwen3.6-plus
     codex: gpt-5.4-mini
     gemini: gemini-2.5-flash
-    cursor: gpt-5.4-mini
+    cursor: claude-4.5-haiku-thinking
+    grok: cursor-grok-4.5-high-fast
   task-coach:
     claude: claude-haiku-4-5-20251001
     opencode: opencode-go/kimi-k2.6
     codex: gpt-5.4-mini
     gemini: gemini-2.5-flash
-    cursor: gpt-5.4-mini
+    cursor: claude-4.5-haiku-thinking
+    grok: cursor-grok-4.5-high-fast
   repo-explorer:
     claude: claude-haiku-4-5-20251001
     opencode: opencode-go/qwen3.6-plus
     codex: gpt-5.4-mini
     gemini: gemini-2.5-flash
-    cursor: gpt-5.4-mini
+    cursor: composer-2.5-fast
+    grok: cursor-grok-4.5-high-fast
   goal-planner:
     claude: claude-haiku-4-5-20251001
     opencode: opencode-go/qwen3.6-plus
     codex: gpt-5.4-mini
     gemini: gemini-2.5-flash
-    cursor: gpt-5.4-mini
+    cursor: claude-4.5-haiku-thinking
+    grok: cursor-grok-4.5-high-fast
+  contract-builder:
+    claude: claude-sonnet-4-6
+    opencode: opencode-go/qwen3.6-plus
+    codex: gpt-5.4
+    gemini: gemini-2.5-pro
+    cursor: claude-sonnet-5-thinking-high
+    grok: cursor-grok-4.5-high-fast
 tools:
   Read:
     claude: ViewCodeItem / ReadFile

package/src/presets/models/gemini.yml

@@ -57,6 +57,24 @@ agents:
     codex: gpt-5.4-mini
     gemini: gemini-2.5-flash
     cursor: gpt-5.4-mini
+  complexity-auditor:
+    claude: claude-sonnet-4-6
+    opencode: opencode-go/qwen3.6-plus
+    codex: gpt-5.4
+    gemini: gemini-2.5-pro
+    cursor: gpt-5.4
+  security-reviewer:
+    claude: claude-opus-4-7
+    opencode: opencode-go/deepseek-v4-pro
+    codex: gpt-5.5
+    gemini: gemini-2.5-pro
+    cursor: gpt-5.5
+  contract-builder:
+    claude: claude-sonnet-4-6
+    opencode: opencode-go/qwen3.6-plus
+    codex: gpt-5.4
+    gemini: gemini-2.5-pro
+    cursor: gpt-5.4
 tools:
   Read:
     claude: ViewCodeItem / ReadFile

package/src/presets/models/opencode.yml

@@ -57,6 +57,24 @@ agents:
     codex: gpt-5.4-mini
     gemini: gemini-2.5-flash
     cursor: gpt-5.4-mini
+  complexity-auditor:
+    claude: claude-sonnet-4-6
+    opencode: opencode-go/qwen3.7-plus
+    codex: gpt-5.4
+    gemini: gemini-2.5-pro
+    cursor: gpt-5.4
+  security-reviewer:
+    claude: claude-opus-4-7
+    opencode: opencode-go/deepseek-v4-pro
+    codex: gpt-5.5
+    gemini: gemini-2.5-pro
+    cursor: gpt-5.5
+  contract-builder:
+    claude: claude-sonnet-4-6
+    opencode: opencode-go/qwen3.7-plus
+    codex: gpt-5.4
+    gemini: gemini-2.5-pro
+    cursor: gpt-5.4
 permissions:
   Read: read
   Write: edit