coldstart
A cheap-tier LLM plays a fresh agent and lists every human-only question a ticket leaves unanswered before the build queue.
coldstart
ADLC phase: P2 Decompose · Gate: every ticket is self-contained: no human-only questions remain before it enters the build queue.
What it defends against
A build agent that starts on an under-specified ticket loses the plot fast: it guesses at missing shapes, invents contracts, and drifts. coldstart runs the check up front. A cheap-tier model plays a fresh agent with no prior context and lists every question it would have to ask a human before it could start. Information derivable from the repo does not count; only genuine gaps (undefined schemas, absent contracts, unverifiable criteria, vague scope) block the gate.
Usage
adlc coldstart <ticket-id> [options]
adlc coldstart --all [options]| Flag | Description |
|---|---|
--tickets <path> | Path to the tickets file (default .adlc/tickets.json). |
--all | Run the gate on every ticket in the file. |
--tier cheap|mid|frontier | Model tier (default cheap). |
--json | Machine-readable JSON output for orchestrators. |
--prompt-only | Print the exact prompt(s) and exit 0 without making an LLM call. |
--record-verdict <file|-> | With --prompt-only: record the operator's answer into .adlc/manifest.jsonl via gate-manifest. Requires --prompt-only. |
Exit codes
Example
$ adlc coldstart T2
✗ T2 — 1 gap
- UserSchema: shape referenced in body but not defined
exit 2Go deeper
packages/coldstart · Why executable tickets matter as much as specs: Tests Are the Spec.