@activatus/code-standards 0.0.0-stage → 2.0.0

package/docs/templates.mdx

@@ -0,0 +1,419 @@
+---
+sidebar_position: 2
+---
+
+import CodeBlock from "@theme/CodeBlock";
+import agents from "!!raw-loader!@site/static/templates/AGENTS.md";
+import eslintTypescript from "!!raw-loader!@site/static/templates/eslint/typescript/eslint.config.mjs";
+import eslintReact from "!!raw-loader!@site/static/templates/eslint/react/eslint.config.mjs";
+import eslintNextjs from "!!raw-loader!@site/static/templates/eslint/nextjs/eslint.config.mjs";
+import eslintBase from "!!raw-loader!@site/static/templates/eslint/base/eslint.config.mjs";
+import prettier from "!!raw-loader!@site/static/templates/prettier.config.js";
+import stylelintCss from "!!raw-loader!@site/static/templates/stylelint/css/stylelint.config.mjs";
+import stylelintScss from "!!raw-loader!@site/static/templates/stylelint/scss/stylelint.config.mjs";
+import globalsCss from "!!raw-loader!@site/static/templates/globals.css";
+import editorconfig from "!!raw-loader!@site/static/templates/.editorconfig";
+import nvmrc from "!!raw-loader!@site/static/templates/.nvmrc";
+import envrc from "!!raw-loader!@site/static/templates/.envrc";
+import commitlint from "!!raw-loader!@site/static/templates/.commitlintrc.json";
+import skillLint from "!!raw-loader!@site/static/templates/skills/lint.md";
+import skillLintFix from "!!raw-loader!@site/static/templates/skills/lintFix.md";
+import skillFormat from "!!raw-loader!@site/static/templates/skills/format.md";
+import skillCodeReview from "!!raw-loader!@site/static/templates/skills/codeReview.md";
+import skillUpdateLayout from "!!raw-loader!@site/static/templates/skills/updateLayout.md";
+import skillSecurityAudit from "!!raw-loader!@site/static/templates/skills/securityAudit.md";
+import skillTypescript from "!!raw-loader!@site/static/templates/skills/typescript.md";
+import skillTest from "!!raw-loader!@site/static/templates/skills/test.md";
+import docsSitePackage from "!!raw-loader!@site/static/templates/docsSite/package.json.txt";
+import docsSiteConfig from "!!raw-loader!@site/static/templates/docsSite/docusaurus.config.ts";
+import docsSiteSidebars from "!!raw-loader!@site/static/templates/docsSite/sidebars.ts";
+import docsSiteTsconfig from "!!raw-loader!@site/static/templates/docsSite/tsconfig.json";
+import docsSiteWorkspace from "!!raw-loader!@site/static/templates/docsSite/pnpm-workspace.yaml";
+import docsSiteCss from "!!raw-loader!@site/static/templates/docsSite/src/css/custom.css";
+import docsSiteGitignore from "!!raw-loader!@site/static/templates/docsSite/gitignore.txt";
+import decisionDoc from "!!raw-loader!@site/static/templates/decision-doc.md";
+import docsSiteHome from "!!raw-loader!@site/static/templates/docsSite/src/pages/index.tsx";
+import nextConfig from "!!raw-loader!@site/static/templates/next.config.mjs";
+import huskyHook from "!!raw-loader!@site/static/templates/husky/commit-msg";
+import huskyPreCommit from "!!raw-loader!@site/static/templates/husky/pre-commit";
+
+# Templates
+
+Ready-made files to copy into a project. Every config on this page is the exact file described in the standards — copy it, do not retype it.
+
+Each file is also served as a plain file, so a person or an AI agent can fetch it directly instead of copying from this page.
+
+| File                                             | Copy to                                    | Plain file                                                                                                    |
+| ------------------------------------------------ | ------------------------------------------ | ------------------------------------------------------------------------------------------------------------- |
+| [AGENTS.md](#agents)                             | `AGENTS.md` in the project root            | [`/templates/AGENTS.md`](pathname:///templates/AGENTS.md)                                                     |
+| [ESLint — TypeScript](#eslinttypescript)         | `eslint.config.mjs` in the project root    | [`/templates/eslint/typescript/eslint.config.mjs`](pathname:///templates/eslint/typescript/eslint.config.mjs) |
+| [ESLint — React + TypeScript](#eslintreact)      | `eslint.config.mjs` in the project root    | [`/templates/eslint/react/eslint.config.mjs`](pathname:///templates/eslint/react/eslint.config.mjs)           |
+| [ESLint — Next.js](#eslintnextjs)                | `eslint.config.mjs` in the project root    | [`/templates/eslint/nextjs/eslint.config.mjs`](pathname:///templates/eslint/nextjs/eslint.config.mjs)         |
+| [ESLint — JavaScript / Node.js](#eslintbase)     | `eslint.config.mjs` in the project root    | [`/templates/eslint/base/eslint.config.mjs`](pathname:///templates/eslint/base/eslint.config.mjs)             |
+| [Prettier](#prettier)                            | `prettier.config.js` in the project root   | [`/templates/prettier.config.js`](pathname:///templates/prettier.config.js)                                   |
+| [Stylelint — CSS and CSS Modules](#stylelintcss) | `stylelint.config.mjs` in the project root | [`/templates/stylelint/css/stylelint.config.mjs`](pathname:///templates/stylelint/css/stylelint.config.mjs)   |
+| [Stylelint — SCSS](#stylelintscss)               | `stylelint.config.mjs` in the project root | [`/templates/stylelint/scss/stylelint.config.mjs`](pathname:///templates/stylelint/scss/stylelint.config.mjs) |
+| [Global styles and colour palette](#globalscss)  | `app/globals.css`                          | [`/templates/globals.css`](pathname:///templates/globals.css)                                                 |
+| [EditorConfig](#editorconfig)                    | `.editorconfig` in the project root        | [`/templates/.editorconfig`](pathname:///templates/.editorconfig)                                             |
+| [Node version](#nvmrc)                           | `.nvmrc` in the project root               | [`/templates/.nvmrc`](pathname:///templates/.nvmrc)                                                           |
+| [direnv](#envrc)                                 | `.envrc` in the project root               | [`/templates/.envrc`](pathname:///templates/.envrc)                                                           |
+| [Commitlint](#commitlint)                        | `.commitlintrc.json` in the project root   | [`/templates/.commitlintrc.json`](pathname:///templates/.commitlintrc.json)                                   |
+| [Agent skills](#skills)                          | `.agents/skills/` and `.claude/commands/`  | Eight files — see [below](#skills)                                                                            |
+| [Husky commit hook](#husky)                      | `.husky/commit-msg`                        | [`/templates/husky/commit-msg`](pathname:///templates/husky/commit-msg)                                       |
+| [Docs site](#docs-site)                          | `docsSite/` in the project root            | Several files — see [below](#docs-site)                                                                       |
+| [`/docs` route](#docs-route)                     | `next.config.mjs`                          | [`/templates/next.config.mjs`](pathname:///templates/next.config.mjs)                                         |
+| [Document templates](#document-templates)        | `docs/` in the project root                | Several files — see [below](#document-templates)                                                              |
+
+---
+
+## AGENTS.md {#agents}
+
+**Copy to:** `AGENTS.md` in the project root
+
+Replace every `[placeholder]`. See [AGENTS.md Specifications](/Standards/agent-specs).
+
+<CodeBlock language="markdown" title="AGENTS.md">
+  {agents}
+</CodeBlock>
+
+---
+
+## ESLint — TypeScript {#eslinttypescript}
+
+**Copy to:** `eslint.config.mjs` in the project root
+
+For TypeScript projects. Install commands are on the [ESLint page](/Standards/eslint#installation).
+
+<CodeBlock language="js" title="eslint.config.mjs">
+  {eslintTypescript}
+</CodeBlock>
+
+---
+
+## ESLint — React + TypeScript {#eslintreact}
+
+**Copy to:** `eslint.config.mjs` in the project root
+
+For React projects. Set `settings.react.version` to the project's React version.
+
+<CodeBlock language="js" title="eslint.config.mjs">
+  {eslintReact}
+</CodeBlock>
+
+---
+
+## ESLint — Next.js {#eslintnextjs}
+
+**Copy to:** `eslint.config.mjs` in the project root
+
+For Next.js projects. Set `settings.react.version` to the project's React version.
+
+<CodeBlock language="js" title="eslint.config.mjs">
+  {eslintNextjs}
+</CodeBlock>
+
+---
+
+## ESLint — JavaScript / Node.js {#eslintbase}
+
+**Copy to:** `eslint.config.mjs` in the project root
+
+For plain JavaScript and Node.js projects.
+
+<CodeBlock language="js" title="eslint.config.mjs">
+  {eslintBase}
+</CodeBlock>
+
+---
+
+## Prettier {#prettier}
+
+**Copy to:** `prettier.config.js` in the project root
+
+See the [Prettier page](/Standards/prettier).
+
+<CodeBlock language="js" title="prettier.config.js">
+  {prettier}
+</CodeBlock>
+
+---
+
+## Stylelint — CSS and CSS Modules {#stylelintcss}
+
+**Copy to:** `stylelint.config.mjs` in the project root
+
+See the [Stylelint page](/Standards/stylelint).
+
+<CodeBlock language="js" title="stylelint.config.mjs">
+  {stylelintCss}
+</CodeBlock>
+
+---
+
+## Stylelint — SCSS {#stylelintscss}
+
+**Copy to:** `stylelint.config.mjs` in the project root
+
+For projects that use SCSS.
+
+<CodeBlock language="js" title="stylelint.config.mjs">
+  {stylelintScss}
+</CodeBlock>
+
+---
+
+## Global styles and colour palette {#globalscss}
+
+**Copy to:** `app/globals.css`
+
+Replace the example colours with the project's palette. See [CSS Styling](/Standards/styling).
+
+<CodeBlock language="css" title="globals.css">
+  {globalsCss}
+</CodeBlock>
+
+---
+
+## EditorConfig {#editorconfig}
+
+**Copy to:** `.editorconfig` in the project root
+
+See the [EditorConfig page](/Standards/editorconfig).
+
+<CodeBlock language="ini" title=".editorconfig">
+  {editorconfig}
+</CodeBlock>
+
+---
+
+## Node version {#nvmrc}
+
+**Copy to:** `.nvmrc` in the project root
+
+Set it to the project's Node major version. See [direnv + nvm](/Standards/direnv).
+
+<CodeBlock language="text" title=".nvmrc">
+  {nvmrc}
+</CodeBlock>
+
+---
+
+## direnv {#envrc}
+
+**Copy to:** `.envrc` in the project root
+
+Run `direnv allow` after adding it. See [direnv + nvm](/Standards/direnv).
+
+<CodeBlock language="bash" title=".envrc">
+  {envrc}
+</CodeBlock>
+
+---
+
+## Commitlint {#commitlint}
+
+**Copy to:** `.commitlintrc.json` in the project root
+
+See [Conventional Commits](/Standards/conventional-commits).
+
+<CodeBlock language="json" title=".commitlintrc.json">
+  {commitlint}
+</CodeBlock>
+
+---
+
+## Agent skills {#skills}
+
+**Copy to:** `.agents/skills/` in the project root, and again to `.claude/commands/` so Claude Code picks them up as slash commands.
+
+The eight standard skills. Copy all of them into every project. See [Agent Skills](/Standards/agent-skills) for how they are written.
+
+| Skill                                  | Invocation                             | Plain file                                                                            |
+| -------------------------------------- | -------------------------------------- | ------------------------------------------------------------------------------------- |
+| [Lint](#skill-lint)                    | `/lint [path]`                         | [`/templates/skills/lint.md`](pathname:///templates/skills/lint.md)                   |
+| [Lint & fix](#skill-lintfix)           | `/lintFix [path]`                      | [`/templates/skills/lintFix.md`](pathname:///templates/skills/lintFix.md)             |
+| [Format](#skill-format)                | `/format [path]`                       | [`/templates/skills/format.md`](pathname:///templates/skills/format.md)               |
+| [Code review](#skill-codereview)       | `/codeReview [branch, commit or path]` | [`/templates/skills/codeReview.md`](pathname:///templates/skills/codeReview.md)       |
+| [Update layout](#skill-updatelayout)   | `/updateLayout`                        | [`/templates/skills/updateLayout.md`](pathname:///templates/skills/updateLayout.md)   |
+| [Security audit](#skill-securityaudit) | `/securityAudit [path]`                | [`/templates/skills/securityAudit.md`](pathname:///templates/skills/securityAudit.md) |
+| [TypeScript](#skill-typescript)        | `/typescript [path]`                   | [`/templates/skills/typescript.md`](pathname:///templates/skills/typescript.md)       |
+| [Test](#skill-test)                    | `/test [path]`                         | [`/templates/skills/test.md`](pathname:///templates/skills/test.md)                   |
+
+### Lint {#skill-lint}
+
+Runs ESLint (and Stylelint if configured) in check-only mode; reports all issues grouped by file.
+
+<CodeBlock language="markdown" title="lint.md">
+  {skillLint}
+</CodeBlock>
+
+### Lint & fix {#skill-lintfix}
+
+Runs ESLint and Stylelint in fix mode, then Prettier; reports what changed and what is left.
+
+<CodeBlock language="markdown" title="lintFix.md">
+  {skillLintFix}
+</CodeBlock>
+
+### Format {#skill-format}
+
+Runs Prettier in write mode; reports reformatted files.
+
+<CodeBlock language="markdown" title="format.md">
+  {skillFormat}
+</CodeBlock>
+
+### Code review {#skill-codereview}
+
+Reviews changes for correctness, security, types, tests and standards compliance. Report only.
+
+<CodeBlock language="markdown" title="codeReview.md">
+  {skillCodeReview}
+</CodeBlock>
+
+### Update layout {#skill-updatelayout}
+
+Regenerates the "Repository layout" section of `AGENTS.md` (and "Workspace packages" in monorepos).
+
+<CodeBlock language="markdown" title="updateLayout.md">
+  {skillUpdateLayout}
+</CodeBlock>
+
+### Security audit {#skill-securityaudit}
+
+Audits dependencies and code for secrets, missing access control, unvalidated input and injection. Report only.
+
+<CodeBlock language="markdown" title="securityAudit.md">
+  {skillSecurityAudit}
+</CodeBlock>
+
+### TypeScript {#skill-typescript}
+
+Tightens loose types and removes `any`, `!` and unexplained `as`.
+
+<CodeBlock language="markdown" title="typescript.md">
+  {skillTypescript}
+</CodeBlock>
+
+### Test {#skill-test}
+
+Runs the test suite; reports failures grouped by cause, tests that never ran, and files missing a test.
+
+<CodeBlock language="markdown" title="test.md">
+  {skillTest}
+</CodeBlock>
+
+---
+
+## Husky commit hook {#husky}
+
+**Copy to:** `.husky/commit-msg` in the project root
+
+Refuses a commit whose message does not follow [Conventional Commits](/Standards/conventional-commits#enforcing-commit-messages). Plain file: [`/templates/husky/commit-msg`](pathname:///templates/husky/commit-msg)
+
+<CodeBlock language="text" title=".husky/commit-msg">
+  {huskyHook}
+</CodeBlock>
+
+### Lint before commit {#husky-pre-commit}
+
+**Copy to:** `.husky/pre-commit` in the project root
+
+Refuses a commit while `pnpm lint` reports errors. Plain file: [`/templates/husky/pre-commit`](pathname:///templates/husky/pre-commit)
+
+<CodeBlock language="text" title=".husky/pre-commit">
+  {huskyPreCommit}
+</CodeBlock>
+
+---
+
+## Docs site {#docs-site}
+
+**Copy to:** a `docsSite/` folder in the project root
+
+The Docusaurus viewer that shows the project's `docs/` folder at `/docs`. Copy every file, keeping the folder layout. See [Documentation](/Standards/documentation#-setting-it-up).
+
+| File                     | Plain file                                                                                                                            |
+| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------- |
+| `package.json`           | [`/templates/docsSite/package.json.txt`](pathname:///templates/docsSite/package.json.txt) — rename to `package.json`                  |
+| `docusaurus.config.ts`   | [`/templates/docsSite/docusaurus.config.ts`](pathname:///templates/docsSite/docusaurus.config.ts)                                     |
+| `sidebars.ts`            | [`/templates/docsSite/sidebars.ts`](pathname:///templates/docsSite/sidebars.ts)                                                       |
+| `tsconfig.json`          | [`/templates/docsSite/tsconfig.json`](pathname:///templates/docsSite/tsconfig.json)                                                   |
+| `pnpm-workspace.yaml`    | [`/templates/docsSite/pnpm-workspace.yaml`](pathname:///templates/docsSite/pnpm-workspace.yaml)                                       |
+| `src/css/custom.css`     | [`/templates/docsSite/src/css/custom.css`](pathname:///templates/docsSite/src/css/custom.css)                                         |
+| `.gitignore`             | [`/templates/docsSite/gitignore.txt`](pathname:///templates/docsSite/gitignore.txt) — rename to `.gitignore`                          |
+| `src/pages/index.tsx`    | [`/templates/docsSite/src/pages/index.tsx`](pathname:///templates/docsSite/src/pages/index.tsx)                                       |
+| `static/images/logo.svg` | [`/templates/docsSite/static/images/logo.svg`](pathname:///templates/docsSite/static/images/logo.svg) — replace with the project logo |
+
+Set `PROJECT_NAME` at the top of the config:
+
+<CodeBlock language="ts" title="docusaurus.config.ts">
+  {docsSiteConfig}
+</CodeBlock>
+
+<CodeBlock language="json" title="package.json">
+  {docsSitePackage}
+</CodeBlock>
+
+<CodeBlock language="ts" title="sidebars.ts">
+  {docsSiteSidebars}
+</CodeBlock>
+
+<CodeBlock language="json" title="tsconfig.json">
+  {docsSiteTsconfig}
+</CodeBlock>
+
+<CodeBlock language="yaml" title="pnpm-workspace.yaml">
+  {docsSiteWorkspace}
+</CodeBlock>
+
+<CodeBlock language="css" title="src/css/custom.css">
+  {docsSiteCss}
+</CodeBlock>
+
+<CodeBlock language="text" title=".gitignore">
+  {docsSiteGitignore}
+</CodeBlock>
+
+The home page sends `/docs` to the first Overview doc. Change the path if the overview file is renamed:
+
+<CodeBlock language="tsx" title="src/pages/index.tsx">
+  {docsSiteHome}
+</CodeBlock>
+
+### The `/docs` route {#docs-route}
+
+**Copy to:** `next.config.mjs` in the project root. If the project already has a Next.js config, add the `rewrites` function to it.
+
+Plain file: [`/templates/next.config.mjs`](pathname:///templates/next.config.mjs)
+
+<CodeBlock language="js" title="next.config.mjs">
+  {nextConfig}
+</CodeBlock>
+
+---
+
+## Document templates {#document-templates}
+
+**Copy to:** the `docs/` folder in the project root, keeping the folder layout
+
+The full set of Decision Docs for a new project: every [reusable folder](/Standards/documentation#-the-folders) with every standard file, each marked `Status: Not started`. Copy the whole [`static/templates/docs/`](https://github.com/activatus-life/code-standards/tree/main/static/templates/docs) folder from this repository.
+
+| Folder          | Example file                                                                                  |
+| --------------- | --------------------------------------------------------------------------------------------- |
+| `overview/`     | [`/templates/docs/overview/what-is-it.md`](pathname:///templates/docs/overview/what-is-it.md) |
+| `architecture/` | [`/templates/docs/architecture/system.md`](pathname:///templates/docs/architecture/system.md) |
+| `scope/`        | [`/templates/docs/scope/core.md`](pathname:///templates/docs/scope/core.md)                   |
+| …and 13 more    | Each file is served at `/templates/docs/<folder>/<file>.md`                                   |
+
+After copying, rename `overview/what-is-it.md` after the project and update its title.
+
+### Decision Doc format {#doc-format}
+
+**Copy to:** any new doc that has no template file
+
+The shape every doc follows. See [The doc format](/Standards/documentation#-the-doc-format). Plain file: [`/templates/decision-doc.md`](pathname:///templates/decision-doc.md)
+
+<CodeBlock language="markdown" title="decision-doc.md">
+  {decisionDoc}
+</CodeBlock>

package/docs/version-history.md

@@ -0,0 +1,211 @@
+---
+sidebar_position: 1.6
+sidebar_label: "Version History"
+---
+
+# Version History
+
+> What changed in each version of the standards, and exactly what a project has to do about it. Written for the AI agent doing the update.
+
+**Every change to the standards gets a new version number.** Each project records the version it follows in its `AGENTS.md`, under "Code standards":
+
+```md
+**Code standards version:** 2
+```
+
+## Updating a project to a new version
+
+**Read only the versions newer than the project's.** A project on version 1 that is updating to version 3 reads version 2 and version 3 on this page, and nothing else. Do not re-read every standard or check the whole codebase: each version lists every change that matters, and how to find the code it affects.
+
+1. **Find the project's version** in its `AGENTS.md`. If there is none, the project has never followed the standards: follow [Setup](/Guides/setup) instead.
+2. **Update the package:** `pnpm update @activatus/code-standards --latest`. Then read this page from `node_modules/@activatus/code-standards/docs/version-history.md`.
+3. **Read each version newer than the project's**, oldest first. Skip any change to a standard the project opted out of: they are listed in `docs/development/coding-standards.md`.
+4. **For each change, do the "What to do" steps**, then run the "How to check" searches. A search that still finds something means the change is not finished.
+5. **One pull request per kind of change** (for example, all the folder renames together), so each one stays easy to review. Follow the project's commit rule in `AGENTS.md`.
+6. **Run `pnpm lint`, `pnpm test` and the build** after each change.
+7. **Update the version number** in `AGENTS.md` once every change is done.
+
+**When a change does not fit the project**, for example it renames a folder the project does not have, skip it. If you are not sure, ask; do not guess.
+
+## Adding a version
+
+Anyone changing the standards adds a version, in the same pull request as the change:
+
+- **One version per change that reaches `main`**, numbered one higher than the last. Whole numbers only.
+- **Bump the package's major version to match** in `package.json`: version 3 is `3.0.0`. Then publish it to npm (npmjs.com) with `pnpm publish`. pnpm is the tool; npm is where the package lives, and projects install it from there with `pnpm add`.
+- **For every change, write:** what changed, why, what to do in a project, and how to check it is done. Write it for an agent that has not read the rest of the standards.
+- **If a project has nothing to do, say so.**
+- **Newest version at the top.**
+
+---
+
+## Version 2
+
+**Released:** 2026-10-15 · **Updates from:** version 1
+
+### 1. The standards are an npm package — do this first
+
+**Why:** A project installs the standards, so an agent reads the exact version the project uses, straight from `node_modules`. The package version is the standards version: `2.0.0` is version 2.
+
+**What to do:**
+
+- `pnpm add -D @activatus/code-standards`
+- Read the rest of this update from `node_modules/@activatus/code-standards/docs/version-history.md`. The templates to copy are in `node_modules/@activatus/code-standards/static/templates/`.
+- In `AGENTS.md`, under "Code standards", say the standards are installed as `@activatus/code-standards`, and that agents read them from `node_modules/@activatus/code-standards/docs/`. Copy the wording from the [`AGENTS.md` template](/templates#agents).
+
+**How to check:** `@activatus/code-standards` is in the project's `devDependencies`.
+
+### 2. The person agrees which standards apply — do this second
+
+**Why:** Not every standard suits every project. The person now picks, from a numbered list, and the choices are written down so every agent follows the same ones.
+
+**What to do:**
+
+- Print the numbered list in [Setup, step 3](/Guides/setup#3-agree-the-standards) to the person, exactly as written, and record their answer in `docs/development/coding-standards.md`.
+- For the rest of this update, **skip any change to a standard the person opted out of.**
+
+**How to check:** `docs/development/coding-standards.md` lists the opted-out standards by number, or says "No differences".
+
+### 3. `docs` is a dictionary word: the docs folder is `docs/` again
+
+**Why:** `docs` is a word, not an abbreviation, and `documentation` is long and hard to read in names.
+
+**What to do:**
+
+- Rename the folders with `git mv`: `documentation/` → `docs/`, `documentationSite/` → `docsSite/`.
+- Rename `docs/overview/writing-documentation.md` → `docs/overview/writing-docs.md`, and fix every link to it.
+- Rename the environment variable `DOCUMENTATION_URL` → `DOCS_URL` in `next.config.mjs`, `.env.local`, `.env.example` and the hosting provider's settings.
+- Rename the route `/documentation` → `/docs`. Copy the new rewrite from the [`next.config.mjs` template](/templates#docs-route).
+- In `docsSite/docusaurus.config.ts`, set `baseUrl: '/docs/'` and `path: '../docs'`. Copy the [`docsSite/` template](/templates#docs-site) if unsure.
+- Rename the scripts in `package.json`: `documentation:install` → `docs:install`, `documentation:dev` → `docs:dev`, `documentation:build` → `docs:build`.
+- Update every mention in `AGENTS.md`, `README.md` and the docs themselves.
+
+**How to check:** `grep -rn "documentation/\|documentationSite\|DOCUMENTATION_URL\|documentation:" --exclude-dir=node_modules .` finds nothing. Normal sentences that say "documentation" are fine.
+
+### 4. `props` is a dictionary word: prop types end in `Props`
+
+**Why:** `props` is the word every React developer uses. `properties` is harder to read.
+
+**What to do:**
+
+- Rename every type ending in `Properties` to end in `Props`: `ButtonProperties` → `ButtonProps`. Use the editor's Rename Symbol (F2), not find-and-replace.
+- Rename variables and parameters called `properties` to `props`, including spreads: `...buttonProperties` → `...buttonProps`.
+- Copy the new [ESLint config](/Standards/eslint). Two things changed in it:
+  - The type-name rule is now `(Props|Type)$`.
+  - `unicorn/name-replacements` now has `replacements: { docs: false, props: false, utils: false }`.
+
+**How to check:** `grep -rn "Properties\b" --include=*.ts --include=*.tsx --exclude-dir=node_modules .` finds nothing of ours, and `pnpm lint` passes.
+
+### 5. `utils` is a dictionary word: reusable functions live in `utils/`
+
+**Why:** `utils` is the word developers use. `utilities` and `helpers` are not.
+
+**What to do:**
+
+- Rename every `utilities/` folder to `utils/` with `git mv`, at every level: global, section and component.
+- Rename any `helpers/` folder to `utils/`. Split a `helpers.ts` grab-bag file into one folder per function.
+- Fix the imports: `@/utilities` → `@/utils`, `./utilities` → `./utils`.
+
+**How to check:** `find . -type d \( -name utilities -o -name helpers \) -not -path "*/node_modules/*"` finds nothing, and `grep -rn "utilities\"" --exclude-dir=node_modules .` finds no imports.
+
+### 6. Components live where they are used: no feature folders
+
+**Why:** Grouping by feature and grouping by page meant two places for the same component. Now there is one rule. See [Where components live](/Structure/folder-structure#-where-components-live).
+
+| Used by                                                  | Lives in                    |
+| -------------------------------------------------------- | --------------------------- |
+| Every project the same way: the Design System Components | `components/ui/`            |
+| More than one page of this project                       | `components/shared/`        |
+| A few pages in one section                               | `app/(section)/components/` |
+| One page only                                            | `app/page-name/components/` |
+
+**What to do:**
+
+- For each component in `components/features/` or `components/layout/`, find where it is imported (`grep -rn "ComponentName"`).
+  - Imported by one page → move it to that page's `components/` folder.
+  - Imported by pages in one section → move it to that section's route group: `app/(section)/components/`.
+  - Imported by pages in more than one section → move it to `components/shared/`.
+- Move a feature's `utils/` folder the same way, to wherever its functions are used.
+- Delete the empty `components/features/` and `components/layout/` folders.
+- Leave `components/ui/` as it is.
+
+**How to check:** `components/features/` and `components/layout/` do not exist, and the build passes.
+
+### 7. The Component Reference is now Design System Components
+
+**Why:** It is the list of standard components every project builds the same way, and "design system components" is what people call that.
+
+**What to do:** In `AGENTS.md` and the project's docs, change "Component Reference" to "Design System Components", and change links from `/template-components` to `/design-system-components`.
+
+**How to check:** `grep -rn "Component Reference\|template-components" --exclude-dir=node_modules .` finds nothing.
+
+### 8. The Dictionary: short names that are words
+
+**Why:** Some short names are words, not abbreviations. The [Dictionary](/Standards/human-readable-names#dictionary) is the one list of them, so nobody has to guess.
+
+**What to do:**
+
+- The Dictionary has: `id`, `docs`, `props`, `utils`, `app`, `url`, `api`, `uat`, `pdf`, `html`, `css`, `json`, `readme`.
+- Any other short name in the project's own code is written out in full. If one seems like a word, ask for it to be added to the Dictionary; do not just use it.
+- Copy the new "Dictionary words stay short" bullet into `AGENTS.md` from the [template](/templates#agents).
+
+**How to check:** `pnpm lint` passes with the new ESLint config.
+
+### 9. Third-party names are used as they are
+
+**Why:** The naming rule is only for names we write. Names from someone else's code keep their own names: everyone knows them by those names, and renaming them breaks the code.
+
+**What to do:**
+
+- Undo any rename of a third-party name. The common one is shadcn/ui's `cn` function: it stays `cn`.
+- In our own code, give the value a full-word name as soon as it arrives: `const workingDirectory = process.cwd();`, then `{ cwd: workingDirectory }`.
+
+**How to check:** Nothing to search for. Review any renamed import from a package.
+
+### 10. The ontology only holds code words
+
+**Why:** The code standards define words about writing code. Each project defines the words for what it builds.
+
+**What to do:**
+
+- Keep the project's product words in `docs/product/ontology.md`.
+- Check every word in it against the [Ontology](/ontology). If the project gives a code word a different meaning, remove that entry and use the code standards' meaning. Tell a person what changed.
+- Make the project's ontology say that it adds to the code standards' ontology.
+- Update the "Ontology" section of `AGENTS.md` from the [template](/templates#agents). It now points to both ontologies.
+
+**How to check:** No term in `docs/product/ontology.md` is also defined in the code standards' [Ontology](/ontology).
+
+### 11. Whether agents may commit is the project's choice
+
+**Why:** Strict no commit is right for most projects, but a tool built to ship code with AI, such as Launchpad, needs agents to commit.
+
+**What to do:** This is standard 22 in the list from change 2. If the person kept it, keep the template's "NEVER COMMIT CODE" lines for strict no commit. Otherwise, replace them with the project's own rule, saying exactly which agents may commit, push and open Pull Requests, and when. See [A project can choose otherwise](/Standards/agent-specs#a-project-can-choose-otherwise).
+
+**How to check:** The top of `AGENTS.md` states the project's commit rule.
+
+### 12. The live standards site
+
+**Why:** The standards now have a real address: https://activatus-code-standards.vercel.app
+
+**What to do:** Replace `[code standards site URL]` in `AGENTS.md` and `docs/development/coding-standards.md` with https://activatus-code-standards.vercel.app
+
+**How to check:** `grep -rn "code standards site URL" .` finds nothing.
+
+### 13. This Version History
+
+**What to do:** Add `**Code standards version:** 2` to `AGENTS.md`, under "Code standards".
+
+### No action needed
+
+- The [Setup](/Guides/setup) guide is written for the agent: install the package, check the version, agree the standards, apply them. It never asks which framework the project uses, and never creates the app: the person does that.
+- The [migration guide](/Guides/migrating#stage-4--names) has a Names stage.
+
+---
+
+## Version 1
+
+**Released:** 2026-10-15
+
+The first numbered version: everything in the standards on this date. It included `documentation/` for the docs folder, `Properties` at the end of prop types, `utilities/` for reusable functions, `components/features/`, and the Component Reference. Version 2 replaced all five.
+
+**What to do in a project:** follow the [migration guide](/Guides/migrating) for everything.