CLASSIFICATION: OPEN-SOURCE LICENCE: MIT DOC-GS-001 REV 1.3.1

§01 · JGS GOAL-TO-SPEC KIT

Model the work.
Then build it.

Three composable AI agent skills that turn a rough idea into a hardened engineering specification, one you can trust enough to build from. Tool-agnostic, zero dependencies.

§02 · THE CHAIN

Three skills, run in order. Full reference on the skills page; the step-by-step walkthrough is on the usage page.

01

/goal-formatter

Describe your idea in plain language; get back a structured, testable goal: measurable end state, success criteria, verification method. Self-reviews against a rubric.

02

/goal-spec

Turns the goal into a complete engineering spec, asking targeted clarifying questions grounded in what you said you want, resolving every gap before it's done.

03

/spec-review

An autonomous roundtable (Architect, Security, Test/QA, Operations, Product) critiques the spec round after round until no critical or major issues remain.

§03 · USE IT WITH YOUR AGENT

Native · SKILL.md copied as-is

Claude Code OpenClaw GitHub Copilot CLI

Transform · converted by the installer

OpenAI Codex CLI Gemini CLI Cursor

Pure prompt workflows: no MCP server, no runtime. Detail: docs/other-agents.md.

§04 · INSTALL

Plugin marketplace · Claude Code

/plugin marketplace add jgsystemsconsulting/jgs-goal-spec
/plugin install jgs-goal-spec@jgs-goal-spec

Installer script · any agent

python install.py                 # Claude Code (default)
python install.py --agent gemini  # or codex / cursor /
                                  # openclaw / copilot
python install.py --list-agents

§05 · THEN EXECUTE IT

The kit's deliverable is a trustworthy spec, not a running system. Once spec-review reports convergence, hand the goal + hardened spec to an executor of your choice: Claude Code's /goal, an autonomous loop, or an executor subagent.

The spec's Success Criteria are the acceptance gate: the work is done when every criterion is observably met. That's how the loop closes on a built outcome, not just a written one.