clawplays/ospec

Spec-driven, agentic workflow framework for AI coding agents. Turn a request into a verifiable goal loop — plan, act, verify — with durable specs and evidence in your repo. Works with Claude Code, Codex, Gemini, OpenCode, and plain CLI.

해결하는 문제

AI 코딩 어시스턴트는 종종 중요한 요구 사항과 의사 결정 컨텍스트를 채팅 기록에만 저장하므로, 서로 다른 세션이나 도구 간에 작업을 검사, 검토 및 재개하기가 어렵습니다. OSpec은 사양 기반 개발(SDD) 레이어를 도입하여 제안, 설계, 계획 및 검증 증거를 포함한 전체 워크플로우를 프로젝트 리포지토리에 직접 저장함으로써 이 문제를 해결합니다.

작동 방식

OSpec은 Claude Code, Codex, Gemini와 같은 AI 에이전트와 통합되는 "Loop Engineering" 프레임워크(plan $ ightarrow$ act $ ightarrow$ verify)를 구현합니다. 두 가지 주요 모드로 작동합니다:

  1. Change Flow: 단순한 요구 사항을 위한 경량 경로(init $ ightarrow$ change $ ightarrow$ verify/finalize)로, 진행 상황을 추적하기 위해 일련의 마크다운 파일(제안, 작업, 검증, 검토)을 생성합니다.
  2. Goal Workflow: 복잡한 작업을 위한 더 엄격한 에이전트 프로세스입니다. 컨트롤러 레이어를 사용하여 작업 그래프를 도출하고, 병렬 워커 에이전트를 할당하며, 리뷰어 게이트를 강제하고, 목표가 완료로 표시되기 전에 결정론적 검증 증거를 요구합니다.

시스템은 "Protocol Shell"(.skillrc 및 .ospec/ 디렉토리 포함)을 사용하여 프로젝트 지식과 상태를 유지하므로, 호환되는 모든 AI 에이전트가 이전 에이전트가 중단한 지점에서 정확히 작업을 재개할 수 있습니다.

대상 사용자

휘발성 채팅 로그에 의존하는 대신 AI 기반 변경 사항에 대한 검증 가능하고 감사 가능하며 영구적인 기록을 원하는 AI 코딩 에이전트(Claude Code, Codex, Gemini, OpenCode 등) 사용자.

주요 특징

  • 리포지토리 기반 컨텍스트: 요구 사항과 계획을 채팅 기록에서 버전 관리되는 파일로 이동합니다.
  • 에이전트형 컨트롤러: 고위험 작업에 대해 병렬 워커 할당 및 독립적인 리뷰어 게이트를 지원합니다.
  • 도구 불가지론(Tool Agnostic): 다양한 AI 하네스 및 CLI 워크플로우에서 작동합니다.
  • 검증 가능한 루프: 아카이브되기 전에 검증 증거와 독립적인 검토를 통해 작업이 증명되었는지 확인합니다.