Skip to content

Latest commit

 

History

History
51 lines (40 loc) · 3.15 KB

AGENT-DASHBOARD.sample.md

File metadata and controls

51 lines (40 loc) · 3.15 KB

AGENT-DASHBOARD.md の見本

ルートの AGENT-DASHBOARD.md(git の管理外)の形。主のセッションが、最初に作るときに読む(AGENTS.md「作業の見える化」)。 人が、今の状況・頼まれていること・今聞かれている判断の材料を、会話を読まずに分かるようにする。

  • 書くのは主のセッションだけ。サブ エージェントの状況は、呼んだときと報告を受けたときに主が書く
  • 1 つのファイルにセッションごとの節。自分の節だけを、書く直前に読み直してから書き換える(ほかの節に触れない)
  • 書き直すのは:作業の始まりと終わり・サブ エージェントを呼んだときと報告を受けたとき・人に聞いたときと答えを受けたとき。 時刻はそのとき取る(Get-Date -Format 'yyyy-MM-dd HH:mm' など。後から推測で埋めない)
  • 終わったら自分の節を「終了」の形にする。次に始めたセッションは、終了した節を消す(人への依頼が残る節は消さずに人に確かめる)
  • 判断の記録の本体は、決定のレポート(docs/spec/…-decisions.md など)。ここは「今」だけを持ち、記録の本体を指す(二重に持たない)

動いている節の形

## <セッションの名前(作業の名前)>(開始 <yyyy-MM-dd HH:mm>)— <動いている / 人を待っている>

### 処理状況(<更新した時刻>)
| 誰 | 役・モデル | 今の作業 | 状態 | 始めた時刻 |
| --- | --- | --- | --- | --- |
| 主 | <モデル ID> | <例:ケース 2 の段 1。実装役の報告を待つ> | 待っている | <HH:mm> |
| 実装役 | <役の名前>(<モデル ID>) | <例:テスト仕様を書く> | 動いている | <HH:mm> |
| レビュー役 | <役の名前>(<モデル ID>) | <例:段 1 の 2 往復目> | 終わった(承認) | <HH:mm> |

### 人への依頼
| # | 何を | なぜ | どう答えるか(返す文面) | いつから |
| --- | --- | --- | --- | --- |
| 1 | <例:仕様の決定記録をコミットする> | <例:DEC-ORD-11 を案として書いた> | <例:「決定記録を <版> でコミットしました。続けて下さい。」> | <HH:mm> |

無ければ「なし」。

### 今の意思決定(対話で聞いている間だけ)
- 記録の本体:<決定のレポートのパス> の <決定 N>
- 背景:<関係する仕様の本文・決定記録の文の引用。なぜ問いになるか>
- 問い:<1 文>
- 選択肢と結果:
  1. <選択肢>:<利用者に見えること・テストの期待・ほかへの影響・手間>
  2. <選択肢>:<同上>
- 推奨と理由:<ほかの選択肢と比べて>

聞いていなければ、この見出しごと消す。

終了した節の形

## <セッションの名前>(開始 <yyyy-MM-dd HH:mm>)— 終了 <yyyy-MM-dd HH:mm>
- 結果:<1 行。例:ケース 2 を完了。コミット aaf47f1>
- 残った人への依頼:<無ければ「なし」。あれば上の表の形で>