@detergent-software/conductor 1.0.0-dev.32 → 1.0.0-dev.33

package/CHANGELOG.md

@@ -2,6 +2,14 @@
 
 Releases are tagged `conductor-v<version>` and staged on npm by `atk-conductor-release` (`pipelines/release-conductor.yml`), which writes each section below. `scripts/check-changelog.mjs` fails when a tag has no section here.
 
+## [1.0.0-dev.33](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/branchCompare?baseVersion=GTconductor-v1.0.0-dev.32&targetVersion=GTconductor-v1.0.0-dev.33) (2026-10-12)
+
+### Bug Fixes
+
+* **conductor:** log when the mod asks a console to load its skill (ATK-385) ([10f7e58](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/10f7e58ec830ef3ec15e26cb7f7f03375aff235e))
+* **conductor:** reset the console's skill check on /clear (ATK-385) ([6b47df4](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/6b47df436acfb57cda034bf79b98f3d65db2c065))
+* **conductor:** tell a console without its skill to load it (ATK-385) ([c080637](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/c08063760f2035ebea6c53f21113296731d98237))
+
 ## [1.0.0-dev.32](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/branchCompare?baseVersion=GTconductor-v1.0.0-dev.31&targetVersion=GTconductor-v1.0.0-dev.32) (2026-10-12)
 
 ### Features

package/README.md

@@ -252,7 +252,7 @@ The scheduler moves conduct-atk's tick into the daemon (design note, section 8).
    - **Order:** the tracker project's priority, then the conductor project's `weight` (profile, or `conduct focus --weight`), then the item's priority, then when it was created.
    - **Areas:** one in-flight item per Area per project. An Area is held by every worker in flight and every started item, and by the Areas it covers or is covered by.
    - **Not picked:** items labelled with the profile's human label, and items whose blockers are still open, which wait (pending, or "not being worked" when nothing will clear them).
-   - **Slots:** `scheduler.slots` (4) across projects and the profile's `slots` (2) per project, or `conduct focus --slots`, never more than the global ones. Slots count running workers only: a parked worker keeps its Area and frees its slot.
+   - **Slots:** `scheduler.slots` (4) across projects and the profile's `slots` per project (ATK's is 4), or `conduct focus --slots`, never more than the global ones. Slots count running workers only: a parked worker keeps its Area and frees its slot.
    - **Holds:** quiet hours and `conduct pause` turn picks into waits that say why.
 3. **Act.** It runs the rules on what it found: `queue.pick` → `launch` (default `launch`), `item.closed` → `retire` (default `retire-closed`; a refused retire raises an inbox item once, except one refused while the worker's turn runs or its session starts, which is tried again each tick and raised only after 15 minutes), `queue.drained` and `queue.ready-to-release` → an inbox item once a day. Each action is a `rule.fired` event, then `rule.done` or `rule.failed`. A launch that failed isn't tried again while its inbox item is open.
 
@@ -487,6 +487,7 @@ It runs `claude -n conductor --permission-mode auto -- /conductor-console` with
   - **the band** above the prompt while the inbox has items: one hotkey per item (a plan approves after a second press, `y`, since a digit typed into an empty prompt presses a band button; an npm OTP copies its `npm stage approve` line; the rest open the pane), and `o` for the pane;
   - **the pane** (`/conductor`, `o`, or opened at the start, docked as a sidebar on a fullscreen terminal of 144 columns or more): the notification profile (a picker; buttons on mobile) and Remote Control's state, the inbox with each item's actions (approve, revise, copy a command, open a link, done), the workers by project (each project's rule has [pause] and [focus]; a row expands to attach and why), and today's spend;
   - **commands answered in code**, never by the model: `/conductor`, `/inbox`, `/approve <item | #id>`, `/revise <item | #id> <text>`, `/attach <item | worker>`, `/notify [<profile> [--until <when>]]`, `/pause [<project>] [--until <when>]`, `/unpause [<project>]`, `/focus-project <project> [--until <when>]` (puts its items first, until midnight without `--until`; not `/focus`, which is Claude Code's own);
+  - **a check that `/conductor-console` ran**: a console started without it (by hand, as `claude -n conductor`) shows `console without its skill: run /conductor-console` in the band, and each prompt, Jason's or an escalation's, carries a line telling the model to load the skill before it answers. Running the skill (`/conductor-console`, or the model's Skill tool) clears both, until a `/clear` or a resume starts a conversation without it;
   - **the stream**: it runs `node <package>/build/cli.js events --follow --console` (`--console` tells the daemon a console is open), redraws on each event, toasts each new inbox item, and acts on three events:
 
 | Event | Data | The mod |

package/mod/README.md

@@ -1,6 +1,6 @@
 # Conductor mod
 
-A Claude Code plugin (a hooks module) that does the conductor console's plumbing in code, so it costs no tokens. Only the console (`CONDUCTOR_CONSOLE=1`) gets anything from it: the inbox band, the fleet pane, `/conductor` `/inbox` `/approve` `/revise` `/attach` `/notify` `/pause` `/unpause` `/focus-project`, toasts, Remote Control pushes (and the one warning when Remote Control is off), and the one model wake-up for an escalation. What it shows and does is in the conductor README's *Mod* section (`apps/conductor/README.md`).
+A Claude Code plugin (a hooks module) that does the conductor console's plumbing in code, so it costs no tokens. Only the console (`CONDUCTOR_CONSOLE=1`) gets anything from it: the inbox band, the fleet pane, `/conductor` `/inbox` `/approve` `/revise` `/attach` `/notify` `/pause` `/unpause` `/focus-project`, toasts, Remote Control pushes (and the one warning when Remote Control is off), the one model wake-up for an escalation, and a nudge to load `/conductor-console` in a console started without it. What it shows and does is in the conductor README's *Mod* section (`apps/conductor/README.md`).
 
 Install it with the daemon's CLI, which ships this folder:
 

package/mod/hooks/model.ts

@@ -46,6 +46,13 @@ export function reportedState(outcome: PushOutcome): 'failing' | 'inactive' | 'o
   return outcome.state === 'failed' ? 'failing' : outcome.state;
 }
 
+// The skill a console runs first (ATK-385). `conduct console` starts with it as the first prompt;
+// a console started by hand (`claude -n conductor`) has to be told.
+export const CONSOLE_SKILL = 'conductor-console';
+// What the model reads beside each prompt of a console whose skill hasn't run.
+export const NO_SKILL_CONTEXT = `This session is the conductor console (CONDUCTOR_CONSOLE=1), but /${CONSOLE_SKILL} hasn't run in it, so its rules don't hold. Load the ${CONSOLE_SKILL} skill with the Skill tool and follow it, then answer this prompt.`;
+export const NO_SKILL_WARNING = `console without its skill: run /${CONSOLE_SKILL}`;
+
 // A band entry and the act its press does.
 export type BandEntry = { act: 'approve' | 'copy' | 'pane'; hotkey: string; id: number; label: string; text: string };
 

package/mod/hooks/register.tsx

@@ -1,5 +1,5 @@
 import { atom, read, update } from 'claude-code';
-import type { EngineInterface, Register } from 'claude-code';
+import type { EngineInterface, Register, RenderElement } from 'claude-code';
 
 import type { ConductorSnapshot } from '../types';
 
@@ -8,6 +8,7 @@ import {
   type ApiAnswer,
   answerText,
   bandEntries,
+  CONSOLE_SKILL,
   endpointOf,
   errorOf,
   findPlan,
@@ -15,6 +16,8 @@ import {
   glyph,
   homeOf,
   inboxText,
+  NO_SKILL_CONTEXT,
+  NO_SKILL_WARNING,
   notifyArgs,
   notifyText,
   overrideArgs,
@@ -49,6 +52,7 @@ const NOT_RUNNING = 'the conductor is not running (conduct serve)';
 const snapshot = atom({ plugin: 'conductor', key: 'snapshot' } as const, null);
 const confirming = atom({ plugin: 'conductor', key: 'confirming' } as const, null);
 const expanded = atom({ plugin: 'conductor', key: 'expanded' } as const, null);
+const hasSkill = atom({ plugin: 'conductor', key: 'hasSkill' } as const, false);
 
 // The console is the session started with CONDUCTOR_CONSOLE=1 (`conduct console` sets it): only it
 // draws the band and the pane, answers the commands, follows the stream and acts on events. Both
@@ -315,6 +319,27 @@ export const register: Register = (on) => {
     return started;
   });
 
+  // A console the skill never ran in (one started by hand as `claude -n conductor`, ATK-385) is
+  // told to load it before it answers, each prompt until it has. `/conductor-console` or the Skill
+  // tool expands it before its prompt is submitted; a /clear or a resume starts a conversation
+  // without it.
+  on('skill.prompt', { skill: CONSOLE_SKILL }, async ($, e, next) => {
+    const prompt = await next(e);
+    if (isConsole) await update($, hasSkill, () => true);
+    return prompt;
+  });
+
+  on('session.end', async ($, e, next) => {
+    if (isConsole) await update($, hasSkill, () => false);
+    return next(e);
+  });
+
+  on('prompt.submit', async ($, e, next) => {
+    if (!isConsole || (await read($, hasSkill))) return next(e);
+    $.ui.log(`conductor: /${CONSOLE_SKILL} hasn't run; asking the model to load it`, { to: 'debug' });
+    return next({ ...e, context: [...(e.context ?? []), NO_SKILL_CONTEXT] });
+  });
+
   on('command.run', { command: 'conductor' }, async ($) => {
     await openPane($);
     return { text: 'Conductor pane opened.' };
@@ -369,17 +394,32 @@ export const register: Register = (on) => {
   on('command.run', { command: 'focus-project' }, async ($, e) => ({ text: await override($, 'focus', e.args) }));
 
   // The band above the prompt, in the console, while the inbox has items. A bare digit typed into
-  // an empty prompt presses a band Button, so a plan's approve takes a second press (`y`).
+  // an empty prompt presses a band Button, so a plan's approve takes a second press (`y`). Until
+  // /conductor-console runs, a warning sits above it, or above the engine's own (ATK-385).
   on('ui.render', { component: 'AbovePrompt' }, async ($, e, next) => {
     if (!isConsole || e.props.hasSurvey) return next(e);
-    const snap = await read($, snapshot);
-    if (snap === null || snap.error !== null || snap.inbox.length === 0) return next(e);
     const { Box, Button, Text } = $.ui.resolve(e);
+    const isWarned = !(await read($, hasSkill));
+    const withWarning = (row: RenderElement): RenderElement =>
+      isWarned ? (
+        <Box flexDirection="column">
+          <Box key="no-skill">
+            <Text bold color="warning">
+              {NO_SKILL_WARNING}
+            </Text>
+          </Box>
+          {row}
+        </Box>
+      ) : (
+        row
+      );
+    const snap = await read($, snapshot);
+    if (snap === null || snap.error !== null || snap.inbox.length === 0) return isWarned ? withWarning(await next(e)) : next(e);
     const entries = bandEntries(snap.inbox);
     const confirmId = await read($, confirming);
     const pending = entries.find((x) => x.act === 'approve' && x.id === confirmId);
     if (pending) {
-      return (
+      return withWarning(
         <Box columnGap={2} flexWrap="wrap">
           <Text bold>conductor</Text>
           <Text>
@@ -396,10 +436,10 @@ export const register: Register = (on) => {
             variant="primary"
           />
           <Button hotkey="n" key="cancel" label="n cancel" onPress={() => update($, confirming, () => null)} />
-        </Box>
+        </Box>,
       );
     }
-    return (
+    return withWarning(
       <Box columnGap={2} flexWrap="wrap">
         <Text bold>conductor · inbox {snap.inbox.length}</Text>
         {entries.map((x) => (
@@ -416,7 +456,7 @@ export const register: Register = (on) => {
         ))}
         {snap.inbox.length > entries.length && <Text dimColor>+{snap.inbox.length - entries.length} more</Text>}
         <Button hotkey="o" key="open-pane" label="o panel" onPress={() => openPane($)} />
-      </Box>
+      </Box>,
     );
   });
 

package/mod/types/index.d.ts

@@ -51,6 +51,9 @@ declare module 'claude-code' {
       confirming: number | null;
       // The worker whose row the pane shows expanded, by name.
       expanded: string | null;
+      // Whether /conductor-console ran in this conversation (ATK-385). Kept in $.state, so a reload
+      // of the mod doesn't forget it; a /clear or a resume (session.end) sets it back to false.
+      hasSkill: boolean;
       snapshot: ConductorSnapshot | null;
     };
   }

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@detergent-software/conductor",
-	"version": "1.0.0-dev.32",
+	"version": "1.0.0-dev.33",
 	"description": "Conductor: the local daemon that runs conducted projects' work loops (conduct serve) and its conduct CLI.",
 	"type": "module",
 	"bin": {