nobrainer-spec-driven-development SKILL.md skillA

nobrainer-spec-driven-development from nobrainer-tech/nobrainer-tech-flow is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add nobrainer-tech/nobrainer-tech-flow/nobrainer-spec-driven-development@git:20261028.b89d7ef

Pins git:20261028.b89d7ef in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
nobrainer-tech/nobrainer-tech-flow
Path
skills/nobrainer-spec-driven-development/SKILL.md
Versions recorded
9
Latest version
git:20261028.b89d7ef, committed Oct 28, 2026
First version recorded
Aug 27, 2026
Size
6,362 bytes
Repository stars
6
License
MIT

Use when implementation needs a durable, reviewable specification because it changes architecture, public contracts, migrations, several dependent components, or work that may span sessions. Alias: nb-sdd.

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

# NoBrainer Spec-Driven Development

Use spec-driven development to freeze what must be true before deciding how to
build it. This is not subagent-driven development. Session topology is handled
by `nobrainer-sessions`; implementation belongs to `nobrainer-build` and the
project's maintained engineering workflow.

Read [references/spec-template.md](references/spec-template.md) before writing a
new specification. For an idea without a plan, also read
[idea to delivery](../nobrainer-tech-flow/references/idea-to-delivery.md).

## Persist only when it pays

Create or update a durable spec when the owner requests SDD or at least one is true:

- architecture, public behavior, data shape, external interface, or security
  boundary changes;
- migration, irreversible effect, expensive failure, or difficult `ROLLBACK`;
- several dependent components, phases, writers, or sessions share a contract;
- work may be resumed later and chat context would be unsafe;
- conflicting sources or unresolved assumptions can change acceptance.

Do not create a spec for a mechanical one-file correction whose target,
expected result, verification, and rollback are already unambiguous.

## Lifecycle
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add nobrainer-tech/nobrainer-tech-flow/nobrainer-spec-driven-development@sha256:0e4f7740d82837a5

The line at the top of this page pins the label git:20261028.b89d7ef, 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_enuso7222h6rh3hh.svg)](https://markdownregistry.com/a/art_enuso7222h6rh3hh)

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

Versions

The registry has recorded 9 versions of this file, between Aug 27, 2026 and Oct 28, 2026, about one every 8 days.

versioncommittedcommitsizeaudit
git:20261028.b89d7ef latest2026-10-28 b89d7ef 6,362 BA view · diff
git:20261019.285e4212026-10-19 285e421 6,377 BA view · diff
git:20261011.d65ea2c2026-10-11 d65ea2c 6,564 BA view · diff
git:20261002.ec2c2762026-10-02 ec2c276 6,427 BA view · diff
git:20260926.ce1bc202026-09-26 ce1bc20 5,850 BA view · diff
git:20260911.e23cb702026-09-11 e23cb70 5,846 BA view · diff
git:20260904.72005bc2026-09-04 72005bc 5,366 BA view · diff
git:20260828.711be312026-08-28 711be31 5,076 BA view · diff
git:20260827.955de2a2026-08-27 955de2a 5,068 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 (6362 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

nobrainer-tech/nobrainer-tech-flow · 6 stars · license MIT · pushed 2026-11-05 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_enuso7222h6rh3hh
GET https://markdownregistry.com/api/v1/resolve?ref=nobrainer-tech/nobrainer-tech-flow/nobrainer-spec-driven-development
GET https://markdownregistry.com/api/v1/blob/0e4f7740d82837a50262a8d47e13c3af15133e2d0a0dfb065e3515261343f7da

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 nobrainer-tech/nobrainer-tech-flow

AGENTS.md AGENTS.md file
nobrainer-tech/nobrainer-tech-flow · AGENTS.md
git:20261104.e53f1a8 · audit A · 6 stars
CLAUDE.md CLAUDE.md file
nobrainer-tech/nobrainer-tech-flow · CLAUDE.md
git:20261104.e53f1a8 · audit A · 6 stars
nobrainer-auto-fine-tune SKILL.md skill
nobrainer-tech/nobrainer-tech-flow · skills/nobrainer-auto-fine-tune/SKILL.md · Use when setting up nobrainer-tech-flow for the first time, or when client capabilities, model routing, context or…
git:20261028.b89d7ef · audit A · 6 stars
nobrainer-autoimprove SKILL.md skill
nobrainer-tech/nobrainer-tech-flow · skills/nobrainer-autoimprove/SKILL.md · Use when a skill or prompt needs to improve and a measurable, bounded baseline-variant-evaluation loop should replace…
git:20261028.b89d7ef · audit A · 6 stars
nobrainer-browser SKILL.md skill
nobrainer-tech/nobrainer-tech-flow · skills/nobrainer-browser/SKILL.md · Use when you need to inspect or operate a rendered website, attach to an existing approved Chrome/Edge session, restart…
git:20261028.b89d7ef · audit B · 6 stars
nobrainer-build SKILL.md skill
nobrainer-tech/nobrainer-tech-flow · skills/nobrainer-build/SKILL.md · Use when outcome and acceptance are clear and an approved, bounded code, configuration, documentation or test change…
git:20261104.e53f1a8 · audit A · 6 stars
nobrainer-context SKILL.md skill
nobrainer-tech/nobrainer-tech-flow · skills/nobrainer-context/SKILL.md · Use when one project's instructions for coding agents (AGENTS.md, CLAUDE.md, GEMINI.md, Cursor rules, Copilot…
git:20261028.b89d7ef · audit A · 6 stars
nobrainer-decide SKILL.md skill
nobrainer-tech/nobrainer-tech-flow · skills/nobrainer-decide/SKILL.md · Use when choosing between options: just decide for a quick choice, decide or nb-decide for standard analysis, deep…
git:20261011.d65ea2c · audit A · 6 stars
nobrainer-dispatcher SKILL.md skill
nobrainer-tech/nobrainer-tech-flow · skills/nobrainer-dispatcher/SKILL.md · Use when an approved plan has multiple queued work units that require ready-set selection, dependency-aware ordering…
git:20261028.b89d7ef · audit A · 6 stars
nobrainer-rca SKILL.md skill
nobrainer-tech/nobrainer-tech-flow · skills/nobrainer-rca/SKILL.md · Use when an incident, regression, test failure, outage, wrong value or unexpected system behavior has an unclear cause…
git:20261102.814dd35 · audit A · 6 stars
nobrainer-research SKILL.md skill
nobrainer-tech/nobrainer-tech-flow · skills/nobrainer-research/SKILL.md · Use when a task depends on current, niche, uncertain, high-stakes or source-attributed facts, when external information…
git:20261028.b89d7ef · audit A · 6 stars
nobrainer-review SKILL.md skill
nobrainer-tech/nobrainer-tech-flow · skills/nobrainer-review/SKILL.md · Use when work needs an evidence-gated CLOSEOUT, an adversarial BUG_HUNT or a RELEASE_GATE, when someone asks for a DoD…
git:20261104.e53f1a8 · audit A · 6 stars

Every file in nobrainer-tech/nobrainer-tech-flow

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