lee-spec-kit 0.7.5 → 0.7.7

package/dist/index.js

@@ -188,12 +188,7 @@ var koCli = {
   "update.langLabel": "\uC5B8\uC5B4",
   "update.typeLabel": "\uD0C0\uC785",
   "update.updatingAgents": "\u{1F4C1} agents/ \uD3F4\uB354 \uC5C5\uB370\uC774\uD2B8 \uC911...",
-  "update.updatingSkills": "\u{1F4C1} agents/skills \uD3F4\uB354 \uC5C5\uB370\uC774\uD2B8 \uC911...",
   "update.agentsUpdated": "agents/ \uC5C5\uB370\uC774\uD2B8 \uC644\uB8CC",
-  "update.skillsUpdated": "agents/skills \uC5C5\uB370\uC774\uD2B8 \uC644\uB8CC",
-  "update.updatingFeatureBase": "\u{1F4C1} features/feature-base/ \uD3F4\uB354 \uC5C5\uB370\uC774\uD2B8 \uC911...",
-  "update.engineManagedSkillsBuiltin": "agents/skills\uB294 CLI \uB0B4\uC7A5 \uADDC\uCE59\uC73C\uB85C \uAD00\uB9AC\uB418\uC5B4 docs\uB85C \uB3D9\uAE30\uD654\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4.",
-  "update.engineManagedFeatureBaseBuiltin": "features/feature-base\uB294 CLI \uB0B4\uC7A5 \uD15C\uD50C\uB9BF\uC73C\uB85C \uAD00\uB9AC\uB418\uC5B4 docs\uB85C \uB3D9\uAE30\uD654\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4.",
   "update.engineManagedPruned": "docs\uC5D0\uC11C CLI \uAD00\uB9AC \uBB38\uC11C {count}\uAC1C\uB97C \uC815\uB9AC\uD588\uC2B5\uB2C8\uB2E4.",
   "update.filesUpdated": "{count}\uAC1C \uD30C\uC77C \uC5C5\uB370\uC774\uD2B8 \uC644\uB8CC",
   "update.updatedTotal": "\uCD1D {count}\uAC1C \uD30C\uC77C \uC5C5\uB370\uC774\uD2B8 \uC644\uB8CC!",
@@ -218,6 +213,7 @@ var koCli = {
   "doctor.issue.tasksDocStatusUnset": "tasks.md\uC758 \uBB38\uC11C \uC0C1\uD0DC(Doc Status)\uAC00 \uC124\uC815\uB418\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4. (Draft/Review/Approved \uC911 \uD558\uB098\uB85C \uC124\uC815\uD558\uC138\uC694.)",
   "doctor.issue.tasksDocStatusMissing": "tasks.md\uC5D0 \uBB38\uC11C \uC0C1\uD0DC(Doc Status) \uD544\uB4DC\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4. `- **\uBB38\uC11C \uC0C1\uD0DC**: -`\uC640 `\uAC12: Draft | Review | Approved`\uB97C \uCD94\uAC00\uD558\uC138\uC694.",
   "doctor.issue.tasksPrdTagUnknown": "tasks.md\uC5D0 \uC815\uC758\uB418\uC9C0 \uC54A\uC740 PRD \uD0DC\uADF8\uAC00 \uC788\uC2B5\uB2C8\uB2E4: {ids}{extra}. tasks.md\uC5D0\uC11C PRD-FR-001 \uAC19\uC740 ID\uB97C \uC784\uC758\uB85C \uB9CC\uB4E4\uC9C0 \uB9D0\uACE0, \uBA3C\uC800 docs/prd \uB610\uB294 \uC0C1\uC704 \uC694\uAD6C\uC0AC\uD56D \uBB38\uC11C\uC5D0 ID\uB97C backfill\uD55C \uB4A4 spec.md `PRD Refs`\uC640 tasks \uD0DC\uADF8\uB97C \uD568\uAED8 \uB9DE\uCD94\uC138\uC694.",
+  "doctor.issue.unmanagedDocsEntry": "lee-spec-kit \uBB38\uC11C \uD45C\uBA74 \uBC16\uC758 \uBB38\uC11C \uC5D4\uD2B8\uB9AC\uAC00 \uAC10\uC9C0\uB418\uC5C8\uC2B5\uB2C8\uB2E4: {path}. \uCD5C\uC885 SSOT\uB85C \uC4F0\uC9C0 \uB9D0\uACE0 feature-local docs\uB85C \uC815\uADDC\uD654\uD558\uAC70\uB098, \uC758\uB3C4\uB41C \uACBD\uB85C\uB77C\uBA74 `.lee-spec-kit.json`\uC758 `allowedDocsEntries`\uC5D0 \uCD94\uAC00\uD558\uC138\uC694.",
   "doctor.issue.duplicateFeatureId": "\uC911\uBCF5 Feature ID \uAC10\uC9C0: {id} ({count}\uAC1C)",
   "doctor.issue.missingFeatureId": "Feature \uD3F4\uB354\uBA85\uC774 F001-... \uD615\uC2DD\uC774 \uC544\uB2D9\uB2C8\uB2E4. (ID\uB97C \uCD94\uCD9C\uD560 \uC218 \uC5C6\uC74C)",
   "init.selectLangPrompt": "\uBB38\uC11C \uC5B8\uC5B4\uB97C \uC120\uD0DD\uD558\uC138\uC694:",
@@ -684,6 +680,7 @@ var koMessages = {
   featureScopeSplitTwo: "Feature \uBC94\uC704\uAC00 \uD07D\uB2C8\uB2E4. (tasks: {taskCount}, decisions \uC904\uC218: {decisionsLineCount}) \uAD8C\uC7A5 \uADDC\uCE59\uC0C1 40~79 \uD0DC\uC2A4\uD06C\uC774\uBA74\uC11C \uD558\uB4DC \uAE30\uC900 \uBBF8\uB9CC\uC774\uBA74 2\uAC1C \uC774\uC288 \uBD84\uD560\uC774 \uAE30\uBCF8\uC785\uB2C8\uB2E4. `{guideCommand}`\uB97C \uB530\uB77C \uACB0\uD569\uB3C4/\uD30C\uC77C\uACB9\uCE68/\uD14C\uC2A4\uD2B8/\uBC30\uD3EC \uAE30\uC900\uC73C\uB85C \uBD84\uD560\uD558\uC138\uC694. \uAC01 \uC774\uC288\uC5D0\uB294 \uB2E4\uC74C \uD15C\uD50C\uB9BF\uC744 \uAE30\uB85D\uD558\uC138\uC694: \uBAA9\uD45C, \uD3EC\uD568 \uBC94\uC704, \uC81C\uC678 \uBC94\uC704, \uC120\uD589 \uC758\uC874\uC131, PR \uC644\uB8CC \uAE30\uC900.",
   featureScopeSplitFour: "Feature \uBC94\uC704\uAC00 \uD07D\uB2C8\uB2E4. (tasks: {taskCount}, decisions \uC904\uC218: {decisionsLineCount}) tasks >= {recommendFourTaskThreshold} \uB610\uB294 decisions \uC904\uC218 >= {recommendFourDecisionsThreshold}\uC774\uBA74 4\uAC1C \uC774\uC288 \uBD84\uD560\uC744 \uAC15\uD558\uAC8C \uAD8C\uC7A5\uD569\uB2C8\uB2E4. `{guideCommand}`\uB97C \uB530\uB77C 4\uAC1C\uC758 \uC5F0\uAD00 \uC774\uC288\uB85C \uBD84\uB9AC\uD558\uACE0 \uC758\uC874 \uC21C\uC11C\uB97C \uBA85\uC2DC\uD55C \uB4A4 PR\uC744 \uC21C\uCC28 \uBA38\uC9C0\uD558\uC138\uC694. \uAC01 \uC774\uC288 \uD15C\uD50C\uB9BF: \uBAA9\uD45C, \uD3EC\uD568 \uBC94\uC704, \uC81C\uC678 \uBC94\uC704, \uC120\uD589 \uC758\uC874\uC131, PR \uC644\uB8CC \uAE30\uC900.",
   userRequestReplan: "\uD604\uC7AC \uB2E8\uACC4\uC640 \uBCC4\uAC1C\uB85C \uC0AC\uC6A9\uC790\uAC00 \uC81C\uC548\uD55C \uC0C8 \uC694\uAD6C\uB97C \uBA3C\uC800 \uBC18\uC601\uD560 \uC218 \uC788\uC2B5\uB2C8\uB2E4. \uC694\uAD6C\uC0AC\uD56D\uC744 \uC694\uC57D\uD574 tasks.md\uC5D0 \uCD94\uAC00\uD558\uAC70\uB098 \uBCC4\uB3C4 Feature\uB85C \uBD84\uB9AC\uD55C \uB4A4, \uBB38\uC11C \uC0C1\uD0DC\uB97C \uB9DE\uCD94\uACE0 context\uB97C \uB2E4\uC2DC \uC2E4\uD589\uD558\uC138\uC694.",
+  docsUnmanagedNormalize: "lee-spec-kit \uBB38\uC11C \uD45C\uBA74 \uBC16\uC758 \uBB38\uC11C \uC5D4\uD2B8\uB9AC\uAC00 \uAC10\uC9C0\uB418\uC5C8\uC2B5\uB2C8\uB2E4: {paths}. Feature `{featureRef}`\uB97C \uACC4\uC18D \uC9C4\uD589\uD558\uAE30 \uC804\uC5D0 \uC774 \uBB38\uC11C\uB4E4\uC740 reference \uC785\uB825\uC73C\uB85C\uB9CC \uCDE8\uAE09\uD558\uC138\uC694. \uC0AC\uC6A9\uC790 \uBC94\uC704/acceptance\uB294 `spec.md`, \uC544\uD0A4\uD14D\uCC98/\uD30C\uC77C/\uD14C\uC2A4\uD2B8 \uB0B4\uC6A9\uC740 `plan.md`, \uC2E4\uD589 \uC791\uC5C5\uC740 `tasks.md`, \uADFC\uAC70/\uD2B8\uB808\uC774\uB4DC\uC624\uD504\uB294 `decisions.md`\uB85C \uC815\uADDC\uD654\uD55C \uB4A4 `npx lee-spec-kit context {featureRef}`\uB97C \uB2E4\uC2DC \uC2E4\uD589\uD558\uC138\uC694.",
   featureDone: "\uC6CC\uD06C\uD50C\uB85C\uC6B0 \uC694\uAD6C\uC0AC\uD56D\uACFC \uB85C\uCEEC \uC815\uB9AC\uAE4C\uC9C0 \uBAA8\uB450 \uB05D\uB0AC\uC2B5\uB2C8\uB2E4. \uC774 Feature\uB294 \uC644\uC804\uD788 \uC885\uB8CC\uB418\uC5C8\uC2B5\uB2C8\uB2E4.",
   fallbackRerunContext: "\uC0C1\uD0DC\uB97C \uD310\uBCC4\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4. \uBB38\uC11C\uB97C \uD655\uC778\uD55C \uB4A4 \uB2E4\uC2DC context\uB97C \uC2E4\uD589\uD558\uC138\uC694."
 };
@@ -695,6 +692,7 @@ var koWarnings = {
   workflowWorktreeRequired: "`workflow.requireWorktree=true` \uC124\uC815\uC73C\uB85C \uC778\uD574 \uD0DC\uC2A4\uD06C \uC2E4\uD589\uC740 `.worktrees/*` \uACBD\uB85C\uC5D0\uC11C\uB9CC \uD5C8\uC6A9\uB429\uB2C8\uB2E4.",
   docsGitUnavailable: "docs \uB808\uD3EC\uC758 git \uC0C1\uD0DC\uB97C \uD655\uC778\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4. (\uB808\uD3EC \uC704\uCE58 / git init \uD655\uC778)",
   docsPathIgnored: "\uD604\uC7AC Feature \uBB38\uC11C \uACBD\uB85C\uAC00 git ignore \uB300\uC0C1\uC785\uB2C8\uB2E4: {path} (docs \uCEE4\uBC0B \uAC10\uC9C0\uAC00 \uC81C\uD55C\uB420 \uC218 \uC788\uC2B5\uB2C8\uB2E4.)",
+  unmanagedDocsEntries: "lee-spec-kit \uBB38\uC11C \uD45C\uBA74 \uBC16\uC758 \uBB38\uC11C \uC5D4\uD2B8\uB9AC\uAC00 \uC788\uC2B5\uB2C8\uB2E4: {paths}. reference \uC785\uB825\uC73C\uB85C\uB9CC \uCDE8\uAE09\uD558\uACE0, \uACC4\uC18D \uC9C4\uD589\uD558\uAE30 \uC804\uC5D0 feature-local docs\uB85C \uC815\uADDC\uD654\uD558\uC138\uC694.",
   docsUncommittedChanges: "\uBB38\uC11C \uBCC0\uACBD\uC0AC\uD56D\uC774 \uCEE4\uBC0B\uB418\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4. (\uCD94\uAC00 \uBB38\uC11C \uCEE4\uBC0B \uD544\uC694) \uCEE4\uBC0B \uBA54\uC2DC\uC9C0 \uADDC\uCE59\uC740 git-workflow \uAC00\uC774\uB4DC\uB97C \uAE30\uC900\uC73C\uB85C \uD655\uC778\uD558\uC138\uC694.",
   projectUncommittedChanges: "\uD504\uB85C\uC81D\uD2B8 \uCF54\uB4DC \uBCC0\uACBD\uC0AC\uD56D\uC774 \uCEE4\uBC0B\uB418\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4. (\uCD94\uAC00 \uCF54\uB4DC \uCEE4\uBC0B \uD544\uC694)",
   featureScopeSplitSuggested: "Feature \uBC94\uC704\uAC00 \uB2E8\uC77C \uC774\uC288\uB85C \uCC98\uB9AC\uD558\uAE30\uC5D0 \uD07D\uB2C8\uB2E4. (tasks: {taskCount}, decisions \uC904\uC218: {decisionsLineCount}; \uBD84\uD560 \uC81C\uC548 \uAE30\uC900: tasks {taskThreshold}\uAC1C \uB610\uB294 decisions {decisionsThreshold}\uC904) \uD604\uC7AC \uAD8C\uC7A5 \uBD84\uD560: {recommendedIssues}\uAC1C \uC774\uC288 (4\uBD84\uD560 \uD558\uB4DC \uAE30\uC900: tasks >= {recommendFourTaskThreshold} \uB610\uB294 decisions \uC904\uC218 >= {recommendFourDecisionsThreshold}).",
@@ -767,12 +765,7 @@ var enCli = {
   "update.langLabel": "Lang",
   "update.typeLabel": "Type",
   "update.updatingAgents": "\u{1F4C1} Updating agents/ folder...",
-  "update.updatingSkills": "\u{1F4C1} Updating agents/skills folder...",
   "update.agentsUpdated": "agents/ updated",
-  "update.skillsUpdated": "agents/skills updated",
-  "update.updatingFeatureBase": "\u{1F4C1} Updating features/feature-base/ folder...",
-  "update.engineManagedSkillsBuiltin": "agents/skills is CLI-managed and is not synced into docs.",
-  "update.engineManagedFeatureBaseBuiltin": "features/feature-base is CLI-managed and is not synced into docs.",
   "update.engineManagedPruned": "Removed {count} CLI-managed docs entries from this docs tree.",
   "update.filesUpdated": "{count} files updated",
   "update.updatedTotal": "Updated {count} files!",
@@ -797,6 +790,7 @@ var enCli = {
   "doctor.issue.tasksDocStatusUnset": "tasks.md Doc Status is not set. (Set it to Draft, Review, or Approved.)",
   "doctor.issue.tasksDocStatusMissing": "tasks.md is missing the Doc Status field. Add `- **Doc Status**: -` and `Values: Draft | Review | Approved`.",
   "doctor.issue.tasksPrdTagUnknown": "tasks.md uses PRD tags with no matching source definition: {ids}{extra}. Do not invent IDs like PRD-FR-001 in tasks.md. Backfill IDs in docs/prd or the upstream requirements doc first, then align spec.md `PRD Refs` and task tags.",
+  "doctor.issue.unmanagedDocsEntry": "Unmanaged docs entry detected outside the lee-spec-kit docs surface: {path}. Treat it as reference input only, normalize it into feature-local docs, or allowlist it in `.lee-spec-kit.json` `allowedDocsEntries`.",
   "doctor.issue.duplicateFeatureId": "Duplicate Feature ID detected: {id} ({count})",
   "doctor.issue.missingFeatureId": "Feature folder name is not in F001-... format. (Cannot extract ID)",
   "init.selectLangPrompt": "Select docs language:",
@@ -1263,6 +1257,7 @@ var enMessages = {
   featureScopeSplitTwo: "Feature scope is large (tasks: {taskCount}, decisions lines: {decisionsLineCount}). Recommendation rule: 40~79 tasks and below the hard threshold usually maps to 2 issues. Follow `{guideCommand}` and split by coupling/file-overlap/test/deploy criteria. For each new issue, document this template: Goal, Included Scope, Excluded Scope, Depends On, PR Done Criteria.",
   featureScopeSplitFour: "Feature scope is large (tasks: {taskCount}, decisions lines: {decisionsLineCount}). Hard recommendation is 4 issues when tasks >= {recommendFourTaskThreshold} or decisions lines >= {recommendFourDecisionsThreshold}. Follow `{guideCommand}` and split into 4 linked issues with explicit dependency order and sequential PR merges. Use the per-issue template: Goal, Included Scope, Excluded Scope, Depends On, PR Done Criteria.",
   userRequestReplan: "You can pause this step and handle a newly requested user requirement first. Summarize it, add it to tasks.md or split it into a separate Feature, then align document statuses and rerun context.",
+  docsUnmanagedNormalize: "Unmanaged docs entries were found outside the lee-spec-kit docs surface: {paths}. Before continuing feature `{featureRef}`, treat them as reference inputs only. Normalize user-facing scope and acceptance into `spec.md`, architecture/file/test details into `plan.md`, executable work into `tasks.md`, and rationale/trade-offs into `decisions.md`, then rerun `npx lee-spec-kit context {featureRef}`.",
   featureDone: "All workflow requirements and local cleanup are complete. This feature is fully finished.",
   fallbackRerunContext: "Cannot determine status. Check the docs and run context again."
 };
@@ -1274,6 +1269,7 @@ var enWarnings = {
   workflowWorktreeRequired: "With `workflow.requireWorktree=true`, task execution is allowed only from `.worktrees/*` paths.",
   docsGitUnavailable: "Cannot read git status for the docs repo. (Check repo location / git init.)",
   docsPathIgnored: "Current feature docs path is ignored by git: {path} (docs commit detection may be limited).",
+  unmanagedDocsEntries: "Unmanaged docs entries are present outside the lee-spec-kit docs surface: {paths}. Treat them as reference inputs only and normalize them into feature-local docs before continuing.",
   docsUncommittedChanges: "Docs changes are not committed. (Additional docs commit needed.) Check commit message rules against the git-workflow guide.",
   projectUncommittedChanges: "Project code changes are not committed. (Additional code commit needed.)",
   featureScopeSplitSuggested: "Feature scope may be too large for one issue (tasks: {taskCount}, decisions lines: {decisionsLineCount}; suggest split at {taskThreshold} tasks or {decisionsThreshold} decision lines). Current recommendation: split into {recommendedIssues} issue units (hard 4-way rule: tasks >= {recommendFourTaskThreshold} or decisions lines >= {recommendFourDecisionsThreshold}).",
@@ -2048,7 +2044,7 @@ In approval-waiting state:
 2. End with \`approvalRequest.finalPrompt\` exactly as provided.
 3. Do not paraphrase or omit these lines.
 4. Prefer \`approvalRequest.userFacingLines\` as the source for user-facing approval text.
-5. Prefer \`matchedFeature.currentSubstateOwner\` plus \`agentOrchestration.subAgentHandoff\` as the delegation SSOT. Treat \`currentActionShouldDelegate\` as a compatibility mirror for older consumers.
+5. Prefer \`matchedFeature.currentSubstateOwner\` plus \`agentOrchestration.subAgentHandoff\` as the delegation SSOT.
 6. When \`matchedFeature.currentSubstateOwner="subagent"\` and \`agentOrchestration.subAgentHandoff.required=true\` with \`mode="command"\`, call \`spawn_agent\` first and do not execute the delegated command directly from the main agent. If the delegated command is handoff-only, continue the delegated work immediately and do not re-open the same approval label.
 
 In non-approval state (progress updates, analysis, tool execution logs, unrelated Q&A):
@@ -2103,15 +2099,20 @@ async function upsertLeeSpecKitAgentsMd(filePath, options) {
 }
 var LEE_SPEC_KIT_CODEX_BOOTSTRAP_BEGIN = "# lee-spec-kit:codex-bootstrap:begin";
 var LEE_SPEC_KIT_CODEX_BOOTSTRAP_END = "# lee-spec-kit:codex-bootstrap:end";
-var REQUIRED_FALLBACK = "docs/AGENTS.md";
+var REQUIRED_FALLBACKS = ["AGENTS.md", "docs/AGENTS.md"];
 var REQUIRED_COMPACT_LINES = [
+  "Preserve any instructions loaded from ./AGENTS.md or ./docs/AGENTS.md in the compacted summary.",
+  "After context compression/reset, read ./AGENTS.md or ./docs/AGENTS.md again before resuming project-specific work."
+];
+var LEGACY_FALLBACKS = ["docs/AGENTS.md"];
+var LEGACY_COMPACT_LINES = [
   "Preserve any instructions loaded from ./docs/AGENTS.md in the compacted summary.",
   "After context compression/reset, read ./docs/AGENTS.md again before resuming project-specific work."
 ];
 function renderManagedSegment2() {
   return [
     LEE_SPEC_KIT_CODEX_BOOTSTRAP_BEGIN,
-    `project_doc_fallback_filenames = ["${REQUIRED_FALLBACK}"]`,
+    `project_doc_fallback_filenames = ["${REQUIRED_FALLBACKS.join('", "')}"]`,
     'compact_prompt = """',
     ...REQUIRED_COMPACT_LINES,
     '"""',
@@ -2132,7 +2133,9 @@ function getCodexConfigPath() {
   return path15.join(getCodexHome(), "config.toml");
 }
 function contentIncludesRequiredBootstrap(content) {
-  return content.includes(REQUIRED_FALLBACK) && REQUIRED_COMPACT_LINES.every((line) => content.includes(line));
+  const matchesCurrent = REQUIRED_FALLBACKS.every((value) => content.includes(value)) && REQUIRED_COMPACT_LINES.every((line) => content.includes(line));
+  const matchesLegacy = LEGACY_FALLBACKS.every((value) => content.includes(value)) && LEGACY_COMPACT_LINES.every((line) => content.includes(line));
+  return matchesCurrent || matchesLegacy;
 }
 function hasConflictingTopLevelKey(content, key) {
   const keyPattern = new RegExp(`^\\s*${key}\\s*=`, "m");
@@ -2367,6 +2370,7 @@ async function getConfig(cwd) {
             pushDocs: configFile.pushDocs,
             docsRemote: configFile.docsRemote,
             projectRoot: configFile.projectRoot,
+            allowedDocsEntries: configFile.allowedDocsEntries,
             pr: configFile.pr,
             workflow: configFile.workflow,
             approval: configFile.approval
@@ -3863,6 +3867,7 @@ var ACTION_CATEGORIES = [
   "plan_approve",
   "tasks_write",
   "tasks_approve",
+  "docs_normalize",
   "docs_commit",
   "issue_create",
   "branch_create",
@@ -3882,7 +3887,7 @@ var ACTION_CATEGORIES = [
   "feature_done",
   "fallback"
 ];
-var LEGACY_LONG_RUNNING_DELEGATION_CATEGORIES = [
+var SUBAGENT_HANDOFF_CATEGORIES = [
   "task_execute",
   "code_review_run",
   "code_review",
@@ -4346,7 +4351,7 @@ function countDoneTransitionsInLatestTasksCommit(ctx, feature) {
   if (!diff.trim()) return 0;
   const removedByTask = /* @__PURE__ */ new Map();
   const addedByTask = /* @__PURE__ */ new Map();
-  const parseTaskLine3 = (line) => {
+  const parseTaskLine2 = (line) => {
     const match = line.match(
       /^\s*-\s*\[(TODO|DOING|DONE|REVIEW)\]\s+(.+?)\s*$/i
     );
@@ -4361,7 +4366,7 @@ function countDoneTransitionsInLatestTasksCommit(ctx, feature) {
   for (const line of diff.split("\n")) {
     if (line.startsWith("---") || line.startsWith("+++")) continue;
     if (line.startsWith("-")) {
-      const parsed = parseTaskLine3(line.slice(1));
+      const parsed = parseTaskLine2(line.slice(1));
       if (!parsed) continue;
       const existing = removedByTask.get(parsed.key) || /* @__PURE__ */ new Set();
       existing.add(parsed.status);
@@ -4369,7 +4374,7 @@ function countDoneTransitionsInLatestTasksCommit(ctx, feature) {
       continue;
     }
     if (line.startsWith("+")) {
-      const parsed = parseTaskLine3(line.slice(1));
+      const parsed = parseTaskLine2(line.slice(1));
       if (!parsed) continue;
       const existing = addedByTask.get(parsed.key) || /* @__PURE__ */ new Set();
       existing.add(parsed.status);
@@ -5663,35 +5668,12 @@ function normalizeApprovalToken(value) {
   return (value ?? "").trim().toLowerCase();
 }
 function applyApprovalPolicy(step, actions, approval, currentSubstatePhase) {
-  const taskExecuteCheckPolicy = approval?.taskExecuteCheck === "start_only" ? "start_only" : "both";
-  if (!approval) {
-    return actions.map((action) => ({
-      ...action,
-      requiresUserCheck: applyTaskExecutePhaseCheck(
-        action,
-        Boolean(action.requiresUserCheck),
-        taskExecuteCheckPolicy,
-        false,
-        currentSubstatePhase
-      )
-    }));
-  }
-  const mode = approval.mode ?? "builtin";
-  if (mode === "builtin") {
-    return actions.map((action) => ({
-      ...action,
-      requiresUserCheck: applyTaskExecutePhaseCheck(
-        action,
-        Boolean(action.requiresUserCheck),
-        taskExecuteCheckPolicy,
-        false,
-        currentSubstatePhase
-      )
-    }));
-  }
+  const effectiveApproval = approval ?? createDefaultApprovalConfig();
+  const taskExecuteCheckPolicy = effectiveApproval.taskExecuteCheck === "start_only" ? "start_only" : "both";
+  const mode = effectiveApproval.mode ?? "category";
   if (mode === "steps") {
     const required = new Set(
-      (approval.requireCheckSteps ?? approval.requireOkSteps ?? []).map((n) => typeof n === "number" ? n : Number(n)).filter((n) => Number.isFinite(n))
+      (effectiveApproval.requireCheckSteps ?? []).map((n) => typeof n === "number" ? n : Number(n)).filter((n) => Number.isFinite(n))
     );
     const requiresUserCheck = required.has(step);
     return actions.map((action) => ({
@@ -5706,12 +5688,12 @@ function applyApprovalPolicy(step, actions, approval, currentSubstatePhase) {
     }));
   }
   const requiredCategories = new Set(
-    (approval.requireCheckCategories ?? approval.requireOkCategories ?? []).map((c) => normalizeApprovalToken(c)).filter(Boolean)
+    (effectiveApproval.requireCheckCategories ?? []).map((c) => normalizeApprovalToken(c)).filter(Boolean)
   );
   const skippedCategories = new Set(
-    (approval.skipCheckCategories ?? approval.skipOkCategories ?? []).map((c) => normalizeApprovalToken(c)).filter(Boolean)
+    (effectiveApproval.skipCheckCategories ?? []).map((c) => normalizeApprovalToken(c)).filter(Boolean)
   );
-  const defaultPolicy = approval.default ?? "keep";
+  const defaultPolicy = effectiveApproval.default ?? "keep";
   return actions.map((a) => {
     const builtin = Boolean(a.requiresUserCheck);
     const category = normalizeApprovalToken(a.category ?? "uncategorized");
@@ -7976,21 +7958,18 @@ function hasOwnKey(value, key) {
 }
 function isLegacyGeneratedApprovalConfig(approval) {
   const mode = typeof approval.mode === "string" ? approval.mode : "";
-  if (mode && mode !== "builtin") return false;
+  if (mode && mode !== "category" && mode !== "steps") return false;
   const overrideKeys = [
     "default",
     "requireCheckSteps",
-    "requireOkSteps",
     "requireCheckCategories",
-    "requireOkCategories",
     "skipCheckCategories",
-    "skipOkCategories",
     "taskExecuteCheck"
   ];
   return !overrideKeys.some((key) => hasOwnKey(approval, key));
 }
 function updateCommand(program2) {
-  program2.command("update").description("Update docs templates to the latest version").option("--agents", "Update agents/ folder only").option("--agents-md", "Sync project-scoped AGENTS.md entrypoint").option("--skills", "Cleanup legacy agents/skills copies (CLI-managed)").option("--templates", "Cleanup legacy feature-base copies (CLI-managed)").option(
+  program2.command("update").description("Update docs templates to the latest version").option("--agents", "Update agents/ folder only").option("--agents-md", "Sync project-scoped AGENTS.md entrypoint").option(
     "-f, --force",
     "Force overwrite even if docs has uncommitted changes"
   ).action(async (options) => {
@@ -8033,11 +8012,9 @@ async function runUpdate(options) {
       const docsLockPath = getDocsLockPath(docsDir);
       const forceOverwrite = !!options.force || await isDocsWorktreeCleanOrThrow(docsDir, lang, [docsLockPath]);
       const configBackfill = await backfillMissingConfigDefaults(docsDir);
-      const hasExplicitSelection = !!(options.agents || options.agentsMd || options.skills || options.templates);
-      const updateAgents = options.agents || options.skills || !hasExplicitSelection;
+      const hasExplicitSelection = !!(options.agents || options.agentsMd);
+      const updateAgents = options.agents || !hasExplicitSelection;
       const updateAgentsMd = options.agentsMd || !hasExplicitSelection;
-      const updateTemplates = options.templates || !hasExplicitSelection;
-      const agentsMode = options.skills && !options.agents ? "skills" : "all";
       console.log(chalk9.blue(tr(lang, "cli", "update.start")));
       console.log(chalk9.gray(`  - ${tr(lang, "cli", "update.langLabel")}: ${lang}`));
       console.log(
@@ -8046,50 +8023,40 @@ async function runUpdate(options) {
       console.log();
       let updatedCount = 0;
       if (updateAgents) {
-        if (agentsMode === "skills") {
-          console.log(chalk9.blue(tr(lang, "cli", "update.updatingSkills")));
-          console.log(
-            chalk9.gray(tr(lang, "cli", "update.engineManagedSkillsBuiltin"))
-          );
-          console.log(chalk9.green(`  \u2705 ${tr(lang, "cli", "update.skillsUpdated")}`));
-        } else {
-          console.log(chalk9.blue(tr(lang, "cli", "update.updatingAgents")));
-        }
-        if (agentsMode === "all") {
-          const commonAgentsBase = path15.join(templatesDir, lang, "common", "agents");
-          const targetAgentsBase = path15.join(docsDir, "agents");
-          const commonAgents = commonAgentsBase;
-          const targetAgents = targetAgentsBase;
-          const featurePath = projectType === "multi" ? "docs/features/{component}" : "docs/features";
-          const projectName = config.projectName ?? "{{projectName}}";
-          const commonReplacements = {
-            "{{projectName}}": projectName,
-            "{{featurePath}}": featurePath
-          };
-          if (await fs.pathExists(commonAgents)) {
-            const count = await updateFolder(
-              commonAgents,
-              targetAgents,
-              forceOverwrite,
-              commonReplacements,
-              lang,
-              {
-                protectedFiles: /* @__PURE__ */ new Set([
-                  "custom.md",
-                  "constitution.md",
-                  ...ENGINE_MANAGED_AGENT_FILES
-                ]),
-                skipDirectories: new Set(ENGINE_MANAGED_AGENT_DIRS)
-              }
-            );
-            updatedCount += count;
-          }
-          console.log(
-            chalk9.green(
-              `  \u2705 ${tr(lang, "cli", "update.agentsUpdated")}`
-            )
+        console.log(chalk9.blue(tr(lang, "cli", "update.updatingAgents")));
+        const commonAgentsBase = path15.join(templatesDir, lang, "common", "agents");
+        const targetAgentsBase = path15.join(docsDir, "agents");
+        const commonAgents = commonAgentsBase;
+        const targetAgents = targetAgentsBase;
+        const featurePath = projectType === "multi" ? "docs/features/{component}" : "docs/features";
+        const projectName = config.projectName ?? "{{projectName}}";
+        const commonReplacements = {
+          "{{projectName}}": projectName,
+          "{{featurePath}}": featurePath
+        };
+        if (await fs.pathExists(commonAgents)) {
+          const count = await updateFolder(
+            commonAgents,
+            targetAgents,
+            forceOverwrite,
+            commonReplacements,
+            lang,
+            {
+              protectedFiles: /* @__PURE__ */ new Set([
+                "custom.md",
+                "constitution.md",
+                ...ENGINE_MANAGED_AGENT_FILES
+              ]),
+              skipDirectories: new Set(ENGINE_MANAGED_AGENT_DIRS)
+            }
           );
+          updatedCount += count;
         }
+        console.log(
+          chalk9.green(
+            `  \u2705 ${tr(lang, "cli", "update.agentsUpdated")}`
+          )
+        );
       }
       if (updateAgentsMd) {
         const agentsMdTargets = await collectAgentsMdTargets(cwd, config);
@@ -8103,10 +8070,6 @@ async function runUpdate(options) {
           }
         }
       }
-      if (updateTemplates) {
-        console.log(chalk9.blue(tr(lang, "cli", "update.updatingFeatureBase")));
-        console.log(chalk9.gray(tr(lang, "cli", "update.engineManagedFeatureBaseBuiltin")));
-      }
       const pruned = await pruneEngineManagedDocs(docsDir);
       if (pruned.length > 0) {
         console.log(
@@ -8696,15 +8659,15 @@ function getBuiltinDocIds() {
 function normalizeBuiltinDocId(input) {
   const normalized = input.trim().toLowerCase().replace(/_/g, "-");
   if (normalized === "git-workflow") return "git-workflow";
-  if (normalized === "issue-doc" || normalized === "issue-md") return "issue-doc";
-  if (normalized === "pr-doc" || normalized === "pr-md") return "pr-doc";
+  if (normalized === "issue-doc") return "issue-doc";
+  if (normalized === "pr-doc") return "pr-doc";
   if (normalized === "issue-template") return "issue-doc";
   if (normalized === "pr-template") return "pr-doc";
   if (normalized === "create-feature") return "create-feature";
   if (normalized === "execute-task") return "execute-task";
   if (normalized === "create-issue") return "create-issue";
   if (normalized === "create-pr") return "create-pr";
-  if (normalized === "split-feature" || normalized === "feature-split") {
+  if (normalized === "split-feature") {
     return "split-feature";
   }
   if (normalized === "agents") return "agents";
@@ -8766,6 +8729,68 @@ function resolveComponentOption(value) {
   const component = (value || "").trim().toLowerCase();
   return component || void 0;
 }
+var DEFAULT_MANAGED_DOC_DIRS = [
+  "agents",
+  "designs",
+  "features",
+  "ideas",
+  "prd",
+  "scripts"
+];
+var DEFAULT_MANAGED_DOC_FILES = [
+  "README.md",
+  ".lee-spec-kit.json",
+  ".gitignore"
+];
+var DOC_LIKE_FILE_EXTENSIONS = /* @__PURE__ */ new Set([
+  ".md",
+  ".mdx",
+  ".txt",
+  ".rst",
+  ".adoc"
+]);
+function normalizeEntryName(value) {
+  return value.trim().toLowerCase();
+}
+function toAllowedSet(values, extras) {
+  return new Set(
+    [...values, ...extras || []].map((entry) => normalizeEntryName(entry)).filter(Boolean)
+  );
+}
+function isDocLikeFile(name) {
+  return DOC_LIKE_FILE_EXTENSIONS.has(path15.extname(name).toLowerCase());
+}
+async function collectUnmanagedDocsEntries(docsDir, allowed) {
+  const allowedDirs = toAllowedSet(DEFAULT_MANAGED_DOC_DIRS, allowed?.dirs);
+  const allowedFiles = toAllowedSet(DEFAULT_MANAGED_DOC_FILES, allowed?.files);
+  const entries = await fs.readdir(docsDir, { withFileTypes: true });
+  const unmanaged = [];
+  for (const entry of entries) {
+    const name = entry.name || "";
+    if (!name) continue;
+    if (entry.isDirectory()) {
+      if (name.startsWith(".")) continue;
+      if (allowedDirs.has(normalizeEntryName(name))) continue;
+      unmanaged.push({
+        name,
+        kind: "dir",
+        absPath: path15.join(docsDir, name),
+        relPath: `docs/${name}`
+      });
+      continue;
+    }
+    if (!entry.isFile()) continue;
+    if (allowedFiles.has(normalizeEntryName(name))) continue;
+    if (!isDocLikeFile(name)) continue;
+    unmanaged.push({
+      name,
+      kind: "file",
+      absPath: path15.join(docsDir, name),
+      relPath: `docs/${name}`
+    });
+  }
+  return unmanaged.sort((a, b) => a.relPath.localeCompare(b.relPath));
+}
 
 // src/utils/context-selection.ts
 var REMOTE_ACTION_CATEGORIES = /* @__PURE__ */ new Set([
@@ -9059,6 +9084,13 @@ function toReasonCode(status) {
 async function resolveContextSelection(ctx, featureName, options) {
   const { config } = ctx;
   const { features, branches, warnings } = await scanFeatures(ctx);
+  const unmanagedDocs = await collectUnmanagedDocsEntries(
+    config.docsDir,
+    config.allowedDocsEntries
+  );
+  const unmanagedDocsWarning = unmanagedDocs.length > 0 ? tr(config.lang, "warnings", "unmanagedDocsEntries", {
+    paths: unmanagedDocs.map((entry) => entry.relPath).join(", ")
+  }) : "";
   const selectedComponent = resolveComponentOption(options.component);
   const scopedFeatures = selectedComponent ? features.filter((f) => f.type === selectedComponent) : features;
   const doneFeatures = scopedFeatures.filter((f) => f.completion.workflowDone);
@@ -9129,14 +9161,36 @@ async function resolveContextSelection(ctx, featureName, options) {
     openFeatures,
     targetFeatures
   );
-  const matchedFeature = targetFeatures.length === 1 ? targetFeatures[0] : null;
+  const baseMatchedFeature = targetFeatures.length === 1 ? targetFeatures[0] : null;
+  let matchedFeature = baseMatchedFeature;
+  if (baseMatchedFeature && !baseMatchedFeature.completion.workflowDone && unmanagedDocs.length > 0) {
+    const normalizeMessage = tr(config.lang, "messages", "docsUnmanagedNormalize", {
+      paths: unmanagedDocs.map((entry) => entry.relPath).join(", "),
+      featureRef: baseMatchedFeature.folderName
+    });
+    matchedFeature = {
+      ...baseMatchedFeature,
+      currentSubstateId: "docs_unmanaged_normalize",
+      currentSubstateOwner: "main",
+      currentSubstatePhase: "blocked",
+      warnings: unmanagedDocsWarning ? [...baseMatchedFeature.warnings, unmanagedDocsWarning] : [...baseMatchedFeature.warnings],
+      actions: [
+        {
+          type: "instruction",
+          category: "docs_normalize",
+          message: normalizeMessage
+        }
+      ],
+      nextAction: normalizeMessage
+    };
+  }
   const actions = annotateActions(matchedFeature?.actions ?? []);
   const actionOptions = toActionOptions(actions, config.lang);
   const contextVersion = getContextVersion(matchedFeature, actionOptions);
   return {
     features: scopedFeatures,
     branches,
-    warnings,
+    warnings: unmanagedDocsWarning ? [...warnings, unmanagedDocsWarning] : warnings,
     doneFeatures,
     openFeatures,
     inProgressFeatures,
@@ -9186,14 +9240,12 @@ function isTaskExecuteProjectCommitCommand(option) {
 function shouldDelegateCurrentAction(actionOptions, currentSubstateOwner) {
   const primaryOption = actionOptions[0];
   const primaryCategory = primaryOption?.action?.category || null;
-  const longRunningSet = new Set(
-    LEGACY_LONG_RUNNING_DELEGATION_CATEGORIES
-  );
+  const handoffCategories = new Set(SUBAGENT_HANDOFF_CATEGORIES);
   const isCommand = primaryOption?.action?.type === "command";
   const isRemoteCommand = isCommand && primaryOption?.action?.operationType === "remote";
   const ownerDelegates = currentSubstateOwner === "subagent";
-  const legacyCategoryDelegates = !currentSubstateOwner && !!primaryCategory && longRunningSet.has(primaryCategory);
-  const shouldDelegate = (ownerDelegates || legacyCategoryDelegates) && isCommand && !isRemoteCommand && !isTaskExecuteProjectCommitCommand(primaryOption);
+  const categoryFallbackDelegates = !currentSubstateOwner && !!primaryCategory && handoffCategories.has(primaryCategory);
+  const shouldDelegate = (ownerDelegates || categoryFallbackDelegates) && isCommand && !isRemoteCommand && !isTaskExecuteProjectCommitCommand(primaryOption);
   return {
     shouldDelegate,
     category: primaryCategory
@@ -9222,15 +9274,6 @@ function buildAgentOrchestrationPolicy(actionOptions, autoRunAvailable, autoRunC
   ).digest("hex").slice(0, 12) : "";
   return {
     mode: "main_orchestrates_subagent_execution",
-    delegationPolicy: "prefer_main_delegate_long_running_fallback_main",
-    delegateCommandExecution: "long_running_only",
-    delegateAutoRunExecution: true,
-    fallbackToMainAgentWhenSubAgentUnavailable: true,
-    longRunningCategories: [...LEGACY_LONG_RUNNING_DELEGATION_CATEGORIES],
-    currentActionShouldDelegate: delegation.shouldDelegate,
-    autoRunDelegationAvailable: autoRunAvailable,
-    autoRunShouldDelegate: shouldDelegateAutoRunNow,
-    currentActionCategory: delegation.category,
     mainAgentResponsibilities: [
       "Keep user conversation state and approval boundaries",
       "Run the same execution loop directly when sub-agent is unavailable",
@@ -9376,7 +9419,7 @@ function buildDelegatedApprovalGuidance(handoffRequired, handoffMode) {
   const base = "Before asking for approval, show only `actionOptions[].approvalPrompt` lines and `approvalRequest.finalPrompt` to the user. Keep `requiredDocs`, `checkPolicy`, and raw execution commands as internal guidance. For commit actions, include scope (`docs`/`project`) and commit message in the visible prompt. User replies should include the label token (e.g. `A`, `A OK`, `A proceed`, `A \uC9C4\uD589\uD574`).";
   const delegatedCommand = handoffRequired && handoffMode === "command" ? ' When `matchedFeature.currentSubstateOwner="subagent"` and `agentOrchestration.subAgentHandoff.required=true` with `mode="command"`, call spawn_agent first and do not execute the delegated command directly from the main agent. If the delegated command is handoff-only, `--execute` only prepares the handoff; continue the delegated work immediately and do not re-approve the same label.' : "";
   const nonDelegated = " For non-delegated command actions, prefer one-shot `npx lee-spec-kit flow <featureRef> --approve <LABEL> --execute` to avoid session mismatch after context compression/reset. Use ticket-based `context --execute --ticket` only when explicitly needed.";
-  const orchestration = ' Use main-agent orchestration: keep short steps in main agent. Prefer `matchedFeature.currentSubstateOwner` + `agentOrchestration.subAgentHandoff` as the delegation SSOT; `currentActionShouldDelegate` is a compatibility mirror. Delegate auto-run only when `agentOrchestration.subAgentHandoff.required=true` with `mode="auto_run"`.';
+  const orchestration = ' Use main-agent orchestration: keep short steps in main agent. Prefer `matchedFeature.currentSubstateOwner` + `agentOrchestration.subAgentHandoff` as the delegation SSOT. Delegate auto-run only when `agentOrchestration.subAgentHandoff.required=true` with `mode="auto_run"`.';
   return `${base}${delegatedCommand}${nonDelegated}${orchestration}`;
 }
 function buildFinalApprovalPrompt(lang, actionOptions) {
@@ -9415,7 +9458,7 @@ function resolveAutoRunCategories(approval) {
   const known = new Set(ACTION_CATEGORIES);
   const unique2 = /* @__PURE__ */ new Set();
   const unknown = /* @__PURE__ */ new Set();
-  for (const raw of approval?.requireCheckCategories ?? approval?.requireOkCategories ?? []) {
+  for (const raw of approval?.requireCheckCategories ?? []) {
     const normalized = normalizeCategoryToken(raw);
     if (!normalized) continue;
     if (known.has(normalized)) {
@@ -9450,7 +9493,7 @@ function resolveAutoRunPlan(lang, state, featureName, selectedComponent, approva
   if (state.status !== "single_matched") return base("NOT_SINGLE_MATCHED");
   if (state.actionOptions.length === 0) return base("NO_ACTION_OPTIONS");
   if (approvalRequired) return base("APPROVAL_REQUIRED");
-  const mode = approval?.mode ?? "builtin";
+  const mode = approval?.mode ?? "category";
   if (mode !== "category") return base("APPROVAL_MODE_NOT_CATEGORY");
   const defaultPolicy = approval?.default ?? "keep";
   if (defaultPolicy !== "skip") return base("DEFAULT_NOT_SKIP");
@@ -9780,7 +9823,6 @@ function parseApprovalReply(input, validLabels) {
   }
   return null;
 }
-var LEGACY_APPROVAL_TICKET_FILENAME = ".lee-spec-kit.approval-tickets.json";
 var APPROVAL_TICKET_TTL_MS = 5 * 60 * 1e3;
 function getApprovalSessionId() {
   const explicit = (process.env.LEE_SPEC_KIT_SESSION_ID || "").trim();
@@ -9789,12 +9831,6 @@ function getApprovalSessionId() {
   if (terminalSession) return terminalSession;
   return "";
 }
-function getApprovalTicketPaths(config) {
-  return {
-    runtimePath: getApprovalTicketStorePath(config.docsDir),
-    legacyPath: path15.join(config.docsDir, LEGACY_APPROVAL_TICKET_FILENAME)
-  };
-}
 async function loadApprovalTicketStore(storePath) {
   if (!await fs.pathExists(storePath)) return { tickets: [] };
   try {
@@ -9817,32 +9853,11 @@ function pruneApprovalTickets(tickets, nowMs) {
     return expiresAtMs > nowMs;
   });
 }
-async function resolveApprovalTicketStoreAndPath(config, nowMs) {
-  const { runtimePath, legacyPath } = getApprovalTicketPaths(config);
-  if (await fs.pathExists(runtimePath)) {
-    return {
-      storePath: runtimePath,
-      store: await loadApprovalTicketStore(runtimePath)
-    };
-  }
-  if (!await fs.pathExists(legacyPath)) {
-    return {
-      storePath: runtimePath,
-      store: { tickets: [] }
-    };
-  }
-  const legacyStore = await loadApprovalTicketStore(legacyPath);
-  const migrated = pruneApprovalTickets(legacyStore.tickets, nowMs);
-  await saveApprovalTicketStore(runtimePath, {
-    tickets: migrated,
-    updatedAt: new Date(nowMs).toISOString(),
-    migratedFrom: legacyPath
-  });
-  await fs.remove(legacyPath).catch(() => {
-  });
+async function resolveApprovalTicketStoreAndPath(config, _nowMs) {
+  const runtimePath = getApprovalTicketStorePath(config.docsDir);
   return {
     storePath: runtimePath,
-    store: { tickets: migrated }
+    store: await loadApprovalTicketStore(runtimePath)
   };
 }
 function toApprovalActionHash(payload) {
@@ -10653,7 +10668,7 @@ async function runContext(featureName, options) {
         oneApprovalPerAction: approvalRequired,
         requireFreshContext: true,
         contextVersion: state.contextVersion,
-        config: config.approval ?? { mode: "builtin" }
+        config: config.approval ?? createDefaultApprovalConfig()
       },
       agentOrchestration,
       delegatedAction,
@@ -11378,6 +11393,20 @@ async function checkDocsStructure(config, cwd) {
       path: formatPath(cwd, configPath)
     });
   }
+  const unmanagedEntries = await collectUnmanagedDocsEntries(
+    config.docsDir,
+    config.allowedDocsEntries
+  );
+  for (const entry of unmanagedEntries) {
+    issues.push({
+      level: "warn",
+      code: "unmanaged_docs_entry",
+      message: tr(config.lang, "cli", "doctor.issue.unmanagedDocsEntry", {
+        path: entry.relPath
+      }),
+      path: formatPath(cwd, entry.absPath)
+    });
+  }
   return issues;
 }
 async function checkFeatures(config, cwd, features, decisionsPlaceholderMode) {
@@ -11571,7 +11600,15 @@ function doctorCommand(program2) {
       let warnings = scan.warnings;
       let issues = [];
       issues.push(
-        ...await checkDocsStructure({ docsDir, projectType, lang }, cwd)
+        ...await checkDocsStructure(
+          {
+            docsDir,
+            projectType,
+            lang,
+            allowedDocsEntries: config.allowedDocsEntries
+          },
+          cwd
+        )
       );
       issues.push(
         ...await checkFeatures(
@@ -11605,7 +11642,15 @@ function doctorCommand(program2) {
           warnings = scan.warnings;
           issues = [];
           issues.push(
-            ...await checkDocsStructure({ docsDir, projectType, lang }, cwd)
+            ...await checkDocsStructure(
+              {
+                docsDir,
+                projectType,
+                lang,
+                allowedDocsEntries: config.allowedDocsEntries
+              },
+              cwd
+            )
           );
           issues.push(
             ...await checkFeatures(
@@ -12121,18 +12166,13 @@ function toCompactStatusReport(report) {
   };
 }
 function buildAgentOrchestrationPolicy2(autoRun, featureRef) {
-  const preferredResumeCommand = autoRun?.run?.resumeCommand || autoRun?.resume?.flowCommand || null;
-  const handoffRequired = !!autoRun && !!preferredResumeCommand;
+  const resumeCommand = autoRun?.run?.resumeCommand || autoRun?.resume?.flowCommand || null;
+  const handoffRequired = !!autoRun && !!resumeCommand;
   const verifyCacheKey = handoffRequired ? `${(featureRef || "unknown").toLowerCase()}|${Buffer$1.from(
-    preferredResumeCommand
+    resumeCommand
   ).toString("base64").slice(0, 12)}` : "";
   return {
     mode: "main_orchestrates_subagent_execution",
-    delegationPolicy: "prefer_main_delegate_long_running_fallback_main",
-    delegateCommandExecution: "long_running_only",
-    delegateAutoRunExecution: true,
-    fallbackToMainAgentWhenSubAgentUnavailable: true,
-    longRunningCategories: [...LEGACY_LONG_RUNNING_DELEGATION_CATEGORIES],
     mainAgentResponsibilities: [
       "Keep user conversation state and approval boundaries",
       "Run the same execution loop directly when sub-agent is unavailable",
@@ -12151,14 +12191,13 @@ function buildAgentOrchestrationPolicy2(autoRun, featureRef) {
       "AUTO_MANUAL_REQUIRED",
       "command execution error"
     ],
-    preferredResumeCommand,
     subAgentHandoff: {
       required: handoffRequired,
       mode: handoffRequired ? "auto_run" : null,
       featureRef,
       category: null,
       cwd: handoffRequired ? process.cwd() : null,
-      cmd: handoffRequired ? preferredResumeCommand : null,
+      cmd: handoffRequired ? resumeCommand : null,
       verify: handoffRequired ? {
         runOncePerSession: true,
         cacheKey: verifyCacheKey,
@@ -17818,20 +17857,25 @@ async function runRequirements(options) {
   }
   if (options.strict && issuesFound) process.exitCode = 1;
 }
-function parseTaskLine(line) {
+
+// src/utils/task-lines.ts
+function parseTaskLine(line, index = -1) {
   const match = line.match(
-    /^\s*-\s*\[(TODO|DOING|DONE|REVIEW)\]\[([^\]]+)\](?:\[[^\]]+\])*\s+(T-[A-Za-z0-9-]+)\s+(.+?)\s*$/
+    /^\s*-\s*\[(TODO|DOING|DONE|REVIEW)\]((?:\[[^\]]+\])*)\s+(T-[A-Za-z0-9-]+)\s+(.+?)\s*$/
   );
   if (!match) return null;
+  const tags = [...(match[2] || "").matchAll(/\[([^\]]+)\]/g)].map((entry) => (entry[1] || "").trim()).filter(Boolean);
   return {
-    index: -1,
+    index,
     raw: line,
     status: match[1],
-    priority: match[2],
+    tags,
     taskId: match[3],
     title: match[4]
   };
 }
+
+// src/commands/task-run.ts
 function buildTaskRunPrompt(input) {
   const shared = [
     "Read `spec.md`, `plan.md`, and `tasks.md` before editing code.",
@@ -18003,19 +18047,6 @@ function taskRunCommand(program2) {
     }
   });
 }
-function parseTaskLine2(line) {
-  const match = line.match(
-    /^\s*-\s*\[(TODO|DOING|DONE|REVIEW)\]\[[^\]]+\](?:\[[^\]]+\])*\s+(T-[A-Za-z0-9-]+)\s+(.+?)\s*$/
-  );
-  if (!match) return null;
-  return {
-    index: -1,
-    raw: line,
-    status: match[1],
-    taskId: match[2],
-    title: match[3]
-  };
-}
 function setTaskStatus2(line, nextStatus) {
   return line.raw.replace(
     /^\s*-\s*\[(TODO|DOING|DONE|REVIEW)\]/,
@@ -18064,7 +18095,7 @@ async function runTaskComplete(featureName, options) {
     );
   }
   const resolvedTask = lines.map((line, index) => {
-    const parsed = parseTaskLine2(line);
+    const parsed = parseTaskLine(line);
     return parsed ? { ...parsed, index } : null;
   }).find((entry) => entry?.taskId === requestedTaskId);
   if (!resolvedTask) {
@@ -18143,10 +18174,204 @@ function taskCompleteCommand(program2) {
     }
   );
 }
+function escapeRegExp8(value) {
+  return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+function findTaskListHeadingIndex(lines) {
+  return lines.findIndex((line) => /^\s*##\s+(Task List|태스크 목록)\s*$/.test(line));
+}
+function findNextSectionHeadingIndex(lines, start) {
+  for (let i = start + 1; i < lines.length; i += 1) {
+    if (/^\s*##\s+/.test(lines[i] || "")) return i;
+  }
+  return lines.length;
+}
+function findTaskInsertIndex(lines, sectionStart, sectionEnd) {
+  let lastTaskIndex = -1;
+  for (let i = sectionStart; i < sectionEnd; i += 1) {
+    if (parseTaskLine(lines[i] || "", i)) lastTaskIndex = i;
+  }
+  if (lastTaskIndex < 0) return sectionEnd;
+  let insertIndex = lastTaskIndex + 1;
+  while (insertIndex < sectionEnd) {
+    const line = lines[insertIndex] || "";
+    if (parseTaskLine(line, insertIndex)) break;
+    if (/^\s{2,}\S/.test(line) || /^\s*$/.test(line)) {
+      insertIndex += 1;
+      continue;
+    }
+    break;
+  }
+  return insertIndex;
+}
+function normalizeTaskRef(value) {
+  const trimmed = value.trim();
+  if (!trimmed) {
+    throw createCliError(
+      "INVALID_ARGUMENT",
+      "`--ref` is required. Use `NON-PRD` or an existing `PRD-...` requirement ID."
+    );
+  }
+  if (isNonPrdTag(trimmed)) return "NON-PRD";
+  const normalized = trimmed.toUpperCase();
+  if (!isPrdRequirementId(normalized)) {
+    throw createCliError(
+      "INVALID_ARGUMENT",
+      "`--ref` must be `NON-PRD` or an existing `PRD-FR-001`-style requirement ID."
+    );
+  }
+  return normalized;
+}
+function getNextTaskSequence(content, featureFolderName) {
+  const taskIdPattern = new RegExp(
+    `\\bT-${escapeRegExp8(featureFolderName)}-(\\d+)\\b`,
+    "g"
+  );
+  let max = 0;
+  for (const match of content.matchAll(taskIdPattern)) {
+    const numeric = Number(match[1] || "0");
+    if (Number.isFinite(numeric) && numeric > max) max = numeric;
+  }
+  return max + 1;
+}
+function formatTaskBlock(input) {
+  return [
+    `- [TODO][${input.ref}] ${input.taskId} ${input.title}`,
+    `  - Date: ${input.recordedAt}`,
+    "  - Acceptance:",
+    "    - -",
+    "  - Checklist:",
+    "    - [ ] -"
+  ];
+}
+async function resolveTaskFeature(featureName, component) {
+  const ctx = await createCliContext({ cwd: process.cwd() });
+  if (!ctx) {
+    throw createCliError(
+      "CONFIG_NOT_FOUND",
+      "No lee-spec-kit config found in this workspace."
+    );
+  }
+  const state = await resolveContextSelection(ctx, featureName, {
+    component: resolveComponentOption(component)
+  });
+  if (state.status !== "single_matched" || !state.matchedFeature) {
+    throw createCliError(
+      "CONTEXT_SELECTION_REQUIRED",
+      "task add requires a single matched feature. Pass <feature-name> explicitly."
+    );
+  }
+  return {
+    ctx,
+    feature: state.matchedFeature
+  };
+}
+async function runTaskAdd(featureName, options) {
+  const { ctx, feature } = await resolveTaskFeature(featureName, options.component);
+  const title = options.title.trim();
+  if (!title) {
+    throw createCliError("INVALID_ARGUMENT", "`--title` must not be empty.");
+  }
+  const ref = normalizeTaskRef(options.ref);
+  if (isPrdRequirementId(ref)) {
+    const { definitions } = await scanPrdRequirements(ctx.fs, ctx.config.docsDir);
+    if (!definitions.has(ref)) {
+      throw createCliError(
+        "PRECONDITION_FAILED",
+        `Requirement "${ref}" is not defined in docs/prd or the upstream requirements doc.`
+      );
+    }
+  }
+  const tasksPath = path15.join(feature.path, "tasks.md");
+  if (!await fs.pathExists(tasksPath)) {
+    throw createCliError(
+      "PRECONDITION_FAILED",
+      `tasks.md not found for feature: ${feature.folderName}`
+    );
+  }
+  const content = await fs.readFile(tasksPath, "utf-8");
+  const lines = content.split("\n");
+  const taskListHeadingIndex = findTaskListHeadingIndex(lines);
+  if (taskListHeadingIndex < 0) {
+    throw createCliError(
+      "PRECONDITION_FAILED",
+      "tasks.md is missing a `Task List` section."
+    );
+  }
+  const nextSectionHeadingIndex = findNextSectionHeadingIndex(
+    lines,
+    taskListHeadingIndex
+  );
+  const taskId = `T-${feature.folderName}-${String(
+    getNextTaskSequence(content, feature.folderName)
+  ).padStart(2, "0")}`;
+  const insertIndex = findTaskInsertIndex(
+    lines,
+    taskListHeadingIndex + 1,
+    nextSectionHeadingIndex
+  );
+  const recordedAt = getLocalDateString();
+  const blockLines = formatTaskBlock({ ref, taskId, title, recordedAt });
+  const shouldPrefixBlank = insertIndex > taskListHeadingIndex + 1 && (lines[insertIndex - 1] || "").trim() !== "";
+  const shouldSuffixBlank = insertIndex < lines.length && (lines[insertIndex] || "").trim() !== "";
+  const insertLines = [
+    ...shouldPrefixBlank ? [""] : [],
+    ...blockLines,
+    ...shouldSuffixBlank ? [""] : []
+  ];
+  lines.splice(insertIndex, 0, ...insertLines);
+  await fs.writeFile(tasksPath, lines.join("\n"), "utf-8");
+  const payload = {
+    status: "ok",
+    reasonCode: "TASK_ADDED",
+    feature: feature.folderName,
+    taskId,
+    title,
+    ref,
+    tasksUpdated: true,
+    tasksPath,
+    recordedAt
+  };
+  if (options.json) {
+    console.log(JSON.stringify(payload, null, 2));
+    return;
+  }
+  console.log(chalk9.green(`Added task ${taskId} to ${feature.folderName}.`));
+  console.log(chalk9.gray(`- ref: ${ref}`));
+  console.log(chalk9.gray(`- tasks.md updated: ${tasksPath}`));
+}
+function taskCommand(program2) {
+  const task = program2.command("task").description("Manage tasks");
+  task.command("add [feature-name]").description("Append a new task to the end of Task List").requiredOption("--title <title>", "Task title").requiredOption("--ref <ref>", "Requirement ref: NON-PRD or PRD-FR-001").option("--component <component>", "Component name for multi projects").option("--json", "Output JSON").action(async (featureName, options) => {
+    try {
+      await runTaskAdd(featureName, options);
+    } catch (error) {
+      const ctx = await createCliContext({ cwd: process.cwd() });
+      const lang = ctx?.config?.lang ?? DEFAULT_LANG;
+      const cliError = toCliError(error);
+      const suggestions = getCliErrorSuggestions(cliError.code, lang);
+      if (options.json) {
+        console.log(
+          JSON.stringify({
+            status: "error",
+            reasonCode: cliError.code,
+            error: cliError.message,
+            suggestions
+          })
+        );
+        process.exitCode = 1;
+        return;
+      }
+      console.error(chalk9.red(`[${cliError.code}] ${cliError.message}`));
+      printCliErrorSuggestions(suggestions, lang);
+      process.exitCode = 1;
+    }
+  });
+}
 function setupCommand(program2) {
   const setup = program2.command("setup").description("Developer environment setup helpers");
   setup.command("codex-bootstrap").description(
-    "Install a small Codex global bootstrap that reads ./docs/AGENTS.md"
+    "Install a small Codex global bootstrap that reads ./AGENTS.md or ./docs/AGENTS.md"
   ).option(
     "--remove",
     "Remove the lee-spec-kit managed Codex bootstrap block"
@@ -18374,6 +18599,7 @@ prePrReviewCommand(program);
 codeReviewRunCommand(program);
 taskRunCommand(program);
 taskCompleteCommand(program);
+taskCommand(program);
 requirementsCommand(program);
 setupCommand(program);
 configureRootCommandSurface();