architectural-proposals

Produce structured architecture proposals documenting decisions, risks, and tradeoffs.

Updated Mar 27, 2026
One-click install
npx skills add https://github.com/lbouriez/Squad-Templates --skill architectural-proposals-lbouriez
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architectural-proposals
Source: https://github.com/lbouriez/Squad-Templates/tree/main/Nectari-Devops-Squad/.copilot/skills/architectural-proposals
Command: npx skills add https://github.com/lbouriez/Squad-Templates --skill architectural-proposals-lbouriez

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Aligning teams around architecture before coding can be inconsistent and slow, leading to misaligned decisions and costly rework.

Core Features & Use Cases

  • Structured decision framing captures problem statements, options, risks, and trade-offs to guide alignment.
  • Wave-aware documentation documents decisions with impact across project waves and milestones.
  • Decision governance defines recommended choices and ownership with explicit sign-off needs.
  • Applicability is useful for new foundations, platform migrations, or major architecture shifts.

Quick Start

Draft a concise architecture proposal outlining the problem, proposed solution, and impact to project waves.

Frequently Asked Questions about architectural-proposals

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

FAQPage Schema
How do I document architecture decisions before coding to ensure team alignment?

Architecture decisions require structured proposals that capture problem statements, options, risks, and trade-offs to guide team alignment before code is written. This prevents inconsistent decisions and costly rework during system foundation design.

What is the best way to structure an architecture proposal for a platform migration?

An architecture proposal for platform migrations should outline the problem, proposed solution, and impact across project waves and milestones. Comprehensive documentation defines recommended choices and ownership with explicit sign-off needs for governance.

How do I evaluate architecture trade-offs and risks for a new system foundation?

Evaluating architecture trade-offs requires structured decision framing that captures problem statements, options, risks, and impacts across project waves. This approach ensures all alternatives are documented before committing to a system foundation.

When do I need formal architecture proposals instead of just starting development?

Formal architecture proposals are needed for new foundations, platform migrations, or major architecture shifts where misaligned decisions create costly rework. They satisfy requirements for structured problem statements, architecture rationale, decisions, risks, and scope documentation.

Can I track architecture decisions across multiple project waves and milestones?

Architecture decisions can be tracked across project waves and milestones using wave-aware documentation. This captures the impact of choices throughout project phases and defines recommended options with explicit sign-off requirements for governance.

How do I frame architecture options and risks to get stakeholder sign-off?

Framing architecture options for sign-off requires structured decision documentation that captures problem statements, trade-offs, and risks. Decision governance defines recommended choices and ownership with explicit sign-off needs to secure stakeholder alignment.