v3.1.0 — The Agent-First Release

Release Date: August 20, 2026

📦 Release Archive: vibe-coding-prompt-template-v3.1.0.zip (~261 KB)

🌟 Highlights

• Your Agent Runs the Workflow Now: tell Claude Code, Cursor, Codex, or Gemini CLI to npx vibeworkflow and it takes over — installs the planning skills, interviews you, writes your PRD and Tech Design, and scaffolds the agent files. You only answer questions. The CLI is published on npm.
• One Question at a Time, For Real: the skills now tell your agent to use its own question tool and ask a single question per turn. Previously the CLI printed a shortcut interview to stdout, so agents took it and you got about ten shallow questions instead of the full flow.
• The CLI Finds Your Tools: it detects Claude Code, Cursor, Codex, and Gemini from your environment and existing config folders, and only writes configs for what you actually use. --tools still overrides.
• Re-Running Is Safe: scaffolding never overwrites a file you have already filled in. Run it as many times as you like; pass --force if you actually want a reset.
• README Gets to the Point: the 5 steps and the npx vibeworkflow command now sit in the first screenful under "Start here". They used to start at line 115, behind a table of contents, a project showcase, and a diagram.
• Research and Tech Design Stop Forgetting: ## Handoff Context blocks now close part1 and part3 too, so later steps confirm your level, platform, budget, and timeline instead of asking again. Part 2 already had this from v3.0.0.
• Fabricated Cursor Setup Removed: part3 no longer tells you to install from cursor.sh or to set ai.autoComplete and ai.explainCode — that domain and those settings keys do not exist.
• CI Is Green Again: Repo Lint had been failing on main since v3.0.0. Inside a YAML args: >- block, # does not start a comment, so the link checker's comment lines were being passed to it as arguments and it never ran. Fixed.
• Releases Publish Themselves: the CLI ships from cli-v* tags using npm Trusted Publishing over OIDC — no npm token stored in the repo, nothing to rotate. Repo tags like v3.1.0 no longer trigger an accidental npm publish.
• Docs Have a Shape: docs/ is now split into ai/, tools/, workflow/, and maintenance/ with an index at docs/README.md, plus a new build-paths guide for picking your stack.
• Removed llms.txt: this repo is not a website, so it was never served at a well-known path and only duplicated the docs index. Guidance telling you to add one to your project is unchanged.
• ⚠️ Note for CLI users: vibeworkflow's own interview is gone, along with the --level and --answers flags. The skills' interviews are the only interviews now. Bare npx vibeworkflow is the command to remember.

📁 What's Included

• Core Prompts: all 4 prompt parts (part1–part4), with Handoff Context blocks in 1–3 and JSON meta blocks in 2–3.
• cli/: the vibeworkflow npm package — zero dependencies, 17 tests, publishes over OIDC.
• .claude/ and .agents/: the vibe skills (research, prd, techdesign, agents, build, review, workflow), each with Interview Rules and handoff wiring.
• templates/: AGENTS.md, MEMORY.md, REVIEW-CHECKLIST.md, agent_docs/, per-tool configs for Claude Code, Cursor, Codex, Gemini, and Copilot, plus tool-adapters/.
• examples/: the reddit-to-ai worked example, showing the full paper trail.
• docs/: indexed and split into ai/, tools/, workflow/, maintenance/ — including the new build-paths guide and the changelog.
• .github/: repo-lint (contract checks + working link checking), cli-test, release-cli, greetings, pr-size-labeler.
• scripts/: validate.py — 13 contract checks you can run locally.
• Root Files: README.md, LICENSE, CITATION.cff, .gitignore.