Kickoff
Turn intent into an accepted build contract before execution. Do not replace repository evidence with interview questions, and do not force ceremony onto trivial, fully specified changes.
Gate
Kickoff is required before non-trivial implementation or agent dispatch when any applies:
- product behavior, failure semantics, boundaries, or acceptance remain implicit;
- more than one materially different path is plausible;
- feasibility depends on unknown code, runtime, library, API, cost, or permission facts;
- work spans modules, agents, phases, or durable checkpoints;
- changing direction after implementation would be costly.
Skip only for trivial, reversible, fully specified work with one evident path and direct verification. Record why the gate was skipped when an orchestration skill consumes the task.
Workflow
Read workflow and contract schema.
- Derive repository/runtime facts first. Ask only for material product or risk decisions tools cannot resolve.
- Freeze goal: problem, outcome, non-goals, invariants, user journeys, and observable acceptance.
- Freeze path: constraints, candidate routes, probes, selected route, rejected routes, decisions, consequences, and revalidation triggers.
- Freeze execution: accepted base, dependency nodes, exclusive scope, required evidence, minimal E2E smoke, and change-control triggers.
- Build traceability from every required goal/invariant to decision, execution node, and evidence producer. Reject or remove orphan nodes.
- Persist exact contract bytes in an owner-controlled artifact. Set
status: accepted only after the user or authorized owner accepts every material decision; clear, already-authorized intent with no material unresolved choice may be owner-accepted without another prompt.
- Pin
contract_id, version, and SHA-256 digest at dispatch. Workers receive read-only projections and cannot amend or accept the contract.
Unresolved material decisions mean needs-decision, never accepted. Execution discoveries that invalidate goal, path, scope, or acceptance stop affected nodes, create impact analysis, increment the version, and require renewed acceptance. Evidence may satisfy a contract; it cannot silently rewrite one.
1---2name: kickoff3description: Freeze goal, path, execution, and acceptance before non-trivial implementation or agent dispatch. Use when requirements hide assumptions, multiple implementation paths exist, feasibility needs research/prototyping, work spans modules or agents, or the user asks to align requirements before building. Produces an accepted, versioned Kickoff Contract.4---56# Kickoff78Turn intent into an accepted build contract before execution. Do not replace repository evidence with interview questions, and do not force ceremony onto trivial, fully specified changes.910## Gate1112Kickoff is required before non-trivial implementation or agent dispatch when any applies:1314- product behavior, failure semantics, boundaries, or acceptance remain implicit;15- more than one materially different path is plausible;16- feasibility depends on unknown code, runtime, library, API, cost, or permission facts;17- work spans modules, agents, phases, or durable checkpoints;18- changing direction after implementation would be costly.1920Skip only for trivial, reversible, fully specified work with one evident path and direct verification. Record why the gate was skipped when an orchestration skill consumes the task.2122## Workflow2324Read [workflow](references/workflow.md) and [contract schema](references/contract-schema.md).25261. Derive repository/runtime facts first. Ask only for material product or risk decisions tools cannot resolve.272. Freeze **goal**: problem, outcome, non-goals, invariants, user journeys, and observable acceptance.283. Freeze **path**: constraints, candidate routes, probes, selected route, rejected routes, decisions, consequences, and revalidation triggers.294. Freeze **execution**: accepted base, dependency nodes, exclusive scope, required evidence, minimal E2E smoke, and change-control triggers.305. Build traceability from every required goal/invariant to decision, execution node, and evidence producer. Reject or remove orphan nodes.316. Persist exact contract bytes in an owner-controlled artifact. Set `status: accepted` only after the user or authorized owner accepts every material decision; clear, already-authorized intent with no material unresolved choice may be owner-accepted without another prompt.327. Pin `contract_id`, `version`, and SHA-256 digest at dispatch. Workers receive read-only projections and cannot amend or accept the contract.3334Unresolved material decisions mean `needs-decision`, never `accepted`. Execution discoveries that invalidate goal, path, scope, or acceptance stop affected nodes, create impact analysis, increment the version, and require renewed acceptance. Evidence may satisfy a contract; it cannot silently rewrite one.
luw2007