# Project Vocabulary

<!-- Terms, jargon, acronyms specific to this project -->
<!-- Updated by Spec Writer agent when new terms are introduced -->

| Term | Meaning | First seen |
|------|---------|------------|
| SDD | Spec-Driven Development — formal specs before code | 2026-02-27 |
| TDD | Test-Driven Development — write tests before implementation | 2026-02-27 |
| REQ | Requirement — atomic spec unit, 3-7 acceptance tests each | 2026-02-27 |
| CR | Change Request — modification to existing REQ | 2026-02-27 |
| PLAN | Implementation plan created by Architect for a REQ | 2026-02-27 |
| TUI | Terminal User Interface — Textual-based interactive dashboard | 2026-02-27 |
| sandbox | Docker container (`ievoai/sandbox:latest`) for isolated agent execution | 2026-02-27 |
| manifest | `.ievo/config.yaml` — project configuration file | 2026-02-27 |
| registry | `registry.yaml` in marketplace — source of truth for `ievo add` | 2026-02-27 |
| session ID | Unique identifier for a Claude Code session, enables `--resume` | 2026-02-27 |
| evolution | Agent self-improvement — detecting errors and updating instructions | 2026-02-27 |
| evolution signal | Distilled finding from Evolution agent → GitHub issue in curator | 2026-03-03 |
| curator | Cross-agent pattern aggregator — collects evolution signals | 2026-03-03 |
| sub-agent | Native Claude Code `.md` file in `.claude/agents/` — auto-delegated | 2026-03-02 |
| agent memory | `memory: user` — persistent cross-project learning at `~/.claude/agent-memory/` | 2026-03-02 |
| evolution overlay | `.ievo/evolution/<agent>.md` — project-specific rules surviving agent updates | 2026-03-02 |
| auto-init | Automatic project initialization triggered by `ievo` with no args when no project found, after user confirmation | 2026-03-03 |
| deprecated command | CLI command that still works but shows a deprecation warning; will be removed in a future release | 2026-03-03 |
| internal API | `add_agents()` — programmatic entry point for HR agent, no deprecation warning, no CLI argument parsing | 2026-03-03 |
| HR agent | Human Resources agent — autonomously manages agent installation, updates, and removal | 2026-03-03 |
| bundled content | Marketplace files (agents, templates, skills, registry) shipped inside the pip package at `src/ievo/marketplace/` | 2026-03-03 |
| YAML frontmatter | Agent metadata in `.md` files, enclosed between `---` delimiters at the top of the file | 2026-03-03 |
| CLAUDE_AGENTS_DIR | Path constant `.claude/agents` — new agent install location for single `.md` file format | 2026-03-03 |
| placeholder agent | Minimal `.md` file with valid frontmatter, created when both bundled and GitHub sources fail | 2026-03-03 |
| kernel overlay | `.ievo/evolution/KERNEL.md` — evolution lessons that target pipeline rules (IEVO.md conventions), not individual agents | 2026-03-03 |
| ievo marker block | `<!-- ievo:start -->...<!-- ievo:end -->` block injected into CLAUDE.md during init; removed by `ievo uninstall` | 2026-03-03 |
| kernel evolution target | Classification used by the evolution agent when a finding's root cause is in pipeline rules rather than an agent's own instructions | 2026-03-03 |
| trajectory | Ordered sequence of tool calls (input + output + timing) captured during an agent session, stored as JSONL | 2026-03-04 |
| debug capture | The hook-based system (PreToolUse/PostToolUse/Stop) that records trajectory, outcome, and thinking data per session | 2026-03-04 |
| trajectory.jsonl | Per-session JSONL file: one record per tool call. Fields: seq, tool, input, output, duration_ms, ts_start, ts_end | 2026-03-04 |
| outcome.yaml | Per-session YAML file written by Stop hook: session_id, stop_reason, ts_end, transcript_path | 2026-03-04 |
| thinking.md | Per-session markdown file: extended thinking blocks extracted from PostToolUse payloads | 2026-03-04 |
| tool_use_id | Unique ID per tool call in Claude Code hook payloads; used to correlate PreToolUse timing with PostToolUse record | 2026-03-04 |
| fine-tuning dataset | Training data built from trajectory (input sequence) + outcome (label) pairs for model fine-tuning | 2026-03-04 |
