Spec Mode

Thoughtful planning for features and services — before writing any code.

01Constitution

The first step — optional but recommended. The constitution is a document that sets the rules for the entire project:


  • Description of the service — what it is, why, for whom
  • Core development principles
  • Coding style — naming conventions, structure, architectural decisions
  • Code style examples
  • What's allowed, what's not
  • Approach to testing, deployment, etc.

    • The agent uses the constitution at every subsequent stage — the plan and implementation will follow it.

    021. Discussion

    Create a new feature and start talking with the agent — describe what you want, ask questions, ask for ideas. It's a free-form conversation. As you talk, the agent builds an understanding of the task.

    032. Spec

    When you're done discussing — click the button or tell the agent to write the spec. The agent produces a structured document: feature goals, constraints, design decisions.


    Read the spec. Edit if needed. You can add code examples, clarify details, remove things that don't fit.

    043. Plan

    Click the button or tell the agent to write the plan. The agent takes the spec and the constitution and produces a detailed implementation plan that follows all the rules.


    Read the plan. Make edits if anything is off.

    054. Tasks

    Click the button or tell the agent to create tasks. The agent breaks the plan into concrete tasks ordered by dependencies.


    Read the tasks. This is still the easy time to change things.

    06Clarify and Analyze

    At any point before implementation you can:


  • Clarify — the agent asks targeted questions about underspecified areas
  • Analyze — the agent checks whether the implementation might break existing functionality

    • 075. Implementation

    Say or click Implement — the agent starts executing tasks in order. A dedicated panel shows progress: which task is in progress, which are done.


    When finished — run tests. If tests were mentioned in the constitution or tasks, the agent already wrote and ran them.

    086. Review and merge

    Review the code, check the Preview to see how it works. When you're happy — merge and push yourself, or tell the agent to do it.

    09Who it's for

    Architects, tech leads, anyone who wants to plan thoroughly before building. You can run the full planning pipeline with the agent and then hand off the tasks to a team — or export them to GitHub, GitLab, Jira and other trackers.


    *Task export to external trackers is coming soon.*