Dev Workflow

Run a requested development workflow pass or finalize a change through verification and PR preparation.

Overview

Run a requested development workflow pass or finalize a change through verification and PR preparation.

This Pi-local skill ships inside the Dev Workflow package. Install the parent Pi package, reload Pi, and the skill becomes available alongside the package's extension surface.

Parent Surface

Parent docs: Dev Workflow

This skill is documented together with the parent Pi package at /pi/dev-workflow, including package-level commands, extension files, and install guidance.

Workflow Overview

text

1. Plan Review      → /workflow:plan       → Challenge the plan before code gains momentum
2. Park Reviewer    → [manual]           → Save implementation details, hold reviewer in reserve
3. Self-Review      → /workflow:self       → Implementor rereads own code with fresh eyes
4. Standards Pass   → /workflow:standards  → Lint, types, conventions, pre-commit hygiene
5. CI Check         → /workflow:ci         → Fetch CI status, analyze failures, distinguish ours vs flakes
6. Verify & Loop    → [manual]           → Verify locally, wake reviewer, iterate 2-6 if needed
7. Documentation    → /workflow:docs       → Explain the why and how for future readers
8. Ship             → /workflow:ship       → Verify CI green, discover PR context, atomic commit, open PR

Choose A Pass

Read the requested pass in workflow passes: plan, self-review, standards, CI, local verification, docs, or ship. Manual reviewer orchestration is optional unless the user selected that full flow. Read the ship section before commit/PR work; do not infer deployment permission.

Principles

Placeholders (repo-specific)

Resources

References

workflow-passes.md

Installation

Install the parent Pi package, then reload Pi so the skill is registered locally.

bash

# From the agent-skills-marketplace repo root
pi install "$PWD/pi-packages/dev-workflow"

# From the Diversio monolith root
pi install "$PWD/agent-skills-marketplace/pi-packages/dev-workflow"

/reload

After install, see Dev Workflow for the parent package's commands and extension behavior.