(テンプレート)パターン名|日本語名¶
一言で(TL;DR)¶
このパターンを一文〜数文で記述してください。何を、どんな確率的特性に対して、どう収めるのかを説明してください。
解決する問題¶
このパターンが無いと何が起きるかを述べてください。関係する設計力学(frontmatter の forces)を
設計力学 F1–F17 に紐づけて説明してください。
選定条件(When to use / When NOT)¶
意思決定層の中核です。 箇条書きでなく判断基準として書いてください。
- 使う条件:…
- 使わない条件(=代替に倒す):… → 代わりに 代替(例:
a1-sync-edge-agent.md)を検討してください。
可能なら可逆性×影響度などの2軸マトリクスや閾値で、機械的に判定できる形にしてください。
駆動変数とチューニング(程度)¶
このパターンが露出する「目盛り」を表で示してください。各行に効かなすぎ⇔効きすぎ、[駆動変数]、
目安値(出発点)を必ず入れてください。値は定数でなく駆動変数の関数として書いてください。
| 目盛り | 効かなすぎ ⇔ 効きすぎ | 決め方 [駆動変数] |
目安 |
|---|---|---|---|
| 例:チェックポイント頻度 | 作業消失 ⇔ I/O過多 | 副作用直前は必須 [reversibility] |
各ツール実行後 |
相反における立ち位置(相反)¶
このパターンが 相反カタログ のどのフォークで、どちら側に倒すものかを示してください。 その判定基準(どの駆動変数が効くか)を述べてください。
構造¶
flowchart LR
A[入力] --> B[このパターンの要素]
B --> C[出力]
実装メモ¶
最小実装、設定例、JSON/コード断片、よくある落とし穴を記載してください。SDK固有のAPIリファレンスには立ち入りません。
効かせる力学(forces)¶
frontmatter の各 force にどう効くかを1行ずつ記述してください。
関連・代替¶
- 関連:例:
a3-sync-facade-async-core.md(なぜ一緒に使うかを説明してください) - 代替:例:
a1-sync-edge-agent.md(どんな条件でこちらに倒すかを説明してください)
コーディングエージェント向け指示(machine-actionable)¶
このパターンを人間に提案するなら、同時に提案/確認すべきことをチェックリストで示してください。 例:
- [ ] このパターンを採るなら G1 二層観測 も併せて提案しましたか
- [ ] 目盛り(上表)の値を
[駆動変数]から導き、理由を添えて提示しましたか - [ ] 不可逆な副作用があるなら E1 リスクベース承認 を併置しましたか