graphyloop-workflow

GraphyLoop Workflow v2 (condensed)

The full rules live in the installed rules file (AGENTS.md) when your harness loads one. This is the same workflow in one page, for harnesses that do not: Oh My Pi, Gemini CLI, Claude Code and others. The user's explicit instruction and the project's own rules always win.

Tool names: OpenCode graphyloop_<tool>; Claude Code and DeepSeek Harness mcp__graphyloop__<tool>; Codex, Cursor, Oh My Pi, Gemini CLI bare <tool>. Below: bare names. If one is missing, run npx graphyloop doctor.

The 11 rules

1. Recall first, record last. memory_search with 2-4 keywords before planning; use hits, stay silent on a miss, never invent one. At the end memory_store ONE dense line (decision / lesson / pattern / event). Never store credentials. See swarm-memory.
2. Size the work. 3 or fewer known files: do it inline (read, smallest edit, one targeted check, no dispatch, no memory calls). 4+ files or unmapped code is a build: rules 3-9.
3. Context pack. One batched read pass writes ctx-<slug>.md: per lane path:line, the current code excerpt, the pattern to copy. Lanes start editing instead of rediscovering.
4. Freeze the contract. Same turn as dispatch, write contract-<slug>.md (entities and columns, routes with request/response JSON and error codes, props, the test scenarios that define done, env keys). It is the only cross-lane dependency; if wrong, fix the contract, never drift.
5. One wave. All independent lanes in ONE parallel dispatch, one lane per layer (data, backend, frontend, tests, UI), strictly disjoint file sets, max 4 concurrent by default. Data runs alongside backend and frontend.
6. Turn economy. Lanes batch reads, first edit by turn 5, done in about 25 turns; 40+ means mis-sized. End every BUILDER brief with: Read the ctx pack and contract first, in ONE turn. Batch 2+ reads/searches into one parallel call; read with line ranges; never re-read a file; first edit by turn 5; do not run project-wide lint/test/build — the driver does. Wave-0 (writes ctx + contract): Batch 2+ reads/searches into one parallel call; read with line ranges; never re-read a file; write the ctx pack and contract before anything else. Integration/verify/deploy lanes: Read the ctx pack and contract first, in ONE turn. Batch 2+ reads/searches into one parallel call; read with line ranges; never re-read a file.
7. No polling. Servers, builds, deploys and renders run in the background or via the tool's own blocking command (vercel inspect --wait, gh run watch). Never sleep-loop.
8. Verify by running. Smoke the changed path and quote the decisive output line. Tests alone are not proof; check UI in a real browser; check artifacts by viewing the rendered file. Run lint/typecheck/test/build once, centrally, after lanes land.
9. Audit is conditional. Reviewer and security agents only for auth, RBAC, payments, uploads, secrets, data/tenant boundaries, or a diff you cannot read end to end.
10. Artifact wave (posters, decks, PDFs, video): freeze brief-<slug>.md, hero piece first, one lane per artifact.
11. Evidence-first report: Changed / Files / Verified (command plus verbatim output) / Skills / Blocked. Never claim a check that did not run.