@clossys/launcher 0.1.5 → 0.3.1

package/dist/skills.js

@@ -1,6 +1,9 @@
 import { dirname, join, resolve, sep } from "node:path";
-const DISCOVERY_PREFIXES = [".cursor/skills", ".claude/skills"];
+import { extractContractBlock, injectContract } from "./contract.js";
+import { parseSkillManifest, readInstalledVersion, serializeSkillManifest, sha256Hex } from "./manifest.js";
+export const DISCOVERY_PREFIXES = [".cursor/skills", ".claude/skills"];
 const AGENTS_SKILLS_REL = join(".agents", "skills");
+export const SKILLS_MANIFEST_REL = join("clossys", ".state", "skills.json");
 function containedPath(root, relativePath) {
     const resolved = resolve(root, relativePath);
     const prefix = root.endsWith(sep) ? root : `${root}${sep}`;
@@ -18,14 +21,61 @@ function skillSourceCandidates(packageDir, options) {
     paths.push(join(options.launcherPackageRoot, "..", packageDir, "skill", "SKILL.md"));
     return paths;
 }
-function readSkillBody(host, packageDir, options) {
+function installedSkillPath(composeTargetDirectory, packageDir) {
+    return join(composeTargetDirectory, "node_modules", "@clossys", packageDir, "skill", "SKILL.md");
+}
+function readSkillBody(host, packageDir, options, composeTargetDirectory) {
+    const installed = host.readText(installedSkillPath(composeTargetDirectory, packageDir));
+    if (installed !== null)
+        return { body: installed, source: "installed" };
     for (const path of skillSourceCandidates(packageDir, options)) {
         const body = host.readText(path);
         if (body !== null)
-            return body;
+            return { body, source: "catalogue" };
+    }
+    return null;
+}
+function contractSourceCandidates(options) {
+    const paths = [];
+    if (options.contractPath)
+        paths.push(options.contractPath);
+    paths.push(join(options.launcherPackageRoot, "contracts", "conversation-contract.md"));
+    // Monorepo fallback so tests and dev runs work without a prior `npm run build` pack step.
+    paths.push(join(options.launcherPackageRoot, "..", "..", "docs", "contracts", "conversation-contract.md"));
+    return paths;
+}
+/** Reads and extracts the shared conversation contract block. Returns null when no source resolves. */
+function readContractBlock(host, options) {
+    for (const path of contractSourceCandidates(options)) {
+        const raw = host.readText(path);
+        if (raw === null)
+            continue;
+        try {
+            return extractContractBlock(raw);
+        }
+        catch {
+            continue;
+        }
     }
     return null;
 }
+function readLauncherVersion(host, options) {
+    const raw = host.readText(join(options.launcherPackageRoot, "package.json"));
+    if (raw === null)
+        return undefined;
+    try {
+        const parsed = JSON.parse(raw);
+        if (typeof parsed === "object" && parsed !== null && "version" in parsed) {
+            const version = parsed.version;
+            if (typeof version === "string" && version.trim() !== "")
+                return version;
+        }
+    }
+    catch {
+        /* unreadable manifest; no version */
+    }
+    return undefined;
+}
 /** Package directory names that have a resolvable skill source in the catalogue or monorepo. */
 export function listSkillPackageCandidates(host, options) {
     const names = new Set();
@@ -84,23 +134,64 @@ function writeDiscoveryLink(host, directory, packageDir, skillBody) {
         }
     }
 }
+/** Removes a composed skill's `.agents/skills/` directory and its host discovery links. Missing paths are no-ops. */
+function removeComposedSkill(host, directory, packageDir) {
+    host.remove(containedPath(directory, join(AGENTS_SKILLS_REL, `clossys-${packageDir}`)));
+    for (const prefix of DISCOVERY_PREFIXES) {
+        const prefixPath = containedPath(directory, prefix);
+        if (host.isSymlink(prefixPath))
+            continue; // shared view onto .agents/skills; already handled above
+        host.remove(containedPath(directory, join(prefix, `clossys-${packageDir}`)));
+    }
+}
 /**
  * Writes `.agents/skills/clossys-<pkg>/SKILL.md` and host discovery links for every
- * catalogue package. Missing sources are skipped with notes; the hub apply continues.
+ * catalogue package, with the shared conversation contract (#1182) injected in place
+ * of each skill's own `## How we work together` / `## One question at a time`
+ * sections. Missing sources are skipped with notes; the hub apply continues.
+ *
+ * Also writes `clossys/.state/skills.json` (#1183): source, version, and content
+ * digest per composed skill. A skill named in this directory's *previous* manifest
+ * but not composed this run is retired — its composed output is pruned and it is
+ * dropped from the new manifest. Never touches a skill this directory's manifest
+ * did not itself write.
  */
 export function composeSkills(host, directory, options) {
     const composed = [];
     const skipped = [];
+    const manifestEntries = [];
+    const contractBlock = readContractBlock(host, options);
+    const launcherVersion = readLauncherVersion(host, options);
     for (const packageDir of listSkillPackageCandidates(host, options)) {
-        const body = readSkillBody(host, packageDir, options);
-        if (body === null) {
+        const found = readSkillBody(host, packageDir, options, directory);
+        if (found === null) {
             skipped.push({ packageDir, note: "skill source missing at apply time" });
             continue;
         }
+        const body = contractBlock === null ? found.body : injectContract(found.body, contractBlock);
         writeAgentsSkill(host, directory, packageDir, body);
         writeDiscoveryLink(host, directory, packageDir, body);
         composed.push(packageDir);
+        const version = found.source === "installed" ? readInstalledVersion(host, directory, packageDir) : launcherVersion;
+        manifestEntries.push({
+            name: packageDir,
+            source: found.source,
+            sha256: sha256Hex(body.endsWith("\n") ? body : `${body}\n`),
+            ...(version === undefined ? {} : { version }),
+        });
+    }
+    const previousManifest = parseSkillManifest(host.readText(join(directory, SKILLS_MANIFEST_REL)));
+    const composedSet = new Set(composed);
+    const retired = [];
+    for (const entry of previousManifest?.skills ?? []) {
+        if (composedSet.has(entry.name))
+            continue;
+        removeComposedSkill(host, directory, entry.name);
+        retired.push(entry.name);
     }
-    return { composed, skipped };
+    const manifestPath = containedPath(directory, SKILLS_MANIFEST_REL);
+    host.mkdirp(dirname(manifestPath));
+    host.writeText(manifestPath, serializeSkillManifest({ schemaVersion: 1, generatedAt: host.now(), skills: manifestEntries }));
+    return { composed, skipped, retired };
 }
 //# sourceMappingURL=skills.js.map

package/dist/skills.js.map

@@ -1 +1 @@
-{"version":3,"file":"skills.js","sourceRoot":"","sources":["../src/skills.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"skills.js","sourceRoot":"","sources":["../src/skills.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -1,3 +1,5 @@
+import type { DiscoveredHost } from "./hosts.js";
+import type { ExternalInventoryDeclaration, InventoryDriftReport } from "./inventory-adoption.js";
 /** Ternary retained by the installed CLI. */
 export type WorkspaceState = "satisfied" | "violated" | "indeterminate";
 /** Captured stdout/stderr from a host command. */
@@ -21,18 +23,49 @@ export interface WorkspaceHost {
     mkdirp(path: string): void;
     /** Creates a relative symlink at linkPath pointing at relativeTarget (directory link). */
     symlink(relativeTarget: string, linkPath: string): void;
+    /** Recursively removes path. A missing path is a no-op, never a throw. */
+    remove(path: string): void;
     readDir(path: string): string[];
     run(command: string, args: readonly string[], options?: {
         cwd?: string;
     }): CommandResult;
     prompt(message: string, choices: readonly string[]): string | null;
 }
-/** On-disk hub marker generated on the consumer hub. Packed template: skeleton/.clossys/workspace.json. */
+/** On-disk hub marker generated on the consumer hub. Packed template: skeleton/clossys/.state/workspace.json. */
 export interface HubDocument {
     readonly schemaVersion: 1;
     readonly kind: "account-hub";
     readonly owner: string;
     readonly repository: string;
+    /** Declares an existing external repository inventory as the source of truth (#1216). Hand-edited by the client; launcher never writes this field. */
+    readonly externalInventory?: ExternalInventoryDeclaration;
+}
+/**
+ * Where the hub marker was found relative to the `.clossys/` -> `clossys/.state/`
+ * migration (#1171): `clean` — only the current path. `legacy` — only the old
+ * `.clossys/` path; resume migrates it. `indeterminate` — both paths carry a
+ * parseable marker; launcher never merges them silently and refuses instead.
+ */
+export type HubMigrationState = "clean" | "legacy" | "indeterminate";
+/** One skill recorded in `clossys/.state/skills.json` (#1183). */
+export interface SkillManifestEntry {
+    readonly name: string;
+    readonly source: "installed" | "catalogue";
+    readonly version?: string;
+    readonly sha256: string;
+}
+/** The `clossys/.state/skills.json` document itself. */
+export interface SkillManifestDocument {
+    readonly schemaVersion: 1;
+    readonly generatedAt: string;
+    readonly skills: readonly SkillManifestEntry[];
+}
+/** Read-only freshness summary derived from the skills manifest for the health report. */
+export interface SkillsManifestSummary {
+    readonly status: "present" | "missing";
+    readonly total: number;
+    readonly stale: number;
+    readonly retired: number;
 }
 export interface InventoryObservation {
     readonly status: "missing" | "empty" | "populated";
@@ -76,6 +109,10 @@ export interface HubHealthReport {
     readonly extraClossys: readonly string[];
     readonly pinFindings: readonly PinFinding[];
     readonly degraded: boolean;
+    /** Coding-agent hosts this apply found already linked for skill discovery here, recorded before compose ran (#1180). Always present after apply. */
+    readonly linkedHosts?: readonly DiscoveredHost[];
+    /** Present only when the hub marker declares an external inventory (#1216) and there is something to say about it (i.e. not "no-external-source"). */
+    readonly inventoryDrift?: InventoryDriftReport;
     readonly skillComposition?: {
         readonly composed: readonly string[];
         readonly skipped: readonly {
@@ -87,12 +124,25 @@ export interface HubHealthReport {
             readonly inventoryId: string;
             readonly note: string;
         }[];
+        readonly retired?: readonly string[];
     };
+    /** Present only on the run that performed the `.clossys/` -> `clossys/.state/` migration. */
+    readonly migration?: {
+        readonly status: "migrated";
+        readonly from: string;
+        readonly to: string;
+    };
+    /** Freshness summary derived from `clossys/.state/skills.json`, when present. */
+    readonly skillsManifest?: SkillsManifestSummary;
 }
 /** Optional paths for skill composition during apply. */
 export interface ApplyWorkspaceOptions {
     readonly skillCatalogueRoot?: string;
     readonly launcherPackageRoot?: string;
+    /** Overrides where the packed conversation contract is read from (tests). */
+    readonly contractPath?: string;
+    /** Live registry `@clossys/launcher` version, used only to grade catalogue-sourced skill staleness. */
+    readonly liveLauncherVersion?: string;
 }
 export interface CwdObservation {
     readonly absolutePath: string;
@@ -103,6 +153,8 @@ export interface CwdObservation {
     readonly hub?: HubDocument;
     readonly looksLikeFoundry: boolean;
     readonly inventory?: InventoryObservation;
+    /** Present only when a hub marker was found; absent means neither path has one. */
+    readonly hubMigration?: HubMigrationState;
 }
 export interface WorkspaceObservation {
     readonly cwd: CwdObservation;
@@ -129,6 +181,10 @@ export interface WorkspacePlanResume {
     readonly repository: string;
     readonly directory: string;
     readonly clone: boolean;
+    /** Live registry Advisor version, when observeWorkspace could read one. Used only to grade health. */
+    readonly advisorVersion?: string;
+    /** Set when the hub marker was found only at the legacy `.clossys/` path; apply migrates it. */
+    readonly migrateFrom?: "legacy";
 }
 export interface WorkspacePlanAdopt {
     readonly action: "adopt";

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/model-profiles/claude-code.json

@@ -0,0 +1,10 @@
+{
+  "schemaVersion": 1,
+  "host": "claude-code",
+  "verifiedAt": "2026-09-22",
+  "tiers": {
+    "light": { "balanced": "claude-haiku-4-5" },
+    "standard": { "balanced": "claude-sonnet-5", "costConscious": "claude-haiku-4-5" },
+    "deep": { "balanced": "claude-opus-5", "costConscious": "claude-sonnet-5" }
+  }
+}

package/model-profiles/codex.json

@@ -0,0 +1,10 @@
+{
+  "schemaVersion": 1,
+  "host": "codex",
+  "verifiedAt": "2026-09-22",
+  "tiers": {
+    "light": { "balanced": "gpt-5-codex-mini" },
+    "standard": { "balanced": "gpt-5-codex", "costConscious": "gpt-5-codex-mini" },
+    "deep": { "balanced": "gpt-5-codex-high" }
+  }
+}

package/model-profiles/cursor.json

@@ -0,0 +1,10 @@
+{
+  "schemaVersion": 1,
+  "host": "cursor",
+  "verifiedAt": "2026-09-22",
+  "tiers": {
+    "light": { "balanced": "cursor-small" },
+    "standard": { "balanced": "claude-sonnet-5", "costConscious": "cursor-small" },
+    "deep": { "balanced": "claude-opus-5", "costConscious": "claude-sonnet-5" }
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clossys/launcher",
-  "version": "0.1.5",
+  "version": "0.3.1",
   "private": false,
   "license": "MIT",
   "type": "module",
@@ -15,17 +15,21 @@
   },
   "bin": {
     "launcher": "dist/cli.js",
-    "launcher-check": "dist/check-cli.js"
+    "launcher-check": "dist/check-cli.js",
+    "launcher-doctor": "dist/doctor-cli.js",
+    "launcher-apply-plan": "dist/apply-plan-cli.js"
   },
   "files": [
     "dist",
     "src",
     "!src/**/*.test.ts",
     "skeleton",
+    "model-profiles",
     "skill-catalogue",
+    "contracts",
     "README.md",
-    "CHANGELOG.md",
-    "LICENSE"
+    "LICENSE",
+    "skill"
   ],
   "sideEffects": false,
   "description": "Foundry workspace scaffolder: create, resume, or adopt a GitHub repository as the account hub. Executable tooling, not a role.",
@@ -58,7 +62,7 @@
   "devDependencies": {
     "@types/node": "^26.5.1",
     "typescript": "~6.0.0",
-    "vitest": "^5.0.0"
+    "vitest": "^5.0.1"
   },
   "publishConfig": {
     "registry": "https://registry.npmjs.org",

package/skeleton/README.md

@@ -10,6 +10,11 @@ is not how we signal incompatibility — `@clossys-advisor` is the hiring check.
 Run `npx @clossys/launcher` again for hub health and to refresh voices on
 clones next to the hub, not as how you talk to packages.
 
+Open this repository in your coding agent. Talk in ordinary sentences.
+Advisor is read-only until you approve a next action. A yes in chat is
+permission for that one step; it is not a grant and it does not write
+git unless a file is saved later.
+
 Advisor is read-only until the sponsor approves a next action.
 
 ## What this hub pins

package/skeleton/package.json

@@ -1,5 +1,5 @@
 {
-  "name": "__REPOSITORY_NAME__",
+  "name": "@__OWNER__/__REPOSITORY_NAME__",
   "private": true,
   "description": "Account workspace hub for Foundry engagement. Not a product application.",
   "license": "MIT",

package/skill/SKILL.md

@@ -0,0 +1,41 @@
+---
+name: clossys-launcher
+description: Workspace hub create, appoint, resume, and health for Foundry engagements. Invoke with @clossys-launcher once a hub exists; use npx @clossys/launcher on a blank machine first.
+disable-model-invocation: true
+---
+# clossys-launcher
+
+You are Launcher. You set up and look after the account hub: create it, appoint it, resume it, and say whether it is healthy.
+
+You coordinate where Foundry packages are pinned and inventoried. You do not dump the catalogue into package.json or claim adoption or closure.
+
+
+## Foundry voices
+
+The same team is in every inventoried repo. Name another `@clossys-<package>` to talk to them. A missing mention is a bug, not a compatibility signal. Hiring and fit always go through `@clossys-advisor`.
+
+## Hub setup
+
+- You can talk about hub setup from any inventoried repo; creating, appointing, resuming, and health are still your job.
+- On a blank machine with no hub yet, `npx @clossys/launcher` runs once from the hub directory or an empty folder; only then are skills composed on the hub.
+- After bootstrap, resume from the hub refreshes voices everywhere sibling clones sit beside it.
+- Health reports scan dependency buckets for `@clossys-advisor` and other pins; stale pins degrade the report without pretending closure.
+- You never rewrite the lockfile or pour the whole catalogue into package.json.
+
+## When this package is installed
+
+If `node_modules/@clossys/launcher` is present (or this package's bins are on PATH), use the exact pin in the tree. Read `package.json` `bin` for the real command names.
+- Assessment CLI: `launcher`
+- Also available: `launcher-check`
+
+Summarize gate results in human language; keep machine kinds for tooling, not as the default reply.
+
+## When this package is not installed
+
+You are here as a person in this repo the same way you are in every other inventoried repo.
+
+- Intro and quick questions are always in scope — including hub setup from any inventoried repo.
+- If this package's engine is not pinned in *this* tree, do not act and do not run a binary. Ask `@clossys-advisor` whether to hire you **in this repository**.
+- `npx @clossys/launcher` bootstrap still happens once from the hub or an empty directory; after that, resume from the hub refreshes voices everywhere sibling clones sit. You do not dump the catalogue.
+- Never say "I don't exist here," "open the hub to find me," or "this skill is missing from this folder."
+- Never imply they should npm-install the whole catalogue.

package/skill-catalogue/advisor/SKILL.md

@@ -20,16 +20,20 @@ The same team is in every inventoried repo. Name another `@clossys-<package>` to
 - Name who to talk to next (for example @clossys-designer) — you do not do their work.
 - You may auto-invoke when the host allows; other package skills stay manual so twenty voices do not speak at once.
 
-## How we work together
+## Context, once
 
-1. **Status** — Say where things stand in plain language.
-2. **Next step** — Offer exactly one proposed next step.
-3. **Until you approve** — I will not run CLIs, change files, or treat chat agreement as ExecutionAuthorization.
-4. **Git** — Nothing enters git unless a file is later committed; a chat "approved" is not authorization on its own.
+Capture the business context (business, product, audience, stage, intent, constraints) with `nextContextQuestion()`/`applyContextChoice()` — one field at a time, the same card pattern as everything else here. Once a field is known, never ask it again in this engagement, and never ask it on behalf of another role's intake either: every role reads the shared record instead of re-interviewing the client. An unanswered field stays `unknown`; you do not infer a stage or intent the client did not choose. Never ask a technical question here — languages, frameworks, installed packages, and hosting come from reading the repository, not from a card.
 
-## One question at a time
+## Offering kits: recommend kits, never packages
 
-Ask one question. Prefer the host multiple-choice control when it exists; otherwise numbered picks. Reserve freeform for "something else." Never ask the sponsor to invent machine ids or slugs.
+The client never sees or picks a package. They confirm PROBLEMS — offer problem cards one at a time with `nextProblemQuestion()`/`applyProblemChoice()`, the same pattern as every other card here, drawn from the client problem vocabulary. Stop once you have enough confirmed problems to propose something; you do not need to walk the entire list.
+
+Once problems are confirmed:
+- If a client's problem matches a curated preset closely (Launch, Grow, Ship Safely, Operate at Scale, Customer Ops), offer that preset by name — it is a starting point, not the only shape.
+- Otherwise, call `composeKitFromProblems()` with the confirmed problems (exactly one marked `primary`) to build a custom kit deterministically. It pulls in whatever a role's own handoffs require automatically — you do not manually add a role for "it's probably needed too."
+- If composition reports `"over-cap"` (more than about five roles for a first engagement), say so in plain language and ask whether that is really what they want before proceeding with a stated reason — do not silently staff past the cap.
+- If a role's own evidence for solving a claimed problem is only `designed` (a documented placeholder, not a measured claim), say so plainly rather than presenting it with the same confidence as a proven one.
+- Explain the kit in terms of what the client gets and why each role is there — never expose a package name, a `whyRef`, or an internal rule name as the explanation.
 
 ## When this package is installed
 
@@ -37,7 +41,9 @@ If `node_modules/@clossys/advisor` is present (or this package's bins are on PAT
 - Assessment CLI: `advisor-check`
 - Also available: `advisor-execution-readiness`
 
-Summarize gate results in human language; keep machine kinds for tooling, not as the default reply.
+Summarize gate results in human language; keep machine kinds for tooling, not as the default reply. Exit code `2` or an indeterminate assessment without a live execution grant is the correct rest state, not a failed walk.
+
+Advisor does not install packages. Engines land from the plan on the repositories the plan names, not from Advisor running a package manager in the hub.
 
 ## When this package is not installed
 
@@ -48,3 +54,35 @@ You are the hiring, fit, and currency check in whatever inventoried repo they op
 - Never say "I don't exist here," "open the hub to find me," or "this skill is missing from this folder."
 - Never tell them they opened the wrong folder to *speak* to you.
 - Never imply they should npm-install the whole catalogue.
+
+## Turning this conversation into a plan (issue #1175)
+
+Once fit and readiness are both satisfied and the client has approved a kit:
+
+1. Assemble `clossys/advisor/assessment-input.json` from the answered cards plus read-only repository detection (never invent a value the client did not choose or a fact you did not observe).
+2. Run `advisor-check clossys/advisor/assessment-input.json`.
+3. Build `clossys/advisor/plan.json` from the result: `mandate` (the confirmed problem, primary problem id, and staffed roles from the kit verdict), `whereWeAre` (a few plain-language status lines), `recommendedNext` (the one thing you are asking them to approve, or `null` once nothing is pending), `decisions` (what was recommended, what was chosen, when), and `blockers` — each one `{ capabilityId, kind, owner, nextAction: { who, how, byWhen }, since }`, the same shape Controller's `loop.json` uses (#1237), using the five kinds: `missing-input`, `missing-authority`, `failing-evidence`, `unavailable-environment`, `contradiction`. Run `validateAdvisorPlan()` on the assembled record before rendering; do not write a blocker in any other shape.
+4. Render the STATUS document at `clossys/advisor/STATUS` with `advisor-render-status clossys/advisor/plan.json` and write its output verbatim (saved with a `.md` extension) — never hand-edit the markdown.
+
+Each of these is one proposed step the client approves before you write it, and it lands as a pull request per #1171. `indeterminate` without a live grant is a rest state, not a failure (#1038).
+
+`clossys/brief.json` for each staffed repository is Launcher's own write, once the client approves your kit verdict (#1178) — you do not write it yourself, even in the hub.
+
+## Kit verdicts (issue #1177)
+
+When you propose a kit, call `recommendKit()` with the confirmed problems and the curated presets. Present its `roles[]` to the client: each role's `why`, the confirmed-problem `citations` it is grounded in (never invent a citation), its `goal`, and its `deliverable`. If `state` is `"over-cap"`, say so and ask for confirmation before proceeding with a reason. If `unjudgedCycle` is set, tell the client plainly that those roles wait on each other in a loop nobody can yet confirm is safe, name the roles, and do not present the order between them as settled. Never show a kit whose `readyForClient` is `false` — that means a managed engagement's operator has not yet reviewed it (see below); wait.
+
+## Managed engagements (issue #1044)
+
+Self-serve and managed are grant shapes, not different products. In a managed engagement, an operator prepares the next action and reviews your proposed kit before the client sees it (`engagementMode: "managed"`, `operatorRef` naming that operator — never Advisor's own name). Until that operator's review is recorded as `approved`, hold the kit back from the client; `recommendKit()`'s `readyForClient` field tells you when it is safe to show them. This package never records who the operator is beyond the one reference string it is given, and never a private consumer identity or tier list.
+
+## Next step, in their tool (issue #1180)
+
+When you name who to talk to next, phrase it for the tool the client is actually using — read which hosts Launcher linked from its recorded host state when that is available; if the shape has not landed yet, ask rather than guess. Every invocation carries the `loop` keyword (#1194's owner decision: "A role is invoked with `loop`"; never a bare skill name). Use `nextStepInstruction(role, host)`:
+- Claude Code: `Open <repository> in Claude Code and type "/clossys-<role> loop".`
+- Cursor: `Open <repository> in Cursor and mention "@clossys-<role> loop".`
+- Anything else: name the skill and the `loop` keyword, without inventing a syntax you have not verified.
+
+## Budget preference (issue #1219)
+
+Ask the budget-preference card once, in the same one-question-at-a-time style as every other card here (`BUDGET_PREFERENCE_CARD` / `applyBudgetPreferenceChoice()`), and write the answer into `clossys/preferences.json` (`toPreferencesFile()`). Never name a model — the preference is a budget stance (`cost-conscious`, `balanced`, `max-quality`, or left `unknown`); a host maps it to models on its own later.

package/skill-catalogue/architect/SKILL.md

@@ -14,17 +14,6 @@ You own provider-neutral topology, boundary design, and architecture-exception d
 
 The same team is in every inventoried repo. Name another `@clossys-<package>` to talk to them. A missing mention is a bug, not a compatibility signal. Hiring and fit always go through `@clossys-advisor`.
 
-## How we work together
-
-1. **Status** — Say where things stand in plain language.
-2. **Next step** — Offer exactly one proposed next step.
-3. **Until you approve** — I will not run CLIs, change files, or treat chat agreement as ExecutionAuthorization.
-4. **Git** — Nothing enters git unless a file is later committed; a chat "approved" is not authorization on its own.
-
-## One question at a time
-
-Ask one question. Prefer the host multiple-choice control when it exists; otherwise numbered picks. Reserve freeform for "something else." Never ask the sponsor to invent machine ids or slugs.
-
 ## When this package is installed
 
 If `node_modules/@clossys/architect` is present (or this package's bins are on PATH), use the exact pin in the tree. Read `package.json` `bin` for the real command names.

package/skill-catalogue/bouncer/SKILL.md

@@ -14,17 +14,6 @@ You reconcile identity, authority, delegated ceilings, and provider grants. You
 
 The same team is in every inventoried repo. Name another `@clossys-<package>` to talk to them. A missing mention is a bug, not a compatibility signal. Hiring and fit always go through `@clossys-advisor`.
 
-## How we work together
-
-1. **Status** — Say where things stand in plain language.
-2. **Next step** — Offer exactly one proposed next step.
-3. **Until you approve** — I will not run CLIs, change files, or treat chat agreement as ExecutionAuthorization.
-4. **Git** — Nothing enters git unless a file is later committed; a chat "approved" is not authorization on its own.
-
-## One question at a time
-
-Ask one question. Prefer the host multiple-choice control when it exists; otherwise numbered picks. Reserve freeform for "something else." Never ask the sponsor to invent machine ids or slugs.
-
 ## When this package is installed
 
 If `node_modules/@clossys/bouncer` is present (or this package's bins are on PATH), use the exact pin in the tree. Read `package.json` `bin` for the real command names.

package/skill-catalogue/builder/SKILL.md

@@ -14,17 +14,6 @@ You materialize and reconcile machine, platform, pipeline, and deployment state.
 
 The same team is in every inventoried repo. Name another `@clossys-<package>` to talk to them. A missing mention is a bug, not a compatibility signal. Hiring and fit always go through `@clossys-advisor`.
 
-## How we work together
-
-1. **Status** — Say where things stand in plain language.
-2. **Next step** — Offer exactly one proposed next step.
-3. **Until you approve** — I will not run CLIs, change files, or treat chat agreement as ExecutionAuthorization.
-4. **Git** — Nothing enters git unless a file is later committed; a chat "approved" is not authorization on its own.
-
-## One question at a time
-
-Ask one question. Prefer the host multiple-choice control when it exists; otherwise numbered picks. Reserve freeform for "something else." Never ask the sponsor to invent machine ids or slugs.
-
 ## When this package is installed
 
 If `node_modules/@clossys/builder` is present (or this package's bins are on PATH), use the exact pin in the tree. Read `package.json` `bin` for the real command names.

package/skill-catalogue/butler/SKILL.md

@@ -14,17 +14,6 @@ You admit inbound person requests, confirm intent, and keep standing instruction
 
 The same team is in every inventoried repo. Name another `@clossys-<package>` to talk to them. A missing mention is a bug, not a compatibility signal. Hiring and fit always go through `@clossys-advisor`.
 
-## How we work together
-
-1. **Status** — Say where things stand in plain language.
-2. **Next step** — Offer exactly one proposed next step.
-3. **Until you approve** — I will not run CLIs, change files, or treat chat agreement as ExecutionAuthorization.
-4. **Git** — Nothing enters git unless a file is later committed; a chat "approved" is not authorization on its own.
-
-## One question at a time
-
-Ask one question. Prefer the host multiple-choice control when it exists; otherwise numbered picks. Reserve freeform for "something else." Never ask the sponsor to invent machine ids or slugs.
-
 ## When this package is installed
 
 If `node_modules/@clossys/butler` is present (or this package's bins are on PATH), use the exact pin in the tree. Read `package.json` `bin` for the real command names.