Treatment Backend Planner (Treatment バックエンドプランナー)
これは 計画スキル であり、Codex、OpenCode、Claude Code 間で共有されます。検証済みのリポジトリ証拠に基づいてアクション可能な設計を生成します。計画モードでは、明示的に要求されない限り、アプリケーションコードを変更したり、マイグレーションを実行したりしないでください。
コンテキストの発見と検証
- 要求された成果、受け入れ基準、作業ブランチ、対象ブランチ（該当する場合）、および意図されたデプロイ環境を特定してください。
productionやdevelopmentといったブランチ名を推測しないでください。比較する前にgit statusと refs を確認してください。未コミットの作業を上書きしないでください。 - 関連する既存の製品/ビジネスドキュメント（ペルシャ語）および技術/品質ドキュメント（英語）が利用可能な場合は読んでください。不足している場合は、どのドキュメントが不足しているかを正確にフラグ付けしてください。ビジネス要件を発明しないでください。
- Graphify がインストールされており、該当する現在のグラフが利用可能な場合は、オプションで
graphify query、path、またはexplainを使用して方向性を確認してください。Graphify を必須にしないでください。 利用できないか古い場合は、関連するソース、マイグレーション、設定、テストを直接検索してください。グラフはヒントとして扱い、証拠としては扱わないでください。 - 実際のソースコードでクラス、コールサイト、権限、データフロー、設定、データベース制約、外部依存関係を検証してください。
- アクティブなプロジェクト設定とロックファイルから Python/Django/ランタイムのバージョンを特定してください。矛盾があれば報告してください。過去のフレームワークバージョンをハードコードしないでください。
- ブランチ比較には、ユーザーが指定した実際のソースと宛先 refs を使用してください。コミット履歴とワーキングツリーの変更を区別してください。ユーザーの認可やネットワークの可用性を考慮せずにリモート refs をフェッチしないでください。
アーキテクチャと変更影響のレビュー
- 所有アプリとその境界を特定し、不要な抽象化やクロスアプリ結合を避けてください。SOLID とクリーンレイヤリングを機械的ではなく実用的に適用してください。
- 公開 API コントラクト（ルート、シリアライザー、フィールドタイプ、ステータス/エラーフォーマット、ページネーション、フィルタリング）、フロントエンド/PWA との互換性、認証/認可/テナント分離を検証してください。
- ORM クエリコスト、N+1、トランザクションとロック、制約、並行性、データ一貫性、マイグレーション順序、およびリバーシビリティを分析してください。
- 非同期および外部影響（Celery のリトライと冪等性、
transaction.on_commit、キャッシュ無効化、Elasticsearch/インデックス同期、HTTP タイムアウトとエラー、SMS ゲートウェイ）を含めてください。 - 関連する場合、可観測性、セキュリティとシークレット、運用、ロールアウト、ロールバック、フィーチャーフラグ、デプロイ順序を分析してください。
- 検証済みの現在の動作、文書化された意図された動作、提案された変更、未解決の質問 を分離してください。不一致があれば明確に特定してください。
- テスタビリティと既存のテストインフラを考慮してください。定期的な自動テストでは、実際のサードパーティ/SMS/Celery ディスパッチを行わないでください。
必須出力
以下の内容を含む、意思決定完了済みの計画を生成してください。
- スコープ、目的、制約、受け入れ基準。
- 証拠と関連するソースパス、および使用したソース/ターゲットリビジョン。
- 現在のアーキテクチャ/データフローと提案されたアーキテクチャ/データフロー、コンポーネントの所有権を含む。
- 順序付けられた実装手順、影響を受ける公開インターフェース、互換性対策。
- 移行/バックフィル戦略、障害処理、可観測性、ロールアウトとロールバック（該当する場合）。
- リスクに比例した明示的なユニット/統合/API/E2E/スモークテスト（FireTest）、移行、セキュリティ、パフォーマンスのシナリオ。
- 必要なドキュメント更新と影響を受けるドキュメントページ。
- 不確実性、前提、トレードオフ、ブロックされた決定。必要な場合にのみ、対象を絞った質問をしてください。
スキルコラボレーション
treatment-django-engineerがこのスキルを呼び出した場合、最初に計画を返してください。エンジニアは実装、統合、最終報告を担当します。- 影響を受けるドキュメントを更新するために
django-product-documentationを、テストを実装するためにtreatment-backend-testingを推奨してください。ただし、これらのスキルが実際に見つかり、実際に呼び出された/読まれた場合を除き、実行したと主張しないでください。 - 依存するスキルが存在しない場合は、不足している依存関係を記録し、そのルールを捏造せずに使用可能なフォールバック計画を提供してください。
- このスキルは、軽微なタイプミスやフォーマット変更のたびに自動的に実行されるわけではありません。計画の労力を影響に合わせて調整してください。
譲れないセーフガード
ドメインポリシー、データモデル、文書化されていない API 動作、またはテスト結果を決して発明しないでください。無言での破壊的なデータベース操作、コミット、デプロイ、または無関係なファイルへの変更を行わないでください。実行および測定なしに、カバレッジ、ビルド、マイグレーション、または統合の成功を主張しないでください。