Skip to content

chore

Sanctioned lane for non-behavioral work — docs-only edits, dependency bumps, reverts. Type-scaled gates; no TDD demanded of prose.

This is the lane for changes with no behavior to test-drive — prose edits, a version bump on an existing dependency, or backing out a named commit. Each of the three types gets exactly the checks it needs and nothing more: a docs edit gets a secrets scan and a copy pass instead of a demand for failing tests that would never exist for prose; a dependency bump gets the same vetting /ca:add-dep applies plus a full suite run; a revert has to be a real git revert, never a hand-edited backout, and also needs the suite green afterward. Anything that smuggles in a behavioral code change gets redirected — this lane exists precisely to keep TDD ceremony off changes that have nothing to test.

/ca:chore <docs|deps|revert> <description or SHA>

Name the type first, then the docs description, the dependency to bump, or the commit SHA to revert.

> /ca:chore deps bump lodash to 4.17.21
Classified: deps.
Dispatching dependency-reviewer... license MIT (unchanged), no new transitive risk, changelog reviewed.
Manifest and lockfile updated together.
Running full suite... 412 passed, 0 failed.
Routing to commit-gate (classification: chore)...

Reach for /ca:chore for docs-only edits, an existing dependency’s version bump, or reverting a named commit. A brand-new dependency goes through /ca:add-dep first; any behavioral change goes through /ca:feature or /ca:fix.

GateWhenEffect
type classificationbefore any gate runsthe request must sort cleanly into docs, deps, or revert; a behavioral change beyond that scope redirects to feature or fix
type-scaled checksafter classificationdocs gets a copy pass and a secrets scan; deps gets a dependency review and a full green suite; revert gets a clean git revert and a full green suite
commit-gateafter the type’s checks passthe change still exits through the standard commit gate and lands via branch and PR
Source — plugins/ca/commands/chore.md (v2.9.1)
---
description: Sanctioned lane for non-behavioral work — docs-only edits, dependency bumps, reverts. Type-scaled gates; no TDD demanded of prose.
argument-hint: "<docs|deps|revert> <description or SHA>"
---
# /ca:chore — non-behavioral change lane
The sanctioned path for work that has no behavioral surface to test-drive. Three types, each with
the gates that fit it — and nothing it doesn't need. Everything still exits through `commit-gate`
(classification `docs` / `chore` / `revert`) and lands via branch/PR.
## Types
**docs** — README, comments, CHANGELOG, `.codearbiter/` prose, typo fixes.
- Gates: secrets scan over the diff; diff review (no behavioral code change smuggled in);
anti-slop copy pass on any user-facing doc in the change; `commit-gate`.
- **Anti-slop copy pass** — for any user-facing doc the change touches (repo-root community docs
and `docs/**`; not codeArbiter's own framework bodies), load
`${CLAUDE_PLUGIN_ROOT}/includes/anti-slop-design/INDEX.md`, then `core.md` and the
`medium-documents` leaf (§7.A.1), and run the §3.A em-dash ban and the §3.B copy self-audit over
the authored prose before `commit-gate`. The `H-13` PostToolUse reminder surfaces §3.A separator
dashes as you write, so the pass is a confirmation, not a discovery.
- No `tdd` — prose has no failing test to write.
**deps** — bump an existing dependency's version (manifest + lockfile together, never one without
the other).
- Gates: dispatch `dependency-reviewer` (same vetting as `/ca:add-dep` — license, provenance,
supply chain, changelog of the bump); full test suite green after the bump; `commit-gate`.
- A bump that requires code changes to adopt is not a chore — route the code change through
`/ca:feature` or `/ca:fix`.
**revert** — back out a named commit.
- Gates: `git revert <SHA>` (never hand-edited backout); full suite green after the revert; the
commit message references the reverted SHA and the reason; `commit-gate`.
- No new regression test demanded — the revert restores already-tested behavior. If the revert is
fixing a defect the suite missed, open `/ca:fix` afterward to pin it.
## Flow
1. Classify `$ARGUMENTS` into one of the three types. Anything with a behavioral code change beyond
a mechanical revert is NOT a chore — redirect to `/ca:feature` or `/ca:fix` and stop.
2. Run the type's gates above.
3. Exit through `commit-gate` with the matching classification, then
`finishing-a-development-branch` as usual.
## Hard gate
MUST reject a change containing behavioral code (beyond the revert itself) — that is `/ca:feature`
or `/ca:fix` territory. MUST keep manifest and lockfile changes in the same commit for `deps`.
MUST run the full suite for `deps` and `revert`. MUST run the anti-slop copy pass on any user-facing
doc a `docs` change authors or edits. Never skips `commit-gate`.
## When NOT to use
- Any new or changed behavior → `/ca:feature` / `/ca:fix`.
- Adding a NEW dependency → `/ca:add-dep`.
- Restructuring code → `/ca:refactor`.

View in repo