---
aliases: [Alternative Name, Short Form]
tags: [concept, pattern, design]
category: [Cognitive, Tools, Safety, Memory, etc.]
related_mechanisms: [M1, M2, M3]
---

# [Concept Name]

**Category:** [Cognitive Architecture|Tool Integration|Safety & Compliance|Memory & Continuity|etc.]

**Related Mechanisms:** [[Experiments/M# Name|M#]], [[Experiments/M# Name|M#]]

---

## Definition

[1-2 paragraphs defining the concept clearly and concisely.]

### In Simple Terms

[Explain this concept as if to a new developer joining the team.]

---

## How It Works

[2-3 paragraphs describing the mechanism or implementation.]

### Example

```typescript
// Code example showing this concept in action
```

---

## Key Characteristics

1. **Characteristic 1:** [Description]
2. **Characteristic 2:** [Description]
3. **Characteristic 3:** [Description]

---

## Where It's Used

- [[Architecture/Component A|Component A]] — Context about usage
- [[Architecture/Component B|Component B]] — Context about usage
- [[Packages/package-name|package-name]] — Key file: `key/file.ts`

---

## Trade-offs

### Advantages

- [Advantage 1]
- [Advantage 2]
- [Advantage 3]

### Disadvantages

- [Disadvantage 1]
- [Disadvantage 2]

### When to Use

✅ Use this concept when:
- [Condition 1]
- [Condition 2]

❌ Avoid this concept when:
- [Condition 1]
- [Condition 2]

---

## Related Concepts

- [[Concepts/Related Concept 1|Related Concept 1]] — How it relates
- [[Concepts/Related Concept 2|Related Concept 2]] — How it relates
- [[Concepts/Related Concept 3|Related Concept 3]] — How it relates

---

## Learning Resources

- **Test file:** `packages/.../tests/concept-name.test.ts`
- **Implementation:** `packages/.../src/concept-name.ts`
- **Decision doc:** [[Decisions/Decision Name|Decision Name]]
- **Research doc:** [[Concepts/Research Discipline|Research Discipline]]

---

## Validation & Evidence

[If this concept was spike-tested in Phase 1, include validation results.]

| Metric | Result | Status |
|--------|--------|--------|
| [Metric] | [Result] | ✅/❌ |
| [Metric] | [Result] | ✅/❌ |

**Evidence:** [Link to harness report, test results, or measurement doc]

---

## See Also

- [[MOCs/Concepts MOC|Concepts MOC]] — All core concepts
- [[MOCs/Architecture MOC|Architecture MOC]] — System design
- [[MOCs/Research MOC|Research MOC]] — Mechanism validation

---

**Last Updated:** [Date]  
**Status:** [Stable|Experimental|Deprecated]
