# Beads

> このプロジェクトの bd (beads) タスク管理のコンセプト・ルール・ワークフロー全体を定義する

- Skill: `d-kimuson/beads` (Agent Skill)
- Install (CLI): `npx skillmds@latest add d-kimuson/beads`
- Raw SKILL.md: https://api.skillmd.com/api/skills/d-kimuson/beads/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: d-kimuson (https://skillmd.com/u/d-kimuson)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/d-kimuson/beads

---


このプロジェクトの bd (beads) タスク管理の共通知識。

## ロールモデル

| ロール | 担い手 | 責務 |
|--------|--------|------|
| pdm | AI | タスク管理・分解・AC設定・依存設計 |
| dev | AI | 実装・テスト・コミット |
| architect | AI | 設計判断・レビュー |
| po / user | kimuson | 要件定義・AC合意・動作確認 |

## Issue の型 (type)

すべての issue は同じ ID 体系 (`<prefix>-xxx`) を持つ。

| type | 用途 |
|------|------|
| task | 作業全般（機能追加・バグ以外） |
| bug | バグ修正 |
| feature | ユーザーに見える新機能 |
| epic | 複数 issue をまとめる親 |
| chore | メンテナンス・依存更新・ドキュメント等 |
| gate | 実装後の確認チェックポイント |
| merge-request | PR に対応する issue |

`molecule / agent / role / convoy / event` は bd 内部構造用。通常の開発では使わない。

## Assignee ルール

| assignee | 意味 |
|----------|------|
| なし (unassigned) | dev (AI) が `bd ready --unassigned` で自動取得・実装 |
| `kimuson` | kimuson 専任。AI はスキップする |

## Issue の必須メタデータ

`gate` を除くすべての issue (task / bug / feature) には以下が必要:

**description:**
```
## AC (Acceptance Criteria)
- [ ] <具体的な完了条件>
```

**ラベル:** `gate:required` または `gate:not-required` を付与する。
`gate:required` の場合は description に確認観点も記載する。

**gate 要否の判断基準:**

| 条件 | gate |
|------|------|
| ユーザーに見える挙動の変更（機能追加・UI変更・外部挙動に変わるバグ修正） | required |
| 内部実装のみ・テストで担保可能（リファクタ・型修正・内部バグ修正） | not-required |

## AC の決め方

- **PdM が決めてよい**: 実装詳細・内部構造・テスト戦略
- **kimuson と合意が必要**: ユーザーに見える機能で設計選択肢が複数あるもの

→ kimuson 合意が必要な場合は **AC合意タスク → 本体** の依存構造にする:

```bash
# AC合意タスク (kimuson 専任)
AC_ID=$(bd q --title="[AC合意] <本体タイトル>" --type=task --assignee=kimuson \
  --description="<選択肢と決めるべきこと>")

# 本体
MAIN_ID=$(bd q --title="<本体タイトル>" --type=feature \
  --labels "gate:required" ...)

# 本体が AC合意タスクに依存（AC合意が終わるまで本体は ready に出ない）
bd dep add "$MAIN_ID" "$AC_ID"
```

## ワークフロー概要

```
1. [pdm]       teams:pdm           → issue 起票・AC設定・依存設計
2. [dev]       teams:dev-auto|colab → bd ready --unassigned から実装
3. [dev]       実装完了              → gate:required なら gate issue 作成
4. [po]        teams:gates-review   → kimuson が動作確認し結果を返す
5. [pdm]       teams:gates-review   → OK なら close、NG なら note + タスク open に戻す
6. [architect] teams:architect      → 定期レビュー → pdm が issue 化
```

## コマンド一覧

| コマンド | 用途 |
|----------|------|
| `teams:pdm` | issue 起票・整理・依存設計 |
| `teams:dev-auto` | 自律実装。ユーザー確認なし |
| `teams:dev-colab` | 協働実装。kimuson に確認しながら進む |
| `teams:gates-review` | gate 確認サマリー出力 + kimuson の結果処理 |
| `teams:architect` | アーキテクチャレビュー + CODING_GUIDELINE.md + Lint更新 |