design-grill

Analyze complex feature architecture and generate a design document with decisions and trade-offs.

Updated Jun 26, 2025
One-click install
npx skills add https://github.com/flaviogragnolati/coco --skill design-grill-flaviogragnolati
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: design-grill
Source: https://github.com/flaviogragnolati/coco/tree/main/.agents/skills/design-grill
Command: npx skills add https://github.com/flaviogragnolati/coco --skill design-grill-flaviogragnolati

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill provides a comprehensive architectural discovery process for complex features, ensuring that the design is robust and scalable.

Core Features & Use Cases

  • Deep Architectural Analysis: Delve into the design of large, complex features that span multiple modules and introduce new domain concepts.
  • Documentation Generation: Automatically generate a durable architecture design document with a high-level rollout plan.
  • Decision Recording: Record architectural decisions and trade-offs, including the rationale behind each choice.
  • Use Case: When designing a new feature that requires significant architectural changes, use this Skill to ensure that all aspects of the design are thoroughly considered.

Quick Start

Run the design-grill skill with the argument 'What complex feature, architectural change, or cross-cutting capability should be grilled?'

Frequently Asked Questions about design-grill

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

FAQPage Schema
How do I document architectural decisions and trade-offs for a complex feature?

To document architectural decisions for a complex feature, you need a process that captures the rationale behind each choice and trade-offs. This performs deep architectural analysis and records all decisions to ensure durable design documentation.

What is the best way to analyze a cross-cutting capability that spans multiple modules?

The best way to analyze a cross-cutting capability spanning multiple modules is through deep architectural discovery. This process examines the design of large, complex features to ensure the resulting architecture is robust and scalable across all affected areas.

When should I use a deep architectural discovery process instead of standard design patterns?

You should use deep architectural discovery when designing a new feature that requires significant architectural changes or introduces new domain concepts. Standard design patterns may lack the scope needed to thoroughly consider all aspects of complex, multi-module features.

How do I generate an architecture design document with a rollout plan?

You generate an architecture design document with a rollout plan by running a deep architectural analysis on your specified complex feature. This process automatically produces durable documentation that includes a high-level rollout strategy alongside recorded trade-offs.

Does this architectural analysis tool work for features introducing new domain concepts?

Yes, this architectural analysis tool is specifically designed for large, complex features that introduce new domain concepts. It delves into the multi-module design to ensure all architectural changes are thoroughly considered and robustly documented.