Files
magnus919_agent-skills/software-architecture-analysis/README.md
T
Magnus Hedemark 738ec715e7 Add human-focused README.md to every skill and bundle directory
Each README is written for a human audience, explaining:
- What the skill does (not what format it follows)
- What benefit the user gets from installing it
- Quick setup and usage patterns
- When to load/trigger the skill
- What scripts, references, and templates it ships

data-scientist already had a README — left unchanged.

48 READMEs added across all skill and bundle directories.
2026-07-09 22:30:12 -04:00

30 lines
1.4 KiB
Markdown

# 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.