hashgraph-online/awesome-codex-plugins / plugins/beastlabai/multi-llm-plugin/skills/multi-llm
multi-llm
FlaggedOrchestrate plan reviews, task generation, implementation and code reviews across several LLM CLIs in parallel, or ask every model one free-text question about a plan. Use when the user says: review my plan, multi-llm, run a code review, generate tasks from a plan, implement this plan, ask the models about my plan.
schemas/status_json.schema.json
View on GitHub{
"$schema": "http://json-schema.org/draft-07/schema#",
"$id": "status_json.schema.json",
"title": "status --json output",
"description": "The one JSON document `multi_llm.py status <plan> --json` prints (utils/run_status.main), before its MULTI_LLM_RESULT line: an error object, the workflow view alone (`--view workflow`, byte-identical to check_workflow_prerequisites.py --status), or the run document (`--view run`, and `--view all` with the workflow view beside the runs). `--abort` and `--sweep` print text, never this document. A consumer takes the text before the last `MULTI_LLM_RESULT:` marker. Strict at the top level of each shape: the output is produced and read by one plugin version, so an unknown key is drift. The `run` and `progress` objects inside each run view are the checkpoint's own (status_file.schema.json) and stay open, since that file outlives its writer. Nothing validates against this schema at run time; tests/test_result_contract.py does.",
"anyOf": [
{
"$ref": "#/definitions/error"
},
{
"$ref": "#/definitions/workflow"
},
{
"$ref": "#/definitions/runs_document"
}
],
"definitions": {
"error": {
"type": "object",
"description": "The plan could not be read (not found, unreadable state.json) or its spelling was refused; the exit code says which.",
"additionalProperties": false,
"required": ["error"],
"properties": {
"error": { "type": "string" }
}
},
"workflow": {
"type": "object",
"description": "The workflow view built from state.json (check_workflow_prerequisites.get_workflow_status).",
"additionalProperties": false,
"required": ["plan", "phases", "suggested_next"],
"properties": {
"plan": { "type": "string" },
"phases": {
"type": "object",
"additionalProperties": {
"type": "object",
"required": ["status"],
"additionalProperties": true,
"properties": {
"status": {
"type": "string",
"description": "completed, skipped, pending or in_progress."
},
"timestamp": { "type": "string" },
"reason": { "type": "string" },
"optional": { "type": "boolean" },
"stale": { "type": "boolean" },
"warning": { "type": "string" }
}
},
"description": "One entry per workflow phase, keyed by phase name. Open: implement's entry carries its task counts and manual-task gate."
},
"suggested_next": { "type": ["string", "null"] },
"hint": { "type": "string" },
"notices": {
"type": "array",
"items": { "type": "string" }
}
}
},
"runs_document": {
"type": "object",
"description": "The run view: one entry per phase dir holding a checkpoint, after selection (--phase, --question, --run-id, --all).",
"additionalProperties": false,
"required": ["runs"],
"properties": {
"workflow": {
"anyOf": [
{
"$ref": "#/definitions/workflow"
},
{ "type": "null" }
],
"description": "--view all only."
},
"runs": {
"type": "array",
"items": {
"$ref": "#/definitions/run_view"
}
},
"implement_tasks": {
"type": "object",
"description": "Implement's task account when the plan has an implement record (run_status's implement view)."
},
"apply_phases": {
"type": "array",
"items": { "type": "object" },
"description": "Each apply phase's batch account, present only when there is one."
},
"implement_tally": {
"type": "object",
"description": "Implement's task tally by bucket."
},
"ignored_dirs": {
"type": "array",
"description": "Non-phase children holding a .status.json, listed only when no --phase pins one dir."
},
"copied_runs": {
"type": "array",
"items": { "type": "object" },
"description": "Dirs whose run id another phase dir already carries ({dir, run_id, copy_of})."
},
"commit_fixes": {
"$ref": "result_line.schema.json#/definitions/commit_fixes"
},
"cascades": {
"type": "array",
"description": "Each composite's unfinished --cascade that no listed composite run view carries as its cascade key (a native-leg cascade, or one an executor run left in the foreground, has no composite run record), read from the pointer and the record (utils/status_views.unfinished_cascades). Present only when there is one; never under --run-id or --question; under --phase only the composite it names.",
"items": {
"type": "object",
"additionalProperties": false,
"required": ["mode", "cascade_id", "state", "stage", "of", "model", "dir"],
"properties": {
"mode": { "enum": ["improve-plan", "improve-code"], "description": "The composite whose cascade it is." },
"cascade_id": { "type": "string" },
"state": { "enum": ["running"] },
"stage": { "type": "integer", "minimum": 1, "description": "The first stage not closed, 1-based." },
"of": { "type": "integer", "minimum": 1, "description": "The number of stages." },
"model": { "type": "string", "description": "That stage's one provider:model spec." },
"dir": { "type": "string", "description": "The cascade's directory (absolute)." }
}
}
}
}
},
"run_view": {
"type": "object",
"description": "One phase dir's run view (utils/detach.classify_run), the checkpoint's keys a poll needs plus the liveness verdict.",
"additionalProperties": false,
"required": ["phase_dir", "run", "run_state", "verdict", "lock_held"],
"properties": {
"phase_dir": { "type": "string" },
"phase": { "type": ["string", "null"] },
"question": { "type": ["string", "null"] },
"state": {
"type": ["string", "null"],
"description": "The checkpoint's phase machine word."
},
"updated_at": { "type": ["string", "null"] },
"output_files": { "type": "object" },
"progress": {
"$ref": "status_file.schema.json#/definitions/progress"
},
"consolidation_recommended": {
"anyOf": [
{
"$ref": "status_file.schema.json#/definitions/consolidation_recommended"
},
{ "type": "null" }
]
},
"validation_context": {
"anyOf": [
{
"$ref": "status_file.schema.json#/definitions/validation_context"
},
{ "type": "null" }
]
},
"validation_counts": {
"anyOf": [
{
"$ref": "status_file.schema.json#/definitions/validation_counts"
},
{ "type": "null" }
]
},
"answer_origins": {
"anyOf": [
{
"$ref": "status_file.schema.json#/definitions/answer_origins"
},
{ "type": "null" }
]
},
"high_priority_groups": {
"anyOf": [
{
"$ref": "status_file.schema.json#/definitions/high_priority_groups"
},
{ "type": "null" }
]
},
"step_results": {
"anyOf": [
{
"$ref": "status_file.schema.json#/definitions/step_results"
},
{ "type": "null" }
]
},
"cascade": {
"type": "object",
"additionalProperties": false,
"required": ["cascade_id", "state", "stage", "of", "model", "dir"],
"description": "A composite run's (improve-plan, improve-code) unfinished --cascade, read from the pointer and the record (utils/status_views.attach_cascades over utils/improve_cascade.cascade_status): the stage under way or the one a continuation goes on at. Absent outside an unfinished cascade, and on every other view.",
"properties": {
"cascade_id": { "type": "string" },
"state": { "enum": ["running"] },
"stage": { "type": "integer", "minimum": 1, "description": "The first stage not closed, 1-based." },
"of": { "type": "integer", "minimum": 1, "description": "The number of stages." },
"model": { "type": "string", "description": "That stage's one provider:model spec." },
"dir": { "type": "string", "description": "The cascade's directory (absolute): record.json, summary.md and the stage dirs." }
}
},
"run": {
"anyOf": [
{
"$ref": "status_file.schema.json#/definitions/run"
},
{
"type": "object",
"maxProperties": 0
}
],
"description": "The checkpoint's run record, or {} on a foreground checkpoint."
},
"run_state": {
"type": ["string", "null"],
"description": "run.state, or null when no run is recorded."
},
"reason_code": {
"type": ["string", "null"],
"description": "A refusal close-out's reason."
},
"reaggregate_command": {
"type": ["string", "null"],
"description": "The continuation, rebuilt at read time from the checkpoint's reaggregate triple."
},
"lock_held": {
"type": "boolean",
"description": "Whether {phase}/.lock is held right now."
},
"verdict": {
"enum": ["no_run", "starting", "running", "stale", "done", "failed", "aborted"],
"description": "Liveness: the run's terminal state, `running`/`starting`, `stale` while the probe is inconclusive, or `no_run`."
},
"reason": {
"type": "string",
"description": "Why the verdict is what it is, when it needs a reason."
},
"heartbeat_age_s": { "type": ["number", "null"] },
"identity": {
"enum": ["alive", "dead", "unknown"],
"description": "The pid + start-time probe."
},
"finished_during_wait": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"spec": { "type": "string" },
"state": { "type": "string" },
"elapsed_s": { "type": ["number", "null"] },
"error": { "type": ["string", "null"] }
}
},
"description": "--wait only: the slots that turned terminal during this call."
}
}
}
}
}
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirements | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallback | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |