architectural-proposals

Documents architecture decisions, risks, and scope in a structured proposal before coding begins.

Updated Apr 16, 2026
One-click install
npx skills add https://github.com/Leep-GH/Lee-s-squad --skill architectural-proposals-leep-gh
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architectural-proposals
Source: https://github.com/Leep-GH/Lee-s-squad/tree/main/.copilot/skills/architectural-proposals
Command: npx skills add https://github.com/Leep-GH/Lee-s-squad --skill architectural-proposals-leep-gh

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Solves alignment problems by documenting architecture decisions before coding begins.

Core Features & Use Cases

  • Structured template: provides required sections (Problem Statement, Proposed Architecture, What Changes, What Stays the Same, Key Decisions, Risks and Mitigations, Scope).
  • Decision framing and risk analysis: guides explicit choices, rationale, and ownership with traceable decisions.
  • Impact assessment across waves: communicates how changes affect milestones, modules, and timelines.

Quick Start

Draft an architectural proposal by outlining the problem, proposed architecture, changes, and risks in docs/proposals, then circulate for feedback

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 begins?

You can establish team alignment by drafting structured proposals that outline problem statements, proposed architecture, and key decisions. This ensures trade-offs and scope are documented before coding begins.

What should be included in an architectural proposal template?

A proposal template should include Problem Statement, Proposed Architecture, What Changes, What Stays the Same, Key Decisions, Risks and Mitigations, and Scope sections to ensure explicit decision framing and comprehensive risk analysis.

How do I assess the impact of architecture changes across project milestones?

Assess change impacts by documenting how modifications affect milestones, modules, and timelines within the proposal. This communicates trade-offs across waves and ensures coordinated team alignment during system design evaluations.

How do I create a decision log for system design trade-offs?

Create a decision log by framing explicit choices, rationale, and ownership with traceable decisions within the proposal. This provides a documented record of risk analyses and architectural choices for team collaboration.

What is the best way to structure team collaboration around system designs?

Structure team collaboration by drafting alignment-first architectural proposals. Circulating documents that outline problems, proposed architecture, and risks in docs/proposals allows teams to coordinate feedback and evaluate trade-offs effectively.