beads/.github/copilot-instructions.md
Julian Knutsen 0773e6334e
docs(agents): contributor-only agent instructions and documented-issue intake (#7223)
Makes the repo's agent and contributor surface describe developing beads, not using bd, and requires every PR to link a documented issue.

- Contributor-only root AGENTS.md with a routing table; cmd/bd/AGENTS.md and engdocs/AGENTS.md seam files; CLAUDE.md symlinks so Claude Code loads nested files.
- Bug and feature issue forms, a PR template that requires Closes #, CONTRIBUTING sections for the triage and pipeline labels, and the opt-in fork-cache during dev setup.
- ROADMAP.md for 1.4: versioned beads (#6132), Graph Preview 2 (#7170), contributor onboarding (#7228).
- docsync guards: root AGENTS.md at or under 20 KB; every AGENTS.md symlinked, routed, and with resolving links, paths, and guard-test names.

Agent-Signature: claude-code-claude-opus-5-5-high on behalf of Julian Knutsen
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
2026-10-05 08:43:53 +00:00

746 B

GitHub Copilot instructions for beads

The canonical contributor instructions for this repository are in AGENTS.md; area-specific rules are in the nested AGENTS.md files listed in its routing table. Read those, not this file, for workflow, build, test, and scope rules.

The rules most often missed in review:

  • A PR must close a documented GitHub issue (filed before or alongside it).
  • Build with make install, never go build -o bd ./cmd/bd or go install ./cmd/bd.
  • make ci-pr-lint must pass with zero issues; choose tests with engdocs/TESTING.md.
  • Never create test issues in a production database; use t.TempDir().
  • CLI output uses small Unicode status symbols, never emoji icons.