phase-builder SKILL.md skillA

phase-builder from ayejk/phase-runner is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add ayejk/phase-runner/phase-builder@git:20261004.12e5cda

Pins git:20261004.12e5cda in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
ayejk/phase-runner
Path
plugin/skills/phase-builder/SKILL.md
Versions recorded
4
Latest version
git:20261004.12e5cda, committed Oct 4, 2026
First version recorded
Sep 29, 2026
Size
62,411 bytes
Repository stars
28
License
MIT

Orchestrates automated sprint implementation from phase plans — e.g. 'run phase 1', 'implement sprint 1.3', 'run phase 4 in a worktree'. Optional worktree mode isolates a phase run on its own branch so two phases can run at once. Spawns phase-ui-implement (UI sprints + docs/design/design-system.md), general implementation (data/mixed), phase-verify, phase-wave-test (design asserts), phase-doc-sync. Skill-router per sprint. Clean orchestrator thread. Max 3 retries per gate then escalate. Pauses…

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Phase Builder

Orchestrates sprint implementation from phase plan files at `docs/phases/Phase-{N}-*.md`. Reads the plan, identifies incomplete sprints, **groups sprints into parallel waves when safe**, spawns one sub-agent per sprint (multiple sub-agent calls in the same turn when running a wave), processes results, and manages human checkpoints at blockers and phase boundaries. **Default remains sequential** when the dependency graph, overlap risk, or sprint semantics do not justify parallelism.

**Companion files:** `runtime-adapter.md` (which sub-agent tool and skill-loading mechanism this environment uses), `project-layout.md` (workspace_root vs app_root), `skill-router.md`, `run-log.md` (the per-phase log the gate agents and implementers append to), and the `phase-ui-implement`, `phase-verify`, `phase-wave-test`, `phase-doc-sync` skills. For a published design, also design-planner's `design-sync.md` (Step 1.2).

---

## Step 0 — Resolve the runtime
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add ayejk/phase-runner/phase-builder@sha256:f725c0dee8b0810b

The line at the top of this page pins the label git:20261004.12e5cda, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_k2v2r7qbutrdbby2.svg)](https://markdownregistry.com/a/art_k2v2r7qbutrdbby2)

1 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 4 versions of this file, between Sep 29, 2026 and Oct 4, 2026, about one every day.

versioncommittedcommitsizeaudit
git:20261004.12e5cda latest2026-10-04 12e5cda 62,411 BA view · diff
git:20261004.c0239032026-10-04 c023903 59,623 BA view · diff
git:20260929.0405de02026-09-29 0405de0 58,649 BA view · diff
git:20260929.764d97b2026-09-29 764d97b 50,030 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (62411 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

ayejk/phase-runner · 28 stars · license MIT · pushed 2026-10-22 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_k2v2r7qbutrdbby2
GET https://markdownregistry.com/api/v1/resolve?ref=ayejk/phase-runner/phase-builder
GET https://markdownregistry.com/api/v1/blob/f725c0dee8b0810b3b9760d5ce950500205bc2f0e5cceaab1593604a140ad27c

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from ayejk/phase-runner

design-planner SKILL.md skill
ayejk/phase-runner · plugin/skills/design-planner/SKILL.md · Establishes visual design language and screen contracts between project scope docs and phase-planner. Produces…
git:20261004.12e5cda · audit A · 28 stars
phase-doc-sync SKILL.md skill
ayejk/phase-runner · plugin/skills/phase-doc-sync/SKILL.md · Applies sprint implementation results to docs/phases/ phase plan files. Used by phase-builder as a sub-agent after each…
git:20260929.0405de0 · audit A · 28 stars
phase-planner SKILL.md skill
ayejk/phase-runner · plugin/skills/phase-planner/SKILL.md · Creates and maintains phase plan documents in docs/phases/ files. Use when turning design chat into a structured phase…
git:20261004.12e5cda · audit A · 28 stars
phase-ui-implement SKILL.md skill
ayejk/phase-runner · plugin/skills/phase-ui-implement/SKILL.md · UI implementation sub-agent for phase-builder. Spawned for UI-primary sprints — reads docs/design/design-system.md…
git:20261004.c023903 · audit A · 28 stars
phase-verify SKILL.md skill
ayejk/phase-runner · plugin/skills/phase-verify/SKILL.md · Per-wave CLI verification for phase-builder. Spawned as a sub-agent after implementation calls return — runs the…
git:20260929.0405de0 · audit A · 28 stars
phase-viewer SKILL.md skill
ayejk/phase-runner · plugin/skills/phase-viewer/SKILL.md · Starts the phase-viewer live dashboard for this project (npx phase-viewer) in the background and reports its localhost…
git:20260929.0405de0 · audit A · 28 stars
phase-wave-test SKILL.md skill
ayejk/phase-runner · plugin/skills/phase-wave-test/SKILL.md · Per-wave browser and UI verification for phase-builder. After CLI verify, before doc-sync on UI waves. Runs dev server…
git:20260929.0405de0 · audit A · 28 stars
product-planner SKILL.md skill
ayejk/phase-runner · plugin/skills/product-planner/SKILL.md · Plans out a product, product feature, or set of related features and produces a rich HTML planning document. Use when…
git:20261004.c023903 · audit A · 28 stars

Every file in ayejk/phase-runner

Browse by kind, by grade A, or by owner.