system-architect

Designs software architectures, project scaffolding, and linting configurations for Python and JavaScript projects.

1|Updated May 10, 2026
One-click install
npx skills add https://github.com/Tgoldi/claude-skills --skill system-architect-tgoldi
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: system-architect
Source: https://github.com/Tgoldi/claude-skills/tree/main/system-architect
Command: npx skills add https://github.com/Tgoldi/claude-skills --skill system-architect-tgoldi

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? Starting a new project or refactoring an existing one often leads to inconsistent folder structures, ad-hoc technology choices, and missing security or linting standards. This Skill provides a Senior System Architect persona that produces standardized directory layouts, technology stack recommendations, and ready-to-use configuration templates. ## Core Features & Use Cases - Project Scaffolding: Generates standard directory layouts for Python (src layout with pyproject.toml), JavaScript/TypeScript, and full-stack monorepo or multi-repo structures. - Tech Stack & Standards Guidance: Recommends frameworks (Flask vs FastAPI, React vs Vue) and enforces PEP 8, ESLint, and TypeScript strict-mode conventions. - Security & Documentation Templates: Ships an OWASP-based security checklist plus README, ARCHITECTURE, .editorconfig, .pylintrc, and .eslintrc.json templates. - Use Case: When starting a new FastAPI backend, ask for a system design and receive a folder structure, Mermaid architecture diagram, Docker-based deployment notes, and linting configs in one pass. ## Quick Start Ask the assistant to design the architecture and folder structure for a new Python web application with security best practices.

Frequently Asked Questions about system-architect

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

FAQPage Schema
How do I structure a new Python project with src layout?

Place your package under src/<package_name>/, tests in a top-level tests/ directory, and configure tooling in pyproject.toml. Install with pip install -e . so the package is not imported from the repo root.

Flask vs FastAPI for a new Python backend?

FastAPI is recommended when you need async support, automatic OpenAPI docs, and type-driven validation; Flask suits simpler apps with a large extension ecosystem. The Skill recommends stacks based on your stated requirements.

What linting and formatting tools should a TypeScript project use?

Use ESLint with the TypeScript plugin for linting and Prettier for formatting, with strict: true enabled in tsconfig.json. Avoid the any type and prefer interface over type for object shapes.

Should I use a monorepo or separate repos for a full-stack app?

Prefer separate frontend and backend repos unless you need shared types or coordinated releases. For monorepos, use apps/frontend, apps/backend, and shared packages/ with pnpm workspaces, Turborepo, or Nx.

What security checks should a Docker-based web app pass?

Run containers as a non-root user, pin base image versions like python:3.11-slim instead of latest, and use minimal Alpine or Distroless images. Also keep secrets out of git and audit dependencies with npm audit or pip-audit.