tech-stack-architect

Generate TECH-STACK.md and ARCHITECTURE.md from project requirements.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/MacroMan5/claude-code-workflow-plugins --skill tech-stack-architect
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tech-stack-architect
Source: https://github.com/MacroMan5/claude-code-workflow-plugins/tree/main/.claude/skills/tech-stack-architect
Command: npx skills add https://github.com/MacroMan5/claude-code-workflow-plugins --skill tech-stack-architect

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Generates a complete TECH-STACK.md and ARCHITECTURE.md from project requirements, including data flows and mermaid diagrams.

Core Features & Use Cases

  • Phase-based design: Phase 1 tech stack selection; Phase 2 architecture.
  • Mermaid diagrams: Generates data flow and deployment diagrams.
  • Use Case: Starting a new project, define stack and architecture.

Quick Start

Provide project requirements; the tool will generate tech stack and architecture.

Frequently Asked Questions about tech-stack-architect

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

FAQPage Schema
How do I design a complete tech stack and system architecture from project requirements?

Tech stack architecture design starts with your PROJECT-OVERVIEW.md, then systematically selects frontend, backend, database, and DevOps technologies. The process generates TECH-STACK.md with category tables and integration trade-offs, plus ARCHITECTURE.md with data flows, mermaid diagrams, and scalability strategy to document your complete system design.

What should I include in system architecture documentation?

Architecture documentation covers component details, data flows visualized with mermaid diagrams, deployment topology, scalability strategy, and security architecture. It translates technology choices into concrete system behavior, showing how frontend, backend, database, and infrastructure components interact and scale.

When should I use architecture design versus just picking technologies?

Use full architecture design when starting new projects, re-architecting existing systems, or evaluating major technology shifts. Simple technology selection alone misses data flows, integration points, scalability constraints, and security implications that architecture design captures through documentation and diagrams.

Can I generate mermaid diagrams automatically for my system architecture?

Yes, architecture design generates mermaid diagrams showing data flows and deployment topology automatically from your requirements. This creates visual, version-controlled documentation of how system components connect and communicate across your tech stack.

What trade-offs should I document when selecting technologies?

Document trade-offs between competing technologies in each category: performance vs. complexity, cost vs. capability, learning curve vs. team familiarity, and operational overhead. TECH-STACK.md captures these trade-offs alongside migration paths and team considerations for informed technology decisions.

How do I ensure my architecture scales as the project grows?

Architecture design includes explicit scalability strategy covering load distribution, database scaling patterns, caching layers, and infrastructure elasticity. Documenting these patterns upfront prevents re-architecture later and aligns technology choices with growth projections from your project requirements.