skills.rest
constellize
constellizeOFFICIAL
Explore all skills by this author →
GitHub

document-architectural-evolution

Generate an Architectural Evolution document with architecture, triggers, migration path, and lessons.

1|Updated Feb 16, 2026
Search Tags:#documentation#adr#traceability#system-design#decision-record#migration-path#architectural-evolution
One-click install
npx skills add https://github.com/constellize/marketplace --skill document-architectural-evolution
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: document-architectural-evolution
Source: https://github.com/constellize/marketplace/tree/main/plugins/constellize-evolution/skills/document-architectural-evolution
Command: npx skills add https://github.com/constellize/marketplace --skill document-architectural-evolution

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Documents the rationale and context behind architectural changes, ensuring future teams understand why decisions were made and how they evolved over time.

Core Features & Use Cases

  • Captures the original architecture, evolution triggers, migration path, and the final design with stated trade-offs.
  • Provides auditable traceability by linking ADRs and decision records to each evolution step.
  • Records constraints, lessons learned, and guardrails to guide future evolution and maintenance.

Quick Start

Generate a complete Architectural Evolution document for a system, including original architecture, evolution triggers, migration plan, and learned lessons.

Frequently Asked Questions about document-architectural-evolution

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

FAQPage Schema
How do I document architectural evolution and system migration paths?▼

Document architectural evolution by generating a complete record that captures the original architecture, evolution triggers, migration path, and lessons learned to preserve context for future teams.

What is the best way to link ADRs for auditable system design traceability?▼

Linking ADRs and decision records to each evolution step provides auditable traceability, ensuring future teams understand why specific architectural decisions and constraints were made.

Why should I record constraints and trade-offs during a system migration?▼

Recording constraints and trade-offs during system migration documents the rationale behind architectural changes, establishing guardrails and lessons learned to guide future maintenance and evolution.

When do I need an architectural decision record for software evolution?▼

You need an architectural decision record when a system undergoes structural changes, requiring documentation of evolution triggers, migration strategies, and stated trade-offs to maintain an auditable history.

Does this approach work for documenting legacy system migration plans?▼

Yes, this approach works for evolution projects across software systems, specifically including documenting migration plans, constraints, and lessons learned for legacy migrations.

Related Skills

Explore More Software Engineering Skills→
CuriousLearnerCuriousLearner
27

architecture-documenter

Document system architecture and technical decisions with diagrams and ADRs.

Community
Advanced
ievo-aiievo-ai

evo

Capture and classify lessons learned from AI agent usage.

Official
Advanced
stevolandstevoland

adr

Create and manage MADR-compliant Architecture Decision Records across projects.

Community
Basic
xloxn69xloxn69
7

agileflow-adr

Convert discussed architectural decisions into MADR-formatted ADR files.

Community
Basic