system-architecture

Generate architecture.md and ADRs for Python/React full-stack modules.

8|1|Updated Feb 3, 2026
One-click install
npx skills add https://github.com/hieutrtr/ai1-skills --skill system-architecture-hieutrtr
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: system-architecture
Source: https://github.com/hieutrtr/ai1-skills/tree/main/skills/system-architecture
Command: npx skills add https://github.com/hieutrtr/ai1-skills --skill system-architecture-hieutrtr

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill guides teams through architectural design for Python/React full-stack projects, ensuring consistent structure, ADR discipline, and scalable system decisions during the design phase.

Core Features & Use Cases

  • Architecture guidance for component boundaries, service layers, data flow, and database planning across FastAPI and React applications.
  • Generates architecture documents and ADRs to capture decisions and rationale, promoting maintainable, evolvable designs.
  • Cross-cutting concerns and best practices for authentication, error handling, logging, configuration, and deployment considerations.

Quick Start

Use this skill to produce architecture documentation for a new module, component or subsystem. It will write architecture.md and ADRs based on your inputs. You can then run /api-design-patterns for API contracts or /task-decomposition to create implementation tasks.

Frequently Asked Questions about system-architecture

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

FAQPage Schema
How do I design system architecture for a FastAPI and React full-stack project?

Architecture for FastAPI and React projects involves defining component boundaries, service layers, data flow patterns, and database schemas. This skill generates architecture.md and ADRs to document these scalable system decisions.

What is an Architecture Decision Record and when do I need one for my Python application?

An Architecture Decision Record (ADR) captures design decisions and rationale to promote maintainable, evolvable designs. You need ADRs when planning new modules to ensure consistent structure and document technology trade-offs.

Can this skill generate API contracts and implementation tasks for my React frontend?

No, this skill focuses on system architecture and does not perform implementation work or API contract design. It directs users to run /api-design-patterns for API contracts and /task-decomposition for implementation tasks.

Does the architecture guidance cover cross-cutting concerns like authentication and error handling?

Yes, the architecture guidance covers cross-cutting concerns and best practices for authentication, error handling, logging, configuration, and deployment considerations across FastAPI and React applications.

What is the best way to document technology trade-offs when planning a database schema?

The best way to document technology trade-offs during database schema planning is by generating Architecture Decision Records. This skill produces ADRs to capture your rationale and ensure scalable, evolvable system designs.