askill
architecture-detail

architecture-detailSafety 95Repository

This skill should be used when the user asks to "design security architecture", "plan infrastructure", "define caching strategy", "detail system configuration", or "finalize architecture". Designs detailed security, infrastructure, and caching strategies after Wave A/B completion.

0 stars
1.2k downloads
Updated 2/19/2026

Package Files

Loading files...
SKILL.md

Architecture Detail Skill

Wave B で実行される詳細アーキテクチャ設計スキル。 セキュリティ設計、インフラ構成、キャッシュ戦略を定義する。

実行タイミング: Wave B(api と並列)

前提条件

条件必須説明
docs/03_architecture/architecture.mdWave A の出力
docs/03_architecture/adr.md技術選定記録
Blackboard(decisions.architecture)NFR ポリシー
Blackboard(decisions.entities)データ構造(Wave A)

出力ファイル

ファイル説明
docs/03_architecture/security.mdセキュリティ設計
docs/03_architecture/infrastructure.mdインフラ構成
docs/03_architecture/cache_strategy.mdキャッシュ戦略

依存関係

種別対象
前提スキルarchitecture-skeleton(Wave A)
並列スキルapi(Wave B)
後続スキルdesign-detail, implementation

ワークフロー

1. Blackboard から NFR ポリシーを読み込み
2. API 設計を読み込み
3. セキュリティ設計を詳細化
4. キャッシュ戦略を設計
5. インフラ構成を設計
6. 各ファイルを生成
7. SendMessage で contract_outputs を Lead に送信

セキュリティ設計

認証実装詳細

Wave A で決定した認証方式に基づき、詳細を設計:

項目設計内容
JWT 署名RS256、公開鍵は JWKS エンドポイント
トークン保存Access: メモリ、Refresh: httpOnly Cookie
セッション管理Redis(TTL 付き)
CSRF 対策SameSite=Strict + Double Submit Cookie

脆弱性対策

脅威対策検証方法
XSSCSP、サニタイズOWASP ZAP
CSRFSameSite Cookie、Token手動テスト
SQL Injectionパラメータ化クエリ(Prisma)静的解析
SSRF許可リスト、プライベートIP拒否手動テスト

データガバナンス(security.md に含める)

データ分類と取り扱い

分類保存要件アクセス要件
PII氏名、メール、住所暗号化必須、保持期限設定認証+認可+監査ログ
Sensitive決済情報、医療情報暗号化必須、厳格なアクセス制御最小権限原則+MFA
InternalユーザーID、タイムスタンプ標準暗号化認証必須
Publicカテゴリ名、公開コンテンツなし制限なし

データライフサイクル

項目定義内容
保持期限データ種別ごとの保持期間(法的要件考慮)
削除ポリシー物理削除 / 論理削除 / 匿名化
匿名化ルールPII フィールドのマスキング・ハッシュ化方式
監査ログアクセスログの保持期間、記録項目

PII マスキングルール

対象マスキング方式
メールアドレス部分マスクt***@example.com
電話番号後方マスク090--
氏名仮名化User_12345

キャッシュ戦略設計

レイヤー別設計

レイヤー技術TTL無効化戦略
ブラウザCache-Control1日ETag
CDNCloudFront1時間パスベース無効化
アプリケーションRedis15分イベント駆動
DBクエリキャッシュ5分更新時クリア

キャッシュキー設計

// ユーザー固有データ
cache:user:{userId}:profile
cache:user:{userId}:settings

// 共有データ
cache:global:categories
cache:global:config

インフラ設計

可用性目標

項目目標
稼働率99.9%(8.76時間/年ダウンタイム許容)
RTO1時間
RPO5分

構成図(Mermaid)

graph TB
    subgraph "Public"
        CDN[CloudFront]
        ALB[Application Load Balancer]
    end

    subgraph "Private"
        App[App Server<br/>Auto Scaling]
        Redis[ElastiCache<br/>Redis]
        DB[(RDS PostgreSQL<br/>Multi-AZ)]
    end

    CDN --> ALB
    ALB --> App
    App --> Redis
    App --> DB

SendMessage 完了報告

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

status: ok
severity: null
artifacts:
  - docs/03_architecture/security.md
  - docs/03_architecture/infrastructure.md
  - docs/03_architecture/cache_strategy.md
contract_outputs:
  - key: decisions.architecture.security
    value: {認証/認可/脆弱性対策}
  - key: decisions.architecture.cache
    value: {キャッシュ戦略}
  - key: decisions.architecture.infrastructure
    value: {インフラ構成}
open_questions: []
blockers: []

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

エラーハンドリング

エラー対応
NFR ポリシー不在architecture-skeleton へ差し戻し(P1)
API 設計不整合api へ差し戻し(P1)
セキュリティ要件不明確P2 報告、デフォルト推奨値で設計

Install

Download ZIP
Requires askill CLI v1.0+

AI Quality Score

92/100Analyzed 2/12/2026

An exceptionally detailed and well-structured skill for architectural design. It provides clear triggers, prerequisites, workflows, and high-density technical references for security, infrastructure, and caching.

95
95
70
95
90

Metadata

Licenseunknown
Version1.0.0
Updated2/19/2026
Publishersizukutamago

Tags

apidatabasesecurity