Steve Yegge
|
bf74160f05
|
Fix GH#366: Encourage descriptions when creating issues
Addresses GitHub Discussion #366 where users reported Claude Code
creating issues with titles but no descriptions.
Two-pronged solution:
1. Documentation improvements (bd-na8r):
- Updated AGENTS.md with prominent guidance section
- Added good/bad examples showing why/what/how to include
- Updated all bd create examples to include --description
- Enhanced MCP tool docstring with importance note
- Updated .github/copilot-instructions.md
2. Code validation (bd-bcrt):
- Added friendly yellow warning when description is empty
- Warning skips test issues (title contains "test")
- Works in both CLI and daemon modes
- Non-blocking to preserve quick workflows
Evidence from our own projects showed significant empty description
rates:
- ~/src/beads: 110/630 (17.5%)
- ~/wyvern: 8/119 (6.7%)
- ~/src/vc: 3/170 (1.8%)
Fixes bd-0tr0, bd-na8r, bd-bcrt
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
|
2025-11-23 14:14:40 -08:00 |
|
Steve Yegge
|
605fff151e
|
feat: Add GitHub Copilot support with .github/copilot-instructions.md
Addresses GH #298 - GitHub Copilot inconsistently interpreting AGENTS.md
Changes:
- Create .github/copilot-instructions.md (132 lines, Copilot-optimized)
- Update AGENTS.md with prominent Copilot callout
- Enhance bd onboard command to generate copilot-instructions.md
Architecture: Two-file approach for different AI agents
- AGENTS.md (626 lines): Comprehensive guide for all AI agents
- .github/copilot-instructions.md (132 lines): Concise, auto-loaded for Copilot
Note: Untested with GitHub Copilot yet. Feedback from Copilot users welcome!
Co-authored-by: Claude <noreply@anthropic.com>
|
2025-11-21 20:52:18 -05:00 |
|