Workflow Architect Lite

What it does

Workflow Architect Lite provides a compact, two-phase architecture workflow for designing and implementing software projects. It splits work into an Understand phase (requirements gathering and proposal) and an Execute phase (flat plan execution and verification), enforcing non-negotiable rules such as no code before approval, persistent state, and one-commit-per-task. The skill includes templates and references to guide state management, plan writing, and task structure.

When to use it

Use this skill when you need a fast, disciplined architecture and execution flow for small-to-medium projects, or when operating with constrained models where a full multi-stage architect workflow would be too heavyweight. Avoid for trivial single-file edits or tiny fixes under ~5 tool calls. Ideal for initial project scoping, creating a clear plan on disk, and executing tasks with verification and commits.

What's included

• Scripts: none embedded, but the skill references templates and helper files in the repository when present.
• References: includes a references/ folder with phase protocols and state schema that the runtime loads during phase transitions.
• Instructions: concrete state machine (INIT → UNDERSTAND → EXECUTE → COMPLETED), explicit hard-gates (no code in Understand, persist state.json, require user approval to advance), and file templates for plans and tasks.

Compatible agents

Designed for agents that support read/write file tools, task creation, and basic shell/git operations (e.g., Claude Code, Copilot-style agents, other agents that expose Read/Write/Edit/Bash and task tooling).