Commands
Use Deliberate through the /deliberate skill in a capable agent harness.
In the command forms below, <angle brackets> mark required input and [square brackets] mark optional input. For example, a case requires an idea, while a brief or readout can omit its period and use the default window.
| Command | Purpose |
|---|---|
/deliberate address/deliberate:deliberate address$deliberate addressdeliberate address/deliberate addressdeliberate address@deliberate address | Work through in-record review comments, update the artifact where warranted, and optionally resolve them. |
/deliberate brief [period]/deliberate:deliberate brief [period]$deliberate brief [period]deliberate brief [period]/deliberate brief [period]deliberate brief [period]@deliberate brief [period] | Produce a grounded landscape brief for the 90-day first-run default, the since-last-brief cadence, or a natural-language period override. |
/deliberate brief list/deliberate:deliberate brief list$deliberate brief listdeliberate brief list/deliberate brief listdeliberate brief list@deliberate brief list | List the project’s briefs, newest first. |
/deliberate case <idea>/deliberate:deliberate case <idea>$deliberate case <idea>deliberate case <idea>/deliberate case <idea>deliberate case <idea>@deliberate case <idea> | Analyze any consequential idea or signal; the host chooses the relevant methods and produces a recommendation, score, and one-pager. |
/deliberate case <id> prototype/deliberate:deliberate case <id> prototype$deliberate case <id> prototypedeliberate case <id> prototype/deliberate case <id> prototypedeliberate case <id> prototype@deliberate case <id> prototype | Generate a testable artifact for a completed product or market case. |
/deliberate case <id> score/deliberate:deliberate case <id> score$deliberate case <id> scoredeliberate case <id> score/deliberate case <id> scoredeliberate case <id> score@deliberate case <id> score | Re-score a completed recommendation against lens-specific criteria with evaluator provenance. |
/deliberate case list/deliberate:deliberate case list$deliberate case listdeliberate case list/deliberate case listdeliberate case list@deliberate case list | List all cases and their lens-specific scores. |
/deliberate feedback/deliberate:deliberate feedback$deliberate feedbackdeliberate feedback/deliberate feedbackdeliberate feedback@deliberate feedback | Send a bug, idea, or praise to the makers with scrubbed diagnostics and no project files. |
/deliberate help/deliberate:deliberate help$deliberate helpdeliberate help/deliberate helpdeliberate help@deliberate help | Render the current public command registry. |
/deliberate init/deliberate:deliberate init$deliberate initdeliberate init/deliberate initdeliberate init@deliberate init | Create the files-first project context, or refresh existing context through the latest installed Deliberate method while preserving supported user edits. |
/deliberate matchup <competitor>/deliberate:deliberate matchup <competitor>$deliberate matchup <competitor>deliberate matchup <competitor>/deliberate matchup <competitor>deliberate matchup <competitor>@deliberate matchup <competitor> | Produce a competitive teardown. |
/deliberate matchup list/deliberate:deliberate matchup list$deliberate matchup listdeliberate matchup list/deliberate matchup listdeliberate matchup list@deliberate matchup list | List the project’s competitive matchups. |
/deliberate readout [period]/deliberate:deliberate readout [period]$deliberate readout [period]deliberate readout [period]/deliberate readout [period]deliberate readout [period]@deliberate readout [period] | Produce a readout for one completed reporting period. |
/deliberate readout list/deliberate:deliberate readout list$deliberate readout listdeliberate readout list/deliberate readout listdeliberate readout list@deliberate readout list | List the project’s readouts, newest first. |
/deliberate source add <location> ["<description>"] [--section <section>] | remove <location>/deliberate:deliberate source add <location> ["<description>"] [--section <section>] | remove <location>$deliberate source add <location> ["<description>"] [--section <section>] | remove <location>deliberate source add <location> ["<description>"] [--section <section>] | remove <location>/deliberate source add <location> ["<description>"] [--section <section>] | remove <location>deliberate source add <location> ["<description>"] [--section <section>] | remove <location>@deliberate source add <location> ["<description>"] [--section <section>] | remove <location> | Add or remove a categorized, durable source outside the current project folder; internal systems and public resources are both supported. |
/deliberate source list/deliberate:deliberate source list$deliberate source listdeliberate source list/deliberate source listdeliberate source list@deliberate source list | List the project’s durable context sources from outside the current folder. |
Run /deliberate help/deliberate:deliberate help$deliberate helpdeliberate help/deliberate helpdeliberate help@deliberate help for the live grammar installed with your version. Subcommands and argument details are rendered from that registry rather than duplicated in the harness.
Files inside the current project are automatic grounding, so source add rejects them rather than duplicating them in .sonorance/sources.md. Source curation favors systems and corpora with recurring signal, plus maintained canonical documents—not isolated feedback, individual cases/interviews, or point-in-time exports.
Rerunning /deliberate init/deliberate:deliberate init$deliberate initdeliberate init/deliberate initdeliberate init@deliberate init is the all-up context update path. It rereads current project files and configured sources, applies the latest context contracts, and refreshes product.md, competitors.md, and ecosystem.md together. Existing source entries remain hand-editable in .sonorance/sources.md.
Case behavior
Section titled “Case behavior”Use /deliberate case <idea>/deliberate:deliberate case <idea>$deliberate case <idea>deliberate case <idea>/deliberate case <idea>deliberate case <idea>@deliberate case <idea> for any consequential idea or signal: product & experience, market & commercial, strategy & portfolio, or platform & ecosystem. The agent host chooses one durable primary lens and asks only when the decision is genuinely ambiguous.
Every case uses frame → shape → launch with methods suited to its lens. Prototypes are available for product and market cases; no prototype is forced for strategy or platform cases. Scores preserve evaluator provenance and are not directly rankable across different lenses.
Case creation returns an id. Every later case operation requires that full id or a unique prefix, so several cases can progress concurrently without a singleton active-case setting.
Brief and readout follow-through is classified as a product case, market case, strategy case, platform case, or direct action. Routine operations, instrumentation, already-decided work, and bounded research remain direct actions rather than cases.