One-click install
npx skills add https://github.com/Ryno-Crypto-Mining-Services/braiins-insights-mcp-server --skill architect-role-skill
Or copy as Structured Prompt for Agentā–¼
Please help me install this Agent Skill.
Skill: architect-role-skill
Source: https://github.com/Ryno-Crypto-Mining-Services/braiins-insights-mcp-server/tree/main/docs/claude/skills/architect-role-skill
Command: npx skills add https://github.com/Ryno-Crypto-Mining-Services/braiins-insights-mcp-server --skill architect-role-skill

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill provides a structured approach to software architecture, from designing new systems to analyzing and improving existing codebases. It ensures that technical decisions are well-documented, scalable, secure, and aligned with business goals, reducing risks and accelerating development.

Core Features & Use Cases

  • Greenfield Project Initialization: Guides through requirements discovery, technology stack justification, and generation of DEVELOPMENT_PLAN.md, ARCHITECTURE.md, and SECURITY.md.
  • Existing Codebase Analysis: Evaluates current systems across dimensions like code organization, scalability, and maintainability, providing prioritized recommendations.
  • Comprehensive Planning Documents: Creates detailed data models, API specifications, deployment strategies, and risk mitigation plans.
  • Use Case: You're starting a new e-commerce platform. Use this skill to define the technology stack (React, Node.js, PostgreSQL), design a microservices architecture, outline scalability strategies, and generate all necessary planning documents for the development team.

Quick Start

Use the architect-role-skill to design the architecture for a new e-commerce platform.

Frequently Asked Questions about architect-role-skill

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

FAQPage Schema
How do I design architecture for a new system from scratch?ā–¼

System design from scratch involves discovering requirements, selecting appropriate technology stack, defining scalability and security strategies, then documenting decisions in architecture and planning documents. This skill guides you through requirements gathering, technology justification, and generation of comprehensive ARCHITECTURE.md and DEVELOPMENT_PLAN.md files aligned with business goals.

What should I look for when analyzing an existing codebase for architectural improvements?ā–¼

Codebase analysis evaluates code organization, scalability bottlenecks, maintainability issues, and security gaps across your system. This skill systematically reviews these dimensions and delivers prioritized recommendations to reduce technical debt and improve long-term system resilience.

How do I choose the right technology stack for my project?ā–¼

Technology stack selection requires evaluating frameworks, databases, and platforms against your scalability, security, and business requirements. This skill applies structured evaluation methods to justify technology choices and ensures your stack supports current and future development roadmaps.

What does a complete architectural decision document include?ā–¼

Comprehensive architectural planning documents cover data models, API specifications, deployment strategies, risk mitigation plans, and security considerations. This skill generates these artifacts with the technical depth needed for development teams to execute without ambiguity.

Can I use this approach for both new and existing systems?ā–¼

Yes. This skill applies to greenfield projects through guided initialization and to existing systems through architectural reviews. It handles technology stack evaluation and production of development plans for both starting fresh and improving established codebases.

How do I ensure security and scalability are built into my architecture from the start?ā–¼

Security architecture and scalability strategies are addressed during requirements discovery and technology selection phases. This skill generates dedicated SECURITY.md documentation and scalability planning as part of the architectural foundation, reducing risks and implementation rework.