clawplays/ospec

해결하는 문제

AI 코딩 어시스턴트는 중요한 요구사항과 의사결정 이력을 주로 채팅 로그에만 저장하는 경향이 있어, 다양한 세션이나 다른 AI 도구 간에 검토하고 일관된 상태를 유지하는 것이 어렵습니다. OSpec은 변경 사항의 맥락(제안, 설계, 계획, 검증 증거)을 프로젝트 리포지토리 내에 직접 지속적으로 저장하는 사양 기반 개발(SDD) 계층을 제공합니다.

작동 방식

OSpec은 "루프 엔지니어링" 워크플로우(계획 → 실행 → 검증)를 구현하며, Claude Code, Codex, Gemini와 같은 AI 에이전트와 통합됩니다. CLI 도구를 통해 요구사항의 라이프사이클을 관리합니다.

1. 초기화: AI 가이드라인과 프로젝트 지식을 저장하기 위한 프로젝트 구조(.ospec/ 디렉터리 포함)를 설정합니다.
2. 변경 관리: 간단한 작업에는 제안 → 작업 → 구현 → 검증으로 이어지는 빠른 흐름(ospec change)을 사용합니다.
3. 목표 워크플로우: 복잡한 작업에는 ospec goal이 설계 문서, 작업 그래프, 병렬 워커 디스패치, 독립적 리뷰, 자동 검증 게이트를 포함하는 더 엄격한 에이전트 프로세스를 트리거합니다.
4. 아카이빙: 변경 사항이 검증되고 배포된 후, 리포지토리 내에 아카이브되어 작업의 영구 기록을 유지합니다.

대상 사용자

AI 코딩 에이전트를 사용하며, 일시적인 채팅 기록에 의존하는 대신, 리포지토리 기반의 검증 가능한 요구사항 및 구현 계획 감사 기록을 원하는 소프트웨어 개발자.

주요 특징

• 사양 기반 개발: 채팅 요청을 리포지토리에 저장되는 영구 파일(제안, 설계, 계획)로 변환합니다.
• 에이전트 컨트롤러: 복잡한 목표에 대해 병렬 워커 디스패치와 리뷰 게이트를 지원합니다.
• 도구 독립성: Claude Code, Codex, Gemini, OpenCode 등 다양한 AI 허브와 호환됩니다.
• 내구성 있는 상태: 진행 상황을 리포지토리에 저장하여 어떤 어시스턴트라도 이전 작업이 멈춘 지점에서 정확히 재개할 수 있습니다.