magnus919_agent-skills/software-architecture-analysis/README.md

# Software Architecture Analysis — Reverse Engineering to Design Document

Reverse-engineer a codebase to understand its architecture, data flow, privacy posture, and feature surface — then produce a clean-room design document, PRD, or migration plan.

## Why Install This Skill

When your agent loads this skill, it becomes a **codebase archaeologist** who can:

- **Map repository structure** — identify core components, languages, and frameworks
- **Extract architecture** — understand how the system is actually built, not how it's documented
- **Inventory features** — catalog every capability the system provides
- **Identify implicit contracts** — storage operations, data flows, integration points
- **Design clean-room alternatives** — re-imagine the system under new constraints (local-first, privacy-first, self-hosted)
- **Produce specifications** — PRDs, design documents, migration plans with zero source code copying

## What You Get

| Directory | Purpose |
|-----------|---------|
| `SKILL.md` | 7-phase build workflow, trigger conditions |
| `references/` | Phase-by-phase guidance with architecture extraction patterns, clean-room methodology |

## Triggers

Load this when you need to understand how a codebase works, produce a design document for a system in the same problem space, or create a clean-room specification.

## Requirements

Git, a programming language runtime matching the target codebase.


## Quick Start

Start with the setup and first workflow in SKILL.md, then use the linked resources for the specific task you need to complete.