← Open Source
ai skill
utopia-ai-arch
The skill that builds and polices our agent system itself - a four-agent roster, enforcement hooks that block bad edits, and a drift catalogue distilled from production repos.
/plugin marketplace add Utopia-USS/utopia-flutter-skills
/plugin install utopia-ai-arch@utopia-flutter-skillswhy it exists
The other skills tell our agents how to write Flutter. This one builds the agents. It defines the .claude/ layer a repo runs inside: a four-agent roster with hard boundaries - an architect that plans read-only, a maintainer that is the only agent allowed to write, a reviewer that flags BLOCKER / WARN / NIT, and a pre-commit auditor that gates the staged diff before anything is committed. Each role can do exactly one job, so no single agent both decides and writes unchecked.
The discipline is enforced, not suggested. PostToolUse hooks block edits that break the rules, and a drift catalogue distilled from production Utopia repos lists the ways an agent layer rots so they can be caught. This is the part of the methodology a CTO usually has to take on faith - so we publish it. You can read how the agent system is built before you hire us, and it is the same scaffolding your team keeps after hand-over.
The other skills - utopia-hooks for screens, utopia-cms for admin panels - are agents built on this same layer, following its rules the way any agent in the roster would.
The discipline is enforced, not suggested. PostToolUse hooks block edits that break the rules, and a drift catalogue distilled from production Utopia repos lists the ways an agent layer rots so they can be caught. This is the part of the methodology a CTO usually has to take on faith - so we publish it. You can read how the agent system is built before you hire us, and it is the same scaffolding your team keeps after hand-over.
The other skills - utopia-hooks for screens, utopia-cms for admin panels - are agents built on this same layer, following its rules the way any agent in the roster would.
utopia-ai-arch/SKILL.md10 refs
- name
- utopia-ai-arch
Referencesthe layer blueprint
Layer modelCRITICAL
Agent rosterCRITICAL
Skill designCRITICAL
Enforcement hooksCRITICAL
Evolution & driftCRITICAL
Slash commandsHIGH
Architecture docHIGH
CLAUDE.mdHIGH
Bootstrap procedureHIGH
settings.jsonMEDIUM
usage
The enforcement runs as a real PostToolUse hook. This is the shape of one:
// .claude/settings.json - the hook fires after every Edit/Write.
{
"hooks": {
"PostToolUse": [
{
"matcher": "Edit|Write|MultiEdit",
"hooks": [
{
"type": "command",
"command": "bash \"${CLAUDE_PROJECT_DIR}/.claude/scripts/quality_check.sh\""
}
]
}
]
}
}
// The script exits 0 to pass, 2 to block the edit outright.
talk to us
Want this in your build?
The team behind utopia-ai-arch ships production Flutter on the same stack. Tell us what you are building.