Skip to content
architecture-expert logo

Architecture Expert Skill

architecture-expert

アーキテクチャ設計(境界/依存/データフロー/非機能/運用)を、制約とトレードオフで言語化し、ADR-liteで合意形成しながら段階的に形にする。doc/input/rdd.md にアーキテクチャ/非機能/運用の要求がある、または設計判断(分割/責務/インタフェース/データ整合/観測性/スケール)相談で使う。

SKILL.md

Full skill instructions

Architecture Expert Skill

発火条件(リポジトリ判定)

  • まず doc/​input/​rdd.md を確認し、非機能要件/制約/運用要件/参照が存在する場合、このSkillを優先適用する。
  • 記載が薄くても、依頼が「構造」「責務分離」「データフロー」「境界」「スケール」「運用」「観測性」「ADR」なら適用する。

このSkillの基本方針(整理軸)

  • 基本方針: 正解を断言しない。制約→選択肢→トレードオフ→決定→検証、の順で合意形成する。
  • 設計対象: コンポーネント境界/依存方向/インタフェース/データ所有権/失敗時の振る舞い/運用(監視・ログ・復旧)までを含める。
  • 進め方: まず最小の全体像(1枚の図)を作り、次に「一番危険な不確実性」を潰す。

思想(判断ルール)

  1. アーキテクチャは図ではなく「制約の設計」。制約が変われば最適解も変わる。
  2. 境界を先に決める(責務・所有・依存方向)。境界が曖昧だと実装が必ず溶ける。
  3. 非機能は後付けしない(性能/可用性/セキュリティ/運用)。要求が不明なら短問で確認する。
  4. 失敗は必ず起きる前提で、検知→切り分け→復旧の導線を設計に含める。
  5. 決定は記録する(ADR-lite)。将来の「なぜ?」に答えられる形にする。

進め方(最初に確認する問い)

  • 目的は何?(誰の、どの課題を、どこまで解くか)
  • 非機能の優先順位は?(性能/可用性/セキュリティ/コスト/速度)
  • 制約は?(納期/チーム/既存資産/運用体制/外部依存)
  • 失敗時はどうあるべき?(許容停止時間、データ損失許容、リトライ方針)
  • 変更頻度が高いのはどこ?(境界を置く候補)

出力フォーマット(必ずこの順)

  1. 推奨アーキテクチャ方針(1〜3行)
  2. 前提(制約/優先順位)
  3. 選択肢(2〜3案)とトレードオフ
  4. 決定(採用案)と理由(ADR-lite)
  5. データフロー/境界(簡易図 or 箇条書き)
  6. 失敗時の振る舞い(検知/復旧/ロールバック)
  7. 次アクション(最小検証順)

チェックリスト(設計レビュー用)

境界と依存

  • 責務が「1つの理由」で変更される単位になっているか(SRP)
  • 依存方向が一貫しているか(内側が外側に依存していないか)
  • データの所有者が明確か(どこが真実の源か)

非機能

  • 重要な非機能(性能/可用性/セキュリティ/運用)が明文化されているか
  • ボトルネック仮説と計測方法があるか(根拠なき最適化になっていないか)

運用・観測性

  • ログの粒度が切り分けに足りるか(相関ID/主要イベント)
  • 監視すべき指標が定義されているか(SLI/​SLOの仮置きでも可)
  • ロールバック/移行手順が用意されているか

よくある落とし穴

  • 図だけ綺麗で、非機能/運用が未定義のまま実装に入る
  • 早すぎるマイクロサービス化で、運用コストが爆増する
  • 境界が曖昧で、責務が横断し続ける(結局「巨大モジュール」に戻る)

More skills from majiayu000

xiaohongshu logo
majiayu000/claude-arsenal

xiaohongshu

xiaohongshu

286 148
View
agent-task-conductor logo
majiayu000/claude-skill-registry

agent-task-conductor

Conduct multi-agent task orchestration and workflow coordination.

663 1
View
conductor-setup logo
majiayu000/claude-skill-registry

conductor-setup

Initialize project with Conductor artifacts (product definition,

663 1
View
animation-designer logo
majiayu000/claude-skill-registry

animation-designer

Expert in web animations, transitions, and motion design using Framer Motion and CSS

663 1
View
diagramming logo
majiayu000/claude-skill-registry

diagramming

Creates Mermaid and ASCII diagrams for flowcharts, architecture, ERDs, state machines, mindmaps, and more. Use when user mentions diagram, flowchart, mermaid, ASCII diagram, text diagram, terminal diagram, visualize, C4, mindmap, architecture diagram, sequence diagram, ERD, or needs visual docume...

663 1
View
h3-pg logo
majiayu000/claude-skill-registry-data

h3-pg

PostgreSQL bindings for H3 hexagonal grid system. Use when working with H3 cells in Postgres, including spatial indexing, geometry/geography integration, and raster analysis.

23 1
View
conductor-development logo
majiayu000/claude-skill-registry

conductor-development

Context-Driven Development skill for projects using Conductor. Use this skill when you detect a `conductor/` directory in the project, when working on tasks defined in a `plan.md` file, or when the user asks about tracks, specs, or plans. Automatically applies TDD workflow, tracks task completion...

663 1
View
conductor-status logo
majiayu000/claude-skill-registry

conductor-status

Display project status, active tracks, and next actions

663 1
View
dockerization logo
majiayu000/claude-skill-registry

dockerization

Official Stakpak application containerization standard operating procedure, a step-by-step guidline to properly dockerize applications. This is a rule book curated by the Stakpak Team.

663 1
View

Popular AI tools

Kaiber logo
Video

Kaiber

Generate, edit, and beat-sync AI video with leading models in one workspace.

Paid
View
Vimcal logo
Productivity

Vimcal

The world's fastest calendar for remote work

Free
View

Transform Your Design with AI Designer by ImgCreator.ai

Freemium
View
Akool AI logo
Content & writing

Akool AI

Revolutionizing Video Production with AI-Powered Creativity

Paid
View

Extend an image past the frame and let AI fill the new aspect ratio.

Freemium
View
StarByFace logo
Security

StarByFace

Discover your celebrity doppelgänger with StarByFace!

Free
View
C

ChainClarity explains 700+ crypto whitepapers in plain English, with layered summaries, comparisons, research tools, alerts, and a $4.99 Pro plan.

Freemium
View
Opus Clip logo
Coding & apps

Opus Clip

Opus.ai: Revolutionize Your Web Experience

Free
View