프로젝트 소개

Eric의 엔지니어링 헌법은 인간과 AI 에이전트가 소프트웨어 프로젝트에서 협업하는 방식에 대한 단일 진실 공급원 역할을 하는 재사용 가능한 프레임워크입니다. 이는 읽기 전용 `constitution/` 서브모듈로 모든 Git 저장소에 가져와서, 소수의 로컬 프로젝트 파일과 함께 계층화되고, AI 코딩 에이전트와 CI 파이프라인 모두에 의해 강제되도록 설계되었습니다. 이 저장소에는 권위 있는 거버넌스 문서(CONSTITUTION.md, AI_WORKFLOW.md, INTEGRATION.md, TESTING.md, DOCUMENTATION.md, SECURITY.md, OPERATIONS.md, ARCHITECTURE.md, RELEASES.md, TODO_GUIDELINES.md, KNOWLEDGE_SOURCES.md), 헌법 규칙을 자율적으로 강제하는 25개의 내장 에이전트 스킬, 그리고 CI에서 규정 준수를 검증하는 포괄적인 참조 체커 스크립트 세트가 포함되어 있습니다. 이러한 체커는 공급업체 파일(AGENTS.md, CLAUDE.md, .cursorrules 등) 간의 지시 템플릿 일관성, 스킬 메타데이터 유효성, 요구사항과 테스트의 추적성, OTS 소프트웨어 인벤토리 교차 검사, 아키텍처 종속성 규칙(소스 코드 종속성이 종속성 규칙에 따라 내부를 향하도록 보장), 버전 및 릴리스 태그 정렬, 문서 및 위키 최신성, 위키 링크 무결성, 비밀 스캔, 지시 가중치 측정을 다룹니다. 부트스트랩 스크립트(`scripts/bootstrap.sh`)는 서브모듈을 추가하고, 누락된 거버넌스 파일을 생성하며, 채택 보고서를 생성하여 기존 저장소를 초기화합니다. `--agents` 플래그(claude, cursor, copilot, goose, openhands, antigravity, continue, aider, generic, all)를 통한 옵트인 에이전트 지시 파일을 지원하며, AGENTS.md가 기본값입니다. 이 스크립트는 기본적으로 기존 파일을 덮어쓰지 않으며, 수동 병합을 위해 템플릿 사본을 `.constitution-bootstrap/templates/`에 배치합니다. 또한 중복을 피하기 위해 마커 사이에 관리되는 표준 채택 배지를 README에 추가합니다. 프레임워크에는 풀 리퀘스트 완료 체크리스트, CODEOWNERS, CI 워크플로 게이트(SHA 고정), Visual Studio의 GitHub Copilot용 Solon 사용자 지정 에이전트, 그리고 제품 요구사항, 마일스톤 백로그, 세션 계획, OTS 소프트웨어 인벤토리, 위키 홈 페이지, 인시던트 사후 분석을 위한 문서 템플릿이 포함되어 있습니다. 또한 헌법 문서와 소스를 리소스로 노출하는 MCP 서버와 `sources/` 아래 에이전트가 소비할 수 있는 요약으로 책과 기사를 증류하는 지식 소스 워크플로를 제공합니다. IDE 통합은 자동입니다. 부트스트랩된 저장소를 Visual Studio, VS Code 또는 JetBrains IDE에서 열면 AI 어시스턴트(GitHub Copilot, Continue.dev, Cursor)가 헌법 서브모듈을 가리키는 커밋된 지시 파일을 읽을 수 있습니다. Claude Code의 SessionStart 후크는 오래된 서브모듈을 즉시 표시합니다. 프레임워크 자체의 CI는 모든 풀 리퀘스트와 main 푸시에서 전체 테스트 스위트와 자체 거버넌스 체커를 실행하며, 릴리스 태그 정렬 워크플로가 버전 태그를 보호합니다. 이 프로젝트는 통합, 버전 관리(현재 1.48.0), 그리고 작업된 예제 프로젝트 레이아웃에 대한 광범위한 문서를 포함합니다. 이는 코드 라이브러리가 아닌 거버넌스 계층으로 포지셔닝되며, 훈련되고 측정 가능한 AI 지원 개발 관행을 강조합니다.