[renderer] Design log: render-shape survey + decisions#346
Closed
leeovery wants to merge 5 commits into
Closed
Conversation
Add the full survey of structured-ASCII shapes across the skills (signposts/gates, menus, lists-vs-trees, vocab/legends) — distinct variants, observed drift, candidate canonical forms, open questions — into idea #32. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Update the survey for the epic-dashboard restructure: motivating wrap bug still live (gutter 7->9, overflow now 74 cols), first-row ┌─ dropped for the discovery map, build-phase render promoted to a genuine tree (3B-v) with formal child gutter, and the new stage-divider composition layer (Family 1 signposts wrapping Family 3 trees). Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Record the agreed model: one render library+CLI in-repo under skills/; caller-owns-data (Claude for trivial shapes, discovery.cjs in-process for trees); one run / one source / two outputs (display + reasoning); two surfaces from one structured object; tree is write-only-to-user; first slice = core+signpost, then a discovery-map spike as go/no-go. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
leeovery
force-pushed
the
docs/renderer-survey
branch
from
6747d04 to
f6b8188
Compare
leeovery
changed the title
Record the build log: core+signpost shipped; tree spike came out GO (renderTree kept). Note the inherent header-row overflow finding and the deferred tree-width decision. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Capture the agreed architecture as a hand-off draft: generic engine + schema-in-skill (mirrors the manifest CLI), the layer model (data → projections → presentation), the grounded invocation mechanics (parameterless ! insert vs scoped manual bash), an epic strawman against the live buildEpicDetail shape, the two flavours (declarative vs toolkit), and the open decisions to resolve before building. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Owner
Author
|
Consolidated into #380 (single branch off current main, same content, additive-only). Closing to keep one clean hand-off PR. |
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
1 participant
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.
Summary
Long-lived design log for the deterministic renderer (idea #32). Holds the idea, the full render-shape survey, and the locked design decisions in
ideas/deterministic-tree-and-menu-renderer.md. Stays open and is appended to as the feature progresses; merges last.Code ships in separate stacked PRs (PR1: core + signpost slice).
Test plan
Docs only — no code in this PR.