Codex
.codex는 Lumie의 공용 워크플로 제어 평면입니다. 제품 런타임의 일부는
아니지만, 워크스페이스 전반에서 작업을 어떻게 발견하고, 계획하고, 라우팅하고,
리뷰하고, 문서화할지를 좌우합니다.
.codex에 들어 있는 것
워크스페이스 루트에서 .codex는 각 제품 저장소 내부에 중복되어서는 안 되는
교차 저장소 자동화와 가이드를 담고 있습니다.
- 단계 기반 워크플로와 보조 런북을 위한
skills/ - 전문 역할을 위한
agents/ - 용어집과 저장소별 가이드를 위한
knowledge/ - 저장소 카드와 리뷰 라우팅을 위한
routing/ - 가드레일을 위한
rules/및lint/ - 워크플로 강제를 위한
hooks/ - 격리된 쓰기 작업을 위한
worktrees/
핵심 아이디어는 단순합니다. 제품 저장소는 제품 코드를 소유하고, .codex는
공용 개발자 워크플로를 소유합니다.
기본 워크플로
Lumie의 기본 경로는 /ship 오케스트레이터입니다. 이 경로는 다음 공통 단계를
조합합니다.
Intake → Discover → Spec → Design → Plan → Execute → Verify → Review → Commit → Learn
전체 경로가 필요하지 않을 때는 /discover, /plan, /execute, /verify,
/review 같은 개별 스킬을 통해 같은 단계들을 직접 사용할 수 있습니다.
실무 관례
- 루트
AGENTS.md부터 시작하고, 그다음 영향을 받는 저장소의AGENTS.md를 읽습니다. - 정의 위치, 호출자, 영향 범위 같은 구조적 질문에는 먼저 Graphify를 사용합니다.
- 모든 작업에 하나의 일반 워크플로를 쓰기보다 저장소 경계에 따라 작업을 라우팅합니다.
.codex를 유일한 제어 평면으로 유지하고, 같은 장치를 저장소 로컬 복사본으로 다시 만들지 않습니다.
일반적인 쓰기 작업에서는 각 저장소에서 즉흥적으로 처리하기보다 공용 워크플로가 브랜치 또는 워크트리 격리를 담당하는 것을 전제로 합니다.
실제 저장소 라우팅
워크스페이스는 편집을 시작하기 전에 올바른 가이드가 로드되도록 저장소별 라우팅을 사용합니다.
- 프론트엔드 작업은
.codex/routing/repos/frontend.md에서 시작합니다. - 백엔드 작업은
.codex/routing/repos/backend.md에서 시작합니다. - 워커 작업은
.codex/routing/repos/worker.md에서 시작합니다. - 인프라 작업은
.codex/routing/repos/infra.md에서 시작합니다. - 제품 문서는
.codex/routing/repos/document.md에서 시작합니다.
이렇게 하면 모듈 경계, 리뷰어 기대치, 저장소별 규칙이 서로 어긋나지 않습니다.
Caveman 모드와 가드레일
새 워크스페이스 세션은 사용자가 명시적으로 끄지 않는 한 전체 caveman 실행을
기본값으로 사용합니다. 실무적으로는 범위가 불분명하거나 교차 저장소일 때 Lumie가
더 철저한 워크플로를 기본으로 선호한다는 뜻입니다.
어디서나 중요한 상위 규칙 두 가지가 있습니다.
- 최종 커밋은 수동
git commit이 아니라 가드된/commit흐름을 거칩니다. - 제품 문서, 코드, 인프라 변경은 완료로 간주하기 전에 실제 저장소 상태와 대조해 검증해야 합니다.
문서 작업에서 이것이 중요한 이유
문서 작업에서 .codex는 주로 라우팅과 일관성을 돕습니다.
- 제품 문서를 Docusaurus 전용 문서 생성 규칙으로 연결합니다.
- 영문 원본 페이지와 현지화 작업을 구분합니다.
- 코드 및 플랫폼 작업과 같은 저장소 경계를 기준으로 문서를 정렬합니다.
그래서 문서 업데이트는 보통 페이지 자체를 편집하기 전에 루트 규칙,
lumie-document 저장소 규칙, 문서 라우팅 맵을 함께 확인하게 됩니다.
다음에 볼 문서
- 문서화에서 Docusaurus 전용 작성 규칙을 확인하세요.