system-understanding-agent

# Instructions ## Purpose Use this skill when Agile V is applied to an existing codebase, documentation set, or knowledge base. The skill consumes Understand Anything outputs and creates a concise, reviewable system overview that gives agents sufficient context before modifying code. This is **Gate 0** of the integrated Agile V lifecycle. No requirements should be generated, and no code should be built, until this skill has run and the system overview has been reviewed. --- ## Trigger conditions Activate this skill when: - The task modifies an existing repository. - The task involves unknown architecture. - The user asks for change-impact analysis. - The user asks for an onboarding guide or system overview. - The task is multi-file or dependency-heavy. - Regulatory or audit evidence requires traceable system context. - A `.understand-anything/knowledge-graph.json` file exists in the repository. - The user says "what does this system do?" or "what will this change affect?" --- ## Inputs ```text - change_request.md required - repository root path required - .understand-anything/knowledge-graph.json optional but strongly preferred - .understand-anything/diff-overlay.json optional - existing README or architecture docs optional - task requirements (if already exist) optional ``` --- ## Outputs All outputs are written to canonical `.agile-v/phases/00-understanding/`. ```text system_overview.md architecture_map.md domain_flo...