design-doc SKILL.md skillA
design-doc from lamngockhuong/aiteamkit is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add lamngockhuong/aiteamkit/design-doc@git:20261021.ae774f4Pins git:20261021.ae774f4 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- lamngockhuong/aiteamkit
- Path
plugins/atk/skills/design-doc/SKILL.md- Versions recorded
- 3
- Latest version
- git:20261021.ae774f4, committed Oct 21, 2026
- First version recorded
- Oct 1, 2026
- Size
- 15,660 bytes
- Repository stars
- 9
- License
- MIT
Write the technical design document a team reviews before coding, plus its ADR: current state, options with trade-offs, chosen approach, data and API changes, migration, rollback, risks, open questions, and who signs off. Use before code that touches a schema, a public contract, a shared module, or several services. `--spike` first investigates, time-boxed, a question the design cannot choose without; `--challenge` puts one agent per signing role on the draft; `--answer` records answers to its…
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 Document (`atk:design-doc`) Produces the document a Tech Lead and peers can review without a meeting, and the ADR that survives the people who wrote it. The point is the comparison: a design with only one option is a plan, not a design, and gets reviewed as such. ## Scope Handles: describing the current implementation with citations, framing the problem, comparing viable options against stated criteria, specifying the chosen data model, API contracts, and the migration and rollout sequence the change requires, and writing the ADR entry. Under `--spike`, it also investigates a question the comparison cannot be scored without, inside a time box somebody set, and writes what was found instead of a design. Given a design at `DRAFT`, it finishes or revises it. Under `--answer`, it records a person's answers to a design's open questions, and the edits review settles, until the design is `APPROVED`; it never answers one itself. Does NOT handle: writing the requirement (`atk:intake`), sizing (`atk:estimate`), or the implementation itself. It chooses the approach and stops there: sequencing the chosen approach into …
Read the whole file at its exact version.
How to install
mdr add lamngockhuong/aiteamkit/design-doc@sha256:5cb504d6677dfe7aThe line at the top of this page pins the label git:20261021.ae774f4, 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_wloev4mdz5c7psbu)
4 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 3 versions of this file, between Oct 1, 2026 and Oct 21, 2026, about one every 10 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20261021.ae774f4 latest | 2026-10-21 | ae774f4 | 15,660 B | A | view · diff |
| git:20261014.03c655e | 2026-10-14 | 03c655e | 9,583 B | A | view · diff |
| git:20261001.ed02384 | 2026-10-01 | ed02384 | 9,371 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 (15660 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
lamngockhuong/aiteamkit · 9 stars · license MIT · pushed 2026-10-22 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_wloev4mdz5c7psbu GET https://markdownregistry.com/api/v1/resolve?ref=lamngockhuong/aiteamkit/design-doc GET https://markdownregistry.com/api/v1/blob/5cb504d6677dfe7a67a3c53380150db6263668de9eb0ce8b41f2a2eca44be1f0
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 lamngockhuong/aiteamkit
Every file in lamngockhuong/aiteamkit