User clarified the architectural intent: the data structure is
the source of truth. The textual surface is one projection
among potentially many — visual / graphical front-ends are an
explicitly anticipated future lane.
The previous draft of Decision 6 said "JSON-AST demoted to
storage and exchange only", which was the wrong framing. The
JSON-AST stays canonical; form (A) is the AI authoring
projection but does not displace the AST.
Changes:
- New "Architectural pin: data structure is the source of truth"
subsection.
- Implementation outline reworded: parser is "strictly additive",
no schema changes, .ail.json remains a first-class input to
every existing subcommand.
- New "What this Decision deliberately does not do" subsection
to lock in the architectural commitments.
No code change. Pure documentation correction to the 14b
design pass before 14c starts.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Brummel
5e8342df02