2

    software-architect

    by Roy Yuen

    A structured framework for planning, reviewing, and evolving complex software systems with explicit trade-offs.

    Updated Jun 2026
    198 views
    Security scanned

    $5

    · or 25 credits

    30-day refund guarantee

    Secure checkout via Stripe

    Included in download

    • Decompose a legacy monolith into scalable microservices
    • Design event-driven data flows with explicit reliability trade-offs
    • Ready for Codex CLI
    • Includes example output and usage patterns
    • Instant install

    Sample input

    We're hitting DB bottlenecks at 4k/rps on our Rails monolith. Evaluate extracting auth vs. an event-driven approach for scalability and provide a migration plan.

    Sample output

    Current State: Monolithic Ruby on Rails, DB contention at 4k/rps. Candidate Option A: Extract Auth via gRPC. Candidate Option B: Event-driven via SNS/SQS. Recommendation: Option B. Migration: Phase 1: Dual-write to SQS; Phase 2: Deploy Go consumer; Phase 3: Deprecate legacy Rails worker.

    About This Skill

    Systematic Architecture Design

    The Software Architect skill transforms vague engineering briefs into rigorous, artifact-driven technical designs. Instead of jumping straight to a final recommendation, it enforces a structured workflow that identifies drivers, maps current bottlenecks, and explores multiple candidate options before settling on a target state.

    What it does

    • Artifact-First Planning: Generates explicit documents for Problem Framing, Architecture Drivers, and Current-State Mapping.
    • Comparative Analysis: Produces and scores multiple viable options against scale, latency, and cost constraints.
    • Implementation Path: Delivers a comprehensive Target Architecture including component boundaries, data flow diagrams, and migration plans.
    • Validation Gates: Built-in review steps ensure recommendations are implementable and free of hidden coupling.

    Why use this skill?

    Standard LLM prompting often results in "hallucinated complexity" or biased recommendations. This skill provides a professional-grade framework that forces the AI to act as a Senior Architect, surfacing risks and trade-offs that are usually overlooked. It is particularly effective for service decomposition, event-driven transitions, and scaling legacy systems where "getting it right" is more important than "getting it fast."

    Output Format

    The skill produces a structured technical document following an industry-standard Output Contract, covering everything from reliability notes and security boundaries to a concrete, step-by-step migration plan.

    Use Cases

    • Decompose a legacy monolith into scalable microservices
    • Design event-driven data flows with explicit reliability trade-offs
    • Compare multiple technical options against cost and latency drivers
    • Generate a detailed migration plan for major infrastructure refactors

    Reviews

    No reviews yet - be the first to share your experience.

    Only users who have downloaded or purchased this skill can leave a review.

    Security Scanned

    Passed automated security review

    Permissions

    No special permissions declared or detected

    Codex CLI, Claude Code, Cursor, and SKILL.md-compatible agents.

    Creator

    Frequently Asked Questions

    More Premium Skills

    $5