What workspace.plan Does for AI Planning

Estimated reading: 0 minutes 8 views

The workspace.plan command gives Vex a structured task planning system that lives in GameCatalyst’s local SQLite database. Instead of keeping plans in conversation memory where they can be lost when the chat gets long or a session restarts, workspace.plan stores everything persistently. Close Unity, reopen it tomorrow, and your plan is still right where you left it.

What workspace.plan provides:

Plan creation: Define a goal and break it into steps (simple mode) or phases, features, and tasks (rich mode). Simple mode is a flat to-do list. Rich mode is a full hierarchy for complex features.
Task lifecycle tracking: Every task follows Start → Implement → Verify → Complete, with nine detailed loop stages (0 through 8) so you can see exactly where Vex is in the process.
Verification gates: Vex must verify each task succeeded before advancing to the next one. No skipping ahead with broken results.
Gap recovery: When verification fails, a gap record is created automatically with a severity level (low, medium, or high). Vex cannot advance until the gap is resolved.
User collaboration: You can leave comments on any plan or task from the Plan Wizard, WhatIs Plans tab, or by telling Vex to add a comment. Vex must acknowledge your comment before proceeding — this is a hard gate that ensures your feedback is never ignored or overlooked.
Database persistence: Plans survive Unity recompilation, server restarts, and session timeouts. Your plan data is safe in the local database.

Plan IDs:

Every plan gets a unique ID like WP-a1b2c3d4. Tasks within the plan use hierarchical IDs: WP-a1b2c3d4.P1.F2.T3 means Plan → Phase 1 → Feature 2 → Task 3. Gap IDs add a suffix: ...T3-G1 for the first gap on that task.

Per-project control:

workspace.plan can be enabled or disabled per project through Dashboard Settings → Tool Permissions. When disabled, Vex uses its own planning system while DAP guidance still applies. This lets you use full plan tracking on complex projects and skip it on quick prototypes where a lighter approach works better.

Where to view plans:

You can view and manage plans in three places: the Plan Wizard (a dedicated Unity Editor window), the WhatIs Plans tab (in your browser), or by asking Vex to show plan status in your conversation.