Read-set manifest:
devrites-engine context --skills-root .dsh/skills <slug> --phase shipbundles every file named below into one deduplicated read. Trigger names map to the conditional rules in the sections that follow.
/rite-ship: ship + close the task
/rite-seal decides; /rite-ship mutates Git and closes. Read the source workspace per phase target binding;
if absent, route to /rite-spec <feature>. Ship only with current GO in seal.md.
Rules consulted (read on demand from .dsh/skills/devrites-lib/reference/standards/)
Step 0: Read core.md, then pull as needed:
git-workflow.md: Conventional Commits, atomicity, never-commit list.afk-hitl.md: AFK pause rules for irreversible actions (the type-GO gate itself:git-ship.md,rollout.md). Triggerafk— load when.devrites/AFKexists.definition-of-done.md: acceptance, evidence, drift, rollback, docs.release/ship-checklist.md: final pass/fail sweep.
Operating rules
- GO is prerequisite. No current
seal.mdGO → stop at/rite-seal. - Ship is candidate-read-only. Follow
candidate-integrity.md. Ship must not change any candidate path ortouched-files.md; it may write only workspaceship.md,state.md, and archive bookkeeping. Project/manifest mutation returns through Prove → Review → Seal. - Bindings stay exact. Rerun candidate/Seal checks; require the digest bound in evidence, optional browser evidence, review, and seal. Any mismatch stops.
- Fresh approval. Disclose the exact Git attempt; literal
GOauthorizes it once. Change/retry means re-prompt. Native approval remains separate/authoritative. - Archive, never delete, every audit
.md.
Workflow
- Orient. Snapshot; read seal, state, spec, touched files, evidence, and any UI
brief. Confirm GO/closed digest, then run:
Nonzero/mismatch stops; never reinterpret it. 1a. Health (advisory). Applydevrites-engine check candidate <slug> devrites-engine check seal <slug>/rite-doctorread-only; surface WARN/FAIL without repair. If ACTIVE is flagged, confirm the slug. - Prepare the exact Git candidate. Follow
git-ship.md's read-only pre-GO ladder: inspect the candidate and existing NUL-delimited staged state/path set, refuse out-of-manifest staged work, and rerun candidate/Seal checks. Do not stage or collapse checkpoints before fresh literalGO. From the verified candidate, disclose the exact proposed staging/collapse commands, project-conformant message/trailers, branch, tag/PR, commands, and skips; the existing index need not yet equal the candidate. 2a. Credential guard (HIGH blocks). Before type-GO, run only read-only scans of existing staged blobs and the proposed PR body. This is not a final candidate-clean claim; after literalGOand exact staging, repeat the full staged scan before commit. HIGH stops and requires rotation/redaction; MEDIUM needs confirmation recorded inship.md; LOW is FYI.
Scan a PR body withdevrites-engine secret-scan --stageddevrites-engine secret-scan --stdinonly through non-logging process stdin, then close it—never command/argv/env/heredoc/log/temp file. If that channel is unavailable, stop. rc=3 → STOP: no type-GO/commit/push/archive. 2b. Reconcile residuals before type-GO. Scanstrategy.mddeferrals,decisions.mdFYIs/revisit triggers, unresolvedreview.mdnon-blocking/if-minor/ FYI findings, andseal.mdfollow-ups. Deduplicate only rows with identical obligation + disposition, preserving every source pointer. Each residual appears once in the pendingship.mdtable astracked(durable path/ID) orno-action(prior decision or explicit human acceptance + reason/revisit). Type-GO never impliesno-action. Missing/vague/conflicting disposition blocks;nonerequires empty sources. - Type-GO. Render
git-ship.md's prompt and wait. LiteralGOproceeds once; anything else records cancellation inship.mdand stops. Any command/scope/branch/message/tag/PR change or retry needs a fresh prompt; native approval is still required. - On literal GO plus native approval, follow
git-ship.md's post-GO ladder: disclosed collapse/staging, staged scope/byte comparisons, candidate/Seal revalidation, and full staged secret scan BEFORE commit. Then commit; verify committed state/path set and exact candidate digest; then push → tag/PR as applicable viagit-ship.md. Record SHA and push state inship.mdbefore push (git-ship 7a); a push/tag/PR failure stops, and a rerun resumes at push under fresh type-GO. Capture branch, tag/PR URL. Mismatch stops before push/tag; retry needs fresh approval. 4a. PR only: rendergit-ship.md's structured body; omit empty sections. - Re-scan the four residual sources; any new/missing/changed item blocks archive. Write the template with shipment metadata and the unchanged pre-GO reconciliation.
- Close. Set
state.mdphasedone; followclose-out.mdand rundevrites-engine state close <slug>to move.devrites/work/<slug>→.devrites/archive/<slug>and clearACTIVEonly if it names this slug; preserve another active feature's cursor. Preserve every.md; stable hierarchical instructions need no active-workspace sync. Report the recordedNext stepverbatim — the exact/rite-spec <parent>-<n> "<objective>"when a continuation sequence remains — so the next increment starts from one line, never from chat memory.
Mid-flight discipline. No seal GO, skipped type-GO, out-of-manifest stage, or deleted workspace. Stop and use
anti-patterns.
