메인 콘텐츠로 건너뛰기

Athena 지식 플랫폼

Engineering System에서 말하는 Athena는 우리가 검토하고 채택한 오픈소스 프로젝트 jannismilz/athena를 의미합니다. Athena는 지식 플랫폼을 뜻하는 일반 명칭이 아니라 우리가 사용하는 특정 오픈소스 프로젝트입니다. Data Relay Labs가 처음부터 만든 제품은 아니며, xdr-labs/athena로 fork한 뒤 Engineering System에 필요한 기능을 보강하고 있습니다. Athena는 Engineering System에서 검색과 지식 조회를 위한 보조 계층으로 사용합니다. GitHub, OpenSpec, 코드, 테스트, ADR, 릴리스 검증 자료가 계속 기준 기록입니다.

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입니다.
Athena와 canonical Git 내용이 충돌하면 항상 Git이 우선합니다. 자동 생성된 project page를 authoritative product spec처럼 직접 수정해서는 안 됩니다.

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가 되지 않음
이 결과를 바탕으로 cross-project searchable knowledge layer를 Tela에서 Athena로 전환합니다.

Production 배포 target

현재 production target은 OVHcloud Singapore VPS입니다. 선택한 baseline: OVHcloud는 현재 선택한 운영 인프라일 뿐 Engineering System 규칙의 일부는 아닙니다. 나중에 공급자를 바꾸더라도 Athena는 검색 계층으로, GitHub는 기준 기록으로 유지됩니다.

목표 운영 흐름

최종 목표는 Wiki를 사람이 수동으로 관리하지 않는 것입니다. 사람과 AI는 canonical repository artifact를 관리하고, Athena가 선택된 durable knowledge를 자동으로 동기화하고 색인합니다. 정식 Athena 서버가 준비되기 전까지는 이 transition knowledge가 chat에만 남지 않도록 Tela에 임시로 기록할 수 있습니다.
마지막 수정일 2026년 9월 28일