Files

T

beads/crew/dave f03c754df1 refactor: move Claude Code plugin to dedicated subdirectory (GH#985)

Move all plugin content to claude-plugin/ subdirectory for cleaner
separation from core beads functionality:

- claude-plugin/.claude-plugin/plugin.json - plugin manifest
- claude-plugin/commands/ - all slash commands
- claude-plugin/agents/ - task-agent (now in correct location)
- claude-plugin/skills/beads/ - beads skill with resources

Root .claude-plugin/ now only contains marketplace.json pointing
to ./claude-plugin.

Note: After updating, users may need to clear plugin cache:
  rm -rf ~/.claude/plugins/cache/beads-marketplace/

Fixes #985

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Executed-By: beads/crew/dave
Rig: beads
Role: crew

2026-01-09 22:59:11 -08:00

1.7 KiB

Raw Blame History

ADR-0001: Use bd prime as CLI Reference Source of Truth

Status

Accepted

Context

The beads skill maintained CLI reference documentation in multiple locations:

SKILL.md inline (~2,000+ words of CLI reference)
references/CLI_REFERENCE.md (~2,363 words)
Scattered examples throughout resource files

This created:

Duplication: Same commands documented 2-3 times
Drift risk: Documentation can fall behind bd versions
Token overhead: ~3,000+ tokens loaded even for simple operations

Meanwhile, bd provides bd prime which generates AI-optimized workflow context automatically.

Decision

Use bd prime as the single source of truth for CLI commands:

SKILL.md contains only value-add content (decision frameworks, cognitive patterns)
CLI reference points to bd prime (auto-loaded by hooks) and bd --help
Resources provide depth for advanced features (molecules, agents, gates)

Consequences

Positive

Zero maintenance: CLI docs auto-update with bd versions
DRY: Single source of truth
Accurate: No version drift possible
Lighter SKILL.md: ~500 words vs ~3,300

Negative

Dependency on bd prime format: If output changes significantly, may need adaptation
External tool requirement: Skill assumes bd is installed

Implementation

Files restructured:

SKILL.md — Reduced from 3,306 to ~500 words
references/ → resources/ — Directory rename for consistency
New resources added: agents.md, async-gates.md, chemistry-patterns.md, worktrees.md
Existing resources preserved with path updates

Claude Code skill progressive disclosure guidelines
Similar pattern implemented in other Claude Code skill ecosystems

Date

2025-01-02

1.7 KiB Raw Blame History