Repository navigation
fix(patterns) redraw ten more ASCII diagrams under 78 columns - #434
Conversation
Continues the diagram-width review pass. This batch covers the next tier of offenders, 80 to 81 characters wide, redrawn as narrower vertical layouts. - medallion-architecture.md, 81 to 57 characters - stub.md, 81 to 57 characters - token-binding-and-dpop.md, 81 to 51 characters - profunctor.md, 81 to 52 characters - hierarchical-agents.md, 81 to 51 characters - error-budget.md, 81 to 52 characters - observer.md, 80 to 55 characters - dead-code.md, 80 to 60 characters - large-class.md, 80 to 51 characters - pipeline-architecture.md, 80 to 53 characters No structural, prose, reference, or code content changed, only the diagram fences. Every redrawn diagram preserves every field, every prose annotation, and every before/after framing from the original, only the visual layout narrowed. medallion-architecture.md's bronze, silver, gold layer chain plus the catalog and lineage store cross-link is preserved. large-class.md's before-and-after Extract Class example, all four responsibility clusters and their delegate classes, is preserved. dead-code.md's reachability graph and guard-gated branch sections both stay intact. tools/gen-indexes.py was re-run before this commit, regenerating the family index tables these ten entries span. A stray diff in .ref-cache.json from validate-refs.py's live citation probe was reverted before staging, keeping this diff scoped to content only. check-structure.py 884/884, check-prose.py 925/925, markdownlint-cli2 0 issues, validate-refs.py --strict all citations resolve, check-code.py --strict all code blocks still compile. 27 more entries with the same width issue remain, to be worked through in following batches.
# Conflicts: # patterns/05-architectural/README.md
|
REVIEWED. Multi-pass review. This branch initially showed Pass 1, content-only diff read. Confirmed every changed line sits Pass 2, each of the ten diagrams read start to end against its source Pass 3, gate output read directly. check-structure.py 884 of 884, Approved. |
Summary
the next tier at 80 to 81 characters, down to 51 to 60 characters.
profunctor.md, hierarchical-agents.md, error-budget.md,
observer.md, dead-code.md, large-class.md,
pipeline-architecture.md.
diagram fences.
nine family index tables these entries span.
Notable redesigns
a straight vertical pipeline, with the catalog and lineage store
cross-link (it both feeds Gold and is populated from Silver) stated
in prose rather than drawn as a diagonal arrow.
four responsibility clusters (pricing, fulfillment, notification,
audit) and the four delegate classes the Order class ends up using.
from every entry point, and the guard-gated branch section keeps the
distinction between structurally reachable and practically dead.
Test plan
and committed alongside the content changes
empty, no unexpected top level changes
reverted before staging
27 more entries with the same width issue remain, to be worked through
in following batches.