Sigma-Discipline

A portable planning + shipping discipline for AI coding agents. The planning half is two complementary documents kept at every project's root:

• WISHLIST.md — the low-ceremony capture inbox. Ideas, deferrals, nice-to-haves, and out-of-scope bugs/findings land here so nothing good is forgotten. Append-only.
• ROADMAP.md — the authoritative, priority-ordered plan of what to build next, as phases. Only scoped, sequenced, committed work; every phase has named deliverables and a testable definition of done.

The flow: capture in WISHLIST → triage → promote a scoped item into a ROADMAP phase → build → record the outcome. WISHLIST stays a parking lot; ROADMAP stays clean and executable.

Alongside the planning docs, two shipping discipline skills close the loop once work is built:

• sigma-check — the shipper. When a unit of work is finished and the local gate is green, it opens the PR, deploys an independent reviewer, loops fix→re-review (max 3 rounds), and merges autonomously only on a genuinely green gate. Releases/tags/migrations always stop for sign-off.
• wrap-up — post-ship housekeeping. After work is merged and verified, it cleans junk and dead code (allowlisted, never blind — no git clean -fd), prunes merged branches, and syncs docs/project memory. Only tidies finished work; only deletes what it can name.

Full cycle: capture → triage → promote → build → /sigma-check (ship) → /wrap-up (clean).

This repo packages that discipline as slash-commands / skills for Claude Code, Codex, and OpenCode, from a single canonical source so the three never drift.

Layout

skills/
  wishlist/SKILL.md      ← CANONICAL source (Claude Code skill format)
  roadmap/SKILL.md       ← CANONICAL source
  wrap-up/SKILL.md       ← CANONICAL source (post-ship housekeeping)
  sigma-check/SKILL.md   ← CANONICAL source (review-loop auto-merge shipper)
AGENTS.md                ← condensed always-on planning discipline (Codex + OpenCode auto-read this)
install.sh               ← installs into each tool's native format from the canonical source

The skills/*/SKILL.md files are the single source of truth. The Codex prompts and OpenCode commands are derived from them at install time (frontmatter rewritten, cross-references re-pointed) — edit the SKILL.md, re-run install, done.

Install

git clone https://github.com/s1gmamale1/Sigma-Discipline.git
cd Sigma-Discipline
./install.sh              # auto-detects which of the three tools are present
# or target specific tools:
./install.sh --claude --codex --opencode

Tool	Mechanism	Lands at	Invoke
Claude Code	skill (symlink)	~/.claude/skills/{wishlist,roadmap,wrap-up,sigma-check}	/wishlist, /roadmap, /wrap-up, /sigma-check (auto-discovered)
Codex	prompt	~/.codex/prompts/{wishlist,roadmap,wrap-up,sigma-check}.md	same slash-commands
OpenCode	command	~/.config/opencode/command/{wishlist,roadmap,wrap-up,sigma-check}.md	same slash-commands

Re-running install.sh is idempotent (it overwrites the derived files and refreshes the Claude symlinks). If a skill already exists at the Claude path as a real directory (hand-authored or copied), the installer moves it aside to <name>.pre-sigma-discipline.bak before symlinking — it never deletes your version.

Always-on (optional, recommended)

Slash-commands are pull-based. To make the discipline always apply in a project — so the agent reaches for WISHLIST/ROADMAP without being asked — copy this repo's AGENTS.md into your project root (Codex and OpenCode both auto-load AGENTS.md), or append its content to your global ~/.codex/AGENTS.md. Claude Code users can add the same pointer to CLAUDE.md.

install.sh prints this reminder; it does not modify global AGENTS.md/CLAUDE.md files for you (those are yours to own).

Uninstall

./install.sh --uninstall   # removes the symlinks / derived files; never touches your WISHLIST/ROADMAP

Updating

git pull then ./install.sh. The Claude skills are symlinks (live-updated by the pull); the Codex/OpenCode derived files are regenerated by the install run.