reviewing-technical-design

Reviews a finished technical design document against an 11-condition implementability bar and emits an approve or revise verdict.

1|1|Updated May 24, 2026
One-click install
npx skills add https://github.com/bm629/agent-skills --skill reviewing-technical-design-bm629
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: reviewing-technical-design
Source: https://github.com/bm629/agent-skills/tree/main/skills/reviewing-technical-design
Command: npx skills add https://github.com/bm629/agent-skills --skill reviewing-technical-design-bm629

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Engineering teams need an independent acceptance gate that decides whether a finished technical design document (TDD) is complete enough for an engineer to implement without re-deriving the design, without the reviewer silently relaxing standards or inventing new ones. ## Core Features & Use Cases - 11-Condition Implementability Checklist: Judges requirement traceability, scope, decomposition, reference-not-duplicate, alternatives, failure handling, observability, testing, rollout/rollback, grounded assumptions, and amend scoping. - Machine-Parseable Verdict: Emits exactly VERDICT: approve or VERDICT: revise plus actionable findings naming the failed condition, location, and concrete fix. - Delta-Scoped Amend Review: Reviews only the changed decisions and their ripple when handed a change request against an existing TDD. - Use Case: After authoring a TDD for a new export feature, run this gate before implementation; it flags an inlined API contract that should be referenced from the api-spec and a rollback plan missing measurable triggers. ## Quick Start Use reviewing-technical-design on docs/specs/export-feature-tdd.md and give me the verdict with findings.

Frequently Asked Questions about reviewing-technical-design

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I review a technical design document before implementation?

Hand the finished TDD to this gate, which reads it independently and judges it against 11 implementability conditions covering traceability, decomposition, failure handling, observability, testing, and rollout. It returns a single VERDICT: approve or revise line plus actionable findings.

What makes a technical design doc ready for implementation?

A ready TDD traces every decision to a requirement bidirectionally, stays scoped to one feature, references rather than duplicates owned contracts, weighs a real alternative, handles each failure mode, names observability signals, covers failure cases in testing, and defines measurable rollback triggers.

When should I use design-review instead of this TDD review gate?

Use design-review for generic engineering design docs, RFCs, ADRs, specs, or plans that need claims verified against the codebase. This gate is only for the doc-library technical-design artifact, identified by the template: technical-design frontmatter.

Can this skill review an amendment to an existing design doc?

Yes. When handed a change request against an existing TDD, it runs a delta-scoped review of only the changed decisions and their ripple, checking version bumps, changelogs, and SSOT impacts, without re-reviewing the unchanged design.

Why does a thin design doc sometimes get approved?

The bar is proportionate: a small feature legitimately omits migration, concurrency, or a separate observability section. The gate judges completeness of applicable decisions, not section count, and never manufactures gaps from brevity.