메인 콘텐츠로 건너뛰기

시스템 아키텍처

핵심은 각 도구에 역할을 분리하는 것입니다.

역할 분담

시스템 계층

사람이 읽는 홈페이지나 Athena는 이해와 검색을 돕습니다. 하지만 실제 제품 상태나 릴리즈 판정은 GitHub와 실행된 evidence가 우선합니다.

충돌 시 우선순위

이 순서를 정해두면 오래된 채팅이나 로드맵이 현재 제품 상태를 덮어쓰는 일을 막을 수 있습니다.

두 repository의 역할

datarelay-labs/engineering-system Canonical / machine-consumed repository입니다. 표준, adapter, template, validation, /resume, session continuity rule이 여기에 있습니다. datarelay-labs/engineering-system-docs 사람이 읽는 handbook입니다. 왜 이런 구조가 되었는지, 실제로 어떻게 사용하는지, 어떤 문제가 개선되었는지를 설명합니다.
두 문서가 충돌하면 항상 canonical engineering-system repository를 따릅니다.

Project-local Adoption

기본 Engineering System 적용에 필요한 저장소 시작 지점은 다음 네 가지입니다.
AI Work Packet Issue 템플릿은 구현 권한과 continuity의 기본 surface입니다. .cursor/commands/resume.md 같은 Cursor 파일은 managed compatibility adapter로 남을 수 있지만 기본적으로 비활성화되며, 현재 packet의 명시적 opt-in 없이는 실행 권한을 만들지 않습니다. 저장소 안에 Engineering System 전체를 복사하지 않고 사용할 버전과 기준 SHA만 고정해 참조합니다.
마지막 수정일 2026년 9월 29일