architectural-proposals

Write evidence-based architectural proposals with problem statements, risks, and scope.

Updated Apr 3, 2026
One-click install
npx skills add https://github.com/sachinnair90/gitgloss --skill architectural-proposals-sachinnair90
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architectural-proposals
Source: https://github.com/sachinnair90/gitgloss/tree/main/.copilot/skills/architectural-proposals
Command: npx skills add https://github.com/sachinnair90/gitgloss --skill architectural-proposals-sachinnair90

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps teams make high-stakes architecture decisions before implementation starts, reducing rework, unclear ownership, and avoidable regressions when product direction or technical foundations change.

Core Features & Use Cases

  • Writes structured proposals that explain the problem, recommended architecture, trade-offs, risks, and scope in a format that supports review and sign-off.
  • Handles situations where a new foundation affects multiple waves, milestones, or modules and where downstream plans need to be rethought.
  • Uses concrete evidence from current decisions, product requirements, and architecture docs so proposals are specific enough to guide execution.
  • Example use case: a team needs to introduce a new interactive shell or rework a core workflow and wants alignment on the design before any code changes begin.

Quick Start

Review the current decisions, requirements, and architecture context, then draft a proposal in docs/proposals that clearly states the problem, recommended design, impacts, risks, scope, and required approvals.

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 architectural proposal for a system redesign?

An architectural proposal aligns stakeholders before implementation begins by applying concrete evidence from current decisions, product requirements, and architecture docs to document problem statements, architecture choices, risks, scope, and backward-compatibility considerations.

When do I need a technical proposal for system design changes?

You need a technical proposal when facing architecture shifts, product-direction changes, dependency-driven redesigns, or wave restructuring across existing roadmaps to reduce rework, unclear ownership, and avoidable regressions before implementation starts.

How do I align stakeholders before implementation begins?

You align stakeholders by creating structured proposals that explain the problem, recommended architecture, trade-offs, risks, and scope in a reviewable format designed to support sign-off before any code changes begin.

Can I use architectural proposals for multi-wave roadmap restructuring?

Yes, architectural proposals handle situations where a new foundation affects multiple waves, milestones, or modules, allowing you to rethink downstream plans and align the redesigned architecture across the existing roadmap.

What should be included in an architecture proposal document?

An architecture proposal document should include explicit problem statements, recommended architecture choices, trade-offs, risks, scope, backward-compatibility considerations, and required approvals based on concrete evidence from PRDs and current architecture docs.

What are the limitations of using proposals for technical planning?

Proposals for technical planning require reading existing team decisions, PRDs, and architecture docs beforehand, meaning they cannot generate accurate designs without prior context and concrete evidence from current team documentation.