Turn vague ideas into documented, buildable software projects
A skill that turns a vague project idea into eight structured, confirmable planning documents before any code is written.
Why it matters
Transform any project idea-no matter how vague-into a complete, documented development plan with 8 living documents that serve as persistent memory and source of truth throughout the entire build process, ensuring alignment between user intent and implementation.
Outcomes
What it gets done
Generate PRD, tech spec, schema, and 6 other planning documents from minimal user input
Enforce user commands as final authority and auto-sync all affected documents when requirements change
Guide interactive design decisions by asking for style direction and color palettes before documenting
Track implementation progress and maintain append-only history of completed work
Install
Add it to your toolbox
Run in your project directory:
curl -fsSL https://spark.entire.vc/get/ag-not-a-vibe-coder | bash Overview
Not-a-Vibe-Coder
A skill that turns a vague project idea into eight structured planning documents - PRD, tech spec, flows, schema, plan, rules, and design - confirmed one at a time. Use only for brand-new projects with no existing code, starting from a vague idea or a detailed spec.
What it does
Not-a-Vibe-Coder is a skill that turns a vague project idea into eight structured, living planning documents that act as the project's persistent memory across a long context window - PRD.md, TechSpec.md, AppFlow.md, Design.md, Schema.md, ImplementationPlan.md, Tracker.md, and Rules.md.
When to use - and when NOT to
Use this only for brand-new projects with no existing code - it explicitly aborts if the project already has code files. It's triggered by a one-line idea like "build me a restaurant ordering app" or a fully detailed spec, and it treats the user's live instructions as always overriding the files: if a user's statement contradicts a document, the user wins and the relevant file gets updated to match, never the reverse.
Inputs and outputs
Follows a five-phase workflow: Phase 0 detects intent and aborts on existing codebases; Phase 1 builds PRD.md first through clarifying questions on audience, core features, platform, and must-haves versus nice-to-haves, or a skeleton with placeholders if the user wants to fill it in themselves, confirmed before moving on; Phase 2 drafts the remaining files one at a time in order - TechSpec.md, AppFlow.md, Schema.md, ImplementationPlan.md, Rules.md, Tracker.md - each proposed, shown, and confirmed before the next; Phase 2.5 handles Design.md as always-interactive, asking for style direction and a color palette, or offering 2-3 options, before writing anything, never filled from the assistant's own taste; Phase 3 is a final review of all eight files, explicitly asking what to change before building starts; Phase 4 builds step by step against ImplementationPlan.md, checking items off in the append-only Tracker.md, and never deviating from the plan, rules, tech spec, or schema without explicit instruction. A mid-project pivot, like switching from Firebase to Postgres, updates every affected file proactively and gets summarized to the user rather than requiring a file-by-file request.
Integrations
Core rules govern every phase: no silent additions of features, tech, or rules the user didn't approve; one file at a time unless the user asks for all at once; and, when a user explicitly says "you decide" or "brainstorm it," the skill makes a reasoned, PRD-consistent choice rather than a random default, still surfacing it for review. It reads all eight files at the start of a session if they already exist, since they are its persistent memory, and can use ask_user_input_v0 for quick multiple-choice clarifications during PRD and Design.md gathering.
Who it's for
Builders starting a brand-new app from a vague idea who want a structured, confirmable planning process instead of jumping straight into code, with documentation that stays in sync as the project's direction shifts mid-build.
FAQ
Common questions
Discussion
Questions & comments · 0
Sign In Sign in to leave a comment.