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

..

bench_test.go

Fix test compilation errors: add context.Background() to sqlite.New() calls

2025-11-21 14:57:18 -05:00

client_selfheal_test.go

Add client self-heal for stale daemon.pid

2025-11-07 21:21:24 -08:00

client.go

feat: Add 'bd count' command for counting and grouping issues

2025-11-21 19:21:05 -05:00

comments_test.go

test: Tag 16 slow integration tests with build tags

2025-11-21 14:40:22 -05:00

coverage_test.go

Remove deprecated bd repos command

2025-10-24 19:49:16 -07:00

isolation_test.go

Add database isolation canary test

2025-10-21 22:44:45 -07:00

limits_test.go

fix: Add context.Background() to sqlite.New() calls in test files

2025-11-21 14:48:41 -05:00

list_filters_test.go

fix: Add context.Background() to sqlite.New() calls in test files

2025-11-21 14:48:41 -05:00

metrics_test.go

Fix TestMetricsSnapshot/uptime flakiness on Windows

2025-11-02 09:56:42 -08:00

metrics.go

Fix TestMetricsSnapshot/uptime flakiness on Windows

2025-11-02 09:56:42 -08:00

protocol_test.go

Add native Windows support (#91)

2025-10-20 21:08:49 -07:00

protocol.go

feat: Add label operations to bd update command

2025-11-21 22:17:26 -05:00

rpc_test.go

fix: Add context.Background() to sqlite.New() calls in test files

2025-11-21 14:48:41 -05:00

server_compact.go

Fix #249: Add nil storage checks to prevent RPC daemon crashes (#250)

2025-11-07 14:21:14 -08:00

server_core.go

Implementing an RPC monitoring solution with a web-ui as implementation example. (#244)

2025-11-07 09:49:12 -08:00

server_export_import_auto.go

Fix GH#367: bd import defaulting to stdin is confusing

2025-11-23 11:15:34 -08:00

server_issues_epics.go

Fix GH#366: Encourage descriptions when creating issues

2025-11-23 14:14:40 -08:00

server_labels_deps_comments.go

Fix #249: Add nil storage checks to prevent RPC daemon crashes (#250)

2025-11-07 14:21:14 -08:00

server_lifecycle_conn.go

fix: address critical resource leaks and error handling issues (#327)

2025-11-20 08:13:06 -08:00

server_mutations_test.go

Implementing an RPC monitoring solution with a web-ui as implementation example. (#244)

2025-11-07 09:49:12 -08:00

server_routing_validation_diagnostics.go

feat: Add 'bd count' command for counting and grouping issues

2025-11-21 19:21:05 -05:00

server.go

Complete cache audit (bd-bc2c6191)

2025-11-06 19:51:16 -08:00

signals_unix.go

Add native Windows support (#91)

2025-10-20 21:08:49 -07:00

signals_windows.go

Add native Windows support (#91)

2025-10-20 21:08:49 -07:00

status_test.go

fix: Add context.Background() to sqlite.New() calls in test files

2025-11-21 14:48:41 -05:00

test_helpers.go

Context propagation with graceful cancellation (bd-rtp, bd-yb8, bd-2o2)

2025-11-20 21:57:23 -05:00

transport_unix.go

Add native Windows support (#91)

2025-10-20 21:08:49 -07:00

transport_windows.go

Add native Windows support (#91)

2025-10-20 21:08:49 -07:00

version_test.go

Fix test compilation errors: add context.Background() to sqlite.New() calls

2025-11-21 14:57:18 -05:00