Getting started with Specnote
How to confirm your app behaves as planned without reading code. New here? Start from Getting started and read in order.
Browse the docs
- Key terms at a glanceAs you use Specnote, you'll run into a handful of terms — workspace, area, scenario, step, verification, credits. Here they are, explained in plain language. Come back whenever something is unclear.
- How verification worksYou're probably wondering what "the AI tries it out for you" actually means. Here's how a real browser replays your scenario, how pass and fail are decided, and how the results are saved.
- Creating testsTests are only created inside the scope you approved. It goes ask → plan review → your approval → tests submitted → first verification, in five steps. You create them all through your AI.
- Running verification and reading resultsOnce your tests are ready, it's time to run verification. Learn how to run it, how to read the pass and fail results, and how to get a fix report and hand it to your AI when something breaks.
- Connect your code (MCP)Specnote's most powerful trait is that it can reach your actual code directly. We'll walk you through connecting AI tools like Claude Code, and how we keep your production secrets from being stored on our servers.
- Test Environments & AccountsThis is where you decide which address verification opens and who it signs in as. Site addresses, test accounts, and safely encrypted secrets — everything to set up before running a verification.
- What You Can Ask Your AIA one-page reference of everything you can ask your Specnote-connected AI to do, with ready-to-use example phrases. Feed this whole page to your AI and it will understand you even better.
- Preparing external connections (payment, email, login)This is where you prepare the parts that rely on outside services — payment, email, social login — for development. Sync your code and Specnote finds these connections automatically; hand the setup instructions to your AI and safe stand-ins appear on your dev server, so you can verify the whole flow from sign-in to checkout.
- Credits and plansCreating tests is unlimited, and you only spend credits when you need verification. Here's everything in one place — what a credit is, how much each task costs, and how plans, top-ups, and refunds work.
- Connect CI for automatic verificationHere's how to make verification run on its own every time you push code. One paste to your AI is all it takes to connect, and results land on both GitHub and the test-run tab. We also cover connecting it by hand and the questions people ask most.
- TroubleshootingWhen the connection fails, a verification won't start, or sign-in steps keep failing — here are the most common symptoms with causes and fixes, in the order worth checking. Most issues resolve by working top-down.
- Frequently asked questionsWe've gathered the questions new users ask most. Quickly check whether you need to know code, whether your data is safe, what to do when something goes wrong, and more.
- What is SpecnoteWithout reading code yourself, Specnote confirms whether the app you (or your AI) built behaves the way you planned — by clicking through it like a real person. Let's start with what problem it solves and who it's for.
- Get your first verification in 5 minutesFollow the first steps from signing up to getting your first verification result — all in under five minutes. You'll create a workspace, ask your AI to make a test, and get back the result of the AI clicking through it for you.
- Connect Your AI (Install MCP)Step-by-step instructions for connecting Specnote to your AI coding tool — Claude Code, Cursor, and any other MCP-compatible tool. Do it once, and from then on just say "create a test for this".
Want to try it right away?
In five minutes you can build your first scenario and get a verification report.