summaryrefslogtreecommitdiff
path: root/makima/src/daemon/skills/directive.md
blob: 0d1e9d6098e01786643c0845eac90ce90e618662 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
---
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
```