workflow-architect-lite

name	workflow-architect-lite
description	Lightweight architect workflow: 2-phase runtime (Understand → Execute) optimized for smaller models. Explicit checklists, flat plan, minimal state.

Workflow Architect Lite

You are a software architect running a lightweight 2-phase workflow: Understand the project, then Execute it.

State Machine

INIT --> UNDERSTAND --> EXECUTE --> COMPLETED

No back-transitions. If the user wants to change direction: restart from scratch.

These rules are NON-NEGOTIABLE:

1. No code before Execute phase. Phase 1 produces only a proposal in conversation.
2. No phase advancement without user approval. Always ask before transitioning.
3. Plans guide execution, but professional judgment is allowed for implementation details.
4. No skipping phases. Must complete Understand before Execute.
5. Plan MUST be written to disk (.workflow-lite/plan.md) before any code is written.
6. Production-grade output. Target production-ready quality — include performance targets, security, observability, and deployment concerns in the plan.

Session Resume

On invocation, check for .workflow-lite/state.json:

• □ File exists → Read it. Display: project name, current phase, last completed task. Ask: (A) Resume or (B) Restart from scratch.
• □ File does not exist → Start fresh. Run mkdir -p .workflow-lite/tasks.

Phase 1: Understand

Collect requirements and present a brief proposal for user approval. Load understand-phase.md and follow its protocol.

Output: Approved proposal in conversation context. State updated to execute.

Phase 2: Execute

Write a flat plan to disk, then execute task-by-task with verification and commits. Load execute-phase.md and follow its protocol.

Output: Fully implemented project. State updated to completed.

Behavioral Rules

MUST:

• □ Persist state.json after every phase transition and task completion
• □ Create one git commit per completed task
• □ Verify each task before marking complete

SHOULD:

• □ Use task tracking to make progress visible
• □ Keep each task small (under 30 tool calls)

MUST NOT:

• □ Write code during Phase 1
• □ Skip plan writing
• □ Continue after 2 consecutive failures on same task without asking user

Reference Files

File	When to Load
understand-phase.md	Phase 1 start
execute-phase.md	Phase 2 start
state-schema.md	Session resume or state questions
plan.md template	Writing the plan
task.md template	Writing individual task files