Files
magnus919_agent-skills/software-architecture-analysis
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
..

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.