architectural-proposals

Drafts structured architecture proposals with evidence, risks, and decision documentation.

209|27|Updated Mar 10, 2026
One-click install
npx skills add https://github.com/dotnet/maui-labs --skill architectural-proposals-dotnet
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architectural-proposals
Source: https://github.com/dotnet/maui-labs/tree/main/src/Comet/.copilot/skills/architectural-proposals
Command: npx skills add https://github.com/dotnet/maui-labs --skill architectural-proposals-dotnet

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It solves the problem of misalignment and costly rework by ensuring architecture decisions are documented with clear evidence, specific technical direction, and explicit trade-offs before implementation begins.

Core Features & Use Cases

  • Comprehensive proposal structure: Problem statement, proposed architecture, scope, decision ownership, and measurable success criteria.
  • Risk and mitigation documentation: Likelihood/impact framing with concrete, testable mitigations.
  • Wave and dependency clarity: Guidance for restructuring milestones when foundations shift.
  • Decision framing for sign-off: Recommended option with alternatives and named approval roles.

Quick Start

Ask the AI to draft an architecture proposal that includes a problem statement with evidence, a technically specific solution, what changes vs. stays the same, and a risk section with mitigations for your planned implementation.

Frequently Asked Questions about architectural-proposals

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

FAQPage Schema
How do I write an architecture proposal that prevents implementation rework?

An architecture proposal prevents implementation rework by documenting the problem with evidence, specifying the proposed solution, and defining clear v1 scope boundaries before development begins.

What should be included in an architecture proposal for a product direction shift?

An architecture proposal for a product direction shift must include the problem statement, proposed architecture, scope, regressions, explicit decisions, and risk mitigations with measurable success criteria.

How do I structure risk mitigations for multi-milestone engineering waves?

Risk mitigations for engineering waves require likelihood and impact framing alongside concrete, testable mitigations, ensuring many teams coordinate effectively when foundations shift.

When do I need to draft an evidence-driven architecture proposal?

You need an evidence-driven architecture proposal when invalidated assumptions, dependency changes, or product direction shifts require team alignment and explicit decision ownership before implementation.

How do I frame decisions for sign-off in an architecture proposal?

Decision framing for sign-off requires presenting a recommended option alongside alternatives and naming the specific approval roles responsible for explicit decisions on the proposed architecture.

Does this approach work for coordinating multiple teams during dependency changes?

Yes, this approach works for dependency changes by providing wave and dependency clarity, which guides restructuring milestones and ensures multiple teams coordinate when foundations shift.