Maestro

data-ai MCP Server

Agent harness for codebases. Gives Claude Code, Codex, and CI a shared task system, verdict ledger, and state store so agent work is traceable and auditable.

Verified
data-aidata-ai
4 views197 stars20 forksMIT

Why This Matters

Discovered via github-topic:mcp and last synced 3mo ago.

Verified
Source
github-topic:mcp
Stars
197
Last synced
3mo ago
Install
Check source

Install

Install instructions not detected yet

Check the source repository for the latest setup steps.

View source instructions
42
Tools
0
Resources
0
Prompts
Standard I/O
Transport

Available Tools (42)

Concept

Purpose

Mission

The top-level unit of work with a lifecycle such as `draft`, `approved`, or `executing`.

Milestone

A phase within a mission. Milestones can act as work phases or validation gates.

Feature

A concrete piece of work assigned to an agent type, with verification steps and optional dependencies.

Assertion

A validation target tied to a feature. Assertions are updated to `passed`, `failed`, `blocked`, or `waived`.

Handoff

A persisted launch record plus markdown brief for starting a fresh Codex or Claude session from current mission or repo context.

Task

A Claude-style blocker-graph work item for the daily loop; lives at `.maestro/tasks/tasks.jsonl` independent of missions.

Reply

A agent's structured outcome record for a feature, optionally gated by behavioral principles.

Principle

A behavioral rule injected into agent prompts and scored against replies. Stored at `.maestro/principles.jsonl`.

Surface

Lives where

Memory

Corrections, learnings, and compiled guidance that feed back into future agent prompts.

Checkpoint

A timestamped mission snapshot you can save and later restore.

Bundle

A portable `.mission.tar.gz` archive of a mission plus its artifacts for review or transfer.

Command

What it does

Cost

💰💰💰💰💰

rediscovered_decision

state

migrate

Snapshot `.maestro/` and fold legacy feature/task/decision/harness trees into `.maestro/cards/`

watch

Live dependency-tree board, or a one-shot snapshot; an optional id focuses one feature

recurring_blocker

behavioral

index

Maintain the local text index that accelerates `card list --grep`

feature

Manage the product contract and its lifecycle

card

Work the flat store: `ready` / `list` / `show` / `create` / `update` / `close` / `claim` / `assign` / `note` / `dep` / `graph` / `archive` (`--parent`, `--type`, `--assignee`, `--status`, `--grep`)

lean

Show or set the session lean mode, emit review/audit guidance, or harvest debt markers

idea

Harness/self-improvement proposal

init

Scaffold `.maestro/` and extract bundled resources

link

Add or remove non-blocking `related` edges between live cards; linked cards can use `msg`

version

Print the version and binary path

missing_verification

state

active

Show other live sessions, their bound cards, link state, progress, and copy-paste link/message hints

harness

List, show, apply, dismiss, and measure self-improvement idea cards

recurring_intervention

behavioral

task

Create, claim, complete, `verify`, and inspect `proof` for proof-gated work cards (`task watch` for a live list)

loop

Print a loop-orchestration recipe (or the index): `loop list`, `loop show <name>`

decision

Create, lock, show, and list decision cards

Detector

Class

upgrade

Upgrade the binary and refresh resources

doctor

Diagnose the installation

msg

Send, read, and list pull-only messages on linked-card channels

conflict

Flag a link-free, git-free "I'm taking this ground, hold off" notice on a peer card; `--clear` retracts it

Type

Role

missing_skill

behavioral

playbook

Print a language code styleguide, or the index with no language