Ownership
Produce a change evidence brief for another planning method; do not execute the implementation plan.
The workflow below implements the shared Codebase Intelligence evidence contract.
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
- objective;
- explicit in/out scope;
- current-state evidence;
- affected surfaces;
- relevant paths and contracts;
- risks;
- unresolved questions;
- suggested slices;
- testing surfaces;
- handoff to Architecture, Engineering Workflow, Quality & Testing, or Systematic Debugging;
Does not own
Executable planning, implementation, TDD, or slice management; do not implement the plan. Hand executable planning to Engineering Workflow or writing-plans.
1---2name: planning-codebase-changes-with-evidence3description: Use when you need a change evidence brief to inform another method's executable plan for a real codebase change.4---56## Ownership78Produce a change evidence brief for another planning method; do not execute the implementation plan.910The workflow below implements the shared Codebase Intelligence evidence contract.1112## Workflow13141. Ask one narrow structural question, define its scope, and state the decision it supports.152. 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.163. Use the narrowest symbol, relation, or targeted search that can answer the question; expand only to close a named evidence gap.174. 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.185. Keep an evidence ledger for every material claim: claim, status (`observed`, `inferred`, or `unresolved`), source, location, confidence, and relevance.196. 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.2021## Output contract2223- objective;24- explicit in/out scope;25- current-state evidence;26- affected surfaces;27- relevant paths and contracts;28- risks;29- unresolved questions;30- suggested slices;31- testing surfaces;32- handoff to Architecture, Engineering Workflow, Quality & Testing, or Systematic Debugging;3334## Does not own3536Executable planning, implementation, TDD, or slice management; do not implement the plan. Hand executable planning to Engineering Workflow or `writing-plans`.
jhonatan-oliveiradev