observal-agents

# Observal Agents: Agent Lifecycle Management ## Critical Rules 1. **EXECUTE commands**: run them in your shell. Set timeout to 60 seconds. 2. **Use single quotes** for `--prompt` and `--description` values. 3. **Pass `--output json`** on list/show/versions commands. 4. **Pass `--yes`** on destructive commands (`delete`, `unarchive`, `bulk-create`). 5. **Resolve 409:** `observal agent publish --update` for in-place edits, `observal agent release --bump` for reviewed releases. 6. **When in doubt about a flag, run `<command> --help` first.** --- ## Procedure: Create Agent Required: `--name`, `--description`, `--prompt`. Optional: `--model` (default: `claude-sonnet-4`), `--ide` (repeatable), `--owner`, `--prompt-file`, `--from-file`. > **WARNING:** Without `--name` and `--prompt`, the command launches an interactive wizard. Always pass at least `--name`, `--description`, and `--prompt`. ```bash observal agent create \ --name AGENT_NAME \ --description 'Short description' \ --prompt 'System prompt content' \ --model claude-sonnet-4 \ --ide kiro --ide claude-code ``` Error branching: - **`409`**: switch to Procedure: Update Agent or Release Agent Version. - **`422`**: missing required field. Check message, fix, retry. - **`Connection failed`**: server unreachable; use `observal-advanced` skill's Local Fallback. --- ## Procedure: Update Agent Skips review queue. Overwrites in place. 1. Write `observal-agent.yaml`. **Critical:** include `model_config_json: {}` ...