Repository navigation
feat(diagrams): verified story diagrams as the default architecture/flow graphics (ADR-0014) - #29
Merged
Merged
Conversation
… walkthrough replace the vanilla architecture/flow slots (ADR-0014)
✅ Deploy Preview for explainmyrepo canceled.
|
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
Makes the owner-approved "story" graphics the default for the architecture and flow slots (ADR-0014), instead of the dependency-graph layout and the five-box vertical list.
visuals.systemMap→ architecture slot: inputs → engine → surfaces (with real commands) + a WORKS WITH strip + RUNS ON.visuals.decision→ flow slot: candidates as gauges against a threshold, one skipped, one picked, animated handoff.The rule that makes it safe
The brain does not get to assert any of it.
make-diagramsverifies every claim against the cloned repo:quotemust be in the namedfileterms; kept only on zero matchesrule.quotemust be inrule.fileUnverifiable claims are dropped; if nothing survives, the slot keeps today's graph diagram (ADR-0011 — never fail a build for this).
Evidence
tests/story-diagrams.test.mjs), including guards proven by mutation.quote not found in README.md).tests/fixtures/story-claude-swap.mjs.Known gaps (stated in the ADR)
tools/→src/import; the INV-23 mutation test now mirrors the real layout.