Protocol
Put the real build and validation path in repository instructions
The repository should teach a new contributor how correctness is checked.
Before you use it
- Use when
- An agent guesses how to build or test the project and either wastes time or validates the wrong thing.
Keep this limit in mind
- Instructions can be wrong or stale; CI and human review remain independent checks.
An idea to explore.
Try this idea.
Inspect the example, try the idea in your situation, then check your next move.
Why it matters
Document the minimal authoritative setup, build, test, lint and targeted validation commands the agent should use, including path-specific exceptions. Point to the source of truth rather than copying huge manuals into the prompt. Keep the instructions current when CI changes.
Steps
- Setup command documented.
- Targeted test command documented.
- Full validation path documented.
- Path-specific rules documented where needed.
- Source-of-truth docs linked.
- Instructions updated with CI changes.
An example
AGENTS.md tells an agent to run one fast unit suite for local iteration and the full contract validator before a PR is considered complete.
Check your result
The agent can state and execute the same validation path a human maintainer expects.
Save and practise this idea
My learning
Read. Recall. Repeat.
Save this idea and return to it on any device.
Keep exploring
Connected ideas
You are readingPut the real build and validation path in repository instructions
Ideas that link here
These ideas link to this one. Check their conditions and limits before use.
Useful with this ideaProtect agent instruction files like build configuration
Evidence and sources
GitHub repository instructions can provide agents with project-specific build, test and validation guidance, including repository-wide, path-specific and AGENTS.md instructions.
Instruction files improve context but are not a security boundary or substitute for permissions.
Adding repository custom instructions for GitHub Copilot · Repository custom instructions
All sources (1)
Edition and review
Version 0.1.0
No review details are supplied for this edition.