summaryrefslogblamecommitdiff
path: root/makima/src/daemon/skills/directive.md
blob: 0d1e9d6098e01786643c0845eac90ce90e618662 (plain) (tree)
















































                                                                                                                                                                                   













                                                                                                                                                                                















                                   





                                      


                                     
---
name: makima-directive
description: Directive orchestration tools for autonomous goal-driven execution. Use when working with directives, chains, steps, verifiers, and approvals.
---

# Makima Directive Commands

These commands let orchestrators interact with directive state. Environment variables (`MAKIMA_API_URL`, `MAKIMA_API_KEY`, `MAKIMA_DIRECTIVE_ID`) are pre-configured by the daemon.

## Status and Information

### Get directive status
```bash
makima directive status
```
Returns full directive details including status, autonomy level, thresholds, and tracking info.

### Get directive goals
```bash
makima directive goals
```
Returns the goal, requirements, acceptance criteria, constraints, and external dependencies.

### List chains
```bash
makima directive chains
```
Returns all chains (plan generations) for the directive, ordered by generation.

### Get chain with steps
```bash
makima directive chain <chain_id>
```
Returns a chain and all its steps with status, dependencies, and evaluation info.

### List steps in a chain
```bash
makima directive steps <chain_id>
```
Returns just the steps array from a chain.

## Status Updates

### Update directive status
```bash
makima directive update-status <status>
```
Updates the directive status. Valid statuses: `draft`, `planning`, `active`, `paused`, `completed`, `archived`, `failed`.

## Evaluation

### Trigger manual evaluation for a step
```bash
makima directive evaluate <step_id>
```
Triggers a monitoring evaluation for the specified step. The step must have been executed (have a contract). Sets the step to "evaluating" and dispatches a monitoring contract.

### List evaluations for a step
```bash
makima directive evaluations <step_id>
```
Returns the evaluation history for a step, ordered by evaluation number.

## Output Format

All commands output JSON to stdout.

Example workflow:
```bash
# Check directive details and goals
makima directive status
makima directive goals

# List execution chains
makima directive chains

# Get details of a specific chain
makima directive chain <chain_id>

# Trigger manual evaluation of a step
makima directive evaluate <step_id>

# Check evaluation history
makima directive evaluations <step_id>

# Update status to active
makima directive update-status active
```