diff --git a/website/docs/user-guide/configuration.md b/website/docs/user-guide/configuration.md index 8cec37ccc8..d2383a6b14 100644 --- a/website/docs/user-guide/configuration.md +++ b/website/docs/user-guide/configuration.md @@ -784,6 +784,7 @@ $ hermes model [ ] title_generation currently: openrouter / google/gemini-3-flash-preview [ ] compression currently: auto / main model [ ] approval currently: auto / main model +[ ] triage_specifier currently: auto / main model ``` Select a task, pick a provider (OAuth flows open a browser; API-key providers prompt), pick a model. The change persists to `auxiliary..*` in `config.yaml`. Same machinery as the main-model picker — no extra syntax to learn. @@ -880,6 +881,18 @@ auxiliary: base_url: "" api_key: "" timeout: 30 + + # Kanban triage specifier — `hermes kanban specify ` (or the + # dashboard's ✨ Specify button on Triage-column cards) uses this + # slot to expand a one-liner into a concrete spec and promote the + # task to `todo`. Cheap fast models work well here; spec expansion + # is short and doesn't need reasoning depth. + triage_specifier: + provider: "auto" + model: "" + base_url: "" + api_key: "" + timeout: 120 ``` :::tip diff --git a/website/docs/user-guide/features/fallback-providers.md b/website/docs/user-guide/features/fallback-providers.md index df52eb1a66..7b7735a4ce 100644 --- a/website/docs/user-guide/features/fallback-providers.md +++ b/website/docs/user-guide/features/fallback-providers.md @@ -192,6 +192,7 @@ Hermes uses separate lightweight models for side tasks. Each task has its own pr | MCP | MCP helper operations | `auxiliary.mcp` | | Approval | Smart command-approval classification | `auxiliary.approval` | | Title Generation | Session title summaries | `auxiliary.title_generation` | +| Triage Specifier | `hermes kanban specify` / dashboard ✨ button — fleshes out a one-liner triage task into a real spec | `auxiliary.triage_specifier` | ### Auto-Detection Chain @@ -384,5 +385,6 @@ See [Scheduled Tasks (Cron)](/docs/user-guide/features/cron) for full configurat | MCP helpers | Auto-detection chain | `auxiliary.mcp` | | Approval classification | Auto-detection chain | `auxiliary.approval` | | Title generation | Auto-detection chain | `auxiliary.title_generation` | +| Triage specifier | Auto-detection chain | `auxiliary.triage_specifier` | | Delegation | Provider override only (no automatic fallback) | `delegation.provider` / `delegation.model` | | Cron jobs | Per-job provider override only (no automatic fallback) | Per-job `provider` / `model` | diff --git a/website/docs/user-guide/features/kanban-tutorial.md b/website/docs/user-guide/features/kanban-tutorial.md index f8d9501cb2..8d422fadf1 100644 --- a/website/docs/user-guide/features/kanban-tutorial.md +++ b/website/docs/user-guide/features/kanban-tutorial.md @@ -22,7 +22,7 @@ Throughout the tutorial, **code blocks labelled `bash` are commands *you* run.** Six columns, left to right: -- **Triage** — raw ideas, a specifier will flesh out the spec before anyone works on them. +- **Triage** — raw ideas, a specifier will flesh out the spec before anyone works on them. Click the **✨ Specify** button on any triage card (or run `hermes kanban specify ` / `/kanban specify ` from a chat) to have the auxiliary LLM turn a one-liner into a full spec (goal, approach, acceptance criteria) and promote it to `todo` in one shot. Configure which model runs it under `auxiliary.triage_specifier` in `config.yaml`. - **Todo** — created but waiting on dependencies, or not yet assigned. - **Ready** — assigned and waiting for the dispatcher to claim. - **In progress** — a worker is actively running the task. With "Lanes by profile" on (the default), this column sub-groups by assignee so you can see at a glance what each worker is doing.