system-architect

Reviews designs for architectural compliance with ADRs and contracts.

Updated Feb 19, 2026
One-click install
npx skills add https://github.com/Kotuhan/labor-market-dashboard --skill system-architect-kotuhan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: system-architect
Source: https://github.com/Kotuhan/labor-market-dashboard/tree/main/.claude/skills/system-architect
Command: npx skills add https://github.com/Kotuhan/labor-market-dashboard --skill system-architect-kotuhan

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill ensures that project designs and implementations adhere to established architectural principles, standards, and documentation, preventing technical debt and maintaining system integrity.

Core Features & Use Cases

  • Architectural Governance: Provides oversight and validation of designs against ADRs and contracts.
  • Pre-PO Context: Offers insights into architectural constraints and integration points before a task is formally defined.
  • Design Review: Acts as a mandatory gate to approve or reject designs based on architectural compliance.
  • Architecture Maintenance: Updates architecture documentation and creates retroactive ADRs as needed post-task completion.
  • Use Case: Before a new feature is developed, the system-architect skill reviews the proposed design to ensure it aligns with existing architectural decisions and contracts, preventing future integration issues.

Quick Start

Use the system-architect skill to review the design for task-008.

Frequently Asked Questions about system-architect

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

FAQPage Schema
How do I review software designs against architectural contracts and ADRs?

To review software designs against architectural contracts and ADRs, use the system-architect skill's arch-review mode to validate proposed implementations and approve or reject designs based on compliance.

What is architectural governance and when do I need it for project development?

Architectural governance is the oversight of project designs to ensure adherence to established principles, preventing technical debt. You need it before developing new features to validate alignment with existing architecture.

How do I maintain architecture documentation and create retroactive ADRs after a task?

To maintain architecture documentation and create retroactive ADRs, use the arch-update mode post-task completion to update records and capture architectural decisions that were made during development.

Can I get architectural context and integration insights before a task is formally defined?

Yes, you can get architectural context before a task is formally defined by using the arch-context mode, which provides pre-PO insights into architectural constraints and integration points for informed decision-making.

What is the best way to prevent integration issues when designing a new system feature?

The best way to prevent integration issues when designing a new system feature is to enforce a mandatory design review gate that checks the proposed design against existing architectural decisions and contracts.

Does system architecture governance work without existing ADR documentation?

System architecture governance relies on ADRs and contracts for validation, but if documentation is missing, the arch-update mode can generate retroactive ADRs after task completion to maintain system integrity.