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
..
2025-10-12 11:25:29 -07:00
2025-11-17 10:06:35 -07:00
2025-11-23 14:14:40 -08:00
2025-10-23 20:06:40 -07:00