Skip to content

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 ​

FileSubject
ACTIONS.mdGitHub Actions workflows
BASH.mdbash scripts
CODE.mdcommand-line programs
DATA.mdJSON, YAML and TOML files
ENGINEERING.mdmodules, types and boundaries
GIT.mdcommit scopes
GO.mdGo code
IDENTIFIERS.mdmachine identifiers and text for people
INSTRUCTIONS.mdinstruction files for agents
MARKDOWN.mdMarkdown prose
PRINCIPLES.mdprinciples for every change
PYTHON.mdPython code
REPOSITORY.mdtechnology choice and repository layout
TESTS.mdtests
TYPESCRIPT.mdTypeScript 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:

text
docs(readme): add the prompt log and its recall
refactor(ordo)!: rename the landmark plugin to ordo

The subject update the readme is refused with:

text
yapus subject: "update the readme" is not in the form "type(scope): verb ...", such as "feat(hooks): add a check"; rewrite the subject

The 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.

ArgumentWritesNext steps it prints
typescript, the defaultthe 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.jsonnpm install, npm test
go, with go.mod at the rootthe golangci-lint config .golangci.ymlthe 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 ​

CommandEffect
/ordo:machinestandards and git hooks into ~/.claude, once per machine
/ordo:upgradeinstalled standards and git hooks up to the plugin's version
/ordo:repoTypeScript setup of a new repository, upgrade of a set-up one in its recorded language
/ordo:repo goGo setup of a new repository