Update an adoption
An update moves an adopted repository to a newer setup: a new version of its standards source, another source or profile, a new CLI, or any combination of them. Each update is one adoption run, reviewed and committed like the first adoption.
See what is available
Section titled “See what is available”.repo-standards/runtime/node_modules/.bin/repo-standards outdatedoutdated reports whether a newer CLI or standards version is published for
each pin, and each newer release’s adopter action: something its author asks
of you outside adoption. It changes nothing in the project and is safe to run
at any time; the installed repository-standards skill runs it at the start
of an agent’s work. Whether to update is your decision. See
the available-updates report for its
output and the release policy.
Update with one command
Section titled “Update with one command”In an adopted project, omit the source to update the current selection:
npx @lutzseverino/repo-standards adoptThis offers the newest stable standards release and the profiles, with the
same terminal prompts or answers-file path. Pass a new source URL to change
sources, or use --standards-version and --profile to choose them explicitly.
Running through npx installs and pins the CLI it ran. To keep the current
CLI pin while updating standards, use the project runtime instead:
.repo-standards/runtime/node_modules/.bin/repo-standards adoptIn a fresh clone, restore the ignored runtime dependencies before starting an update that keeps the CLI pin:
npm ci --ignore-scripts --prefix .repo-standards/runtimeA matching external CLI also requires this restoration. Otherwise adoption
reports RUNTIME_MISSING and starts no run. Restore the runtime, then rerun
the project-pinned adopt command with the same requested selection and answers;
there is no new run to abandon. A valid existing runtime is reused without
installing dependencies again.
Each update reviews changes, obtains confirmation when required, and completes
one run. With every recorded answer reused, nothing else
open and no confirmation required, adopt --json is the whole update: it
starts the run in that invocation, which exits 0 with its changes ready to
commit. See Update the selection for the detailed
update contract and lower-level commands.
Answers an update reuses
Section titled “Answers an update reuses”An update carries the last complete adoption’s answers forward when what they were about is provably unchanged: a discovered scope whose guidance, rules and fresh draft match and whose paths all still exist, a deferral of remote setup that is still not ready, and an assessment whose rules and scoped files are unchanged. Every other recorded answer comes back prefilled for review, with what changed. A confirmation is never reused. See Reused answers for the exact conditions.
Apply the same version again
Section titled “Apply the same version again”To apply the current selection again, for example after the repository gains or moves content its standards should cover, keep both pins: run the pinned runtime and pass the current standards version.
.repo-standards/runtime/node_modules/.bin/repo-standards adopt \ --standards-version <current version>Without --standards-version, adopt proposes the newest stable release. The
pinned runtime keeps the CLI pin, and the run applies the retained standards
again even when the source cannot be read. A discovered scope whose recorded
paths no longer all exist comes back with a fresh draft for review. See
Update the selection.
Change the CLI pin
Section titled “Change the CLI pin”npx @lutzseverino/repo-standards@<version> adopt installs and pins the CLI it
ran, so it changes the CLI pin and the standards version in one run. In the
product’s own checkout, use an external exact CLI instead, as
Adopting in the product checkout
describes.
Update without anyone answering
Section titled “Update without anyone answering”adopt --headless updates an established adoption without asking anybody,
for a scheduled job or another unattended caller. It completes only when every
answer is reused, nothing blocks it and no confirmation is required, and it
defers every remote setup to the next local adopt. Otherwise it stops with
the questions that remain. See
Update headlessly. To have
every available update proposed as a pull request, opt in to
automated updates.
Review and commit
Section titled “Review and commit”Review an update as you would an adoption: review the changes, then commit them. The inspection also states the update class. An exact update changes only exact content, skills or the selection, so no contextual work is asked for again. A contextual update changes guidance, rules of a contextual declaration, discovery, operations, retired declarations or scope, so the affected declarations are assessed again. See update class. An update also removes installed content that leaves the selection, unless it was edited or lies within contextual scope: that content stays in place as the project’s own.