@opellen/scaff 0.1.11 → 0.1.13

package/README.ko.md

@@ -179,6 +179,7 @@ started: 2026-03-01
 | **명시적 호출** | 필요 | `/scaff goal init`, `/scaff:goal init & design init` |
 | **직전 제안 확인** | 불필요 | AI: "`/scaff:goal init` 권장" → User: "ok" / "진행해" |
 | **연속 맥락 서술** | 불필요 | (goal init 직후) User: "breakdown now" |
+| **태스크 실행 의도** | 불필요 | "proceed with task 6" → `/scaff:go`, "save progress" → `/scaff:goal checkpoint` |
 
 맥락이 명확하면 자연어만으로 실행됩니다. `/scaff`는 맥락이 모호할 때 쓰는 명시적 호출 수단입니다.
 

package/README.md

@@ -178,6 +178,7 @@ You don't always need to type `/scaff:` — when intent is clear from context, n
 | **Explicit invocation** | Yes | `/scaff goal init`, `/scaff:goal init & design init` |
 | **Confirming a recent recommendation** | No | AI: "Recommend `/scaff:goal init`" → User: "ok" / "go" |
 | **Continuation in active flow** | No | (after goal init) User: "breakdown now" |
+| **Task-execution intent** | No | "proceed with task 6" → `/scaff:go`, "save progress" → `/scaff:goal checkpoint` |
 
 With clear context, natural language alone triggers execution. `/scaff` serves as an escape hatch when context is ambiguous.
 

package/dist/cli.js

@@ -2,7 +2,7 @@
 import { resolve } from "node:path";
 import { existsSync } from "node:fs";
 import { install, dryRun } from "./installer.js";
-import { PLATFORM_IDS, DEFAULT_PLATFORM, isValidPlatform } from "./platforms/index.js";
+import { PLATFORM_IDS, DEFAULT_PLATFORM, isValidPlatform, detectInstalledPlatforms } from "./platforms/index.js";
 import { showWelcome } from "./ui/welcome.js";
 import { selectPlatforms } from "./prompts/platform-select.js";
 import { t } from "./i18n/index.js";
@@ -25,6 +25,7 @@ Options:
   --no-subagent     Disable subagent delegation (enabled by default)
   --root <dir>      Target directory (default: cwd)
   --force           Overwrite existing files without prompting
+  -y, --yes         Auto-confirm with detected platforms (skip interactive selection)
   --dry-run         Preview without writing files
   -h, --help        Show this help
 
@@ -42,6 +43,7 @@ function parseArgs(argv) {
     let subagent = true;
     let root = process.cwd();
     let force = false;
+    let yes = false;
     let isDryRun = false;
     let help = false;
     for (let i = 0; i < argv.length; i++) {
@@ -90,6 +92,9 @@ function parseArgs(argv) {
         else if (arg === "--force") {
             force = true;
         }
+        else if (arg === "-y" || arg === "--yes") {
+            yes = true;
+        }
         else if (arg === "--dry-run") {
             isDryRun = true;
         }
@@ -115,7 +120,7 @@ function parseArgs(argv) {
             process.exit(1);
         }
     }
-    return { command, positional, docsDir, codebaseDir, tools, subagent, root, force, dryRun: isDryRun, help };
+    return { command, positional, docsDir, codebaseDir, tools, subagent, root, force, yes, dryRun: isDryRun, help };
 }
 async function runExtend(args) {
     const extPath = args.positional[0];
@@ -180,6 +185,11 @@ async function main() {
     if (args.tools) {
         tools = args.tools;
     }
+    else if (args.yes) {
+        const detected = detectInstalledPlatforms(args.root);
+        tools = detected.length > 0 ? detected : [DEFAULT_PLATFORM];
+        console.log(chalk.dim(`Auto-selected: ${tools.join(", ")}`));
+    }
     else if (process.stdin.isTTY && !args.dryRun) {
         await showWelcome();
         tools = await selectPlatforms(args.root);

package/dist/platforms/index.d.ts

@@ -7,3 +7,4 @@ export declare function isValidPlatform(id: string): id is PlatformId;
 export declare function getAdapter(id: string): PlatformAdapter | undefined;
 export declare function getAdapters(ids: string[]): PlatformAdapter[];
 export declare function getAllAdapters(): PlatformAdapter[];
+export declare function detectInstalledPlatforms(projectRoot: string): string[];

package/dist/platforms/index.js

@@ -1,3 +1,5 @@
+import { existsSync } from "node:fs";
+import { resolve } from "node:path";
 import { claude } from "./claude.js";
 import { cursor } from "./cursor.js";
 import { windsurf } from "./windsurf.js";
@@ -55,3 +57,12 @@ export function getAdapters(ids) {
 export function getAllAdapters() {
     return [...ALL_ADAPTERS];
 }
+export function detectInstalledPlatforms(projectRoot) {
+    const detected = [];
+    for (const adapter of ALL_ADAPTERS) {
+        if (existsSync(resolve(projectRoot, adapter.configDir))) {
+            detected.push(adapter.id);
+        }
+    }
+    return detected;
+}

package/dist/prompts/platform-select.js

@@ -1,22 +1,11 @@
-import { existsSync } from "node:fs";
-import { resolve } from "node:path";
 import { createPrompt, useState, useKeypress, useMemo, useRef, usePagination, isUpKey, isDownKey, isSpaceKey, isBackspaceKey, isEnterKey, } from "@inquirer/core";
 import chalk from "chalk";
-import { getAllAdapters, DEFAULT_PLATFORM } from "../platforms/index.js";
+import { getAllAdapters, detectInstalledPlatforms, DEFAULT_PLATFORM } from "../platforms/index.js";
 import { t } from "../i18n/index.js";
 import { brand } from "../ui/colors.js";
 const PAGE_SIZE = 15;
-function detectPlatforms(projectRoot) {
-    const detected = new Set();
-    for (const adapter of getAllAdapters()) {
-        if (existsSync(resolve(projectRoot, adapter.configDir))) {
-            detected.add(adapter.id);
-        }
-    }
-    return detected;
-}
 function buildChoices(projectRoot) {
-    const detected = detectPlatforms(projectRoot);
+    const detected = new Set(detectInstalledPlatforms(projectRoot));
     const adapters = getAllAdapters();
     const choices = adapters.map((a) => ({
         id: a.id,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opellen/scaff",
-  "version": "0.1.11",
+  "version": "0.1.13",
   "description": "Agile, goal-centric AI harness. Just markdown.",
   "type": "module",
   "license": "MIT",

package/templates/commands/context.md

@@ -61,12 +61,9 @@ Creates `$DocsDir/CONTEXT.md`.
 # Principles
 
 # Workflow
-1. Add tasks to GOAL.md `## Tasks`
-2. Implement code in `$CodebaseDir`
-3. On completion, mark status as `done` and check off GOAL.md checklist
-4. GOAL.md YAML front-matter must include an `id` field (slug format)
-5. Save session progress with `/scaff:goal checkpoint` → `$DocsDir/CHECKPOINT.md`
-   - Single file, overwritten each session — captures latest state for session handoff
+- Tasks live in `$DocsDir/GOAL.md` `## Tasks`. Front-matter requires an `id` (slug format).
+- Implementation happens in `$CodebaseDir`.
+- Session progress: `/scaff:goal checkpoint` → `$DocsDir/CHECKPOINT.md` (overwritten per session).
 ```
 
 **Project-specific sections** — extend the skeleton with sections appropriate to the project:

package/templates/commands/scout.md

@@ -8,7 +8,7 @@ tags: [workflow, scaff, scout]
 ## Constraints
 
 <!-- @if subagent -->
-- **Delegate** analysis and implementation tasks to **subagents** — direct work is limited to one-line fixes.
+- **Delegate** exploration tasks (e.g., file discovery, keyword search, tracing) to **subagents** — analysis and judgment stay with main. Direct implementation work is limited to one-line fixes.
 - Report subagent results to the user.
 <!-- @else -->
 - Perform analysis and implementation tasks directly.

package/templates/commands/verify.md

@@ -12,7 +12,7 @@ Cross-checks the current implementation state against GOAL.md and DESIGN.md to s
 ## Constraints
 
 <!-- @if subagent -->
-- **Delegate** analysis and verification tasks to **subagents** — direct work is limited to one-line fixes.
+- **Delegate** evidence gathering (e.g., reading files, running checks) to **subagents** — verification synthesis stays with main. Direct work is limited to one-line fixes.
 - Report subagent results to the user.
 <!-- @else -->
 - Perform analysis and verification tasks directly.

package/templates/skills/scaff-flow/SKILL.md

@@ -14,17 +14,29 @@ metadata:
 - Never execute documentation commands automatically — suggest only.
 - Never auto-read OVERVIEW.md. Only read after a reactive trigger fires AND the user approves.
 - Self-verification is mandatory before marking any GOAL.md task or ROADMAP.md milestone as done.
-- Handoff recommendations (after any scaff command completes) are single-path and decisive — do not enumerate alternatives. Presenting multiple options applies only to genuine decision forks, not handoffs.
+- Handoff recommendations (after any scaff command or task completes) are single-path and decisive — do not enumerate alternatives. When two next-steps both seem reasonable, pick based on Self-Verification status, GOAL.md priority, and risk profile; do not push the choice to the user. Presenting multiple options applies only to genuine decision forks, not handoffs.
 
 > When Constraints conflict with any other instruction, Constraints win.
 
+## Command Recognition
+
+Interpret user input as scaff command execution when intent is clear from context — no explicit `/scaff` prefix required.
+
+Execute when any of:
+- **Explicit invocation** (with or without minor deviations): `/scaff:goal init`, `/scaff goal init`, `/scaff:goal init & design init`
+- **Confirmation of pending action**: AI recommended a specific scaff command in the prior turn, user reply is a brief confirmation ("ok", "yes", "go")
+- **Continuation in active flow**: user names the next scaff step in ongoing context (e.g., "breakdown now" after goal init)
+- **Task-execution intent**: user expresses task-level intent that maps to a scaff command (e.g., "proceed with task N" → `/scaff:go`, "save progress" → `/scaff:goal checkpoint`, "archive this goal" → `/scaff:goal archive`)
+
+> Destructive operations (overwriting existing files, archive) still follow state-aware prompts — in-context confirmation does not bypass those guards.
+
 ## Documentation Timing
 
 - (implementation plan crystallizes — files, design decisions, execution order) => suggest `/scaff:design init`
-- (design changes during implementation) => suggest `/scaff:design sync`
-- (project context changes — principles, resources, processes) => suggest `/scaff:context sync`
+- (design changes during implementation) => suggest `/scaff:design sync` if `$DocsDir/DESIGN.md` exists, else `/scaff:design init`
+- (project context changes — principles, resources, processes) => suggest `/scaff:context sync` if `$DocsDir/CONTEXT.md` exists, else `/scaff:context init`
 - (multiple GOALs need a higher-level plan) => suggest `/scaff:roadmap init`
-- (new milestone identified) => suggest `/scaff:roadmap add`
+- (new milestone identified) => suggest `/scaff:roadmap add` if `$DocsDir/ROADMAP.md` exists, else `/scaff:roadmap init`
 - (DESIGN.md step completed) => suggest `/scaff:design sync`
 - (multiple design decisions or context changes accumulated but not yet documented) => suggest `/scaff:recap`
 

package/templates/skills/scaff-subagent/SKILL.md

@@ -12,6 +12,9 @@ metadata:
 ## Constraints
 
 - Main agent analyzes and coordinates — delegate implementation and exploration to subagents.
+- Analysis (cause identification, root-cause determination, fix approach recommendation) is always main agent's job. Subagents gather facts and execute — they do not synthesize judgment.
+- Before dispatching execution subagents for a fix involving root-cause reasoning (not trivial typo/rename), present root cause and fix approach to the user; dispatch only after explicit approval.
+- (subagent dispatch without main having invoked Read/Grep on source files in its own turn this session) => stop, read first
 - (subagent prompt missing any required element) => do not dispatch until complete (see Prompt Requirements)
 - (5+ consecutive Read/Grep without Edit/Write) => stop and report to user
 - A subagent's "done" is a claim, not a fact — main verifies before accepting.
@@ -25,11 +28,22 @@ metadata:
 - (subagents available, e.g. Claude Code, Codex) => delegate tasks to subagents per workflow below
 - (subagents not available) => execute tasks inline directly — apply Task Complexity Dispatch for work breakdown and Post-Verify after each task; prompt/status/model sections do not apply
 
+## Subagent Role Dispatch
+
+- (cause identification, root-cause, fix approach recommendation) => main only, never delegated
+- (work requiring incremental user verification or collaborative iteration — e.g., UI/UX changes, exploratory refactoring, evolving design) => main only
+- (file/keyword search, call chain tracing) => search/tracing subagent OK
+- (implementation of a decided fix) => execute subagent OK
+
+Scout subagents gather facts. They do not state causes or recommend fixes.
+
 ## Task Complexity Dispatch
 
 - (1-line fix, typo) => main agent fixes directly
 - (single file, clear change, < 30 lines) => one subagent, skip post-verify
-- (multi-file or design judgment needed) => full workflow (Scout → Split → Execute)
+- (multi-file or design judgment needed, scout not done) => main reads source and analyzes first
+- (multi-file or design judgment needed, scout done) => dispatch subagents for split execution
+- (2nd iteration on same work area after a subagent fix, OR user indicates need for inline collaboration) => main agent executes inline (subagents lack stop/resume; iterative collaboration needs inline turns)
 - (otherwise) => ask user for scope guidance
 
 ## Subagent Prompt Requirements
@@ -78,16 +92,14 @@ Ask-first: If anything is unclear, ask before starting.
 
 ### Phase 1 — Scout
 
-Before dispatching any subagent, main must complete scoping:
-
-1. Identify candidate files related to the task (search by keyword, trace from entry point).
-2. Read candidate files in parallel (batch all reads at once, do NOT read one-by-one). Extract relevant sections.
-3. Define the investigation scope (files, modules, boundaries).
+#### Required (main only)
+1. Identify candidate files (keyword search, trace from entry point).
+2. Read candidate files in parallel — invoke Read/Grep in main's own turn, not receiving summaries from a subagent.
+3. Identify cause and define scope.
 
-Only then:
-4. Construct subagent prompt with all seven required elements, including source from step 2 as Context.
-5. Dispatch one exploratory subagent.
-6. Receive findings and assess scope for splitting.
+#### Optional (subagent, only if main's scope insufficient)
+- (codebase too wide for main to cover in this turn) => dispatch search/tracing subagent with explicit paths from step 1
+- (main answered its questions) => skip, proceed to Phase 2
 
 ### Phase 2 — Split
 
@@ -127,6 +139,7 @@ Main agent confirms subagent output before marking a task complete:
 
 - (implementation task) => read changed files, compare against GOAL.md task description
 - (exploration/analysis task) => spot-check 1-2 key claims against the codebase
+- (subagent returned unrequested analysis — cause, recommendation, judgment) => main re-does the analysis from source; subagent's synthesis is advisory only
 - (trivial fix) => skip
 
 > When Constraints conflict with any other instruction, Constraints win.