brainstorm-architecture

Facilitate structured system architecture discussions covering tech stack, API design, and ADR documentation.

8|Updated Jul 2, 2026
One-click install
npx skills add https://github.com/firdaus12p/MACCA-METHOD --skill brainstorm-architecture
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: brainstorm-architecture
Source: https://github.com/firdaus12p/MACCA-METHOD/tree/main/.agents/skills/brainstorm-architecture
Command: npx skills add https://github.com/firdaus12p/MACCA-METHOD --skill brainstorm-architecture

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill streamlines the process of defining and documenting system architecture, ensuring that design decisions are well-reasoned and well-documented.

Core Features & Use Cases

  • System Context Mapping: Identifies all components and external dependencies interacting with the system.
  • Tech Stack Definition: Specifies the chosen technologies and frameworks for the system.
  • State Management Strategies: Outlines client and server state management approaches.
  • API Design Guidelines: Establishes the communication protocol between frontend and backend.
  • Folder Structure Recommendations: Suggests optimal directory layouts for project organization.
  • Design Patterns Application: Applies appropriate architectural patterns like MVC and Clean Architecture.
  • Authentication & Authorization Solutions: Defines authentication mechanisms and access control rules.
  • Deployment & Infrastructure Guidelines: Offers guidance on hosting, CI/CD, and deployment strategies.
  • Architecture Decision Records (ADR) Documentation: Ensures key decisions are recorded for future reference.

Quick Start

Initiate a new architecture brainstorm session using the 'brainstorm-architecture' skill.

Frequently Asked Questions about brainstorm-architecture

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

FAQPage Schema
How do I define system architecture for a new software project?

To define system architecture, you need a structured process covering system context, tech stack selection, state management, API design, and deployment strategies. This ensures all components and external dependencies are mapped before development begins.

What is the best way to document architecture decisions for future reference?

The best way to document architecture decisions is through Architecture Decision Records (ADR). ADRs capture the reasoning behind design patterns, authentication mechanisms, and tech stack choices, ensuring future teams understand the context.

How should I structure API design and state management for a client-server system?

API design and state management should be structured by establishing clear communication protocols between frontend and backend, while outlining specific client and server state management strategies to maintain data consistency.

Does this approach to system design apply to specific architectural patterns like Clean Architecture?

Yes, this system design approach applies architectural patterns like Clean Architecture and MVC. It guides how to structure folders and apply these patterns to ensure separation of concerns and maintainability.

What do I need to cover when planning deployment and infrastructure guidelines?

Planning deployment and infrastructure guidelines requires defining hosting environments, CI/CD pipelines, and deployment strategies. It also involves establishing authentication and authorization rules to secure the deployed system.