/stage-launch

name: stage-launch
description: Phase 2 of building a Claude Managed Agent — turn a validated build sheet into exact API payloads and a resumable BYOK curl launch script, then launch (environment → agent → session → kickoff) using the founder's OWN Anthropic key. Use when the user says "launch it", "deploy the agent", "create the agent now", or when the orchestrator routes phase=stage-launch. payload_generator.py emits the four ordered payloads; launch_script_writer.py writes launch.sh that reads $ANTHROPIC_API_KEY at runtime and never embeds it; payload_validator.py runs a pre-launch check including an API-key-leak scan. No tool in this skill makes network calls — the user runs launch.sh themselves. Distinct from interview (planning) and grade-iterate (the outcome loop).
version: 2.11.2
author: Alireza Rezvani
license: MIT
tags: [cma, launch, payloads, curl, byok, api-key-safety, environment, agent, session]
compatible_tools: [claude-code, codex-cli, cursor, antigravity, opencode, gemini-cli]

Phase 2 — Stage → Launch

Turn the build sheet into runnable artifacts, then let the founder launch with their own key. **No script here touches the network or the key** — the user runs `launch.sh`.

Workflow

1. **Generate payloads.**

   python3 scripts/payload_generator.py \
     --sheet ./my-agent/build-sheet.json --out-dir ./my-agent
   # -> ./my-agent/payloads/{01-environment,02-agent,03-session,04-kickoff}.json

Agent toolset → `always_allow`; every MCP toolset → `always_ask` (baked into the agent payload's `permission_policies`). 2. **Write the launch script.**

   python3 scripts/launch_script_writer.py --out-dir ./my-agent

`launch.sh` creates environment → agent → session → kickoff **in order**, chaining IDs, and **resumes** on re-run (each step skips if its `*.id` file exists). It reads `$ANTHROPIC_API_KEY` at runtime. 3. **Validate before launch.**

   python3 scripts/payload_validator.py --dir ./my-agent

FAIL blocks — especially a `key_leak` finding. Fix and re-run. 4. **Minimal key step (never in chat).** Check the shell first:

   [ -n "$ANTHROPIC_API_KEY" ] && echo "key present" || echo "export ANTHROPIC_API_KEY=... first"

Point the founder to platform.claude.com → API keys. **Never print the key to chat, never write it to a file.** 5. **Launch + watch the first poll.**

   export ANTHROPIC_API_KEY=...      # in their shell, not in chat
   ./my-agent/launch.sh

Mark checkpoints with Console deep links. Then `goal_state.py set --phase grade-iterate` and advance.

Hard rules (API-key safety)

• **The key never enters chat, a file, a payload, or a log.** `launch.sh` reads it

from the environment; `payload_validator.py` scans for `sk-ant-…` leaks and FAILs.

• **Sequential launch.** environment → agent → session → kickoff. Watch the first

poll foreground before declaring success.

• **Resumable.** Re-running `launch.sh` continues from the last created ID.

Forcing-question library (recommend + cite)

1. "Is the key in your shell env already?" *Recommend:* check `$ANTHROPIC_API_KEY` before anything. *Cite:* this SKILL, key-safety rules. 2. "Cloud or self-hosted environment?" *Recommend:* cloud for v0. *Cite:* cma-primitives.md (environment). 3. "Any MCP server in the payload?" *Recommend:* keep it `always_ask`. *Cite:* cma-primitives.md (permissions). 4. "Did the first poll return idle/running cleanly?" *Recommend:* watch it foreground before moving on. *Cite:* cma-primitives.md (session lifecycle).

Tools

• `scripts/payload_generator.py` — build sheet → 4 ordered API payloads.
• `scripts/launch_script_writer.py` — resumable BYOK curl launcher (no key handling).
• `scripts/payload_validator.py` — pre-launch check + API-key-leak scan.