comet-design

Produce a Design Doc and delta spec through structured brainstorming.

2.7k|259|Updated May 14, 2026
One-click install
npx skills add https://github.com/rpamis/comet --skill comet-design
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: comet-design
Source: https://github.com/rpamis/comet/tree/main/assets/skills/comet-design
Command: npx skills add https://github.com/rpamis/comet --skill comet-design

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Comet Phase 2 requires structured, traceable deep design brainstorming to transform ideas into a formal Design Doc and delta specs. This skill provides a guided workflow to produce a Design Doc and delta spec through OpenSpec handoffs and Superpowers brainstorming.

Core Features & Use Cases

  • Guided deep design brainstorming to convert proposals into concrete architecture decisions.
  • Generates a Design Doc with canonical spec references and an accompanying delta spec.
  • Context-managed handoff flow (OpenSpec) to coordinate design intent, risk analysis, and acceptance criteria.

Quick Start

Invoke Comet Design to start a deep design brainstorm and produce the Design Doc and delta spec.

Frequently Asked Questions about comet-design

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

FAQPage Schema
How do I generate a design doc and delta spec through structured brainstorming?

To generate a design doc and delta spec, you use a guided deep design workflow that transforms proposals into concrete architecture decisions. It produces canonical spec references and coordinates design intent through structured handoffs.

What is the best way to convert architecture proposals into traceable design documentation?

Converting architecture proposals into traceable design documentation requires structured brainstorming that produces a formal Design Doc. This approach ensures traceable context and iterative refinement with spec patches for formal handoffs.

Can I use OpenSpec handoffs to coordinate design validation and risk assessment?

Yes, you can use OpenSpec handoffs to coordinate design validation and risk assessment. The workflow manages context flow to coordinate design intent, analyze risks, and define acceptance criteria for the delta spec.

When do I need a delta spec for architecture decisions?

You need a delta spec for architecture decisions during Phase 2 workflows when refining specifications. It captures iterative changes through spec patches, ensuring design validation and acceptance criteria are traceable.

Does deep design brainstorming support iterative refinement with spec patches?

Yes, deep design brainstorming supports iterative refinement with spec patches. The workflow allows continuous specification refinement, ensuring the design doc and delta spec accurately reflect evolving architecture decisions.

What are the limitations of generating design docs without structured context management?

Generating design docs without structured context management risks losing traceable context and formal handoff coordination. Without guided brainstorming, architecture decisions may lack proper risk assessment, acceptance criteria, and delta spec traceability.