Explanation

Understanding-oriented background. These pages explain how planwerk-agent works and why it is built the way it is — read them to build a mental model, not to perform a task.

• Concept & architecture — the high-level data flow of each workflow.
• Review methodology — the Staff Engineer persona, scope-drift detection, the review checklist, and suppressions.
• Caching model — how SHA-based caching avoids repeated analysis.
• Design decisions — the choices behind the tool and their rationale.
• Prompt-design doctrine — the authoring discipline behind the prompt builders, and the failure modes the audit hunts.
• Roadmap — planned future extensions.

For step-by-step instructions, start with the Tutorials or the How-to guides.