Update docs to remove archetype references

Agent-Logs-Url: https://github.com/jeduden/mdsmith/sessions/456d9e30-3668-49b8-9a42-1b286b593ef5

Co-authored-by: jeduden <1117699+jeduden@users.noreply.github.com>

Author: Claude

CLAUDE.md

@@ -17,9 +17,8 @@ sort: path
 header: ""
 row: "- [{summary}]({filename})"
 ?>
-- [How generated sections work — markers, directives, and fix behavior.](docs/background/archetypes/generated-section/README.md)
-- [Shared patterns (archetypes) reused across multiple linting rules.](docs/background/archetypes/README.md)
 - [How "flavor" (a property of the renderer), "rule" (a single check), "convention" (a project-wide bundle), and "kind" (a per-file role tag) differ in mdsmith, the cases where they overlap, and how the four concepts compose.](docs/background/concepts/flavor-rule-convention-kind.md)
+- [How generated sections work — markers, directives, and fix behavior.](docs/background/concepts/generated-section.md)
 - [How the placeholder vocabulary lets rules treat template tokens as opaque rather than flagging them as content violations.](docs/background/concepts/placeholder-grammar.md)
 - [Comparison of mdsmith with other Markdown linters and formatters.](docs/background/markdown-linters.md)
 - [Codecov coverage gate and CI status checks.](docs/development/coverage.md)

docs/background/archetypes/README.md

@@ -90,61 +90,6 @@ directive has no effect`.
 For full reference, see
 [MDS020 required-structure](../../../internal/rules/MDS020-required-structure/README.md).
 
-## Archetype templates
-
-Instead of authoring `schema: path/to/schema.md` for
-every override, collect reusable schemas in an
-archetype directory and refer to them by name.
-
-### Bootstrap the directory
-
-```text
-mdsmith archetypes init
-```
-
-This creates `./archetypes/` by default. Passing a
-directory name creates exactly that directory — for
-example, `mdsmith archetypes init templates` creates
-`./templates/`. The directory gets an `example.md`
-schema and a `README.md`. `init` does not touch
-`.mdsmith.yml`; add the printed snippet yourself.
-
-### Register roots and select an archetype
-
-```yaml
-archetypes:
-  roots:
-    - archetypes
-
-overrides:
-  - files: ["stories/**/*.md"]
-    rules:
-      required-structure:
-        archetype: story
-```
-
-`archetypes.roots` is a list of directories searched
-in order; earlier roots shadow later ones. When the
-key is omitted, the single root `./archetypes` is
-used.
-
-### Inspect archetypes
-
-```text
-mdsmith archetypes list                # one per line: "<name>\t<path>"
-mdsmith archetypes show <name>         # print schema source
-mdsmith archetypes path <name>         # print resolved path
-```
-
-`archetype` and `schema` are mutually exclusive.
-Schema files can use `<?include?>`, but in
-`required-structure` those include paths are
-currently resolved relative to the process working
-directory, not the archetype file's directory. Keep
-archetype schemas self-contained, or run `mdsmith`
-from the project root when an archetype schema uses
-`<?include?>`.
-
 ## Allowing intentional empty sections
 
 Some sections are intentionally left empty (for

…d/archetypes/generated-section/README.md …background/concepts/generated-section.mddocs/background/archetypes/generated-section/README.md renamed to docs/background/concepts/generated-section.md docs/background/archetypes/generated-section/README.md renamed to docs/background/concepts/generated-section.md

@@ -19,7 +19,6 @@ mdsmith <command> [flags] [files...]
 | `help`         | Show help for rules/topics                     |
 | `metrics`      | List and rank shared metrics                   |
 | `merge-driver` | Git merge driver for regenerable sections      |
-| `archetypes`   | Scaffold, list, show, and locate archetypes    |
 | `kinds`        | Inspect declared kinds and resolve config      |
 | `init`         | Generate `.mdsmith.yml`                        |
 | `version`      | Print version, exit                            |
@@ -155,22 +154,6 @@ records the layers that set the leaf, in chain order:
      {"source": "overrides[0]", "value": 900}]}]}
 ```
 
-## `archetypes` Subcommands
-
-| Subcommand    | Description                                  |
-|---------------|----------------------------------------------|
-| `init [dir]`  | Scaffold archetype dir with example + README |
-| `list`        | Print discovered archetypes (name + path)    |
-| `show <name>` | Print raw schema source to stdout            |
-| `path <name>` | Print resolved filesystem path               |
-
-Archetype roots come from the top-level
-`archetypes.roots` key in `.mdsmith.yml`. When absent,
-`./archetypes` is used. `init` never mutates the
-config file; it prints the snippet to add manually.
-`list` exits `1` when no archetypes are discovered;
-`show` and `path` exit `2` on unknown names.
-
 ## `--max-input-size`
 
 Sets the byte-size cap for any input file read by