Designs

Designs

The architecture behind crickets and Agent M — the high-level design docs that explain how each system works, in depth. Each design's sub-parts live in this section's sidebar.

What's here

Crickets

• Crickets — High Level Design — the live parent design: the thirteen-capability toolbox, build-once-generate-everywhere, and composition onto agentm. Reconciles the two designs below. All children content-final (AG Phase 3, 2026-06-24).
  • Build system — single source → per-host generated, drift gate, host-subset coverage.
  • Composition — capability↔capability and capability↔opinion, the full relationship map, the one-way arrow onto agentm, role-retirement.
  • Model + effort routing — T0…T4 tier scale; persona→tier map; tier: manifest axis. (agentm-parented; enforcement surface is crickets agent-defs.)
  • development-lifecycle — the spine: setup / plan / work / review / release / bugfix + launch / deprecate / retire.
  • code-review — adversarial review, cross-model variant, /code-review.
  • design — design authoring: abbreviated / full / architecture rungs.
  • developer-safety — the recoverability gate: skill + hook + carve-out tests.
  • wiki — docs upkeep: diataxis-author + documenter + wiki-watcher.
  • github-projects — board-sync: vault → board ≥4 deep, per-commit comment trail; driven by the Planner (TPM).
  • maintenance — keep the codebase healthy: dependency repair, CVE, tech-debt, tentative content-refresh.
  • conventions — 8-domain base-standards shell (testing · releasing · ci · code-quality · agentic-engineering · reliability · coding · documentation).
  • obsidian-vault — the storage backend.
  • token-audit — token metering; absorbs status-line-meter.
  • privacy — PII + extensible data-protection layer.
  • research — deep research.
  • diagnostics — observability / troubleshooting.
• Crickets v3.0 — Native Host Plugins — the src/ → generate → dist/ model.
• Wiki Maintenance — the diataxis-author + documenter + wiki-watcher system.
• diataxis-author — the authoring + style-learning skill.
• Continuous Integration — the gate battery · the 3-OS matrix · the PII layers.
• Wiki — the intent-grouped IA · per-folder sidebars · linting + publish.
• Wiki-Maintenance Provisioning — provision a target repo end-to-end (init · template-ship · gate distribution · standalone retirement).
• Wiki Section Taxonomy — the 7-section frame · per-project Architecture manifest · conditional sections · the two dogfood restructures.
• Wiki Composer — the manifest → page transform: load each section · strip its opinion comment · resolve voice + language · concatenate.

Architecture (Agent M)

• MemoryVault — permanent agent memory.
• Agent Memory Evolution V1→V7 · Device-Wide Architecture · Memory-OS (V5).

Recent changes

• 2026-06-24 — AG Phase 3: 15 crickets child designs lifted (all content-final); crickets-hld.md re-synced (thirteen capabilities, rename ledger, 3 amendment entries).
• 2026-06-08 — moved to designs/; this index added.
• 2026-06-09 — Continuous Integration + Wiki designs added; the four earlier designs updated to shipped reality; Wiki Maintenance is now launched.

See also

Reference · Decisions · Explanation · Home