create-ai-project 1.21.0 → 1.22.1

package/.claude/skills-en/project-context/references/template.md

@@ -0,0 +1,154 @@
+# Project Context Section Catalog
+
+This file is the section catalog used by `/project-inject`. Consumer agents load `SKILL.md` only; this file is loaded only during update operations.
+
+## Section Index
+
+| Section | Inclusion Rule | Source of Hearing Questions |
+|---------|----------------|-----------------------------|
+| Project Overview | Always include | This file (below) |
+| Domain Constraints | Include when at least one rule changes AI decisions | This file (below) |
+| Development Phase | Include when phase materially changes AI behavior (e.g., suppresses test scaffolding for prototype) | This file (below) |
+| Directory Conventions | Include when non-obvious file placement rules exist | This file (below) |
+| External Resources | Include when the project depends on resources outside the repository (design source, schema source, secret store, IaC source, etc.) | `external-resources-{frontend,backend,api,infra}.md` (load only the domains relevant to the project) |
+
+## Section Definitions
+
+### Project Overview
+
+**Inclusion**: Always.
+
+**Hearing**:
+- AskUserQuestion 1: "What does this project do? (1–2 sentences)"
+- AskUserQuestion 2: "What domain does it belong to?" with concrete option examples drawn from common categories (e.g., developer tooling, fintech, healthcare, e-commerce, internal platform). Always include "Other".
+
+**Output structure**:
+```markdown
+## Project Overview
+- **What this project does**: <one to two sentences>
+- **Domain**: <domain>
+```
+
+### Domain Constraints
+
+**Inclusion**: Include when at least one constraint, if ignored, would cause a bug or compliance failure.
+
+**Hearing**:
+- AskUserQuestion: "Are there domain-specific rules that AI must follow when making decisions in this project?" Options: "Yes, I will list them" / "No, no domain constraints apply".
+- When "Yes": for each rule (cap at 3), capture the rule statement plus a measurable check. Accept statements only when they evaluate as pass/fail; reframe subjective phrasings into measurable form (e.g., turn "be careful with PII" into "log output uses anonymized patient IDs").
+- Adapt example phrasings to the domain captured in Project Overview (e.g., for fintech: "every monetary mutation appends an audit log entry"; for developer tooling: "generated code keeps lockfile commands invocable").
+
+**Output structure** (omit the section entirely when zero constraints):
+```markdown
+## Domain Constraints
+1. <measurable rule 1>
+2. <measurable rule 2>
+3. <measurable rule 3>
+```
+
+### Development Phase
+
+**Inclusion**: Include when phase materially changes AI behavior. Skip when behavior is identical across phases.
+
+**Hearing**:
+- AskUserQuestion: "Which phase is this project in?" Options: "Prototype", "Production", "In operation", "No meaningful difference between phases".
+- When "No meaningful difference": omit the section.
+
+**Output structure**:
+```markdown
+## Development Phase
+- **Phase**: <Prototype | Production | In operation>
+```
+
+### Directory Conventions
+
+**Inclusion**: Include when at least one file placement rule is non-obvious from the repository structure (i.e., a contributor reading the tree would guess wrong).
+
+**Hearing**:
+- AskUserQuestion: "Are there file placement rules that AI should follow?" Options: "Yes" / "No".
+- When "Yes": capture each rule as a single line stating the trigger and the destination (e.g., "Temporary working files: place under `./tmp/` and remove on completion").
+
+**Output structure** (omit the section entirely when zero rules):
+```markdown
+## Directory Conventions
+- <rule 1>
+- <rule 2>
+```
+
+### External Resources
+
+**Inclusion**: Include the section when at least one selected domain has a present axis OR a non-empty self-declaration. Otherwise omit the section.
+
+**Hearing routing**:
+- AskUserQuestion: "Which external-resource domains apply to this project?" Multi-select options:
+  - Frontend (design source, design system, guidelines, visual verification environment)
+  - Backend (database schema, migration history, secret store, background jobs)
+  - API contract (schema source, mocks, authentication, schema change process)
+  - Infrastructure (IaC source, environment configuration, infrastructure secrets, deployment trigger)
+  - None apply
+- For each selected domain, load the matching reference file using the slug map below and run its hearing protocol.
+
+**Domain to file slug mapping**:
+| Domain (user-facing label) | Reference file |
+|---------------------------|----------------|
+| Frontend | `external-resources-frontend.md` |
+| Backend | `external-resources-backend.md` |
+| API contract | `external-resources-api.md` |
+| Infrastructure | `external-resources-infra.md` |
+
+**Hearing protocol** (per domain reference): each reference defines structured axes plus a self-declaration phase. The structured phase asks one AskUserQuestion per axis, offering "Not applicable" as one explicit choice. The self-declaration phase always runs once, asking for free-form additions, regardless of how the structured choices landed.
+
+**Per-axis output schema** (3 fields):
+```markdown
+#### <Axis name>
+- Source type: <verbatim text of the AskUserQuestion choice the user selected>
+- Location: <URL | file path | service or package name>
+- Access method: <WebFetch | file read | MCP server name | CLI command | manual procedure>
+```
+
+**Axis output rules**:
+
+1. **Axis output is conditional on whether the schema can be filled.** Render the axis block when the user's choice points to an external resource with identifiable **Location** and **Access method** values. The following choices produce zero output lines for that axis:
+   - Listed absence-declaring choices: "Not applicable", "No <resource>", "No <resource> required", "No documented <resource>", "Ad-hoc <resource>", "Manual <process> (no <resource>)".
+   - Any other choice whose Location and Access method values resolve to blank.
+
+2. **Multiple instances within one axis** (e.g., primary and analytics databases, separate guideline files for CSS and accessibility) — repeat the axis block with a disambiguating suffix:
+   ```markdown
+   #### Database Schema Source — Primary
+   - Source type: Schema file in the repository
+   - Location: prisma/schema.prisma
+   - Access method: file read
+
+   #### Database Schema Source — Analytics
+   - Source type: Database MCP server that introspects a live database
+   - Location: bigquery-prod
+   - Access method: MCP server `bigquery`
+   ```
+
+3. **Cross-axis reference** (e.g., the same secret store appears under both Backend and Infrastructure) — the first occurrence carries the canonical fields; the second occurrence renders as a reference back to it:
+   ```markdown
+   #### Secrets in Infrastructure
+   - Source type: Secrets sourced from a secret manager via IaC data lookup
+   - Reference: same store as Backend > Secret Store
+   - Access method: <inherited; record only differences if any>
+   ```
+
+**Domain block layout**:
+```markdown
+### <Domain>
+
+<axis blocks in catalog order, each rendered per the rules above>
+
+#### Additional Resources
+
+<rendered only when self-declaration captured items; placed after the last present axis within the same domain>
+- <free-form description from user>
+```
+
+## Output Assembly Rules
+
+After hearing completes, the calling command (`/project-inject`) assembles the configured `SKILL.md` per the order it specifies. This file owns the per-section content shape (above) and these cross-section rules:
+
+1. Sections marked for omission produce zero output lines. The rebuilt body advances directly to the next included section.
+2. Domain blocks within External Resources appear in catalog order (Frontend → Backend → API contract → Infrastructure), regardless of the order in which the user selected them during hearing.
+3. The Vagueness rejection rule (defined in `/project-inject` Step 3) is a hearing-time filter applied to every `add` and `update` section. The captured rules that pass the filter are written through normal section output; the filter contributes zero output lines of its own.

package/.claude/skills-en/task-analyzer/references/skills-index.yaml

@@ -95,11 +95,6 @@ skills:
     size: small
     key-references:
       - "Project-specific (empirical)"
-    sections:
-      - "Project Overview"
-      - "Domain Constraints"
-      - "Development Phase"
-      - "Directory Conventions"
 
   documentation-criteria:
     skill: "documentation-criteria"

package/.claude/skills-ja/coding-standards/SKILL.md

@@ -29,6 +29,7 @@ description: コードの品質問題、アンチパターン、可読性を検
 
 - **積極的なリファクタリング** - 技術的負債を防ぎ、健全性を維持
 - **使われない「念のため」のコード禁止** - YAGNI原則（Kent Beck）に反する
+- **Minimum Surface for Required Coverage** - 保守対象の要素（永続状態、公開コントラクト要素または境界を越えるフィールド/Props、振る舞いモード/フラグ/バリアント、再利用可能な抽象、コンポーネント分割）を導入する場合、現在のユーザー観察可能な要件と受容済み技術制約（監査、データ整合性、互換性、セキュリティ、パフォーマンス、アクセシビリティ）をカバーする最小の設計面を選ぶ。採用の正当化は「より小さい代替案では満たせない現要件・制約を名指す」形で行い、価値ベースの議論（再利用可能、将来対応、実装が楽）はタイブレーカーのみに用いる。YAGNI との違い: YAGNI は時間軸の判断（将来のためだけの作業はしない）、本原則は固定されたカバレッジ点での設計面を制約する。
 
 ## コメント記述ルール
 

package/.claude/skills-ja/documentation-criteria/SKILL.md

@@ -120,6 +120,7 @@ description: PRD、ADR、Design Doc、UI Spec、作業計画書の作成を支
 - **コード調査エビデンス**（調査時に確認したファイル/関数）
 - **フィールド伝播マップ**（フィールドがコンポーネント境界を越える場合）
 - **データ構造の採用判断**（新規構造導入時）
+- **Minimal Surface Alternatives**（永続状態、公開コントラクト要素または境界を越えるフィールド、振る舞いモード/フラグ、再利用可能な抽象/コンポーネント分割を導入する場合 — design-template.md の5ステップ出力フォーマットを参照）
 - **適用基準**（explicit/implicit分類）
 - **前提となるADR**（共通ADR含む）
 - **検証戦略**（必須）

package/.claude/skills-ja/documentation-criteria/references/design-template.md

@@ -185,6 +185,49 @@ unknowns:
 
 **判断**: [再利用 / 拡張 / 新規] — [根拠]
 
+### Minimal Surface Alternatives（保守対象の要素を導入する場合）
+
+新規に導入する適用対象要素（永続状態 / 公開コントラクト要素または境界を越えるフィールド・Props / 振る舞いモード・フラグ・バリアント / 再利用可能な抽象またはコンポーネント分割）ごとに1エントリ。設計者エージェントが実行した5ステップの結果を記録する。参照: `coding-standards` スキル「Minimum Surface for Required Coverage」。
+
+#### Element 1: [新規要素の名前]
+
+**ステップ1 — 確定要件**
+- [AC 参照 — AC ID、AC見出し、EARS節、または制約ID]: [要件・制約の文言]
+- [AC 参照]: [要件・制約の文言]
+
+参照先は Design Doc、参照 PRD、参照 UI Spec のいずれでもよい。
+
+**ステップ2〜3 — 比較した代替案**
+
+下記の列名は設計コンテキストに合わせて適用する。バックエンド Design Doc では「モジュール/サービス境界を越えるか」「新規の概念 / モード / フラグ」を使用、フロントエンド Design Doc では「コンポーネント境界を越えるか」「新規の Props / モード / バリアント」を使用（永続状態列には「クライアントまたはサーバー」の修飾を加える）。
+
+| 代替案 | カバーする現要件（AC 参照） | 新規の永続状態（件数） | 新規の概念 / モード / フラグ / Props / バリアント（件数） | モジュール/サービスまたはコンポーネント境界を越えるか（はい/いいえ） | 破壊的変更または移行が必要か（はい/いいえ） | 主観的コストノート |
+|---|---|---|---|---|---|---|
+| [提案された追加要素そのもの] | | | | | | |
+| [削減的代替案 — 既存から導出 / オンデマンド計算 / 呼び出し側に留める / 既存を再利用 / 新規状態を導入しない] | | | | | | |
+| [任意の第3案] | | | | | | |
+
+主観的コストノートに記載できる内容: 保守性の懸念、命名の分かりやすさ、体感的な実装労力、将来対応への期待、その他の判断レベルのコメント。
+
+**「最小」選定のための解決優先順位**（左の列が同点のとき右の列でタイブレーク）:
+1. 新規の永続状態の件数（少ない＝小さい）
+2. モジュール/サービスまたはコンポーネント境界を越えるか（いいえ＝小さい）
+3. 新規の概念 / モード / フラグ / Props / バリアントの件数（少ない＝小さい）
+4. 破壊的変更または移行の要否（いいえ＝小さい）
+5. 主観的コストノート
+
+**ステップ4 — 選定した代替案と根拠**
+- **選定**: [代替案の名前]
+- **根拠**:
+  - 選定が検討した中で最小の代替案である場合: 「検討した中で最小の代替案であり、これ以上の縮減余地なし」と記載
+  - 選定が最小でない場合: ステップ1から、より小さい代替案では満たせない現要件を名指す
+
+**ステップ5 — 不採用案の記録**
+- [代替案の名前]: [何だったか・なぜ不採用かを1〜2行]
+- [代替案の名前]: [何だったか・なぜ不採用かを1〜2行]
+
+新規に導入する各適用対象要素について上記のエレメントブロックを繰り返す。適用対象要素を導入しない場合は、本セクション全体を簡潔な理由とともに N/A とする。
+
 ### 型定義
 
 ```typescript
@@ -357,6 +400,16 @@ unknowns:
 - **デメリット**: [欠点]
 - **不採用理由**: [採用しなかった理由]
 
+## 将来の拡張性
+
+本セクションは現在の設計面から**除外した**機能・能力を記録する。エントリは現要件、現在のコンシューマー、または記録された制約に結び付くものに限定し、純粋な将来構想は別途の提案ドキュメントに送る。
+
+「Minimal Surface Alternatives → ステップ5（不採用案）」との区別: ステップ5 は単一の適用対象要素内で比較・棄却した要素レベルの代替案を記録する。本セクションは個別の要素に結び付かない、より粒度の大きな能力レベルの項目（検討したが今回の設計面に含めなかった機能や能力）を記録する。
+
+- **先送りした機能・能力**: [設計時に検討したが現在の設計面から明示的に除外した機能・能力。各エントリには、これが満たしたはずの現要件を名指して記載する]
+- **意図的な限定**: [意図的に小さく抑えた範囲とその理由]
+- **拡張ポイント（既存・現在のコンシューマーあり）**: [現在のコンシューマーがすでに利用している既存のインターフェースやフック。各エントリには現在のコンシューマーを名指して記載する]
+
 ## リスクと対策
 
 | リスク | 影響度 | 発生確率 | 対策 |

package/.claude/skills-ja/project-context/SKILL.md

@@ -1,21 +1,8 @@
 ---
 name: project-context
-description: AIの実行精度に必要なプロジェクト固有の前提情報を提供。プロジェクト構成確認時に使用。
+description: AIの実行精度に必要なプロジェクト固有の前提情報を提供 — ドメイン制約、開発フェーズ、ディレクトリ規約、外部リソースのアクセス方法。セッション開始時、プロジェクト構成確認時、またはタスクがドメインルールやリポジトリ外の外部リソースを参照する時に使用。
 ---
 
 # プロジェクトコンテキスト
 
-> **未設定。** `/project-inject`を実行してプロジェクト固有のコンテキストを設定してください。
-
-## プロジェクト概要
-- **このプロジェクトが何をするか**: （要設定）
-- **ドメイン**: （要設定）
-
-## ドメイン制約
-（AIの判断に影響するドメイン固有のルール）
-
-## 開発フェーズ
-- **フェーズ**: （プロトタイプ / 本番開発 / 運用中）
-
-## ディレクトリ規約
-（ファイル配置ルールがあれば記載）
+`/project-inject` を実行してこのスキルを設定する。

package/.claude/skills-ja/project-context/references/external-resources-api.md

@@ -0,0 +1,76 @@
+# APIコントラクト外部リソース軸
+
+API コントラクト設計、クライアント統合、サーバーエンドポイント実装に関する作業向けのヒアリング軸。`/project-inject` はユーザーが API ドメインを選択したときにこのファイルを読み込む。
+
+## Axis 1: API スキーマソース
+
+API コントラクト（リクエスト/レスポンス形状、エンドポイント、RPC メソッド）の正本となる取得元。
+
+**AskUserQuestion 選択肢**:
+- OpenAPI / Swagger 仕様（リポジトリ内ファイルまたはホストされた URL）
+- Protobuf 定義（リポジトリ内ファイル）
+- GraphQL スキーマ（SDL ファイルまたはイントロスペクションエンドポイント）
+- リポジトリ内のコードファースト契約定義（例: クライアントとサーバー間で共有される TypeScript 型）
+- アドホックな JSON（正式なコントラクトなし）
+- 該当なし
+
+**フォローアップ（軸が該当する場合）**: 2 つのフィールドを収集する:
+- **場所**: ファイルパスまたは URL。
+- **アクセス方法**: ファイル読み込みまたは WebFetch。
+
+複数のコントラクトが併存する場合（公開 API、内部サービス等）、`template.md` の複数インスタンスルールに従ってコントラクトの用途を識別接尾辞として各エントリを収集する。
+
+## Axis 2: モック環境
+
+ライブサーバーから独立した状態でクライアントが API を実行する手段。
+
+**AskUserQuestion 選択肢**:
+- スキーマから生成されたモック（例: OpenAPI / Protobuf ツールチェーンから）
+- リポジトリ内の手書きモックサーバー
+- ホスト型モックサービス（URL）
+- ライブ開発サーバー（独立したモックなし）
+- 該当なし
+
+**フォローアップ（軸が該当する場合）**: 2 つのフィールドを収集する:
+- **場所**: モックの URL またはリポジトリパス。
+- **アクセス方法**: CLI コマンド、WebFetch、または生成ステップ名。スキーマ変更時にモックが自動更新されるかも記録する（例: `commit 時に openapi.yaml から再生成`）。
+
+## Axis 3: 認証方式
+
+API がリクエストをどのように認証・認可するか。
+
+**AskUserQuestion 選択肢**:
+- 認証サービスが発行する Bearer トークン（例: JWT）
+- ヘッダーまたはクエリパラメータの API キー
+- 別途のログインフローで設定されるセッション Cookie
+- 相互 TLS
+- 認証なし
+- 該当なし
+
+**フォローアップ（軸が該当する場合）**: 2 つのフィールドを収集する:
+- **場所**: 開発・テスト用の認証情報を取得する認証サービス URL、環境変数名、またはフィクスチャファイルパス。
+- **アクセス方法**: SDK 呼び出し、CLI コマンド、またはファイル読み込み。
+
+同一のシークレットがバックエンドのシークレットストアに格納されている場合、この軸は `template.md` で定義される軸間参照記法でそのストアへの参照として出力する。
+
+## Axis 4: スキーマ変更プロセス
+
+破壊的変更と非破壊的変更がどのようにレビュー・展開されるか。
+
+**AskUserQuestion 選択肢**:
+- 文書化されたコントラクトレビュープロセス（ドキュメントへのリンク）
+- バージョン分けされたエンドポイント（例: `/v1/`、`/v2/`）
+- 後方互換のある変更のみ、正式なバージョニングなし
+- 該当なし
+
+**フォローアップ（軸が該当する場合）**: 2 つのフィールドを収集する:
+- **場所**: ドキュメントパスまたは URL。
+- **アクセス方法**: ファイル読み込み、WebFetch、またはバージョン交渉ルールの記述（例: `破壊的変更には新しい /vN/ パスが必要`）。
+
+## 自己申告フェーズ
+
+4 つの構造化軸の後、1 回だけ尋ねる: 「構造化された質問の範囲を超えて、このプロジェクトが依存する API 外部リソースは何か？ 該当する項目を次のメッセージで列挙、または 'none' と返答する。」
+
+自由記述の回答は API ブロックの「追加リソース」サブセクションに収集する。このフェーズは構造化軸が全て「該当なし」となった場合でも実行する。
+
+自己申告でのみ表面化するリソースの例: レートリミット設定、API 前段のゲートウェイ / プロキシ、コントラクトテストスイート（例: Pact ブローカー URL）、API ゲートウェイの管理コンソール、設計時に参照したサードパーティ API ドキュメント。

package/.claude/skills-ja/project-context/references/external-resources-backend.md

@@ -0,0 +1,76 @@
+# バックエンド外部リソース軸
+
+サーバーサイド、データ、ストレージに関する作業向けのヒアリング軸。`/project-inject` はユーザーがバックエンドドメインを選択したときにこのファイルを読み込む。
+
+## Axis 1: データベーススキーマソース
+
+データベーススキーマ（テーブル、カラム、インデックス、制約）の正本となる取得元。
+
+**AskUserQuestion 選択肢**:
+- リポジトリ内のマイグレーションファイル（例: `migrations/` ディレクトリ）
+- リポジトリ内のスキーマファイル（例: `schema.sql`、`prisma/schema.prisma`）
+- ライブ DB を introspect する DB MCP サーバー
+- 外部のスキーマレジストリ（URL またはホスト型カタログ）
+- 永続データベースなし
+- 該当なし
+
+**フォローアップ（軸が該当する場合）**: 2 つのフィールドを収集する:
+- **場所**: ファイルパス、URL、または MCP の対象識別子。
+- **アクセス方法**: ファイル読み込み、WebFetch、または MCP サーバー名。
+
+複数の DB が併存する場合（primary、analytics、cache 等）、`template.md` の複数インスタンスルールに従って DB 用途を識別接尾辞として各エントリを収集する。
+
+## Axis 2: マイグレーション履歴
+
+スキーマ変更が時系列でどのように追跡されるか。
+
+**AskUserQuestion 選択肢**:
+- リポジトリ内のバージョン管理されたマイグレーションファイル
+- ORM 管理のマイグレーションツール（例: Alembic、Flyway、Prisma Migrate）
+- 手動の変更ログドキュメント
+- マイグレーション追跡なし
+- 該当なし
+
+**フォローアップ（軸が該当する場合）**: 2 つのフィールドを収集する:
+- **場所**: ディレクトリパスまたはマイグレーションツール名。
+- **アクセス方法**: 手動実行の CLI コマンド、または自動適用される場合の CI ステップ名 / デプロイフック名。
+
+## Axis 3: シークレットストア
+
+認証情報、API キー、その他のシークレットの保存・アクセス先。
+
+**AskUserQuestion 選択肢**:
+- シークレットマネージャーサービス（例: AWS Secrets Manager、Vault、GCP Secret Manager）
+- `.env` ファイルから読み込む環境変数（開発環境のみ）
+- リポジトリ内の暗号化されたファイル
+- シークレットは不要
+- 該当なし
+
+**フォローアップ（軸が該当する場合）**: 2 つのフィールドを収集する:
+- **場所**: シークレットマネージャーのサービス名または MCP の対象。
+- **アクセス方法**: シークレットを読むための MCP サーバー名、CLI コマンド、または SDK 呼び出し。
+
+実際のシークレット値はストア内に存在し、ランタイムでそこから読み出す。収集対象は到達手段のみとする。
+
+## Axis 4: バックグラウンドジョブ基盤
+
+非同期処理がどのようにディスパッチ・観測されるか。
+
+**AskUserQuestion 選択肢**:
+- キューサービス（例: SQS、Pub/Sub、RabbitMQ）
+- デプロイプラットフォームが管理する cron / スケジュールタスク
+- プロセス内ワーカースレッド
+- バックグラウンド処理なし
+- 該当なし
+
+**フォローアップ（軸が該当する場合）**: 2 つのフィールドを収集する:
+- **場所**: キュー名またはスケジューラー識別子。
+- **アクセス方法**: enqueue コマンド、ジョブ確認コマンド、またはプラットフォームのコンソール URL。
+
+## 自己申告フェーズ
+
+4 つの構造化軸の後、1 回だけ尋ねる: 「構造化された質問の範囲を超えて、このプロジェクトが依存するバックエンド外部リソースは何か？ 該当する項目を次のメッセージで列挙、または 'none' と返答する。」
+
+自由記述の回答はバックエンドブロックの「追加リソース」サブセクションに収集する。このフェーズは構造化軸が全て「該当なし」となった場合でも実行する。
+
+自己申告でのみ表面化するリソースの例: サードパーティ SaaS API（決済、メール、検索インデックス）、分散キャッシュサービス（Redis、Memcached）、オブジェクトストレージ（S3、GCS）、サーバー側で消費されるフィーチャーフラグサービス、可観測性プラットフォーム（ログ、トレース、メトリクス）。

package/.claude/skills-ja/project-context/references/external-resources-frontend.md

@@ -0,0 +1,74 @@
+# フロントエンド外部リソース軸
+
+フロントエンド作業（コンポーネント実装、画面設計、表示調整、デザインシステム移行）向けのヒアリング軸。`/project-inject` はユーザーがフロントエンドドメインを選択したときにこのファイルを読み込む。
+
+## Axis 1: デザインソース
+
+ビジュアル仕様の正本となる取得元。
+
+**AskUserQuestion 選択肢**:
+- デザインツール（ホスト型のデザインプラットフォーム）
+- リポジトリ内の仕様ファイル（例: `DESIGN.md`、`docs/design/...`）
+- 公開ドキュメントの URL
+- 既存実装のみ（独立したデザインソースなし）
+- 該当なし
+
+**フォローアップ（軸が該当する場合）**: 2 つのフィールドを収集する（ソースタイプは上記の選択肢から自動取得）:
+- **場所**: 公開 URL、リポジトリ内ファイルパス、または MCP の対象識別子。
+- **アクセス方法**: WebFetch、ファイル読み込み、MCP サーバー名、または手動スクリーンショット手順。
+
+## Axis 2: デザインシステム
+
+再利用可能なコンポーネントライブラリとデザイントークン。
+
+**AskUserQuestion 選択肢**:
+- MCP サーバー経由でアクセスするコンポーネントライブラリ
+- ドキュメント URL を持つコンポーネントライブラリ
+- Storybook 等価のコンポーネントカタログ
+- チーム内ドキュメントのみを持つ社内パッケージ
+- デザインシステムなし（アドホックなコンポーネント）
+- 該当なし
+
+**フォローアップ（軸が該当する場合）**: 2 つのフィールドを収集する:
+- **場所**: Storybook URL、パッケージ名、または社内ドキュメントのパス。
+- **アクセス方法**: WebFetch、ファイル読み込み、または MCP サーバー名。
+
+## Axis 3: ガイドライン
+
+UI 作業向けの利用ガイド、アクセシビリティルール、アンチパターン、命名規約。
+
+**AskUserQuestion 選択肢**:
+- プロジェクト層のガイドラインファイル（例: `DESIGN.md`、`docs/guidelines/...`）
+- 外部のドキュメントサイト
+- デザインシステムカタログ内のインライン記述
+- 文書化されたガイドラインなし
+- 該当なし
+
+**フォローアップ（軸が該当する場合）**: 2 つのフィールドを収集する:
+- **場所**: ファイルパスまたは URL。
+- **アクセス方法**: ファイル読み込みまたは WebFetch。
+
+複数のファイルが異なる関心領域を扱う場合（CSS、アクセシビリティ、i18n 等）、`template.md` の複数インスタンスルールに従って各ファイルを別エントリとして収集する。
+
+## Axis 4: 表示検証環境
+
+実装中にレンダリング結果を確認する手段。
+
+**AskUserQuestion 選択肢**:
+- スクリーンショット機能を持つ E2E テストランナー
+- Storybook 等価の独立したコンポーネントプレビュー
+- ブラウザ自動化ツール（専用 CLI または MCP サーバー）
+- 手動でのブラウザ確認のみ
+- 該当なし
+
+**フォローアップ（軸が該当する場合）**: 2 つのフィールドを収集する:
+- **場所**: プレビュー URL、MCP の対象、またはテストランナー識別子。
+- **アクセス方法**: 起動コマンド、MCP サーバー名、またはブラウザ自動化ツール名。
+
+## 自己申告フェーズ
+
+4 つの構造化軸の後、1 回だけ尋ねる: 「構造化された質問の範囲を超えて、このプロジェクトが依存するフロントエンド外部リソースは何か？ 該当する項目を次のメッセージで列挙、または 'none' と返答する。」
+
+自由記述の回答はフロントエンドブロックの「追加リソース」サブセクションに収集する。このフェーズは構造化軸が全て「該当なし」となった場合でも実行する。
+
+自己申告でのみ表面化するリソースの例: ブランド資産の CDN、フォントホスティングサービス、アイコンライブラリのサブスクリプション、ビジュアルバリアントを制御する A/B テストダッシュボード、ビジュアル KPI 確認用の分析ダッシュボード。

package/.claude/skills-ja/project-context/references/external-resources-infra.md

@@ -0,0 +1,76 @@
+# インフラストラクチャ外部リソース軸
+
+デプロイ、環境設定、Infrastructure as Code に関する作業向けのヒアリング軸。`/project-inject` はユーザーがインフラストラクチャドメインを選択したときにこのファイルを読み込む。
+
+## Axis 1: IaC ソース
+
+インフラ定義の正本となる取得元。
+
+**AskUserQuestion 選択肢**:
+- リポジトリ内の Terraform 構成
+- リポジトリ内の Pulumi または CDK コード
+- リポジトリ内の Kubernetes マニフェスト / Helm チャート
+- クラウドプロバイダー固有のテンプレート（例: CloudFormation、Bicep、Deployment Manager）
+- 手動コンソール設定（IaC なし）
+- 該当なし
+
+**フォローアップ（軸が該当する場合）**: 2 つのフィールドを収集する:
+- **場所**: ディレクトリパス。
+- **アクセス方法**: 自動で plan / apply が走る場合の CI パイプライン名、または手動実行の場合の CLI コマンド。
+
+## Axis 2: 環境設定
+
+環境ごとの設定（開発、ステージング、本番）の差分管理方法。
+
+**AskUserQuestion 選択肢**:
+- リポジトリ内の環境別設定ファイル（例: `terraform/envs/`、`config/staging.yaml`）
+- デプロイプラットフォームが管理する環境変数
+- IaC ツール自身のワークスペースまたはスタック抽象化
+- 共通の単一設定（環境ごとの差分なし）
+- 該当なし
+
+**フォローアップ（軸が該当する場合）**: 2 つのフィールドを収集する:
+- **場所**: 環境固有の値が格納されている設定ファイルのパス、プラットフォームの設定名、またはワークスペース識別子。
+- **アクセス方法**: ファイル読み込み、プラットフォームのコンソール URL、または CLI コマンド。
+
+複数の環境が個別に追跡される場合（開発、ステージング、本番）、`template.md` の複数インスタンスルールに従って環境名を識別接尾辞として各エントリを収集する。
+
+## Axis 3: インフラのシークレット
+
+インフラコードがシークレット値をソース管理に出さずに参照する方法。
+
+**AskUserQuestion 選択肢**:
+- IaC のデータルックアップでシークレットマネージャーから取得
+- apply 時に環境変数経由で注入
+- IaC コードと共に格納された暗号化済みシークレットファイル
+- インフラにシークレットなし
+- 該当なし
+
+**フォローアップ（軸が該当する場合）**: 2 つのフィールドを収集する:
+- **場所**: シークレットマネージャーのサービス名または IaC のデータソース識別子。
+- **アクセス方法**: データルックアップの構文、環境変数名、または apply 時の注入機構。
+
+同一のシークレットストアがバックエンドドメインに登場する場合、この軸は `template.md` で定義される軸間参照記法でそのストアへの参照として出力する。
+
+## Axis 4: デプロイトリガー
+
+インフラとアプリケーションの変更が各環境にどのように到達するか。
+
+**AskUserQuestion 選択肢**:
+- 特定ブランチへのマージで起動する CI パイプライン
+- CI 内の手動承認ステップ
+- オペレーターによるローカル apply
+- デプロイプラットフォームの push 連動オートデプロイ
+- 該当なし
+
+**フォローアップ（軸が該当する場合）**: 2 つのフィールドを収集する:
+- **場所**: CI パイプライン名またはデプロイプラットフォーム識別子。
+- **アクセス方法**: 各環境を起動するブランチ / タグ規約と、必要な手動承認ステップ。
+
+## 自己申告フェーズ
+
+4 つの構造化軸の後、1 回だけ尋ねる: 「構造化された質問の範囲を超えて、このプロジェクトが依存するインフラストラクチャ外部リソースは何か？ 該当する項目を次のメッセージで列挙、または 'none' と返答する。」
+
+自由記述の回答はインフラストラクチャブロックの「追加リソース」サブセクションに収集する。このフェーズは構造化軸が全て「該当なし」となった場合でも実行する。
+
+自己申告でのみ表面化するリソースの例: IaC ツールの state 保管バックエンド、インシデント対応の runbook ドキュメント、オンコールローテーション、可観測性ダッシュボード、コスト監視ツール、コンプライアンス / 監査ログ送信先。