개발 가이드

​

핵심 명령

pnpm dev
pnpm precommit:check
pnpm test
pnpm check
pnpm check:docs
pnpm docs:linkcheck
pnpm docs:validate

​

권장 작업 루프

1. 의도 정렬: Doctrine/Contracts 먼저 확인
2. 작은 단위로 구현
3. 로컬 검증 (pnpm precommit:check, 필요 시 pnpm check, docs checks)
4. 커밋/PR

​

Git Hook

• 기준 파일: .pre-commit-config.yaml
• 필수 차단:
  • 저장소 hygiene 훅
  • pnpm precommit:check
• pnpm precommit:check 구성:
  • pnpm format:check
  • pnpm lint
  • pnpm typecheck
• 권고/수동:
  • pnpm test
  • detect-secrets
  • actionlint
  • zizmor

pnpm precommit:check

​

품질 원칙

• 실행 가능한 결과 우선
• 트레이드오프를 명시
• 결정 이유를 문서화

​

머지 게이트 (main PR)

• 필수 상태: ci / required-ci, PR Convention / convention
• 참고 상태: codeql / analyze (javascript-typescript) 와 ci 내부 개별 잡
• 기준 문서: 기여 가이드