Ownership
Observe the structure that exists; do not design the structure that should replace it.
Use the shared evidence contract.
Read the optional CodeGraph guide only when CodeGraph tools are callable or the user explicitly asks to install, initialize, or configure CodeGraph.
Workflow
- Ask one narrow structural question, define its scope, and state the decision it supports.
- Detect whether an optional code-intelligence runtime is available through callable tools only. Do not install a runtime, do not run
codegraph init, and do not create .codegraph/ without explicit authorization.
- Use the narrowest symbol, relation, or targeted search that can answer the question; expand only to close a named evidence gap.
- Use an explicit fallback when runtime evidence is unavailable or inconclusive: inspect targeted symbols, search, imports, references, tests, configuration, and direct reads. A textual match is not proof of a caller, callee, or owner.
- Keep an evidence ledger for every material claim: claim, status (
observed, inferred, or unresolved), source, location, confidence, and relevance.
- Stop at sufficiency when traceable evidence answers the question, critical dependencies are checked, gaps are classified, and further reading is unlikely to change the immediate decision. Hand off to the next owner.
Output contract
- scope;
- entrypoints;
- modules and responsibilities;
- observed boundaries;
- dependency direction;
- ownership signals;
- hotspots;
- evidence gaps;
- source references;
Does not own
Future architecture, pattern selection, or new boundary design; hand those decisions to Architecture & Engineering.
1---2name: mapping-existing-codebase-structure3description: Use when you need traceable evidence of the current codebase structure, boundaries, and entrypoints.4---56## Ownership78Observe the structure that exists; do not design the structure that should replace it.910Use the shared [evidence contract](references/evidence-contract.md).1112Read the optional [CodeGraph guide](references/codegraph.md) only when CodeGraph tools are callable or the user explicitly asks to install, initialize, or configure CodeGraph.1314## Workflow15161. Ask one narrow structural question, define its scope, and state the decision it supports.172. Detect whether an optional code-intelligence runtime is available through callable tools only. Do not install a runtime, do not run `codegraph init`, and do not create `.codegraph/` without explicit authorization.183. Use the narrowest symbol, relation, or targeted search that can answer the question; expand only to close a named evidence gap.194. Use an explicit fallback when runtime evidence is unavailable or inconclusive: inspect targeted symbols, search, imports, references, tests, configuration, and direct reads. A textual match is not proof of a caller, callee, or owner.205. Keep an evidence ledger for every material claim: claim, status (`observed`, `inferred`, or `unresolved`), source, location, confidence, and relevance.216. Stop at sufficiency when traceable evidence answers the question, critical dependencies are checked, gaps are classified, and further reading is unlikely to change the immediate decision. Hand off to the next owner.2223## Output contract2425- scope;26- entrypoints;27- modules and responsibilities;28- observed boundaries;29- dependency direction;30- ownership signals;31- hotspots;32- evidence gaps;33- source references;3435## Does not own3637Future architecture, pattern selection, or new boundary design; hand those decisions to Architecture & Engineering.
jhonatan-oliveiradev