Core Workflow

pokayokay follows a structured loop that takes you from a product requirement document all the way to a verified, production-ready implementation:

/plan --> /revise (optional) --> /work --> /audit --> /handoff

Each step in the workflow has a clear purpose:

01

/plan

Analyze a PRD and decompose it into epics, stories, and tasks with dependency chains. The planner agent creates a structured work plan.

02

/revise

Optionally refine the plan. Add constraints, reprioritize stories, or adjust scope before implementation begins.

03

/work

Execute the plan. Agents implement tasks with TDD, run reviews, commit code, and chain sessions when context fills up.

04

/audit

Verify completeness across 5 dimensions: accessibility, testing, documentation, security, and observability.

05

/handoff

Prepare a handoff summary for the next session or human reviewer with full context of what was accomplished.

The /work command is where most of the action happens. It dispatches tasks to specialized agents, runs two-stage code reviews, auto-commits on success, and can chain across multiple sessions when context windows fill up.

Command relationship flow
                  +-----------+
                  |   /plan   |  ← Start here with a PRD
                  +-----+-----+
                        |
                        v
                  +-----------+
              +--> |  /revise  |  ← Refine until satisfied
              |   +-----+-----+
              |         |
              +---------+
                        |
                        v
                  +-----------+
                  |   /work   |  ← Implementation loop
                  +-----+-----+
                        |
                        v
                  +-----------+
                  |  /audit   |  ← Verify completeness
                  +-----+-----+
                        |
                        v
                  +-----------+
                  | /handoff  |  ← Session summary
                  +-----------+