architecture-design

Designs technical architecture for features, bug fixes, and refactors using codebase evidence and existing patterns.

1|1|Updated Jun 24, 2026
One-click install
npx skills add https://github.com/growmax/growmax-skills --skill architecture-design-growmax
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: architecture-design
Source: https://github.com/growmax/growmax-skills/tree/main/gmax/skills/architecture-design
Command: npx skills add https://github.com/growmax/growmax-skills --skill architecture-design-growmax

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? It prevents teams from designing changes from task descriptions alone, which leads to architectures that ignore the existing codebase, break shared consumers, or introduce unnecessary new patterns. ## Core Features & Use Cases - Business-flow-first reasoning: Positions every task inside the user's business flow (WHO → FLOW → FEATURE → CODE → TECHNICAL DESIGN) before proposing any technical change. - Evidence-based system mapping: Maps business steps to actual code with path:line citations, finds the closest existing pattern, and traces bugs to root causes across all layers. - Shared Architecture Protocol: For shared or system-level changes, identifies all consumers, ownership, invariants, and blast radius so sibling features do not regress. - Use Case: Before planning a change to a pricing calculation, run this skill to produce an approved architecture design with a feature map, API contract, acceptance criteria, and regression surface that the planner, builder, and reviewer all follow. ## Quick Start Ask the AI to design the architecture for your confirmed task, for example: "Design the architecture for the notification settings feature based on the confirmed business context."

Frequently Asked Questions about architecture-design

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

FAQPage Schema
How do I design software architecture before writing code?▼

Start from the confirmed business context, map the business flow to existing code with path:line evidence, find the closest existing pattern, then design through system, data, technical, decision, and impact lenses. This skill writes the result as an architecture-design.md document.

How to trace a bug to its root cause across the full stack?▼

Trace Expected Flow → Actual Flow → Failure Point → Root Cause → Corrected Flow through every layer the flow crosses, from frontend to API to backend to data. Never assume the bug is in the file the report names.

When should a change skip the architecture design step?▼

Trivial or small local work skips it. The skill classifies changes as Local, Feature, Shared, or System scope; only Local changes get a lightweight collapsed design, while Shared and System changes require the full Shared Architecture Protocol.

How do I avoid breaking shared code when changing one feature?▼

Run the Shared Architecture Protocol: find all consumers by import/reference search, distinguish structural from behavioral sharing, record ownership and invariants, and list the regression surface so every consumer is verified after the change.

Can I deviate from the project's existing patterns in a design?▼

Yes, via the developer override rule. The design records the existing pattern, the requested deviation, and its impact in the Assumptions/Deviations section, then continues rather than silently introducing a new architecture.