code-explain-templates

Code Explanation Templates Reference

Templates and patterns for the /explain:code-explain command. All examples are C#/.NET focused.

Complexity Metrics

Code Analysis Checklist

## Code Complexity Analysis

| Metric | Value | Threshold |
|--------|-------|-----------|
| Lines of Code | {count} | <200 per class |
| Cyclomatic Complexity | {value} | <10 per method |
| Nesting Depth | {depth} | <4 levels |
| Method Count | {count} | <20 per class |
| Dependency Count | {count} | <10 per class |

### Identified Concepts
- [ ] Async/await patterns
- [ ] Dependency injection
- [ ] Repository pattern
- [ ] Unit of Work
- [ ] CQRS pattern

---

Visual Diagram Templates

Flow Diagram (Mermaid)

flowchart TD
    F0[MethodName]
    F0_params[/param1, param2/]
    F0_return[ReturnType]
    F0_params --> F0
    F0 --> F0_return
    F0 --> F1[CalledMethod]

Class Diagram (Mermaid)

classDiagram
    class ClassName {
        -privateField : Type
        +PublicProperty : Type
        -PrivateMethod() : void
        +PublicMethod(params) : ReturnType
    }
    IInterface <|.. ClassName : implements
    BaseClass <|-- ClassName : extends
    ClassName --> DependencyClass : uses

Sequence Diagram (Mermaid)

sequenceDiagram
    participant Controller
    participant AppService
    participant Repository
    participant Database

    Controller->>AppService: CreateAsync(dto)
    AppService->>Repository: InsertAsync(entity)
    Repository->>Database: INSERT INTO...
    Database-->>Repository: Success
    Repository-->>AppService: Entity
    AppService-->>Controller: DTO

---

Concept Explanations

Dependency Injection

## Understanding Dependency Injection

Dependency Injection (DI) is a design pattern where objects receive their dependencies from external sources rather than creating them internally.

**Simple Analogy**: Instead of a chef growing their own vegetables (tight coupling), vegetables are delivered to them (loose coupling). The chef doesn't need to know where vegetables come from.

**How it works in .NET**:
```csharp
// ❌ Without DI - tightly coupled
public class PatientService
{
    private readonly PatientRepository _repository = new PatientRepository();
    // Hard to test - can't mock the repository
}