DevRites

DevRites

DevRites is a repository-local workflow for building software with Claude Code or Codex. It turns a feature request into a spec, a sliced plan, working code, recorded proof, a release decision, and an explicit ship step.

The work lives under `.devrites/`, not in chat history. A later session or a different agent can read the same plan, decisions, state, and evidence before it continues.

The core path is:

`SPEC -> CLARIFY -> [TEMPER] -> DEFINE -> VET -> BUILD -> PROVE -> POLISH -> REVIEW -> SEAL -> SHIP`

Clarify is mandatory but adaptive, so it asks no questions when the contract is complete. Temper adds an optional strategic review. Vet is the only final readiness phase before Build.

Seal decides whether the feature is ready without changing git. Ship first runs a read-only preflight and discloses the exact Git attempt. A fresh literal `GO` then authorizes one attempt to collapse eligible checkpoints, stage and validate the exact candidate, commit and reverify it, perform any approved project-conventional push, tag, or PR action, and archive the workspace. Unattended runs may create local WIP checkpoint commits along the way, but they remain local unless Ship's disclosed plan includes an approved remote action.

**Status:** [`v4.5.0`](https://github.com/ViktorsBaikers/DevRites/releases/tag/v4.5.0): see [`CHANGELOG.md`](CHANGELOG.md) for release notes.

This is the latest published release; `main` may contain unreleased work.

Quick start

1. Install DevRites

Run this from the root of your project. Node.js 18 or later is required.

npx devrites@latest

The installer adds project-local support for Claude Code and Codex. It does not write skills, agents, or hooks to `~/.claude` or `~/.codex`.

2. Choose the smallest route

DevRites scales the process to the change. Start with the least ceremony that still protects the work:

| Need | Claude Code | Codex | | --