megacode-profile-author

name	megacode-profile-author
description	Author or update `.megacode/profiles/*.json` agent profiles and generate a matching `.codex/agents/<name>.toml` sketch. Use when defining new MegaCode roles.
disable-model-invocation	true

MegaCode Profile Author

Create role definitions that compile to Codex worker configuration.

Inputs

• Role name (lowercase, [a-z][a-z0-9_-]*).
• Purpose, instructions, context policy, output contract.
• Model policy (default model, reasoning effort, allow list, cost class).
• Skills allow/deny lists, MCP servers, tool allowlist.
• Worktree and GitHub scope policies.

Outputs

1. .megacode/profiles/<name>.json validated against schemas/profile.schema.json.
2. .codex/agents/<name>.toml sketch (commented placeholders until profile compiler exists).

JSON profile checklist

Required fields: name, description, instructions, model_policy.default_model.

Recommended fields:

Field	Guidance
context_policy	isolated for workers; artifact_only for reviewers
output_contract	Named contract id (implementation_result, review_findings, etc.)
skills_allow	Product skills only (megacode-implementation, megacode-testing, …)
mcp_servers	From .megacode/mcp/profile-mcp-matrix.yaml — no Linear
worktree_policy	required for implementer; forbidden for read-only roles
github_scope	read, branch_write, or none per role
quality_gates	e.g. tests-run, diff-summary

TOML sketch template

# Generated sketch — finalize when profile compiler lands
# Source: .megacode/profiles/<name>.json

name = "<name>"
model = "<default_model>"
# reasoning_effort = "medium"

[instructions]
# Paste instructions from JSON (escape multiline as needed)

# [[skills]]
# name = "megacode-implementation"

# [mcp]
# servers = ["filesystem-worktree"]

Validation (fail-closed)

• Name matches schema pattern ^[a-z][a-z0-9_-]*$.
• reasoning_effort and cost_class enums are valid.
• MCP servers appear in the profile MCP matrix for that role.
• No Agents SDK runner references; app-server / exec-json only.
• Do not grant global MCP access — smallest surface per role.

Reference profiles

Study docs/codex_megacode_planning_pack/codex_megacode_planning_pack/examples/profiles/ for explorer, implementer, and reviewer patterns.