go/docs
Snider 93c21cfd53 feat(rfc): Synthesis — 108 findings reduce to 5 root causes
With full session context (tests + refactoring + 13 passes + revisit),
the 108 findings cluster into 5 root causes:

1. Type erasure via Result{any} (16 findings)
   → mitigation: typed methods + AX-7 tests, not fixable without abandoning Result

2. No internal boundaries (14 findings)
   → by design for v0.8.0 (trusted conclave), CoreView for v0.9.0

3. Synchronous everything (12 findings)
   → Action/Task system is the fix, PERFORM replaces ACTION for request/response

4. No recovery path (10 findings)
   → one fix: defer ServiceShutdown + return error from Run() + panic recovery

5. Missing primitives (8 findings)
   → ID, Validate, Health needed. JSON/Time are judgment calls.

60 findings clustered, 48 remaining (specific/local).
Priority: recovery > sync > primitives > types > boundaries.

This is the definitive analysis. 3,800+ lines.

Co-Authored-By: Virgil <virgil@lethean.io>
2026-03-25 13:21:11 +00:00
..
pkg docs: rewrite documentation suite against AX spec 2026-03-21 10:05:04 +00:00
plans docs: remove implemented plans, annotate partial ones 2026-03-14 08:09:20 +00:00
commands.md docs: rewrite documentation suite against AX spec 2026-03-21 10:05:04 +00:00
configuration.md docs: rewrite documentation suite against AX spec 2026-03-21 10:05:04 +00:00
errors.md docs: rewrite documentation suite against AX spec 2026-03-21 10:05:04 +00:00
getting-started.md docs: rewrite documentation suite against AX spec 2026-03-21 10:05:04 +00:00
index.md docs: rewrite documentation suite against AX spec 2026-03-21 10:05:04 +00:00
lifecycle.md docs: rewrite documentation suite against AX spec 2026-03-21 10:05:04 +00:00
messaging.md docs: rewrite documentation suite against AX spec 2026-03-21 10:05:04 +00:00
primitives.md docs: rewrite documentation suite against AX spec 2026-03-21 10:05:04 +00:00
RFC.md feat(rfc): Synthesis — 108 findings reduce to 5 root causes 2026-03-25 13:21:11 +00:00
services.md docs: rewrite documentation suite against AX spec 2026-03-21 10:05:04 +00:00
subsystems.md docs: rewrite documentation suite against AX spec 2026-03-21 10:05:04 +00:00
testing.md docs: rewrite documentation suite against AX spec 2026-03-21 10:05:04 +00:00