j5ik2o/okite-ai/repository-placement
Claude Code and agent skill by j5ik2o/okite-ai
- community
Checking that the SKILL.md file is still in the repository.
リポジトリインターフェースの配置場所に関するガイド。クリーンアーキテクチャにおいて リポジトリインターフェースをドメイン層ではなくユースケース層に配置すべき理由を解説。 ドメインモデルとリポジトリの結合防止、構造による設計意図の強制を主眼とする。 トリガー:「リポジトリをどこに置く」「リポジトリインターフェースの配置」「ドメイン層にリポジトリ」 「クリーンアーキテクチャでリポジトリ」等のリポジトリ配置関連リクエストで起動。
Install
npx vskill@latest install j5ik2o/okite-ai/repository-placementSKILL.md
リポジトリインターフェースの配置
結論
リポジトリインターフェースはユースケース層に置く。ドメイン層には置かない。
なぜドメイン層に置くと問題か
物理的な近さが結合を誘発する
同じ層にあると、ドメインモデルがリポジトリを使いやすくなる:
ドメインが「永続化」を知ってしまう
ドメインモデルは純粋なビジネスルールだけを持つべき。
ユースケース層に置く利点
構造が設計意図を強制する
物理的な距離がガードレールになる:
- ドメインモデルからimportしにくい(別パッケージ/モジュール)
- 「リポジトリはユースケース層のポート」という意図が構造で伝わる
- 集約がIDで参照するルールを守りやすい
集約のID参照ルールを自然に守れる
検出パターン
ドメイン層にリポジトリがある兆候
インターフェースアダプタ層にリポジトリインターフェースがある兆候
正しい配置
DDDとの関係
DDDの伝統的解釈では、リポジトリはドメインの一部(集約のライフサイクル管理)とされる。
しかし実践上は、ドメイン層に置くと結合が生まれやすい。クリーンアーキテクチャの規約では、 リポジトリインターフェースはユースケース層の出力ポートとして扱う。
| アプローチ | メリット | デメリット | |
|---|---|---|---|
| ドメイン層に配置 | DDDの教科書通り | 結合が生まれやすい | |
| ユースケース層に配置 | 規約に一致/依存方向が明確 | DDDの純粋主義と異なる |
推奨: ユースケース層に配置し、構造でガードする。
レビューチェックリスト
- 配置確認: リポジトリインターフェースがユースケース層にあるか?
- 結合確認: ドメインモデル(エンティティ/集約)がリポジトリをimportしていないか?
- ID参照確認: 集約が他の集約を実体ではなくIDで参照しているか?
参考
- Martin, Robert C. "Clean Architecture" (2017)
- Vernon, Vaughn. "Implementing Domain-Driven Design" (2013)
関連スキル(併読推奨)
このスキルを使用する際は、以下のスキルも併せて参照すること:
clean-architecture: リポジトリ配置の基盤となる4層アーキテクチャaggregate-design: リポジトリが対応する集約の設計ルールrepository-design: リポジトリの命名・CQS・メソッド設計
Security
- Security scanPassed, 100 of 100Pattern checks on the skill's files.
- Model reviewNot runA model review is scheduled for the next rescan.
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingskills/repository-placement/SKILL.md
Popularity
- Repository stars
- 74
- Repository forks
- 2
- 7-day trend score
- 22
Stars and forks are for the whole GitHub repository, not this skill alone. Refreshed 24 Mar 2026, 7 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
[](https://verified-skill.com/skills/j5ik2o/okite-ai/repository-placement)