Skip to content

MIP-0068 tasks

Ordered delivery of MIP-0068 as stacked PRs (.claude/skills/mip-tasks/SKILL.md, scripts/stack.sh). Branch mip-0068/<k>-<slug>, each based on the previous; merge bottom-up, scripts/stack.sh restack after each squash-merge.

# slug delivers tests (must exist before the PR) depends on
1 build-hardening §5.2: mkdocs/mkdocs.yml's kroki block gains fail_fast: true, enable_bpmn: false, enable_diagramsnet: false and one slate styles block; theme.palette keeps slate only, no toggle; marola.css drops its default-scheme block and gives non-injectable dialects a light card. §5.1's rule as a "Diagrams" section in .claude/rules/docs.md, docs/3-Working-on-the-repo/DIAGRAMS.md with one example each of mermaid, d2, c4plantuml, dbml and vegalite (linked from docs/index.md), and §5.4's line in the mip skill template. This task file, and the MIP flipped to Accepted with its Tasks: pointer scripts/mkdocs.sh --self-test asserts the three new keys and fails when one is removed. §7 step 1: a broken mermaid fence fails just docs naming the page, a ```bpmn fence renders as a code block (both outputs in the PR). just docs green with DIAGRAMS.md. §7 step 4: slate screenshots of CI-CD.md, ARCHITECTURE.md, MIPs/README.md and DIAGRAMS.md, every arrow and label readable –
2 ascii-to-rendered §5.3 "ASCII to rendered": MIPs/MIP-0060.tasks.md:16-22 (flowchart, wave subgraphs), 4-Research-and-plans/AGENT-STACK-SURVEY.md:117-130 (d2), 3-Working-on-the-repo/AGENT-SKILLS.md:59-89 (flowchart, one subgraph per session), 4-Research-and-plans/AGENT-FRAMEWORKS-SURVEY.md:67-76 (flowchart with the message arrows) just docs green; slate screenshots of the four pages; each diagram's nodes and edges listed against the ASCII it replaces in the PR 1
3 architecture §5.3 "ARCHITECTURE.md": module map (d2, beside the tree at :51-104), the six integrations (classDiagram, :248-264), origin resolution (flowchart, :139-155, fixing the doubled "4."), DSPy summarize → review (:274-306) and the MCP handshake (:358) as sequenceDiagrams, water-quality verdicts (:436-455) and RAG strict vs general (:463-478) as flowcharts. The §3 diagram at :221 stays just docs green; slate screenshot of the page; the water-quality and RAG diagrams checked branch by branch against core/ (§6), with the source lines cited in the PR 1
4 process-docs §5.3 "Process docs": DEV-FLOW.md opening loop (flowchart), MIP lifecycle (stateDiagram-v2), stacking and restack (gitGraph); ISSUE-FLOW.md object model (erDiagram), readiness and board Status (stateDiagram-v2, transitions labelled with the just command); ROADMAP.md ordering with the MIP-0002 gate (flowchart) just docs green; slate screenshots of the three pages; every state and transition in the lifecycle diagrams maps to a sentence or command already in the page, listed in the PR 1
5 mip-flows §5.3 "MIPs", non-sequence part: MIP-0056 pipeline (flowchart) and point/sample schema (dbml); MIP-0063 §5.2 board Status and §5.5 direction of truth; MIP-0065 §3 before/after; MIP-0025 §5 train-and-export pipeline; MIP-0039 §5.2 mode × severity; MIP-0036 §5.1 launch schedule (gantt); task DAGs in MIP-0056, 0063, 0065 and 0025.tasks.md just docs green; slate screenshot per page; each task DAG's edges equal its depends on column, checked in the PR 1
6 mip-sequences §5.3 "MIPs", sequence part: MIP-0060 §5.2 (the tokenless step boxed), MIP-0042 §5.3 (live-fetch failure as an alt), MIP-0006 §5.2, MIP-0015 §5, MIP-0020 §5.5, MIP-0035 §5, MIP-0008 §5.5 just docs green; slate screenshot per page; each MIP whose diagram disagrees with its text is listed in the PR for its author, not silently fixed (§5.3) 1
7 excalidraw §5.2's kroki-excalidraw:0.32.1 companion in mkdocs/docker-compose.yml with KROKI_EXCALIDRAW_HOST, health-checked like mermaid; scenes under docs/assets/diagrams/*.excalidraw via @from_file: for the MIP-0016 coastline geometry and the MIP-0042/0054 mocks; an excalidraw example in DIAGRAMS.md. Dropped whole if review finds no sketch better than the ASCII it replaces (§5.3) docker compose -f mkdocs/docker-compose.yml config --quiet; just docs green with the scenes; each rendered sketch attached to the PR next to the ASCII it replaces; CI's docs job time before and after noted 1

Decisions

  1. Tasks 2–7 need only task 1. Stacked 1 → … → 7 for review order, but depends on is the real graph: any of them can merge right after task 1. The one shared file is MIP-0042, which task 6 edits in §5.3 and task 7 in §3; a restack there is a trivial rebase.
  2. Task 1 carries the dark-only switch. The five existing diagrams must be re-rendered and legible before anything is added on top of them.
  3. Task 7 is last and optional. It is the only task that adds a container, and the MIP makes it conditional on the sketches earning their place.