role-architect

Design software architecture with layers, modules, data models, and API contracts.

Updated Jan 30, 2026
One-click install
npx skills add https://github.com/ChoiHyunjin/ai_skills --skill role-architect-choihyunjin
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: role-architect
Source: https://github.com/ChoiHyunjin/ai_skills/tree/main/skills/role-architect
Command: npx skills add https://github.com/ChoiHyunjin/ai_skills --skill role-architect-choihyunjin

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps users design the technical architecture and code structure for software systems, ensuring clarity, maintainability, and scalability.

Core Features & Use Cases

  • System Design: Define layers, modules, boundaries, and directory structures.
  • Data & API Contracts: Specify data models and API contracts for inter-module communication.
  • Code Conventions: Establish naming rules, patterns, and best practices.
  • Risk Assessment: Identify technical risks and trade-offs in architectural decisions.
  • Use Case: Architect a new microservice for user authentication, defining its API, data storage, and internal module responsibilities.

Quick Start

Design the architecture for a new e-commerce product catalog system.

Frequently Asked Questions about role-architect

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

FAQPage Schema
How do I design technical architecture and define system layers for a new software project?

To design technical architecture, define system layers, modules, boundaries, and directory structures to ensure clarity and maintainability. This involves specifying data models, API contracts, and internal module responsibilities for inter-module communication.

What is the best way to establish code conventions and naming rules across a software system?

Establishing code conventions requires defining naming rules, patterns, and best practices for your code structure. You can enforce these standards by operating in a dedicated Convention mode to identify violations across the codebase.

How do I identify technical risks and trade-offs when making architectural decisions?

Identifying technical risks and trade-offs involves evaluating architectural decisions against system requirements like scalability and maintainability. A Software Architect Agent assesses these factors to highlight potential issues before implementation.

Can I use this to define API contracts and data models for inter-module communication?

Yes, you can define API contracts and data models specifically for inter-module communication. This specifies how modules interact and ensures consistent data exchange across system boundaries.

Does this approach work for designing a new microservice architecture from scratch?

Yes, designing a new microservice architecture from scratch is a supported use case. You can define the service's API, data storage, internal module responsibilities, and directory structure to ensure a scalable design.

How do I review existing code structure for architectural violations?

Reviewing code structure for violations involves operating in Code Review mode to identify deviations from established patterns. This checks the codebase against defined conventions, boundaries, and interface contracts.