Architecture Skeleton Skill

Wave A で実行される高レベルアーキテクチャ設計スキル。 技術選定、システム境界、NFR方針を決定し、ADR として記録する。

実行タイミング: Wave A（database, design-inventory と並列）

前提条件

出力ファイル

依存関係

Wave A 契約出力

Blackboard に以下を登録する:

contract_outputs:
  - key: decisions.architecture.tech_stack
    value: ["Next.js", "PostgreSQL", "Prisma", ...]
  - key: decisions.architecture.boundaries
    value:
      - name: frontend
        type: SPA
        technology: Next.js
      - name: backend
        type: BFF
        technology: Node.js
      - name: database
        type: RDBMS
        technology: PostgreSQL
  - key: decisions.architecture.nfr_policies
    value:
      authentication:
        method: JWT
        algorithm: RS256
        access_token_ttl: 15m
        refresh_token_ttl: 7d
      error_format: RFC7807
      logging: structured_json
      monitoring: OpenTelemetry

ワークフロー

1. 要件（user-stories.md）を読み込み
2. NFR ポリシーを抽出・決定
3. アーキテクチャパターンを選定
4. 技術スタックを検証・詳細化
   4a. USER_APPROVED_TECH_STACK を確認
   4b. mode: auto → 従来通り自律選定
   4c. mode: specified → ユーザー指定を必須制約として採用
   4d. 未指定カテゴリ（空文字列）は自律選定で補完
   4e. 互換性検証（問題あれば needs_input で Lead に報告）
5. システム境界を定義
6. ADR を作成（ユーザー指定技術がある場合「ユーザー制約による選定」として記録）
7. architecture.md（高レベル）を生成
8. SendMessage で contract_outputs を Lead に送信

アーキテクチャパターン選定

注意: ユーザーが技術スタックを指定した場合（mode: specified）、そのスタックと最も相性の良いパターンを優先する。 例: ユーザーが Next.js を指定 → SPA + BFF パターンを優先。Django を指定 → MVC モノリスを検討。

NFR ポリシー決定項目

ADR テンプレート

### ADR-0001: アーキテクチャパターン選定

#### コンテキスト
[プロジェクト特性、要件からの制約]

#### 決定
[選定したパターン]

#### 理由
[選定理由、NFR との整合性]

#### 代替案
| 代替案 | 却下理由 |
|--------|----------|
| マイクロサービス | 初期フェーズでは過剰 |

#### 影響
[後続フェーズへの影響、制約]

NFR 測定可能性定義

各 NFR に対して、以下の3要素を定義する（IPA 非機能要求グレード準拠）:

定義テンプレート

データフロー: Phase 3a → Aggregator → Blackboard nfr_measurability → Phase 7 nonfunctional_test_plan.md → Phase 8 検証

SendMessage 完了報告

タスク完了時に以下の YAML 形式で Lead に SendMessage を送信する:

status: ok | needs_input
severity: null
artifacts:
  - docs/03_architecture/architecture.md
  - docs/03_architecture/adr.md
contract_outputs:
  - key: decisions.architecture.tech_stack
    value: [選定した技術スタック]
  - key: decisions.architecture.user_constraints
    value: {ユーザー承認済み技術スタック（mode, 各カテゴリ）をそのまま転記}
  - key: decisions.architecture.boundaries
    value: [定義したシステム境界]
  - key: decisions.architecture.nfr_policies
    value: {NFR ポリシー}
  - key: decisions.nfr_measurability
    value:
      NFR-PERF-001:
        target: "API応答時間 p95 < 200ms"
        measurement: "k6 負荷テスト"
        pass_criteria: "p95 < 200ms かつ p99 < 500ms"
      # 全 NFR-ID について定義
open_questions:
  - "キャッシュ戦略は Wave B（architecture-detail）で決定"
  - "具体的なインフラ構成は Wave B で決定"
blockers: []

注意: project-context.yaml には直接書き込まない（Aggregator の責務）。

エラーハンドリング