pi-workflow-agent

Generic Pi extension for issue-led coding workflows.

It helps Pi classify work, decide whether planning or external memory is needed, guide verification, and land changes without hardcoding any one project or tool.

Security: Pi extensions run with full system permissions. Review extensions before installing them.

Install

From a local checkout:

pi install /absolute/path/to/pi-workflow-agent

From npm:

pi install npm:pi-workflow-agent

Pinned npm version:

pi install npm:[email protected]

From GitHub:

pi install git:github.com/repolife/[email protected]

For project-local installation, add -l:

pi install -l npm:[email protected]

Commands

/workflow start <task>      classify and start a workflow
/workflow classify <task>   classify without editing
/workflow status            show current workflow state
/workflow verify            ask the agent to run relevant verification
/workflow land              ask the agent to update issue state, commit, and push
/workflow reset             clear workflow state

Flow

issue → classify → optional planner → optional memory/context → execute → verify → land

The extension does not duplicate repo hook or CI internals. Configure verification commands and let the repo own its checks.

Project configuration

Optional project config can live at either:

.pi/workflow.json
.workflow-agent.json

Example:

{
  "issueTracker": "beads",
  "planner": "gsd",
  "memory": "tolaria",
  "verification": {
    "defaultCommands": ["pnpm test"],
    "preCommitCommand": "pnpm exec lefthook run pre-commit --no-tty"
  }
}

Defaults

Without config, the extension assumes:

• issue tracker: beads
• planner: gsd
• memory: optional
• verification: choose targeted commands from repo scripts/docs

Design goals

• Generic and reusable across projects.
• Adapter-friendly without requiring adapters up front.
• Transparent classification before edits.
• No project-specific naming or policy.
• No duplicate task tracker.