clean-architecture-principles

daishiman 的头像作者 daishiman

Clean Architecture の依存関係ルールとレイヤー境界設計を整理し、設計レビューと違反検出を支援するスキル。アーキテクチャのレイヤー構成、境界インターフェース、依存違反の是正を扱う。Anchors:• Clean Architecture (Robert C. Martin) / 適用: レイヤー設計と依存ルール / 目的: 依存違反の防止• Domain-Driven Design (Eric Evans) / 適用: ドメイン境界設計 / 目的: 内部モデルの保護• Accelerate (Forsgren/Humble/Kim) / 適用: 変更容易性と品質 / 目的: 継続的改善の指標化Trigger:Use when reviewing architecture layers, enforcing dependency rules, designing boundaries, or validating layer compliance.clean architecture, dependency rule, layer violation, boundary interface, architecture review

📖 中文导读:Clean Architecture の依存関係ルールとレイヤー境界設計を整理し、設計レビューと違反検出を支援するスキル。アーキテクチャのレイヤー構成、境界インターフェース、依存違反の是正を扱う。Anchors:• Clean Architecture (Robert C. Martin) / 適用: レイヤー設計と依存ルール / 目的: 依存違反の防止• Domain-Driven Design (Eric Evans) / 適用: ドメイン境界設計 / 目的: 内部モデルの保護• Accelerate (Forsgren/Humble/Kim) / 適用: 変更容易性と品質 / 目的: 継続的改善の指標化Trigger:Use when reviewing architecture layers, enforcing dependency rules, designing boundaries, or validating layer compliance.clean architecture, dependency rule, layer violation, boundary interface, architecture review 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: clean-architecture-principles description: | Clean Architecture の依存関係ルールとレイヤー境界設計を整理し、設計レビューと違反検出を支援するスキル。 アーキテクチャのレイヤー構成、境界インターフェース、依存違反の是正を扱う。

Anchors: • Clean Architecture (Robert C. Martin) / 適用: レイヤー設計と依存ルール / 目的: 依存違反の防止 • Domain-Driven Design (Eric Evans) / 適用: ドメイン境界設計 / 目的: 内部モデルの保護 • Accelerate (Forsgren/Humble/Kim) / 適用: 変更容易性と品質 / 目的: 継続的改善の指標化

Trigger: Use when reviewing architecture layers, enforcing dependency rules, designing boundaries, or validating layer compliance. clean architecture, dependency rule, layer violation, boundary interface, architecture review allowed-tools: - Read - Write - Edit - Bash - Glob - Grep

clean-architecture-principles

概要

Clean Architecture のレイヤー設計と依存関係ルールを整理し、境界の設計と違反検出を一貫して進める。

ワークフロー

Phase 1: 要件整理

目的: 対象範囲と設計目的を明確化する。

アクション:

  1. 対象システムの目的と制約を整理する。
  2. レイヤー構成と対象境界を定義する。
  3. 参照すべき要件文書を特定する。

Task: agents/analyze-architecture-requirements.md を参照

Phase 2: レイヤー設計

目的: 依存関係ルールと境界設計を具体化する。

アクション:

  1. 依存関係ルールと許容例外を整理する。
  2. 境界インターフェースと責務分担を設計する。
  3. レビュー用チェックリストを整備する。

Task: agents/design-layer-boundaries.md を参照

Phase 3: 検証と記録

目的: レイヤー違反を検出し、改善点を記録する。

アクション:

  1. 違反検出スクリプトで現状を確認する。
  2. レビュー結果と改善方針をまとめる。
  3. ログと評価情報を更新する。

Task: agents/validate-layer-compliance.md を参照

Task仕様ナビ

Task 起動タイミング 入力 出力
analyze-architecture-requirements Phase 1開始時 目的/制約/対象範囲 要件整理メモ、参照要件一覧
design-layer-boundaries Phase 2開始時 要件整理メモ レイヤー設計案、境界設計案
validate-layer-compliance Phase 3開始時 レイヤー設計案 検証レポート、改善アクション

詳細仕様: 各Taskの詳細は agents/ ディレクトリを参照

ベストプラクティス

すべきこと

推奨事項 理由
依存関係ルールを先に固定する 違反検出の基準が明確になる
境界インターフェースを明文化する 技術詳細の漏出を防ぐ
検証結果をログに残す 改善サイクルを回しやすくする

避けるべきこと

禁止事項 問題点
例外ルールを無制限に増やす ルールが形骸化する
境界設計を省略する 依存違反が検出しづらい
レビューを省略して実装する 手戻りが増える

リソース参照

scripts/(決定論的処理)

スクリプト 機能
scripts/check-layer-violation.mjs レイヤー違反検出
scripts/log_usage.mjs 使用記録と評価メトリクス更新
scripts/validate-skill.mjs スキル構造の検証

references/(詳細知識)

リソース パス 読込条件
Level1 基礎 references/Level1_basics.md 初回整理時
Level2 実務 references/Level2_intermediate.md 設計時
Level3 応用 references/Level3_advanced.md 情報量が多い時
Level4 専門 references/Level4_expert.md 改善ループ時
依存関係ルール references/dependency-rule.md 依存設計時
レイヤー構造 references/layer-structure.md レイヤー定義時
境界設計 references/boundary-interfaces.md 境界設計時
ハイブリッド対応 references/hybrid-architecture-mapping.md 既存構成の変換時
要求索引 references/requirements-index.md 要件参照時
旧スキル references/legacy-skill.md 互換確認時

assets/(テンプレート・素材)

アセット 用途
assets/architecture-review-checklist.md レビューチェックリスト

運用ファイル

ファイル 目的
EVALS.json レベル評価・メトリクス管理
LOGS.md 実行ログの蓄積
CHANGELOG.md 改善履歴の記録