| name | backend-architecture-review-rules |
| description | 백엔드 변경이 architecture boundary, dependency direction, policy, TDD 결정에 맞는지 독립 검토해야 할 때 사용하는 리뷰 규칙. |
Backend Architecture Review Rules
목적
목표:
backend 변경이 입력된 Source of Truth, backend_design_basis, implementation_result에 맞는지 독립적으로 검토한다.
성공 기준
- 변경 파일별 pass/violation 판단이 있다.
- violation에는 rule id, severity, source path, 이유가 있다.
- blocker/major/minor가 구분된다.
- 문서에 없는 개인 선호는 violation으로 보고하지 않는다.
핵심 규칙
- 검토 기준은 입력으로 받은 Source of Truth에 한정한다.
- 기본 Source of Truth 후보는 docs/backend/architecture/, docs/backend/policies/, 관련
backend_design_basis다.
- architecture boundary, dependency direction, transaction, security, logging 정책을 확인한다.
backend_design_basis와 implementation_result의 일관성을 확인한다.- architecture review stage는 구현을 직접 수정하지 않는다.
- violation은 후속 remediation input으로 사용할 수 있는 단위로 작성한다.
Violation payload
Violation payload는 Backend stage payload contracts를 따른다.
안티패턴
- 코드 스타일 취향을 architecture violation으로 보고한다.
- Source of Truth에 없는 규칙을 근거로 blocker를 만든다.
- implementation evidence를 확인하지 않고 pass 처리한다.
금지사항
- 제품 요구사항 자체를 새로 정의하지 않는다.
- frontend UI 규칙을 backend violation 근거로 사용하지 않는다.
- 보안 민감 의심을 숨기지 않는다. 필요하면 blocker 또는 open question으로 분리한다.
- 문서 구조, 스킬, 서브에이전트 계약 변경을 backend architecture violation으로 확장하지 않는다.
검증
- skill frontmatter가 현재 책임과 일치하는지 확인한다.
- 참조 docs 링크가 실제 파일을 가리키는지 확인한다.
- 이 skill에 orchestration, subagent lifecycle, scheduling 책임이 들어오지 않았는지 확인한다.
참조 Docs
