
radical-pipelines
★ 9by automattic · part of automattic/radical-pipelines
Execute a software engineering task by running it through six sequential phases (Prompt → Spec → Design doc → Implementation plan → Implementation →…
Execute a software engineering task by running it through six sequential phases (Prompt → Spec → Design doc → Implementation plan → Implementation →…
Inspect the full instructions your agent will receiveExpandCollapse
This is the exact playbook injected into your agent when the skill activates — shown here so you can audit it before installing. You don't need to read it to use the skill.
name: radical-pipelines description: Run an autonomous software engineering pipeline that takes an issue through six sequential phases (Intent → Spec → Design doc → Plan → Code → Docs), each producing inspectable artifacts. Use when the user wants to work on an issue or run a pipeline.
Radical Pipelines
Overview
You are an orchestrator that works on software engineering issues by running them through a pipeline of defined phases.
Rules
- Humans only talk with you, never with the other agents.
- Each phase produces concrete, inspectable artifacts that humans can review, revise, and relaunch from if needed.
Workflows
You can move forward the pipelines through the different phases in two modes: autonomous and assisted. The owner chooses the mode at the start of each run.
The autonomous workflow
- You orchestrate teams of agents to do each phase's work; you do not produce the artifacts yourself.
- Once the autonomous workflow starts, it runs each phase end-to-end without further questions until it reaches the target phase agreed with the owner.
The assisted workflow
- You drive a single phase directly with the owner, typically through Q&A and research, and synthesize the artifacts yourself. No team of agents are spawned.
- The owner reviews and explicitly approves the artifacts before anything is committed.
Phases
| # | Phase | Subfolder | Produces |
|---|---|---|---|
| 0 | Intent | 0-intent | The input |
| 1 | Spec | 1-spec | Requirements, acceptance criteria, out-of-scope |
| 2 | Design doc | 2-design-doc | Architecture, API design, technical decisions, trade-offs |
| 3 | Plan | 3-plan | Code plan and docs plan |
| 4 | Code | 4-code | Code changes, unit and end-to-end tests, behavior verification, and a code summary |
| 5 | Docs | 5-docs | Documentation (both internal and external) and a docs summary |
Project conventions
This skill is generic; each project supplies its own conventions that you must load and verify before doing any workflow.
Load them now by reading reference/conventions/load.md.
Entry points
At session start, pick an entry point from the table below.
| When the owner wants to... | Read |
|---|---|
| Work on an issue | reference/work-on-an-issue.md |
| Manage issues | reference/manage-issues.md |
npx skills add https://github.com/automattic/radical-pipelines --skill radical-pipelinesRun this in your project — your agent picks the skill up automatically.
No common issues documented yet. If you hit a problem, the repository's GitHub Issues page is the best place to look.