Skip to content

raphaelmans/design

unversioned · a0745e262a8c
layered-design-diagrams-router

Entry point for diagramming a feature or PRD module in layers: state machine → design-pattern flowchart → inside-a-module sequences. Reads the request, picks which level(s) to produce, and loads only those level skills. Use for 'full-blown diagrams', 'just the flowchart', 'show me the sequence for X', 'state machine for Y'. Not for ERDs, UI mockups or slide decks.

layered-diagrams-1-lifecycle-state-machine

Level 1 of the layered design diagrams: a state machine showing every state the feature's main thing goes through. Load only via the Layered design diagrams router, or when asked for just the lifecycle or state machine of a feature.

layered-diagrams-2-design-pattern-flowchart

Level 2 of the layered design diagrams: a flowchart that shows how the feature is shaped by design patterns (hexagonal layers, ports, adapters, strategies, runtime choices). Load only via the Layered design diagrams router, or when asked for just the architecture or patterns flowchart.

layered-diagrams-3-inside-a-module-sequence

Level 3 of the layered design diagrams: one sequence diagram per module showing how its subcomponents work together in a concrete scenario. Load only via the Layered design diagrams router, or when asked to learn how a specific module or component works inside.

pick-the-right-document-router

Entry point for any 'write up / document / spec / render a doc' request. Reads the ask, picks the matching Playbooks template, decides where it lives, and calls the layered diagram skill only for the levels that doc needs. Use instead of invoking layered diagrams directly when the output is a document. Not for a pure diagram request, quick chat answers, or Second Brain core notes.

write-a-design-doc-page-with-diagrams

Turn a worked-out design (architecture, system, integration) into one Notion page with Mermaid diagrams in a single pass, filed in Blueprints as Draft. Not for project status, meeting notes or learning notes.