shaping-writing-architecture-sketches

Generate architecture sketch documents defining solution boundaries, components, data shapes, integrations, flows, and risks.

Updated Mar 6, 2026
One-click install
npx skills add https://github.com/musher-dev/bundles --skill shaping-writing-architecture-sketches
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: shaping-writing-architecture-sketches
Source: https://github.com/musher-dev/bundles/tree/main/project-shaping-orchestration/skills/writing-architecture-sketches
Command: npx skills add https://github.com/musher-dev/bundles --skill shaping-writing-architecture-sketches

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps you define the technical architecture of a project by sketching out its components, data flow, and potential challenges before implementation begins.

Core Features & Use Cases

  • Define Solution Boundary: Clearly state what is in and out of scope.
  • Component Inventory: List all components, their type (New/Existing/Modified), and responsibilities.
  • Data Shape: Sketch the structure of key data entities.
  • Integration Points: Map external and internal system connections and their failure modes.
  • Data Flow: Visualize how data moves through the system for primary scenarios.
  • Identify Hard Parts: Highlight technically challenging aspects and potential approaches.
  • Use Case: When starting a new feature, use this Skill to create a clear technical blueprint that aligns the team on the system's structure and identifies potential risks early.

Quick Start

Use the writing-architecture-sketches skill to produce an architecture sketch for the new user authentication system.

Frequently Asked Questions about shaping-writing-architecture-sketches

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

FAQPage Schema
How do I sketch a technical architecture blueprint before implementation?

Sketching a technical architecture blueprint involves defining solution boundaries, listing component inventories, mapping data shapes, and identifying hard parts. This process generates a structured document that aligns the team on system structure and mitigates risks early before coding begins.

What is a component inventory in system design?

A component inventory in system design is a detailed list of all architectural components, categorizing each as New, Existing, or Modified. It clearly defines the specific responsibilities of every component within the solution boundary to guide technical implementation.

How do I map integration points and data flow for a new feature?

Mapping integration points and data flow requires identifying internal and external system connections alongside their failure modes. You then visualize how data moves through the system for primary scenarios to ensure robust technical shaping.

When do I need to identify hard parts in an architecture sketch?

You need to identify hard parts in an architecture sketch when technical approaches require sketching before implementation. This highlights technically challenging aspects and documents potential approaches to align the team on system risks early.

Does this architecture sketching approach work for defining solution boundaries?

Yes, defining solution boundaries is a core feature of architecture sketching. It explicitly states what is in and out of scope for a shaped project, ensuring the technical blueprint remains focused on the required system design.