コンテンツにスキップ

(テンプレート)パターン名|日本語名

一言で(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 リスクベース承認 を併置しましたか