Documentation Index
Fetch the complete documentation index at: https://docs.10et.ai/llms.txt
Use this file to discover all available pages before exploring further.
Agents are configured with TOML files in .tenet/agents/. Each file defines one agent with its metric, eval script, scope, and constraints.
Basic Example
.tenet/agents/test-coverage.toml
[agent]
name = "test-coverage"
scope = "tests"
metric = "coverage_percent"
direction = "maximize"
time_budget_seconds = 600
rounds = 10
target_repo = "../my-service"
description = "Add tests for uncovered files. Focus on src/ files with 0% coverage first."
[eval]
script = "eval/test-coverage.sh"
data = "eval/fixtures/test-coverage-baseline.jsonl"
[constraints]
scope_files = ["src/**/*.ts", "src/**/__tests__/*.test.ts"]
max_file_changes = 5
Reference
[agent] Section
| Field | Type | Required | Description |
|---|
name | string | ✅ | Unique agent identifier |
scope | string | ✅ | Category (tests, quality, performance, product) |
metric | string | ✅ | Primary metric name (must match eval script output) |
direction | string | ✅ | "maximize" or "minimize" |
time_budget_seconds | number | ✅ | Max time per round |
rounds | number | | Default rounds per session (overridable via CLI) |
target_repo | string | | Relative path to target repo (for cross-repo agents) |
description | string | | Instructions for the agent — what to do, what to avoid |
[eval] Section
| Field | Type | Required | Description |
|---|
script | string | ✅ | Path to eval script (relative to project root) |
data | string | ✅ | Path to eval fixtures/baseline data |
[constraints] Section
| Field | Type | Description |
|---|
scope_files | string[] | Glob patterns for files the agent can modify |
files_in_scope | string[] | Additional file patterns (broader scope) |
files_readonly | string[] | Files the agent must NOT modify |
max_file_changes | number | Maximum files changed per round |
[policy] Section (Advanced)
| Field | Type | Default | Description |
|---|
embedding_model | string | auto | Model for state embeddings |
exploration_rate | number | 0.2 | Initial exploration rate (ε-greedy) |
decay_per_round | number | 0.004 | Exploration decay per round |
min_exploration | number | 0.05 | Minimum exploration rate |
[context_scope] Section
| Field | Type | Description |
|---|
produces | string[] | Events this agent emits (e.g., "perf:cli-improved") |
consumes | string[] | Events this agent reacts to (e.g., "telemetry:metric-alert") |
Full Example (CLI Speed Agent)
.tenet/agents/tenet-cli-speed.toml
[agent]
name = "tenet-cli-speed"
scope = "performance"
metric = "p90_ms"
direction = "minimize"
time_budget_seconds = 180
rounds = 50
target_repo = "../tenet-cli"
[eval]
script = "eval/cli-speed.sh"
data = "eval/fixtures/cli-speed-baseline.jsonl"
[constraints]
scope_files = [
"src/index.ts",
"src/commands/status.ts",
"src/commands/doctor.ts",
"src/lib/service-detector.ts",
"src/utils/cache.ts",
]
files_in_scope = ["src/commands/**/*.ts", "src/lib/**/*.ts"]
files_readonly = ["eval/**", "node_modules/**", "dist/**"]
max_file_changes = 3
[policy]
exploration_rate = 0.2
decay_per_round = 0.004
min_exploration = 0.05
[context_scope]
produces = ["perf:cli-improved", "perf:latency-reduced"]
consumes = ["telemetry:metric-alert", "code:refactored"]
Creating an Agent Interactively
This walks you through setting up name, metric, eval script, and scope.
Listing Agents
Configured Agents
test-coverage
Scope: tests
Metric: coverage_percent (maximize)
Time budget: 600s
Files: src/**/*.ts, src/**/__tests__/*.test.ts
cli-speed
Scope: performance
Metric: p90_ms (minimize)
Time budget: 180s
Files: src/index.ts, src/commands/status.ts, ...
Archiving Agents
Move dead agents to .tenet/agents/_archived/:
mv .tenet/agents/old-agent.toml .tenet/agents/_archived/
agent list.
