Decisions

Architecture decisions

Every load-bearing call in crickets is recorded as an Architecture Decision Record (ADR): the context, the decision with explicit "why X, and why not Y" reasoning, and the consequences with re-audit triggers so a stale assumption surfaces later instead of rotting silently.

This page is the index. The homepage links here once instead of listing every ADR.

Records

• ADR 0001 — crickets purpose, scope, public-with-PII-guardrails
• ADR 0002 — evaluator sub-agent design
• ADR 0003 — base operator-control hooks
• ADR 0004 — design skill: human-facing design pipeline → agent execution handoff
• ADR 0006 — Gemini CLI host removal
• ADR 0007 — MemoryVault Discovery + Mining
• ADR 0008 — diataxis-author skill
• ADR 0009 — evidence-tracker hook
• ADR 0011 — Antigravity 2.0 host support
• ADR 0012 — device-wide-by-default
• ADR 0013 — bundles are native host plugins
• ADR 0014 — #40 install-decoupling
• ADR 0015 — #36 partial-revision
• ADR 0016 — Project surface split
• ADR 0017 — Soft composition (enhances:) + the developer split + capability probe
• ADR 0018 — Per-folder sidebars: intent-grouped wiki folders with collapse/expand nav
• ADR 0019 — Wiki provisioning: gate-distribution split + supersession-gated retirement
• ADR 0020 — Seven-section wiki taxonomy: fixed frame + per-project Architecture manifest + conditional gates
• ADR 0021 — Per-plugin marketplace versioning sourced from group.yaml
• ADR 0022 — Retire worktrees-never-auto: worktrees first-class but operator-initiated

Retrospectives

• V3 Retrospective — what shipped across the V3 arc, what we learned, what's next.

Recent changes

• 2026-06-13 — ADR 0022 (retire worktrees-never-auto) added; records retiring the blanket "never create worktrees" prohibition for "worktrees first-class but operator-initiated" once /spawn-worker made worker worktrees a real workflow, keeping the no-autonomous-spawn guarantee.
• 2026-06-11 — ADR 0021 (per-plugin versioning) added; records sourcing each plugin's marketplace version from group.yaml so claude plugin update works, plus the anti-recurrence bump guard.
• 2026-06-11 — ADR 0020 (seven-section wiki taxonomy) added; records the fixed frame, the per-project Architecture manifest, and the two conditional-section gates.
• 2026-06-10 — ADR 0019 (wiki provisioning) added; records the gate-distribution split + supersession-gated retirement.
• 2026-06-08 — ADR 0018 (per-folder sidebars) added; the ADRs moved into decisions/.

See also

• Home — the wiki landing page.
• Purpose and scope — the founding rationale ADR 0001 records.