# Moirai Graph Design

> Design or review portable graph.yaml topology, phase boundaries, reusable subgraphs, and iteration semantics.

- Skill: `sevenx77/moirai-graph-design` (Agent Skill)
- Install (CLI): `npx skillmds@latest add sevenx77/moirai-graph-design`
- Raw SKILL.md: https://api.skillmd.com/api/skills/sevenx77/moirai-graph-design/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: SevenX77 (https://skillmd.com/u/sevenx77)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/sevenx77/moirai-graph-design

---


# MoirAI graph design

Use this skill after the domain inputs, outputs, and invariants are explicit.

1. Define the root graph boundary and choose stable, bundle-unique graph ids.
2. Split work by responsibility: deterministic action chains use `LOGIC.md`, executor judgment uses `AGENT.md`, and reusable graph calls use `SUBGRAPH.md`.
3. Declare every phase and dependency in `graph.yaml`; treat explicit call edges as topology truth.
   Keep phase identity in two places only: the `phases/<phase_id>/` directory name and its `graph.yaml.phases[].id`. Do not restate the id inside the phase document.
4. Trace required phase inputs to root inputs, upstream outputs, bindings, or iterator injection.
5. Place reusable graphs directly under `graphs/<graph_id>/`; never encode parentage through nested folders.
6. Add batch or loop iteration only with explicit item, range, concurrency or accumulation semantics.
7. Compile the complete bundle and address the full diagnostic set before execution.

Build incrementally rather than all at once: compile the skeleton root graph before adding phases, then add phases and their type files one at a time, compiling at each step. A complete skill written before its first compile hands you every defect simultaneously and tells you nothing about which change caused which.

Do not combine parsing, judgment, and generation into one phase; do not assign an Agent to work that deterministic code can do; and do not accumulate unused fields in a schema for a future possibility that has not been requested.

Use [skill anatomy](references/KB-01-skill-anatomy.md), [I/O dataflow](references/KB-02-io-dataflow.md), [logic actions](references/KB-03-logic-actions.md), [Agent nodes](references/KB-04-agent-nodes.md), [subgraphs](references/KB-05-subgraph.md), and [iteration](references/KB-06-iterate.md) as needed; [working discipline](references/KB-15-working-discipline.md) governs evidence and reporting.

Return the graph inventory, phase table, edges, field-level dataflow, subgraph and iterate decisions, and unresolved constraints. Do not add a `graph.yaml` to MoirAI integration assets; topology belongs only to the user's business gSkill.