OLCP 문서

제품

제품 사양은 두 개의 파일로 구성된 하나의 사양입니다. 어느 하나만으로는 구현할 수 없습니다. 각 사양의 섹션 0은 첫 번째 제품 코드 이전에 단일 IMPLEMENTATION_PLAN.md로의 통합을 요구하며, 카드 017이 해당 통합을 실행합니다.

• plan.md - 기반 계획: identity, OAuth, 개인정보 보호, 평가, 멱등성, Voice, 연습 루프 및 네 가지 핵심 도구. 충돌 시 해당 영역을 우선합니다.

• teaching-intelligence.md - 보완적인 Teaching Intelligence 사양: 레슨, 지식 원자, Curriculum Track Compiler, Session Compiler, 교육적 RAG, 편집 수집, CEFR 분류 및 Model Gateway. 충돌 시 해당 영역을 우선합니다.

• context.md - 회사 단계 및 위험 허용 범위: 이 프로젝트가 감당할 수 없는 손상.

• identity/README.md - 원격 MCP 서버를 위한 identity 설계: 인증 서버로서의 WorkOS AuthKit, 리소스 서버로서의 OLCP, 공급자 비교, 미성년자 및 GDPR, 엔드포인트, EU 데이터 보존.

Related MCP server: learn-cli

운영

• execution/s0-readiness.md - 현재 실행 중인 것, 차단된 것, 그리고 identity 스파이크를 해제하는 인간 설정 체크리스트. 첫 번째 코드 카드를 시작하기 전에 읽으십시오.

운영 계약

• agents/SOURCE.md - 복사된 에이전트 계약의 출처와 제자리에서 편집되지 않는 이유.

• agents/workflows/ - 검토, 위험 등급, 결정 로그, 마감 커밋, 랜딩.

• agents/HOSTS.md - 호스트별 모델링할 기능.

연구

1차 소스 보고서. 이들이 뒷받침하는 결정이 여전히 유효하므로 유지됩니다.

• research/mcp-spec-2026-07-28-remote.md - 가져온 MCP 2026-07-28 사양: OAuth, Streamable HTTP, 이중 시대 협상, SDK 및 ChatGPT에 대한 의미.

• research/openai-chatgpt-mcp-voice-research-2026-08-23.md - 2026년 8월 23일 기준 공식 MCP, Voice 및 OAuth 문서. ChatGPT는 2026-07-28을 선언하지 않으며, Voice-in-Chat은 MCP 앱을 문서화하지 않습니다.

개념 증명

저장소 루트의 poc/는 유지된 실험이며 마이그레이션 대상이 아닙니다. learner_id를 허용하고 JSON으로 상태를 유지하는데, 둘 다 제품에서 금지됩니다. 이 실험의 결과가 제품 설계를 정당화했기 때문에 유지되며, 확장해서는 안 됩니다.

• poc/overview.md - 가설, 범위, 기대 결과

• poc/plan.md - 실험이 실제로 따른 계획

• poc/architecture.md - 파일, MCP 도구, 데이터 흐름

• poc/pedagogy.md - 결정적 선택 규칙

• poc/running.md - 테스트, 데모 및 Inspector 실행

• poc/assumptions.md - 의도적 이탈

• poc/cursor.md - 서버를 Cursor에 연결

• poc/catalog-a1.md - 다섯 개의 A1 어휘 항목

• poc/speaking.md - 발음 서버 (Streamable HTTP)

• poc/chatgpt-voice.md - ChatGPT Voice 터널 및 12회 시도 프로토콜

• poc/evaluation.md - 결과에 대한 비판적 평가