Skip to main content

Spec-Driven AI Workflows for Flutter

You're already using AI to write Flutter code. Now make it write code you trust. ACT is a structured workflow from requirements to verified implementation — where problems are caught early, not in the code review.

Works with Claude Code, Codex, Cursor & more

What Flutter developers are saying

Testimonial from Holger Matthies: I'm loving ACT. It's accelerating me and giving me more confidence, more control . Repeated review runs catch different critical findings, and that helps me turn a rough spec into something solid before implementation starts. The walkthrough reassured me that I'm using ACT as intended , and that alone made it worth the time. Thank you for ACT, it's truly making a difference .
Holger Matthies

Holger Matthies

Flutter developer

Testimonial from Jason Holt: ACT is a pretty thoughtfully designed toolkit. It's been really fantastic for me. I've used/tried a few of these different things (superpoweres, planning with files, the vgv AI toolkits) but the design of your system is definitely the most thoughtful and complete . It works really really well together without me having to chase down a new skill everytime.
Jason Holt

Jason Holt

Founder of Jason Holt Digital

AI coding tools are fast. But fast at what, exactly?

AI agents are great at following patterns and writing lots of code — when you give them the right structure. Without it, they infer missing requirements, make product decisions, and guess at your conventions, often going off-track. AI is a multiplier — of whatever process you give it. The speed is real. The confidence isn't.

"My codebase started consistent. Six weeks later, it feels like a house of cards."

AI follows local context. When conventions and decisions are not documented, patterns drift as features pile up.

"I spend more time reviewing AI code than writing it myself."

The AI produces something, but you can't trust it without reading every line. That's not faster — it's just different work.

"Great news: 100% passing tests. Small detail: half of them are disabled."

AI agents optimize for completion. They will chase green checks with brittle, shallow, or disabled tests that fail to protect real behavior.

"I gave it a vague prompt and got exactly what I deserved."

Without a proper spec, the AI fills in the blanks with guesses. And you don't discover the wrong assumptions until the PR review.

"The code works, but it doesn't look like Flutter."

AI agents write code that compiles. They don't write code that follows Flutter conventions — widget composition, proper state management, theme extensions, idiomatic patterns. You end up fighting the agents or rewriting by hand.

"Every session starts from zero."

You solved this exact problem last week. But the context is gone and the AI has no memory of what worked. Without a way to capture and reuse insights, every session reinvents the wheel.

Now imagine a different workflow

You describe what you want to build. The AI asks questions (rather than guessing) and writes a detailed specification, then a second pass tears it apart — finding gaps and wrong assumptions before a single line of code is written.

Then it breaks the spec into focused tasks and implements one bounded piece at a time. Tests lock in behavior and keep future runs aligned.

What if your AI agent actually worked this way?

Introducing the

Agentic Coding Toolkit

Agentic Coding Toolkit (ACT) is a collection of commands, agents, skills, and a Flutter knowledge base that turns AI-assisted development into a structured workflow from spec to PR.

ACT is fully open-source readable, installs in two commands, and works with any Flutter or Dart project without changing your project structure.

ACT supports Claude Code, OpenCode, Codex, GitHub Copilot CLI, Cursor, and Antigravity. You'll need one of these installed, along with your preferred LLM subscription or API key.

See it in Action

Watch ACT take a feature request through interview, spec, task breakdown, and execution, with each step verified along the way.

This walkthrough shows the core ACT idea: clarify requirements, write a spec, break work into tasks, and implement it. Some commands and details have changed; use the Quickstart for the current workflow.

Five skills. One predictable workflow

From requirements to verified implementation with guardrails at every step

1

Interview

You describe the feature. The AI asks clarifying questions and helps you iterate until all user flows, edge cases, and error scenarios are covered.

2

Create a spec

The answers become a traceable spec and decision record, with requirements you can review before any implementation starts.

3

Refine the spec

Optional but recommended

A second pass roasts the spec — looking for gaps, wrong assumptions, and misalignment with your existing codebase.

4

Create tasks

Turn the spec into focused implementation tasks with acceptance criteria, dependencies, and the context needed for handoff.

5

Implement

The AI implements one focused task at a time, running the relevant checks and reporting what changed.

Everything your AI agent needs to write code you trust

Six pillars that transform AI-assisted Flutter development from chaotic to predictable

Spec-Driven development

AI works from detailed specs, not vague prompts. Each spec includes user flows, edge cases, and error scenarios — then gets reviewed for gaps before implementation starts.

Structured Workflows

A repeatable cycle where each stage produces artifacts that feed the next. Interview to spec to implementation tasks — with guardrails at every step.

Test-Backed Delivery

Tests are baked into implementation so behavior stays explicit and future agent runs stay on track. TDD-style guidance when it helps — without turning every task into ceremony.

Robot Testing

Encode user journeys as robot-driven widget tests with stable selectors and deterministic test seams. Real user flows, not isolated unit checks.

Flutter Knowledge Base

10 principles. 15+ patterns. Breaking changes docs. Setup recipes. Available when specs are refined, tasks are created, and code is implemented — not as an afterthought, but as the foundation.

Git Workflow

Conventional commits, automatic PR creation with smart descriptions, and full git worktree support for isolated parallel feature development.

The complete toolkit at a glance

Everything included in the full toolkit, organized by skill type, supporting agents, and Flutter knowledge base.

Skill What it does
/act-config Configure ACT workflow storage and project setup once before using the workflow
/act-interview Ask focused questions before requirements are written, so the agent does not guess
/act-create-spec Create specs with user flows, edge cases, acceptance criteria, and a record of key decisions
/act-refine-spec Adversarially review specs for gaps, wrong assumptions, and codebase misalignment
/act-create-issues Turn specs into focused implementation tasks with clear acceptance criteria
/act-implement Implement one focused task at a time with context, testing, and verification

Built for Flutter developers who use AI agents

You're past tab-autocomplete. You've used tools like Claude Code and Codex to build real features, and you've seen what happens when the AI works without guardrails. Architecture drifts. Tests pass for the wrong reasons. Every session starts from scratch.

You don't want to stop using AI. You want it to work your way — following your patterns, writing proper specs, and producing code you'd actually approve in a PR review.

Whether you're working solo or on a team, ACT gives you that structure.

This isn't for vibe coders. It's for engineers who care about what they ship.

Build With AI Workflows You Can Trust

Start with Lite for the core workflow. Upgrade to Pro for Flutter/Dart expertise, Git workflow support, background agents, setup recipes, testing guidance, and the full toolkit.

Lite - Free

Experience how Spec-driven development changes the way you build with AI.

$0 forever

Includes:

  • Core spec-to-implementation workflow
  • Interview, spec review, task breakdown, and implementation skills
  • Store workflow artifacts locally or in GitHub issues
  • Full docs site
  • Monthly updates

Pro - Yearly

Best for AI coding on real projects that require testable and maintainable code.

$39 /year

Includes full toolkit access and updates while your subscription is active:

  • Everything in Lite, plus Flutter-specific workflow skills
  • Git workflow guidance, commit/PR support, and worktree setup
  • Flutter/Dart setup, testing, migration, and verification skills
  • Background research agents
  • Flutter knowledge base (10 principles, 15+ patterns)
  • Weekly updates
Recommended

Pro - Lifetime

Best value if you want long-term updates with no renewals. One purchase, lifetime access.

$99 one-time

Includes lifetime access to the full ACT toolkit and all future updates:

  • Everything in Lite, plus Flutter-specific workflow skills
  • Git workflow guidance, commit/PR support, and worktree setup
  • Flutter/Dart setup, testing, migration, and verification skills
  • Background research agents
  • Flutter knowledge base (10 principles, 15+ patterns)
  • Weekly updates
30-day money-back guarantee

I've put a lot of care into making this toolkit genuinely useful and I'm confident you'll find it valuable.

But the only way to know if it's right for you is to try it. Get the toolkit, run the workflow on a real feature, and see the difference for yourself.

If you're not happy with it, for any reason, reach out via the contact page within 30 days and I'll issue a full refund within 24 hours.

About the Author

Hello, I'm Andrea

Andrea Bizzotto

I'm a Flutter GDE and I've been writing code professionally for over 15 years. With my Flutter tutorials and courses, I've helped thousands of developers become better at building Flutter apps over at Code with Andrea.

The Agentic Coding Toolkit is the system I use daily to build Flutter apps with AI assistance — and now it's available to you.

Frequently asked questions

What is the difference between Lite and Pro?
ACT Lite gives you the core spec-to-implementation workflow: interview, spec creation, spec review, task breakdown, and implementation. ACT Pro adds the Flutter/Dart-specific toolkit: Flutter workflow skills, Git support, background research agents, setup recipes, testing guidance, migration skills, and the full Flutter knowledge base.
Which platforms does ACT support?
ACT currently supports Claude Code, OpenCode, Codex, GitHub Copilot CLI, Cursor, and Antigravity.
Which platform works best with ACT?
OpenCode is my recommended CLI for most developers because it has excellent UX/DX, works with many models from different providers, and maps cleanly to ACT's workflow.
What if I use Cursor or VSCode?
Cursor is supported. ACT is also editor-agnostic, so you can use it alongside VS Code or any other editor.
Is this a VS Code extension?
No. ACT is not a VS Code extension. It works with supported AI coding clients and is editor-agnostic, so you can use it alongside VS Code, Cursor, or any other editor.
Does it work with my existing Flutter project?
Yes. The toolkit installs globally and works with any Flutter or Dart project. It doesn't modify your project structure — it adds development workflows on top.
Can ACT turn Figma designs into Flutter code?
Yes. ACT can save a lot of time on Figma-to-Flutter handoff. It uses Figma MCP to inspect selected designs, identify scope, states, assets, tokens, layout structure, and Flutter widget mapping, then helps turn that into working UI. The workflow is intentionally iterative: inspect first, clarify ambiguity, implement, verify, and refine. That produces better results than treating design-to-code as a one-shot export.
Can I use ACT for non-Flutter projects?
The workflow skills and git skills work the same way. The agent will skip Flutter-specific guidance, though the Flutter knowledge base is still loaded and will incur some token usage.
What Flutter patterns and packages does it support?
The knowledge base covers 10 principles, 15+ patterns, and breaking changes for Dart and Flutter. Package-specific knowledge is included for Riverpod, Drift, and Sentry, with more packages coming.
How is this different from free Claude Code plugins?
Most open-source toolkits structure workflows but have zero Flutter-specific knowledge. ACT's primary focus is deep Flutter/Dart domain expertise — patterns, principles, breaking changes, and setup recipes built into every step.
How is this different from just writing a good CLAUDE.md?
CLAUDE.md should be absolutely minimal, but often turns into a dumping ground with irrelevant information that makes your agent perform worse for the task at hand. ACT encodes a full workflow — interview, spec, focused implementation tasks, and delivery cycles, plus a knowledge base of patterns and breaking changes.
What does the workflow actually produce?
I won't promise 100% working software. But if you follow the workflow, you'll get far better results than your average vibe-coded sessions. Each cycle generates durable specs, decision records, implementation tasks, and verification summaries in your configured workflow storage. By default, local ACT projects store these under ai_specs/.
Will this slow down my AI agent?
The structured workflow adds steps, but each step prevents rework that costs more time later. During execution, you can choose lite or full knowledge loading depending on how much guidance you need.
Does it work with team-based workflows?
Yes. The workflow produces artifacts such as specs, decision records, and implementation tasks that live in your configured workflow storage. Team members see the same requirements, decisions, and implementation context.
Can I use this for Dart CLI projects too?
Yes. The toolkit includes /act-dart-create for Dart CLI projects and the knowledge base applies to both Flutter and Dart development.
How do I update it?
Run /act-update from any project. It checks for updates and shows the changelog before applying.
What about code reviews?
ACT is designed so the right requirements are gathered upfront before implementation starts. That makes the resulting code more likely to be correct, so code reviews become lighter — verification rather than discovery.
Is the source code included?
Yes. The toolkit is a set of markdown-based skills, commands, and knowledge files — all fully readable. You're free to build your own skills alongside it. The license does not permit forking or reselling the toolkit itself.

Stop reviewing AI code line by line

Give your AI agent the guardrails, Flutter expertise, and structured workflow it needs to produce code you trust.