Illustrative workflow, not a live workspace result.
Task
Update the account settings screen
Root instruction
Preserve the existing theme
Package instruction
Use the shared form controls
Output
Task instructions with source references
Instructions
One pack, not fourteen scattered rules.
AGENTS.md, CLAUDE.md, editor rules, skills and hooks are read as one corpus, resolved for scope and precedence, and compiled into the smallest correct pack for the task in front of you.
AGENTS.md+4
Normalize rules
Resolve precedence
Compile the pack
Illustration of the compile. Your pack is built from your own repository.
Why use Instructions?
Repository instructions can disagree or apply to different directories. An agent needs to know which rule governs this task, and why.
Resolve competing rules
See which instruction takes precedence and which conflicts need a decision.
Keep the task in focus
Compile the relevant rules for the task and its declared scope.
Trace each instruction
Keep source references with the pack so the recipient can inspect the original guidance.
How Instructions fits your work
01
Supply the sources
Add the repository instructions and the task they should govern.
02
Review scope and conflicts
Inspect the resolved rules and any contradictory guidance.
03
Use the instruction pack
Give the pack and its source map to your coding agent.
What to know before you start
The result depends on the sources and repository facts supplied. Missing or stale sources need review.