Skip to content

v0.1.1 — Comprehensive ARCHITECTURE.md (state-of-the-art design doc)

Choose a tag to compare

@ulissesflores ulissesflores released this 17 May 05:00
· 20 commits to main since this release

v0.1.1 — Documentation patch

Adds docs/ARCHITECTURE.md, a 10-part state-of-the-art design document covering the full journey from v1 to v5:

  • Academic foundations (Klein, MAST, Plan-and-Act, Reflexion, Plan-Validate-Execute, /goal)
  • Community/industry state and the gap ASP fills
  • v1 -> v5 architectural pivots with each pivot's trigger and discovery
  • Empirical discoveries (2026-05-17 battery, including the Critical Finding C: `claude -p` returns exit 0 even on graceful refusal — Iron Law 11 derivation)
  • User contributions (especially the lateral move proposing `claude -p` as subprocess to invoke `/goal`)
  • Advisor reviews (3 calls, 1 pre-ship functional bug caught in Iron Law 9 enforcement)
  • Derivation of all 12 Iron Laws mapped to specific papers / findings / incidents
  • What is genuinely novel in ASP
  • Open questions and future work
  • Full references (academic + Anthropic + community + internal probe files)

Links added to all 5 READMEs (EN/ES/PT/IT/HE).

No code changes. Pure documentation patch.