architectural-proposals

Articulate architectural problems and proposed solutions in a structured, review-ready format.

Updated Nov 11, 2025
One-click install
npx skills add https://github.com/acmeleme/Conversation-Knowledge-Mining-Solution-Accelerator --skill architectural-proposals-acmeleme
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architectural-proposals
Source: https://github.com/acmeleme/Conversation-Knowledge-Mining-Solution-Accelerator/tree/main/.squad/templates/skills/architectural-proposals
Command: npx skills add https://github.com/acmeleme/Conversation-Knowledge-Mining-Solution-Accelerator --skill architectural-proposals-acmeleme

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Proposals help teams achieve early alignment on architecture and product direction, preventing costly rework by documenting rationale before code is written.

Core Features & Use Cases

  • Structured decision framework: defines a consistent format for problem statements, proposed architecture, scope, and decisions.
  • Risk-aware planning: includes explicit risks, mitigations, and trade-offs to support governance.
  • Wave and milestone alignment: maps decisions to project waves and milestones to ensure traceability.

Quick Start

Draft an architectural proposal that clearly states the problem, the proposed blueprint, and expected impact before implementation begins.

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 teams before implementation?

Architectural proposals articulate problems and proposed solutions in a review-ready format. They define a consistent structure for problem statements, proposed architecture, scope, and decisions to prevent costly rework before code is written.

What should be included in an architectural proposal for system design?

An architectural proposal should include a Problem Statement, Proposed Architecture, What Changes, Risks and Mitigations, and explicit decision owners. This structure ensures traceability across project waves and milestones during cross-team initiatives.

When do I need to draft an architectural proposal for product direction?

You need an architectural proposal when seeking early alignment on product direction, system design, or cross-team initiatives. Drafting proposals before implementation begins helps document rationale, map decisions to milestones, and prevent expensive rework.

How do I manage risks and trade-offs in architecture decision documents?

Manage risks in architecture decision documents by explicitly listing risks, mitigations, and trade-offs within the proposal structure. This risk-aware planning supports governance by ensuring potential issues are documented alongside the proposed architecture.

Can I map architectural decisions to project waves and milestones?

Yes, you can map architectural decisions to project waves and milestones. This ensures traceability by aligning the decision framework with specific phases, helping teams track when changes occur and who owns each decision throughout the lifecycle.