architecture-documentation

name	architecture-documentation
description	Document technical architecture
languages	["all"]
subagents	["all"]
tools_needed	["read","write"]

Architecture Documentation

Overview

Comprehensive guide to document technical architecture.

Why This Matters

• Importance 1
• Importance 2
• Importance 3

Core Concepts

Concept 1: [Name]

Definition: [What is it] When to use: [When applicable] How it works: [Mechanism]

Concept 2: [Name]

Definition: [What is it] When to use: [When applicable] How it works: [Mechanism]

Implementation Guide

Phase 1: [Phase Name]

[Detailed steps and explanation]

Phase 2: [Phase Name]

[Detailed steps and explanation]

Phase 3: [Phase Name]

[Detailed steps and explanation]

Common Patterns

Pattern A: [Description] [Code or example]

Pattern B: [Description] [Code or example]

Best Practices

1. Practice 1: [Explanation and rationale]
2. Practice 2: [Explanation and rationale]
3. Practice 3: [Explanation and rationale]
4. Practice 4: [Explanation and rationale]
5. Practice 5: [Explanation and rationale]

Common Pitfalls

❌ Mistake 1: [What goes wrong] ✅ Correct: [How to do it right]

❌ Mistake 2: [What goes wrong] ✅ Correct: [How to do it right]

❌ Mistake 3: [What goes wrong] ✅ Correct: [How to do it right]

Advanced Topics

Topic 1

[Advanced explanation]

Topic 2

[Advanced explanation]

Tools & Resources

• Tool 1
• Tool 2
• Tool 3

Checklist

• Understood core concepts
• Reviewed patterns
• Considered pitfalls
• Applied to your context
• Documented decisions