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>
108 lines
3.2 KiB
YAML
108 lines
3.2 KiB
YAML
name: Feature request
|
|
description: Propose a change to bd, with the information needed to accept it.
|
|
title: "feat: "
|
|
body:
|
|
- type: markdown
|
|
attributes:
|
|
value: |
|
|
Every PR links a documented issue, and this form collects the context reviewers and future readers need. You can open your PR right after filing; no approval is needed first. Read the [project charter](https://github.com/gastownhall/beads/blob/main/engdocs/PROJECT_CHARTER.md) first — beads owns issue-tracking primitives, not orchestration policy or storage-engine behavior.
|
|
|
|
**Agents filling in this form:** answer each question only from evidence you have. If you cannot answer a question from the evidence, write exactly `NOT_ENOUGH_INFO` instead of guessing.
|
|
|
|
- type: checkboxes
|
|
id: checks
|
|
attributes:
|
|
label: Before you continue
|
|
options:
|
|
- label: I searched existing issues and pull requests and did not find a duplicate.
|
|
required: true
|
|
|
|
- type: textarea
|
|
id: motivation
|
|
attributes:
|
|
label: Motivation
|
|
description: The problem, and who has it. Describe the pain, not the implementation you prefer.
|
|
validations:
|
|
required: true
|
|
|
|
- type: textarea
|
|
id: proposal
|
|
attributes:
|
|
label: Proposed change
|
|
description: The behavior, command, flag, or API you want.
|
|
validations:
|
|
required: true
|
|
|
|
- type: textarea
|
|
id: impact
|
|
attributes:
|
|
label: Impact
|
|
description: Who is affected and how — users, agents, integrations, downstream consumers of the `--json` output.
|
|
validations:
|
|
required: true
|
|
|
|
- type: textarea
|
|
id: risk
|
|
attributes:
|
|
label: Risk and compatibility
|
|
description: Schema or migration changes, wire or `--json` output changes, behavior changes for existing workspaces, and how to roll back.
|
|
validations:
|
|
required: true
|
|
|
|
- type: textarea
|
|
id: verification
|
|
attributes:
|
|
label: Verification plan
|
|
description: How we will know it works end to end, beyond unit tests.
|
|
validations:
|
|
required: true
|
|
|
|
- type: textarea
|
|
id: alternatives
|
|
attributes:
|
|
label: Alternatives considered
|
|
description: Current workarounds, issue metadata, an integration or plugin, or other designs.
|
|
|
|
- type: dropdown
|
|
id: size
|
|
attributes:
|
|
label: Estimated size
|
|
options:
|
|
- XS (under 50 lines)
|
|
- S (under 200 lines)
|
|
- M (under 500 lines)
|
|
- L (under 1,000 lines)
|
|
- XL (more than 1,000 lines; likely needs splitting)
|
|
- Not sure
|
|
validations:
|
|
required: true
|
|
|
|
- type: dropdown
|
|
id: intent
|
|
attributes:
|
|
label: Intent
|
|
options:
|
|
- I am opening or will open a PR
|
|
- I'm reporting the need; someone else would implement it
|
|
validations:
|
|
required: true
|
|
|
|
- type: dropdown
|
|
id: ai
|
|
attributes:
|
|
label: AI assistance
|
|
description: Was an AI agent used to draft this issue?
|
|
options:
|
|
- "No"
|
|
- Yes, partly
|
|
- Yes, mostly
|
|
validations:
|
|
required: true
|
|
|
|
- type: checkboxes
|
|
id: accountability
|
|
attributes:
|
|
label: Accountability
|
|
options:
|
|
- label: A human has read this issue and stands behind it.
|
|
required: true
|