Orchestrator Needs Human
orchestrator_needs_humanGenerates NEEDS_HUMAN.md when self-correction is exhausted, returning its path to stop the loop and let a human unblock the failing stage.
Instructions
Write NEEDS_HUMAN.md when self-correction is exhausted and return its path.
Use when: a stage keeps failing and only the human can unblock it (stop the loop afterwards). Returns: {ok, path}.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"app_dir": "<app_dir>",
"stage": "<stage>",
"reason": "<reason>",
"how_to_resolve": "<how_to_resolve>"
},
"name": "orchestrator_needs_human"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| stage | Yes | Pipeline stage id, e.g. 'aso', 'screenshots', 'features' (see pipeline_status for the list). | |
| reason | Yes | Why self-correction is exhausted (what failed). | |
| app_dir | Yes | Absolute path to the app project directory (contains app.spec.json), e.g. /Users/me/Apps/MyApp. | |
| how_to_resolve | Yes | What the human needs to do to unblock the stage. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||