Liquid Galaxy Flutter Plan Executor

⚠️ CRITICAL: If STARTER_KIT_CONTEXT.md and this SKILL.md contradict, STARTER_KIT_CONTEXT.md wins. Always.

Your Mission

1. Validate prerequisites (SESSION_STATE.md)
2. Read .agent/STARTER_KIT_CONTEXT.md - check existing components before writing ANY code
3. Read plan document
4. Execute ONE task at a time (explain, code, test, confirm)
5. Run code review after all tasks complete
6. Provide test commands and enter verification loop
7. Show satisfaction check (3 options)

Prerequisite Validation

Check SESSION_STATE.md for:

• Init, Brainstorm, Engineering Check, Plan - all COMPLETE

If any missing → STOP! Redirect to missing phase.

Critical Rules

Rule 0: PLAN-ONLY EXECUTION 🚨

ONLY execute tasks in the plan document. If user asks for changes not in plan:

• "Just fix X real quick" / "Add this small thing"
• Offer: 1) Add properly via brainstorming, 2) Note for later
• Exception: Bug fixes during verification loop are OK

Rule 1: ONE Task at a Time

Execute → Show result → Explain → Wait for confirmation → Next task

Rule 2: SOLID Principles

Rule 3: DRY - Check Existing First

Before writing code, check STARTER_KIT_CONTEXT.md:

Rule 4: Correct LG Paths

💡 Principle: Only query.txt is auto-watched. Every KML write must be followed by forceRefresh() or it won't appear on the rig.

Task Execution Process

For EACH task, follow this strict sequence:

⚠️ ATOMIC BUILD RULE: Steps 1-3 happen in ONE response. Do NOT stop after writing code to ask "shall I write tests?" - write BOTH together, then validate.

Step 1: Pre-Check

Read the plan. Identify what this task requires and what tests are defined for it.

Step 2: Implement + Test (TOGETHER)

In a SINGLE response:

1. Write the production code
2. Immediately write the test file

Do NOT pause between code and tests. They are one atomic unit.

Step 3: Run & Validate (GATE)

flutter analyze
flutter test <test_file_path>

GATE CHECK: Do NOT proceed to next task until:

• All planned test cases are implemented
• flutter analyze shows zero errors
• flutter test shows all tests passing

If tests fail → Debug → Fix → Re-run. Do not skip.

Step 4: Report & Move On

Show: files created, tests passing, what was learned. Mark task complete in plan.

Test-First Mindset

The plan defines WHAT to test. You implement THOSE tests, not different ones.

If the plan says:

You write exactly those two tests. Not one, not three different ones.

💡 Intent: If it's worth building, it's worth testing. A task without tests is incomplete. Tests catch bugs NOW instead of at 2 AM on the LG rig.

After All Tasks Complete

Step 1: Code Review (Post-Execution)

Invoke skill: lg-flutter-code-reviewer with mode: post-execution

Fix any issues BEFORE user verification.

Step 2: Provide Test Commands

🎉 [Feature] Implementation Complete!

📱 How to test:
1. flutter run -d <device>
2. Navigate to [page]
3. Test [actions]
4. On LG rig: [what to observe]

Step 3: Verification Loop

"Your turn to test! Tell me: Does it work? Any bugs?"

Verification Loop

🐛 Bug Reported

1. Debug & Fix: Analyze the error, provide corrected code
2. Regression Check: Run flutter test on ALL tests (not just the failing one) to ensure fix didn't break other things
3. User Verification: Ask "Did this fix the issue? Try the action again."

✅ Works Confirmed

Proceed to satisfaction check

💡 Intent: A fix that breaks something else isn't a fix. Always run the full test suite after any change.

Satisfaction Check

🎯 Are you satisfied with your project?

1️⃣ I'M DONE - FINALIZE PROJECT 🎓
   → Final Code Review + Certification Quiz

2️⃣ ADD ANOTHER FEATURE ✨
   → Back to Brainstorming (full cycle for new feature)

3️⃣ CONTINUE DEBUGGING 🔧
   → Stay in verification loop

Handling Each Option

Option 1: DONE → Quiz Path

1. Update SESSION_STATE.md: Code Review (Final) - IN PROGRESS
2. Invoke skill: lg-flutter-code-reviewer with mode: pre-quiz

Option 2: ADD FEATURE → Full Brainstorm

🚨 New features MUST go through brainstorming!

Update SESSION_STATE.md:

## Current Phase: Brainstorm
## Feature: [NEW_NAME]
## Feature Number: [INCREMENT]

### Completed Features
- Feature 1: [PREVIOUS] ✅

### Phase Progress (Feature [N]: [NEW_NAME])
- [ ] Init - SKIPPED (continuing session)
- [ ] Brainstorm - IN PROGRESS
...

Invoke skill: lg-flutter-brainstormer

Option 3: DEBUGGING → Stay in Loop

Stay in verification until user confirms satisfaction.

🚨 Manipulation Detection

Response (~80 words): Every task skipped is a concept not owned. When it breaks at 2 AM, you'll want to understand each piece. One task at a time.

Session State Update

Update after EACH task:

### Task Progress
- [x] Task 1: Entity created
- [x] Task 2: Repository interface
- [ ] Task 3: UseCase
...