synthesis-preplan SKILL.md skillA
synthesis-preplan from synthesisengineering/synthesis-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add synthesisengineering/synthesis-skills/synthesis-preplan@v2.0.0Pins v2.0.0 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- synthesisengineering/synthesis-skills
- Path
skills/synthesis-preplan/SKILL.md- Versions recorded
- 9
- Latest version
- v2.0.0, committed Oct 6, 2026
- First version recorded
- Aug 12, 2026
- Size
- 6,962 bytes
- Repository stars
- 23
- License
- Apache-2.0
Lock architecture decisions for a ticket or issue with real design choices: resolve delegated technical choices, ask structured questions for the user's, and hand a reviewable decision set to the planning step. Use to preplan, pre-plan a ticket, lock decisions, or list its open design questions.
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
# Synthesis Preplan — Architecture-Decision Locker Resolves architectural choices on tickets or issues, records their owners and evidence, and hands a decision set to the planning step. Use Q&A for choices the user owns; decide technical choices inside delegated work. ## Binding rules Rules 1 to 8 are the 1.1.0 rules, in their order. 1. **Don't skip the source-of-truth fetch.** Ticket comments, parent branches, and project docs frequently contain the decisions you'd otherwise re-litigate. Read them. 2. **Don't author the plan inside this skill.** The skill's job is locked decisions + the handoff prompt; the planner authors the commit breakdown. Persisting the planner's returned plan to a file in Step 6 is not authoring — do that. 3. **Two durable artifacts: the decision summary file and the plan document.** Both survive context compaction; the conversation log and the planner's output do not. Step 5 writes the decisions; Step 6 writes the plan to `plans/<ticket-slug>-plan.md` after the planner returns (many planners cannot write files themselves, so the orchestrator must). …
Read the whole file at its exact version.
How to install
mdr add synthesisengineering/synthesis-skills/synthesis-preplan@sha256:ac3ac91885af64a3The line at the top of this page pins the label v2.0.0, 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.
[](https://markdownregistry.com/a/art_dmmsdplsjqgro56w)
3 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 9 versions of this file, between Aug 12, 2026 and Oct 6, 2026, about one every 7 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| v2.0.0 latest | 2026-10-06 | 26e97df | 6,962 B | A | view · diff |
| v1.1.0 | 2026-09-25 | 05b0737 | 32,641 B | A | view · diff |
| v1.0.0 | 2026-09-20 | 02ed2df | 30,462 B | A | view · diff |
| v1.0.0 | 2026-09-20 | cbc4cdd | 30,464 B | A | view · diff |
| v1.0.0 | 2026-08-12 | 97bdfde | 30,229 B | A | view · diff |
| v1.0.0 | 2026-08-12 | 5f734c5 | 30,231 B | A | view · diff |
| v1.0.0 | 2026-08-12 | 8f5c1e3 | 30,088 B | A | view · diff |
| v1.0.0 | 2026-08-12 | 0067669 | 29,000 B | A | view · diff |
| v1.0.0 | 2026-08-12 | 54b6e01 | 26,247 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 (6962 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
synthesisengineering/synthesis-skills · 23 stars · license Apache-2.0 · pushed 2026-11-05 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_dmmsdplsjqgro56w GET https://markdownregistry.com/api/v1/resolve?ref=synthesisengineering/synthesis-skills/synthesis-preplan GET https://markdownregistry.com/api/v1/blob/ac3ac91885af64a3dbf1761122054d69f56ea2245c1d8dd0adcbbeb17038b342
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.