design-review-gate

Runs a five-agent parallel review gate on design documents before implementation begins.

1|Updated Jun 23, 2026
One-click install
npx skills add https://github.com/seal-harness/seal-harness --skill design-review-gate-seal-harness
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: design-review-gate
Source: https://github.com/seal-harness/seal-harness/tree/main/.agents/skills/design-review-gate
Command: npx skills add https://github.com/seal-harness/seal-harness --skill design-review-gate-seal-harness

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Design documents often go straight to implementation without structured review, leading to missed security flaws, unclear use cases, and misaligned architecture that surface only after code is written. This skill enforces a mandatory multi-perspective review gate so complex features are validated by five specialist reviewers before any implementation starts. ## Core Features & Use Cases - Parallel Specialist Review: Spawns Product Manager, Architect, Designer, Security, and CTO agents simultaneously, each with a detailed checklist covering use cases, architecture, UX, OWASP threats, and TDD readiness. - Iterative Gate Protocol: Aggregates structured verdicts (APPROVED or NEEDS_REVISION), consolidates blockers and questions, and supports up to 3 revision cycles before escalating to a human decision. - Dual Coordination Modes: Works with fire-and-forget Task subagents by default, or persistent Team Mode teammates that retain context across review rounds when TeamCreate and SendMessage are available. - Use Case: After brainstorming produces docs/plans/2026-01-11-contact-assistant-design.md, the gate auto-activates, all five agents review it, security flags a userId trust-boundary blocker, and the design is revised and re-reviewed until all approve. ## Quick Start Ask the agent to run the design review gate on your design document, for example by saying: review the design at docs/plans/my-feature-design.md with all five reviewers.

Frequently Asked Questions about design-review-gate

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

FAQPage Schema
How do I run a design review on a design document?

Invoke the gate with /review-design followed by the path to your design document, such as /review-design docs/plans/my-feature-design.md. You can also use --latest to review the most recent design doc in docs/plans/.

What reviewers does the design review gate spawn?

It spawns five parallel agents: Product Manager for use case validation, Architect for technical soundness, Designer for UX and API quality, Security for threat modeling against OWASP, and CTO for TDD readiness and codebase alignment.

When does the design review gate activate automatically?

It auto-activates when a design document is committed to docs/plans/ matching the *-design.md pattern, or when the superpowers:brainstorming skill completes. You can also trigger it manually with the /review-design command.

What happens if reviewers keep rejecting the design?

The gate allows up to 3 revision cycles where you update the design based on consolidated blockers. After 3 failed iterations, it escalates to a human with options to override, defer, revise further, or cancel the feature.

What is the difference between Task Mode and Team Mode?

Task Mode spawns fresh Task() subagents each review round with no retained context. Team Mode uses TeamCreate to make reviewers persistent teammates who retain context across revision cycles, saving cold starts on re-reviews.

Why did a review agent time out during the gate?

Individual agents have a 3-minute timeout. If this occurs, check that the design document is not excessively large, try running agents sequentially with --sequential, or investigate network and API issues.