architectural-proposals

Name: architectural-proposals
Availability: InStock
Author: nicolehaugen

Guide creation of architectural proposals with structured documentation and risk analysis.

Updated Apr 8, 2026

Search Tags:#architecture #stakeholder alignment #risk analysis #proposal writing #decision framing

Ready to run

npx skills add https://github.com/nicolehaugen/CustomMetricsDashboard --skill architectural-proposals-nicolehaugen

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: architectural-proposals
Source: https://github.com/nicolehaugen/CustomMetricsDashboard/tree/main/.squad/templates/skills/architectural-proposals
Command: npx skills add https://github.com/nicolehaugen/CustomMetricsDashboard --skill architectural-proposals-nicolehaugen

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps create alignment among stakeholders by guiding the development of comprehensive architectural proposals before code is written.

Core Features & Use Cases

Problem Statement: Clearly defines the issues with the current architecture.
Proposed Architecture: Provides a detailed solution with technical specifics.
Changes and Impact: Describes the impact on existing work and what stays the same.
Decision Framing: Facilitates explicit decision-making with alternatives and rationale.
Risk Analysis: Identifies risks and their mitigation strategies.
Scope Definition: Defines the scope of the proposed changes.

Quick Start

Use the architectural-proposals skill to write a comprehensive architectural proposal for the upcoming project.

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 that aligns stakeholders before coding starts?▼

An architectural proposal aligns stakeholders by structuring a problem statement, proposed architecture, and decision framing to drive technical decisions before code is written. It requires structured documentation and risk analysis to define scope and impact.

What should be included in a technical architecture proposal for a project review?▼

A technical architecture proposal should include a problem statement, proposed architecture with technical specifics, changes and impact on existing work, decision framing with alternatives, risk analysis with mitigations, and scope definition to facilitate project planning and architecture reviews.

How do I frame technical decisions and alternatives in a software architecture document?▼

Decision framing in a software architecture document facilitates explicit decision-making by presenting alternatives and rationale alongside the proposed architecture. This structured documentation approach ensures stakeholders understand the technical specifics and impact before approving changes.

When do I need a formal architectural proposal instead of just starting implementation?▼

You need a formal architectural proposal when stakeholder alignment and risk analysis are required before code is written. It applies to project planning and architecture reviews where structured documentation of problem statements, proposed architecture, and scope definition drives technical decisions.

How do I perform risk analysis and define scope for proposed architecture changes?▼

Risk analysis for proposed architecture changes identifies potential risks and documents their mitigation strategies within the architectural proposal. Scope definition explicitly boundaries the proposed changes, while the changes and impact section describes effects on existing work to align stakeholders.

Does the architectural proposals approach work for small scope changes or only large project planning?▼

The architectural proposals approach scales to both small scope changes and large project planning by requiring structured documentation. It defines the scope of proposed changes, describes impact on existing work, and facilitates decision framing to align stakeholders regardless of project size.