qp Manual

qp is a repo-local task runner and workflow runtime driven by one qp.yaml, designed for human developers and coding agents to share the same operational contract.

What Makes qp Different

1. One file defines tasks, safety, scopes, guards, and context.
2. Structured output (--json, --events) makes automation reliable.
3. Planning/brief/repair commands support agent-assisted workflows.

60-Second Example

project: payments
default: check

tasks:
  lint:
    desc: Lint code
    cmd: golangci-lint run
  test:
    desc: Run tests
    cmd: go test ./...
  check:
    desc: Quality gate
    run: par(lint, test)

qp list
qp help check
qp check --json

Start Here

1. Getting Started
2. Core Concepts
3. Tasks, Task Parameters, Pipelines, DAGs
4. Profiles, Secrets, Caching, Retry
5. Events and JSON Output
6. Cookbook

Quick Install

go install github.com/neural-chilli/qp/cmd/qp@latest

Then in a repo:

qp init
qp list
qp check

Reading Paths by Role

• Individual developer: start with Getting Started, Tasks, Params, and Cookbook.
• Team lead / CI owner: focus on Guards, Events/JSON, Schema/Validation, and CLI reference.
• Agent-heavy workflow: focus on Scopes, Context, Planning, Repair, Agent Integration.