Add comprehensive label documentation (bd-159, bd-163)

- Create LABELS.md with complete guide to label system
- Document label patterns, filtering, workflows, and best practices
- Add Labels section to README with examples
- Link LABELS.md in documentation section
- Close bd-159 and bd-163

Amp-Thread-ID: https://ampcode.com/threads/T-072304c3-3a03-4091-92a9-9e16b4538227
Co-authored-by: Amp <amp@ampcode.com>
This commit is contained in:
Steve Yegge
2025-10-19 23:11:52 -07:00
parent 422c102f46
commit 24cd163afb
3 changed files with 563 additions and 1 deletions
+31
View File
@@ -413,6 +413,36 @@ bd rename-prefix kw-
bd list # Shows kw-* issues
```
### Labels
Add flexible metadata to issues for filtering and organization:
```bash
# Add labels during creation
bd create "Fix auth bug" -t bug -p 1 -l auth,backend,urgent
# Add/remove labels
bd label add bd-42 security
bd label remove bd-42 urgent
# List labels
bd label list bd-42 # Labels on one issue
bd label list-all # All labels with counts
# Filter by labels
bd list --label backend,auth # AND: must have ALL labels
bd list --label-any frontend,ui # OR: must have AT LEAST ONE
# JSON output
bd label list-all --json
```
**See [LABELS.md](LABELS.md) for complete documentation:**
- Label workflows and best practices
- Common label patterns (components, domains, size, quality gates)
- Advanced filtering techniques
- Integration with CI/CD and automation
### Dependencies
```bash
@@ -1527,6 +1557,7 @@ If you installed via Homebrew, this shouldn't be necessary as the formula alread
## Documentation
- **[README.md](README.md)** - You are here! Complete guide
- **[LABELS.md](LABELS.md)** - Complete label system guide: workflows, filtering, best practices
- **[TEXT_FORMATS.md](TEXT_FORMATS.md)** - JSONL format analysis and merge strategies
- **[GIT_WORKFLOW.md](GIT_WORKFLOW.md)** - Historical analysis of binary vs text approaches
- **[EXTENDING.md](EXTENDING.md)** - Database extension patterns