system-architect

Review system architecture decisions and provide recommendations and decision logs.

Updated Nov 5, 2025
One-click install
npx skills add https://github.com/RichJacobs69/job-analytics --skill system-architect-richjacobs69
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: system-architect
Source: https://github.com/RichJacobs69/job-analytics/tree/main/.claude/skills/system-architect
Command: npx skills add https://github.com/RichJacobs69/job-analytics --skill system-architect-richjacobs69

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps you make sound architectural decisions by focusing on simplicity, scalability, and productization readiness, ensuring your systems are built for both immediate needs and future growth.

Core Features & Use Cases

  • Architecture Review: Evaluate current system designs for adherence to best practices.
  • Decision Guidance: Assist in choosing between technical approaches, abstraction levels, and frontend/backend responsibilities.
  • Scaling Strategy: Plan for future growth by identifying potential bottlenecks and scaling solutions.
  • Use Case: When planning a new feature, use this Skill to review the proposed architecture, ensuring it aligns with principles like YAGNI and maintainability.

Quick Start

Use the system architect skill to review the current architecture for the job analytics pipeline.

Frequently Asked Questions about system-architect

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

FAQPage Schema
How do I review my system architecture for scalability and simplicity?

To guide system design decisions for productization readiness, evaluate frontend/backend boundaries, database schema, and separation of concerns. Applying YAGNI principles during technical reviews prevents over-engineering while ensuring architecture supports future scaling requirements and maintainability.

What's the best way to plan scaling strategies for a growing system?

Planning scaling strategies requires analyzing data flow, database schema, and API design to identify bottlenecks and recommend scaling solutions. Documenting these decisions in decision logs ensures future planning maintains system simplicity while accommodating growth and productization readiness.

When do I need a technical review of my system design?

A technical review of system design is needed when planning new features, evaluating abstraction decisions, or preparing for productization. Analyzing separation of concerns, frontend/backend boundaries, and security ensures architecture aligns with YAGNI principles and maintainability before implementation begins.

How does separating frontend and backend boundaries affect architecture decisions?

Separating frontend and backend boundaries clarifies responsibilities, improves separation of concerns, and simplifies API design within system architecture. This separation enables independent component scaling and supports productization readiness by maintaining clear abstraction levels and data flow boundaries across the system.

Can I use this approach for evaluating database schema and API design together?

Evaluating database schema and API design together involves analyzing data flow and separation of concerns across system architecture. This integrated review identifies scaling considerations, security requirements, and observability needs while generating decision logs that support future planning and productization readiness.