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.
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
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
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
Skill
What it does
/act-git-commit
Conventional commits for staged changes
/act-git-commit-all
Conventional commit for all staged and unstaged changes
/act-git-push-make-pr
Push to GitHub and create PR with smart descriptions
/act-git-switch-main-pull
Switch to main and pull latest changes
/act-git-worktree
Manage git worktrees for isolated parallel feature development
Skill
What it does
/act-dart-create
Create Dart CLI projects with recommended setup
/act-flutter-create
Create Flutter projects with lints and analysis options
/act-flutter-development
Knowledge router for patterns, principles, breaking changes, and setup guides
/act-flutter-tdd
Test-first structure for behavior-focused implementation
/act-flutter-robot-testing
Robot-driven widget journey tests with stable selectors
/act-figma-to-flutter
Turn Figma designs into implementation-ready Flutter work by extracting scope, states, assets, tokens, and layout guidance
/act-flutter-driver-mcp
Set up Flutter Driver entrypoints for Dart MCP runtime interaction
/act-flutter-screenshot
Capture screenshots from running apps for visual verification
/act-flutter-pub-upgrade-major
Upgrade dependencies to latest major versions with verification
/act-flutter-drift-setup
Set up Drift SQLite with cross-platform support
/act-flutter-sentry-init
Initialize Sentry error reporting with DSN and debug symbols
/act-download-flutter-rules
Fetch latest official Flutter rules from the repository
/act-dart-migrate-dot-shorthand
Migrate Dart code to dot shorthand syntax (Dart 3.10 or higher)
/act-dart-migrate-primary-constructors
Migrate Dart constructor boilerplate to primary constructors (Dart 3.12 or higher)
Agent
What it does
act-flutter-patterns-researcher
Find relevant patterns and principles for features
act-flutter-docs-researcher
Research SDK/package docs, migrations, version constraints
act-codebase-researcher
Research project structure, conventions, similar implementations
✓10 principles (API key storage, avoiding global state, reactive state management, YAGNI/KISS, and more)
✓Breaking changes docs for Dart, Flutter, and Riverpod
✓7 setup recipes (Riverpod, Sentry, environment variables, flavors, and more)
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.
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
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
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.