theslopmachine 0.7.0 → 0.7.2

package/assets/slopmachine/utils/claude_live_common.mjs

@@ -8,7 +8,7 @@ import crypto from 'node:crypto'
 import { fileURLToPath } from 'node:url'
 import { spawn } from 'node:child_process'
 
-import { emitFailure, emitSuccess, parseArgs, readJsonFile, readPrompt, sleep, waitForRateLimitReset, writeFileIfNeeded, writeJsonIfNeeded } from './claude_worker_common.mjs'
+import { emitFailure, emitSuccess, extractRateLimitMetadata, parseArgs, readJsonFile, readPrompt, sleep, waitForRateLimitReset, writeFileIfNeeded, writeJsonIfNeeded } from './claude_worker_common.mjs'
 
 export { emitFailure, emitSuccess, parseArgs, readPrompt, sleep, waitForRateLimitReset, writeJsonIfNeeded }
 
@@ -279,7 +279,7 @@ export function buildMcpConfig({ paths, utilsDir, channelName, lane, port, token
   }
 }
 
-export function buildClaudeLaunchCommand({ claudeCommand, agentName, displayName, settingsFile, mcpConfigFile, channelName, model }) {
+export function buildClaudeLaunchCommand({ claudeCommand, agentName, displayName, settingsFile, mcpConfigFile, channelName, model, effort = null }) {
   const parts = [
     shellQuote(claudeCommand),
     '--agent',
@@ -299,6 +299,10 @@ export function buildClaudeLaunchCommand({ claudeCommand, agentName, displayName
     parts.push('--model', shellQuote(model))
   }
 
+  if (effort) {
+    parts.push('--effort', shellQuote(effort))
+  }
+
   return parts.join(' ')
 }
 
@@ -382,10 +386,11 @@ export function classifyStopFailure(event, fallbackSid = null) {
   const payload = event?.payload || null
   const sid = payload?.session_id || fallbackSid || null
   const message = extractFailureMessage(payload) || 'claude_stop_failure'
+  const rateLimit = extractRateLimitMetadata(payload)
 
   if (/hit your limit|usage limit|capacity|overloaded/i.test(message)) {
     return {
-      result: { ok: false, code: 'claude_usage_limit', msg: 'usage_limit', detail: message, sid },
+      result: { ok: false, code: 'claude_usage_limit', msg: 'usage_limit', detail: message, rate_limit: rateLimit, sid },
       nextStatus: 'blocked',
     }
   }

package/assets/slopmachine/utils/claude_live_launch.mjs

@@ -36,6 +36,9 @@ const cwd = argv.cwd ? path.resolve(argv.cwd) : null
 const lane = argv.lane
 const agentName = argv.agent || 'developer'
 const claudeCommand = argv['claude-command'] || 'claude'
+const laneModel = argv.model || 'sonnet'
+const laneEffort = argv.effort || null
+const subagentModel = argv['subagent-model'] || 'sonnet'
 const launchTimeoutMs = Number.parseInt(argv['timeout-ms'] || String(DEFAULT_LAUNCH_TIMEOUT_MS), 10)
 const replace = argv.replace === '1'
 
@@ -85,7 +88,9 @@ try {
     cwd,
     sid: null,
     agent_name: agentName,
-    model: argv.model || null,
+    model: laneModel,
+    effort: laneEffort,
+    subagent_model: subagentModel,
     tmux_session: tmuxSession,
     channel_name: channelName,
     channel_port: channelPort,
@@ -110,7 +115,7 @@ try {
       runtimeDir: paths.runtimeDir,
       utilsDir,
       agentName,
-      subagentModel: argv.model || 'sonnet',
+      subagentModel,
     })),
     writeJsonIfNeeded(paths.mcpConfigFile, buildMcpConfig({
       paths,
@@ -129,7 +134,8 @@ try {
     settingsFile: paths.settingsFile,
     mcpConfigFile: paths.mcpConfigFile,
     channelName,
-    model: argv.model || null,
+    model: laneModel,
+    effort: laneEffort,
   })
 
   const launchResult = await runCommand('tmux', ['new-session', '-d', '-s', tmuxSession, '-c', cwd, launchCommand])

package/assets/slopmachine/utils/claude_live_stop.mjs

@@ -34,6 +34,7 @@ await writeState(runtimeDir, {
   status: 'stopped',
   current_turn_id: null,
   current_turn_prompt_file: null,
+  current_turn_prompt_source: null,
   current_turn_started_at: null,
   last_error: null,
   stopped_at: new Date().toISOString(),

package/assets/slopmachine/utils/claude_live_turn.mjs

@@ -1,7 +1,5 @@
 #!/usr/bin/env node
 
-import path from 'node:path'
-
 import {
   DEFAULT_TURN_TIMEOUT_MS,
   buildFailureResult,
@@ -13,7 +11,7 @@ import {
   postPromptToChannel,
   parseArgs,
   readJsonl,
-  readPrompt,
+  readPromptInput,
   readState,
   tmuxHasSession,
   waitForRateLimitReset,
@@ -25,11 +23,11 @@ import {
 
 const argv = parseArgs(process.argv.slice(2))
 const runtimeDir = argv['runtime-dir']
-const promptFile = argv['prompt-file']
 const turnTimeoutMs = Number.parseInt(argv['timeout-ms'] || String(DEFAULT_TURN_TIMEOUT_MS), 10)
 const retryOnLimit = argv['retry-on-limit'] !== '0'
+const hasPromptInput = Boolean(argv['prompt-file'] || Object.hasOwn(argv, 'prompt') || argv['prompt-stdin'] === '1' || process.stdin.isTTY === false)
 
-if (!runtimeDir || !promptFile) {
+if (!runtimeDir || !hasPromptInput) {
   emitFailure('claude_live_turn_invalid_args', 'Missing required turn arguments', {
     state_file: runtimeDir ? buildRuntimePaths(runtimeDir).stateFile : null,
   })
@@ -37,6 +35,7 @@ if (!runtimeDir || !promptFile) {
 }
 
 const paths = buildRuntimePaths(runtimeDir)
+let prompt = ''
 
 function emitTurnFailure(resultPayload) {
   emitFailure(resultPayload.code, resultPayload.msg, {
@@ -47,6 +46,9 @@ function emitTurnFailure(resultPayload) {
 }
 
 try {
+  let promptSource = null
+  let promptSourceKind = null
+
   const state = await readState(runtimeDir)
   if (!state) {
     const resultPayload = buildFailureResult('claude_live_turn_uninitialized', 'Claude live lane is not initialized')
@@ -76,7 +78,7 @@ try {
     process.exit(1)
   }
 
-  const prompt = await readPrompt(promptFile)
+  ({ prompt, promptSource, promptSourceKind } = await readPromptInput(argv))
   let hookStartIndex = (await readJsonl(paths.hookEventsFile)).length
   const turnNumber = Number(state.last_turn_number || 0)
   const turnId = buildTurnId(turnNumber)
@@ -84,7 +86,8 @@ try {
   await writeState(runtimeDir, {
     status: 'running',
     current_turn_id: turnId,
-    current_turn_prompt_file: path.resolve(promptFile),
+    current_turn_prompt_file: promptSourceKind === 'file' && promptSource ? promptSource : null,
+    current_turn_prompt_source: promptSource,
     current_turn_started_at: new Date().toISOString(),
     last_error: null,
   })
@@ -107,6 +110,7 @@ try {
         status: 'failed',
         current_turn_id: null,
         current_turn_prompt_file: null,
+        current_turn_prompt_source: null,
         current_turn_started_at: null,
         last_completed_turn_id: turnId,
         last_turn_number: turnNumber + 1,
@@ -116,6 +120,9 @@ try {
         rate_limit_wait_ms: null,
         rate_limit_wait_source: null,
         rate_limit_message: null,
+        rate_limit_reset_at: null,
+        rate_limit_type: null,
+        rate_limit_raw_reset_at: null,
       })
       emitTurnFailure(resultPayload)
       process.exit(1)
@@ -138,6 +145,7 @@ try {
         transcript_path: event.payload?.transcript_path || liveState.transcript_path || state.transcript_path || null,
         current_turn_id: null,
         current_turn_prompt_file: null,
+        current_turn_prompt_source: null,
         current_turn_started_at: null,
         last_completed_turn_id: turnId,
         last_hook_event: 'Stop',
@@ -149,6 +157,9 @@ try {
         rate_limit_wait_ms: null,
         rate_limit_wait_source: null,
         rate_limit_message: null,
+        rate_limit_reset_at: null,
+        rate_limit_type: null,
+        rate_limit_raw_reset_at: null,
       })
       emitSuccess(sessionId, {
         result_file: argv['result-file'] || paths.resultFile,
@@ -168,6 +179,9 @@ try {
       })
       await waitForRateLimitReset({
         message: resultPayload.detail || resultPayload.msg,
+        resetAt: resultPayload.rate_limit?.resetAt || null,
+        rateLimitType: resultPayload.rate_limit?.rateLimitType || null,
+        rawResetAt: resultPayload.rate_limit?.rawResetAt ?? null,
         statePath: paths.stateFile,
       })
 
@@ -178,6 +192,7 @@ try {
           status: 'failed',
           current_turn_id: null,
           current_turn_prompt_file: null,
+          current_turn_prompt_source: null,
           current_turn_started_at: null,
           last_completed_turn_id: turnId,
           last_turn_number: turnNumber + 1,
@@ -187,6 +202,9 @@ try {
           rate_limit_wait_ms: null,
           rate_limit_wait_source: null,
           rate_limit_message: null,
+          rate_limit_reset_at: null,
+          rate_limit_type: null,
+          rate_limit_raw_reset_at: null,
         })
         emitTurnFailure(deadPayload)
         process.exit(1)
@@ -195,7 +213,8 @@ try {
       await writeState(runtimeDir, {
         status: 'running',
         current_turn_id: turnId,
-        current_turn_prompt_file: path.resolve(promptFile),
+        current_turn_prompt_file: promptSourceKind === 'file' && promptSource ? promptSource : null,
+        current_turn_prompt_source: promptSource,
         current_turn_started_at: new Date().toISOString(),
         last_error: null,
       })
@@ -209,6 +228,7 @@ try {
       transcript_path: event.payload?.transcript_path || liveState.transcript_path || state.transcript_path || null,
       current_turn_id: null,
       current_turn_prompt_file: null,
+      current_turn_prompt_source: null,
       current_turn_started_at: null,
       last_completed_turn_id: turnId,
       last_hook_event: 'StopFailure',
@@ -219,6 +239,9 @@ try {
       rate_limit_wait_ms: null,
       rate_limit_wait_source: null,
       rate_limit_message: null,
+      rate_limit_reset_at: null,
+      rate_limit_type: null,
+      rate_limit_raw_reset_at: null,
     })
     emitTurnFailure(resultPayload)
     process.exit(1)
@@ -229,12 +252,13 @@ try {
   const resultPayload = buildFailureResult(code, error instanceof Error ? error.message : String(error), state?.sid || null)
   const turnNumber = Number(state?.last_turn_number || 0)
   const turnId = buildTurnId(turnNumber)
-  const prompt = await readPrompt(promptFile).catch(() => '')
-  await writeTurnArtifacts(paths, turnId, prompt, resultPayload, argv['result-file'] || null)
+  const promptForArtifacts = prompt || await readPromptInput(argv).then((value) => value.prompt).catch(() => '')
+  await writeTurnArtifacts(paths, turnId, promptForArtifacts, resultPayload, argv['result-file'] || null)
   await writeState(runtimeDir, {
     status: 'failed',
     current_turn_id: null,
     current_turn_prompt_file: null,
+    current_turn_prompt_source: null,
     current_turn_started_at: null,
     last_completed_turn_id: turnId,
     last_turn_number: turnNumber + 1,
@@ -244,6 +268,9 @@ try {
     rate_limit_wait_ms: null,
     rate_limit_wait_source: null,
     rate_limit_message: null,
+    rate_limit_reset_at: null,
+    rate_limit_type: null,
+    rate_limit_raw_reset_at: null,
   })
   emitTurnFailure(resultPayload)
   process.exit(1)

package/assets/slopmachine/utils/claude_resume_session.mjs

@@ -1,11 +1,11 @@
 #!/usr/bin/env node
 
-import { parseArgs, readPrompt, buildResumeArgs, emitFailure, emitSuccess, compactClaudeResult, runClaudeWithRetry, writeJsonIfNeeded } from './claude_worker_common.mjs'
+import { parseArgs, readPromptInput, buildResumeArgs, emitFailure, emitSuccess, compactClaudeResult, runClaudeWithRetry, writeJsonIfNeeded } from './claude_worker_common.mjs'
 
 const argv = parseArgs(process.argv.slice(2))
 
 try {
-  const prompt = await readPrompt(argv['prompt-file'])
+  const { prompt } = await readPromptInput(argv)
   const { parsed, failure } = await runClaudeWithRetry({
     claudeCommand: argv['claude-command'] || 'claude',
     cwd: argv.cwd,

package/assets/slopmachine/utils/claude_worker_common.mjs

@@ -16,6 +16,33 @@ function utilsDir() {
   return path.dirname(fileURLToPath(import.meta.url))
 }
 
+function normalizeResetAtCandidate(value) {
+  if (value === null || value === undefined || value === '') {
+    return null
+  }
+
+  if (typeof value === 'number' && Number.isFinite(value)) {
+    const ms = value > 1_000_000_000_000 ? value : value * 1000
+    return new Date(ms)
+  }
+
+  if (typeof value === 'string') {
+    const trimmed = value.trim()
+    if (!trimmed) {
+      return null
+    }
+    if (/^\d+$/.test(trimmed)) {
+      return normalizeResetAtCandidate(Number(trimmed))
+    }
+    const parsed = Date.parse(trimmed)
+    if (!Number.isNaN(parsed)) {
+      return new Date(parsed)
+    }
+  }
+
+  return null
+}
+
 export function parseArgs(argv) {
   const result = {}
   for (let index = 0; index < argv.length; index += 1) {
@@ -66,6 +93,50 @@ export async function readPrompt(promptFile) {
   return content.trim()
 }
 
+async function readPromptFromStdin() {
+  const chunks = []
+  for await (const chunk of process.stdin) {
+    chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk))
+  }
+  return Buffer.concat(chunks).toString('utf8').trim()
+}
+
+export async function readPromptInput(argv) {
+  const hasPromptFile = typeof argv['prompt-file'] === 'string' && argv['prompt-file'].trim().length > 0
+  const hasPromptInline = typeof argv.prompt === 'string'
+  const hasPromptStdin = argv['prompt-stdin'] === '1' || process.stdin.isTTY === false
+
+  if (hasPromptStdin) {
+    return {
+      prompt: await readPromptFromStdin(),
+      promptSource: 'stdin',
+      promptSourceKind: 'stdin',
+    }
+  }
+
+  if (hasPromptFile && hasPromptInline) {
+    throw new Error('Prompt input is ambiguous: provide only one of legacy fallback inputs --prompt-file or --prompt when stdin is not used')
+  }
+
+  if (hasPromptFile) {
+    return {
+      prompt: await readPrompt(argv['prompt-file']),
+      promptSource: path.resolve(argv['prompt-file']),
+      promptSourceKind: 'file',
+    }
+  }
+
+  if (hasPromptInline) {
+    return {
+      prompt: String(argv.prompt).trim(),
+      promptSource: 'inline',
+      promptSourceKind: 'inline',
+    }
+  }
+
+  throw new Error('Missing prompt input: pipe prompt text through stdin (preferred) or use legacy fallback --prompt-file <file> / --prompt <text>')
+}
+
 export async function resolveClaudeSessionPath(sessionId, cwd) {
   const projectsRoot = path.join(os.homedir(), '.claude', 'projects')
   const directKey = cwd.replaceAll(path.sep, '-')
@@ -278,6 +349,47 @@ export function classifyClaudeFailure(parsed, fallbackMessage = '') {
   }
 }
 
+export function extractRateLimitMetadata(payload = null) {
+  if (!payload || typeof payload !== 'object') {
+    return null
+  }
+
+  const info = payload.rate_limit_info && typeof payload.rate_limit_info === 'object'
+    ? payload.rate_limit_info
+    : payload.rateLimitInfo && typeof payload.rateLimitInfo === 'object'
+      ? payload.rateLimitInfo
+      : payload.rateLimit && typeof payload.rateLimit === 'object'
+        ? payload.rateLimit
+        : null
+
+  const rawResetAt =
+    info?.resetsAt
+    ?? info?.resetAt
+    ?? payload.resetsAt
+    ?? payload.resetAt
+    ?? payload.rate_limit_reset_at
+    ?? payload.limit_reset_at
+    ?? null
+
+  const normalizedResetAt = normalizeResetAtCandidate(rawResetAt)
+  const rateLimitType =
+    info?.rateLimitType
+    ?? info?.type
+    ?? payload.rateLimitType
+    ?? payload.rate_limit_type
+    ?? null
+
+  if (!normalizedResetAt && !rateLimitType && rawResetAt === null) {
+    return null
+  }
+
+  return {
+    resetAt: normalizedResetAt ? normalizedResetAt.toISOString() : null,
+    rawResetAt,
+    rateLimitType,
+  }
+}
+
 function normalizeOffset(token) {
   if (!token) return null
   const normalized = token.trim().toUpperCase()
@@ -399,7 +511,19 @@ function parseAbsoluteCandidate(candidate, now) {
   return parseTimeOnlyCandidate(cleaned, now)
 }
 
-export function calculateRateLimitReset({ message, now = new Date(), bufferMs = DEFAULT_RATE_LIMIT_BUFFER_MS } = {}) {
+export function calculateRateLimitReset({ message, resetAt = null, rateLimitType = null, rawResetAt = null, now = new Date(), bufferMs = DEFAULT_RATE_LIMIT_BUFFER_MS } = {}) {
+  const explicitResetAt = normalizeResetAtCandidate(resetAt)
+  if (explicitResetAt) {
+    return {
+      waitMs: Math.max(explicitResetAt.getTime() - now.getTime() + bufferMs, 0),
+      resetAt: explicitResetAt,
+      source: 'structured_reset_at',
+      rawMessage: String(message || '').trim(),
+      rateLimitType: rateLimitType || null,
+      rawResetAt,
+    }
+  }
+
   const rawMessage = String(message || '').trim()
   if (!rawMessage) {
     const fallbackMs = msUntilNextQuotaReset(now)
@@ -408,6 +532,8 @@ export function calculateRateLimitReset({ message, now = new Date(), bufferMs =
       resetAt: new Date(now.getTime() + fallbackMs),
       source: 'fallback_default_quota_window',
       rawMessage,
+      rateLimitType: rateLimitType || null,
+      rawResetAt,
     }
   }
 
@@ -418,6 +544,8 @@ export function calculateRateLimitReset({ message, now = new Date(), bufferMs =
       resetAt: relative,
       source: 'relative_duration',
       rawMessage,
+      rateLimitType: rateLimitType || null,
+      rawResetAt,
     }
   }
 
@@ -430,6 +558,8 @@ export function calculateRateLimitReset({ message, now = new Date(), bufferMs =
         resetAt: parsed,
         source: 'anchored_phrase',
         rawMessage,
+        rateLimitType: rateLimitType || null,
+        rawResetAt,
       }
     }
   }
@@ -443,6 +573,8 @@ export function calculateRateLimitReset({ message, now = new Date(), bufferMs =
         resetAt: parsed,
         source: 'iso_datetime',
         rawMessage,
+        rateLimitType: rateLimitType || null,
+        rawResetAt,
       }
     }
   }
@@ -453,11 +585,13 @@ export function calculateRateLimitReset({ message, now = new Date(), bufferMs =
     resetAt: new Date(now.getTime() + fallbackMs),
     source: 'fallback_default_quota_window',
     rawMessage,
+    rateLimitType: rateLimitType || null,
+    rawResetAt,
   }
 }
 
-export async function waitForRateLimitReset({ message, statePath = null, dryRun = false, bufferMs = DEFAULT_RATE_LIMIT_BUFFER_MS } = {}) {
-  const waitInfo = calculateRateLimitReset({ message, bufferMs })
+export async function waitForRateLimitReset({ message, resetAt = null, rateLimitType = null, rawResetAt = null, statePath = null, dryRun = false, bufferMs = DEFAULT_RATE_LIMIT_BUFFER_MS } = {}) {
+  const waitInfo = calculateRateLimitReset({ message, resetAt, rateLimitType, rawResetAt, bufferMs })
   if (statePath) {
     const existing = (await readJsonIfExists(statePath)) || {}
     await writeJsonIfNeeded(statePath, {
@@ -468,6 +602,9 @@ export async function waitForRateLimitReset({ message, statePath = null, dryRun
       rate_limit_wait_ms: waitInfo.waitMs,
       rate_limit_wait_source: waitInfo.source,
       rate_limit_message: waitInfo.rawMessage || null,
+      rate_limit_reset_at: waitInfo.resetAt.toISOString(),
+      rate_limit_type: waitInfo.rateLimitType || null,
+      rate_limit_raw_reset_at: waitInfo.rawResetAt ?? null,
     })
   }
   if (!dryRun && waitInfo.waitMs > 0) {

package/assets/slopmachine/utils/package_claude_session.mjs

@@ -1,6 +1,7 @@
 #!/usr/bin/env node
 
 import fs from 'node:fs/promises'
+import os from 'node:os'
 import path from 'node:path'
 import { spawn } from 'node:child_process'
 
@@ -73,6 +74,23 @@ async function createZipArchive(sourceDir, outputPath) {
   }
 }
 
+async function normalizeClaudeJsonlFiles(projectDir) {
+  const normalizerScript = path.join(path.dirname(new URL(import.meta.url).pathname), 'normalize_claude_session.py')
+  const entries = await fs.readdir(projectDir, { withFileTypes: true }).catch(() => [])
+  const jsonlFiles = entries
+    .filter((entry) => entry.isFile() && entry.name.endsWith('.jsonl'))
+    .map((entry) => path.join(projectDir, entry.name))
+
+  for (const filePath of jsonlFiles) {
+    const tempOutputPath = `${filePath}.normalized`
+    const result = await run('python3', [normalizerScript, filePath, '--output', tempOutputPath], projectDir)
+    if (result.code !== 0) {
+      throw new Error(`Failed to normalize Claude session file ${path.basename(filePath)}: ${(result.stderr || result.stdout).trim()}`)
+    }
+    await fs.rename(tempOutputPath, filePath)
+  }
+}
+
 try {
   const sessionId = argv['session-id']
   const transcriptPath = await resolveClaudeSessionPath(sessionId, argv.cwd)
@@ -80,16 +98,25 @@ try {
     throw new Error(`Claude transcript not found for session ${sessionId}`)
   }
 
-  const projectDir = path.dirname(transcriptPath)
+  const sourceProjectDir = path.dirname(transcriptPath)
+  const tempRoot = await fs.mkdtemp(path.join(os.tmpdir(), 'slopmachine-claude-project-'))
+  const projectDir = path.join(tempRoot, path.basename(sourceProjectDir))
+  await fs.cp(sourceProjectDir, projectDir, { recursive: true })
+  await normalizeClaudeJsonlFiles(projectDir)
   const included = (await fs.readdir(projectDir).catch(() => [])).sort((left, right) => left.localeCompare(right))
 
-  await createZipArchive(projectDir, argv.output)
-  emitSuccess(sessionId, {
-    output: argv.output,
-    project_dir: projectDir,
-    label: argv.label || null,
-    included,
-  })
+  try {
+    await createZipArchive(projectDir, argv.output)
+    emitSuccess(sessionId, {
+      output: argv.output,
+      project_dir: sourceProjectDir,
+      label: argv.label || null,
+      included,
+      normalized: true,
+    })
+  } finally {
+    await fs.rm(tempRoot, { recursive: true, force: true }).catch(() => {})
+  }
 } catch (error) {
   emitFailure('package_claude_session_failed', error instanceof Error ? error.message : String(error))
   process.exitCode = 1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "theslopmachine",
-  "version": "0.7.0",
+  "version": "0.7.2",
   "description": "SlopMachine installer and project bootstrap CLI",
   "license": "MIT",
   "type": "module",

package/src/constants.js

@@ -62,6 +62,7 @@ export const CLAUDE_REQUIRED_AGENT_FILES = ["developer.md"];
 export const REQUIRED_SLOPMACHINE_FILES = [
   "backend-evaluation-prompt.md",
   "frontend-evaluation-prompt.md",
+  "test-coverage-prompt.md",
   "workflow-init.js",
   "templates/AGENTS.md",
   "templates/CLAUDE.md",
@@ -81,6 +82,7 @@ export const REQUIRED_SLOPMACHINE_FILES = [
   "utils/prepare_strict_audit_workspace.mjs",
   "utils/claude_wait_for_rate_limit_reset.mjs",
   "utils/claude_wait_for_rate_limit_reset.sh",
+  "utils/normalize_claude_session.py",
   "scaffold-playbooks/docker-shared-contract.md",
   "scaffold-playbooks/generic-unknown-tech-guide.md",
   "scaffold-playbooks/frontend-family-matrix.md",
@@ -113,8 +115,6 @@ export const REQUIRED_SLOPMACHINE_FILES = [
   "utils/cleanup_delivery_artifacts.py",
 ];
 
-export const REQUIRED_SLOPMACHINE_ROOT_FILES = ["test-coverage-prompt.md"];
-
 export const MCP_ENTRIES = {
   context7: {
     enabled: true,

package/src/init.js

@@ -288,7 +288,13 @@ async function createInitialPhaseArtifacts(targetPath, options) {
     `## Bootstrap Status\n\n` +
     `- Workspace initialized by slopmachine.\n` +
     `${options.adoptExisting ? '- Existing project adoption mode is active.\n' : ''}` +
-    `${options.requestedStartPhase ? `- Requested start phase: ${options.requestedStartPhase}.\n` : ''}`
+    `${options.requestedStartPhase ? `- Requested start phase: ${options.requestedStartPhase}.\n` : ''}` +
+    `\n## Entry Template\n\n` +
+    `Copy this exact structure for each clarification item:\n\n` +
+    `### 1. Clarification Defaults for Planning\n` +
+    `- Question: Can the drafted clarification defaults be used for planning?\n` +
+    `- My Understanding: The prompt was large enough that planning needed explicit confirmation that the clarification package was acceptable. We needed to lock this in rather than carrying uncertainty forward into the planning phase.\n` +
+    `- Solution: Yes. Proceed with the drafted defaults, allowing planning to start from the approved clarification brief instead of an uncertain baseline.\n`
 
   const prePlanningBriefContent = `# Pre-Planning Brief\n\n` +
     `Capture the planning-critical project shape here before real planning begins.\n\n` +