truecourse-ai/truecourse

어떤 프로젝트인가요?

핵심 기능

• 01PRD, ADR, README, 문서 사이트를 테스트 가능한 주장 모음으로 변환합니다.
• 02실행 중인 제품을 대상으로 각 사용자 흐름의 Playwright 엔드투엔드 테스트를 작성합니다.
• 03실패한 테스트와 상충하는 구체적인 문서 주장을 알려줍니다.
• 04GitHub에서 pull request의 문서 충돌과 테스트 실패를 검사합니다.
• 05Claude Code가 워크스페이스 결과를 조회할 수 있도록 MCP 엔드포인트를 제공합니다.

활용 사례

• 제품이 PRD와 사용자 문서에 설명된 대로 계속 동작하는지 확인합니다.
• 아키텍처 결정 기록과 실행 중인 시스템 사이의 차이를 찾아냅니다.
• 병합 전에 pull request에서 문서 기반 검사를 실행합니다.

빠른 시작

1. 1

   예제 환경 파일을 복사합니다

   cp .env.example .env
2. 2

   Docker Compose로 Postgres를 시작합니다

   docker compose up -d
3. 3

   종속성을 설치합니다

   pnpm install
4. 4

   개발 서버를 시작하고 http://localhost:3000 을 엽니다

   pnpm dev

사용 전 알아둘 점

• !Claude Code 로그인이 필요하며, claude 바이너리가 PATH에 있어야 합니다.
• !truecourse npm CLI는 더 이상 사용이 권장되지 않으며 유지 관리도 중단되었습니다.
• !ee/ 코드를 프로덕션에서 사용하려면 Enterprise 구독이 필요합니다.

포함된 컬렉션

토픽

자주 묻는 질문

truecourse은(는) 무엇인가요?

PRD, ADR, README를 바탕으로 Playwright 엔드투엔드 테스트를 생성하고 제품과 문서의 내용이 다른 부분을 찾아냅니다. TrueCourse는 PRD, ADR, README, 문서 사이트 등 팀에서 이미 작성하는 문서를 읽고 검증 가능한 주장으로 정리합니다. 그런 다음 사용자가 제품을 이용하는 흐름을 파악하고, 실행 중인 인터페이스를 대상으로 각 흐름의 테스트를 작성합니다.

truecourse은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

truecourse은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

truecourse은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. truecourse의 마지막 커밋은 2026년 10월 14일입니다.

truecourse은(는) 어디에 사용할 수 있나요?

제품이 PRD와 사용자 문서에 설명된 대로 계속 동작하는지 확인합니다. 아키텍처 결정 기록과 실행 중인 시스템 사이의 차이를 찾아냅니다. 병합 전에 pull request에서 문서 기반 검사를 실행합니다.

truecourse는 어떻게 설치하나요?

예제 환경 파일을 복사합니다: cp .env.example .env Docker Compose로 Postgres를 시작합니다: docker compose up -d 종속성을 설치합니다: pnpm install 개발 서버를 시작하고 http://localhost:3000 을 엽니다: pnpm dev

truecourse은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/truecourse-ai/truecourse