Repository navigation
Add issue templates and standard labels #4
Description
Note
Historical GitHub issue. This issue is closed and retained for provenance. Its original body may describe an older writ/worktrees-hives architecture; do not treat retired Python/lab, Research-Hive, Graph-MVP, hook-enforcement, managed-worktree, babysit, or blanket local-merge restrictions below as current requirements.
Current product direction: https://linear.app/rpd-34/issue/RM-116/epic-writ-parallel-subagent-collaboration-ownership-and-conflict
Linear is the required task tracker; GitHub keeps source/PR/review/check history.
Linked Linear record: https://linear.app/rpd-34/issue/RM-4/worktrees-hives-gh4-add-issue-templates-and-standard-labels
Original GitHub milestone A — Scaffold is legacy taxonomy and does not define the current roadmap.
Summary
Repo hygiene for consistent issue filing across worktrees-hives. Standard labels and optional GitHub issue templates make multi-agent work discoverable, filterable, and consistent with the epic’s milestone taxonomy (scaffold / core / orchestrator / safety / platform / docs).
Problem / context
Today the repo already has custom labels (epic, core, orchestrator, docs, platform, safety) plus GitHub defaults, but:
- Label meanings are not documented for humans or agents that file follow-ups.
- There are no issue templates, so new issues tend to be thin (summary + short acceptance only), which slows planning and PR handoff.
- The skill will spawn workers that create and claim issues; templates reduce ambiguity and keep Linear↔GitHub footers consistent.
- Milestone A3 (scaffold) depends on this being done before core hive-loop work is treated as “production quality” process.
This issue is documentation and GitHub repo configuration only — not skill runtime code.
Goals
- Establish a canonical label set with short, operator-facing definitions.
- Provide optional issue templates (feature / bug / chore) that nudge authors toward problem, acceptance criteria, and the Linear footer pattern already used (
Linear: … (\RM-N`)`). - Document labels in README and/or a short CONTRIBUTING snippet so agents and humans share one source of truth.
- Align template fields with how workers will later parse issues (title, summary, acceptance checkboxes).
Non-goals
- Building runtime label enforcement in the skill (
discoverfilters, auto-labeling logic) — that belongs in later core issues. - Replacing Linear as the planning system of record; GitHub remains the execution surface, Linear stays linked via footer.
- Migrating or closing existing issues; re-labeling historical issues is optional cleanup, not required for Done.
- Designing full product PR templates or CODEOWNERS (out of scope for A3).
- Implementing the skill’s
discover/ claim / orchestrator behavior (see Discover open issues/PRs for allowed owners #5–Issue → PR workflow (never auto-merge) #8).
Detailed acceptance criteria
- Labels present and usable on
rmems/worktrees-hives:epic— multi-issue umbrella / milestone groupingcore— skill loop primitives (discover, claim, PR, babysit, state)orchestrator— multi-subagent scheduling, caps, join/reportdocs— README, SKILL.md, templates, operator docsplatform— install paths, multi-agent-host packaging, validation on second hostsafety— never-merge, force-with-lease, fix caps, owner allowlist, hang recovery
- Each of the six labels has a non-empty description in GitHub (and the same text appears in docs).
- Optional issue templates under
.github/ISSUE_TEMPLATE/(or GitHub form YAML):- Feature (default for new skill capability)
- Bug (unexpected skill/CI/process failure)
- Chore (hygiene, packaging, docs-only)
- Templates include at least: Summary, Problem / context (or repro), Acceptance criteria (checkboxes), and a Linear footer placeholder matching existing style.
- README (and/or CONTRIBUTING snippet) documents label meanings and when to use which template.
- No change required to skill runtime code for this issue to close.
- Linear footer preserved/updated: link to
RM-4.
Design options
| Option | Approach | Pros | Cons |
|---|---|---|---|
| A. Markdown templates | .github/ISSUE_TEMPLATE/*.md |
Simple, works everywhere, easy to review in git | Weaker form validation |
| B. Issue forms (YAML) | .github/ISSUE_TEMPLATE/*.yml + config.yml |
Structured fields, required checkboxes | Slightly more setup; some agents ignore forms |
| C. Labels-only | Document labels; skip templates | Fastest | Thin issues continue; weaker A3 outcome |
Recommendation: A or B (prefer B if maintainers want required fields; A is fine for agent-heavy workflows that paste markdown). Labels already exist — task is descriptions + docs, not inventing new names unless gaps appear.
Suggested label colors (keep existing if already set): epic red, core blue, orchestrator purple, docs blue-gray, platform green, safety orange/red.
Dependencies
| Issue | Relationship |
|---|---|
| #1 Epic | Parent; labels map to epic milestones A–D |
| #2 SKILL.md | Soft dep: SKILL may reference label vocabulary |
| #3 Expand README | Soft dep / can share docs surface for label table |
| #5–#18 | Consumers of consistent filing; not blockers for #4 |
Blocks: nothing hard. Blocked by: nothing hard (can ship anytime in scaffold phase).
Risks
- Label sprawl if agents invent new labels ad hoc — mitigate with “use only documented labels unless epic expands taxonomy.”
- Template fatigue — keep templates short; avoid 20 required fields.
- Drift between Linear issue shape and GitHub templates — keep Linear link footer as the only mandatory cross-link field.
- Duplicate defaults (
documentationvsdocs) — document that skill issues usedocs, leave GitHub defaults alone or note which to prefer.
Suggested plan
- Inventory current labels via
gh label list; fill empty descriptions for the six standard labels. - Add
LABELS.mdsection to README or short CONTRIBUTING: name → meaning → typical milestones. - Add issue templates (feature / bug / chore) with shared footer pattern:
Linear: <url> (\RM-N`)` - Optionally add
config.ymlwith contact links / disable blank issues if desired. - Smoke: open a draft issue from each template; confirm labels apply cleanly.
- Cross-link from Expand README: install, commands, architecture #3 README expansion if that lands later (avoid duplicating long prose).
Prior art / references
- Repo purpose: multi-subagent hive — issues→PRs + PR babysit under isolated git worktrees; owners
rmems,Limen-Neural; never merge. - Prior art skill:
pr-babysit(~/.agents/skills/pr-babysit/SKILL.md) — owner allowlist and safety tone this repo should match in docs. - Epic milestones: A scaffold (this issue = A3).
Hybrid layer
Primary implementation layer: docs
This issue remains valid under the Python/Rust hybrid architecture (epic #21). Rust owns worktrees, state, process supervision, and hard safety; Python owns orchestration/policy; agent skills document how Grok drives both.
Linear: https://linear.app/rpd-34/issue/RM-4/worktrees-hives-gh4-add-issue-templates-and-standard-labels (RM-4)
Metadata
Metadata
Assignees
Labels
Projects
- StatusShow more project fieldsDone
- StatusShow more project fieldsDone
Activity
Add issue templates for rmems/worktree-hive per foundation handoff (#2/…
feat(issue-template): add feature template per foundation handoff (#2/#4
fix(issue-template): add bug report template for worktrees-hive found…
update configuration for issue templates on feature branch #4 logic_r…
fix: address review comments for discovery module
fix: address review comments for discovery module
fix: address review comments for discovery module
Issue #5: Discover open issues/PRs for allowed owners (#58)
Add issue templates for rmems/worktree-hive per foundation handoff (#2/…
feat(issue-template): add feature template per foundation handoff (#2/#4
fix(issue-template): add bug report template for worktrees-hive found…
rmems commentedon Aug 2, 2026
Done in the tree:
.github/ISSUE_TEMPLATE/containsbug.yaml,feature.md, andconfig.yml(95524cc, 0622406, dc19c44). Closing as completed.docs: add canonical labels and feature/bug/chore issue forms (#179)