docs: comprehensive wiki — 13 pages + sidebar + footer
Concepts (6 pages):
- Home — landing page + TOC + source quicklinks
- Architecture — phase loop, state machine, flat vs modular, inspector,
contracts + wiring, retry semantics, memory + adaptive budgets,
process discipline, atomic state I/O
- Validation Pipeline — every one of the 12 checks (stdlib_conflicts,
imports, static_names, syntax, lint, security, operational,
framework, functional, run, smoke_run, tests) with what each catches,
failure modes, FP guards
- Resilience Stack — SPEC, CRITIC, RUNTIME (http/cli/library dispatch),
surgical mode (stuck-loop + cross-module name resolution),
progressive tiers
- Memory System — Lesson schema, recall scoring formula, three filter
layers (tag filter, source-task decay, content tag inference),
reinforcement/penalization, meta-lessons from improve cycle,
phase-budget history, corpus inspection
- Improve Cycle — closed-loop self-improvement: audit/probe/correlate/
propose/apply, the 8-task matrix, termination conditions, score
function, hard constraints
- Workspace Anatomy — top-level files, .cadillac/ subdir, build.jsonl,
flows.json, modules/, post-scaffold protections, disk usage,
inspection patterns
Reference (3 pages):
- Tool API — every tool the LLM can call (read_file, write_file,
edit_file, line_edit, list_files, search_files, run_command,
add_dep, note_lesson, check_status) with signatures, gating, safety
- CLI Reference — every subcommand (auto, new, iterate, resume,
enhance, debug, improve, dash, list, interactive shell), every
flag, env vars, useful patterns
- Languages — Python / TypeScript / React / Vue / Angular / HTML /
Electron / Go / Rust / WordPress / browser-ext / PyTorch — per-stack
gotchas, multi-language workspaces, adding a new language
Help (3 pages):
- Troubleshooting — common failure modes with concrete fixes
- FAQ — design rationale, comparisons to other coding agents (Devin,
OpenHands, Aider, Cursor agent mode, Copilot Workspace), why
JSONL/no web UI/etc
- Glossary — alphabetical reference for every term
Plus:
- _Sidebar.md — nav rendered alongside every page
- _Footer.md — quick links rendered below every page
Total: 13 content pages, 2527 lines, ~111 KB. Cross-linked extensively
so the wiki is browsable in any direction.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>