plan-authoring skillA
plan-authoring is agent-read markdown (skill) from jakeselby/agent-harness: Write or revise a plan file, proposal, design doc or handoff the user reviews before approving work; carries the Review Card contract and the addendum rules. Use before writing anything into .agent-harness/plans/, and for any markdown deliverable whose job is to get a go/no-go..
Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.
What the file says
The trigger lives in the `plan-ceremony` stance. This is the contract. ## Why this exists A plan has two audiences and they are not the same reader. - **The reviewer reviews the approach.** System design, steps, and the decisions that are theirs — in one screen, before they read anything else. - **The implementing agent executes it.** Paths, sequencing, edge cases, evidence. One document written for both produces the 884-line file the reviewer gets lost in. So a plan is one file with a hard seam: a **Review Card** above the first `---`, an **Addendum** below it. **Failure test:** if the reviewer has to scroll to learn what is being built, the plan has failed, however good the work behind it is. ## The Review Card Everything above the first `---`. **Target 50 source lines, hard cap 70**, diagram included. The one thing allowed to push past 70 is a full `## Decisions for the reviewer` block — three lines each, five maximum. Never cut a real decision to hit a budget. Not an introduction to the plan — the whole plan at review altitude. These sections, this order. Do not rename them, do not add to them, do not fold one into another. …
Read the whole file at its exact version.
How to install
mdr add jakeselby/agent-harness/plan-authoring@git:20260923.097bdb0mdr add jakeselby/agent-harness/plan-authoring@sha256:7174b30070c7e12ePin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.
[](https://markdownregistry.com/a/art_ewilfzd7tqhv6or6)
1 badge views in 30 days
Versions
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20260923.097bdb0 latest | 2026-09-23 | 097bdb0 | 16,637 B | A | view · diff |
| git:20260923.81973a3 | 2026-09-23 | 81973a3 | 16,757 B | A | view · diff |
| git:20260922.1cfc35d | 2026-09-22 | 1cfc35d | 15,725 B | A | view · diff |
| git:20260921.af9693b | 2026-09-21 | af9693b | 14,981 B | A | view · diff |
| git:20260919.b757bec | 2026-09-19 | b757bec | 14,741 B | A | view · diff |
| git:20260919.85e6a38 | 2026-09-19 | 85e6a38 | 14,445 B | A | view · diff |
| git:20260919.6cf18f7 | 2026-09-19 | 6cf18f7 | 14,438 B | A | view |
Audit of the latest version
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (16637 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
jakeselby/agent-harness · 17 stars · license MIT · pushed 2026-09-25 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_ewilfzd7tqhv6or6 GET https://markdownregistry.com/api/v1/resolve?ref=jakeselby/agent-harness/plan-authoring GET https://markdownregistry.com/api/v1/blob/7174b30070c7e12e2baa75f08f4364ebb7131a8f42b5e267bb82655d94d77e84
Your agent 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.