Detect the product-delivery state of a project.

Call this FIRST when entering a project. Returns the current state and what action to take next:

• "not_setup": No product-delivery config. Call workflow_setup to add it.

• "setup_no_workflow": Config exists but no workflow started. Call workflow_init.

• "active_workflow": Workflow in progress. Call workflow_status to see where it is.

• "legacy_migration": Has BUILD_PLAN.md or ROADMAP.md from old skills. Call workflow_init(from_migration=True).

Args: project_dir: Project directory to check. Defaults to working directory.

List all known projects managed by this server.

Shows every project that has been detected, initialized, or set up, along with its current phase and last-seen timestamp.

Args: refresh: If True, re-check each project's live state from disk. If False, return cached registry data (faster).

Remove a project from the registry.

Does not delete any files — just removes the project from the cross-project tracking list.

Args: project_dir: Project directory to remove.

Initialize a new delivery workflow in the project directory.

Args: project_type: "greenfield" or "evolution". Leave empty to determine during intake. Can be defaulted via PRODUCT_DELIVERY_PROJECT_TYPE in .env. from_migration: Detect existing BUILD_PLAN.md or ROADMAP.md and migrate. project_dir: Project directory. Defaults to working directory.

Get the current workflow state, work items, and recent events.

Args: project_dir: Project directory. Defaults to working directory.

Show allowed transitions from the current state with guard status.

Returns which states can be reached and whether each guard passes, so the agent can decide what to do next.

Args: project_dir: Project directory. Defaults to working directory.

Attempt a state transition. Guards are checked automatically.

Args: target: Target state (e.g. "discover", "frame", "plan", "deliver"). evidence: Evidence keys to attach to this transition. force: Force past failed guards (logged as forced). reason: Human-readable reason for the transition. project_dir: Project directory. Defaults to working directory.

Add a work item to the delivery plan.

Only valid in plan or deliver phase. The item starts in "ready" state.

Args: name: Work item name/description. acceptance_criteria: AC-NNN IDs this item satisfies. risks: RISK-NNN IDs associated with this item. project_dir: Project directory. Defaults to working directory.

List all work items, optionally filtered by state.

Args: state_filter: Only show items in this state (e.g. "ready", "implementing"). project_dir: Project directory. Defaults to working directory.

Transition a work item to a new state.

Valid transitions: ready->implementing, implementing->verifying, verifying->reviewing, verifying->rework, reviewing->accepted, reviewing->rework, rework->implementing. Any item can be cancelled.

Args: item_id: Work item ID (WI-NNN). target: Target state. reason: Reason for the transition. project_dir: Project directory. Defaults to working directory.

Waive a work item that is in reviewing state.

Requires explicit approver and reason. The item moves to "waived" terminal state and counts toward the completion guard.

Args: item_id: Work item ID (WI-NNN). approver: Who approved the waiver. reason: Why the item is being waived. project_dir: Project directory. Defaults to working directory.

Run guard checks for all available transitions from the current state.

Returns which transitions are ready (all guards pass) and which are blocked, with per-guard status.

Args: project_dir: Project directory. Defaults to working directory.

Block the workflow. Records the current phase as the resume target.

Args: reason: Why the workflow is blocked. owner: Who is responsible for resolving the blocker. project_dir: Project directory. Defaults to working directory.

Resume a blocked workflow back to its pre-blocked phase.

Args: reason: Why the blocker is resolved. project_dir: Project directory. Defaults to working directory.

Waive a transition guard so the transition can proceed.

The waiver is recorded with the approver and reason. The guard will show as "waived" instead of "fail" on subsequent checks.

Args: guard: Guard name to waive (from workflow_check results). approver: Who approved the waiver. reason: Why the guard is being waived (risk accepted). project_dir: Project directory. Defaults to working directory.

Close the workflow (normally from stabilize phase).

Args: reason: Reason for closing. force: Close from a non-stabilize phase (logged as forced). project_dir: Project directory. Defaults to working directory.

Render a human-readable markdown summary of the workflow status.

Args: project_dir: Project directory. Defaults to working directory.

Show the active configuration from .env and environment variables.

Returns all PRODUCT_DELIVERY_* settings and where they came from.

Args: project_dir: Project directory. Defaults to working directory.

Set up product-delivery in a project.

Creates or updates: .claude/settings.json, .cursor/mcp.json, AGENTS.md (workflow rule), .env.sample, .env, and .gitignore. Merges into existing files without clobbering other settings. Idempotent — safe to run multiple times.

Call with dry_run=True first to preview changes, then with dry_run=False to apply them. Present the preview to the user before applying.

Args: dry_run: If True, preview what would change without writing. If False, apply the changes. project_dir: Project directory. Defaults to working directory.