Conversation
Two separate things. (A) A fifth prep question, diagrams: mermaid | ascii | none, sets the notation Pass 2 uses when a section is shaped enough to earn a picture; the rule is draw when the picture is shorter than the paragraph it replaces, and the prose stays the decision. (B) The Pass 3 DAG is always drawn in one rigid Mermaid form — flowchart TD, one subgraph per phase, one edge per blocked-by, four verbatim classDef status classes — and re-rendered in the same commit as every ticket state change, in both notes.md and TODO.md. The ticket one-liners remain the source of truth; the diagram is derived. dstack-ticket, dstack-yolo, and dstack-retro name the re-render at each status flip. The reference project's ASCII DAGs are converted to the conventional shape. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01NLMK6F3vQ1HzyU1Mxqt6Kr
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01NLMK6F3vQ1HzyU1Mxqt6Kr
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
Roadmap item 2 (
meta/roadmap-0.4.md). Based on #6; GitHub retargets tomasteronce #6 merges.Two separate things, kept separate everywhere they're written:
(A) Diagrams as a tool. New prep question 5,
diagrams: mermaid | ascii | none(unset →mermaid). Pass 2 offers a picture where a section is shaped enough to earn one — a when-to-draw table in the spec (erDiagramfor ≥3 related tables,sequenceDiagramfor multi-hop paths,flowchart LRfor component maps,stateDiagram-v2for lifecycles). Rule: draw when the picture is shorter than the paragraph. Prose is the decision; the picture is a rendering.(B) The DAG, always, in one shape. Regardless of (A), the Pass 3 DAG is always Mermaid in a fixed form:
flowchart TD, one subgraph per phase, node id = ticket id, one edge perblocked-by, four verbatimclassDefs (open/inprogress/done/blocked) where node class = checkbox state. Re-rendered in bothnotes.mdandTODO.mdin the same commit as every status change —dstack-ticket(confirm →[~]),dstack-yolo([~],[x],[!], DAG growth) anddstack-retro(a mismatch is a process observation) all name it. Ticket one-liners stay the source of truth.Reference project: both ASCII DAGs converted;
diagrams: mermaidin front matter; a Grounding bullet explains why Pass 2 drew nothing (two-table schema — shorter as prose).Verification
TODO.mdand theSKILL.mdsample) with@mermaid-js/mermaid-cli— both parse; the four status classes show as intended../install.shinto a scratch repo; grepdiagrams:/classDefacross spec, skill, commands, example, README.🤖 Generated with Claude Code
https://claude.ai/code/session_01NLMK6F3vQ1HzyU1Mxqt6Kr