proposal-to-design-resolution

Resolve design ambiguity in project proposals through structured interactive Q&A.

Updated Oct 8, 2025
One-click install
npx skills add https://github.com/ichabodcole/project-docs-scaffold-template --skill proposal-to-design-resolution
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: proposal-to-design-resolution
Source: https://github.com/ichabodcole/project-docs-scaffold-template/tree/main/plugins/project-docs/skills/proposal-to-design-resolution
Command: npx skills add https://github.com/ichabodcole/project-docs-scaffold-template --skill proposal-to-design-resolution

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Resolve design ambiguity in a proposal through structured, interactive Q&A before development planning. The process ensures that unclear system behavior, data models, and architectural assumptions are crystallized before work begins.

Core Features & Use Cases

  • Structured Q&A rounds to surface and resolve behavioral, data-model, and architectural ambiguities.
  • Phase-guided workflow with clear gates: Read & Analyze Proposal, Structured Q&A, Synthesize & Write, Review & Refine.
  • Generates a design-resolution document at docs/projects/$1/design-resolution.md that links back to the proposal and supports subsequent planning.

Quick Start

Start a guided Q&A to resolve design questions in the proposal before planning.

Frequently Asked Questions about proposal-to-design-resolution

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

FAQPage Schema
How do I resolve design ambiguity in a project proposal before planning?

To resolve design ambiguity in a project proposal, use a structured, interactive Q&A process to clarify unclear system behavior, data models, and architectural assumptions before development planning begins.

What is structured Q&A for design resolution?

Structured Q&A for design resolution is a phase-guided workflow that surfaces and resolves behavioral, data-model, and architectural ambiguities through targeted questions before synthesizing a final design document.

How do I clarify unclear data models and architectural assumptions?

You can clarify unclear data models and architectural assumptions by engaging in structured Q&A rounds that crystallize system behavior, ensuring all unresolved proposal questions are answered before project planning.

When do I need to resolve design ambiguity before development planning?

You need to resolve design ambiguity before development planning when a proposal has unresolved behavioral questions, unclear data models, or architectural ambiguity that could impact subsequent project execution.

What does a design resolution document include?

A design resolution document includes synthesized answers to architectural and behavioral questions, references the original proposal, aligns with project conventions, and informs subsequent development planning.

What is the best way to analyze project proposals for architectural ambiguity?

The best way to analyze proposals for architectural ambiguity is applying a phase-guided workflow with clear gates: read and analyze the proposal, conduct structured Q&A, synthesize findings, and review the output.