agent-doc-discipline
Writing-time discipline for documents agents consume (the five surfaces, specs, tickets, .omc/skills/) — every rule checkable and…
Find the mistakes agents keep repeating in this repo and make each impossible at the highest enforcing level — lint rule, type guard, runtime check, script, then text — with every enforcement proven to fire.
Claude Code
$ npx -y skills add Yeachan-Heo/oh-my-claudecode --skill correct --agent claude-code
Codex
$ npx skills add Yeachan-Heo/oh-my-claudecode --skill correct -a codex -y
Cursor
$ npx skills add Yeachan-Heo/oh-my-claudecode --skill correct -a cursor -y
Gemini CLI
$ npx skills add Yeachan-Heo/oh-my-claudecode --skill correct -a gemini-cli -y
GitHub Copilot
$ npx skills add Yeachan-Heo/oh-my-claudecode --skill correct -a github-copilot -y
OpenCode
$ npx skills add Yeachan-Heo/oh-my-claudecode --skill correct -a opencode -y
Windsurf
$ npx skills add Yeachan-Heo/oh-my-claudecode --skill correct -a windsurf -y
name: correct
description: "Find the mistakes agents keep repeating in this repo and make each impossible at the highest enforcing level — lint rule, type guard, runtime check, script, then text — with every enforcement proven to fire."
aliases: []
metadata:
credits:
mistake-elimination: pstack
author: Lauren Tan
url: "https://github.com/cursor/plugins/tree/main/pstack"
port: pstack-claude
port-author: Michael Denyer
port-url: "https://github.com/michael-denyer/pstack-claude"Text instructions decay; structure reruns. This skill converts a repeated agent mistake into an enforcement the mistake cannot survive.
codegen step, broken invariant, slop pattern)
friction
1. **Collect.** Mine the evidence — resolve OMC's state root first (the checkout's `.omc/` by default; `OMC_STATE_DIR` or a parent `.omc-workspace` moves it, and a package-subdirectory launch must not read a stray checkout-local `.omc`): the notepads under `<state-root>/notepads/*/problems.md`, the verification ledger at `<state-root>/state/verification-ledger.tsv`, review comments, recent fix commits. Group by root cause, not by symptom. 2. **Rank.** Frequency × cost. Take the top mistakes; one at a time. 3. **Pick the highest enforcement level that works**: 1. linter rule / compiler error — the mistake stops compiling 2. type-level guard — the mistake stops type-checking 3. runtime check or assertion — the mistake fails loudly at the boundary 4. script or codemod — the correct action is one command 5. project skill text — the last resort; note why every higher level failed 4. **Implement** the enforcement with its exception path documented (how a legitimate case opts out). 5. **Prove it fires.** Reproduce the mistake deliberately and show the enforcement catching it, with real output. An enforcement you have not seen fire is a hypothesis (an external benchmark-checklist discipline applies). 6. **Record honestly**: the ledger verdict matches what the repro actually exercised — a lint rule or type guard firing is `enforcement-verified`, a runtime check exercised by a test is `unit-test-verified`, a proof is `formally-verified`. Never record a stronger verdict than the evidence.
requirement now.
(`<state-root>/state/verification-ledger.tsv` per the collection step) with the verdict the repro actually exercised (see workflow step 6) and the repro command as evidence.
to climb the ladder again.
For Codex users: Check out oh-my-codex — the same orchestration experience for OpenAI Codex CLI. Liked OmC but found it a bit overkill? Try gajae-code.
Writing-time discipline for documents agents consume (the five surfaces, specs, tickets, .omc/skills/) — every rule checkable and…
Clean AI-generated code slop with a regression-safe, deletion-first workflow and optional reviewer-only mode
Settle types and module shape before cross-boundary code — competing designs explored in parallel, compared on API surface and…
Periodic architecture survey — walks the module graph and reports ranked deepening candidates (shallow modules, hypothetical…
Run N parallel candidates at one brief and synthesize: rubric-first framing, isolated fan-out, a cross-judge on a different…
Shipyard's navigator — chart a foggy effort (destination unclear, questions not yet stateable) into a map of decision tickets on…
Use your assigned AgentMail inbox to read email tasks, explicitly send or reply, and check delivery. Provided automatically by…
Create a new Architecture Decision Record with sequential numbering and AgentDB registration