AGENTS.md@skills/universal/dev-context-multi-repo/assets/hub-scaffold · git:20261005.5db538c · 2026-10-05 · sha256 8052db558d3fa30c
AGENTS.md@skills/universal/dev-context-multi-repo/assets/hub-scaffold git:20261005.5db538cA
Immutable. This exact content never changes and is served at /api/v1/blob/8052db558d3fa30c.
# AGENTS.md — <company> Requirements Hub This file is the portable, always-on instruction layer for any AI agent operating against this hub. Keep it short. It is a **map, not an encyclopedia** — it routes to the compiled layer, it does not duplicate it. ## What this repo is A cross-repo knowledge hub. It contains compiled markdown, profiles, and graphs about many source repos. It does **not** contain their source code. Treat the compiled layer as the system of record for cross-repo facts. ## Operating rules 1. **Read before answering.** For any cross-repo question, start from `context/docs/repo-index.md` and the relevant `<domain>/README.md`. Do not infer architecture from repo names. 2. **Ground every claim.** A statement about a repo must trace to a profile (`context/graphs/` / `<domain>/as-is/`) or a cited source. Mark unverified claims as `inferred` or `unverified`. 3. **Right tool for the question.** Direct file read or lexical search for simple lookups; the knowledge graph (`context/scripts/README.md`) only when relationship structure changes the answer. 4. **File durable answers back.** A reusable analysis becomes a catalog page, concept note, or `context/reports/` entry — not a chat-only reply. Run the placement test in `context/docs/documentation-governance.md` first. 5. **Do not paste inventories here.** Repo lists, dependency dumps, and long tables belong in the compiled layer, never in this file. 6. **Respect the rule layer.** `rules/` constraints (compliance, data handling, AI governance, secrets, resilience) are binding. If a task conflicts with a rule, stop and surface the conflict. ## Layout ``` AGENTS.md this file (hot layer) rules/ binding policy stubs context/docs/ canonical platform docs context/templates/ page templates the compiler uses context/scripts/ thin runners + pointers to the pipeline skills context/graphs/ repos.json, knowledge-graph.json, context-graph.json context/overview/ generated cross-cutting maps and catalogs context/reports/ dated, lifecycle-tagged analyses <domain>/ one folder per domain (as-is / assessment / initiatives) ``` ## Runtime layers `AGENTS.md` is the portable baseline read by Claude Code, Codex, and Copilot. Add `.claude/`, `.codex/`, or `.github/` layers only when a tool needs behavior it cannot get from this file. > Replace `<company>` / `<domain>` placeholders before use.