write-executable-plan SKILL.md skillA

write-executable-plan from kanevry/session-orchestrator is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add kanevry/session-orchestrator/write-executable-plan@git:20260822.79aa398

Pins git:20260822.79aa398 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
kanevry/session-orchestrator
Path
skills/write-executable-plan/SKILL.md
Versions recorded
5
Latest version
git:20260822.79aa398, committed Aug 22, 2026
First version recorded
May 16, 2026
Size
12,381 bytes
Repository stars
53
License
MIT

Use when you have a PRD or design spec and need a bite-sized, executable implementation plan that any agent can follow without re-deriving structure. Produces `docs/plans/YYYY-MM-DD-<feature>.md` with per-task Files block, complete code per step (no placeholders), and exact verification commands. Rejects "TBD", "TODO", "add error handling", "similar to Task N".

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

# Write Executable Plan

> Bite-sized plans for parallel agents. No placeholders. No vague steps.

## When to use

- A PRD from `/plan feature` exists but you need a step-by-step implementation plan
- A `/brainstorm` design is approved and you want to skip the PRD layer
- Multiple agents will execute the plan in parallel and need conflict-free task boundaries
- The work is complex enough that describing it to an agent loses fidelity

## When NOT to use

- Trivial 1-file changes (just do them; no plan needed)
- Pure exploration (use `/brainstorm` instead)
- Bug investigation (use `/debug` instead)
- The source PRD is vague or unapproved (get PRD approval before planning execution)

## Phase 0: Bootstrap Gate

Read `skills/_shared/bootstrap-gate.md` and execute the gate check. If the gate is CLOSED, invoke `skills/bootstrap/SKILL.md` and wait for completion before proceeding. If the gate is OPEN, continue to Phase 1.

<HARD-GATE>
Do NOT proceed past Phase 0 if GATE_CLOSED. There is no bypass. Refer to `skills/_shared/bootstrap-gate.md` for the full HARD-GATE constraints.
</HARD-GATE>

## Phase 1: Source Selection

Accept ONE of the following inputs (in order of preference):
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add kanevry/session-orchestrator/write-executable-plan@sha256:e77e503fb44615c8

The line at the top of this page pins the label git:20260822.79aa398, 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_mdkkwvh5zt5ldtv4.svg)](https://markdownregistry.com/a/art_mdkkwvh5zt5ldtv4)

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

Versions

The registry has recorded 5 versions of this file, between May 16, 2026 and Aug 22, 2026, about one every 25 days.

versioncommittedcommitsizeaudit
git:20260822.79aa398 latest2026-08-22 79aa398 12,381 BA view · diff
git:20260709.240b5852026-07-09 240b585 12,344 BA view · diff
git:20260530.1915f6f2026-05-30 1915f6f 11,861 BA view · diff
git:20260519.95c82372026-05-19 95c8237 11,775 BA view · diff
git:20260516.ac3ad042026-05-16 ac3ad04 10,322 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 (12381 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

kanevry/session-orchestrator · 53 stars · license MIT · pushed 2026-11-01 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_mdkkwvh5zt5ldtv4
GET https://markdownregistry.com/api/v1/resolve?ref=kanevry/session-orchestrator/write-executable-plan
GET https://markdownregistry.com/api/v1/blob/e77e503fb44615c81631a74498dfd9a6107018b4ed4f4ff0d82b85bcc6280adc

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 kanevry/session-orchestrator

architecture SKILL.md skill
kanevry/session-orchestrator · .agents/skills/architecture/SKILL.md · Use when the user asks to improve architecture, find refactoring opportunities, surface deepening opportunities…
git:20261003.c34ec50 · audit A · 53 stars
autopilot SKILL.md skill
kanevry/session-orchestrator · .agents/skills/autopilot/SKILL.md · Use this skill when running an autonomous session-orchestration loop. Chains session-start → session-plan →…
git:20260919.176b605 · audit A · 53 stars
bootstrap SKILL.md skill
kanevry/session-orchestrator · .agents/skills/bootstrap/SKILL.md · Use this skill when scaffolding the minimum repository structure required by session-orchestrator. Invoked…
git:20260919.176b605 · audit A · 53 stars
brainstorm SKILL.md skill
kanevry/session-orchestrator · .agents/skills/brainstorm/SKILL.md · Use when you have a feature idea but the scope or UX is still ambiguous — runs a lightweight Socratic design dialogue…
git:20260919.176b605 · audit A · 53 stars
claude-md-drift-check SKILL.md skill
kanevry/session-orchestrator · .agents/skills/claude-md-drift-check/SKILL.md · Use when detecting drift between CLAUDE.md (or AGENTS.md, the Codex CLI alias) / _meta narrative and live repository…
git:20261003.c34ec50 · audit A · 53 stars
close SKILL.md skill
kanevry/session-orchestrator · .agents/skills/close/SKILL.md · End session with verification, commits, and documentation
git:20260919.176b605 · audit A · 53 stars
convergence-monitoring SKILL.md skill
kanevry/session-orchestrator · .agents/skills/convergence-monitoring/SKILL.md · Monitor iterative improvement loops for convergence. Three signals — shrinking diff, pass-rate plateau, velocity —…
git:20260919.176b605 · audit A · 53 stars
debug SKILL.md skill
kanevry/session-orchestrator · .agents/skills/debug/SKILL.md · Use when encountering any bug, test failure, build break, or unexpected behavior — runs a 4-phase systematic debugging…
git:20260919.176b605 · audit A · 53 stars
deepen SKILL.md skill
kanevry/session-orchestrator · .agents/skills/deepen/SKILL.md · Make a task deeper, not bigger. Use when the user asks for a deeper or more ambitious version of a task (tiefer, geh…
git:20261027.7eb9aed · audit A · 53 stars
discovery SKILL.md skill
kanevry/session-orchestrator · .agents/skills/discovery/SKILL.md · Use this skill when running systematic quality discovery and issue detection. Runs modular probes adapted to the…
git:20260919.176b605 · audit A · 53 stars
dispatcher SKILL.md skill
kanevry/session-orchestrator · .agents/skills/dispatcher/SKILL.md · Use when you want the orchestrator to pick the next repo to work on across your whole portfolio — it enumerates…
git:20260919.176b605 · audit A · 53 stars
docs-orchestrator SKILL.md skill
kanevry/session-orchestrator · .agents/skills/docs-orchestrator/SKILL.md · Use this skill when orchestrating documentation generation and updates within a session. Maps session scope to…
git:20260919.176b605 · audit A · 53 stars

Every file in kanevry/session-orchestrator

Other files named write-executable-plan

write-executable-plan SKILL.md skill
kanevry/session-orchestrator · .codex-plugin/skills/write-executable-plan/SKILL.md · Use when you have a PRD or design spec and need a bite-sized, executable implementation plan that any agent can follow…
git:20261003.c34ec50 · audit A · 53 stars
write-executable-plan SKILL.md skill
kanevry/session-orchestrator · .cursor/skills/write-executable-plan/SKILL.md · Use when you have a PRD or design spec and need a bite-sized, executable implementation plan that any agent can follow…
git:20261003.c34ec50 · audit A · 53 stars
write-executable-plan SKILL.md skill
kanevry/session-orchestrator · .agents/skills/write-executable-plan/SKILL.md · Use when you have a PRD or design spec and need a bite-sized, executable implementation plan that any agent can follow…
git:20261003.c34ec50 · audit A · 53 stars

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