Scaffold Agent Docs

Create the smallest useful set of project-owned facts for agents.

Do not create placeholder documents just to match a standard. Prefer one accurate paragraph over a full empty template.

Process

1. Inspect existing agent instructions, domain docs, ADRs, package scripts, CI, and test config.
2. Reuse existing files when they already serve the purpose.
3. Propose the exact files to create or update.
4. Write only facts discovered from the repo or confirmed by the user.
5. Mark unknown but required facts as TBD with owner or follow-up, not invented values.

Default Layout

Use this layout unless the project already has a clearer one: