d-kimuson このプロジェクトの 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合意タスク → 本体 の依存構造にする:
# 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更新 |