system-architect
by 1999azzar
Coding Agents & IDEsBrief
Acts as a Senior System Architect to design robust, scalable, and maintainable software architectures.
Description
What This Skill Does
Configures an AI agent to act as a Senior System Architect. Covers project scaffolding, tech stack selection, linting configuration, and architecture documentation. Defaults to security-first design and the YAGNI principle.
Combines scaffolding, stack recommendations, linting templates, and documentation into one consistent persona instead of switching between separate tools and reference docs.
When to Use It
- Starting a new Python or Node.js project from scratch
- Choosing between Flask and FastAPI for a backend service
- Reviewing folder structure before onboarding new engineers
- Generating ESLint and pylint configs for a TypeScript or Python repo
- Producing an ARCHITECTURE.md for a client or team handoff
Example Workflow
User asks: Design a REST API backend for a SaaS application
- 1
Scopes the design using YAGNI to avoid over-engineering
- 2
Recommends a tech stack (FastAPI, PostgreSQL, Docker)
- 3
Generates a standard directory layout for the project
- 4
Produces .pylintrc and .editorconfig configuration files
- 5
Outputs an ARCHITECTURE.md covering components, data flow, and deployment
Folder structure, stack rationale, lint configs, and a ready-to-use ARCHITECTURE.md
Requirements
- Docker
Installation
clawhub install 1999azzar/system-architectRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.