evolution-architecture-review

Assess software architecture evolvability using repository evidence and incremental change paths.

1.8k|247|Updated Feb 16, 2026
One-click install
npx skills add https://github.com/phodal/routa --skill evolution-architecture-review
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: evolution-architecture-review
Source: https://github.com/phodal/routa/tree/main/.claude/skills/evolution-architecture-review
Command: npx skills add https://github.com/phodal/routa --skill evolution-architecture-review

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Assess how safely a software architecture can evolve within this repository.

Core Features & Use Cases

  • Multi-lens, evidence-driven architecture review guiding evolvability assessment.
  • Anchored in repository evidence (AGENTS.md, docs/ARCHITECTURE.md, docs/product-specs/FEATURE_TREE.md, and more) to ground conclusions.
  • Step-by-step evolution guidance with safe incremental changes and rollback-friendly sequencing.

Quick Start

Invoke Claude Code with the prompt '/evolution-architecture-review analyze the current architecture evolvability' to begin.

Frequently Asked Questions about evolution-architecture-review

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

FAQPage Schema
What is an evidence-driven architecture review for software evolvability?

An evidence-driven architecture review assesses how safely a software architecture can evolve by grounding conclusions in repository artifacts like docs and specs, rather than subjective opinions. It identifies system boundaries and exposes guardrails for incremental changes.

How do I assess if my software architecture can safely evolve?

To assess software architecture evolvability, review module boundaries and change paths using repository evidence. This process identifies safe incremental evolution steps and rollback-friendly sequencing to ensure structural changes do not break existing functionality.

When do I need an architecture review focused on incremental change?

You need an architecture review focused on incremental change when planning modifications across module boundaries. It provides step-by-step evolution guidance, ensuring changes are rollback-friendly and grounded in repository evidence to maintain system stability.

Does architecture evolvability review require specific repository documentation?

Architecture evolvability review anchors its analysis in repository documentation such as AGENTS.md, docs/ARCHITECTURE.md, and product specs. Having these artifacts grounds the evidence-based criteria and improves the accuracy of boundary identification.

What is the best way to identify system boundaries for architecture evolution?

The best way to identify system boundaries for architecture evolution is through a multi-lens, evidence-driven review. This approach satisfies functional requirements by analyzing repository artifacts to expose guardrails and propose safe incremental changes.

Can I use this approach for architecture reviews across multiple modules?

Yes, you can apply this evolvability-focused architecture review across multiple modules. It analyzes change paths and module boundaries using evidence-based criteria, proposing rollback-friendly sequencing to guide safe incremental evolution steps within the repository.