diamond-render
Render `.claude/diamonds/active.yml` as a state diagram. Read-only. Default format Mermaid stateDiagram-v2. Recommended at the end of `/mycelium:diamond-assess` so every assessment closes with a visual state-of-play. See `${CLAUDE_PLUGIN_ROOT}/engine/render-conventions.md` for shared render fleet conventions.
haabe · Static checks on file
Installation
Read the source and dependencies before running a command. Copying does not install or execute anything.
npx skills add haabe/mycelium --skill diamond-renderAbout this skill
name: diamond-render
description: Render .claude/diamonds/active.yml as a state diagram. Read-only. Default format Mermaid stateDiagram-v2. Recommended at the end of /mycelium:diamond-assess so every assessment closes with a visual state-of-play. See ${CLAUDE_PLUGIN_ROOT}/engine/render-conventions.md for shared render fleet conventions.
metadata:
instruction_budget: "45"
framework_dependency: "mycelium"
framework_dependency_note: "Reads .claude/diamonds/active.yml and ${CLAUDE_PLUGIN_ROOT}/engine/diamond-rules.md. Standalone use will fail without active.yml present."
identifier_exposure: "NONE"
Diamond Render
Read-only render of .claude/diamonds/active.yml as a state diagram. First specialist of the render fleet. Other specialists (/mycelium:ost-render, /mycelium:cycle-render) and the dispatcher (/mycelium:render) ship in subsequent patches.
When NOT to use
- To advance a diamond (Discover → Define etc.) →
/mycelium:diamond-progress. - To score gates against current evidence →
/mycelium:diamond-assess. - To start a new diamond →
/mycelium:start.
Identifier exposure
Declared: NONE
Scope (canvas surfaces touched)
| Canvas file | Identifier-bearing fields | Frequency |
|---|---|---|
.claude/diamonds/active.yml | none in current schema (v1) | n/a |
${CLAUDE_PLUGIN_ROOT}/engine/diamond-rules.md | none (canonical phase list) | n/a |
Rationale
diamonds/active.yml is phase-state shape: scale (L0–L5), phase (Discover/Define/Develop/Deliver), confidence value, gate-history timestamps. No contributor names, no participant fields, no identifier-bearing prose. Zero identifier exposure as of v0.40.0.
Future-schema-change caveat: if a future schema adds an identifier field (e.g., per-team diamond ownership for multi-team Mycelium per the deferred Team Topologies adoption), this declaration becomes false. The skill must then be re-declared YES or MIXED, consult the registry per engine/render-conventions.md#hard-rule-consent--privacy-gate, and ship redaction fixtures. The schema-versioning rule surfaces the schema_version mismatch at runtime as a forcing function for the re-audit.
Anon-label convention
Not applicable (NONE).
Worked example
Render of diamonds/active.yml with no identifier content present:
L0 Purpose: [Discover]→[Define]→[Develop*]→[Deliver]
conf=0.612
No identifiers anywhere in the output, regardless of audience.
Fixture pointer
Not applicable. Check 43 forbids redaction fixtures on NONE-declared specialists (avoids the "declares NONE but acts YES" drift). Other fixtures (see § Test fixtures below) exercise actual behavior.
Preflight: Read source
- Read
.claude/diamonds/active.ymlwith the Read tool. Full read (state diagram needs the full structure;limit:1not appropriate here). - Read
${CLAUDE_PLUGIN_ROOT}/engine/diamond-rules.mdto get the canonical phase list per scale + the four canonical phase-transition gate names. - If
--as-of <date>was specified, also read.claude/harness/decision-log.mdto walk backward to that date. - Note the source's canvas-state timestamp per
engine/render-conventions.md#canvas-state-timestamp-resolution:_meta.last_validatedif present, else top-levellast_updated:.
Arguments
| Arg | Default | Values | Effect |
|---|---|---|---|
--format | mermaid | mermaid | ascii | json | Output format. markdown-table and markdown-list are NOT supported (state diagrams don't map cleanly); fail loud per engine/render-conventions.md#format-support-negotiation-global-rule. |
--scale | active | L0 | L1 | L2 | L3 | L4 | L5 | active | all | Which diamond(s) to render. active = all diamonds with non-null phase. |
--theme | base | base | dark | Theme. dark is the WCAG-by-construction opt-in per engine/render-conventions.md#wcag-aa-theme-convention. |
--show-gates | true | bool | Annotate transitions with phase-transition gate names + theory-gate status block. |
--show-confidence | true | bool | Annotate phases with confidence values. |
--show-history | false | bool | Include gate_history entries as transition timestamps. |
--as-of | null | ISO date | Render diamond state as-of this date (walk decision-log backward). Fail loud if date precedes the first decision-log entry mentioning the diamond. |
Workflow
Step 1: Resolve scale
--scale active→ enumerate diamonds with non-nullphase. If empty, emitNo active diamond — run /mycelium:startplaceholder + canonical disclaimer + early return.--scale L<N>→ render only that scale; fail loud if scale not present.--scale all→ render every diamond regardless of phase.
Step 2: Build per-diamond state
For each diamond to render:
- States = the four canonical phases (Discover, Define, Develop, Deliver). Canonicalize on emit: if canvas uses lowercase, render as canonical case. Surface lowercase-canvas as a
canvas-healthfollow-up note. - Current state =
phasefrom active.yml (case-insensitive match). - Completed states = phases before current per linear order.
- Future states = phases after current.
- Transition labels (phase-transition gates) if
--show-gates=true:- Discover → Define :
evidence - Define → Develop :
trio-coverage - Develop → Deliver :
DoD - Deliver → [*] :
launch
- Discover → Define :
- Theory gate status annotation if
--show-gates=trueANDtheory_gates_statusfield present: emitnote right of <ID>block summarizing pass/fail/pass-with-risk per gate (evidence/cynefin/bias/bvssh/corrections/four_risks/jtbd). - Phase annotation =
confidencefield from active.yml (NOTconfidence_threshold) if--show-confidence=true. Display asconf=<value>.
Step 2a: Spawn-relationship arrows (multi-diamond renders)
When rendering multiple diamonds and a child's parent_id is set:
- Emit between-state arrow a