@open-agent-toolkit/cli 0.0.32 → 0.0.34

package/README.md

@@ -34,6 +34,7 @@ Additional useful entry points:
 - `oat config dump --json`
 - `oat project status --json`
 - `oat project list --json`
+- `oat project complete-state /path/to/project`
 - `oat project archive sync`
 - `oat doctor`
 
@@ -44,6 +45,7 @@ Use these commands when you want structured runtime/project state out of the CLI
 - `oat config dump --json` - emit merged OAT config with per-key source attribution
 - `oat project status --json` - emit the active project's full parsed control-plane state
 - `oat project list --json` - emit summary state for tracked projects under the configured projects root
+- `oat project complete-state <project-path>` - emit the canonical completed lifecycle shape into a tracked project's `state.md`
 
 ## Requirements
 

package/assets/docs/reference/cli-reference.md

@@ -39,6 +39,7 @@ Notable inspection commands introduced in the current CLI surface:
 - `oat config dump --json` - merged config with source attribution
 - `oat project status --json` - full parsed state for the active tracked project
 - `oat project list --json` - summary state for tracked projects under the configured projects root
+- `oat project complete-state <project-path>` - apply the canonical completed-state mutation to a project's `state.md`; used by `oat-project-complete` during lifecycle closeout
 
 ## `oat config` surface flags
 

package/assets/docs/workflows/projects/lifecycle.md

@@ -104,7 +104,7 @@ When `autoReviewAtCheckpoints` is enabled (via `.oat/config.json` or `plan.md` f
 
 ### Quick lane diagram
 
-1. `oat-project-quick-start` (adaptive discovery — well-understood requests synthesize quickly, exploratory requests invest in solution space exploration)
+1. `oat-project-quick-start` (adaptive discovery — provide a project name and optional description; if only the name is provided, quick-start asks for the missing description before discovery. Well-understood requests synthesize quickly, exploratory requests invest in solution space exploration)
 2. Decision point: straight to plan, optional lightweight `design.md`, or promote to spec-driven
 3. Implement:
    - `oat-project-implement` (sequential)

package/assets/docs/workflows/skills/index.md

@@ -14,7 +14,7 @@ Use this section when you want to choose the right OAT skill for a task. If you
 
 ## Key Skills by Use Case
 
-- Start a new tracked project: `oat-project-new` or `oat-project-quick-start`
+- Start a new tracked project: `oat-project-new` or `oat-project-quick-start` (quick start accepts a project name plus optional description; if you omit the description it should ask before discovery begins)
 - Resume an existing project: `oat-project-open` and `oat-project-progress`
 - Execute a ready plan: `oat-project-implement`
 - Import an existing plan: `oat-project-import-plan`

package/assets/public-package-versions.json

@@ -1,6 +1,6 @@
 {
-  "cli": "0.0.32",
-  "docs-config": "0.0.32",
-  "docs-theme": "0.0.32",
-  "docs-transforms": "0.0.32"
+  "cli": "0.0.34",
+  "docs-config": "0.0.34",
+  "docs-theme": "0.0.34",
+  "docs-transforms": "0.0.34"
 }

package/assets/skills/oat-docs/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: oat-docs
-version: 1.0.0
+version: 1.0.1
 description: Use when a user asks questions about OAT workflows, CLI commands, skill authoring, configuration, or project lifecycle. Answers questions by reading locally-bundled OAT documentation.
 argument-hint: '[question]'
 disable-model-invocation: false
@@ -161,13 +161,15 @@ Would you like me to:
 To create a new OAT project, you have two main approaches:
 
 1. **Quick mode** (recommended for most tasks):
-   oat-project-quick-start <project-name>
+   oat-project-quick-start <project-name> "project description"
 
 2. **Spec-driven mode** (for complex features):
    oat-project-new <project-name>
 
 Quick mode goes straight from discovery to plan. Spec-driven mode adds
-formal spec and design phases.
+formal spec and design phases. If you invoke quick mode with only a
+project name, it should ask you for the missing project description
+before discovery starts.
 
 Both create a project directory under your projects root
 (default: .oat/projects/shared/<project-name>/) with standard artifacts:

package/assets/skills/oat-project-complete/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: oat-project-complete
-version: 1.4.0
+version: 1.4.1
 description: Use when all implementation work is finished and the project is ready to close. Marks the OAT project lifecycle as complete.
 disable-model-invocation: true
 user-invocable: true
@@ -254,41 +254,19 @@ Rules:
 
 ### Step 5: Set Lifecycle Complete
 
-Update `state.md` frontmatter to add/update `oat_lifecycle: complete` and set completion timestamps:
+Delegate the canonical `state.md` completion mutation to the CLI:
 
 ```bash
-STATE_FILE="${PROJECT_PATH}/state.md"
-NOW_UTC=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
-
-# Check if oat_lifecycle already exists
-if grep -q "^oat_lifecycle:" "$STATE_FILE"; then
-  # Update existing (portable approach using temp file)
-  sed 's/^oat_lifecycle:.*/oat_lifecycle: complete/' "$STATE_FILE" > "$STATE_FILE.tmp"
-  mv "$STATE_FILE.tmp" "$STATE_FILE"
-else
-  # Add after oat_phase_status line using awk (more portable for multi-line inserts)
-  awk '/^oat_phase_status:/ {print; print "oat_lifecycle: complete"; next} 1' "$STATE_FILE" > "$STATE_FILE.tmp"
-  mv "$STATE_FILE.tmp" "$STATE_FILE"
+COMPLETE_STATE_ARGS=("$PROJECT_PATH")
+if [[ "$SHOULD_ARCHIVE" == "true" && "$IS_SHARED_PROJECT" == "true" ]]; then
+  COMPLETE_STATE_ARGS+=("--archived")
 fi
 
-# Set completion and state-updated timestamps
-sed -E "s/^oat_project_completed:.*/oat_project_completed: \"$NOW_UTC\"/" "$STATE_FILE" > "$STATE_FILE.tmp"
-mv "$STATE_FILE.tmp" "$STATE_FILE"
-sed -E "s/^oat_project_state_updated:.*/oat_project_state_updated: \"$NOW_UTC\"/" "$STATE_FILE" > "$STATE_FILE.tmp"
-mv "$STATE_FILE.tmp" "$STATE_FILE"
+oat project complete-state "${COMPLETE_STATE_ARGS[@]}"
 ```
 
-Then update the markdown body in `state.md` so the completion state is explicit and does not rely on reference lookups:
-
-- Set `**Status:** Complete`
-- Set `**Last Updated:**` to the completion date in `YYYY-MM-DD`
-- In `## Current Phase`, replace the body with:
-  - `Lifecycle complete; archived locally` when the project is archived in Step 8
-  - `Lifecycle complete` when the project is completed without archive
-- In `## Progress`, preserve the existing completed workflow/review bullets and add `- ✓ Project lifecycle complete` if it is not already present
-- In `## Next Milestone`, replace the body with `None. Project complete.`
-
-Do not infer these body mutations from other archived projects. Apply them directly as part of this skill.
+The CLI command owns both the frontmatter completion fields and the canonical markdown body updates for `state.md`.
+It must set `oat_lifecycle: complete`, completion timestamps, `**Status:** Complete`, `**Last Updated:**`, the canonical `## Current Phase` body, normalized `## Progress`, and `## Next Milestone`.
 
 ### Step 6: Clear Active Project Pointer
 

package/assets/skills/oat-project-quick-start/SKILL.md

@@ -1,8 +1,8 @@
 ---
 name: oat-project-quick-start
-version: 1.3.1
+version: 1.3.3
 description: Use when a task is small enough for quick mode or rapid iteration is preferred. Scaffolds a lightweight OAT project from discovery directly to a runnable plan, with optional brainstorming and lightweight design.
-argument-hint: '<project-name>'
+argument-hint: '<project-name> ["project description"]'
 disable-model-invocation: true
 user-invocable: true
 allowed-tools: Read, Write, Bash, Glob, Grep, AskUserQuestion
@@ -83,7 +83,11 @@ PROJECTS_ROOT="${PROJECTS_ROOT%/}"
 
 If no valid active project exists:
 
-- Read `{project-name}` from `$ARGUMENTS`, or ask user.
+- Resolve startup input from `$ARGUMENTS` before doing any discovery work:
+  - Accept `{project-name}` plus an optional `{project-description}`.
+  - If `$ARGUMENTS` contains only a bare `{project-name}` (for example a slug or short title) without a substantive description, ask the user for a short project description before scanning the repo or drafting discovery.
+  - Do not infer requirements from the project name alone or go exploring the codebase to guess what the project means.
+  - If neither field is available, ask for both the project name and a short project description. One or two sentences is enough for the description.
 - Create project via the same scaffolding path used by `oat-project-new`:
 
 ```bash
@@ -116,6 +120,8 @@ If `"$PROJECT_PATH/discovery.md"` is missing, create it from `.oat/templates/dis
 
 Before asking questions, classify the request:
 
+- Base this classification on the user's project description plus session context. A bare project name by itself is not enough context to start discovery.
+
 - **Well-understood** — the user has a clear mental model, requirements are specific, approach is obvious. Examples: "add a CLI flag for verbose output", "rename X to Y across the codebase."
   → Synthesize `discovery.md` from available session context quickly when enough detail is already available. Ask only the minimum additional questions needed to remove blockers for a quality plan.
 

package/dist/commands/project/complete-state/index.d.ts

@@ -0,0 +1,16 @@
+import { readFile as defaultReadFile, writeFile as defaultWriteFile } from 'node:fs/promises';
+import { buildCommandContext, type CommandContext } from '../../../app/command-context.js';
+import { dirExists, fileExists } from '../../../fs/io.js';
+import { Command } from 'commander';
+interface ProjectCompleteStateDependencies {
+    buildCommandContext: (options: Parameters<typeof buildCommandContext>[0]) => CommandContext;
+    resolveProjectRoot: (cwd: string) => Promise<string>;
+    readFile: typeof defaultReadFile;
+    writeFile: typeof defaultWriteFile;
+    dirExists: typeof dirExists;
+    fileExists: typeof fileExists;
+    now: () => Date;
+}
+export declare function createProjectCompleteStateCommand(overrides?: Partial<ProjectCompleteStateDependencies>): Command;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/commands/project/complete-state/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/commands/project/complete-state/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,QAAQ,IAAI,eAAe,EAC3B,SAAS,IAAI,gBAAgB,EAC9B,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,mBAAmB,EAAE,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAGhF,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAE/C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQpC,UAAU,gCAAgC;IACxC,mBAAmB,EAAE,CACnB,OAAO,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC,CAAC,CAAC,KAC/C,cAAc,CAAC;IACpB,kBAAkB,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACrD,QAAQ,EAAE,OAAO,eAAe,CAAC;IACjC,SAAS,EAAE,OAAO,gBAAgB,CAAC;IACnC,SAAS,EAAE,OAAO,SAAS,CAAC;IAC5B,UAAU,EAAE,OAAO,UAAU,CAAC;IAC9B,GAAG,EAAE,MAAM,IAAI,CAAC;CACjB;AAsED,wBAAgB,iCAAiC,CAC/C,SAAS,GAAE,OAAO,CAAC,gCAAgC,CAAM,GACxD,OAAO,CA2BT"}

package/dist/commands/project/complete-state/index.js

@@ -0,0 +1,78 @@
+import { readFile as defaultReadFile, writeFile as defaultWriteFile, } from 'node:fs/promises';
+import { isAbsolute, join } from 'node:path';
+import { buildCommandContext } from '../../../app/command-context.js';
+import { readGlobalOptions } from '../../shared/shared.utils.js';
+import { CliError } from '../../../errors/cli-error.js';
+import { dirExists, fileExists } from '../../../fs/io.js';
+import { resolveProjectRoot } from '../../../fs/paths.js';
+import { Command } from 'commander';
+import { renderCompletedProjectState } from './state-utils.js';
+const DEFAULT_DEPENDENCIES = {
+    buildCommandContext,
+    resolveProjectRoot,
+    readFile: defaultReadFile,
+    writeFile: defaultWriteFile,
+    dirExists,
+    fileExists,
+    now: () => new Date(),
+};
+function resolveTargetProjectPath(repoRoot, projectPath) {
+    return isAbsolute(projectPath) ? projectPath : join(repoRoot, projectPath);
+}
+async function runProjectCompleteState(projectPath, options, context, dependencies) {
+    try {
+        const repoRoot = await dependencies.resolveProjectRoot(context.cwd);
+        const targetProjectPath = resolveTargetProjectPath(repoRoot, projectPath);
+        if (!(await dependencies.dirExists(targetProjectPath))) {
+            throw new CliError(`Project not found: ${projectPath}`, 1);
+        }
+        const statePath = join(targetProjectPath, 'state.md');
+        if (!(await dependencies.fileExists(statePath))) {
+            throw new CliError(`Project state.md not found: ${statePath}`, 1);
+        }
+        const now = dependencies.now();
+        const content = await dependencies.readFile(statePath, 'utf8');
+        const updatedContent = renderCompletedProjectState(content, {
+            archived: options.archived ?? false,
+            nowUtc: now.toISOString(),
+            today: now.toISOString().slice(0, 10),
+        });
+        await dependencies.writeFile(statePath, updatedContent, 'utf8');
+        if (context.json) {
+            context.logger.json({
+                status: 'ok',
+                projectPath,
+                statePath,
+                archived: options.archived ?? false,
+            });
+        }
+        else {
+            context.logger.info(`Updated completed project state: ${projectPath}`);
+        }
+        process.exitCode = 0;
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        if (context.json) {
+            context.logger.json({ status: 'error', message });
+        }
+        else {
+            context.logger.error(message);
+        }
+        process.exitCode = error instanceof CliError ? error.exitCode : 1;
+    }
+}
+export function createProjectCompleteStateCommand(overrides = {}) {
+    const dependencies = {
+        ...DEFAULT_DEPENDENCIES,
+        ...overrides,
+    };
+    return new Command('complete-state')
+        .description('Update a project state.md to the completed lifecycle shape')
+        .argument('<project-path>', 'Project path to update')
+        .option('--archived', 'Mark the completed project as archived locally')
+        .action(async (projectPath, options, command) => {
+        const context = dependencies.buildCommandContext(readGlobalOptions(command));
+        await runProjectCompleteState(projectPath, options, context, dependencies);
+    });
+}

package/dist/commands/project/complete-state/state-utils.d.ts

@@ -0,0 +1,7 @@
+export interface CompleteProjectStateOptions {
+    archived: boolean;
+    nowUtc: string;
+    today: string;
+}
+export declare function renderCompletedProjectState(content: string, options: CompleteProjectStateOptions): string;
+//# sourceMappingURL=state-utils.d.ts.map

package/dist/commands/project/complete-state/state-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-utils.d.ts","sourceRoot":"","sources":["../../../../src/commands/project/complete-state/state-utils.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAoED,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,2BAA2B,GACnC,MAAM,CA8DR"}

package/dist/commands/project/complete-state/state-utils.js

@@ -0,0 +1,72 @@
+import { getFrontmatterBlock, getFrontmatterField, } from '../../shared/frontmatter.js';
+import { replaceFrontmatter, upsertFrontmatterField, } from '../../shared/frontmatter-write.js';
+function replaceLine(content, pattern, nextLine) {
+    return pattern.test(content) ? content.replace(pattern, nextLine) : content;
+}
+function findSectionBounds(content, heading) {
+    const marker = `## ${heading}\n\n`;
+    const start = content.indexOf(marker);
+    if (start === -1) {
+        return null;
+    }
+    const bodyStart = start + marker.length;
+    const nextHeading = content.indexOf('\n## ', bodyStart);
+    return {
+        start,
+        bodyStart,
+        end: nextHeading === -1 ? content.length : nextHeading,
+    };
+}
+function readSectionBody(content, heading) {
+    const bounds = findSectionBounds(content, heading);
+    if (!bounds) {
+        return '';
+    }
+    return content.slice(bounds.bodyStart, bounds.end).trim();
+}
+function replaceSection(content, heading, body) {
+    const bounds = findSectionBounds(content, heading);
+    if (!bounds) {
+        return content;
+    }
+    return [
+        content.slice(0, bounds.start),
+        `## ${heading}\n\n${body.trim()}\n`,
+        content.slice(bounds.end),
+    ].join('');
+}
+function renderCompletedProgress(content) {
+    const existingLines = readSectionBody(content, 'Progress')
+        .split('\n')
+        .map((line) => line.trim())
+        .filter((line) => line.length > 0 && line.startsWith('- ✓'));
+    if (!existingLines.includes('- ✓ Project lifecycle complete')) {
+        existingLines.push('- ✓ Project lifecycle complete');
+    }
+    return existingLines.join('\n');
+}
+export function renderCompletedProjectState(content, options) {
+    const frontmatter = getFrontmatterBlock(content);
+    if (!frontmatter) {
+        throw new Error('state.md is missing frontmatter');
+    }
+    let nextBlock = upsertFrontmatterField(frontmatter, 'oat_lifecycle', 'complete', true).nextBlock;
+    nextBlock = upsertFrontmatterField(nextBlock, 'oat_project_completed', `"${options.nowUtc}"`, true).nextBlock;
+    nextBlock = upsertFrontmatterField(nextBlock, 'oat_project_state_updated', `"${options.nowUtc}"`, true).nextBlock;
+    let nextContent = nextBlock === frontmatter
+        ? content
+        : replaceFrontmatter(content, nextBlock);
+    nextContent = replaceLine(nextContent, /^\*\*Status:\*\*.*$/m, '**Status:** Complete');
+    nextContent = replaceLine(nextContent, /^\*\*Last Updated:\*\*.*$/m, `**Last Updated:** ${options.today}`);
+    const currentPhase = options.archived
+        ? 'Lifecycle complete; archived locally'
+        : 'Lifecycle complete';
+    nextContent = replaceSection(nextContent, 'Current Phase', currentPhase);
+    nextContent = replaceSection(nextContent, 'Progress', renderCompletedProgress(nextContent));
+    nextContent = replaceSection(nextContent, 'Next Milestone', 'None. Project complete.');
+    const currentLifecycle = getFrontmatterField(nextBlock, 'oat_lifecycle');
+    if (currentLifecycle !== 'complete') {
+        throw new Error('Failed to set oat_lifecycle: complete');
+    }
+    return nextContent;
+}

package/dist/commands/project/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/project/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAUpC,wBAAgB,oBAAoB,IAAI,OAAO,CAU9C"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/project/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAWpC,wBAAgB,oBAAoB,IAAI,OAAO,CAW9C"}

package/dist/commands/project/index.js

@@ -1,5 +1,6 @@
 import { Command } from 'commander';
 import { createProjectArchiveCommand } from './archive/index.js';
+import { createProjectCompleteStateCommand } from './complete-state/index.js';
 import { createProjectListCommand } from './list.js';
 import { createProjectNewCommand } from './new/index.js';
 import { createProjectOpenCommand } from './open/index.js';
@@ -10,6 +11,7 @@ export function createProjectCommand() {
     return new Command('project')
         .description('Manage OAT project workflows')
         .addCommand(createProjectArchiveCommand())
+        .addCommand(createProjectCompleteStateCommand())
         .addCommand(createProjectListCommand())
         .addCommand(createProjectNewCommand())
         .addCommand(createProjectOpenCommand())

package/dist/validation/skills.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../src/validation/skills.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,uBAAuB;IACtC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,QAAQ,EAAE,iBAAiB,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,uCAAuC;IACtD,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,sCAAsC;IACrD,mBAAmB,EAAE,MAAM,CAAC;IAC5B,QAAQ,EAAE,iBAAiB,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,wBAAwB;IACvC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,cAAc,GAAG;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG,CACzB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,CAAC,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;CAAE,KAChD,OAAO,CAAC,cAAc,CAAC,CAAC;AAE7B,UAAU,6BAA6B;IACrC,WAAW,CAAC,EAAE,YAAY,CAAC;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACzB;AAgOD,wBAAsB,gCAAgC,CACpD,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,uCAAuC,EAChD,YAAY,GAAE,6BAAkC,GAC/C,OAAO,CAAC,sCAAsC,CAAC,CAoBjD;AAED,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,wBAA6B,EACtC,YAAY,GAAE,6BAAkC,GAC/C,OAAO,CAAC,uBAAuB,CAAC,CA6HlC"}
+{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../src/validation/skills.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,uBAAuB;IACtC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,QAAQ,EAAE,iBAAiB,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,uCAAuC;IACtD,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,sCAAsC;IACrD,mBAAmB,EAAE,MAAM,CAAC;IAC5B,QAAQ,EAAE,iBAAiB,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,wBAAwB;IACvC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,cAAc,GAAG;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG,CACzB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,CAAC,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;CAAE,KAChD,OAAO,CAAC,cAAc,CAAC,CAAC;AAE7B,UAAU,6BAA6B;IACrC,WAAW,CAAC,EAAE,YAAY,CAAC;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACzB;AAmPD,wBAAsB,gCAAgC,CACpD,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,uCAAuC,EAChD,YAAY,GAAE,6BAAkC,GAC/C,OAAO,CAAC,sCAAsC,CAAC,CAoBjD;AAED,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,wBAA6B,EACtC,YAAY,GAAE,6BAAkC,GAC/C,OAAO,CAAC,uBAAuB,CAAC,CA6HlC"}

package/dist/validation/skills.js

@@ -77,6 +77,15 @@ function validateQuickStartSemantics(skillPath, content, findings) {
             message: 'Quick-start must limit follow-up questions to the minimum needed to remove blockers',
         });
     }
+    if (!(/(project description|project brief)/i.test(content) &&
+        /(project name alone|bare .*project-name|only a bare .*project-name)/i.test(content) &&
+        /(ask the user|ask for)/i.test(content) &&
+        /(do not infer requirements from the project name alone|not enough context to start discovery)/i.test(content))) {
+        findings.push({
+            file: skillPath,
+            message: 'Quick-start must treat a bare project name as insufficient input, ask for a project description, and avoid inferring scope from the repo',
+        });
+    }
 }
 async function listChangedSkillFiles(repoRoot, baseRef, dependencies) {
     const execFile = dependencies.gitExecFile ?? execFileAsync;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@open-agent-toolkit/cli",
-  "version": "0.0.32",
+  "version": "0.0.34",
   "private": false,
   "description": "Open Agent Toolkit CLI",
   "homepage": "https://github.com/voxmedia/open-agent-toolkit/tree/main/packages/cli",
@@ -33,7 +33,7 @@
     "ora": "^9.0.0",
     "yaml": "2.8.2",
     "zod": "^3.25.76",
-    "@open-agent-toolkit/control-plane": "0.0.32"
+    "@open-agent-toolkit/control-plane": "0.0.34"
   },
   "devDependencies": {
     "@types/node": "^22.10.0",