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コーディングアシスタントは、重要な要件や意思決定の履歴をチャットログにのみ保存する傾向があり、異なるセッションや異なる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ハーネスと互換性があります。
  • 耐久性のある状態: 進捗をリポジトリに保存するため、どのアシスタントでも前の作業が停止した場所から正確に再開できます。

関連

  • プロジェクト
  • プロジェクト
  • プロジェクト
  • Dispatch
  • プロジェクト