rcode-waleed-architect

Analyze software architecture decisions with trade-off and change-cost reasoning.

2|1|Updated Apr 10, 2026
One-click install
npx skills add https://github.com/hanzlahabib/rcode --skill rcode-waleed-architect
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: rcode-waleed-architect
Source: https://github.com/hanzlahabib/rcode/tree/main/rcode/skills/agents/waleed-architect
Command: npx skills add https://github.com/hanzlahabib/rcode --skill rcode-waleed-architect

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps teams make sound technical architecture decisions when the right choice is unclear, especially for stack selection, system design reviews, scalability planning, and architecture decision records.

Core Features & Use Cases

  • Architecture Guidance: Compare technologies, data stores, deployment models, and system boundaries with practical trade-offs.
  • Decision Records: Turn non-trivial choices into durable architecture decision records for long-lived projects.
  • Scale and Risk Analysis: Evaluate reversibility, blast radius, team capacity, and maintenance cost before committing to a path.
  • Use Case: A founder asks whether to use a modular monolith or microservices for a new SaaS platform, and this Skill guides the decision with clear constraints and documented rationale.

Quick Start

Ask Waleed to review your system architecture and recommend the best stack for your project based on team size, timeline, scale, and maintenance needs.

Frequently Asked Questions about rcode-waleed-architect

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

FAQPage Schema
How do I decide between a modular monolith and microservices for a new SaaS platform?

System design decisions between a modular monolith and microservices require evaluating team capacity, timeline, scalability needs, and maintenance costs. Comparing these constraints with explicit trade-off analysis and change-cost reasoning helps justify the chosen architecture while accounting for blast radius and reversibility.

What is an architecture decision record and when do I need one for long-lived projects?

An architecture decision record (ADR) documents non-trivial technical decisions for long-lived projects by capturing rationale, trade-offs, and constraints. You need an ADR when justifying stack selection, system boundaries, or database choices to ensure durable, documented outcomes that account for reversibility and blast radius.

How do I perform a scalability planning review for my software architecture?

Scalability planning reviews evaluate your system architecture by analyzing deployment models, data stores, and system boundaries against expected growth. The process requires explicit trade-off analysis, assessing maintenance costs, team capacity, and blast radius to determine if the architecture can handle increased load.

What is the best way to compare database trade-offs during tech stack selection?

Comparing database trade-offs during tech stack selection involves evaluating data stores against practical constraints like reversibility, maintenance cost, and team capacity. The best approach uses explicit trade-off analysis and change-cost reasoning to document outcomes and justify your technical decision.

Can I use this architecture guidance for a small team with limited maintenance capacity?

Architecture guidance for small teams factors team capacity directly into technical decisions, ensuring stack selection and system design match available resources. It evaluates maintenance costs and blast radius to recommend reversible choices that prevent over-engineering and minimize long-term technical debt.

Why does system design review require explicit trade-off analysis and change-cost reasoning?

System design reviews require explicit trade-off analysis and change-cost reasoning to prevent irreversible architectural mistakes. Documenting these factors ensures that stack selection and scalability planning account for blast radius, team capacity, and maintenance costs before committing to a technical path.