AGENTS.md@docs/_generated git:20260727.833c06aA

Immutable. This exact content is served forever at /api/v1/blob/976716806fe84c8f.

# docs/_generated — technical guide

## Purpose

This directory holds **generator output** plus **maintainer-written** index files (`README.md`, this `AGENTS.md`). Every other file listed below is overwritten by a generator; do not edit any of them by hand. **`COUNTS.md`** is machine-generated by `scripts/docgen/counts.py` and gated by `counts.py --check` in CI and pre-commit (see [`README.md`](README.md)).

## Files

| File | Source |
| --- | --- |
| [`active_projects.md`](active_projects.md) | **Generated** — `uv run python scripts/docgen/active_projects.py` |
| [`architecture_overview.md`](architecture_overview.md) / [`architecture_overview.svg`](architecture_overview.svg) / `.mmd` | **Generated** — `uv run python scripts/docgen/architecture_overview.py` |
| [`coverage_history.md`](coverage_history.md) | **Generated** — `uv run python scripts/docgen/coverage_history.py --from-dir=<dir>` (offline) or `--from-gh --days=30` (online, needs `gh`) |
| [`coverage_snapshot.json`](coverage_snapshot.json) | **Generated** — `uv run python scripts/docgen/counts.py --refresh-coverage-provenance --write`; source-commit/source-hash provenance for the COUNTS.md coverage table, validated fail-closed |
| [`COUNTS.md`](COUNTS.md) | **Generated** — `uv run python scripts/docgen/counts.py --write` (`--check` gates CI and pre-commit); ground-truthed test counts, gates, and roster notes (see [`README.md`](README.md)) |
| [`exemplar_roster.md`](exemplar_roster.md) | **Generated** — `uv run python scripts/docgen/exemplar_roster.py` (`--check` gates CI and pre-commit) |
| [`hermes_knowledge_audit.json`](hermes_knowledge_audit.json) | **Historical snapshot** — legacy external audit metadata; do not use for current counts |
| [`publication_records.md`](publication_records.md) | **Generated publication matrix** — public exemplar GitHub/Zenodo/config records; refresh with `uv run python scripts/docgen/publication_records.py --refresh-external` |
| [`skills_index.md`](skills_index.md) | **Generated** — `uv run python -m infrastructure.skills write-index` |
| [`last-run-summary.md`](last-run-summary.md) | **Generated** — written by `infrastructure.reporting.multi_project_report.write_last_run_summary` (re-exported from `infrastructure.core.pipeline.multi_project`) from `scripts/runner/execute_multi_project.py` end-of-run. Schema: [`../operational/logging/output-design.md`](../operational/logging/output-design.md) |
| [`README.md`](README.md), `AGENTS.md` | **Maintainer** — policy and linking conventions |

## Conventions

- Link to [`active_projects.md`](active_projects.md) for the public CI/documentation project scope; avoid copying local `discover_projects()` rosters into other guides.
- For concrete paths in examples, default to [`projects/templates/template_code_project/`](../../projects/templates/template_code_project/).

## See Also

- [`README.md`](README.md) — policy and regeneration commands