Archon/.github/ISSUE_TEMPLATE/bug_report.md
Rasmus Widing a684345524
feat(skills): overhaul archon-dev skill, add issue cookbook, improve templates
* feat(skills): overhaul archon-dev skill with PRP-inspired improvements

Rewrote all 9 cookbooks (split research into research + investigate) with
battle-tested patterns from PRP workflows. Key improvements:

- research: pure codebase cartography with query classification and follow-up
- investigate: new cookbook for strategic research + feasibility assessment
- prd: 3-round interactive interview with MoSCoW, JTBD, implementation phases
- plan: PRD phase auto-detection, UX diagrams, confidence score, prior-knowledge test
- implement: env detection, base branch auto-detect, git state decision tree
- review: PR checkout, state handling, plan deviation awareness, GitHub posting
- debug: hypothesis-driven methodology, quick/deep modes, 3-test validation
- commit: natural language file targeting while keeping safety checks
- pr: template detection, existing PR check, draft support, base branch auto-detect

Updated SKILL.md description with project-anchored triggers and concrete
examples per cookbook to improve routing accuracy.

* fix(skills): add missing routing keywords for investigate cookbook

Add "can we" and "best approach" to investigate keywords — both are
common phrasings for feasibility questions that weren't being matched.

* fix(skills): broaden PR template search in pr cookbook

Scan .github folder and subfolders more thoroughly before concluding
no PR template exists.

* feat: overhaul PR template with comprehensive engineering sections

Replace minimal 5-section template with structured template covering
UX journey, architecture diagrams, security impact, blast radius,
rollback plan, and validation evidence. Adapted for the Archon
monorepo with project-specific scopes and validation commands.

* feat: improve bug report and feature request issue templates

Add structured sections for user flow diagrams, scope identification,
impact assessment, security considerations, and definition of done.
Adapted for the Archon monorepo with project-specific packages and
platform options.

* feat(skills): add issue cookbook for GitHub bug/feature reporting

New cookbook that classifies bug vs feature, finds the repo's issue
template, validates with a subagent, and submits via gh CLI. Updated
SKILL.md routing table and workflow chain diagram.
2026-03-10 08:38:11 +01:00

1.4 KiB

name about title labels assignees
Bug Report Report a bug to help us improve bug

Summary

  • What broke:
  • When it started (if known):
  • Severity: blocker|major|minor|cosmetic

Steps to Reproduce

Expected vs Actual

  • Expected:
  • Actual:

User Flow

(Draw the flow that triggers the bug. Mark where it breaks with [X].)

Example:
  User                   Archon                   AI Client
  ────                   ──────                   ─────────
  sends /plan ─────────▶ routes to workflow
                         creates worktree
                         streams to AI ──────────▶ processes prompt
                         [X] timeout waiting ◀──── no response
  sees error ◀────────── sends error message

Environment

  • Platform: (Slack / Telegram / GitHub / Discord / Web / CLI)
  • Database: (SQLite / PostgreSQL)
  • Running in worktree? (Yes/No)
  • OS:

Logs

Paste relevant logs here (redact any tokens/secrets)

Impact

  • Affected workflows/commands:
  • Reproduction rate: Always / Intermittent / Once
  • Workaround available? If so, describe:
  • Data loss risk? (Yes/No)

Scope

  • Package(s) likely involved: core|workflows|isolation|git|adapters|server|web|cli|paths
  • Module (if known): e.g. workflows:executor, adapters:slack