| name | clean-architecture |
| description | Alt の Clean Architecture レイヤ規約（Handler → Usecase → Port → Gateway → Driver）を適用し、層の逆依存・層越境・誤った層への実装を検出する。サービスのコードを新規実装・リファクタ・レビューするとき、どの層に置くべきか判断するとき、handler/usecase/gateway/driver/port ディレクトリ配下を編集するときに使う。ユーザが「Clean Architecture」や「層」に触れなくても、ハンドラに fetch や SQL を書き足すような層をまたぐ変更に入るなら使う。 |
| allowed-tools | Read, Grep, Glob, Bash |
| paths | ["**/handler/**","**/rest/**","**/usecase/**","**/port/**","**/gateway/**","**/driver/**"] |
Clean Architecture Layers
Handler -> Usecase -> Port -> Gateway -> Driver
Layer Rules
| Layer | Responsibility | Can Depend On |
|---|
| Handler | HTTP/gRPC entry points, validation, response formatting | Usecase, Port |
| Usecase | Business logic orchestration, NO external dependencies | Port only |
| Port | Interface definitions (contracts) | Nothing |
| Gateway | Anti-corruption layer, external service mapping | Port, Driver |
| Driver | Database, API, external integrations | External libraries |
File Patterns
**/rest/** or **/handler/** = Handler layer**/usecase/** = Usecase layer**/port/** = Port layer (interfaces)**/gateway/** = Gateway layer**/driver/** = Driver layer
Common Violations
Concrete patterns found repeatedly in the 2026-07 full-repo review — check for these before finishing any change:
- Handler doing Driver work: HTTP fetch, SSRF validation, or direct DB calls implemented inside a REST/RPC handler (seen as ~600 lines duplicated across 3 handlers). Handlers validate, delegate to a Usecase, and format the response — nothing else
- Driver importing Service/Usecase (reverse dependency): a
driver/ package importing from service/ or usecase/ inverts the layer direction
- Usecase importing infrastructure:
usecase/ importing otel, httpx, asyncpg, redis clients, or any driver/ package directly — depend on a Port interface instead
- Cross-layer duplication instead of extraction: the same logic pasted into multiple handlers because it lives at the wrong layer — extract into a Usecase
- Circular dependencies between layers
Self-Check (run before handoff)
grep -rn --include="*.go" -E '"[^"]*/(driver|otel)' */app/usecase/ | grep -v _test
grep -rn --include="*.go" -E '"[^"]*/(service|usecase)' */app/driver/
grep -rn --include="*.py" -E '^(from|import) .*(httpx|asyncpg|redis|driver)' */app/usecase/
For broad audits use the layer-checker agent.
