How does it handle Mermaid diagrams?

The skill integrates with the mermaid-collab MCP server to verify visual representations of architecture or flow exist before passing the gate.

What sections does this skill validate in a design document?

It specifically checks for a Problem/Goal statement, Key Decisions with rationale, at least one Diagram, Success Criteria, and an Out of Scope section.

Is there a manual confirmation step?

Yes, once the automated gate passes, the skill uses a browser-based UI or command line prompt to ask for final user confirmation before proceeding.

What happens if a design fails the validation check?

The skill identifies specific gaps, lists the missing components, and redirects the workflow back to the designing phase to address the issues.

Design Validation & Gatekeeping

Name: Design Validation & Gatekeeping
Author: ben-mad-jlp

byben-mad-jlp

•

Collaboration Tools

Ensures technical designs are complete and implementation-ready by verifying required documentation sections and visual diagrams.

About

The Brainstorming Validating skill acts as a quality assurance gate for the technical design process within Claude Code. It automatically audits design documents for essential components such as problem statements, architectural decisions, Mermaid diagrams, and measurable success criteria. By enforcing a standardized completeness gate, it prevents premature implementation and ensures that developers have a clear, unambiguous roadmap before transitioning to the coding phase.

Key Features

Verification of required Mermaid architectural diagrams
Real-time session state management via MCP integration
Interactive UI-based confirmation for workflow transitions
Automated completeness checks for technical design documents
1 GitHub stars
Enforcement of success criteria and project boundaries

Use Cases

Verifying that a feature design has clear success metrics before coding begins
Ensuring architectural diagrams are present in technical specifications
Standardizing the transition from brainstorming to implementation phases

About

Key Features

Verification of required Mermaid architectural diagrams
Real-time session state management via MCP integration
Interactive UI-based confirmation for workflow transitions
Automated completeness checks for technical design documents
1 GitHub stars
Enforcement of success criteria and project boundaries

Use Cases

Verifying that a feature design has clear success metrics before coding begins
Ensuring architectural diagrams are present in technical specifications
Standardizing the transition from brainstorming to implementation phases