claude-skills/agent-launcher/assets/build-sheet.schema.json
Claude d1f2396c6f
feat(agent-launcher): new domain plugin for building Claude Managed Agents
Adds the agent-launcher/ top-level domain — a plugin re-implementation of
Anthropic's launch-your-agent reference skill (Apache-2.0; independent, not a
fork) for building Claude Managed Agents (CMA) in the user's own account.

Every session starts with a goal (./my-agent/goal.json, surfaced by an opt-in
AGENT_LAUNCHER_SESSION=1 SessionStart hook + /cs:goal); loop_compiler.py
compiles that goal into a bounded grade->iterate loop (CMA user.define_outcome
self-grading, max_iterations 1..20), a recurring POSIX-cron scheduled-deployment
loop, or a single-pass interview->stage->launch workflow.

- 6 skills: agent-launcher-orchestrator (context: fork goal router) + interview
  + stage-launch + grade-iterate + run-without-you + wrap-up
- 18 stdlib-only deterministic scaffolder tools (NO network/API calls; live
  launches emitted as BYOK curl that never prints the key); all pass --help/--sample
- 4 agents (orchestrator + interviewer + grader + deployer), 8 /cs:* commands
- opt-in SessionStart/SessionEnd hooks (exit 0 on any error), 5 shared
  references, 4 assets (build-sheet schema + overview/next-directions templates
  + example)
- validators enforce CMA limits (<=20 skills/session, <=8 memory stores,
  depth-1 multiagent, max_iterations <=20, <=1000 deployments/org)
- registered in marketplace.json; headline counters trued up via
  derive_counters.py --check (skills 362->368, domains 18->19, tools 644->664,
  refs 741->746, agents 102->106, commands 116->124, plugins 88->89)

Distinct from engineering/agent-harness (generic bounded loop over any domain)
and engineering/write-a-skill (authors Claude Code skills, not CMAs).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012FwXG6TqCXKZQvF4iD69cv
2026-08-17 02:39:34 +00:00

91 lines
3.3 KiB
JSON

{
"$schema": "http://json-schema.org/draft-07/schema#",
"$id": "https://github.com/alirezarezvani/claude-skills/agent-launcher/build-sheet.schema.json",
"title": "agent-launcher build sheet",
"description": "The Phase-1 plan for a Claude Managed Agent. Produced by build_sheet_builder.py, validated by primitives_validator.py, consumed by payload_generator.py.",
"type": "object",
"required": ["agent_name", "goal", "primitives"],
"additionalProperties": false,
"properties": {
"agent_name": {"type": "string", "minLength": 1, "maxLength": 128},
"goal": {"type": "string", "minLength": 1, "description": "One-sentence job the agent does end-to-end."},
"primitives": {
"type": "object",
"required": ["agent", "environment"],
"additionalProperties": false,
"properties": {
"agent": {
"type": "object",
"required": ["model"],
"properties": {
"model": {"type": "string"},
"system": {"type": "string"},
"tools": {"type": "array", "items": {"type": "object"}},
"mcp_servers": {"type": "array", "items": {"type": "object"}},
"skills": {"type": "array", "items": {"type": "string"}, "maxItems": 20},
"multiagent": {"type": "object"}
}
},
"environment": {
"type": "object",
"required": ["type"],
"properties": {
"type": {"enum": ["cloud", "self_hosted"]},
"networking": {"enum": ["unrestricted", "limited"]},
"allowed_hosts": {"type": "array", "items": {"type": "string"}},
"packages": {"type": "object"}
}
},
"session": {
"type": "object",
"properties": {
"resources": {"type": "array", "items": {"type": "object"}},
"vault_ids": {"type": "array", "items": {"type": "string"}},
"memory_stores": {"type": "array", "maxItems": 8, "items": {"type": "object"}}
}
},
"outcome": {
"type": "object",
"properties": {
"description": {"type": "string"},
"rubric": {"type": "string", "description": "Required markdown criteria for the grader."},
"max_iterations": {"type": "integer", "minimum": 1, "maximum": 20}
}
},
"deployment": {
"type": "object",
"properties": {
"schedule": {
"type": "object",
"required": ["expression", "timezone"],
"properties": {
"expression": {"type": "string", "description": "5-field POSIX cron."},
"timezone": {"type": "string", "description": "IANA identifier."}
}
}
}
}
}
},
"deferrals": {
"type": "array",
"items": {
"type": "object",
"required": ["version", "item", "reason", "mechanism"],
"properties": {
"version": {"type": "string", "pattern": "^v[1-9][0-9]*$"},
"item": {"type": "string"},
"reason": {"type": "string"},
"mechanism": {"type": "string"}
}
}
},
"eval_plan": {
"type": "object",
"properties": {
"success_criteria": {"type": "array", "items": {"type": "string"}},
"held_back_cases": {"type": "array", "items": {"type": "object"}}
}
}
}
}