mycoauthor-and-debug-agent-pipeline-taskslisted

# Authoring and Debugging Myco Agent Pipeline Tasks ## Task YAML Anatomy Every task lives in `src/agent/tasks/<name>.yaml`. Core fields: ```yaml name: my-task description: "What this task does" enabled: true # whether the scheduler auto-runs this task maxTurns: 40 # total turn budget across all phases timeoutSeconds: 900 # wall-clock limit for the entire task run schedule: intervalMinutes: 60 # how often the task sweeps runDuringIdle: true # only run when the daemon has no active user session phases: - name: phase-one maxTurns: 20 prompt: | ... - name: phase-two maxTurns: 15 dependsOn: phase-one prompt: | ... ``` **Budget rule:** Task `maxTurns` must equal the **sum of all phase `maxTurns`** plus a small overhead buffer (5 turns). If the task `maxTurns` is lower than the sum, the run will be silently truncated mid-phase. ## Scheduling Design ### Sweep Scheduling `runDuringIdle: true` gates execution to periods when no user session is active. `intervalMinutes` sets the minimum gap between runs. ### Risk-Profile-Based Default Enablement | Operation type | Default | Rationale | |---|---|---| | Read-only discovery | `enabled: true` | No side effects; safe to auto-run passively | | Generative (writes new files) | `enabled: false` | Creates artifacts; user should verify output quality first | | Mutative (modifies existing files) | `enabled: false` | Changes existing state; higher stakes; opt-in until trusted |