Home / vmobifystudio / app-dev-team · skills/spec-critic/SKILL.md · GitHub

spec-critic skillA

spec-critic is agent-read markdown (skill) from vmobifystudio/app-dev-team: Use after the impl specs and the board exist but before any developer is spawned, to find every question a developer would otherwise be forced to guess at — error types, empty/failure states, cancel paths, source of truth, units, offline, atomicity. Produces `question` rows in the team ledger for tech-lead to answer in one batch. Triggers from /app-plan and from tech-lead whenever a sprint is about to start..

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

# Spec critic

`tech-lead` runs this. **Do not create an agent for it** — tech-lead wrote the impl specs and is the
role that answers these questions anyway, so a new role costs a spawn and buys a relay.

Run it **once per sprint**, after `docs/22-impl-spec-*.md` and `docs/31-board.md` exist and before
`/app-build` spawns anyone. Not once per ticket.

## Why it exists

Measured across three dry runs and ten agent-runs, the live team channel was used **zero times** —
including a run where the agent hit a planted ambiguity, decided it should raise it, and then
reported that it had, when it had not. An agent that can proceed will proceed. The full story is in
`skills/team-protocol/SKILL.md` § "Why ICs mostly won't message" and
`docs/research/2026-07-29-dry-run-3-full-sprint.md`.

"Declare, don't dispatch" catches the guess *after* it was made. This catches it before, while an
answer still costs one line instead of a review-and-rework cycle.

## What you hunt

For each ticket on the board, read its acceptance criteria and the spec section it points at, then
ask what a developer would have to invent. **Ground every question in an acceptance criterion — a
…

Read the whole file at its exact version.

How to install

Latest version
mdr add vmobifystudio/app-dev-team/spec-critic@git:20260729.32eb18a
Exact content
mdr add vmobifystudio/app-dev-team/spec-critic@sha256:79815f0801e889d1

Pin 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.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_fe7y6rw2izsszdby.svg)](https://markdownregistry.com/a/art_fe7y6rw2izsszdby)

1 badge views in 30 days

Versions

versioncommittedcommitsizeaudit
git:20260729.32eb18a latest2026-07-29 32eb18a 5,999 BA view · diff
git:20260729.dc21f652026-07-29 dc21f65 5,012 BA view

Audit of the latest version

A  17 of 17 checks passed. Deterministic, no model, 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 (5999 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

vmobifystudio/app-dev-team · 4 stars · license MIT · pushed 2026-09-19 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_fe7y6rw2izsszdby
GET https://markdownregistry.com/api/v1/resolve?ref=vmobifystudio/app-dev-team/spec-critic
GET https://markdownregistry.com/api/v1/blob/79815f0801e889d1cdd794f2dd99a3f55b5c7850e4fa716b513713957d9ffeaa

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.

More from vmobifystudio/app-dev-team

accessibility-gate skill
vmobifystudio/app-dev-team · skills/accessibility-gate/SKILL.md · Use as a pass/fail gate on any diff with a user-facing surface — by code-reviewer during review, by qa-engineer during…
git:20260729.071181e · audit A · 4 stars
agent-isolation skill
vmobifystudio/app-dev-team · skills/agent-isolation/SKILL.md · Use before spawning any agent that writes files, and by every developer/fixer agent as its first and last action. Gives…
git:20260807.98058c3 · audit A · 4 stars
architecture-builder skill
vmobifystudio/app-dev-team · skills/architecture-builder/SKILL.md · Use to produce the technical architecture doc and engineering principles for a mobile app. Used primarily by the CTO…
git:20260729.6f1f11e · audit A · 4 stars
board-doctor skill
vmobifystudio/app-dev-team · skills/board-doctor/SKILL.md · Use to validate docs/31-board.md before spawning any agent, and to verify a developer's "DONE" claim before moving a…
git:20260729.071181e · audit A · 4 stars
brownfield-onboarding skill
vmobifystudio/app-dev-team · skills/brownfield-onboarding/SKILL.md · Use when pointing the team at an EXISTING, already-built app instead of a blank project — detects the stack…
git:20260729.d5165d9 · audit A · 4 stars
business-model skill
vmobifystudio/app-dev-team · skills/business-model/SKILL.md · Use when deciding or revisiting how the product makes money — pricing, tiers, trial shape, ad load, unit economics — by…
git:20260729.071181e · audit A · 4 stars
content-design skill
vmobifystudio/app-dev-team · skills/content-design/SKILL.md · Use when writing or reviewing any string a user reads — labels, buttons, empty states, errors, permission prompts…
git:20260729.071181e · audit A · 4 stars
context-preflight skill
vmobifystudio/app-dev-team · skills/context-preflight/SKILL.md · Run before changing a repository to verify branch, worktree, ticket, dependencies, source-of-truth documents, and…
git:20260731.42d47b3 · audit A · 4 stars
database-migration skill
vmobifystudio/app-dev-team · skills/database-migration/SKILL.md · Use before changing any persisted schema — by backend-developer on a server store, by web-developer on a client or…
git:20260729.071181e · audit A · 4 stars
defect-hunting skill
vmobifystudio/app-dev-team · skills/defect-hunting/SKILL.md · Use when reviewing code, auditing an app, writing a guard rule or test, or certifying any threshold/constant/formula…
git:20260810.958b327 · audit A · 4 stars
dependency-policy skill
vmobifystudio/app-dev-team · skills/dependency-policy/SKILL.md · Audit declared dependencies, lockfiles, tool versions, compatibility, licenses, and upgrade evidence before…
git:20260731.42d47b3 · audit A · 4 stars
design-system skill
vmobifystudio/app-dev-team · skills/design-system/SKILL.md · Use when defining or extending design tokens and the shared component library — by product-designer when writing…
git:20260729.071181e · audit A · 4 stars

Every file in vmobifystudio/app-dev-team

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