context-builder

Context Builder

Overview

Create a shared vocabulary between you and the agent. Once built, the agent speaks YOUR language — concise, precise, domain-native.

The Problem This Solves

Without shared context:

• Agent uses 20 words where your domain has 1 term
• Variables named generically ("data", "handler", "service") instead of domain terms
• Every session starts from scratch explaining the same concepts
• Conversations are verbose because the agent doesn't know your jargon

With CONTEXT.md:

• Agent speaks your domain language natively
• "the materialization cascade" replaces "when a lesson inside a section of a course is made real"
• Code uses domain terms for variables, functions, modules
• Sessions start with shared understanding already loaded

Process

1. Interview (grill the user)

Ask these questions ONE AT A TIME:

1. "What is this project? One sentence."
2. "What are the 3-5 most important CONCEPTS in this domain?"
3. For each concept: "Define it in one sentence. What terms should I AVOID using for this?"
4. "Are there relationships between these concepts? (X contains many Y, Y belongs to one X)"
5. "Any terms that were previously confusing or ambiguous? What did you resolve them to?"
6. "What actions/verbs are specific to this domain?" (e.g., "materialize", "triage", "hydrate")

2. Generate CONTEXT.md

Write to the project root:

# [Project Name]

[One-sentence description]

## Language

**[Term 1]**:
[Definition in one sentence]
_Avoid_: [terms NOT to use for this concept]

**[Term 2]**:
[Definition]
_Avoid_: [alternatives to avoid]

## Relationships

- A **[Term 1]** contains many **[Term 2]**s
- A **[Term 2]** belongs to one **[Term 1]**

## Flagged Ambiguities

- "[confusing term]" was previously used for both X and Y — resolved: [how it's now used]

3. Persistence

Once CONTEXT.md exists:

• Agent reads it at session start
• Uses defined terms in ALL communication
• Names variables/functions using the vocabulary
• Flags when new undefined terms appear: "Should I add '[term]' to CONTEXT.md?"