Skip to content

v0.3.0

Choose a tag to compare

@ChesterRa ChesterRa released this 23 Sep 02:57
· 707 commits to main since this release

Release notes — CCCC Pair 0.3.0

Headline

  • A user‑facing, low‑noise multi‑peer orchestrator with repo‑native anchors. Two equal peers (defaults: Claude Code + Codex CLI) collaborate by evidence, and an optional Aux (Gemini CLI) handles on‑demand reviews or heavy lifting. Strategic and
    execution context now live where they belong: in your repo.

What’s new

  • Repo‑native anchors (POR/SUBPOR)
    • POR (docs/por/POR.md): strategic board with North‑star, Deliverables, Roadmap (Now/Next/Later), Risk Radar, Decision & Pivot Log, and a short Maintenance log.
    • SUBPOR (docs/por/T######-slug/SUBPOR.md): per‑task sheet with Goal/Scope, 3–5 Acceptance checks, Cheapest Probe, Kill Criteria, Implementation notes, REV, and a single Next step.
    • Lightweight generator: .cccc/por_subpor.py to create POR if missing and spawn new SUBPORs on demand (no deps; ASCII; idempotent).
  • Rules and prompts (clear, concise, equal peers)
    • Require peer ACK before creating a new SUBPOR.
    • SUBPOR creation is owned only by PeerB (after creation both peers can update/maintain).
    • PROJECT.md is user‑maintained; peers read to align but do not edit unless explicitly asked.
    • Message skeleton remains simple: <TO_USER>/<TO_PEER> with one fenced insight (who/kind/next/refs).
  • Low‑noise cadence and visibility
    • Status panel always shows POR path/updated and: “Next: self‑check | auto‑compact (policy)”.
    • Nudge polish: resend at most once; 5‑minute quiet window; small jitter; progress resets retries.
  • Optional third peer (Aux, Gemini CLI)
    • Strategic notes belong in POR, tactical offloads belong in each task’s SUBPOR.
    • Rationale: Gemini excels at short, non‑interactive jobs (reviews/tests/bulk transforms); perfect as on‑demand Aux. You can swap models at any time.
  • README — user‑focused rewrite
    • Pain → payoff, When to use, How it works (60s), Quick Start, Repo layout, FAQ.
    • Clear story for Claude/Codex defaults and Gemini as Aux; vendor‑agnostic by design.

Quality and polish

  • ASCII‑only in templates and prompts; timezone‑aware timestamps in generators.
  • Moved legacy/draft docs under docs/_drafts/ to prevent confusion.
  • Prompt rules regenerated automatically (rules hash bump) to keep runtime docs consistent.

Why it matters

  • No more “big docs somewhere else” or “context scattered in chat.” Strategy (POR) and execution (SUBPOR) are plain files in your repo. Two peers drive by evidence, stay aligned on the board, and keep the noise down. Aux joins only when you need a
    burst of focused work.

Upgrade notes

  • Run cccc run — POR is now ensured under docs/por/.
  • Use .cccc/por_subpor.py subpor new … to create one SUBPOR per task (PeerB after peer ACK).
  • If you had older drafts under docs/, they’re now in docs/_drafts/ (non‑authoritative).

Looking ahead

  • Optional IM digests once anchors stabilize across teams.
  • Gentle “duplicate‑title” guard for SUBPOR creation if teams still hit accidental duplicates.
  • More examples and screenshots for first‑time users.