Skip to content
cccskills
FreePublished on GitHub

architecture-expert

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

The English summary is being prepared. Showing the original description.

See how to install

Files included (1)

  • SKILL.md4.0 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

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)
  • 依存方向が一貫しているか(内側が外側に依存していないか)
  • データの所有者が明確か(どこが真実の源か)

非機能

  • 重要な非機能(性能/可用性/セキュリティ/運用)が明文化されているか
  • ボトルネック仮説と計測方法があるか(根拠なき最適化になっていないか)
  • 描画量・更新頻度が多いUIで、Canvas 2D 手書きでなく WebGL 系ライブラリを検討したか(判断軸は creative-coder の描画技術選定)

運用・観測性

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

よくある落とし穴

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

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

セマンティックHTML/JSXとWAI-ARIAを「最小で正しく」適用し、キーボード操作・スクリーンリーダ・コントラスト等を満たす実装を作るための判断軸。ネイティブ要素優先、ARIAの過剰使用を避ける。

The English summary is being prepared. Showing the original description.

mae616/ai-template9Updated Oct 6, 2026

Agent Browser(Headlessブラウザ自動化CLI)を使ったUI検証・E2Eテスト・スクリーンショット取得の判断軸。アクセシビリティツリーベースの要素選択を優先し、壊れにくいテスト設計を目指す。

The English summary is being prepared. Showing the original description.

mae616/ai-template9Updated Oct 6, 2026

ディズニーの12原則とジブリ的自然運動をベースに、UIアニメーションの「なぜ動かすか」「どう動かすか」を判断する。アニメーション/モーション/トランジション設計の相談で、ツール非依存の概念的判断軸として使う。

The English summary is being prepared. Showing the original description.

mae616/ai-template9Updated Oct 6, 2026

事業仮説を支える一次/二次情報を整理し、意思決定に足る「根拠」「不確実性」「次の調査」を可視化する。でたらめな引用や推測の断言を避け、出典の実在を重視する。

The English summary is being prepared. Showing the original description.

mae616/ai-template9Updated Oct 6, 2026

体験品質(動き/触感/視線誘導)を「実装可能な制約」に落とし、アクセシビリティとパフォーマンスを犠牲にせずに表現を実現する。UIの表現・アニメーション・インタラクション設計/実装の相談で使う。

The English summary is being prepared. Showing the original description.

mae616/ai-template9Updated Oct 6, 2026

設計と実装を「最小で正確」に進め、差分思考で品質と速度を両立する。設計の溶け込み(責務不明/重複/暫定対応)を防ぎ、レビュー可能な変更へ落とし込むときに使う。

The English summary is being prepared. Showing the original description.

mae616/ai-template9Updated Oct 6, 2026

See all skills by mae616

Report a problem with this skill