@ngockhoale/ukit 1.1.6 → 1.1.8

package/templates/.claude/ukit/index/route-task.mjs

@@ -230,11 +230,17 @@ async function prepareTaskRoute({
   const normalizedPrompt = String(promptText || '').trim();
   const normalizedCommand = String(commandText || '').trim();
   const normalizedTarget = normalizeRelativeFile(absoluteRoot, targetFile);
+  const intentMode = deriveIntentMode({
+    promptText: normalizedPrompt,
+    commandText: normalizedCommand,
+    targetFile: normalizedTarget,
+  });
   const activeSkills = await selectActiveSkills({
     rootDir: absoluteRoot,
     promptText: normalizedPrompt,
     commandText: normalizedCommand,
     targetFile: normalizedTarget,
+    intentMode,
   });
   const selectedIds = activeSkills.map((entry) => entry.id);
   const contextIntent = deriveContextIntent({
@@ -247,6 +253,7 @@ async function prepareTaskRoute({
     promptText: normalizedPrompt,
     commandText: normalizedCommand,
     selectedIds,
+    targetFile: normalizedTarget,
   });
   const preservedPrompt = normalizedPrompt || String(lastExplicitUserPromptText || '').trim();
 
@@ -261,6 +268,7 @@ async function prepareTaskRoute({
       targetFile: normalizedTarget,
       contextIntent,
       taskType: inferredTaskType,
+      intentMode,
     },
   };
 }
@@ -623,7 +631,7 @@ async function readHelperCacheSnapshot({
   };
 }
 
-async function selectActiveSkills({ rootDir, promptText, commandText, targetFile }) {
+async function selectActiveSkills({ rootDir, promptText, commandText, targetFile, intentMode = null }) {
   const routeSignals = {
     promptRawText: String(promptText || '').toLowerCase(),
     promptNormalizedText: buildNormalizedRouteSignalText(promptText),
@@ -634,6 +642,7 @@ async function selectActiveSkills({ rootDir, promptText, commandText, targetFile
   const scoredEntries = ROUTE_CATALOG
     .map((entry) => scoreSkillRouteEntry(entry, routeSignals))
     .filter((entry) => entry.score > 0)
+    .filter((entry) => shouldKeepRouteEntryForIntent(entry, intentMode))
     .sort((a, b) => b.score - a.score || a.order - b.order);
   const active = [];
 
@@ -649,6 +658,22 @@ async function selectActiveSkills({ rootDir, promptText, commandText, targetFile
   return active.map(({ order, ...rest }) => rest);
 }
 
+function shouldKeepRouteEntryForIntent(entry, intentMode) {
+  if (entry.id === 'next-step' && ['scoped-advice', 'docs-specific'].includes(intentMode)) {
+    return false;
+  }
+
+  if (entry.id === 'update-status' && intentMode === 'docs-specific') {
+    return false;
+  }
+
+  if (entry.id === 'docs-quality' && ['open-ended-status', 'status-update'].includes(intentMode)) {
+    return false;
+  }
+
+  return true;
+}
+
 function scoreSkillRouteEntry(entry, routeSignals = {}) {
   let score = 0;
   const reasons = [];
@@ -717,6 +742,116 @@ function getSignalTexts(signalType, routeSignals = {}) {
   };
 }
 
+function deriveIntentMode({ promptText = '', commandText = '', targetFile = null } = {}) {
+  const lower = buildNormalizedRouteSignalText(promptText, commandText);
+  const raw = `${promptText ?? ''}\n${commandText ?? ''}`.toLowerCase();
+  const docsSpecific = hasDocsSpecificTaskSignal(lower, raw, targetFile);
+  const statusUpdate = hasStatusUpdateSignal(lower, raw);
+  const openEndedStatus = hasOpenEndedStatusSignal(lower, raw);
+  const concreteTask = hasConcreteTaskSignal(lower, raw, targetFile);
+
+  if (docsSpecific) {
+    return 'docs-specific';
+  }
+
+  if (statusUpdate) {
+    return 'status-update';
+  }
+
+  if (concreteTask && openEndedStatus) {
+    return 'scoped-advice';
+  }
+
+  if (openEndedStatus) {
+    return 'open-ended-status';
+  }
+
+  if (concreteTask) {
+    if (/\b(bug|debug|error|crash|broken|failing|stack trace|triage|fix|login|timeout)\b/.test(lower)) {
+      return 'debug-specific';
+    }
+    if (/\b(review|audit|diff|pr feedback|code review|kiem tra|soat)\b/.test(lower)) {
+      return 'review-specific';
+    }
+    if (/\b(implement|build|create|add|ship|deliver|refactor|integrate|integration|scaffold|feature)\b/.test(lower)) {
+      return 'implement-specific';
+    }
+  }
+
+  return null;
+}
+
+function hasStatusUpdateSignal(lower, raw) {
+  return /\b(update|refresh|write|sync|record|capture|summarize|summarise).{0,64}\b(status\.md|project status|current state|next candidates|session state)\b/.test(lower)
+    || /\b(status\.md|project status).{0,64}\b(update|refresh|write|sync|record|capture|summarize|summarise)\b/.test(lower)
+    || /\b(wrap up|handoff|end this session|ending this session|session summary|before final)\b/.test(lower)
+    || /\b(cap nhat|ghi lai|tong ket|chot session|ban giao).{0,64}\b(status|trang thai|viec tiep theo)\b/.test(lower)
+    || /\b(cập nhật|ghi lại|tổng kết|chốt session|bàn giao).{0,64}\b(status|trạng thái|việc tiếp theo)\b/.test(raw);
+}
+
+function hasOpenEndedStatusSignal(lower, raw) {
+  return /\b(what next|what is next|what's next|next step|next steps|project status|current status|where are we|continue|continue from last session|roadmap|status\.md)\b/.test(lower)
+    || /\b(lam gi tiep|buoc tiep theo|tiep theo lam gi|lam tiep|dang o dau|trang thai project|tinh trang project)\b/.test(lower)
+    || /\b(làm gì tiếp|bước tiếp theo|tiếp theo làm gì|làm tiếp|đang ở đâu|trạng thái project|tình trạng project)\b/.test(raw);
+}
+
+function hasConcreteTaskSignal(lower, raw, targetFile) {
+  if (targetFile && !isStatusFileTarget(targetFile)) {
+    return true;
+  }
+
+  return /\b(bug|debug|error|crash|broken|failing|stack trace|triage|fix|implement|build|create|add|ship|deliver|refactor|integrate|integration|scaffold|feature|review|audit|diff|pr feedback|code review|auth|login|api|endpoint|test|spec)\b/.test(lower)
+    || /\b(sửa|fix|lỗi|bug|debug|implement|cài|thêm|review|kiểm tra|soát|đăng nhập)\b/.test(raw);
+}
+
+function hasDocsSpecificTaskSignal(lower, raw, targetFile) {
+  if (!targetFile || !isDocsTarget(targetFile)) {
+    return false;
+  }
+
+  const targetName = path.posix.basename(String(targetFile || '').replaceAll('\\', '/')).toLowerCase();
+  const explicitStatusUpdate = hasExplicitStatusUpdateSignal(lower, raw);
+
+  if (!isStatusFileTarget(targetFile)) {
+    if (explicitStatusUpdate && !mentionsTargetDoc(lower, targetName)) {
+      return false;
+    }
+
+    return mentionsTargetDoc(lower, targetName)
+      || /\b(edit|write|improve|document|docs?|readme|changelog|worklog|memory|code map|template|wording|copy|grammar|format|structure|heading|section|handoff notes?)\b/.test(lower)
+      || /\b(câu chữ|chỉnh|sửa chữ|ngữ pháp|định dạng|cấu trúc|tài liệu|ghi chú bàn giao)\b/.test(raw);
+  }
+
+  return /\b(template|wording|edit|copy|grammar|format|structure|heading|section|docs?)\b/.test(lower)
+    || /\b(mẫu|câu chữ|chỉnh|sửa chữ|ngữ pháp|định dạng|cấu trúc|tài liệu)\b/.test(raw);
+}
+
+function hasExplicitStatusUpdateSignal(lower, raw) {
+  return /\b(update|refresh|write|sync|record|capture|summarize|summarise).{0,64}\b(status\.md|project status|current state|next candidates|session state)\b/.test(lower)
+    || /\b(status\.md|project status).{0,64}\b(update|refresh|write|sync|record|capture|summarize|summarise)\b/.test(lower)
+    || /\b(cap nhat|ghi lai|tong ket|chot session|ban giao).{0,64}\b(status|trang thai|viec tiep theo)\b/.test(lower)
+    || /\b(cập nhật|ghi lại|tổng kết|chốt session|bàn giao).{0,64}\b(status|trạng thái|việc tiếp theo)\b/.test(raw);
+}
+
+function mentionsTargetDoc(lower, targetName) {
+  if (!targetName) {
+    return false;
+  }
+
+  const escaped = targetName.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+  const withoutExt = escaped.replace(/\\\.md$/i, '');
+  return new RegExp(`\\b(?:${escaped}|${withoutExt})\\b`, 'i').test(lower);
+}
+
+function isStatusFileTarget(targetFile) {
+  return /(?:^|\/)docs\/STATUS\.md$|(?:^|\/)STATUS\.md$/i.test(String(targetFile || ''));
+}
+
+function isDocsTarget(targetFile) {
+  const normalized = String(targetFile || '').replaceAll('\\', '/');
+  return /(?:^|\/)docs\/.+\.md$|(?:^|\/)(?:README|CHANGELOG|AGENTS|CLAUDE|STATUS)\.md$/i.test(normalized);
+}
+
 function shouldUseIndexedContext({ activeSkills = [], targetFile = null } = {}) {
   if (activeSkills.length === 0) {
     return Boolean(targetFile);
@@ -1062,6 +1197,7 @@ function buildRouteSummary({
     fallbackCommands,
     preferredOrder,
     policyMode,
+    intentMode: routingContext.intentMode ?? null,
     delegateHint: delegationRecommendation?.hint ?? null,
     nextActionType: nextAction?.type ?? null,
     nextActionCommand,
@@ -1143,7 +1279,7 @@ function deriveContextIntent({ promptText, commandText, targetFile, selectedIds
   return '';
 }
 
-function inferTaskType({ promptText, commandText, selectedIds }) {
+function inferTaskType({ promptText, commandText, selectedIds, targetFile = null }) {
   const lower = buildNormalizedRouteSignalText(promptText, commandText);
   if (
     selectedIds.includes('discover-security')
@@ -1152,10 +1288,17 @@ function inferTaskType({ promptText, commandText, selectedIds }) {
   ) {
     return 'non-trivial';
   }
+
+  let inferred = 'simple';
   if (/\b(typo|label|text|rename|color|spacing|toggle|comment)\b/.test(lower)) {
-    return 'trivial';
+    inferred = 'trivial';
   }
-  return 'simple';
+
+  if ((inferred === 'simple' || inferred === 'trivial') && isSharedImpactFile(targetFile)) {
+    return 'shared-simple';
+  }
+
+  return inferred;
 }
 
 function buildHelperCommand({ commandNamespace = '.claude', scriptName, intent = '', targetFile = null, taskType = null }) {
@@ -1166,6 +1309,24 @@ function buildHelperCommand({ commandNamespace = '.claude', scriptName, intent =
   return parts.join(' ');
 }
 
+const SHARED_IMPACT_PATTERNS = [
+  /^src\/index\//,
+  /^src\/core\/(runInstallPipeline|applyPlan|buildPlan|diffPlan|metadata|migrateLegacy|uninstall|runtimeConfig|runtimePaths)\.js$/,
+  /^src\/core\/(output|token|compact)\//,
+  /^templates\/\.claude\/hooks\//,
+  /^templates\/\.claude\/ukit\//,
+  /^manifests\/platform\.full\.yaml$/,
+  /^templates\//,
+];
+
+function isSharedImpactFile(filePath) {
+  const normalized = String(filePath ?? '').trim().replace(/\\/g, '/').replace(/^\.\//, '');
+  if (!normalized) {
+    return false;
+  }
+  return SHARED_IMPACT_PATTERNS.some((pattern) => pattern.test(normalized));
+}
+
 function isTestLikeFile(filePath) {
   return /\.(test|spec)\.[a-z0-9]+$/i.test(filePath)
     || /(^|\/)(?:__tests__|tests?|specs?)\//i.test(filePath);
@@ -1554,6 +1715,7 @@ function compactRoutingContext(routingContext = {}) {
     adapter: routingContext.adapter ?? 'claude',
     lastExplicitUserPromptText: routingContext.lastExplicitUserPromptText ?? '',
     taskType: routingContext.taskType ?? null,
+    intentMode: routingContext.intentMode ?? null,
   };
 }
 

package/templates/.codex/README.md

@@ -12,7 +12,7 @@ Auto-generated by UKit for OpenAI Codex.
 - Do not make end users memorize skill names, helper scripts, or routing internals unless they are debugging UKit itself.
 - **Treat helper commands as internal orchestration. Do not ask end users to run them.**
 
-## UKit v1.1.6 Shared Runtime
+## UKit v1.1.8 Shared Runtime
 
 - Shared runtime state lives in `.ukit/storage/`.
 - Treat `.ukit/storage/config.json` as the source of compact, token-pipeline, router, memory, and validation toggles.
@@ -29,6 +29,7 @@ Auto-generated by UKit for OpenAI Codex.
 - **Trivial**: no docs.
 - **Simple**: `docs/MEMORY.md` only.
 - **Non-trivial**: `docs/MEMORY.md` + `docs/PROJECT.md` + `docs/CODE_MAP.md`.
+- `docs/STATUS.md`: read for open-ended status/continue prompts or meaningful continuation context; stale status is orientation only.
 - Read `docs/WORKLOG.md` only when recent continuation/debug context matters.
 - Source is truth; if docs are stale, update docs and continue.
 
@@ -52,6 +53,9 @@ For clearly non-code specialist lanes, avoid dragging the source-code index into
 - Match from prompt wording plus tool/file evidence.
 - Use the smallest useful set, usually 1-2 skills.
 - If docs work is detected, prefer `.codex/skills/docs-quality/SKILL.md`.
+- For open-ended “what next?” / “continue” / project-status prompts, prefer `.codex/skills/next-step/SKILL.md` and show a status freshness cue.
+- For explicit handoff/wrap-up/status updates, prefer `.codex/skills/update-status/SKILL.md`.
+- Concrete debug/implementation/review prompts beat open-ended wording; do not let `next-step` replace the concrete workflow.
 - If routing is complex or ambiguous, prefer `node .codex/ukit/index/route-task.mjs "<prompt>" [--tool-command <cmd>] [--target <file>]`.
 - That helper should keep shared route memory in `.claude/ukit/skill-router-state.json` so Claude and Codex continue from the same compact route state.
 - When route memory already includes `previous-context` or `recent-output`, reuse it before widening reads or logs.
@@ -68,6 +72,7 @@ For clearly non-code specialist lanes, avoid dragging the source-code index into
 ## Docs Discipline
 
 After significant work, update only what changed:
+- `docs/STATUS.md` — compact current state, blockers, verification, next candidates
 - `docs/WORKLOG.md`
 - `docs/MEMORY.md`
 - `docs/CODE_MAP.md`

package/templates/.codex/settings.json

@@ -65,6 +65,12 @@
       ],
       "maintenance": [
         "repo-maintenance"
+      ],
+      "nextStep": [
+        "next-step"
+      ],
+      "statusUpdate": [
+        "update-status"
       ]
     },
     "toolSignals": {
@@ -89,7 +95,8 @@
     },
     "routingRule": {
       "endUserShouldNotNeedSkillNames": true,
-      "selectSmallestUsefulSkillSet": true
+      "selectSmallestUsefulSkillSet": true,
+      "concreteTaskBeatsOpenEndedStatus": true
     },
     "delegationBridge": {
       "enabled": true,

package/templates/AGENTS.md

@@ -31,6 +31,8 @@
 - bug / error / crash / triage / failing path → `.claude/skills/debugging-toolkit/SKILL.md`
 - test / spec / coverage / fixture → `.claude/skills/testing-quality/SKILL.md`
 - docs / README / changelog / handoff / editing `docs/` → `.claude/skills/docs-quality/SKILL.md`
+- open-ended next step / project status / continue with no concrete target → `.claude/skills/next-step/SKILL.md`
+- explicit handoff / wrap up / update `docs/STATUS.md` → `.claude/skills/update-status/SKILL.md`
 - auth / security / token / permission / validation / risky shell-path-delete-db work → `.claude/skills/discover-security/SKILL.md`
 - stale workspace / reinstall / cleanup / maintenance → `.claude/skills/repo-maintenance/SKILL.md`
 
@@ -41,7 +43,7 @@
 - If a concrete verification lane is needed, prefer `node .claude/ukit/index/verify-context.mjs ...`.
 - These helper/index commands are internal orchestration. Run them yourself when needed; never turn them into required end-user workflow.
 
-## UKit v1.1.6 Shared Runtime
+## UKit v1.1.8 Shared Runtime
 
 - Shared runtime state lives in `.ukit/storage/`.
 - Treat `.ukit/storage/config.json` as the source of runtime toggles for compact, token pipeline, router, memory, and validation behavior.
@@ -59,9 +61,18 @@
 - **Trivial**: no docs, no index query unless the file target is unclear.
 - **Simple**: default to `docs/MEMORY.md` only; pull related files/tests with the resolver.
 - **Non-trivial**: read `docs/MEMORY.md` + `docs/PROJECT.md` + `docs/CODE_MAP.md`.
+- `docs/STATUS.md`: read for open-ended status/continue prompts or meaningful continuation context; treat stale status as orientation only and verify against source/index.
 - `docs/WORKLOG.md`: only recent, relevant entries for continuation/debugging.
 - Follow routed verification policy: targeted first when localized, widen in order for shared/risky scope, ask before blanket broad runs when no related-test evidence exists.
 
+## Living Status Workflow
+
+- `docs/STATUS.md` is compact current state, not a transcript and not source truth.
+- When the user asks “what next?”, “continue”, or “project đang ở đâu?” without a concrete target, use the `next-step` skill and show a freshness cue (fresh / possibly stale / stale / missing).
+- Concrete debug/implementation/review prompts beat open-ended wording; use the concrete skill first and only use status as background.
+- After meaningful work, use `update-status` to record state, verification, blockers, and next candidates; skip trivial/no-state-change tasks.
+- Detailed task context files such as `docs/context/<slug>.md` are a future extension, not required baseline workflow.
+
 ## Subagent Policy (internal only)
 
 - Default to direct execution for trivial/simple work.

package/templates/CLAUDE.md

@@ -29,6 +29,8 @@
 - bug / error / crash / triage → `.claude/skills/debugging-toolkit/SKILL.md`
 - test / spec / coverage → `.claude/skills/testing-quality/SKILL.md`
 - docs / README / changelog / handoff / editing `docs/` → `.claude/skills/docs-quality/SKILL.md`
+- open-ended next step / project status / continue with no concrete target → `.claude/skills/next-step/SKILL.md`
+- explicit handoff / wrap up / update `docs/STATUS.md` → `.claude/skills/update-status/SKILL.md`
 - auth / security / token / permission / validation → `.claude/skills/discover-security/SKILL.md`
 - stale workspace / reinstall / cleanup → `.claude/skills/repo-maintenance/SKILL.md`
 
@@ -40,7 +42,7 @@
 - **Do not ask normal contributors to run internal helper commands**; run them yourself or tell them to rerun `ukit install`.
 - Do not ask normal contributors to memorize `ukit doctor`, `ukit diff`, `ukit uninstall`, or `ukit index ...` unless they explicitly need maintainer/debug help.
 
-## UKit v1.1.6 Shared Runtime
+## UKit v1.1.8 Shared Runtime
 
 - Shared runtime state lives in `.ukit/storage/`.
 - Treat `.ukit/storage/config.json` as the source of runtime toggles for compact, token pipeline, router, memory, and validation behavior.
@@ -56,9 +58,18 @@
 - **Trivial**: no docs.
 - **Simple**: `docs/MEMORY.md` only, plus resolver-selected files/tests.
 - **Non-trivial**: `docs/MEMORY.md` + `docs/PROJECT.md` + `docs/CODE_MAP.md`.
+- `docs/STATUS.md`: use for open-ended status/continue prompts or meaningful continuation context; stale status is orientation only.
 - `docs/WORKLOG.md`: only recent relevant entries.
 - Follow routed verification policy: targeted first, widen only when risk/shared scope justifies it, ask before blanket broad runs.
 
+## Living Status Workflow
+
+- `docs/STATUS.md` captures compact current state, active work, debug threads, blockers, verification, and next candidates.
+- It is not source truth and must not replace source/index-first investigation.
+- For “what next?” / “continue” prompts without a concrete target, use `next-step` and show a freshness cue before relying on the status file.
+- For concrete debug/implementation/review prompts, keep the concrete workflow primary even if the user asks for an approach or next step.
+- After meaningful work, use `update-status`; skip trivial/no-state-change tasks and avoid transcript-style noise.
+
 ## Selective Subagent Policy (internal only)
 
 - Keep direct execution as the default for trivial/simple work.

package/templates/docs/INSTALL.md

@@ -47,6 +47,7 @@ End users do not need to manage any of that manually.
 Complete these files before first serious use:
 - `docs/PROJECT.md`
 - `docs/MEMORY.md`
+- `docs/STATUS.md`
 - `docs/WORKLOG.md`
 
 ### 4) Open your AI tool
@@ -96,6 +97,7 @@ ukit install
 Check that the docs baseline files exist and are filled in:
 - `docs/PROJECT.md`
 - `docs/MEMORY.md`
+- `docs/STATUS.md`
 - `docs/WORKLOG.md`
 
 ---

package/templates/docs/PROJECT.md

@@ -44,7 +44,8 @@
 
 1. Run `ukit memory recall "<current task>"` for non-trivial work; reuse relevant `## Previous Context` before asking the user to restate prior decisions
 2. Read `docs/MEMORY.md` — architecture decisions, active constraints, known bugs
-3. Read `docs/CODE_MAP.md` if it exists — structural navigation index
-4. Use the installed source-code index / routed helpers to localize the smallest relevant file + test set first
-5. Scan recent `docs/WORKLOG.md` entries if continuing prior work
-6. Verify understanding against source before acting — **docs orient, source is truth; keep the index-first workflow intact**
+3. Read `docs/STATUS.md` for open-ended status/continue prompts or meaningful continuation context; treat stale status as orientation only
+4. Read `docs/CODE_MAP.md` if it exists — structural navigation index
+5. Use the installed source-code index / routed helpers to localize the smallest relevant file + test set first
+6. Scan recent `docs/WORKLOG.md` entries if continuing prior work
+7. Verify understanding against source before acting — **docs orient, source is truth; keep the index-first workflow intact**

package/templates/docs/STATUS.md

@@ -0,0 +1,81 @@
+# Project Status — {{project.name}}
+
+> Living project state for AI sessions.
+> Keep this compact: current state only, not a session transcript.
+> Source code, tests, and the UKit index remain ground truth.
+
+## Freshness
+
+- Last meaningful update: TODO YYYY-MM-DD HH:mm
+- Updated by: TODO
+- Status confidence: low
+- Stale after: 72h
+
+If this file is stale, AI must treat it as orientation only and verify against source/index before recommending or editing.
+
+## Snapshot
+
+- Current focus: TODO
+- Health: unknown
+- Branch/state: TODO
+- Release/version: TODO
+
+## Active Work
+
+<!-- Keep only live work. Move finished work to Recently Completed or WORKLOG.md. -->
+
+### TODO work item
+
+- Status: planned / in-progress / blocked / done
+- Goal: TODO
+- Done: TODO
+- Remaining: TODO
+- Files involved: TODO
+- Verification: TODO
+- Next action: TODO
+
+## Current Debug Threads
+
+<!-- Detailed bug context belongs in docs/context/<task>.md when that exists. STATUS should only link/summarize. -->
+
+### TODO debug thread
+
+- Status: investigating / root cause found / fixed / blocked
+- Symptom: TODO
+- Root cause: unknown
+- Evidence: TODO
+- Changed files: TODO
+- Verification: TODO
+- Remaining risk: TODO
+- Next action: TODO
+
+## Decisions Pending
+
+- [ ] TODO decision
+  - Context: TODO
+  - Options: TODO
+  - Recommended: TODO
+
+## Next Candidates
+
+1. TODO candidate
+   - Why now: TODO
+   - Expected files: TODO
+   - Verification: TODO
+   - Risk: TODO
+
+## Recently Completed
+
+<!-- Max 10 compact lines. Use docs/WORKLOG.md for session history. -->
+
+- TODO YYYY-MM-DD — summary — verification
+
+## Notes for Next AI Session
+
+- Read first: docs/STATUS.md, then docs/CODE_MAP.md only if navigation is needed.
+- Avoid: treating this file as source truth when it is stale or contradicted by code/tests.
+- Known traps: keep concrete debug/implementation prompts on their specific workflow; do not turn them into global roadmap suggestions.
+
+## Future Candidate: Task Context Files
+
+v1.2 candidate: task-scoped `docs/context/<slug>.md` files for granular bug/feature context. Keep this out of v1.1.8 scope unless a project already uses that folder.

package/templates/docs/UKIT_USAGE_GUIDE.md

@@ -14,6 +14,7 @@ UKit should handle:
 - hidden skill selection
 - source-code indexing
 - compact context selection
+- living project status for open-ended continuation prompts
 - targeted verification
 - optional internal delegation when it is actually useful
 
@@ -127,6 +128,21 @@ Expected UKit behavior:
 2. use DuraOne references only when the repo actually matches that domain/shape
 3. keep the user away from manual skill selection
 
+### F) Continue / what next
+
+User says:
+
+```text
+Project đang ở đâu, làm gì tiếp?
+```
+
+Expected UKit behavior:
+1. auto-load the hidden next-step lane
+2. read `docs/STATUS.md` first and show whether it is fresh, possibly stale, stale, or missing
+3. suggest only a few actionable next candidates
+4. if status is stale, verify with source/index before treating any candidate as authoritative
+5. if the prompt names a concrete bug/feature/review target, keep the concrete workflow primary instead of producing a global roadmap
+
 ---
 
 ## What users should NOT need to do

package/templates/ukit/README.md

@@ -1,6 +1,6 @@
 # UKit Shared Runtime
 
-This folder stores shared UKit runtime state for v1.1.6 features.
+This folder stores shared UKit runtime state for v1.1.8 features.
 
 - `storage/config.json` — runtime feature flags and defaults
 - `storage/cache/` — prompt-cache, compact history, compact pressure state, output summaries, and preserved raw tool outputs under `storage/cache/tee/`

package/templates/ukit/storage/config.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.1.6",
+  "version": "1.1.8",
   "agent": "claude-code",
   "compact": {
     "enabled": true,