Athena 지식 플랫폼
Engineering System에서 말하는 Athena는 우리가 검토하고 채택한 오픈소스 프로젝트jannismilz/athena를 의미합니다.
Athena는 지식 플랫폼을 뜻하는 일반 명칭이 아니라 우리가 사용하는 특정 오픈소스 프로젝트입니다. Data Relay Labs가 처음부터 만든 제품은 아니며, xdr-labs/athena로 fork한 뒤 Engineering System에 필요한 기능을 보강하고 있습니다.
- Upstream: https://github.com/jannismilz/athena
- 우리 fork: https://github.com/xdr-labs/athena
Athena는 Wiki.js가 아닙니다
Wiki.js는 Athena 안에 포함되는 구성요소 중 하나입니다. 쉽게 말하면 Athena가 우리가 채택한 전체 knowledge platform이고, Wiki.js는 그 안에서 사람이 보는 Wiki UI입니다.원래 Athena에 이미 있는 구성요소
아래 구성은 우리가 Engineering System을 위해 새로 만든 기능이 아니라 원래 Athena에 포함되어 있습니다.우리 fork에서 추가한 부분
우리는 Athena를 Data Relay Engineering System에 맞추기 위해 다음을 추가했습니다.- GitHub/OpenSpec → Athena synchronization 및 generated knowledge projection
projects/<project>/...구조와 project-scoped retrieval- repository, ref, source path, Git blob까지 이어지는 provenance
- AI 클라이언트용 읽기 전용 MCP 보강
- 의존성과 CI 안정성 보강
RATIONALE_UNKNOWN은 Athena 자체 기능이 아니라 POC에서 검증한 Engineering System 사용 규칙입니다. AI 클라이언트는 검색한 기준 자료에 결정 이유가 없으면 추측하지 않고 RATIONALE_UNKNOWN을 반환합니다.
이 기능을 추가해도 authority는 바뀌지 않습니다. GitHub/OpenSpec이 canonical이고 Athena는 derived layer입니다.
현재 POC에서 이미 실제 동작한 것
아래 구성은 계획만 세운 것이 아닙니다.dev-dp-mirror POC 서버에서 이미 실제로 실행하고 검증했습니다.
다만 이것은 POC 서버에 적용된 상태입니다. 정식 OVHcloud 서버는 아직 provisioning 중이며, 위 stack은 아직 production 서버로 이전하지 않았습니다.
Source of Truth 규칙
Athena는 의도적으로 derived layer입니다.POC에서 확인한 것
Data Relay Link POC에서 Engineering System에 필요한 핵심 사용 흐름을 실제로 검증했습니다.- Cursor가 MCP를 통해 Athena에 연결됨
- 한국어와 영어 질문 모두 semantic search 가능
- 현재 계약과 과거 design rationale을 구분해 검색 가능
- Cursor가 Wiki path와 원본 OpenSpec source path를 함께 반환 가능
- canonical material에 WHY가 없으면 이유를 만들어내지 않고
RATIONALE_UNKNOWN으로 응답 - current spec과 archived decision history를 함께 색인하면서도 Athena가 source of truth가 되지 않음
Production 배포 target
현재 production target은 OVHcloud Singapore VPS입니다. 선택한 baseline:
OVHcloud는 현재 선택한 운영 인프라일 뿐 Engineering System 규칙의 일부는 아닙니다. 나중에 공급자를 바꾸더라도 Athena는 검색 계층으로, GitHub는 기준 기록으로 유지됩니다.