go/docs
Snider ecd27e3cc9 feat(rfc): Pass Three — 8 spec contradictions found
P3-1: Startable/Stoppable return error, not Result — change to Result
P3-2: Process returns (string,error), Action returns Result — unify on Result
P3-3: Three getter patterns (Result, typed, tuple) — document the two real ones
P3-4: Dual-purpose methods anti-AX — keep as sugar, Registry has explicit verbs
P3-5: error leaks despite Result — accept at Go stdlib boundary, Result at Core
P3-6: Data has overlapping APIs — split mount management from file access
P3-7: Action has no error propagation — inherit PerformAsync's panic recovery
P3-8: Registry.Lock() one-way door — add Seal() for hot-reload (update yes, new no)

RFC now at 2,194 lines. Three passes complete:
- Pass 1: 16 known issues (all resolved)
- Pass 2: 8 architectural findings
- Pass 3: 8 spec contradictions

Co-Authored-By: Virgil <virgil@lethean.io>
2026-03-25 12:39:27 +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): Pass Three — 8 spec contradictions found 2026-03-25 12:39:27 +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