Skip to content
Maestro

For people building their first serious app with AI

You have an app idea.
Maestro helps you build it properly.

Describe the app you have in mind. Maestro turns it into a clear plan, gives Claude Code or Codex the instructions it needs, and checks the important things as your product grows.

You bring the product idea. You do not need to be a Convex or architecture expert.

maestro / build plan checks passed
01 / your ideaplanned

“Build a client knowledge workspace with approval flows.”

screen
feature
capability
workflow
domain
schema

customer data kept separate

data retention decided

reliable workflows checked

agent instructions ready

handoff checks recorded

just verify → PASS

Works where you work

Claude CodeOpenAI CodexConvexGuided setupBuilt-in checks

Why Maestro

The first feature is easy. Will the app still make sense after fifty?

A coding agent can make something impressive in an afternoon. The harder part is keeping the app understandable, safe, and easy to change after dozens of new prompts and sessions.

Without a system

  • ×Every new session has to guess how the app is supposed to work.
  • ×The same product rule gets rebuilt differently in several places.
  • ×Permissions, retries, and data cleanup are only noticed after something breaks.
  • ×If the page loads, it is tempting to assume the feature is finished.

With Maestro

  • Every agent starts with the same map, instructions, and approved building blocks.
  • Your product rules live in one dependable place instead of being copied around.
  • Automatic checks catch important mistakes while they are still small and fixable.
  • Clear results show what was actually tested before you share or release the app.

The working loop

From “I have an idea” to a clear, buildable app plan.

  1. 01

    Explain what you want

    Answer practical questions about your users, what they need to do, what information the app holds, and what a useful first version should include.

  2. 02

    Start with a sound structure

    Maestro creates the right starting points for your screens, product actions, data, and automated workflows, with important safety decisions included from the beginning.

  3. 03

    Build, check, and improve

    Claude Code or Codex builds the product while quick checks guide the work. Before you hand it over or release it, a full check shows what passed and what still needs attention.

Start locally without paid services

pnpm template:quickstart -- --name "My App" --write
no API keys required

Helpful guidance. Firm checks.

Freedom to shape the product. Protection for the things that should not break.

Maestro does not try to control every line your coding agent writes. It explains the project, provides trusted ways to add common parts, and automatically checks the safety and structural rules that should not be left to memory.

~

Guidance while you build

a map of the appparts you can reuseofficial Convex guidancestep-by-step playbooksrecorded decisionsClaude + Codex instructionsa safe place to experiment
!

Checks for costly mistakes

clear app structureseparate customer datareliable workflowsconsistent product rulessafe integrationsdata retention + deletionno exposed secretsproof before release

What Maestro looks after

The invisible parts of your app matter too.

Structure

A codebase that stays understandable

Maestro gives every new feature a sensible home, so the app does not become harder to change each time you add something.

Convex

Convex guidance built in

Your coding agent gets current Convex guidance for data, sign-in, permissions, migrations, and performance instead of guessing from old examples.

Workflows

Reliable multi-step work

Checks cover the details that make automated work dependable: who started it, what happens on a retry, how failures recover, and when old data is cleaned up.

Consistency

One version of how your product works

The website, integrations, command line, and agent tools all use the same product rules, reducing duplicated logic and surprising differences.

Your agent

Clear instructions in every session

Claude Code and Codex can read the plan, the project rules, and the approved ways to add things. You keep using the coding tool you already know.

Checks

Know what passed before you ship

Maestro checks structure, privacy, data safety, and the finished build, then records clear results you or a developer can review.

Easy to pick up again

Your next coding session should not start from zero.

The plan, important decisions, app structure, and working instructions stay inside the project—not buried in an old chat. A new Claude Code or Codex session can understand what exists, what to reuse, and how to continue safely.

prompt / new-session.txt
“Read AGENTS.md. I want to build a workspace that turns client research into approved campaign briefs. Help me plan the first version, reuse what is already here, and run the project checks as you build.”
AGENTS.mdCLAUDE.mdConvex AIskills/

Questions worth asking

What Maestro handles, what you decide, and where experienced help still matters.

I have never built an app before. Is Maestro for me?

Yes—if you can explain who the app is for, what they need to do, and what a useful first version looks like. Maestro helps turn those answers into a sensible build plan and gives your coding agent a well-structured place to start.

What do I need to know before I start?

You do not need to know Convex or software architecture. You do need to make product choices: who your users are, what problem you are solving, and what should happen in the app. Maestro supplies the technical starting point and asks useful questions when a decision matters.

Does Maestro build the whole app for me?

Claude Code or Codex writes the code with Maestro guiding and checking the work. You still decide what the product should do, review what you see, and test it with real users. Maestro is the building system around your coding agent, not a replacement for your judgment.

Why not just prompt Claude Code or Codex directly?

You can, and those tools can create features very quickly. The trouble usually appears later: every session makes slightly different choices, important safety details are missed, and the app becomes difficult to change. Maestro gives each session the same map, rules, starting points, and checks.

Will I still need a developer?

You can get much further before you need one. For a serious launch, an experienced developer should still review decisions involving sensitive data, payments, security, compliance, or unusual scale. Maestro makes that review easier because the project is structured and its checks are visible.

What can I build today?

The Maestro template is available now on GitHub for web applications built on Convex with Claude Code or Codex. It includes the app structure, guided starting points, agent instructions, and checks. You can create your own copy and begin with the included quickstart guide.

Open-source template

Start with a structure you can keep building.

Create your own copy of Maestro on GitHub, open it with Claude Code or Codex, and follow the included guide from your app idea to a checked, working foundation.

View the template on GitHub