This guide takes you from a new account to a finished set of spec files. It takes about ten minutes, most of it spent answering the interview.
1. Create your account
Sign up
Go to app.myspec.dev and register with your email address, or sign in with Google, GitHub, GitLab, Linear or Atlassian. If you register with email, confirm your address from the email we send you.
Set up your workspace
Create a workspace (an organization) for your team, or choose Skip and set one up for me. If you were invited to an existing workspace, pick it instead.
Tell us your role
Pick the role closest to how you work so MySpec can tailor its questions. You can skip this and change it later.
2. Create a project
- On the Projects page, select New Project.
- Give the project a name and a description.
- Choose a project type:
| Type | Use it when |
|---|---|
| Greenfield | You are starting from scratch. Describe what you want to build. |
| Brownfield | You want to change an existing codebase. MySpec explores the code first, so the description is optional. |
| Auto | You are not sure yet. MySpec decides based on the workflow you pick. |
- Select Create Project.
3. Run a Generate session
A session is a conversation with the AI that produces or edits spec files.
- In your project, start a new chat and choose Generate.
- Answer the interview. Questions are often multiple choice; pick Other to write your own answer.
- MySpec writes each spec file in turn. For each one you can accept it, ask for changes, or review the AI’s own review notes first.
- Repeat until the last stage is done, then complete the session.
The default workflow runs these stages:
| Stage | What you get |
|---|---|
| Interview | Questions about your project’s goals, users and constraints. No file yet. |
| Constitution | constitution.md: guiding principles and non-negotiable rules. |
| Requirements | requirements.md: user stories plus functional and non-functional requirements. |
| Solution | solution.md: architecture, data model and key design decisions. |
| Tasks | tasks.md: a concrete, ordered work plan ready for implementation. |
4. Build from your specs
When the session is complete you can:
- Download the spec bundle as a ZIP file.
- Open it in a vibe-coding tool such as Lovable, Bolt or Replit to scaffold a prototype.
- Generate an AI prompt for Cursor, GitHub Copilot or Claude.
- Connect your coding agent to MySpec over MCP, so it can read the latest specs directly and keep them up to date.
Connect your coding agent
Set up the MySpec MCP server in Claude, ChatGPT, Cursor or your editor.