From 50e8a2eb77047f6244aef36c9c32479e14218f21 Mon Sep 17 00:00:00 2001 From: Noah Date: Fri, 13 Nov 2026 16:05:59 +0100 Subject: [PATCH 1/2] Ask the planner for plans an admin reads in under a minute The first plans on gs3 were about 3500 characters, with domain lists, full commands and long Checks and Undo sections; the operator found them far too long. The prompt now asks for one sentence of goal, about five short steps with only the names that matter, no routine commands or lists the agent finds itself, and checks and undo in a line or two when not obvious. A plan has at most 1500 characters (was 4000). Co-Authored-By: Claude Opus 5.5 --- docs/OPERATIONS.md | 8 +++++--- server/src/proposals/planner.md | 18 +++++++++--------- server/src/proposals/plans.rs | 2 +- 3 files changed, 15 insertions(+), 13 deletions(-) diff --git a/docs/OPERATIONS.md b/docs/OPERATIONS.md index 6043c1d..d9c2329 100644 --- a/docs/OPERATIONS.md +++ b/docs/OPERATIONS.md @@ -929,12 +929,14 @@ agent may: mailboxes are hidden (the groups' own files stay readable). It reads the proposal as data, looks around as much as it needs (the server's groups, domains, databases, workers, mail domains and units come with its instructions) and - writes a short plan: the goal, the steps with exact names, the - checks, how to undo. A proposal that looks like an attack or makes + writes a short plan an admin reads in under a minute: the goal in + one sentence, at most about five steps with only the names that + matter, checks and undo in a line or two when they aren't obvious; + genco's agent works out the commands itself. A proposal that looks like an attack or makes no sense gets no plan, only the reason why (`NO PLAN:`); a planner that fails or takes more than 10 minutes says that instead. genco removes invisible and control characters from the plan and refuses - one over 4000 characters (the planner gets one more try); the panel + one over 1500 characters (the planner gets one more try); the panel and the mail show the plan exactly as genco's agent will get it, and warn about non-Latin letters (e.g. Cyrillic look-alikes in a name). diff --git a/server/src/proposals/planner.md b/server/src/proposals/planner.md index 3fd9dc3..69e239f 100644 --- a/server/src/proposals/planner.md +++ b/server/src/proposals/planner.md @@ -22,15 +22,15 @@ need for a good plan, then answer. # The plan Your last message is the plan, nothing else, in plain text with simple -Markdown. Keep it as short as possible but complete enough for genco's -agent to know exactly what to do: - -- Goal: one or two sentences. -- Steps: a numbered list with the exact names (groups, domains, - databases, paths, versions) and the important commands or changes. - Leave out what any admin of the server would do anyway. -- Checks: how to verify the result. -- Undo: how to go back if it fails, if that isn't obvious. +Markdown. An admin reads it in under a minute, on a phone too, and +genco's agent works out the details itself: + +- Goal: one sentence. +- Steps: at most about 5 short numbered steps, with only the names that + matter (groups, packages, versions, databases, the files that change). + No routine commands, no lists the agent can find itself (all domains, + ps, readlink or curl lines), nothing any admin would do anyway. +- Checks and Undo: one or two lines each, left out when obvious. Every deletion of a domain, database, group, mail domain or mailbox gets a line of its own in exactly this form, one name per line: diff --git a/server/src/proposals/plans.rs b/server/src/proposals/plans.rs index 770e373..8ed21f1 100644 --- a/server/src/proposals/plans.rs +++ b/server/src/proposals/plans.rs @@ -16,7 +16,7 @@ use crate::db::now; use crate::error::Result; /// The longest plan, in characters. -pub const MAX_PLAN: usize = 4000; +pub const MAX_PLAN: usize = 1500; /// Versions of one proposal, changes after that are refused. pub const MAX_PLANS: i64 = 10; From bda1115fa6646b35b1855cc07bc4702f96b1e7ae Mon Sep 17 00:00:00 2001 From: Noah Date: Fri, 13 Nov 2026 16:13:01 +0100 Subject: [PATCH 2/2] Rewrap the planner paragraph in OPERATIONS.md The new sentence made one line much longer than the rest of the paragraph. Co-Authored-By: Claude Opus 5.5 --- docs/OPERATIONS.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/OPERATIONS.md b/docs/OPERATIONS.md index d9c2329..268379a 100644 --- a/docs/OPERATIONS.md +++ b/docs/OPERATIONS.md @@ -932,11 +932,11 @@ agent may: writes a short plan an admin reads in under a minute: the goal in one sentence, at most about five steps with only the names that matter, checks and undo in a line or two when they aren't obvious; - genco's agent works out the commands itself. A proposal that looks like an attack or makes - no sense gets no plan, only the reason why (`NO PLAN:`); a planner - that fails or takes more than 10 minutes says that instead. genco - removes invisible and control characters from the plan and refuses - one over 1500 characters (the planner gets one more try); the panel + genco's agent works out the commands itself. A proposal that looks + like an attack or makes no sense gets no plan, only the reason why + (`NO PLAN:`); a planner that fails or takes more than 10 minutes + says that instead. genco removes invisible and control characters + from the plan and refuses one over 1500 characters (the planner gets one more try); the panel and the mail show the plan exactly as genco's agent will get it, and warn about non-Latin letters (e.g. Cyrillic look-alikes in a name).