Source: ViewEdit

History artifacts are filed under the changelog, never the repo root

Agents saved requested reports, prompts, and migration notes as loose files in repository roots, where they cluttered the repo face and were not linked from any history. The rule now gives them one home per repo shape.

  • Antora repos: docs/modules/<module>/pages/changelog-details/history/YYYY-MM-DD-<slug>.adoc, unlisted (:hide-page:, :navtree-parent: changelog.adoc, not in nav.adoc), converted to AsciiDoc where reasonable; include-only fragments in partials/changelog-details/history/. The real changelog is the Antora page; a root CHANGELOG is only a stub with the published URL and source path.

  • Repos with no docs site: root CHANGELOG.adoc plus root changelog-details/history/YYYY-MM-DD-<slug>.adoc. An earlier draft the same day used pages/history/ and changelog/history/; both were dropped so every repo uses one changelog-details/history/ convention.

  • Why changelog-details/: the folder name reads as subordinate to the changelog, so readers go to the changelog first; folders are never named with the plural changelogs.

  • Each history document is linked from its changelog entry and/or a == History and reports section.

  • Throwaway verification files (one-off playbooks, scratch configs) stay in $AGENT_TEMP_ROOT/scratch/ and are never committed. Contributor guides such as STYLE.adoc and CONTRIBUTING stay where contributor docs belong.

  • Skills touched: owned-changelog (new History artifacts section and triggers such as "save this report", "save the prompt", "historical context", "migration notes", "analysis doc", "stray root files"), antora-org-site rule 16, public-readme Repo root hygiene, record-rule, agent-temp, and skills/CATALOG.md.