visible

Shape  (think + verify)  →  Forge  (build + self-correct)  →  Review  (accept + clean)
         BLUEPRINT v1.0  →  BLUEPRINT v1.x                  →  verdict: Pass / Conditional / Fail

Chapters

#	Skill	Job	Reaches for it when
1	shape	Turns vague ideas into an executable, versioned Blueprint. Never writes implementation code.	"help me plan", "design this", "choose a stack", before any build
2	forge	Executes a confirmed Blueprint task by task: implement → check → decide → align.	"implement this", "execute the plan", Blueprint v1.0 confirmed
3	review	Audits work against the Blueprint, cleans up, distills reusable lessons on signal only.	"review this", "check my work", before merge or delivery

Rules shared across chapters: one task, one in_progress; every task carries a stable ID (S1-T1) with an acceptance line; deviations are graded L1 (auto) / L2 (log + continue) / L3 (freeze + ask); rework never rewrites history.

Visibility is emergent: no status reports — the trail (IDs, versions, verdicts) is the status. Run forge/scripts/trail.sh against any Blueprint to see it on one screen.

Layout

visible/
├── README.md
├── shape/   SKILL.md + references/ + blueprint templates
├── forge/   SKILL.md + references/ + scripts/check-ids.sh
└── review/  SKILL.md + references/

Each SKILL.md is the router; details live one level deep in references/ and load only when needed. scripts/ holds deterministic gates — execute them, never reason through by hand what a script already decides.

Install

Copy any chapter into your agent's skills directory (together with its references/ and scripts/):

• Claude Code: ~/.claude/skills/ (personal) or .claude/skills/ (project)
• Cursor: ~/.cursor/skills/ or .cursor/skills/
• OpenCode / others: per-tool skills directory

Trust

Scripts are auditable and dependency-free: check-ids.sh and trail.sh only read the Blueprint file you pass in (grep/sed/printf, no network, no writes, no secrets). Review any skill before installing, as with all community skills.

Compatibility

Bash 4+ with POSIX grep/sed; verified on macOS and Linux. On Windows, run under Git Bash or WSL.