# Repo Standards > Write your setup down once. Your coding agent applies it to every repository. Repo Standards is the scoped npm package `@lutzseverino/repo-standards`, maintained at https://github.com/lutzseverino/repo-standards and published at https://repo-standards.com/. Repo Canon (https://github.com/lutzseverino/repo-canon) is the ready-made setup to start from. The site is also available in Spanish under /es/ and in Catalan under /ca/. Run `npx --yes @lutzseverino/repo-standards adopt https://github.com/lutzseverino/repo-canon --json` in this repository and follow what it prints. ## Overview - [Repo Standards](https://repo-standards.com/index.md) - [Documentation](https://repo-standards.com/docs.md) - [Sources (JSON)](https://repo-standards.com/sources.json) ## Getting started - [Getting started](https://repo-standards.com/docs/getting-started.md) - [Adopt Repo Canon in five minutes](https://repo-standards.com/docs/getting-started/adopt-repo-canon.md) - [Keep it up to date](https://repo-standards.com/docs/getting-started/keep-it-up-to-date.md) - [What Repo Standards does](https://repo-standards.com/docs/getting-started/what-repo-standards-does.md) ## Guides - [Guides](https://repo-standards.com/docs/guides.md) - [Adopt a standards source](https://repo-standards.com/docs/guides/adopt.md) - [Write and publish a standards source](https://repo-standards.com/docs/guides/author-a-source.md) - [Automated updates](https://repo-standards.com/docs/guides/automated-updates.md) - [Find standards sources](https://repo-standards.com/docs/guides/find-sources.md) - [Install the CLI and skills](https://repo-standards.com/docs/guides/install.md) - [Run the adopted checks](https://repo-standards.com/docs/guides/run-checks.md) - [Update an adoption](https://repo-standards.com/docs/guides/update.md) ## Reference - [Reference](https://repo-standards.com/docs/reference.md) - [Adoption run reference](https://repo-standards.com/docs/reference/adoption-run.md) - [Contextual work and agent assessment](https://repo-standards.com/docs/reference/assessment-protocol.md) - [Author format: repo-standards/v2](https://repo-standards.com/docs/reference/author-format.md) - [Available updates report](https://repo-standards.com/docs/reference/available-updates.md) - [Check reference](https://repo-standards.com/docs/reference/check.md) - [GitHub requests and tokens](https://repo-standards.com/docs/reference/github-requests.md) - [Bootstrap and public inspection](https://repo-standards.com/docs/reference/inspection.md) - [Installed rules](https://repo-standards.com/docs/reference/rules.md) - [Trusted script protocol](https://repo-standards.com/docs/reference/script-protocol.md) ## Design decisions - [Architecture decisions](https://repo-standards.com/docs/decisions.md) - [Separate standards authorship from adoption execution](https://repo-standards.com/docs/decisions/0001-separate-authorship-from-adoption.md) - [Finish authoring at a validated local standards source](https://repo-standards.com/docs/decisions/0002-finish-authoring-at-a-validated-source.md) - [Use agent discovery with confirmed concrete scope](https://repo-standards.com/docs/decisions/0003-use-agent-discovery-with-confirmed-concrete-scope.md) - [Amend scope without redefining installed ownership](https://repo-standards.com/docs/decisions/0004-amend-scope-without-redefining-installed-ownership.md) - [Retain work evidence as identities and deltas](https://repo-standards.com/docs/decisions/0005-retain-work-evidence-as-identities-and-deltas.md) - [Gate standards selection with the author range only](https://repo-standards.com/docs/decisions/0006-gate-selection-with-the-author-range-only.md) - [Write and read one evidence format, as identities and deltas](https://repo-standards.com/docs/decisions/0007-write-and-read-one-evidence-format.md) - [Bind confirmation identity to what the run reads](https://repo-standards.com/docs/decisions/0008-bind-confirmation-identity-to-what-the-run-reads.md) - [Correct scope by adopting again, not by amending a run](https://repo-standards.com/docs/decisions/0009-correct-scope-by-adopting-again.md) - [Replace tracked content; block only untracked](https://repo-standards.com/docs/decisions/0010-replace-tracked-content-block-only-untracked.md) - [Retain only the current run](https://repo-standards.com/docs/decisions/0011-retain-only-the-current-run.md) - [Bind content, not location](https://repo-standards.com/docs/decisions/0012-bind-content-not-location.md) - [Expose installed skills through skill links](https://repo-standards.com/docs/decisions/0013-expose-installed-skills-through-skill-links.md) - [Leave available updates to the maintainer](https://repo-standards.com/docs/decisions/0014-leave-available-updates-to-the-maintainer.md) - [Leave delivery to standards sources](https://repo-standards.com/docs/decisions/0015-leave-delivery-to-standards-sources.md) - [Keep edited content that leaves the selection](https://repo-standards.com/docs/decisions/0016-keep-edited-content-that-leaves-the-selection.md) - [Confirm only confirmation-required changes](https://repo-standards.com/docs/decisions/0017-confirm-only-confirmation-required-changes.md) - [Add a private Astro site workspace](https://repo-standards.com/docs/decisions/0018-add-a-private-astro-site-workspace.md) - [Run declared discovery scripts read-only during inspection](https://repo-standards.com/docs/decisions/0019-run-declared-discovery-scripts-read-only.md) - [Read repository-wide rules at the start of any work](https://repo-standards.com/docs/decisions/0020-read-repository-wide-rules-at-the-start-of-work.md) - [Let agents decide what Git can undo](https://repo-standards.com/docs/decisions/0021-let-agents-decide-what-git-can-undo.md) - [Replace a stopped run in place](https://repo-standards.com/docs/decisions/0022-replace-a-stopped-run-in-place.md) - [Let an optional discovery declaration have no scope](https://repo-standards.com/docs/decisions/0023-let-an-optional-discovery-declaration-have-no-scope.md) - [Reuse recorded answers that are provably unchanged](https://repo-standards.com/docs/decisions/0024-reuse-recorded-answers-that-are-provably-unchanged.md) - [Start when nothing is open](https://repo-standards.com/docs/decisions/0025-start-when-nothing-is-open.md) - [Propose updates through one rolling pull request for adopters who opt in](https://repo-standards.com/docs/decisions/0026-propose-updates-through-one-rolling-pull-request.md) - [Choose the platform inside each profile](https://repo-standards.com/docs/decisions/0027-choose-the-platform-inside-each-profile.md) - [Keep generated shadcn source read-only](https://repo-standards.com/docs/decisions/0028-keep-generated-shadcn-source-read-only.md) - [Leave archived run/v6 reports unread](https://repo-standards.com/docs/decisions/0029-leave-archived-run-v6-reports-unread.md) - [Localize the website through MessageFormat 2 catalogs](https://repo-standards.com/docs/decisions/0030-localize-the-site-through-mf2-catalogs.md) - [Give every site page one nav shaped like the docs' header](https://repo-standards.com/docs/decisions/0031-give-every-site-page-one-nav.md) - [Open the phone nav as a sheet under the header](https://repo-standards.com/docs/decisions/0032-open-the-phone-nav-as-a-sheet-under-the-header.md) - [Keep Astro for content and static sites](https://repo-standards.com/docs/decisions/0033-keep-astro-for-content-and-static-sites.md) - [Select check location beside platform](https://repo-standards.com/docs/decisions/0034-select-check-location-beside-platform.md) - [Keep one copy of installed exact content](https://repo-standards.com/docs/decisions/0036-keep-one-copy-of-installed-exact-content.md) ## Sources - [repo-canon](https://repo-standards.com/sources/lutzseverino/repo-canon.md) - [repository-standards-examples](https://repo-standards.com/sources/lutzseverino/repo-standards-example.md) ## How it works - [How Repo Standards works](https://repo-standards.com/how-it-works.md)