ordo
ordo installs the yapus standards and git hooks on the machine and the yapus setup in a repository; /ordo:upgrade and /ordo:repo bring them up to the plugin's version. A standard is a file of numbered rules, such as CODE-4; every standard but PRINCIPLES.md names the file paths it applies to.
/ordo:machine writes the standards into ~/.claude/rules/yapus/ordo/ and the git hooks into ~/.claude/yapus/ordo/hooks/git. It sets the global core.hooksPath to those hooks when it is unset, refuses when another one is set, and prints the steps that undo it.
At the start of every session, ordo reports when it is not installed on the machine or when the installed version differs from the plugin's; it updates nothing itself.
During a session, ordo refuses a Write or Edit that puts a Unicode dash other than the ASCII hyphen into a Markdown file.
Standards
| File | Subject |
|---|---|
| ACTIONS.md | GitHub Actions workflows |
| BASH.md | bash scripts |
| CODE.md | command-line programs |
| DATA.md | JSON, YAML and TOML files |
| ENGINEERING.md | modules, types and boundaries |
| GIT.md | commit scopes |
| GO.md | Go code |
| IDENTIFIERS.md | machine identifiers and text for people |
| INSTRUCTIONS.md | instruction files for agents |
| MARKDOWN.md | Markdown prose |
| PRINCIPLES.md | principles for every change |
| PYTHON.md | Python code |
| REPOSITORY.md | technology choice and repository layout |
| TESTS.md | tests |
| TYPESCRIPT.md | TypeScript code |
Git Hooks
The commit hook refuses a subject that is not type(scope): verb ... with each word listed in a catalog, or that is longer than 72 characters. The type and verb catalogs ship with the hooks (hooks/shared/catalogs/); the scopes come from the repository's .claude/yapus/ordo/scopes.json, and a repository without one accepts any scope of the form. A ! before the colon marks a breaking change.
Two subjects from this repository's history that pass:
docs(readme): add the prompt log and its recall
refactor(ordo)!: rename the landmark plugin to ordoThe subject update the readme is refused with:
yapus subject: "update the readme" is not in the form "type(scope): verb ...", such as "feat(hooks): add a check"; rewrite the subjectThe repository's own commit-msg hook, which the global hooks path hides, runs after the yapus check, and its refusal stops the commit too.
When an agent runs git (CLAUDECODE=1), a commit subject that passes gets the trailers Assisted-by: Claude Code and Co-authored-by: yapus <noreply@yapus.dev>, and git refuses a new branch not named <type>/<slug>: the type from hooks/shared/catalogs/types.json, the slug of lowercase letters, digits and hyphens, at most 50 characters.
Repository Setup
/ordo:repo writes the yapus repository setup into the repository at the root of the session. Every install writes the workflow .github/workflows/yapus.yml, the scope catalog .claude/yapus/ordo/scopes.json and the chosen language in .claude/yapus/ordo/language.
| Argument | Writes | Next steps it prints |
|---|---|---|
typescript, the default | the ESLint and TypeScript base under .claude/yapus/ordo/, the root eslint.config.ts and tsconfig.json that build on it, the check and test scripts, the pinned devDependencies and "type": "module" in package.json | npm install, npm test |
go, with go.mod at the root | the golangci-lint config .golangci.yml | the pinned golangci-lint install, the Go checks |
For TypeScript it removes the old ESLint config files and packages. It never runs npm or golangci-lint.
In a repository that carries its stamp (.claude/yapus/ordo/version), plain /ordo:repo upgrades only yapus's own files to the plugin's version, in the recorded language, and refuses an argument that names another language. The root files, scripts.test and the scope catalog belong to the project.
The command writes nothing while a path it would write or remove has an uncommitted change, and it prints the git steps that undo it.
Commands
| Command | Effect |
|---|---|
/ordo:machine | standards and git hooks into ~/.claude, once per machine |
/ordo:upgrade | installed standards and git hooks up to the plugin's version |
/ordo:repo | TypeScript setup of a new repository, upgrade of a set-up one in its recorded language |
/ordo:repo go | Go setup of a new repository |