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

..

autoimport

Improve staleness check error handling and optimization (bd-n4td, bd-o4qy, bd-c4rq)

2025-11-20 20:45:39 -05:00

beads

Fix: Change default JSONL filename from beads.jsonl to issues.jsonl

2025-11-21 23:34:22 -08:00

compact

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

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

config

Centralize BD_DEBUG logging into internal/debug package

2025-11-06 20:14:34 -08:00

configfile

Fix: Change default JSONL filename from beads.jsonl to issues.jsonl

2025-11-21 23:34:22 -08:00

daemon

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

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

debug

Centralize BD_DEBUG logging into internal/debug package

2025-11-06 20:14:34 -08:00

git

Fix branchExists test after signature change

2025-11-02 20:30:31 -08:00

importer

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

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

lockfile

Standardize daemon detection with tryDaemonLock probe (bd-wgu4)

2025-11-07 21:02:38 -08:00

merge

Annotate gosec-safe file accesses

2025-11-17 10:12:46 -07:00

routing

Fix TestRoutingIntegration and improve DetectUserRole robustness

2025-11-20 19:04:42 -05:00

rpc

Fix GH#366: Encourage descriptions when creating issues

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

storage

Fix TestAddCommentUpdatesTimestamp timing flake on Windows

2025-11-23 10:57:29 -08:00

syncbranch

feat: Respect BEADS_SYNC_BRANCH environment variable

2025-11-22 18:17:19 -08:00

testutil

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

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

types

feat: Add ancestor_id field and implement epic/child filtering

2025-11-05 00:44:41 -08:00

util

Extract normalizeLabels to internal/util/strings.go

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

utils

fix: improve ResolvePartialID / ResolveID handling for bd show (issue #336)

2025-11-19 05:54:28 -05:00

validation

Refactor: Extract duplicated validation logic to internal/validation

2025-11-20 20:39:23 -05:00