Athena 지식 플랫폼
Engineering System에서 말하는 Athena는 우리가 검토하고 채택한 오픈소스 프로젝트jannismilz/athena를 의미합니다.
Athena가 모든 knowledge platform을 통칭하는 일반 명칭인 것은 아니고, Data Relay Labs가 기반 Athena 플랫폼을 새로 만든 것도 아닙니다. 우리는 이 오픈소스 프로젝트를 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을 위해 우리가 새로 만든 것이 아니라 upstream 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 client용 read-only MCP hardening
- dependency 및 CI hardening
RATIONALE_UNKNOWN은 upstream Athena의 내장 기능이나 fork에 hard-code된 기능이 아니라, POC에서 검증한 Engineering System 사용 규칙입니다. AI client에게 canonical material에 WHY가 없으면 추측하지 말고 이 상태를 명시하도록 지시합니다.
이 기능을 추가해도 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의 normative contract는 아닙니다. 나중에 provider를 바꾸더라도 Athena의 역할과 GitHub의 authority는 그대로 유지됩니다.