technical-design-writing-standards SKILL.md skillA

technical-design-writing-standards from ensodynamics/enso-method is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add ensodynamics/enso-method/technical-design-writing-standards@git:20261026.9ffab64

Pins git:20261026.9ffab64 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
ensodynamics/enso-method
Path
skills/technical-design-writing-standards/SKILL.md
Versions recorded
5
Latest version
git:20261026.9ffab64, committed Oct 26, 2026
First version recorded
Oct 13, 2026
Size
14,199 bytes
Repository stars
6
License
MIT

Standards and process for writing technical design documents — architecture decisions, interfaces, data models, and integration points, including designs for changes to an existing system. Use to write a design from a refined PRD, or to check one; the draft is committed and handed to review-technical-design, then autonomous-design-refinement. Not implementation instructions.

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

# Technical Design Writing Standards

Guidelines for writing technical design documents.

---

## What Is a Technical Design Document?

A technical design document describes **how** we're going to build something. This is where technical decisions, interfaces, data models, and architecture choices are documented.

The technical design document bridges the gap between the business requirements (the PRD) and the actual implementation. It captures decisions that affect multiple phases or have long-term implications.

---

## When Do You Need a Technical Design Document?

Most PRDs need a technical design document. If you're building anything with interfaces, data models, or architecture decisions that need to be agreed upon before implementation, write one.

You can skip it when a feature is small, follows an established pattern, and doesn't introduce new interfaces or architectural choices — the PRD is sufficient in those cases.

---

## Writing a Technical Design

When asked to write a design, not just check one, this is the whole process. No separate research phase comes first; you read what the PRD's criteria touch, as you need it.

### Existing code: Preserve or Salvage
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add ensodynamics/enso-method/technical-design-writing-standards@sha256:a50c91e91773248b

The line at the top of this page pins the label git:20261026.9ffab64, 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_pin2bpvxd5ta47aw.svg)](https://markdownregistry.com/a/art_pin2bpvxd5ta47aw)

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

Versions

The registry has recorded 5 versions of this file, between Oct 13, 2026 and Oct 26, 2026, about one every 3 days.

versioncommittedcommitsizeaudit
git:20261026.9ffab64 latest2026-10-26 9ffab64 14,199 BA view · diff
git:20261022.ad79f042026-10-22 ad79f04 14,165 BA view · diff
git:20261018.9c89f882026-10-18 9c89f88 13,647 BA view · diff
git:20261014.85eff882026-10-14 85eff88 12,141 BA view · diff
git:20261013.ce3c32b2026-10-13 ce3c32b 12,081 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 (14199 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

ensodynamics/enso-method · 6 stars · license MIT · pushed 2026-11-03 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_pin2bpvxd5ta47aw
GET https://markdownregistry.com/api/v1/resolve?ref=ensodynamics/enso-method/technical-design-writing-standards
GET https://markdownregistry.com/api/v1/blob/a50c91e91773248b97994b8820b5b6dc2534bcc66ccc561bc2826e165f91236d

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 ensodynamics/enso-method

assumptions-document-feedback SKILL.md skill
ensodynamics/enso-method · skills/assumptions-document-feedback/SKILL.md · Process stakeholder feedback on assumptions documents — incorporate corrections, validations, partial answers and…
git:20261103.fd289f9 · audit A · 6 stars
assumptions-document-writing SKILL.md skill
ensodynamics/enso-method · skills/assumptions-document-writing/SKILL.md · Standards for writing business assumptions documents — specific implementable statements, plain English, confidence…
git:20261102.32695c3 · audit A · 6 stars
autonomous-design-refinement SKILL.md skill
ensodynamics/enso-method · skills/autonomous-design-refinement/SKILL.md · Multi-pass workflow that refines PRD, Technical Design, and Assumptions documents to implementation-ready state, run…
git:20261027.b46e48d · audit A · 6 stars
autonomous-prd-refinement SKILL.md skill
ensodynamics/enso-method · skills/autonomous-prd-refinement/SKILL.md · Review-and-fix loop that takes a drafted PRD, with its assumptions and mockups, to a state with no Medium or High…
git:20261103.fd289f9 · audit A · 6 stars
continuation-prompt SKILL.md skill
ensodynamics/enso-method · skills/continuation-prompt/SKILL.md · Produce the copy-paste prompt that starts the next chat. Line one is a short chat name; then the lineage block (the PRD…
git:20261030.0d2c5d0 · audit A · 6 stars
deliverable-review SKILL.md skill
ensodynamics/enso-method · skills/deliverable-review/SKILL.md · Verify completed work accomplishes what was intended — fresh-eyes sub-agent re-reads output files, traces requirements…
git:20261027.b46e48d · audit A · 6 stars
delivery-audit SKILL.md skill
ensodynamics/enso-method · skills/delivery-audit/SKILL.md · Independent check, once every planned phase of a PRD is closed, that each acceptance criterion is actually built —…
git:20261028.8c7215f · audit A · 6 stars
engineering-principles SKILL.md skill
ensodynamics/enso-method · skills/engineering-principles/SKILL.md · The engineering principles the Enso Method depends on — no silent fallbacks, the testing evidence standard (every…
git:20261006.537f98b · audit A · 6 stars
implement-from-discovery SKILL.md skill
ensodynamics/enso-method · skills/implement-from-discovery/SKILL.md · Implement a fix or improvement identified during research, investigation, or development, or raised in a bug report —…
git:20261103.fd289f9 · audit A · 6 stars
implement-from-requirements SKILL.md skill
ensodynamics/enso-method · skills/implement-from-requirements/SKILL.md · Default implementation skill — load full PRD and Technical Design context, size the work for a single AI session, split…
git:20261102.32695c3 · audit A · 6 stars
implementation-lifecycle SKILL.md skill
ensodynamics/enso-method · skills/implementation-lifecycle/SKILL.md · The umbrella skill for the implementation methodology — how PRDs, technical designs, assumptions, and phase documents…
git:20261102.32695c3 · audit A · 6 stars
implementation-readiness-check SKILL.md skill
ensodynamics/enso-method · skills/implementation-readiness-check/SKILL.md · Pre-implementation validation gate — surface gaps and unclear assumptions before writing code, with proposed answers…
git:20261021.288f2bc · audit A · 6 stars

Every file in ensodynamics/enso-method

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