{
  "schema": "vedokrok.public-item.v1",
  "release_id": "MHC-RPUB-20260920-75ad787a",
  "url": "/knowledge/put-the-real-build-and-validation-path-in-repository-instructions",
  "id": "MHC-D-RESEARCH-0656",
  "version": "0.1.0",
  "title": "Put the real build and validation path in repository instructions",
  "summary": "The repository should teach a new contributor how correctness is checked.",
  "kind": "protocol",
  "body": "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.",
  "limits": [
    "Instructions can be wrong or stale; CI and human review remain independent checks."
  ],
  "topics": [
    "union-ai-assisted-coding-safeguards"
  ],
  "intents": [],
  "source_ids": [
    "RS-9C63048CEC01BF7C"
  ],
  "evidence": [
    {
      "claim": "GitHub repository instructions can provide agents with project-specific build, test and validation guidance, including repository-wide, path-specific and AGENTS.md instructions.",
      "source_id": "RS-9C63048CEC01BF7C",
      "role": "supports",
      "note": "Instruction files improve context but are not a security boundary or substitute for permissions.",
      "locator": "Repository custom instructions"
    }
  ],
  "use_when": [
    "An agent guesses how to build or test the project and either wastes time or validates the wrong thing."
  ],
  "avoid_when": [
    "Instructions can be wrong or stale; CI and human review remain independent checks."
  ],
  "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": "The agent can state and execute the same validation path a human maintainer expects.",
  "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."
  ],
  "sources": [
    {
      "id": "RS-9C63048CEC01BF7C",
      "title": "Adding repository custom instructions for GitHub Copilot",
      "url": "https://docs.github.com/en/copilot/how-tos/copilot-on-github/customize-copilot/add-custom-instructions/add-repository-instructions"
    }
  ],
  "relations": [],
  "collections": [
    {
      "id": "RC-E25DB1788236EF13",
      "title": "Let coding agents move fast inside a reviewable security boundary",
      "url": "/collections/let-coding-agents-move-fast-inside-a-reviewable-security-boundary"
    }
  ]
}