Flutter Documentation

Generate and maintain project documentation that helps the team understand, extend, and onboard onto the Flutter app.

Workflow

1. Identify what needs documenting — new feature, architecture decision, release, or onboarding gap.
2. Read the project state first — inspect README.md, docs/, lib/, pubspec.yaml. Never write docs that contradict the actual code.
3. Choose the right template from templates/ (see Output Artifacts below).
4. Draft the document — fill all required sections; mark [TODO] for sections requiring user input.
5. Review for accuracy — every file path, command, and class name must exist in the current codebase.
6. Update the README if new commands, env vars, setup steps, or architecture patterns were introduced.
7. Cross-link — new feature docs should be referenced from docs/architecture/technical_plan.md or the relevant ADR.

Documentation Rules

• Never document something that contradicts the current code — outdated docs are worse than none.
• Never copy-paste code examples without verifying they match the current Flutter/Dart version.
• README must always have: setup commands, run commands, test commands, env var list, folder structure.
• ADRs are append-only — mark superseded decisions as "Superseded by ADR-XXX" rather than deleting.
• Feature docs live in docs/features/<feature-name>.md and are created by /flutterforge:build-flutter-feature Phase 7.
• Keep templates/claudeprojectmemory.md up to date — it is the CLAUDE.md template for AI context.

README Required Sections

Architecture Decision Record (ADR) Format

Use templates/architecturedecisionrecord.md. Required fields: status (proposed / accepted / superseded), context, decision, consequences, alternatives considered.

Output Artifacts

• README.md — main project README (updated)
• docs/architecture/technical_plan.md — architecture overview
• docs/architecture/architecture_decisions.md — ADR log
• docs/features/<feature-name>.md — per-feature implementation summary
• docs/product/app_brief.md — product brief (from planning phase)
• docs/onboarding/ — setup guides, environment setup, team conventions

Cross-references

• Agents: flutter-architect (ADR content), flutter-implementation-engineer (feature summaries)
• Templates: templates/architecturedecisionrecord.md, templates/featurespec.md, templates/claudeproject_memory.md