technical-integrations

技術的なインテグレーション

目的

既存の内部パターンを使用して外部ベンダーとのインテグレーションを設計・レビューし、API、RFC、SDK、ロールアウト計画において、ベンダーやフレームワークに依存しないワークフローを実現します。

使用する場面

• 新しいサードパーティまたはベンダーとのインテグレーションを追加する場合。
• 互換性を損なわずに既存のインテグレーションの範囲を拡張する場合。
• 実装前にインテグレーションの RFC を作成またはレビューする場合。
• SDK/API のインテグレーションポイントと提供計画を定義する場合。

ワークフロー

1. モードを discover、design、review、implementation-plan のいずれかに分類します。
2. references/hunt-and-inventory.md を実行し、現在のインテグレーションに関する根拠とパターンを収集します。
3. references/principles.md を使用して、ベンダーやフレームワークに依存しない制約を適用します。
4. アーキテクチャと提案の作業では、references/design-and-rfc.md に従います。
5. 実行順序の策定では、references/implementation-plan.md に従います。
6. QA パスでは、references/review-checklist.md を適用します。
7. 明確な判断、トレードオフ、未解決のリスクを含めて成果物を提示します。

フロー

stateDiagram-v2
    [*] --> ClassifyRequest
    ClassifyRequest --> HuntAndInventory
    HuntAndInventory --> ApplyPrinciples
    ApplyPrinciples --> SelectWork
    state SelectWork <<choice>>
    SelectWork --> Deliverables: discovery only
    SelectWork --> DesignAndRFC: architecture or proposal
    SelectWork --> ImplementationPlan: execution sequencing
    SelectWork --> ReviewChecklist: review
    DesignAndRFC --> ReviewChecklist: QA pass in scope
    DesignAndRFC --> Deliverables: proposal only
    ImplementationPlan --> ReviewChecklist: QA pass in scope
    ImplementationPlan --> Deliverables: plan only
    ReviewChecklist --> Deliverables
    Deliverables --> [*]

入力

• インテグレーションの目的と対象ベンダーの機能。
• 既存のリポジトリのパターン（API、SDK、認証、可観測性、エラーモデル）。
• 互換性の制約（後方互換性、バージョニング、ロールアウトポリシー）。
• スコープ（調査のみ、RFC の草案、実装計画、または全体レビュー）。

出力

• インテグレーションの棚卸しとパターンの基準。
• 選択肢と判断理由を含む、RFC 品質の提案。
• API と SDK のインテグレーション設計計画。
• 未解決のリスクを含む、検証およびロールアウトのチェックリスト。