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
| # | Stage | Produces | Gate |
|---|---|---|---|
| 1 | Requirements interview | docs/PRD.md | Your approval |
| 2 | Phased roadmap | docs/PLAN.md | Your approval |
| 3 | Architecture (with options if unsure) | docs/ARCHITECTURE.md | Your approval |
| 4 | Coding rules | project CLAUDE.md | Your approval |
| 5 | Coding + living state snapshot | code + docs/PROJECT_STATE.md | Phase checkpoints |
| 6 | Unit → integration → e2e testing | docs/TEST.md + test_reports/ | All tests pass |
| 7 | Deployment for your platform | docs/DEPLOYMENT.md | Your approval |
Design
- Token-efficient: thin router
SKILL.md; only the active stage's instructions are ever loaded into context. - Resumable:
docs/WORKFLOW_STATE.mdtracks the current stage — new sessions pick up where you left off. - State snapshot, not changelog:
PROJECT_STATE.mdis 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-docsskill for a sharper requirements interview (falls back to built-in questions) - Optional:
ghCLI authenticated, for automatic issue creation
License
MIT