Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.oktolabs.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
Multi-agent development

You can run a multi-agent board by giving each agent a narrow role and letting Pulse enforce the boundaries. A simple production setup is Spec + Executor + Validator.

​
Team structure

AgentPresetOwns
Spec agentSpecIdeation, refinement, spec content, sprint planning, card breakdown.
Executor agentExecutorCard implementation through validation.
Validator agentValidatorSpec, sprint, and task gates.
Add QA when test scenario ownership should be separate from implementation.

​
Setup

Create the agents in the web UI, assign presets, then export MCP config. 
okto-pulse init --agents spec-agent executor-agent validator-agent

{
  "mcpServers": {
    "okto-pulse-spec-agent": { "url": "http://127.0.0.1:8101/mcp?api_key=dash_..." }
  }
}

​
Workflow

  1. Spec agent creates ideation and asks ambiguity-killer questions.
  2. Spec agent derives or writes the spec.
  3. Validator submits spec validation when evidence is ready.
  4. Spec agent derives cards and a sprint.
  5. Executor implements cards and moves them to validation with conclusions.
  6. Validator submits task validation and routes each card.

​
Preventing cross-role drift

The important rule is that implementers do not validate themselves. Executor can read validation records but cannot submit them or move validation -> done.

​
Board-level overrides

Use board overrides to restrict an agent on a sensitive board. For example, keep a shared Reporter read-only on production boards while allowing broader reads on evaluation boards.

​
Common failure modes

SymptomCauseFix
Executor gets permission denied on task validationExecutor lacks card.validation.submit.Ask Validator to review.
Spec agent cannot move approved spec to validatedGate transition is Validator-owned.Submit spec validation as Validator.
Agent cannot act in current statusMissing interact_in flag.Adjust preset or board override.
Last modified on May 8, 2026