alex-core-invariants은(는) 무엇을 하나요?
AI 보조 엔지니어링을 위한 6가지 핵심 불변 조건: README SSOT, 기술 지침, 경량 검사
불변 조건
-
README SSOT (단일 진실 공급원): README는 프로젝트의 유일한 진실 공급원입니다. 모든 AI 변경 사항은 README에 문서화된 지침과 일치해야 합니다.
-
기술 지침 참조: AI는 코드 변경을 수행하기 전에 관련 기술 지침 파일(예:
.cursorrules,CLAUDE.md,AGENT.md)을 참조해야 합니다. -
변경 전 검증: AI는 코드베이스를 수정하기 전에 현재 상태가 모든 불변 조건을 충족하는지 확인해야 합니다.
-
문서 동기화: 모든 코드 변경은 README 및 관련 문서의 업데이트를 동반해야 합니다.
-
변경 요약: AI는 각 작업 세션 후에 수행된 변경 사항과 불변 조건 준수 여부를 요약해야 합니다.
-
피드백 루프: AI는 불변 조건 위반 시 즉시 사용자에게 알리고, 수정 방안을 제안해야 합니다.
사용법
이 스킬을 AI 에이전트(예: Claude Code, Cursor)와 함께 사용하려면, 저장소 루트에 SKILL.md 파일로 추가하거나 에이전트 설정에 포함시키세요.
예시
# 변경 전 검증 실행
alex check-invariants
# README SSOT 업데이트
alex update-readme --from source
라이선스
MIT