Document Architecture

Produce an evidence-backed map of a software system that lets an unfamiliar developer or coding agent locate responsibilities, trace behavior, and change the system without violating its constraints.

Workflow

1. Establish scope

Determine whether the request is to:

• document the current system;
• explain one subsystem or flow;
• audit and update existing documentation; or
• describe a proposed/target architecture.

Label current and proposed states explicitly. Never present aspiration as implemented behavior.

2. Inspect repository guidance