utakata 0.2.0

A Dart CLI tool for building Flutter apps with Clean Architecture 4-layer structure, designed for human and AI agent collaboration.

utakata CLI

utakata is a Dart CLI tool designed for humans and AI agents to collaboratively build Flutter applications using a strict Clean Architecture 4-layer structure (Domain, Infrastructure, Application, Presentation).

日本語のドキュメントは README_ja.md を参照してください。

Features

• 🤖 AI-Driven Development: A set of commands that AI agents can directly invoke, combined with diff-detection tools to validate architectural consistency — preventing chaotic file generation by AI.
• 🧱 Strict 4-Layer Architecture: Instantly scaffolds Clean Architecture boilerplate, optimized for modern stacks like Freezed, Riverpod, and Drift.
• 📝 Entity-Driven Code Sync: Run utakata sync to automatically propagate Entity field changes into Repository, Model, Provider, and State layers.

Installation

dart pub global activate utakata

Make sure $HOME/.pub-cache/bin is added to your PATH.

Command Reference

1. Create a new project

Creates a new Flutter project with the Clean Architecture base structure and AI workflow templates.

utakata create my_app --org com.example

2. Plan your architecture (AI Workflow)

Reads AI/specs/feature_request.yaml and generates an architecture plan document.

utakata plan

3. Scaffold a feature layer

Generates all 4 layers (Domain, Infra, App, Presentation) based on the specified entity and permission.

# Add a single feature
utakata feature add <feature_name> --entity <entity_name> --perm <user|admin|shared>

# Bulk-generate all features defined in plan_architecture.yaml at once
utakata feature init

# List existing features
utakata feature list

4. Sync code from Entity changes

After editing a *_entity.dart file, run this to propagate changes through Repository, Model, Provider, and State.

utakata sync

5. Validate architecture

Scan the current lib/features/ structure and compare it against the planned architecture.

utakata scan
utakata diff
utakata check

6. Status check

Analyzes Flutter version, Lint status, and architecture diff.

utakata status

---

For AI Agents

The generated project includes .agent/rules/flutter.md and AI/guides/ with detailed workflow guides. Please read them and always use the utakata CLI to extend the project structure rather than creating files manually.

---

License

This project uses a dual license:

1. Open Source (GNU GPL v3) Free to use, fork, and modify for personal/open-source projects under the GNU GPL v3.

2. Commercial Use Commercial use of this tool or any code generated by it requires a separate commercial license. Contact the author (@code_utakata) for details.

Links

• Developer Website
• X (Twitter) @code_utakata