skills.rest
grafana
grafanaOFFICIAL
Explore all skills by this author →
Website𝕏@grafanaGitHub

design-review

Critique architecture designs and surface risks from project principles.

19|31|Updated May 29, 2025
Search Tags:#architecture#consultation#design-review#risk-analysis#design-doc#first-principles
One-click install
npx skills add https://github.com/grafana/grafana-pathfinder-app --skill design-review-grafana
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: design-review
Source: https://github.com/grafana/grafana-pathfinder-app/tree/main/.cursor/skills/design-review
Command: npx skills add https://github.com/grafana/grafana-pathfinder-app --skill design-review-grafana

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps teams perform architecture design reviews and critiques with a principal engineer-level perspective. It provides structured reasoning, surfaces hidden assumptions, and drives ambiguity out of plans through guided questions, without writing or modifying code or design documents.

Core Features & Use Cases

  • Structured, first-principles design critique that surfaces hidden assumptions and risks.
  • Aligns designs against project principles and governance documents (ARCHITECTURE_PRINCIPLES.md, related briefs) and facilitates stakeholder discussions.
  • Operates in conversational mode, asking clarifying questions and providing focused recommendations without making changes to code or design documents.
  • Useful for evaluating design documents, architecture decisions, risk analysis, and design partnerships.

Quick Start

Load the design document and start a principled, risk-focused design review through clarifying questions and structured critique.

Frequently Asked Questions about design-review

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

FAQPage Schema
How do I perform a principal-level architecture design review?▼

Perform an architecture design review by loading your design document and engaging in conversational, first-principles critique. The partner asks clarifying questions to surface hidden assumptions and drives ambiguity out of plans without modifying code or documents.

What is first-principles risk analysis for architecture decisions?▼

First-principles risk analysis is a structured critique method that evaluates architecture decisions by identifying hidden assumptions and risks. It aligns designs against project governance documents to drive ambiguity out of formal plans.

Can I use a design review partner to evaluate project governance documents?▼

Yes, you can use it to evaluate governance reviews by loading project context from ARCHITECTURE_PRINCIPLES.md and related briefs. It aligns your architecture decisions against these principles through focused stakeholder discussions.

How do I surface hidden assumptions in a formal design document?▼

Surface hidden assumptions in a design document through guided clarifying questions and structured critique. The review operates conversationally, providing focused recommendations and risk identification without directly editing the document.

Does the design review process modify my code or design documents?▼

No, the design review process enforces hard constraints that prevent any code edits or document modifications without explicit direction. It operates purely in conversational mode to provide critique and risk-focused evaluation.

Related Skills

Explore More Software Engineering Skills→
ArvorCoArvorCo
96

constitution

Create or update a project constitution defining coding principles and governance rules.

Community
Advanced
aget-frameworkaget-framework
11

aget-assess-risk

Assess risks across operational, strategic, financial, compliance, and technical categories.

Official
Intermediate
gkganesh12gkganesh12
1

gk-review

Audit source code against documentation and test suites for architectural drift.

Community
Advanced
Chang-Shih-YungChang-Shih-Yung

health

Aggregate type checker, linter, and test results into a 0-10 composite score.

Community
Advanced