j5ik2o/okite-ai/clean-architecture

Claude Code and agent skill by j5ik2o/okite-ai

Trust tier 2
  • community
Source check pending

Checking that the SKILL.md file is still in the repository.

クリーンアーキテクチャを採用しているプロジェクト向けの設計・レビュー支援。4層構造(ドメイン層、 ユースケース層、インターフェースアダプタ層、インフラストラクチャ層)に基づく。特にインフラ層は 横断的関心事(ロギング、設定管理)のみ、永続化やRPCはインターフェースアダプタ層に配置すべき という原則を適用する。トリガー:「クリーンアーキテクチャで」「クリーンアーキテクチャに従って」 「クリーンアーキテクチャのレビュー」など、クリーンアーキテクチャを明示的に指定した場合のみ起動。 一般的な「設計レビュー」「アーキテクチャ相談」では起動しない。

Install

npx vskill@latest install j5ik2o/okite-ai/clean-architecture

SKILL.md

クリーンアーキテクチャ

クリーンアーキテクチャを採用しているプロジェクト向けの設計・レビュー支援。

注意: このスキルはプロジェクトがクリーンアーキテクチャを採用している場合にのみ使用する。
他のアーキテクチャ(Hexagonal、Onion、レイヤード等)には適用しない。

層構造の概要

┌─────────────────────────────────────────────────────┐
│ Infrastructure(横断的関心事のみ) │
│ ・ログ ・設定 ・メトリクス ・DI設定 │
├─────────────────────────────────────────────────────┤
│ Interface Adapters(外部との境界) │
│ ・Controller ・Repository実装 ・Gateway実装 │
├─────────────────────────────────────────────────────┤
│ Use Cases(アプリケーション固有ルール) │
│ ・Use Case ・Output Port(Repository Interface等)│
├─────────────────────────────────────────────────────┤
│ Domain(ビジネスルール) │
│ ・Entity ・Value Object ・Domain Service │
└─────────────────────────────────────────────────────┘

重要な原則

永続化・RPCの配置場所
コンポーネント配置層
Repository Interfaceユースケース層(Output Port)
Repository 実装インターフェースアダプタ層
Gateway Interfaceユースケース層(Output Port)
Gateway 実装(RPC等)インターフェースアダプタ層
インフラストラクチャ層の責務

配置するもの(横断的関心事のみ):

  • ロギング機構
  • 設定管理
  • メトリクス・トレーシング
  • DIコンテナ設定

配置しないもの:

  • Repository実装 → インターフェースアダプタ層へ
  • 外部API Gateway → インターフェースアダプタ層へ

レビュー時のチェックポイント

  1. ドメイン層に外部依存がないか
  • DB接続、HTTPクライアント等の混入を確認
  1. Repository実装の配置が正しいか
  • インターフェースアダプタ層にあるべき
  1. インフラストラクチャ層が肥大化していないか
  • 永続化コードが紛れ込んでいないか確認
  1. 依存方向が内向きか
  • 外側の層から内側への依存のみ許可

詳細リファレンス

各層の詳細な責務と配置すべきコンポーネントの一覧は references/layer-responsibilities.md を参照。

関連スキル(併読推奨)

このスキルを使用する際は、以下のスキルも併せて参照すること:

  • repository-placement: クリーンアーキテクチャにおけるリポジトリインターフェースの配置
  • package-design: 各層内のパッケージ設計原則
  • ddd-module-pattern: ドメイン層内のモジュール構成

Security

  • Security scanPassed, 100 of 100Pattern checks on the skill's files.
  • Model reviewPassed

Quality evaluation

  • Task evaluationPassed, 83 of 100Effective. 1 run. Evaluated 8 months ago.

Source

Popularity

Repository stars
80
Repository forks
3
7-day trend score
22

Stars and forks are for the whole GitHub repository, not this skill alone. Refreshed 1 May 2026, 6 months ago.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/j5ik2o/okite-ai/clean-architecture/badge)](https://verified-skill.com/skills/j5ik2o/okite-ai/clean-architecture)

Something wrong with this skill or its page? Tell us.