The Spec Builder
A knowledge file, not a program. It interviews you and writes the specification the factory builds from.
CODEHERO_PLANNING_GUIDE.md
Open it in the browser instead →What it is
The Spec Builder is a Markdown file you add as knowledge to a claude.ai project or a ChatGPT project. From then on that assistant becomes the Spec Builder: it interviews you in plain language, one question at a time, in your own language. It decides every technical matter itself. It writes the specification, runs fifty review-and-fix rounds and a final consistency check on it, and hands you a specification package that CodeHero PRO builds from without a human in the build loop.
You are never asked about databases, servers or frameworks. You are asked how your work actually happens, with a real example, and only what the picture still lacks.
How to use it
Download the file
Use the button above. It is one Markdown file; nothing to install.
Create a project and upload the file as knowledge
In claude.ai: Projects → New project → add the file to the project knowledge. In ChatGPT: Projects → New project → add the file. One project per application you want built.
Set the project instruction
Paste this as the project's instructions (custom instructions):
Start the conversation and answer one question at a time
The Spec Builder opens by asking which piece of your work you want to organize or automate, with a real example of what happened last time. Upload spreadsheets, forms or screenshots whenever you have them; it reads them before asking more. Say “I don’t know” when you don’t: technical questions are its job, and every assumption it makes stays visible with its status.
Hand the package to CodeHero PRO
When the package is marked Ready to build, paste it into CodeHero PRO → AI Assistant → Plan with AI. The planner imports it, shows you a preview, and when you approve creates the project and one planning ticket that carries the package. That ticket plans on your installation and creates the tickets, phase by phase. From there the factory builds, verifies and reports.
What comes out
A specification package: the application described in your words, every requirement and decision carrying one of four statuses (Confirmed, Assumed, Technical decision, Open), the technical choices with one-line justifications, the environment the factory must prepare, the run settings, and the ticket plan in the order the work happens. Documentation for every role is part of the package by default.
Delivered when you stop early. Open items are listed at the top, never hidden. Good for a first estimate or a capability probe.
The critical open items of the agreed scope are closed. This is what the planner turns into a project.
The package names developer roles and think modes, never AI providers. Your CodeHero installation assigns the models it has.
Who it is for
- Domain experts inside a company: the interview needs no technical knowledge.
- Partners who prepare projects for their clients: the same file, the same method, every time.
- Developers who want a complete, reviewed specification before the first ticket is written.
Go deeper
CodeHero PRO implements ADF, the Autonomous Development Framework.