foundry-implement-auto

foundry-implement-auto

Purpose

Run exactly one autonomous implementation phase for a spec in unattended mode, then stop deterministically at the phase boundary or any escalation condition.

Reference:

• Runtime contract: src/foundry_mcp/skills/foundry_implement_auto.py
• Supervisor runbook: docs/guides/autonomy-supervisor-runbook.md
• Agent isolation: docs/guides/autonomy-agent-isolation.md

Flow

[x?]=decision (GATE)=server gate →=sequence ↻=loop !=escalation §=section ref

Entry → [spec_id arg present?]
  → [no] → ! SPEC_ID_MISSING → EXIT
  → [yes] → §Preflight (6 checks)
  → [all pass?]
    → [no] → ! FoundryImplementAutoError + remediation → EXIT
    → [yes] → SessionStart
      → [SPEC_SESSION_EXISTS?]
        → [yes] → §SessionReuse → §StaleSessionRecovery (replay probe) → StepLoop
        → [no]  → StepLoop (fresh session, no stale steps possible)
  → StepLoop (max 200 iterations) ↻
    → task(session-step, command="next")
    → [loop_signal?]
      → [phase_complete] → EXIT success
      → [spec_complete] → EXIT success
      → [paused|failed|blocked_runtime] → ! EXIT escalation
      → [continue] → Dispatch(next_step.type)
        → [implement_task] → §ImplementTask
        → [execute_verification] → §ExecuteVerification
        → [run_fidelity_gate] → §RunFidelityGate
        → [address_fidelity_feedback] → §AddressFidelityFeedback
        → [pause|complete_spec] → EXIT
      → Report outcome → ↻ StepLoop
  → [max_iterations exceeded] → ! LOOP_LIMIT_EXCEEDED → EXIT
→ Emit exit packet

MCP Tooling

All interactions use the Foundry MCP router+action pattern: mcp__plugin_foundry_foundry-mcp__<router>.

Router	Key Actions
task	session (start/list), session-step (next/report/replay), prepare
spec	find
server	capabilities
review	fidelity-gate
verification	execute

Non-Negotiable Rules

1. Zero interaction. Never use AskUserQuestion or any interactive prompt. This skill runs fully unattended. If any required input is missing (spec_id, environment), emit a structured error and EXIT immediately — do not ask, guess, or offer choices.
2. Runtime truth only. Use MCP tool responses as the source of truth for feature flags, posture, and role. Never trust discovery metadata or manifest alone.
3. Server-driven sequencing. The session-step orchestrator is the sole authority on task ordering, phase boundaries, and gate timing. Never infer or override task sequence.
4. No privilege escalation. Never set allow_lock_bypass=true, allow_gate_waiver=true, or request elevated role. Always pass enforce_autonomy_write_lock=true on session start.
5. Fail fast on policy violations. Any preflight failure terminates immediately with structured remediation.
6. Deterministic exit. Stop on phase_complete or spec_complete. Escalate on all other terminal loop_signal values. Never continue on ambiguous state.
7. Bounded execution. Hard limit of max_iterations=200. If exceeded without terminal signal, stop and escalate.