# Deep Dive Templates

Two templates: **compact** (default) and **full** (opt-in via `/antivibe full` or "include resources").

---

## Compact Template (default)

<!-- Use this by default. Low token cost. No resources, no line-by-line, no Next Steps. -->

# Deep Dive: [Component/Feature Name]

**Generated**: [YYYY-MM-DD HH:MM:SS]
**Files**: [list of files analyzed]

---

## Overview

[3–5 sentences: what this code does and why it exists]

---

## Key Components

- `[FunctionOrClass]`: [one-line purpose]
- `[FunctionOrClass]`: [one-line purpose]
- `[FunctionOrClass]`: [one-line purpose]

> If more than 5 files are in scope, list the remaining files here with one sentence each and offer to go deeper on request.

---

## Concepts & Decisions

### [Concept 1]

- **What**: [plain language, 1–2 sentences]
- **Why used here**: [design rationale — why this over alternatives, 1–2 sentences]

### [Concept 2]

- **What**: ...
- **Why used here**: ...

---

*Generated by AntiVibe · `/antivibe full` for the extended version with resources and line-by-line walkthrough.*

---
---

## Full Template (opt-in)

<!-- Use when user requests: "/antivibe full", "full deep dive", "include resources", "show everything" -->

# Deep Dive: [Component/Feature Name]

**Generated**: [YYYY-MM-DD HH:MM:SS]
**Phase**: [implementation phase name]
**Files**: [list of files analyzed]

---

## Overview

### What This Code Does

[Brief description - what functionality does this provide?]

### Why This Approach Was Chosen

[Design decisions - why was this written this way? What alternatives were considered?]

### Context

[When would you use this? What problems does it solve?]

---

## Code Walkthrough

### [File 1: filename.ts]

**Purpose**: [What this specific file handles]

**Key Components**:
- `[Function/Class/Method]`: [What it does]

**Line-by-Line Breakdown**:
```typescript
// Line 1-5: [Explanation of what this section does]
codeHere();
```

### [File 2: filename.py]

**Purpose**: [What this specific file handles]

**Key Components**:
- `[Function/Class]`: [What it does]

---

## Concepts Explained

### Design Patterns Used

| Pattern | Where | Why |
|---------|-------|-----|
| [Pattern Name] | [File/Location] | [Design rationale] |

### Key Technical Concepts

#### [Concept 1: e.g., JWT Authentication]

**What**: [Plain-language explanation]

**Why Used Here**: [Design decision explanation]

**When to Use**: [Appropriate contexts]

**Trade-offs**:
- Pros: [What you gain]
- Cons: [What you give up]

**Alternatives**:
- [Alternative 1]: [Brief comparison]
- [Alternative 2]: [Brief comparison]

**Prerequisites to understand this**:
- [Concept A]: [one-line description]
- [Concept B]: [one-line description]

#### [Concept 2]

**What**: ...

**Why Used Here**: ...

**When to Use**: ...

**Prerequisites to understand this**:
- [Concept A]: [one-line description]

---

## Learning Resources

### Official Documentation

- [Doc Name](URL): [What you'll learn here]

### Tutorials & Articles

- [Article Title](URL): [Why this is helpful and what it covers]

### Videos

- [Video Title](URL): [What it covers, estimated length]

### Related Concepts (For Deeper Study)

- [Concept Name]: [Brief description of related topic]

---

## Related Code in This Project

| File | Relationship |
|------|--------------|
| [related-file.ts] | [How it connects - imports, calls, etc.] |
| [other-file.py] | [How it connects] |

---

## Next Steps

1. **Try it yourself**: [Hands-on exercise suggestion]
2. **Deeper dive**: [Advanced topics to explore]
3. **Common pitfalls**: [Things to watch out for]

---

*This deep dive was generated by AntiVibe - the anti-vibecoding learning framework.*
*Learn what AI writes, not just accept it.*