Skip to content

품질 표준 프로토콜 (Quality Standard) ​

품질 표준 (skills/references/quality.md)은 tdd, review, ship, archive, onboard 전반에서 강제 적용되는 품질 기준을 정의합니다.

3차원 품질 검증 ​

모든 구현 및 리팩토링 사이클마다 다음 4가지 관점에서 엄격히 검증합니다:

1. 기계적 검사 (Mechanical Checks) ​

  • Lint 규칙이 경고 없이 통과.
  • 코드 포맷팅이 프로젝트 설정 준수.
  • any를 통한 우회나 타입 오류 억제 없이 타입 검사(Typecheck) 통과.

2. 관례 준수 (Convention Adherence) ​

  • 명세서(convention:)에 선언된 프로젝트 관례 및 스택 모범 사례 엄격 준수.
  • 관용적 구조, 에러 처리 패턴 및 명명 규칙 평가.

3. 설계 및 경계 평가 (Design & Boundaries) ​

  • 내향적 의존성 (Inward Dependencies): 핵심 비즈니스 로직은 가변적인 I/O, UI, DB 어댑터에 의존하지 않음.
  • 부작용 격리 (Isolated Side-Effects): 순수 계산 및 결정 로직을 I/O 및 상태 변이와 명확히 분리.
  • 고응집 및 단순성 (Cohesion & Simplicity): 단일 책임 원칙 준수; 비대해진 함수나 누출된 추상화 배제.

4. 문서 커버리지 (Documentation Coverage) ​

  • 모든 공개 함수, API 엔드포인트, 내보낸 인터페이스, 환경 변수 및 오류 모드가 정확히 문서화됨.
  • README.md의 명령어 및 예제가 실행 가능하고 최신 상태로 유지됨.
  • 문서 업데이트가 누락된 코드 변경은 Code Review를 통과할 수 없음.

Released under the MIT License.