claude-dev-env 8.82.1 → 8.83.1

package/.agents/skills/deepen/SKILL.md

@@ -0,0 +1,42 @@
+---
+name: deepen
+description: >-
+  Deepen a first user task before work starts. Triggers: /deepen, deepen this
+  task, first-task deepening, Cursor Cloud launch prompt.
+---
+
+# deepen
+
+Rewrite a user task so the worker does the omitted expert job. Keep the rewrite short.
+
+## When this applies
+
+- An interactive first user task on Claude Code, Cursor, or Codex
+- `/deepen` with a task in the arguments
+- Cursor Cloud, where user `~/.cursor/hooks.json` does not run and `sessionStart` is deferred, so the launch prompt is already sent
+
+Skip when the prompt already carries `CDE_DEEPEN:v1`, when the text is a thanks or yes/no or status line, when it is a slash command other than `/deepen`, when it is a `/loop` or helper report, or when it is a spawn rewrite that already starts with the poteto-mode prefix.
+
+A prompt that is only `/deepen` with no task is skipped. `/deepen` plus a task deepens the remainder.
+
+## Four answers
+
+1. What a top person in that field would do that this prompt omitted.
+2. The raw source to start from.
+3. The methods and tools they would use.
+4. What besides the agent or Jon would show the result is right.
+
+Then rewrite the user prompt to ask for exactly that job. Put `CDE_DEEPEN:v1` at the top.
+
+## How to deepen
+
+Read the task. Name the field. Fill the four answers from the checkout, the docs, and the tools already in the tree. Keep the rewrite shorter than a new spec. The worker should start from the raw source and finish at the proof.
+
+When you spawn a helper to fill the four answers, that helper's prompt starts with `CDE_DEEPEN_AGENT` so the first-task hook leaves it alone.
+
+## Hosts
+
+- Claude desktop and CLI: a `prompt.submit` mod rewrites the visible text. The Python `UserPromptSubmit` hook is silent when that mod is on outside a cloud session.
+- Claude cloud and Codex local: the Python hook injects `additionalContext`. Command hooks cannot replace the prompt string.
+- Cursor Cloud: run this skill on the launch prompt.
+- Codex cloud orchestration skips command hooks. Local Codex only.

package/bin/codex-skill-load-block.mjs

@@ -10,6 +10,16 @@ export const PACKAGE_GUIDANCE_BLOCK_START = '<!-- claude-dev-env package guidanc
 export const PACKAGE_GUIDANCE_BLOCK_END = '<!-- claude-dev-env package guidance: end -->';
 export const QUESTION_PRESENTATION_BLOCK_START = '<!-- claude-dev-env question presentation: start -->';
 export const QUESTION_PRESENTATION_BLOCK_END = '<!-- claude-dev-env question presentation: end -->';
+export const DEEPEN_GUIDANCE_BLOCK_START = '<!-- claude-dev-env deepen: start -->';
+export const DEEPEN_GUIDANCE_BLOCK_END = '<!-- claude-dev-env deepen: end -->';
+export const DEEPEN_GUIDANCE_TEXT = [
+    'Deepen the first interactive user task before any work starts.',
+    'Answer four things the prompt left out: what a top person in that field would do, the raw source to start from, the methods and tools they would use, and what besides the agent or Jon would show the result is right.',
+    'Then rewrite the task to ask for exactly that job. The rewrite carries the marker CDE_DEEPEN:v1.',
+    'On demand, follow the deepen skill or /deepen with a task.',
+    'Cursor Cloud has no user hooks.json and defers sessionStart, so the launch prompt is already sent. Use the deepen skill under ~/.cursor/skills there.',
+    'Codex cloud orchestration skips command hooks. This block is the local Codex instruction.',
+].join('\n');
 
 const WINDOWS_LONG_PATH_PREFIX = '\\\\?\\';
 
@@ -115,6 +125,23 @@ export function writeCodexPackageGuidance(codexHome, packageGuidanceText, allPac
     );
 }
 
+export function writeCodexDeepenGuidance(codexHome, deepenText = DEEPEN_GUIDANCE_TEXT) {
+    const agentsPath = join(codexHome, 'AGENTS.md');
+    const agentsEntry = lstatSync(agentsPath, { throwIfNoEntry: false });
+    if (agentsEntry && !agentsEntry.isFile()) return null;
+    const currentText = agentsEntry ? readFileSync(agentsPath, 'utf8') : '';
+    const block = managedBlock(DEEPEN_GUIDANCE_BLOCK_START, deepenText, DEEPEN_GUIDANCE_BLOCK_END);
+    const replacedText = withBlockReplaced(
+        currentText, DEEPEN_GUIDANCE_BLOCK_START, DEEPEN_GUIDANCE_BLOCK_END, block,
+    );
+    const separator = currentText && !currentText.endsWith('\n') ? '\n' : '';
+    const updatedText = replacedText ?? `${currentText}${separator}${block}`;
+    if (updatedText === currentText) return null;
+    mkdirSync(codexHome, { recursive: true });
+    writeFileSync(agentsPath, updatedText, 'utf8');
+    return agentsPath;
+}
+
 export function writeCodexQuestionGuidance(codexHome, policyText) {
     const agentsPath = join(codexHome, 'AGENTS.md');
     const agentsEntry = lstatSync(agentsPath, { throwIfNoEntry: false });
@@ -136,6 +163,7 @@ const ALL_PACKAGE_MANAGED_BLOCK_MARKERS = [
     [SKILL_LOAD_BLOCK_START, SKILL_LOAD_BLOCK_END],
     [PACKAGE_GUIDANCE_BLOCK_START, PACKAGE_GUIDANCE_BLOCK_END],
     [QUESTION_PRESENTATION_BLOCK_START, QUESTION_PRESENTATION_BLOCK_END],
+    [DEEPEN_GUIDANCE_BLOCK_START, DEEPEN_GUIDANCE_BLOCK_END],
 ];
 
 /**
@@ -181,6 +209,10 @@ export function removeCodexQuestionGuidance(codexHome) {
     );
 }
 
+export function removeCodexDeepenGuidance(codexHome) {
+    return removeCodexGuidanceBlock(codexHome, DEEPEN_GUIDANCE_BLOCK_START, DEEPEN_GUIDANCE_BLOCK_END);
+}
+
 /**
  * Remove the managed package-guidance block while keeping surrounding guidance bytes.
  *

package/bin/codex-skill-load-block.test.mjs

@@ -11,10 +11,15 @@ import {
     SKILL_LOAD_BLOCK_END,
     SKILL_LOAD_BLOCK_START,
     SKILL_LOAD_INSTRUCTION,
+    removeCodexDeepenGuidance,
     removeCodexPackageGuidance,
     removeCodexQuestionGuidance,
     withSkillLoadBlock,
+    DEEPEN_GUIDANCE_BLOCK_END,
+    DEEPEN_GUIDANCE_BLOCK_START,
+    DEEPEN_GUIDANCE_TEXT,
     writeCodexAgentsGuidance,
+    writeCodexDeepenGuidance,
     writeCodexPackageGuidance,
     writeCodexQuestionGuidance,
 } from './codex-skill-load-block.mjs';
@@ -359,3 +364,25 @@ test('question removal leaves a missing guidance file absent', (context) => {
     assert.equal(removeCodexQuestionGuidance(homes.codexHome), null);
     assert.equal(lstatSync(homes.agentsPath, { throwIfNoEntry: false }), undefined);
 });
+
+test('should write the deepen block into Codex AGENTS.md', (context) => {
+    const homes = makeHomes(context);
+
+    assert.equal(writeCodexDeepenGuidance(homes.codexHome), homes.agentsPath);
+    const guidanceText = readFileSync(homes.agentsPath, 'utf8');
+    assert.ok(guidanceText.includes(DEEPEN_GUIDANCE_BLOCK_START));
+    assert.ok(guidanceText.includes(DEEPEN_GUIDANCE_BLOCK_END));
+    assert.ok(guidanceText.includes(DEEPEN_GUIDANCE_TEXT.split('\n')[0]));
+    assert.equal(writeCodexDeepenGuidance(homes.codexHome), null);
+});
+
+test('should restore the custom guidance bytes when the deepen block is removed', (context) => {
+    const homes = makeHomes(context);
+    mkdirSync(homes.codexHome);
+    const customGuidance = '# My notes\n\nKeep this line.\n';
+    writeFileSync(homes.agentsPath, customGuidance);
+
+    assert.equal(writeCodexDeepenGuidance(homes.codexHome), homes.agentsPath);
+    assert.equal(removeCodexDeepenGuidance(homes.codexHome), homes.agentsPath);
+    assert.equal(readFileSync(homes.agentsPath, 'utf8'), customGuidance);
+});

package/bin/codex-trimmed-sol.test.mjs

@@ -34,6 +34,7 @@ function installInScratchHome(homeDirectory, argumentsList = [], environment = {
             CDE_INSTALL_PSTACK: '0',
             CDE_INSTALL_USAGE_WRAPUP: '0',
             CDE_INSTALL_SUBAGENT_MODELS: '0',
+            CDE_INSTALL_DEEPEN_FIRST_PROMPT: '0',
             CLAUDE_DEV_ENV_INSTALL_FAULT: undefined,
             HOME: homeDirectory,
             USERPROFILE: homeDirectory,

package/bin/ever-shipped-skills.mjs

@@ -24,6 +24,7 @@ export const EVER_SHIPPED_SKILL_NAMES = new Set([
     'copilot-review',
     'correction',
     'deep-research',
+    'deepen',
     'descriptions',
     'e-code-review',
     'e-simplify',

package/bin/install-pstack-plugin.mjs

@@ -34,6 +34,18 @@ export const USAGE_WRAPUP_PLUGIN_SPEC = Object.freeze({
     optOutVariable: 'CDE_INSTALL_USAGE_WRAPUP',
 });
 
+export const DEEPEN_FIRST_PROMPT_PLUGIN_SPEC = Object.freeze({
+    name: 'deepen-first-prompt',
+    label: 'Deepen-first-prompt',
+    marketplaceRepository: 'jl-cmd-projects/claude-dev-env',
+    marketplaceName: 'claude-dev-env',
+    sparsePaths: Object.freeze(['.claude-plugin', 'packages/deepen-first-prompt']),
+    pluginIdentifier: 'deepen-first-prompt@claude-dev-env',
+    hosts: Object.freeze(['claude']),
+    optOutFlag: '--no-deepen-first-prompt',
+    optOutVariable: 'CDE_INSTALL_DEEPEN_FIRST_PROMPT',
+});
+
 export const SUBAGENT_MODELS_PLUGIN_SPEC = Object.freeze({
     name: 'subagent-models',
     label: 'Subagent-models',

package/bin/install-pstack-plugin.test.mjs

@@ -7,6 +7,7 @@ import {
     PSTACK_MARKETPLACE_REPOSITORY,
     PSTACK_PLUGIN_HOSTS,
     PSTACK_PLUGIN_IDENTIFIER,
+    DEEPEN_FIRST_PROMPT_PLUGIN_SPEC,
     PSTACK_PLUGIN_SPEC,
     SUBAGENT_MODELS_PLUGIN_SPEC,
     USAGE_WRAPUP_PLUGIN_SPEC,
@@ -272,6 +273,7 @@ test('the usage-wrapup opt-out flag and variable turn off only usage-wrapup', ()
 for (const [spec, packageFolder] of [
     [USAGE_WRAPUP_PLUGIN_SPEC, './packages/usage-wrapup'],
     [SUBAGENT_MODELS_PLUGIN_SPEC, './packages/subagent-models'],
+    [DEEPEN_FIRST_PROMPT_PLUGIN_SPEC, './packages/deepen-first-prompt'],
 ]) {
     test(`the repository marketplace lists ${spec.name} from its package folder in this repository`, () => {
         const marketplace = JSON.parse(readFileSync(
@@ -305,6 +307,27 @@ test('should remove and add the shared marketplace once when installing usage-wr
     ]);
 });
 
+test('should include deepen-first-prompt in one marketplace add with the other repository plugins', () => {
+    const plan = marketplacePluginsPlan(
+        [USAGE_WRAPUP_PLUGIN_SPEC, SUBAGENT_MODELS_PLUGIN_SPEC, DEEPEN_FIRST_PROMPT_PLUGIN_SPEC],
+        'claude',
+    );
+    assert.deepEqual(plan.commands[0], [
+        'plugin', 'marketplace', 'add', 'jl-cmd-projects/claude-dev-env',
+        '--sparse', '.claude-plugin', 'packages/usage-wrapup', 'packages/subagent-models',
+        'packages/deepen-first-prompt',
+    ]);
+    assert.equal(shouldInstallMarketplacePlugin(DEEPEN_FIRST_PROMPT_PLUGIN_SPEC, ['--no-deepen-first-prompt'], {}), false);
+    assert.equal(
+        shouldInstallMarketplacePlugin(
+            DEEPEN_FIRST_PROMPT_PLUGIN_SPEC,
+            [],
+            { CDE_INSTALL_DEEPEN_FIRST_PROMPT: '0' },
+        ),
+        false,
+    );
+});
+
 test('should refuse one plan for plugins from two marketplaces', () => {
     assert.throws(
         () => marketplacePluginsPlan([PSTACK_PLUGIN_SPEC, SUBAGENT_MODELS_PLUGIN_SPEC], 'claude'),

package/bin/install.agents-home.test.mjs

@@ -55,6 +55,7 @@ function runInstaller(homeDirectory, extraArguments, environmentOverrides = {})
         CDE_INSTALL_PSTACK: '0',
         CDE_INSTALL_USAGE_WRAPUP: '0',
         CDE_INSTALL_SUBAGENT_MODELS: '0',
+        CDE_INSTALL_DEEPEN_FIRST_PROMPT: '0',
         HOME: homeDirectory,
         USERPROFILE: homeDirectory,
         GIT_CONFIG_GLOBAL: join(homeDirectory, '.gitconfig'),

package/bin/install.codex-rules.test.mjs

@@ -61,6 +61,7 @@ function runInstaller(homeDirectory, extraArguments) {
             CDE_INSTALL_PSTACK: '0',
             CDE_INSTALL_USAGE_WRAPUP: '0',
             CDE_INSTALL_SUBAGENT_MODELS: '0',
+            CDE_INSTALL_DEEPEN_FIRST_PROMPT: '0',
             HOME: homeDirectory,
             USERPROFILE: homeDirectory,
             GIT_CONFIG_GLOBAL: join(homeDirectory, '.gitconfig'),
@@ -93,6 +94,7 @@ function scanTextWithProductionPiiScanner(scannedText) {
                     CDE_INSTALL_PSTACK: '0',
                     CDE_INSTALL_USAGE_WRAPUP: '0',
                     CDE_INSTALL_SUBAGENT_MODELS: '0',
+                    CDE_INSTALL_DEEPEN_FIRST_PROMPT: '0',
                     PYTHONPATH: BLOCKING_HOOKS_DIRECTORY,
                     CLAUDE_LOCAL_IDENTITY_PATH: join(
                         temporaryDirectory,

package/bin/install.cursor-rules.test.mjs

@@ -35,6 +35,7 @@ function runInstaller(homeDirectory, extraArguments, environmentOverrides = {})
             CDE_INSTALL_PSTACK: '0',
             CDE_INSTALL_USAGE_WRAPUP: '0',
             CDE_INSTALL_SUBAGENT_MODELS: '0',
+            CDE_INSTALL_DEEPEN_FIRST_PROMPT: '0',
             HOME: homeDirectory,
             USERPROFILE: homeDirectory,
             CODEX_HOME: join(homeDirectory, '.codex'),
@@ -133,7 +134,12 @@ test('seeds one editable policy and one native Codex routing hook', () => {
         );
         assert.equal(firstSpawnPromptGroups.length, 1);
         assert.match(firstSpawnPromptGroups[0].hooks[0].command, /skill_loaded_reminder\.py/);
-        assert.deepEqual(Object.keys(firstCodexHooks.hooks), ['PreToolUse']);
+        assert.deepEqual(Object.keys(firstCodexHooks.hooks), ['PreToolUse', 'UserPromptSubmit']);
+        assert.ok(
+            firstCodexHooks.hooks.UserPromptSubmit.some(group =>
+                group.hooks.some(hook => String(hook.command).includes('deepen_first_prompt.py')),
+            ),
+        );
         assert.equal(
             firstCodexHooks.hooks.PreToolUse.some(group => group.matcher === 'Write|Edit|MultiEdit|apply_patch'),
             false,
@@ -291,6 +297,11 @@ test('Codex reinstall removes omitted package hooks and preserves user configura
             ['Agent|Task', 'multi_agent_v1__spawn_agent'].includes(eachGroup.matcher));
         assert.equal(allSpawnGroups.length, 2);
         migratedHooks.hooks.PreToolUse = migratedHooks.hooks.PreToolUse.filter(eachGroup => !allSpawnGroups.includes(eachGroup));
+        const allPackagePromptCommands = migratedHooks.hooks.UserPromptSubmit
+            .flatMap(eachGroup => eachGroup.hooks)
+            .map(eachHook => eachHook.command);
+        assert.ok(allPackagePromptCommands.some(eachCommand => eachCommand.includes('deepen_first_prompt.py')));
+        delete migratedHooks.hooks.UserPromptSubmit;
         assert.deepEqual(migratedHooks, { enabled: false, metadata: 'keep-file', hooks: expectedUserHooks });
         assert.equal(readFileSync(configPath, 'utf8'), disabledConfig);
         const firstInstall = readFileSync(codexHooksPath, 'utf8');
@@ -337,6 +348,32 @@ test('uninstall removes the routing hook and keeps a Codex user hook', () => {
     }
 });
 
+test('should ship the deepen skill to Cursor and the deepen block to Codex, and remove both on uninstall', () => {
+    const homeDirectory = mkdtempSync(join(tmpdir(), 'cdev-deepen-surfaces-'));
+    try {
+        const sourceSkillPath = join(PACKAGE_DIRECTORY, '.agents', 'skills', 'deepen', 'SKILL.md');
+        const cursorSkillPath = join(homeDirectory, DEFAULT_CURSOR_DIRECTORY_NAME, 'skills', 'deepen', 'SKILL.md');
+        const codexGuidancePath = join(homeDirectory, '.codex', 'AGENTS.md');
+        const manifestPath = join(homeDirectory, '.claude', '.claude-dev-env-manifest.json');
+
+        runInstaller(homeDirectory, []);
+
+        assert.equal(readFileSync(cursorSkillPath, 'utf8'), readFileSync(sourceSkillPath, 'utf8'));
+        assert.equal(JSON.parse(readFileSync(manifestPath, 'utf8')).files.includes(cursorSkillPath), true);
+        const codexGuidance = readFileSync(codexGuidancePath, 'utf8');
+        assert.match(codexGuidance, /<!-- claude-dev-env deepen: start -->/);
+        assert.match(codexGuidance, /CDE_DEEPEN:v1/);
+
+        runInstaller(homeDirectory, ['--uninstall']);
+
+        assert.equal(existsSync(cursorSkillPath), false);
+        const remainingGuidance = existsSync(codexGuidancePath) ? readFileSync(codexGuidancePath, 'utf8') : '';
+        assert.doesNotMatch(remainingGuidance, /claude-dev-env deepen/);
+    } finally {
+        rmSync(homeDirectory, { recursive: true, force: true });
+    }
+});
+
 test('malformed Codex hooks restore the staged install', () => {
     const homeDirectory = mkdtempSync(join(tmpdir(), 'cdev-routing-malformed-'));
     try {

package/bin/install.mjs

@@ -54,6 +54,7 @@ import {
 } from './install-constants.mjs';
 import {
     PSTACK_PLUGIN_SPEC,
+    DEEPEN_FIRST_PROMPT_PLUGIN_SPEC,
     SUBAGENT_MODELS_PLUGIN_SPEC,
     USAGE_WRAPUP_PLUGIN_SPEC,
     installMarketplacePlugins,
@@ -68,9 +69,11 @@ import {
     writeCodexSolSetting,
 } from './codex-trimmed-sol.mjs';
 import {
+    removeCodexDeepenGuidance,
     removeCodexPackageGuidance,
     removeCodexQuestionGuidance,
     writeCodexAgentsGuidance,
+    writeCodexDeepenGuidance,
     writeCodexPackageGuidance,
     writeCodexQuestionGuidance,
 } from './codex-skill-load-block.mjs';
@@ -223,6 +226,7 @@ export const CORE_SKILLS = [
     'issue-tracker',
     'task-build',
     'eli5',
+    'deepen',
 ];
 
 export function collectPackageSourceConflicts(packageDirectory) {
@@ -2207,12 +2211,14 @@ function mergeHooksAtPath(
 
 function selectCodexNativeHooksConfig(hooksConfig) {
     const preToolUseGroups = hooksConfig.hooks?.PreToolUse;
+    const userPromptSubmitGroups = hooksConfig.hooks?.UserPromptSubmit;
     return {
         ...hooksConfig,
         hooks: {
             PreToolUse: Array.isArray(preToolUseGroups)
                 ? preToolUseGroups.filter(group => ALL_CODEX_NATIVE_PRE_TOOL_USE_MATCHERS.has(group?.matcher))
                 : [],
+            UserPromptSubmit: Array.isArray(userPromptSubmitGroups) ? userPromptSubmitGroups : [],
         },
     };
 }
@@ -2876,6 +2882,23 @@ function executeInstallPlanMutations(plan, transactionHelpers) {
     }
     summary.skills = { created: skillsCreated, updated: skillsUpdated, pruned: 0, paths: skillPaths };
     allInstalledFiles.push(...skillPaths);
+    if (copiedSkillNames.has('deepen')) {
+        for (const sourceRoot of allSourceRoots) {
+            const deepenSourceDirectory = join(
+                resolvePackageManagedDirectory(sourceRoot, MANAGED_SKILLS_DIRECTORY_NAME),
+                'deepen',
+            );
+            if (!existsSync(deepenSourceDirectory)) continue;
+            const cursorDeepenDirectory = join(
+                INSTALL_ROOT_RESOLUTION.cursorInstallDirectory,
+                'skills',
+                'deepen',
+            );
+            const cursorSkillStats = copyTree(deepenSourceDirectory, cursorDeepenDirectory);
+            allInstalledFiles.push(...cursorSkillStats.paths);
+            break;
+        }
+    }
     if (!selectedGroups) {
         summary.retiredSessionContinuity = {
             changedPaths: removeRetiredSessionContinuityHooks(),
@@ -2915,8 +2938,11 @@ function executeInstallPlanMutations(plan, transactionHelpers) {
         }
         printPluginHostOutcomes([PSTACK_PLUGIN_SPEC], pstackPlugin);
     }
-    const allRepositoryPluginSpecs = [USAGE_WRAPUP_PLUGIN_SPEC, SUBAGENT_MODELS_PLUGIN_SPEC]
-        .filter(eachSpec => shouldInstallMarketplacePlugin(eachSpec));
+    const allRepositoryPluginSpecs = [
+        USAGE_WRAPUP_PLUGIN_SPEC,
+        SUBAGENT_MODELS_PLUGIN_SPEC,
+        DEEPEN_FIRST_PROMPT_PLUGIN_SPEC,
+    ].filter(eachSpec => shouldInstallMarketplacePlugin(eachSpec));
     if (!selectedGroups && allRepositoryPluginSpecs.length > 0) {
         const repositoryPlugins = installMarketplacePlugins(allRepositoryPluginSpecs, {
             claudeRoot: CLAUDE_HOME,
@@ -2939,6 +2965,10 @@ function executeInstallPlanMutations(plan, transactionHelpers) {
             readFileSync(join(PACKAGE_ROOT, 'rules', 'question-presentation.md'), 'utf8'),
         );
         if (questionGuidancePath) allCodexGuidancePaths.push(questionGuidancePath);
+        const deepenGuidancePath = writeCodexDeepenGuidance(
+            INSTALL_ROOT_RESOLUTION.codexHomeDirectory,
+        );
+        if (deepenGuidancePath) allCodexGuidancePaths.push(deepenGuidancePath);
         const solSettingPath = writeCodexSolSetting(
             INSTALL_ROOT_RESOLUTION.codexHomeDirectory,
             join(CLAUDE_HOME, SOL_PROMPT_DIRECTORY_NAME, SOL_PROMPT_FILE_NAME),
@@ -3307,6 +3337,7 @@ function executeUninstallPlan(plan, helpers = {}) {
     }
     removeCodexPackageGuidance(INSTALL_ROOT_RESOLUTION.codexHomeDirectory);
     removeCodexQuestionGuidance(INSTALL_ROOT_RESOLUTION.codexHomeDirectory);
+    removeCodexDeepenGuidance(INSTALL_ROOT_RESOLUTION.codexHomeDirectory);
     removeCodexSolSetting(INSTALL_ROOT_RESOLUTION.codexHomeDirectory);
     throwIfFault(FAULT_PHASES.AFTER_FILE_STAGING);
 
@@ -3455,6 +3486,7 @@ Usage:
   npx ${PACKAGE_NAME} --no-pstack  Full install without the pstack plugin (also CDE_INSTALL_PSTACK=0)
   npx ${PACKAGE_NAME} --no-usage-wrapup  Full install without the usage-wrapup plugin (also CDE_INSTALL_USAGE_WRAPUP=0)
   npx ${PACKAGE_NAME} --no-subagent-models  Full install without the subagent-models plugin (also CDE_INSTALL_SUBAGENT_MODELS=0)
+  npx ${PACKAGE_NAME} --no-deepen-first-prompt  Full install without the deepen-first-prompt plugin (also CDE_INSTALL_DEEPEN_FIRST_PROMPT=0)
   npx ${PACKAGE_NAME} --uninstall  Remove installed files from the selected root
   npx ${PACKAGE_NAME} --help       Show this help
 

package/bin/install.prompt-context.test.mjs

@@ -35,9 +35,11 @@ test('reinstall drops the retired style reminder and keeps one skill reminder ho
     mergeHooksIntoSettings(settings, hooksConfig, 'C:/Users/example/.claude', 'python');
 
     const userPromptHooks = settings.hooks.UserPromptSubmit.flatMap(eachGroup => eachGroup.hooks);
-    assert.equal(userPromptHooks.length, 2);
+    assert.equal(userPromptHooks.length, 4);
     assert.equal(userPromptHooks[0].command, userCommand);
     assert.match(userPromptHooks[1].command, /session\/skill_loaded_reminder\.py$/);
+    assert.match(userPromptHooks[2].command, /session\/deepen_first_prompt\.py$/);
+    assert.match(userPromptHooks[3].command, /lifecycle\/nested_project_hooks\.py$/);
     assert.ok(userPromptHooks.every(eachHook => !eachHook.command.includes('style_reminder_prompt')));
 
     const firstMerge = JSON.stringify(settings);

package/bin/install.prune.test.mjs

@@ -264,6 +264,7 @@ function resolveInstallerInvocation(homeDirectory) {
         CDE_INSTALL_PSTACK: '0',
         CDE_INSTALL_USAGE_WRAPUP: '0',
         CDE_INSTALL_SUBAGENT_MODELS: '0',
+        CDE_INSTALL_DEEPEN_FIRST_PROMPT: '0',
         HOME: homeDirectory,
         USERPROFILE: homeDirectory,
         GIT_CONFIG_GLOBAL: join(homeDirectory, '.gitconfig'),

package/bin/install.question-presentation.test.mjs

@@ -27,6 +27,7 @@ function installInScratchHome(homeDirectory, argumentsList = [], extraEnvironmen
             CDE_INSTALL_PSTACK: '0',
             CDE_INSTALL_USAGE_WRAPUP: '0',
             CDE_INSTALL_SUBAGENT_MODELS: '0',
+            CDE_INSTALL_DEEPEN_FIRST_PROMPT: '0',
             HOME: homeDirectory,
             USERPROFILE: homeDirectory,
             CODEX_HOME: join(homeDirectory, '.codex'),
@@ -183,6 +184,7 @@ test('a successful pstack install retains its skill block and gains the question
         CDE_INSTALL_PSTACK: '1',
         CDE_INSTALL_USAGE_WRAPUP: '0',
         CDE_INSTALL_SUBAGENT_MODELS: '0',
+        CDE_INSTALL_DEEPEN_FIRST_PROMPT: '0',
         CDE_CODEX_EXECUTABLE: commandPath,
         CDE_CLAUDE_EXECUTABLE: commandPath,
     });
@@ -211,6 +213,7 @@ test('enabling pstack after a pstack-off install preserves question guidance', (
         CDE_INSTALL_PSTACK: '1',
         CDE_INSTALL_USAGE_WRAPUP: '0',
         CDE_INSTALL_SUBAGENT_MODELS: '0',
+        CDE_INSTALL_DEEPEN_FIRST_PROMPT: '0',
         CDE_CODEX_EXECUTABLE: commandPath,
         CDE_CLAUDE_EXECUTABLE: commandPath,
     });
@@ -240,6 +243,7 @@ test('a failed pstack transition restores question-only guidance and removes its
         CDE_INSTALL_PSTACK: '1',
         CDE_INSTALL_USAGE_WRAPUP: '0',
         CDE_INSTALL_SUBAGENT_MODELS: '0',
+        CDE_INSTALL_DEEPEN_FIRST_PROMPT: '0',
         CDE_CODEX_EXECUTABLE: commandPath,
         CDE_CLAUDE_EXECUTABLE: commandPath,
         CLAUDE_DEV_ENV_INSTALL_FAULT: 'after_file_staging',

package/bin/install.settings-defaults.test.mjs

@@ -65,6 +65,7 @@ function runInstallerInSandbox(sandboxHome, installerArguments = []) {
             CDE_INSTALL_PSTACK: '0',
             CDE_INSTALL_USAGE_WRAPUP: '0',
             CDE_INSTALL_SUBAGENT_MODELS: '0',
+            CDE_INSTALL_DEEPEN_FIRST_PROMPT: '0',
             HOME: sandboxHome,
             USERPROFILE: sandboxHome,
             GIT_CONFIG_GLOBAL: gitConfigGlobal,

package/bin/install.shared-settings.test.mjs

@@ -33,6 +33,7 @@ function installEnvironment(homeDirectory) {
         CDE_INSTALL_PSTACK: '0',
         CDE_INSTALL_USAGE_WRAPUP: '0',
         CDE_INSTALL_SUBAGENT_MODELS: '0',
+        CDE_INSTALL_DEEPEN_FIRST_PROMPT: '0',
     };
 }
 

package/bin/install.test.mjs

@@ -257,6 +257,11 @@ test('CORE_SKILLS ships ELI5 as the leaf presentation skill', () => {
     assert.equal(INSTALL_GROUPS.core.skills.includes('eli5'), true);
 });
 
+test('CORE_SKILLS ships deepen so the first-task skill installs with core', () => {
+    assert.ok(CORE_SKILLS.includes('deepen'), 'deepen must be in CORE_SKILLS');
+    assert.equal(INSTALL_GROUPS.core.skills.includes('deepen'), true);
+});
+
 test('CORE_SKILLS ships test-runner for explicit Django and Playwright readiness checks', () => {
     assert.ok(CORE_SKILLS.includes('test-runner'));
     assert.equal(INSTALL_GROUPS.core.skills.includes('test-runner'), true);
@@ -3037,6 +3042,7 @@ test('a failed update preserves an existing skills lookup pointer', () => {
             CDE_INSTALL_PSTACK: '0',
             CDE_INSTALL_USAGE_WRAPUP: '0',
             CDE_INSTALL_SUBAGENT_MODELS: '0',
+            CDE_INSTALL_DEEPEN_FIRST_PROMPT: '0',
         };
         const argumentsForCoreInstall = [PSTACK_TEST_INSTALLER_PATH, '--only', 'core'];
         const firstRun = spawnSync(process.execPath, argumentsForCoreInstall, {
@@ -3090,6 +3096,7 @@ function runPstackInstaller(homeDirectory, extraArguments, environmentOverrides
             CDE_INSTALL_PSTACK: '1',
             CDE_INSTALL_USAGE_WRAPUP: '0',
             CDE_INSTALL_SUBAGENT_MODELS: '0',
+            CDE_INSTALL_DEEPEN_FIRST_PROMPT: '0',
             ...environmentOverrides,
         },
     });
@@ -3402,15 +3409,18 @@ test('the help output names the usage-wrapup opt-out beside the pstack one', ()
 
     assert.equal(helpRun.status, 0, helpRun.stderr);
     assert.match(helpRun.stdout, /--no-pstack .*\n.*--no-usage-wrapup .*CDE_INSTALL_USAGE_WRAPUP=0/);
+    assert.match(helpRun.stdout, /--no-deepen-first-prompt .*CDE_INSTALL_DEEPEN_FIRST_PROMPT=0/);
 });
 
 const REPOSITORY_PLUGIN_CLAUDE_COMMANDS = Object.freeze([
     'claude plugin uninstall usage-wrapup@claude-dev-env',
     'claude plugin uninstall subagent-models@claude-dev-env',
+    'claude plugin uninstall deepen-first-prompt@claude-dev-env',
     'claude plugin marketplace remove claude-dev-env',
-    'claude plugin marketplace add jl-cmd-projects/claude-dev-env --sparse .claude-plugin packages/usage-wrapup packages/subagent-models',
+    'claude plugin marketplace add jl-cmd-projects/claude-dev-env --sparse .claude-plugin packages/usage-wrapup packages/subagent-models packages/deepen-first-prompt',
     'claude plugin install usage-wrapup@claude-dev-env',
     'claude plugin install subagent-models@claude-dev-env',
+    'claude plugin install deepen-first-prompt@claude-dev-env',
 ]);
 
 test('should install subagent-models beside usage-wrapup with one marketplace add on a full install', t => {
@@ -3420,11 +3430,13 @@ test('should install subagent-models beside usage-wrapup with one marketplace ad
         ...sandbox.environment,
         CDE_INSTALL_USAGE_WRAPUP: '1',
         CDE_INSTALL_SUBAGENT_MODELS: '1',
+        CDE_INSTALL_DEEPEN_FIRST_PROMPT: '1',
     });
 
     assert.deepEqual(usageWrapupCommands(sandbox.recordedCommands()), REPOSITORY_PLUGIN_CLAUDE_COMMANDS);
     assert.match(installerOutput, /Usage-wrapup \(claude\): installed/);
     assert.match(installerOutput, /Subagent-models \(claude\): installed/);
+    assert.match(installerOutput, /Deepen-first-prompt \(claude\): installed/);
 });
 
 for (const [caseName, extraArguments, environmentOverrides] of [
@@ -3448,6 +3460,27 @@ for (const [caseName, extraArguments, environmentOverrides] of [
     });
 }
 
+for (const [caseName, extraArguments, environmentOverrides] of [
+    ['--no-deepen-first-prompt', ['--no-deepen-first-prompt'], { CDE_INSTALL_DEEPEN_FIRST_PROMPT: '1' }],
+    ['CDE_INSTALL_DEEPEN_FIRST_PROMPT=0', [], { CDE_INSTALL_DEEPEN_FIRST_PROMPT: '0' }],
+    ['an --only run', ['--only', 'core'], { CDE_INSTALL_DEEPEN_FIRST_PROMPT: '1' }],
+]) {
+    test(`should skip deepen-first-prompt on ${caseName}`, t => {
+        const sandbox = pstackPluginSandbox(t);
+
+        const installerOutput = runPstackInstaller(sandbox.homeDirectory, extraArguments, {
+            ...sandbox.environment,
+            ...environmentOverrides,
+        });
+
+        assert.equal(
+            sandbox.recordedCommands().some(eachCommand => eachCommand.includes('deepen-first-prompt')),
+            false,
+        );
+        assert.doesNotMatch(installerOutput, /Deepen-first-prompt \(/);
+    });
+}
+
 test('should name the subagent-models opt-out in the help output', () => {
     const helpRun = spawnSync(process.execPath, [PSTACK_TEST_INSTALLER_PATH, '--help'], {
         encoding: 'utf8',

package/bin/install.transaction.test.mjs

@@ -90,6 +90,7 @@ test('capture and restore recover settings, manifest, files, and hooksPath', ()
         CDE_INSTALL_PSTACK: '0',
         CDE_INSTALL_USAGE_WRAPUP: '0',
         CDE_INSTALL_SUBAGENT_MODELS: '0',
+        CDE_INSTALL_DEEPEN_FIRST_PROMPT: '0',
         HOME: box.root,
         USERPROFILE: box.root,
         GIT_CONFIG_GLOBAL: gitConfigPath,
@@ -155,6 +156,7 @@ test('capture and restore recover an additional host settings file', () => {
             CDE_INSTALL_PSTACK: '0',
             CDE_INSTALL_USAGE_WRAPUP: '0',
             CDE_INSTALL_SUBAGENT_MODELS: '0',
+            CDE_INSTALL_DEEPEN_FIRST_PROMPT: '0',
             HOME: box.root,
             USERPROFILE: box.root,
             GIT_CONFIG_GLOBAL: gitConfigPath,
@@ -193,6 +195,7 @@ test('runWithInstallTransaction restores prior state on injected fault', () => {
         CDE_INSTALL_PSTACK: '0',
         CDE_INSTALL_USAGE_WRAPUP: '0',
         CDE_INSTALL_SUBAGENT_MODELS: '0',
+        CDE_INSTALL_DEEPEN_FIRST_PROMPT: '0',
         HOME: box.root,
         USERPROFILE: box.root,
         GIT_CONFIG_GLOBAL: gitConfigPath,
@@ -250,6 +253,7 @@ test('runWithInstallTransaction commits and discards journal on success', () =>
             CDE_INSTALL_PSTACK: '0',
             CDE_INSTALL_USAGE_WRAPUP: '0',
             CDE_INSTALL_SUBAGENT_MODELS: '0',
+            CDE_INSTALL_DEEPEN_FIRST_PROMPT: '0',
             HOME: box.root,
             USERPROFILE: box.root,
             GIT_CONFIG_GLOBAL: gitConfigPath,
@@ -296,6 +300,7 @@ function runInstaller(homeDirectory, extraArguments, options = {}) {
         CDE_INSTALL_PSTACK: '0',
         CDE_INSTALL_USAGE_WRAPUP: '0',
         CDE_INSTALL_SUBAGENT_MODELS: '0',
+        CDE_INSTALL_DEEPEN_FIRST_PROMPT: '0',
         HOME: homeDirectory,
         USERPROFILE: homeDirectory,
         GIT_CONFIG_GLOBAL: join(homeDirectory, '.gitconfig'),
@@ -332,6 +337,7 @@ test('a later install fault removes newly seeded Codex pstack files', () => {
                 CDE_INSTALL_PSTACK: '1',
                 CDE_INSTALL_USAGE_WRAPUP: '0',
                 CDE_INSTALL_SUBAGENT_MODELS: '0',
+                CDE_INSTALL_DEEPEN_FIRST_PROMPT: '0',
                 CDE_CODEX_EXECUTABLE: codexCommandPath,
             },
         });
@@ -478,6 +484,7 @@ test('installer fault after_git_config restores prior core.hooksPath', () => {
                 CDE_INSTALL_PSTACK: '0',
                 CDE_INSTALL_USAGE_WRAPUP: '0',
                 CDE_INSTALL_SUBAGENT_MODELS: '0',
+                CDE_INSTALL_DEEPEN_FIRST_PROMPT: '0',
                 HOME: homeDirectory,
                 USERPROFILE: homeDirectory,
                 GIT_CONFIG_GLOBAL: gitConfigPath,
@@ -498,6 +505,7 @@ test('installer fault after_git_config restores prior core.hooksPath', () => {
                 CDE_INSTALL_PSTACK: '0',
                 CDE_INSTALL_USAGE_WRAPUP: '0',
                 CDE_INSTALL_SUBAGENT_MODELS: '0',
+                CDE_INSTALL_DEEPEN_FIRST_PROMPT: '0',
                 HOME: homeDirectory,
                 USERPROFILE: homeDirectory,
                 GIT_CONFIG_GLOBAL: gitConfigPath,