Executing Liquid Galaxy Plans
Overview
Execute implementation plans in batches. This is the fourth step in the 6-stage pipeline: Init -> Brainstorm -> Plan -> Execute -> Review -> Quiz (Finale).
⚠️ PROMINENT GUARDRAIL: Do not be a "coding robot." If the student stops participating or just says "Go on," you MUST trigger the Skeptical Mentor (/Users/victor/Development/liquidgalaxy/LGWebStarterKit/.agent/skills/lg-skeptical-mentor/SKILL.md).
Announce at start: "I'm using the lg-exec skill to implement the [Feature Name] plan."
The Process
Step 1: Load and Review Plan
- •Read the plan file in
docs/plans/. - •Critical Review: Identify questions about the architecture or synchronization strategy.
- •OSS Context: Ensure the proposed names and structures follow the existing project patterns.
- •If concerns: Raise them with the student before starting.
Step 2: Execute Batch
Default: Execute tasks in batches of 2-3.
For each task in the batch:
- •Mark as
in_progress. - •Follow the steps exactly (Logic -> Implementation -> Verification).
- •Educational Check: Briefly explain why this specific task is necessary for the overall architecture.
- •Run verifications as specified (e.g., opening Chrome tabs to check sync).
- •Pro Tip: If changes don't appear, check if the server is running with
nodemon. If not, restart it manually withnpm run dev.
- •Pro Tip: If changes don't appear, check if the server is running with
- •Quality Check: Run
npm run lintandnpm run check-types. - •Test Check: If logic was modified, run
npm run test. - •Commit with a descriptive message:
feat: [task name].
Step 3: Educational Report
When a batch is complete, report back with:
- •What was built: A summary of the changes.
- •Verification Result: Screenshots or console outputs showing the sync works.
- •Engineering Principles: Mention which principle was applied (e.g., "I applied Separation of Concerns by keeping the UI logic inside the controller folder").
- •Visual Check: How does it look on the virtual rig? Does it have the "Wow Factor"?
- •Checklist: Mark the completed tasks in the
docs/plans/folder. - •Learning Journal: Append this educational report to
docs/learning-journal.mdto track your engineering growth.
Step 4: Continue
- •Ask: "Ready for the next batch? Does the architecture still make sense to you?"
- •Execute next batch until complete.
Step 5: Final Review & Completion
After all tasks are complete:
- •Perform a final sync check across all simulated screens.
- •Finalize the
docs/plans/document by marking it as complete. - •Review Handoff: Ask: "Feature implementation is complete. Ready for a professional Code Review?"
- •Use the Liquid Galaxy Code Reviewer (/Users/victor/Development/liquidgalaxy/LGWebStarterKit/.agent/skills/lg-code-reviewer/SKILL.md) to perform the final quality audit.
When to Stop and Ask for Help
- •Hit a blocker (desync, unclear instruction).
- •Plan has logic gaps.
- •Verification fails repeatedly.
- •Don't guess—ask for clarification.
Remember
- •Review critically first.
- •Sync is everything: If it's not on the server, it's not in sync.
- •Report engineering principles after every batch.
- •Guardrail: If the student asks for too much automation or loses track of the engineering principles, call in the Skeptical Mentor (/Users/victor/Development/liquidgalaxy/LGWebStarterKit/.agent/skills/lg-skeptical-mentor/SKILL.md).
- •Stop when blocked.