all-you-need

A spec-first engineering workflow orchestrator for Claude Code. It guides a project through the full professional development lifecycle — no code before the specs are approved.

Idea → PRD → Plan → Architecture → Rules → Code → Test → Deploy

Why

AI agents jump straight to code and guess at requirements. This skill forces the workflow a senior engineer would follow: interview first, document decisions, gate each stage on your approval, keep a bounded state file so any model can resume the project without re-scanning the repo.

Install

Any agent via skills.sh

npx skills add nubbot77/all-you-need

Claude Code (native plugin)

/plugin marketplace add nubbot77/all-you-need
/plugin install all-you-need@all-you-need

Then in any project, say "start workflow" or invoke /all-you-need.

OpenAI Codex CLI

git clone https://github.com/nubbot77/all-you-need ~/.all-you-need
mkdir -p ~/.codex/prompts
cp ~/.all-you-need/agents/codex/all-you-need.md ~/.codex/prompts/

Then run /all-you-need inside Codex.

Gemini CLI

git clone https://github.com/nubbot77/all-you-need ~/.all-you-need
mkdir -p ~/.gemini/commands
cp ~/.all-you-need/agents/gemini/all-you-need.toml ~/.gemini/commands/

Then run /all-you-need inside Gemini CLI.

Cursor, Windsurf, Aider, any other agent

git clone https://github.com/nubbot77/all-you-need ~/.all-you-need

Paste the block from agents/AGENTS-snippet.md into your agent's instructions file (AGENTS.md, .cursor/rules, .windsurfrules, CONVENTIONS.md, …), then say "start workflow".

Update on any agent: git -C ~/.all-you-need pull (Claude Code users update via /plugin).

Stages

Design

• Token-efficient: thin router SKILL.md; only the active stage's instructions are ever loaded into context.
• Resumable: docs/WORKFLOW_STATE.md tracks the current stage — new sessions pick up where you left off.
• State snapshot, not changelog: PROJECT_STATE.md is rewritten in place; git history handles the past.
• Small-task escape hatch: bugfixes skip the ceremony — change, regression test, state update, done.
• Git-safe: commits and pushes after each approved stage; never merges, rebases, or deletes without an explicit ask. Found bugs become GitHub issues automatically.

Requirements

• Any supported coding agent (Claude Code, Codex CLI, Gemini CLI, Cursor, Windsurf, Aider, …)
• Optional: grill-with-docs skill for a sharper requirements interview (falls back to built-in questions)
• Optional: gh CLI authenticated, for automatic issue creation

License

MIT

{
  "name": "all-you-need",
  "owner": {
    "name": "nubbot77"
  },
  "plugins": [
    {
      "name": "all-you-need",
      "source": "./",
      "description": "Spec-first engineering workflow orchestrator: PRD → Plan → Architecture → Rules → Code → Test → Deploy, with approval gates and token-efficient progressive disclosure."
    }
  ]
}