OpenAgentsControl/.opencode/context/core/context-system/standards/templates.md

Context File Templates

Purpose: Standard formats for all context file types

Last Updated: 2026-01-06

---

Template Selection

Type	Max Lines	Required Sections
Concept	100	Purpose, Core Idea (1-3 sentences), Key Points (3-5), Example (<10 lines), Reference, Related
Example	80	Purpose, Use Case, Code (10-30 lines), Explanation, Related
Guide	150	Purpose, Prerequisites, Steps (4-7), Verification, Related
Lookup	100	Purpose, Tables/Lists, Commands, Related
Error	150	Purpose, Per-error: Symptom, Cause, Solution, Prevention, Reference, Related
README	100	Purpose, Navigation tables (all 5 folders), Loading Strategy, Statistics

---

1. Concept Template

# Concept: {Name}

**Purpose**: [1 sentence]
**Last Updated**: {YYYY-MM-DD}

## Core Idea
[1-3 sentences]

## Key Points
- Point 1
- Point 2
- Point 3

## When to Use
- Use case 1
- Use case 2

## Quick Example

lang [<10 lines]

## Deep Dive
**Reference**: [Link]

## Related
- concepts/x.md
- examples/y.md

---

2. Example Template

# Example: {What It Shows}

**Purpose**: [1 sentence]
**Last Updated**: {YYYY-MM-DD}

## Use Case
[2-3 sentences]

## Code

lang [10-30 lines]

## Explanation
1. Step 1
2. Step 2
3. Step 3

**Key points**:
- Detail 1
- Detail 2

## Related
- concepts/x.md

---

3. Guide Template

# Guide: {Action}

**Purpose**: [1 sentence]
**Last Updated**: {YYYY-MM-DD}

## Prerequisites
- Requirement 1
- Requirement 2

**Estimated time**: X min

## Steps

### 1. {Step}

bash {command}

**Expected**: [result]

### 2. {Step}
[Repeat 4-7 steps]

## Verification

bash {verify command}

## Troubleshooting
| Issue | Solution |
|-------|----------|
| Problem | Fix |

## Related
- concepts/x.md

---

4. Lookup Template

# Lookup: {Reference Type}

**Purpose**: Quick reference for {desc}
**Last Updated**: {YYYY-MM-DD}

## {Section}
| Item | Value | Desc |
|------|-------|------|
| x | y | z |

## Commands

bash

Description

{command}

## Paths

{path} - {desc}

## Related
- concepts/x.md

---

5. Error Template

# Errors: {Framework}

**Purpose**: Common errors for {framework}
**Last Updated**: {YYYY-MM-DD}

## Error: {Name}

**Symptom**:

{error message}

**Cause**: [1-2 sentences]

**Solution**:
1. Step 1
2. Step 2

**Code**:

lang // ❌ Before {bad}

// ✅ After {fixed}

**Prevention**: [how to avoid]
**Frequency**: common/occasional/rare
**Reference**: [link]

---

[Repeat for 5-10 errors]

## Related
- concepts/x.md

---

6. Navigation Template (Replaces README.md)

Note: Use navigation.md instead of README.md for better discoverability

Target: 200-300 tokens

# {Category} Navigation

**Purpose**: [1 sentence]

---

## Structure

{category}/ ├── navigation.md ├── {subcategory}/ │ ├── navigation.md │ └── {files}.md

---

## Quick Routes

| Task | Path |
|------|------|
| **{Task 1}** | `{path}` |
| **{Task 2}** | `{path}` |
| **{Task 3}** | `{path}` |

---

## By {Concern/Type}

**{Section 1}** → {description}
**{Section 2}** → {description}
**{Section 3}** → {description}

---

## Related Context

- **{Category}** → `../{category}/navigation.md`

---

7. Specialized Navigation Template

Use for: Cross-cutting concerns (e.g., ui-navigation.md)

Target: 250-300 tokens

# {Domain} Navigation

**Scope**: [What this covers]

---

## Structure

{Relevant directories across multiple categories}

---

## Quick Routes

| Task | Path |
|------|------|
| **{Task 1}** | `{path}` |
| **{Task 2}** | `{path}` |

---

## By {Framework/Approach}

**{Tech 1}** → `{path}`
**{Tech 2}** → `{path}`

---

## Common Workflows

**{Workflow 1}**:
1. `{file1}` ({purpose})
2. `{file2}` ({purpose})

---

All Templates Must Have

1. Title with type prefix (# Concept:, # Example:, etc.)
2. Purpose (1 sentence)
3. Last Updated (YYYY-MM-DD)
4. Related section (cross-references)

---

Validation

• Correct template for file type?
• Has required sections?
• Under max line limit?
• Cross-references added?
• Added to README.md?

---

Related

• creation.md - When to use each template
• mvi-principle.md - How to fill templates
• compact.md - How to stay under limits