SKILL.md
Compound Master
Orchestrate KRT delivery. Do not replace Compound Engineering, duplicate component skills, ship from work phases, open/merge PRs directly, or mutate Jira directly. Hand shipping context to krt-release-marshal.
Arguments:
[initiative/docs] [mode:artifacts|execute|full|resume] [package:<path>] [review-unit:<RU#>]
[pr-granularity:auto|review-unit|work-package|roadmap-item|plan-unit]
[jira-policy:required|optional|skip] [production:unknown|live|preprod|prototype]
[jira-provider:auto|cloud|server-datacenter|none]
[parallel:true|false] [delegation:auto|ask|inline] [worktree-policy:avoid|auto|required]
[autonomy:manual|guarded|high] [autonomous-ledger:<path>] [review-threshold:P0-P2|P0-P1|P0]
[subagent-model:<runtime-specific-model>]
[orchestrator:standalone|seneschal] [run-id:<stable-id>] [state-path:<repo-relative-path>]
[initiative-contract:<repo-relative-path>] [interaction:direct|brokered]
Default: artifact-first after discovery. Execute only when requested or when mode:full reaches its execution gate. Jira is preferred and non-blocking unless jira-policy:required.
Progressive Loading
Load only the current phase. Phase-specific rules live in the owning reference.
| Phase | Load |
|---|---|
| All phases, before workflow actions | references/safety.md |
| Seneschal-nested run, state isolation, inherited context, brokered decisions | references/nested-orchestration.md |
| Preflight, roles, arguments, paths | references/role-and-runtime.md, references/fast-contract.md |
| Artifact workflow and gates | references/workflow-map.md |
| Work-package templates/review units | references/artifact-templates.md |
| Execution routing | references/execution-flow.md |
| Delegation prompts | references/execution-delegation.md |
| Impact/verification | references/impact-verification.md |
| Review, security, CI | references/review-security-ci.md |
| Release handoff | references/release-handoff.md |
| State/closeout/failures | references/status-and-failures.md |
| Autonomous mutation | references/autonomous-mode.md, references/autonomy-ledger-schema.md, references/autonomous-flow-matrix.md |
Before writing or reviewing a work package:
python3 <compound-master-skill-dir>/scripts/check_work_package.py <work-package.md>
Resolve <compound-master-skill-dir> to the directory containing this SKILL.md; installed runtimes may use /home/teb/.agents/skills/krt-compound-master. Before delegating to Luna, compile the relevant package into references/fast-contract.md's schema. Pass only that compiled contract, repository AGENTS.md, and its explicitly named context; do not make the worker load the Compound Master reference tree.
Core Pipeline
- Preflight roles, repo, branch, Jira, production, delegation, context, parent orchestrator, run ID, interaction mode, and canonical state path.
- Generate exactly one roadmap/readiness report for standalone work; in a Seneschal child, validate and reuse the assigned reviewed roadmap/item instead of generating another program roadmap. Stop if context is insufficient.
- Review the roadmap, run one focused brainstorm per roadmap item that lacks reviewed planning input, review it, plan it, and review the plan. In nested mode, inherit the initiative contract and never rerun the general initiative brainstorm.
- Derive and review work packages, then pass the Reviewability Gate: choose review-unit/PR boundaries for human reviewability and independent mergeability, not atomicity or Jira-fit, and cap open stacked PRs at 2-3.
- Execute each ready review unit with the resolved work role in implementation-only/no-shipping mode.
- Run Impact Scan, verification, code review, Security Watch/Sentinel as required, and CI break-prevention evidence.
- For standalone work, hand finished review units to
krt-release-marshal; it owns commits, rebase, Jira, PRs, reviewers, transitions, and ledger-bound autonomous merge execution. In a Seneschal child, return a release-ready packet to the parent for wave reconciliation and let Seneschal invoke Release Marshal.
Universal Rules
- Resolve roles by canonical skill/command/agent. Never guess short names.
- Use document-review roles for documents and code-review roles for diffs.
- No implementation before a written and reviewed plan; no roadmap continuation when context is insufficient; no skipped brainstorm unless explicit and recorded.
- Do not invent product behavior, auth/data contracts, Jira transitions, release constraints, branch bases, dependency edges, or production posture. Use
production:unknownunless evidence says otherwise;production:liveis compatibility-preserving. - Escalate product behavior, auth/data contracts, destructive operations, public contract removal, branch/base strategy, required Jira/PR workflow decisions, and production compatibility breakage.
- Keep state and active artifacts current in the same phase transition that changes their truth; reconcile state before delegation, resume, review handoff, release handoff, or stop.
- In
orchestrator:seneschal, use the supplied per-run state path, keep interaction brokered, and return structured decision requests to the parent instead of asking the user directly. - Resolve brainstorm and planning inputs by artifact contract/readiness rather than requiring
docs/brainstorms/**; accept legacy paths and currentce-unified-plan/v1artifacts under the configured docs root. - Optimize review-unit/PR boundaries for human reviewability and independent mergeability, not atomicity or Jira-fit. Keep at most 2-3 open unmerged PRs in one stacked chain; at the cap, wait for the parent to merge into the integration base or collapse the pending chain onto it, and never resolve an over-deep stack by abandoning it for one mega-consolidation PR. When a later review unit fixes a surface an earlier still-open PR's reviewer flagged, record and surface a downstream-fix note so the prior review is not lost. Jira stays at review-unit granularity: a grouped PR covering several review units backlinks one subtask per review unit under a shared parent, never a single collapsed task.
- Do not produce artifacts or PRs faster than their verifying gate can close them. Every brainstorm, plan, work package, and PR must pass its review/verification gate before the next one is built on top of it; this generalizes the open-stack cap to all phases, not just stacked PRs.
- Do not let work roles ship. Internal review, Security Sentinel, CI evidence, and release-plan acceptance are readiness signals only, not merge authorization.
autonomy:highwithout an active ledger is local autonomy only; it never authorizes PR, branch, reviewer, Jira, or merge side effects.- Trust bundled checkers over assumptions. Resolve Jira provider from explicit input, Jira URL, or unique readiness through
krt-release-marshal; never default silently to Cloud or Server/Data Center. If a checker reports a result, act on it and diagnose the real failure; never ask for Jira credentials. - With default optional Jira, attempt Jira when context/config exists; otherwise record the omitted handoff. Ask only for required Jira, ambiguous Jira mutation, or release-plan approval naming the action/fallback.
Stop Discipline
In a Seneschal child, stop at a structured release-ready return so the parent can reconcile the wave before invoking Release Marshal. This is the explicit exception to the standalone no-pause handoff rule below.
Close out with current phase/status, written paths, ready work, blockers or "No blockers", recommended next action, and exact next invocation. For stacked/sibling PR handoff, include per-PR scope/base context so Release Marshal can emit stable PR1/PR2 blocks. If artifact generation stopped before implementation, do not imply a planning/docs branch should ship independently. Do not stop between a passing work/review loop and krt-release-marshal; that approval pause belongs inside Release Marshal.
Workflow Map
Artifact generation: load references/workflow-map.md. Execution: load references/execution-flow.md, then only the phase file it points to. State/failures: load references/status-and-failures.md.