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）を実装しています。主に2つのモードで動作します：

  1. Change Flow: シンプルな要件のための軽量なパス（init $ ightarrow$ change $ ightarrow$ verify/finalize）であり、進捗を追跡するために一連のMarkdownファイル（提案、タスク、検証、レビュー）を作成します。
  2. Goal Workflow: 複雑な作業のための、より厳格なエージェントプロセス。コントローラーレイヤーを使用してタスクグラフを導出し、並列ワーカーエージェントを割り当て、レビューアゲートを強制し、目標が完了とマークされる前に決定論的な検証エビデンスを要求します。

システムは「Protocol Shell」（.skillrc および .ospec/ ディレクトリを含む）を使用してプロジェクトの知識と状態を維持し、互換性のあるAIエージェントが以前の作業の続きから正確に再開できるようにします。

対象者

一時的なチャットログに頼るのではなく、AIによる変更の検証可能で監査可能、かつ永続的な記録を求める、AIコーディングエージェント（Claude Code、Codex、Gemini、OpenCodeなど）を使用する開発者。

ハイライト

  • リポジトリベースのコンテキスト: 要件と計画をチャット履歴からバージョン管理されたファイルへと移行します。
  • エージェント型コントローラー: 高リスクなタスクに対して、並列ワーカーの割り当てと独立したレビューアゲートをサポートします。
  • ツールに依存しない: さまざまなAIハーネスやCLIワークフローで動作します。
  • 検証可能なループ: アーカイブされる前に、検証エビデンスと独立したレビューを通じて作業が証明されていることを保証します。