Five-minute start

RSP 3.1 requires Node.js 22 or later. For opt-in beta evaluation, pin the exact prerelease identity so the workflow does not move underneath the repository.

Initialize a project

npx -y @oevery/rsp@3.1.0-beta.5 init --with-project-setup

This creates the .rsp/ foundation, ensures the RSP entry in AGENTS.md, and creates .rsp/changes/project-setup.md. Fill that Change and .rsp/specs/design.md, then inspect the setup:

npx -y @oevery/rsp@3.1.0-beta.5 doctor
npx -y @oevery/rsp@3.1.0-beta.5 status

Use init --agents-mode print when you need RSP to print the resulting AGENTS.md content as well as initialize the project. RSP owns only the block between <!-- rsp:begin --> and <!-- rsp:end -->; surrounding project instructions remain project-owned.

Start one change

rsp create improve-login "Make login failures actionable"
rsp focus improve-login
rsp show --focused

Edit .rsp/changes/improve-login.md. Keep its canonical Proposal, Spec, Design, Tasks, Verify, and Blockers sections. A focus marker selects current work; an open Change is not automatically current merely because its file exists.

For a deliberately small tracked task, rsp create --lite <name> uses the shorter template. Do not create persistent tracking for every trivial session task.

When no Change is focused and the user has not supplied a concrete task, ask what to work on or suggest npx -y @oevery/rsp create <name> for tracked work. Simple current-session tasks should not create RSP changes unless tracking is intentionally needed.

Work to acceptance

1. Read the nearest AGENTS.md, relevant context, focused Change, and only the Specs or Decision Records that own the affected behavior.
2. Refine unresolved outcome, scope, non-goals, acceptance, or design before implementation.
3. Implement within explicit mutation authority and run fresh, proportionate verification.
4. Update Tasks, Verify, and Blockers with current outcomes rather than an execution transcript.
5. Decide whether stable facts, lasting rationale, or scoped instructions need a durable owner.
6. Archive only after acceptance and required checks pass and no blocker remains.

Archive does not grant Git, publication, or deployment authority. Reinspect the worktree and obtain those permissions separately.

Install project Skills

Preview and install the eleven default Skills from the exact RSP package being used:

npx -y @oevery/rsp@3.1.0-beta.5 skills install --dry-run
npx -y @oevery/rsp@3.1.0-beta.5 skills install

The optional report-only structural audit is installed by exact name:

rsp skills install rsp-structural-audit --dry-run
rsp skills install rsp-structural-audit

Next, read core concepts or follow the daily workflow.