도입 가이드
도입의 목표는 rule을 더 쌓는 것이 아니라 중복 context를 줄이는 것입니다.사용자가 요청하는 방식
사용자가 기억해야 할 adoption 진입점은 버전과 무관하게 다음 한 줄입니다.standards/ADOPTION.md에 따라 저장소를 점검하고 적용합니다.
대상 저장소에 tools/adopt.py가 미리 있을 필요는 없습니다. 인증된 GitHub 연동이나 별도의 임시 Engineering System checkout에서 helper를 가져와 대상 저장소 루트에 실행합니다. Engineering System 전체를 제품 저장소에 복사해 넣지는 않습니다.
Deterministic Bootstrap
Read-only audit:Fail-closed 조건
다음은 AI가 추측하지 않고 중단합니다.- dirty worktree
- 기존 AI/engineering rule 미검토
- test command 후보가 여러 개
- existing CI가 있는데 shared/native 책임이 결정되지 않음
- 기존 adoption을 destructive overwrite해야 함
- immutable canonical baseline SHA를 확인할 수 없음
Managed Adoption Identity
Managed adopted repository는 어떤 canonical standard와 어떤 project-native gate가 실제 책임을 가지는지 증명할 수 있도록 다음 identity를 기록합니다.ci_mode는 shared 또는 native입니다.
- shared: Engineering System reusable affected-test workflow 사용
- native: 기존 project CI를 유지하고 affected-test invariant를 담당하는 실제 workflow file을 명시하며 generated Engineering System workflow는 compliance만 수행
merge_gate_status:verified,advisory,unknown중 하나이며 workflow가 존재한다는 이유만으로 branch protection을 추측하지 않음- Production-oriented repository는 runbook과 incident-response posture를 명시적으로 기록
standards/DESIGN.md로, 운영 장애는 standards/OPERATIONS.md로 연결합니다. 운영 중심 프로젝트에서는 프로젝트 자체의 runbook, 상태 확인, 복구 절차를 기록하고 GitHub 병합 규칙을 실제 상태와 맞춥니다. 실행 가능한 프로젝트 명령이 있을 때는 릴리스 절차에도 이를 사용합니다. 모든 작업마다 새 문서를 만들라는 뜻은 아니며, 필요한 경우에만 가장 작은 기록을 남깁니다.
새 저장소 또는 빈 저장소
완전히 새 프로젝트라도 브랜치, HEAD, 변경 이력과 리뷰 가능한 diff를 기준으로 작업하려면 먼저 Git 저장소를 만들어야 합니다. 저장소를 생성하거나 초기화한 뒤 같은 적용 절차를 진행합니다. 아직 실행 가능한 product code가 전혀 없다면--allow-no-tests를 임시 bootstrap 상태로 사용할 수 있습니다. 하지만 영구적인 test 면제는 아닙니다. 실제 구현이 시작되면 project-native test를 만들고 affected-test contract를 갱신해야 정상 개발/릴리즈 qualification을 완료한 것으로 볼 수 있습니다.
Adoption을 채우기 위해 framework, product architecture, release command, operations contract를 AI가 임의로 만들면 안 됩니다.
Canonical template은 다음 repository에서 가져옵니다.
github.com/datarelay-labs/engineering-system
기본 adoption에 필요한 것은 다음 네 가지입니다.
기존 규칙이 많은 저장소
새 always-on rule을 그냥 추가하지 않습니다. 먼저 기존 rule을 다음처럼 분류합니다.Engineering System 적용이 아직 끝나지 않은 저장소
Work Packet은 존재하지만 Engineering System 적용 작업이 별도 PR에서 진행 중일 수 있습니다. Resume 시AGENTS.md 또는 .engineering/*가 없다면:
ENGINEERING_SYSTEM_ADOPTION=ABSENT_OR_PENDING으로 기록- Work Packet이 유효하면 현재 Engineering System 기본 규칙 아래에서 작업 계속
- 현재 workstream이 adoption 자체를 승인하지 않았다면 adoption 파일을 임의로 생성·merge·수정하지 않음
Cursor User resume command 설치
Desktop에서 직접 resume이 필요할 때를 위해 Mac에 command를 둘 수 있습니다./work-resume을 사용합니다. 기본 구현 경로는 IMPLEMENTER=CHATGPT_CHAT인 ChatGPT 직접 구현입니다. 실행 상태 확인과 재접속 방법은 모바일 & 원격 작업을 참고합니다.
ChatGPT Custom Instructions는 짧게
Custom Instructions에는 전체 표준을 복사하지 않습니다. 다음 routing만 남깁니다.- canonical Engineering System 사용
- repository 먼저 식별
- 구현 권한과 대화 이어가기에 repository Work Packet 사용
- 기본 구현자는 ChatGPT이며 Cursor는 명시적 opt-in compatibility로만 사용
- task-relevant context만 읽기
- 실행하지 않은 테스트나 다른 HEAD의 결과를 PASS 근거로 사용하지 않기
선택 사항: Desktop Commander
ChatGPT가 개발 서버를 직접 감사해야 한다면 Desktop Commander Remote MCP를 연결하고 allowed directory를 필요한 범위로 제한합니다.Adoption Qualification
파일이 존재한다는 이유만으로 PASS가 아닙니다. Managed adoption은 필요한 파일, 버전과 기준 SHA, 작업 이어가기 설정, 테스트 정보, CI 담당 범위와 릴리스 연결 상태를 검증합니다. 그 다음 실제 repository의 가장 싼 project-native smoke/affected test를 실행해야 합니다. 최종적으로 다음을 deterministic하게 증명한 경우에만:Session Continuity Smoke Test
긴 prompt를 복사하지 않고 같은 workstream을 ChatGPT가 이어가면 continuity path가 정상 동작하는 것입니다./work-resume은 선택적 Cursor 호환 경로를 명시적으로 켠 경우에만 사용합니다.