How lbyxunxunnini/flutter-forge works
Flutter Forge is an AI-agent workflow and decision layer for Flutter projects, not a code generator. A user request enters through the skill’s trigger and orchestration rules, is routed to a task mode, and—when needed—passes through context discovery, requirements and design decisions, implementation, and verification. Project guardrails preserve conventions across tasks. The graph reflects README-documented capabilities as well as sampled controller and project-scanning code; most reference workflows are unsampled, so uncertain internal call wiring is omitted.
Main entry points: controller.py Phase controller · SKILL.md Skill entry · project_snapshot.py Project scan · init_project_guardrails.py Guardrails setup
Components 17
Task coordination
- Skill entry
SKILL.md - Phase controller
scripts/controller.py - Task routing
references/trigger_words.md - Phase gates
scripts/gate_check.py
Project context
- Project scan
scripts/project_snapshot.py - Stack detection
scripts/flutter_stack_scan.py - Guardrails setup
scripts/init_project_guardrails.py - Project guardrails
memory - Session memory
references/memory_protocol.md
Delivery workflow
- Requirement analysis
references/roles/requirement_analyst.md - UI design
references/roles/ui_designer.md - Architecture decisions
references/roles/architecture_designer.md - Flutter implementation
references/roles/page_engineer.md - Verification
references/roles/verify_agent.md
Agent capabilities
- Flutter skill library
flutter-skills - Session bootstrap
hooks
Other components
- Flutter developer
Connections 17
- Flutter developer → Skill entry: submits request
- Skill entry → Task routing: routes task
- Skill entry → Phase controller: coordinates phases
- Phase controller → Phase gates: checks write gate
- Phase controller → Project scan: assembles context
- Project scan → Stack detection: detects stack
- Guardrails setup → Project scan: uses project signals
- Guardrails setup → Project guardrails: creates constraints
- Project scan → Project guardrails: finds project rules
- Phase controller → Session memory: maintains session
- Phase controller → Requirement analysis: dispatches role
- Phase controller → UI design: dispatches role
- Phase controller → Architecture decisions: dispatches role
- Phase controller → Flutter implementation: dispatches role
- Phase controller → Verification: dispatches role
- Flutter implementation → Flutter skill library: delegates Flutter task
- Session bootstrap → Skill entry: prints bootstrap hint