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

{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