A general-audience map of Commitizen's subsystems (cli, commands, config, providers, changelog_formats, version_schemes, plugins) and how they wire together. Pairs with the existing contributor guide and is also the anchor for the new agent-facing docs that follow.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

The repository convention is unwrapped paragraphs (one line per logical paragraph) - see existing contributing.md and pull_request.md where lines run to ~150-250 chars. The newly added AGENTS.md, architecture.md, and docs/contributing/agents/ files were authored with a ~70-char hard wrap, breaking the convention. Unwrap them to match.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Drop `uv.lock` and the cache/build-artifact list (.mypy_cache, .ruff_cache, .venv, site, coverage.xml, ...) — those are generic lockfile/gitignore conventions that any modern agent already knows. Keep only the commitizen-specific files that get regenerated by cz bump, cz changelog, poe doc:screenshots, and poe test:regen, which an agent could not infer from convention alone.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

The four items in this section all duplicated content from AGENTS.md's Mandatory PR reminders (PR template, poe all vs poe ci, do-not-touch) or pointed at validation.md (targeted tests). The `When to read what` table above already routes readers to the same destinations in a more compact form, so the section was pure noise.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Second redundancy audit. Drop content that duplicated other docs:

* agents/index.md: remove `Source-of-truth map` table; it duplicated
  the `When to read what` table below it. The dedup rule is still
  enforced by the `Updating these pages` section.
* agents/index.md: collapse the `fall back to the general flow`
  numbered list to a single sentence; the steps were generic
  engineering advice already covered by `AGENTS.md` and the
  pull-request template.
* validation.md: drop the `mypy --python-version 3.10` snippet; the
  identical command already lives in `contributing_tldr.md`.
* validation.md: drop the `Pre-commit hooks` section; `contributing.md`
  already covers `poe setup-pre-commit` and how hooks run.
* AGENTS.md: trim `When unsure` to the backward-compatibility rule;
  the other two bullets were generic agent etiquette.
* AGENTS.md: drop the `Follow Conventional Commits` reminder;
  every commitizen contributor knows this and prek enforces it.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Validation against the actual source code surfaced three inaccuracies:

* add-version-provider.md: `composer_provider.py` was labelled
  `JSON file with non-standard layout`, but it is actually the
  simplest `JsonProvider` (just `filename` and `indent`). Replace
  with `npm_provider.py` for the non-standard layout / multi-file
  case, and re-introduce composer as the simplest-case example.
* add-changelog-format.md: pointed agents at
  `restructuredtext.py` as an example of overriding only
  `parse_version_from_title` + `parse_title_level`. RST actually
  overrides `get_metadata_from_file` because its titles span
  multiple lines. Re-route the line-anchored example to
  `markdown.py` / `asciidoc.py` / `textile.py` and keep RST as
  the multi-line example. Add the multi-line escape hatch to Step 2
  and clarify that the template extension comes from the class
  attribute, not the format name.
* architecture.md: claimed entry points are loaded `lazily`. Only
  providers are looked up at call time; `KNOWN_CHANGELOG_FORMATS`
  is populated at module import time. Drop the misleading qualifier.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>