ospec-goal

Orchestrates full OSpec goal workflows with task graphs, worker dispatch, reviews, and verification evidence.

485|25|Updated Mar 31, 2026
One-click install
npx skills add https://github.com/clawplays/ospec --skill ospec-goal
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ospec-goal
Source: https://github.com/clawplays/ospec/tree/main/assets/global-skills/codex/ospec-goal
Command: npx skills add https://github.com/clawplays/ospec --skill ospec-goal

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Complex software changes managed only through chat history lose context, lack reviewable artifacts, and cannot be verified or handed off between AI coding agents. This Skill turns a complex requirement into a durable, spec-driven goal with proposals, design docs, task graphs, worker dispatch, reviews, and verification evidence stored in the repository.

Core Features & Use Cases

  • Full goal lifecycle management: Creates and advances an OSpec goal from requirement intake through proposal, design, implementation plan, task graph derivation, and final archive.
  • Loop-based task dispatch: Drives a session-bound controller Loop that emits bounded action batches, dispatches workers through native subagent primitives, and records durable evidence per task.
  • Deterministic gates and reviews: Runs design and plan preflights, one combined planning review, independent code reviews, and verification checks before allowing archive.
  • Use Case: A developer asks an AI agent to add a multi-service authentication feature. The Skill creates the goal, plans the work into a parallelizable task graph, dispatches workers, collects review findings, records test evidence, and finalizes the change with an auditable trail.

Quick Start

Ask the agent to use the ospec-goal skill to create a new goal for your complex feature request and drive it through planning, dispatch, review, and verification until done.

Frequently Asked Questions about ospec-goal

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run a complex feature through the OSpec goal workflow?

Create the goal with ospec goal <goal-name>, then draft design.md and implementation-plan.md, run design and plan preflights, derive the task graph, and let the Loop dispatch workers. Record evidence with ospec execute verify and close out with ospec finalize once verification passes.

When should I use ospec-goal instead of ospec-change?

Use ospec-goal for complex work needing design docs, task graphs, worker dispatch, and durable evidence. Use ospec-change for small routine changes that only need the classic fast init-change-verify flow.

Which AI coding agents does the OSpec goal workflow support?

The workflow supports Claude Code, Codex/GPT, Gemini, OpenCode, Grok, Cursor, Copilot, and plain CLI harnesses. Dispatch resolves through the runtime adapter's native subagent capability rather than a target name alone.

What happens if a required user decision is pending during a goal?

A required pending decision blocks implementation and task dispatch on every harness until the user answers. The answer must be recorded with ospec execute decision using --answered-by user before the loop proceeds.

Why does goal archive fail even after all tasks complete?

Archive is blocked by unchecked acceptance criteria, missing verification evidence, incomplete task graph fields, unresolved required decisions, or a final review marked NEEDS_CHANGES. Run ospec verify and ospec execute sync to identify the remaining blockers.