sneakoscope 0.6.89 → 0.6.93

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -2,7 +2,7 @@
2
2
 
3
3
  ![](https://github.com/mandarange/Sneakoscope-Codex/raw/dev/docs/assets/sneakoscope-codex-logo.png)
4
4
 
5
- Sneakoscope Codex (`sks`, displayed as `ㅅㅋㅅ`) is a Codex CLI/App harness for repeatable agent workflows. It adds terminal commands, Codex App `$` prompt commands, warp-native CLI workspaces, Team/Goal/QA/Research routes, Context7 evidence checks, DB safety, TriWiki context tracking, Honest Mode, and release-readiness gates.
5
+ Sneakoscope Codex (`sks`, displayed as `ㅅㅋㅅ`) is a Codex CLI/App harness for repeatable agent workflows. It adds terminal commands, Codex App `$` prompt commands, warp-native CLI workspaces, Team/QA/Research routes, a maximum-speed Computer Use lane, a fast Goal bridge for native `/goal` persistence, Context7 evidence checks, DB safety, TriWiki context tracking, Honest Mode, and release-readiness gates.
6
6
 
7
7
  ## Quick Start
8
8
 
@@ -48,7 +48,8 @@ sks selftest --mock
48
48
  | Team orchestration | Runs substantial work through ambiguity handling, scouts, TriWiki refresh, debate, runtime task graphs, worker inboxes, implementation, review, cleanup, reflection, and Honest Mode. |
49
49
  | From-Chat-IMG | Turns chat screenshots plus original attachments into source-bound work orders, then requires scoped QA evidence before completion. |
50
50
  | QA loop | Dogfoods UI/API behavior with safety gates, Codex Computer Use-only UI evidence, safe fixes, and rechecks. |
51
- | Goal | Bridges SKS pipeline state to Codex native persisted `/goal` create, pause, resume, and clear workflows. |
51
+ | Computer Use fast lane | Uses `$Computer-Use` / `$CU` for UI/browser/visual work that needs maximum speed: skip Team debate and upfront TriWiki loops, use Codex Computer Use directly, then refresh/validate TriWiki and run Honest Mode at final closeout. |
52
+ | Goal | Provides a fast SKS bridge overlay for Codex native persisted `/goal` create, pause, resume, and clear controls; implementation continues through the selected SKS execution route. |
52
53
  | TriWiki voxels | Maintains `.sneakoscope/wiki/context-pack.json` as the context SSOT with coordinate anchors, voxel metadata, `attention.use_first`, and `attention.hydrate_first`. |
53
54
  | Context7 | Requires current docs for external packages, APIs, MCPs, SDKs, and framework/runtime behavior when correctness depends on current guidance. |
54
55
  | DB safety | Treats SQL, migrations, Supabase, RLS, and destructive operations as high risk. |
@@ -201,7 +202,7 @@ Agent sessions communicate through the bounded Team transcript. Use `sks team me
201
202
 
202
203
  When the Team route reaches `session_cleanup`, SKS marks the Warp launch record complete and asks `watch --follow` / `lane --follow` panes to show a cleanup summary and stop. You can also run `sks team cleanup-warp <mission-id|latest>` manually, or `sks team cleanup-warp latest --close` to remove the generated Launch Configuration. Warp's public URI/Launch Configuration surface does not expose a live pane-close API, so the panes remain user-controlled.
203
204
 
204
- ### QA, Goal, Research, DB, Wiki, GX
205
+ ### QA, Computer Use, Goal, Research, DB, Wiki, GX
205
206
 
206
207
  ```sh
207
208
  sks qa-loop prepare "http://localhost:3000"
@@ -222,6 +223,10 @@ sks proof-field scan --json --intent "small CLI change"
222
223
  sks code-structure scan --json
223
224
  ```
224
225
 
226
+ `sks goal` and `$Goal` only prepare/control the native `/goal` persistence bridge. They do not replace Team, QA, DB, or other implementation routes; use the selected execution route for the actual work and verification. Context7 is only needed for Goal when external API/library documentation becomes relevant.
227
+
228
+ Use `$Computer-Use` or `$CU` inside Codex App when the task specifically needs Codex Computer Use speed for UI/browser/visual work. This lane intentionally skips Team debate, QA-LOOP clarification, subagents, and upfront TriWiki refresh. It still requires Codex Computer Use as the evidence source, and it defers TriWiki refresh/validate plus Honest Mode to the final closeout.
229
+
225
230
  ## Codex App Usage
226
231
 
227
232
  Sneakoscope has two surfaces:
@@ -276,7 +281,8 @@ Use these inside Codex App or another agent prompt. They are prompt commands, no
276
281
  | `$Answer` | You want an answer only and no implementation should start. |
277
282
  | `$SKS` | You need setup, status, usage, or workflow help. |
278
283
  | `$QA-LOOP` | You want UI/API dogfooding, safe fixes, and rechecks. |
279
- | `$Goal` | You want Codex native persisted `/goal` continuation for a workflow. |
284
+ | `$Computer-Use` / `$CU` | You want the fastest Codex Computer Use lane for UI/browser/visual inspection or small safe fixes. |
285
+ | `$Goal` | You want a fast SKS bridge overlay for Codex native persisted `/goal` continuation. |
280
286
  | `$Research` | You need frontier-style research with hypotheses and falsification. |
281
287
  | `$AutoResearch` | You want iterative improve/test/keep-or-discard optimization. |
282
288
  | `$DB` | You need database, Supabase, migration, SQL, or MCP safety checks. |
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "sneakoscope",
3
3
  "displayName": "ㅅㅋㅅ",
4
- "version": "0.6.89",
4
+ "version": "0.6.93",
5
5
  "description": "Sneakoscope Codex: database-safe Codex CLI/App harness with Team, Goal, AutoResearch, TriWiki, and Honest Mode.",
6
6
  "type": "module",
7
7
  "homepage": "https://github.com/mandarange/Sneakoscope-Codex#readme",
package/src/cli/main.mjs CHANGED
@@ -523,7 +523,7 @@ async function updateCheck(args = []) {
523
523
  if (result.update_available) console.log('Run: npm i -g sneakoscope');
524
524
  }
525
525
 
526
- const DOLLAR_DEFAULT_PIPELINE_TEXT = 'Default pipeline: questions -> $Answer, small design/content -> $DFix, code -> $Team. Use $From-Chat-IMG only for chat screenshot plus original attachments. Use $MAD-SKS only as an explicit scoped DB authorization modifier that can be combined with another $ route. No route may invent unrequested fallback implementation code.';
526
+ const DOLLAR_DEFAULT_PIPELINE_TEXT = 'Default pipeline: questions -> $Answer, small design/content -> $DFix, Computer Use UI/browser speed work -> $Computer-Use, code -> $Team. Use $From-Chat-IMG only for chat screenshot plus original attachments. Use $MAD-SKS only as an explicit scoped DB authorization modifier that can be combined with another $ route. No route may invent unrequested fallback implementation code.';
527
527
 
528
528
  function commands(args = []) {
529
529
  if (flag(args, '--json')) return console.log(JSON.stringify({ aliases: ['sks', 'sneakoscope'], dollar_commands: DOLLAR_COMMANDS, app_skill_aliases: DOLLAR_COMMAND_ALIASES, commands: COMMAND_CATALOG }, null, 2));
@@ -1924,6 +1924,24 @@ async function selftest() {
1924
1924
  if (trippedStop) throw new Error('selftest failed: compliance loop guard did not terminally trip');
1925
1925
  const loopBlocker = await readJson(path.join(loopMission.dir, 'hard-blocker.json'), null);
1926
1926
  if (loopBlocker?.reason !== 'compliance_loop_guard_tripped') throw new Error('selftest failed: compliance loop guard did not write hard blocker');
1927
+ await setCurrent(tmp, loopState);
1928
+ const dfixPromptHook = await runProcess(process.execPath, [path.join(packageRoot(), 'bin', 'sks.mjs'), 'hook', 'user-prompt-submit'], {
1929
+ cwd: tmp,
1930
+ input: JSON.stringify({ cwd: tmp, prompt: '$DFix Change the CTA label only' }),
1931
+ timeoutMs: 15000,
1932
+ maxOutputBytes: 64 * 1024
1933
+ });
1934
+ if (dfixPromptHook.code !== 0) throw new Error(`selftest failed: DFix prompt hook exited ${dfixPromptHook.code}: ${dfixPromptHook.stderr}`);
1935
+ const dfixStopHook = await runProcess(process.execPath, [path.join(packageRoot(), 'bin', 'sks.mjs'), 'hook', 'stop'], {
1936
+ cwd: tmp,
1937
+ input: JSON.stringify({ cwd: tmp, last_assistant_message: 'DFix 완료 요약: CTA 라벨만 변경했습니다. 검증: 대상 파일 확인 통과. 남은 문제: 없음.' }),
1938
+ timeoutMs: 15000,
1939
+ maxOutputBytes: 64 * 1024
1940
+ });
1941
+ if (dfixStopHook.code !== 0) throw new Error(`selftest failed: DFix stop hook exited ${dfixStopHook.code}: ${dfixStopHook.stderr}`);
1942
+ const dfixStop = JSON.parse(dfixStopHook.stdout || '{}');
1943
+ if (dfixStop.decision === 'block' || dfixStop.continue === false) throw new Error(`selftest failed: DFix stop hook was blocked: ${dfixStopHook.stdout}`);
1944
+ if (!String(dfixStop.systemMessage || '').includes('DFix ultralight finalization accepted')) throw new Error('selftest failed: DFix stop hook did not use the ultralight finalization bypass');
1927
1945
  await writeJsonAtomic(path.join(loopMission.dir, 'team-roster.json'), { schema_version: 1, mission_id: loopMission.id, confirmed: true });
1928
1946
  await writeJsonAtomic(path.join(loopMission.dir, 'team-session-cleanup.json'), { schema_version: 1, passed: true, all_sessions_closed: true, outstanding_sessions: 0, live_transcript_finalized: true });
1929
1947
  await writeJsonAtomic(path.join(loopMission.dir, 'team-gate.json'), { passed: true, team_roster_confirmed: true, analysis_artifact: true, triwiki_refreshed: true, triwiki_validated: true, consensus_artifact: true, implementation_team_fresh: true, review_artifact: true, integration_evidence: true, session_cleanup: true });
@@ -2231,6 +2249,31 @@ async function selftest() {
2231
2249
  const hookState = await readJson(stateFile(hookGoalTmp), {});
2232
2250
  if (hookState.phase !== 'GOAL_READY' || hookState.mode !== 'GOAL') throw new Error('selftest failed: $Goal hook did not set ready state');
2233
2251
  if (!(await exists(path.join(missionDir(hookGoalTmp, hookState.mission_id), GOAL_WORKFLOW_ARTIFACT)))) throw new Error('selftest failed: $Goal hook did not write goal workflow artifact');
2252
+ const hookGoalDelegationTmp = tmpdir();
2253
+ await initProject(hookGoalDelegationTmp, {});
2254
+ const hookGoalDelegationPayload = JSON.stringify({ cwd: hookGoalDelegationTmp, prompt: '$Goal 설치 화면 문제 근본적으로 구현 수정해줘' });
2255
+ const hookGoalDelegationResult = await runProcess(process.execPath, [hookBin, 'hook', 'user-prompt-submit'], { cwd: hookGoalDelegationTmp, input: hookGoalDelegationPayload, env: { SKS_DISABLE_UPDATE_CHECK: '1' }, timeoutMs: 15000, maxOutputBytes: 256 * 1024 });
2256
+ if (hookGoalDelegationResult.code !== 0) throw new Error(`selftest failed: $Goal implementation delegation hook exited ${hookGoalDelegationResult.code}: ${hookGoalDelegationResult.stderr}`);
2257
+ const hookGoalDelegationJson = JSON.parse(hookGoalDelegationResult.stdout);
2258
+ const hookGoalDelegationContext = hookGoalDelegationJson.hookSpecificOutput?.additionalContext || '';
2259
+ const hookGoalDelegationBridgeMatch = hookGoalDelegationContext.match(/Goal bridge mission: (M-[A-Za-z0-9-]+)/);
2260
+ if (!hookGoalDelegationBridgeMatch || !hookGoalDelegationContext.includes('Delegated execution route: $Team')) throw new Error('selftest failed: $Goal implementation prompt did not prepare a bridge plus Team delegation');
2261
+ if (!hookGoalDelegationContext.includes('MANDATORY ambiguity-removal gate activated') || !hookGoalDelegationContext.includes('Route: $Team')) throw new Error('selftest failed: $Goal implementation delegation did not prepare Team ambiguity gate');
2262
+ const hookGoalDelegationState = await readJson(stateFile(hookGoalDelegationTmp), {});
2263
+ if (hookGoalDelegationState.mode !== 'TEAM' || hookGoalDelegationState.phase !== 'TEAM_CLARIFICATION_AWAITING_ANSWERS' || hookGoalDelegationState.implementation_allowed !== false) throw new Error('selftest failed: $Goal implementation delegation did not leave Team gate current');
2264
+ if (!(await exists(path.join(missionDir(hookGoalDelegationTmp, hookGoalDelegationBridgeMatch[1]), GOAL_WORKFLOW_ARTIFACT)))) throw new Error('selftest failed: $Goal implementation delegation did not write bridge workflow artifact');
2265
+ const activeGoalMissionId = hookState.mission_id;
2266
+ const hookGoalOverlayPayload = JSON.stringify({ cwd: hookGoalTmp, prompt: '설치 화면 문제 근본적으로 구현 수정해줘' });
2267
+ const hookGoalOverlayResult = await runProcess(process.execPath, [hookBin, 'hook', 'user-prompt-submit'], { cwd: hookGoalTmp, input: hookGoalOverlayPayload, env: { SKS_DISABLE_UPDATE_CHECK: '1' }, timeoutMs: 15000, maxOutputBytes: 256 * 1024 });
2268
+ if (hookGoalOverlayResult.code !== 0) throw new Error(`selftest failed: active Goal overlay hook exited ${hookGoalOverlayResult.code}: ${hookGoalOverlayResult.stderr}`);
2269
+ const hookGoalOverlayJson = JSON.parse(hookGoalOverlayResult.stdout);
2270
+ const hookGoalOverlayContext = hookGoalOverlayJson.hookSpecificOutput?.additionalContext || '';
2271
+ if (!hookGoalOverlayContext.includes('MANDATORY ambiguity-removal gate activated') || !hookGoalOverlayContext.includes('Route: $Team')) throw new Error('selftest failed: active Goal hijacked a plain Korean implementation prompt instead of preparing Team');
2272
+ if (!hookGoalOverlayContext.includes(`Active Goal overlay: existing Goal mission ${activeGoalMissionId}`) || !hookGoalOverlayContext.includes('goal-workflow.json')) throw new Error('selftest failed: active Goal overlay context was not included with the new route');
2273
+ if (hookGoalOverlayContext.indexOf('MANDATORY ambiguity-removal gate activated') > hookGoalOverlayContext.indexOf('Active Goal overlay:')) throw new Error('selftest failed: active Goal overlay appeared before the newly prepared Team gate');
2274
+ const hookGoalOverlayState = await readJson(stateFile(hookGoalTmp), {});
2275
+ if (hookGoalOverlayState.mission_id === activeGoalMissionId || hookGoalOverlayState.mode !== 'TEAM' || hookGoalOverlayState.phase !== 'TEAM_CLARIFICATION_AWAITING_ANSWERS' || hookGoalOverlayState.implementation_allowed !== false) throw new Error('selftest failed: active Goal overlay did not leave a new Team ambiguity mission current');
2276
+ if (!(await exists(path.join(missionDir(hookGoalTmp, hookGoalOverlayState.mission_id), 'required-answers.schema.json')))) throw new Error('selftest failed: active Goal overlay Team mission did not write ambiguity schema');
2234
2277
  const hookUpdateCurrentTmp = tmpdir();
2235
2278
  await initProject(hookUpdateCurrentTmp, {});
2236
2279
  const hookUpdateCurrentPayload = JSON.stringify({ cwd: hookUpdateCurrentTmp, prompt: '상태 확인해줘' });
@@ -2778,6 +2821,7 @@ async function selftest() {
2778
2821
  if (!warpTeam.launch_uri?.includes(encodeURIComponent(`sks-team-${teamId}.yaml`))) throw new Error('selftest failed: Team warp launch URI is not named for visibility');
2779
2822
  if (routeReasoning(routePrompt('$Research frontier idea'), '$Research frontier idea').effort !== 'xhigh') throw new Error('selftest failed: research reasoning not xhigh');
2780
2823
  if (routeReasoning(routePrompt('$From-Chat-IMG 채팅 이미지 작업'), '$From-Chat-IMG 채팅 이미지 작업').effort !== 'xhigh') throw new Error('selftest failed: From-Chat-IMG reasoning not xhigh');
2824
+ if (routeReasoning(routePrompt('$Computer-Use localhost UI smoke'), '$Computer-Use localhost UI smoke').effort !== 'low') throw new Error('selftest failed: Computer Use fast lane reasoning not low');
2781
2825
  if (routeReasoning(routePrompt('$DB migration'), '$DB migration').effort !== 'high') throw new Error('selftest failed: logical reasoning not high');
2782
2826
  const lowReasoning = routeReasoning({ id: 'LowSmoke', reasoningPolicy: 'low' }, 'small metadata read');
2783
2827
  if (lowReasoning.effort !== 'low' || lowReasoning.profile !== 'sks-task-low') throw new Error('selftest failed: low reasoning did not route to sks-task-low');
@@ -2817,13 +2861,19 @@ async function selftest() {
2817
2861
  if (routePrompt('implement feature')?.id !== 'Team') throw new Error('selftest failed: implementation prompt did not default to Team');
2818
2862
  if (routePrompt('$SKS implement feature')?.id !== 'Team') throw new Error('selftest failed: $SKS implementation prompt did not promote to Team');
2819
2863
  if (routePrompt('$From-Chat-IMG 채팅 기록 이미지와 첨부 이미지로 고객사 요청 수정 작업 수행해줘')?.id !== 'Team') throw new Error('selftest failed: explicit chat capture client work did not promote to Team');
2864
+ if (routePrompt('$Computer-Use localhost 화면 빠르게 검증해줘')?.id !== 'ComputerUse') throw new Error('selftest failed: $Computer-Use did not route to ComputerUse fast lane');
2865
+ if (routePrompt('$CU localhost 화면 빠르게 검증해줘')?.id !== 'ComputerUse') throw new Error('selftest failed: $CU did not route to ComputerUse fast lane');
2866
+ if (routePrompt('computer use 사용하는 파이프라인은 마지막에 triwiki honest mode만 실행되게 조정해줘')?.id !== 'ComputerUse') throw new Error('selftest failed: Computer Use pipeline request was misrouted away from fast lane');
2867
+ if (routePrompt('triwiki나 honest mode가 마지막에만 실행되게 computer use 파이프라인 조정해줘')?.id !== 'ComputerUse') throw new Error('selftest failed: Computer Use directive was hijacked by Wiki route');
2820
2868
  if (routePrompt('$SKS show me available workflows')?.id !== 'SKS') throw new Error('selftest failed: $SKS workflow discovery should remain SKS');
2821
2869
  if (routeRequiresSubagents(routePrompt('이 파이프라인은 왜 이렇게 동작해?'), '이 파이프라인은 왜 이렇게 동작해?')) throw new Error('selftest failed: Answer route requires subagents');
2822
2870
  if (!routeRequiresSubagents(routePrompt('implement feature'), 'implement feature')) throw new Error('selftest failed: default Team implementation route does not require subagents');
2823
2871
  if (!routeRequiresSubagents(routePrompt('$Team implement feature'), '$Team implement feature')) throw new Error('selftest failed: Team route does not require subagents');
2872
+ if (routeRequiresSubagents(routePrompt('$Computer-Use localhost UI smoke'), '$Computer-Use localhost UI smoke')) throw new Error('selftest failed: Computer Use fast lane requires subagents');
2824
2873
  if (!routeRequiresSubagents(routePrompt('$Goal implement feature'), '$Goal implement feature')) throw new Error('selftest failed: Goal implementation route does not require subagents');
2825
2874
  if (routeRequiresSubagents(routePrompt('$Help commands'), '$Help commands')) throw new Error('selftest failed: Help route incorrectly requires subagents');
2826
2875
  if (!reflectionRequiredForRoute(routePrompt('$Team implement feature'))) throw new Error('selftest failed: Team route does not require reflection');
2876
+ if (reflectionRequiredForRoute(routePrompt('$Computer-Use localhost UI smoke'))) throw new Error('selftest failed: Computer Use fast lane requires full-route reflection');
2827
2877
  if (!reflectionRequiredForRoute(routePrompt('$DB migration'))) throw new Error('selftest failed: DB route does not require reflection');
2828
2878
  if (reflectionRequiredForRoute(routePrompt('$DFix button label'))) throw new Error('selftest failed: DFix route incorrectly requires reflection');
2829
2879
  if (reflectionRequiredForRoute(routePrompt('이 파이프라인은 왜 이렇게 동작해?'))) throw new Error('selftest failed: Answer route incorrectly requires reflection');
@@ -354,7 +354,7 @@ async function goalCreate(args) {
354
354
  if (!prompt) throw new Error('Missing goal task prompt.');
355
355
  const { id, dir, mission } = await createMission(root, { mode: 'goal', prompt });
356
356
  const workflow = await writeGoalWorkflow(dir, mission, { action: 'create', prompt });
357
- await setCurrent(root, { mission_id: id, mode: 'GOAL', route: 'Goal', route_command: '$Goal', phase: 'GOAL_READY', questions_allowed: true, implementation_allowed: true, native_goal: workflow.native_goal, stop_gate: 'honest_mode' });
357
+ await setCurrent(root, { mission_id: id, mode: 'GOAL', route: 'Goal', route_command: '$Goal', phase: 'GOAL_READY', questions_allowed: true, implementation_allowed: true, native_goal: workflow.native_goal, stop_gate: 'none' });
358
358
  console.log(`Goal mission created: ${id}`);
359
359
  console.log(`Artifact: ${path.relative(root, path.join(dir, GOAL_WORKFLOW_ARTIFACT))}`);
360
360
  console.log(`Bridge: ${path.relative(root, path.join(dir, GOAL_BRIDGE_ARTIFACT))}`);
@@ -367,7 +367,7 @@ async function goalControl(action, args) {
367
367
  if (!id) throw new Error(`Usage: sks goal ${action} <mission-id|latest>`);
368
368
  const { dir } = await loadMission(root, id);
369
369
  const workflow = await updateGoalWorkflow(dir, action);
370
- await setCurrent(root, { mission_id: id, mode: 'GOAL', route: 'Goal', route_command: '$Goal', phase: `GOAL_${String(action).toUpperCase()}`, native_goal: workflow.native_goal, questions_allowed: true, implementation_allowed: action !== 'pause' && action !== 'clear' });
370
+ await setCurrent(root, { mission_id: id, mode: 'GOAL', route: 'Goal', route_command: '$Goal', phase: `GOAL_${String(action).toUpperCase()}`, native_goal: workflow.native_goal, questions_allowed: true, implementation_allowed: action !== 'pause' && action !== 'clear', stop_gate: 'none' });
371
371
  console.log(`Goal ${action}: ${id}`);
372
372
  console.log(`Native Codex control: ${workflow.native_goal.slash_command}`);
373
373
  }
package/src/core/fsx.mjs CHANGED
@@ -5,7 +5,7 @@ import os from 'node:os';
5
5
  import crypto from 'node:crypto';
6
6
  import { spawn } from 'node:child_process';
7
7
 
8
- export const PACKAGE_VERSION = '0.6.89';
8
+ export const PACKAGE_VERSION = '0.6.93';
9
9
  export const DEFAULT_PROCESS_TAIL_BYTES = 256 * 1024;
10
10
  export const DEFAULT_PROCESS_TIMEOUT_MS = 30 * 60 * 1000;
11
11
 
@@ -26,15 +26,18 @@ export async function writeGoalWorkflow(dir, mission, opts = {}) {
26
26
  prompt,
27
27
  native_goal: {
28
28
  slash_command: nativeGoalCommand(action, prompt),
29
- workflow_kind: 'persisted /goal',
29
+ workflow_kind: 'native /goal persistence bridge',
30
30
  controls: ['create', 'pause', 'resume', 'clear'],
31
31
  runtime_continuation: true,
32
32
  app_server_api_backed: true,
33
33
  model_tools_available: true
34
34
  },
35
35
  pipeline_contract: {
36
+ overlay_only: true,
36
37
  ralph_removed: true,
37
- ambiguity_gate: 'use normal SKS ambiguity gates when required by the selected execution route; Goal itself delegates persistence/continuation to Codex /goal',
38
+ ambiguity_gate: 'Goal creates/controls the native /goal persistence bridge only; use normal SKS ambiguity gates on the selected execution route when implementation is needed',
39
+ context7: 'optional for Goal bridge/control unless external API/library documentation is involved',
40
+ implementation: 'continue implementation through the selected SKS execution route; Goal is not a heavyweight independent implementation pipeline',
38
41
  evidence: ['goal-workflow.json', 'goal-bridge.md']
39
42
  },
40
43
  phase: action === 'clear' ? 'reporting' : 'intake',
@@ -44,9 +47,9 @@ export async function writeGoalWorkflow(dir, mission, opts = {}) {
44
47
  {
45
48
  timestamp: nowIso(),
46
49
  phase: 'intake',
47
- summary: 'Goal workflow bridge created.',
48
- completed_checkboxes: ['goal workflow artifact written'],
49
- open_checkboxes: ['continue original SKS route lifecycle when implementation is needed'],
50
+ summary: 'Goal workflow bridge created as a native /goal persistence overlay.',
51
+ completed_checkboxes: ['goal bridge artifact written'],
52
+ open_checkboxes: ['continue the selected SKS execution route when implementation is needed'],
50
53
  blockers: [],
51
54
  evidence: [GOAL_WORKFLOW_ARTIFACT, GOAL_BRIDGE_ARTIFACT]
52
55
  }
@@ -54,7 +57,7 @@ export async function writeGoalWorkflow(dir, mission, opts = {}) {
54
57
  resume_context: {
55
58
  stable_requirements: prompt ? [prompt] : [],
56
59
  current_files: [GOAL_WORKFLOW_ARTIFACT, GOAL_BRIDGE_ARTIFACT],
57
- decisions: ['Codex native /goal is the persisted continuation surface'],
60
+ decisions: ['Codex native /goal is the persisted continuation surface', '$Goal is a lightweight bridge overlay, not an independent implementation pipeline'],
58
61
  known_mistakes_to_avoid: ['do not clear noisy context without writing a structured handoff first'],
59
62
  active_skills: ['goal'],
60
63
  active_agents: []
@@ -79,7 +82,7 @@ export async function updateGoalWorkflow(dir, action) {
79
82
  action,
80
83
  status: action === 'clear' ? 'cleared' : action === 'pause' ? 'paused' : action === 'resume' ? 'resumed' : current.status || 'created',
81
84
  updated_at: nowIso(),
82
- phase: action === 'pause' ? 'reporting' : action === 'resume' ? 'implementation' : action === 'clear' ? 'retro' : current.phase || 'intake',
85
+ phase: action === 'pause' ? 'reporting' : action === 'resume' ? 'continuation' : action === 'clear' ? 'retro' : current.phase || 'intake',
83
86
  native_goal: {
84
87
  ...(current.native_goal || {}),
85
88
  slash_command: nativeGoalCommand(action, current.prompt || '')
@@ -89,7 +92,7 @@ export async function updateGoalWorkflow(dir, action) {
89
92
  {
90
93
  timestamp: nowIso(),
91
94
  phase: action,
92
- summary: `Goal ${action} requested through SKS bridge.`,
95
+ summary: `Goal ${action} requested through native /goal bridge overlay.`,
93
96
  completed_checkboxes: [`goal ${action} artifact update`],
94
97
  open_checkboxes: action === 'clear' ? ['handoff preserved before noisy context clear'] : [],
95
98
  blockers: [],
@@ -104,7 +107,7 @@ export async function updateGoalWorkflow(dir, action) {
104
107
  }
105
108
 
106
109
  function goalBridgeMarkdown(workflow) {
107
- return `# SKS Goal Bridge
110
+ return `# SKS Goal Persistence Bridge
108
111
 
109
112
  Mission: ${workflow.mission_id}
110
113
  Status: ${workflow.status}
@@ -118,11 +121,13 @@ Run this in the Codex TUI when interactive native goal control is available:
118
121
  ${workflow.native_goal.slash_command}
119
122
  \`\`\`
120
123
 
121
- ## SKS Pipeline Contract
124
+ ## SKS Bridge Contract
122
125
 
123
126
  - Ralph route is removed from the user-facing SKS surface.
124
- - This mission uses Codex native persisted \`/goal\` workflow semantics for continuation.
127
+ - This file is a fast SKS overlay for Codex native persisted \`/goal\` workflow semantics.
128
+ - \`$Goal\` is not a heavyweight independent implementation pipeline.
125
129
  - SKS still records route evidence in \`${GOAL_WORKFLOW_ARTIFACT}\` and this bridge file.
126
- - If implementation work is needed, continue through the normal SKS route gates for that work and report verification evidence honestly.
130
+ - If implementation work is needed, continue through the selected SKS execution route gates for that work and report verification evidence honestly.
131
+ - Context7 is optional for Goal bridge/control unless external API/library documentation becomes relevant.
127
132
  `;
128
133
  }
@@ -12,9 +12,11 @@ const TEAM_DIGEST_MESSAGE_CHARS = 180;
12
12
  const TEAM_DIGEST_CONTEXT_CHARS = 1600;
13
13
  const TEAM_DIGEST_SYSTEM_CHARS = 260;
14
14
  const STOP_REPEAT_GUARD_ARTIFACT = 'stop-hook-repeat-guard.json';
15
+ const LIGHT_ROUTE_STOP_ARTIFACT = 'light-route-stop.json';
15
16
  const STOP_REPEAT_GUARD_WINDOW_MS = 10 * 60 * 1000;
16
17
  const STOP_REPEAT_GUARD_MAX_ENTRIES = 25;
17
18
  const DEFAULT_STOP_REPEAT_GUARD_LIMIT = 2;
19
+ const LIGHT_ROUTE_STOP_WINDOW_MS = 10 * 60 * 1000;
18
20
 
19
21
  async function loadHookPayload() {
20
22
  const raw = await readStdin();
@@ -111,6 +113,8 @@ async function hookUserPrompt(root, state, payload, noQuestion) {
111
113
  const command = dollarCommand(prompt);
112
114
  const route = routePrompt(prompt);
113
115
  const bypassActiveRoute = route?.id === 'DFix' || route?.id === 'Answer';
116
+ const goalOverlay = activeGoalOverlayContext(state, route);
117
+ if (route?.id === 'DFix') await recordLightRouteStop(root, route, payload, prompt);
114
118
  if (isClarificationAwaiting(state) && !looksLikeClarificationCancel(prompt)) {
115
119
  const activeContext = await activeRouteContext(root, state);
116
120
  const teamDigest = await teamLiveDigest(root, state);
@@ -120,8 +124,9 @@ async function hookUserPrompt(root, state, payload, noQuestion) {
120
124
  const teamDigest = bypassActiveRoute ? null : await teamLiveDigest(root, state);
121
125
  const activeContext = await activeRouteContext(root, state);
122
126
  const contexts = [updateContext];
123
- if (activeContext && !command && !bypassActiveRoute) contexts.push(routePipelineContext(prompt), activeContext);
127
+ if (activeContext && !command && !bypassActiveRoute && !goalOverlay) contexts.push(routePipelineContext(prompt), activeContext);
124
128
  else contexts.push((await prepareRoute(root, prompt, state)).additionalContext);
129
+ if (goalOverlay) contexts.push(goalOverlay);
125
130
  if (teamDigest?.context) contexts.push(teamDigest.context);
126
131
  const additionalContext = contexts.filter(Boolean).join('\n\n');
127
132
  return { continue: true, additionalContext, systemMessage: joinSystemMessages(visibleHookMessage('user-prompt-submit', additionalContext), teamDigest?.system) };
@@ -143,6 +148,16 @@ function looksLikeClarificationCancel(prompt = '') {
143
148
  return /^(cancel|reset|restart|new mission|새로|취소|중단|리셋|다시 시작)\b/i.test(String(prompt || '').trim());
144
149
  }
145
150
 
151
+ function activeGoalOverlayContext(state = {}, route = null) {
152
+ if (state.mode !== 'GOAL' || !state.mission_id) return '';
153
+ if (!route || route.id === 'Goal' || route.id === 'DFix' || route.id === 'Answer') return '';
154
+ return [
155
+ `Active Goal overlay: existing Goal mission ${state.mission_id} remains available for lightweight continuation context only.`,
156
+ `Do not let that active Goal hijack this new ${route.command || '$SKS'} prompt. The newly prepared route mission and gate are authoritative for this turn.`,
157
+ `Goal artifact: .sneakoscope/missions/${state.mission_id}/goal-workflow.json. Use Codex native /goal controls only if the user explicitly returns to $Goal.`
158
+ ].join('\n');
159
+ }
160
+
146
161
  async function hookPreTool(root, state, payload, noQuestion) {
147
162
  const harnessDecision = await checkHarnessModification(root, payload, { phase: 'pre-tool' });
148
163
  if (harnessDecision.action === 'block') {
@@ -222,6 +237,12 @@ async function hookPermission(root, state, payload, noQuestion) {
222
237
  }
223
238
 
224
239
  async function hookStop(root, state, payload, noQuestion) {
240
+ if (!noQuestion && await consumeLightRouteStop(root, payload)) {
241
+ return {
242
+ continue: true,
243
+ systemMessage: 'SKS: DFix ultralight finalization accepted; full-route Honest Mode loopback is not required.'
244
+ };
245
+ }
225
246
  const routeDecision = await evaluateStop(root, state, payload, { noQuestion });
226
247
  if (routeDecision) return routeDecision;
227
248
  if (!noQuestion) {
@@ -258,6 +279,46 @@ async function hookStop(root, state, payload, noQuestion) {
258
279
  };
259
280
  }
260
281
 
282
+ async function recordLightRouteStop(root, route = {}, payload = {}, prompt = '') {
283
+ const now = nowIso();
284
+ const expires = new Date(Date.parse(now) + LIGHT_ROUTE_STOP_WINDOW_MS).toISOString();
285
+ const file = path.join(root, '.sneakoscope', 'state', LIGHT_ROUTE_STOP_ARTIFACT);
286
+ await writeJsonAtomic(file, {
287
+ schema_version: 1,
288
+ route: route.id || null,
289
+ route_command: route.command || null,
290
+ mode: route.mode || null,
291
+ conversation_id: conversationId(payload),
292
+ prompt_hash: sha256(String(prompt || '')).slice(0, 16),
293
+ created_at: now,
294
+ expires_at: expires,
295
+ pending_stop_bypass: true,
296
+ stop_policy: 'dfix_ultralight_bypasses_full_route_honest_mode'
297
+ }).catch(() => null);
298
+ }
299
+
300
+ async function consumeLightRouteStop(root, payload = {}) {
301
+ const file = path.join(root, '.sneakoscope', 'state', LIGHT_ROUTE_STOP_ARTIFACT);
302
+ const record = await readJson(file, null).catch(() => null);
303
+ if (!record?.pending_stop_bypass) return false;
304
+ if (record.route !== 'DFix') return false;
305
+ const nowMs = Date.now();
306
+ const expiresMs = Date.parse(record.expires_at || '');
307
+ if (!Number.isFinite(expiresMs) || expiresMs < nowMs) return false;
308
+ const currentConversation = conversationId(payload);
309
+ if (record.conversation_id && explicitConversationId(payload) && record.conversation_id !== currentConversation) return false;
310
+ await writeJsonAtomic(file, {
311
+ ...record,
312
+ pending_stop_bypass: false,
313
+ consumed_at: nowIso()
314
+ }).catch(() => null);
315
+ return true;
316
+ }
317
+
318
+ function explicitConversationId(payload = {}) {
319
+ return payload.conversation_id || payload.thread_id || payload.session_id || payload.chat_id || null;
320
+ }
321
+
261
322
  async function finalizationRepeatDecision(root, state = {}, payload = {}, reason = '', kind = 'finalization') {
262
323
  const now = nowIso();
263
324
  const guardPath = path.join(root, '.sneakoscope', 'state', STOP_REPEAT_GUARD_ARTIFACT);
@@ -722,6 +783,7 @@ function visibleHookMessage(name, text = '') {
722
783
  if (body.includes('SKS answer-only pipeline active')) return 'SKS: answer-only research context injected.';
723
784
  if (body.includes('SKS wiki pipeline active')) return 'SKS: wiki refresh context injected.';
724
785
  if (body.includes('$Goal route prepared')) return 'SKS: Goal workflow bridge prepared for native Codex /goal continuation.';
786
+ if (body.includes('Computer Use fast lane active')) return 'SKS: Computer Use fast lane injected; defer TriWiki/Honest Mode to final closeout.';
725
787
  if (body.includes('MANDATORY ambiguity-removal gate') || body.includes('VISIBLE RESPONSE CONTRACT') || body.includes('Required questions still pending')) return 'SKS: clarification questions must be shown in chat before the route can continue.';
726
788
  if (body.includes('$Team route prepared') || body.includes('Team route')) return 'SKS: Team route, live transcript, and subagent plan injected.';
727
789
  if (body.includes('$QA-LOOP route prepared') || body.includes('QA-LOOP')) return 'SKS: QA-LOOP route and safety checklist injected.';
package/src/core/init.mjs CHANGED
@@ -90,7 +90,7 @@ function isSksManagedHook(hook) {
90
90
  return hook.type === 'command' && /\bhook\s+(?:user-prompt-submit|pre-tool|post-tool|permission-request|stop)\b/.test(command) && /\b(?:sks|sneakoscope|sks\.mjs)\b/.test(command);
91
91
  }
92
92
 
93
- const AGENTS_BLOCK = "\n# Sneakoscope Codex Managed Rules\n\nThis repository uses Sneakoscope Codex.\n\n## Core Rules\n\n- Codex native `/goal` workflows are the persisted continuation surface; Ralph is removed from the user-facing SKS surface.\n- Keep runtime state bounded: raw logs go to files, prompts get tails/summaries, and `sks gc` may prune stale artifacts.\n- Before substantive work, SKS checks npm for a newer package. If newer, ask update-now vs skip-for-this-conversation.\n- Versioning is managed by the SKS pre-commit hook; check `sks versioning status`. Bypass only with `SKS_DISABLE_VERSIONING=1`.\n- Installed harness files are immutable to LLM edits: `.codex/*`, `.agents/skills/`, `.codex/agents/`, `.sneakoscope/*policy*.json`, `AGENTS.md`, and `node_modules/sneakoscope`. The Sneakoscope engine source repo is the only automatic exception.\n- OMX/DCodex conflicts block setup/doctor. Show `sks conflicts prompt`; cleanup requires explicit human approval.\n- Do not stop at a plan when implementation was requested. Finish, verify, or report the hard blocker.\n- Do not create unrequested fallback implementation code. If the requested path is impossible, block with evidence instead of inventing substitute behavior.\n\n## Routes\n\n- General execution/code-changing prompts default to `$Team`: analysis scouts, TriWiki refresh/validate, read-only debate, consensus, concrete runtime task graph/inboxes, fresh executor team, review, integration, Honest Mode.\n- `$Goal` bridges SKS pipeline state to Codex native `/goal` create/pause/resume/clear continuation controls.\n- TriWiki recall must stay bounded. Use `sks wiki sweep` to record demote, soft-forget, archive, delete, promote-to-skill, and promote-to-rule candidates instead of injecting every old claim.\n- Team missions must keep schema-backed evidence current: `work-order-ledger.json`, `effort-decision.json`, `team-dashboard-state.json`, and route-specific visual/dogfood artifacts where applicable. Use `sks validate-artifacts latest` before claiming those artifacts pass.\n- `$DFix` is only for tiny design/content edits and bypasses the main pipeline. `$Answer`, `$Help`, and `$Wiki` stay lightweight.\n- For code work, surface route/guard/write scopes first, split independent worker scopes when available, and keep parent-owned integration and verification.\n- Design work reads `design.md`; if missing, use `design-system-builder`. Image/logo/raster assets use `imagegen`.\n- Research, AutoResearch, performance, token, accuracy, SEO/GEO, or workflow-improvement claims need experiment/eval evidence. Do not claim live model accuracy without a scored dataset.\n- Treat handwritten files above 3000 lines as split-review risks. Run `sks code-structure scan` and prefer extraction before adding substantial logic.\n\n## Evidence And Context\n\n- Context7 is required for external libraries, APIs, MCPs, package managers, SDKs, and generated docs: resolve-library-id then query-docs.\n- When tech stack, framework, package, runtime, or deployment-platform versions change, use Context7 or official vendor web docs, record current syntax/security/limit guidance as high-priority TriWiki claims, then refresh and validate before coding.\n- TriWiki is the context-tracking SSOT for long-running missions, Team handoffs, and context-pressure recovery. Read `.sneakoscope/wiki/context-pack.json` before each stage, use `attention.use_first` for compact high-trust recall, hydrate `attention.hydrate_first` from source before risky or lower-trust decisions, refresh after findings or artifact changes, and validate before handoffs/final claims.\n- Source priority: current code/tests/config, decision contract, vgraph, beta, GX render/snapshot metadata, LLM Wiki coordinate index, then model knowledge only if allowed.\n- Final response before stop: summarize what was done, what changed for the user/repo, what was verified, and what remains unverified or blocked; then run Honest Mode. Say what passed and what was not verified.\n- `$From-Chat-IMG` uses forensic visual effort, not ordinary Team effort. Completion is blocked until source inventory, visual mapping, work-order coverage, scoped dogfood/QA, and post-fix verification artifacts are present and valid.\n\n## Safety\n\n- Database access is high risk. Use read-only inspection by default; live data mutation is out of scope unless a sealed contract allows local or branch-only migration files.\n- MAD and MAD-SKS widen only explicit scoped permissions; they still do not authorize unrequested fallback implementation code.\n- Task completion requires relevant tests or justification, zero unsupported critical claims, accepted visual/wiki drift, and final evidence.\n\n## Codex App\n\nUse `.codex/SNEAKOSCOPE.md`, generated `.agents/skills`, `.codex/hooks.json`, and SKS dollar commands (`$sks`, `$team`, `$goal`, `$dfix`, `$qa-loop`, etc.) as the app control surface.\n";
93
+ const AGENTS_BLOCK = "\n# Sneakoscope Codex Managed Rules\n\nThis repository uses Sneakoscope Codex.\n\n## Core Rules\n\n- Codex native `/goal` workflows are the persisted continuation surface; Ralph is removed from the user-facing SKS surface.\n- Keep runtime state bounded: raw logs go to files, prompts get tails/summaries, and `sks gc` may prune stale artifacts.\n- Before substantive work, SKS checks npm for a newer package. If newer, ask update-now vs skip-for-this-conversation.\n- Versioning is managed by the SKS pre-commit hook; check `sks versioning status`. Bypass only with `SKS_DISABLE_VERSIONING=1`.\n- Installed harness files are immutable to LLM edits: `.codex/*`, `.agents/skills/`, `.codex/agents/`, `.sneakoscope/*policy*.json`, `AGENTS.md`, and `node_modules/sneakoscope`. The Sneakoscope engine source repo is the only automatic exception.\n- OMX/DCodex conflicts block setup/doctor. Show `sks conflicts prompt`; cleanup requires explicit human approval.\n- Do not stop at a plan when implementation was requested. Finish, verify, or report the hard blocker.\n- Do not create unrequested fallback implementation code. If the requested path is impossible, block with evidence instead of inventing substitute behavior.\n\n## Routes\n\n- General execution/code-changing prompts default to `$Team`: analysis scouts, TriWiki refresh/validate, read-only debate, consensus, concrete runtime task graph/inboxes, fresh executor team, review, integration, Honest Mode.\n- `$Computer-Use` / `$CU` is the maximum-speed Codex Computer Use lane for UI/browser/visual tasks: skip Team debate and upfront TriWiki loops, use Codex Computer Use directly, then refresh/validate TriWiki and run Honest Mode at final closeout.\n- `$Goal` is a fast bridge/overlay for Codex native `/goal` create/pause/resume/clear persistence controls; implementation continues through the selected SKS execution route.\n- TriWiki recall must stay bounded. Use `sks wiki sweep` to record demote, soft-forget, archive, delete, promote-to-skill, and promote-to-rule candidates instead of injecting every old claim.\n- Team missions must keep schema-backed evidence current: `work-order-ledger.json`, `effort-decision.json`, `team-dashboard-state.json`, and route-specific visual/dogfood artifacts where applicable. Use `sks validate-artifacts latest` before claiming those artifacts pass.\n- `$DFix` is only for tiny design/content edits and bypasses the main pipeline. `$Answer`, `$Help`, and `$Wiki` stay lightweight.\n- For code work, surface route/guard/write scopes first, split independent worker scopes when available, and keep parent-owned integration and verification.\n- Design work reads `design.md`; if missing, use `design-system-builder`. Image/logo/raster assets use `imagegen`.\n- Research, AutoResearch, performance, token, accuracy, SEO/GEO, or workflow-improvement claims need experiment/eval evidence. Do not claim live model accuracy without a scored dataset.\n- Treat handwritten files above 3000 lines as split-review risks. Run `sks code-structure scan` and prefer extraction before adding substantial logic.\n\n## Evidence And Context\n\n- Context7 is required for external libraries, APIs, MCPs, package managers, SDKs, and generated docs: resolve-library-id then query-docs.\n- When tech stack, framework, package, runtime, or deployment-platform versions change, use Context7 or official vendor web docs, record current syntax/security/limit guidance as high-priority TriWiki claims, then refresh and validate before coding.\n- TriWiki is the context-tracking SSOT for long-running missions, Team handoffs, and context-pressure recovery. Read `.sneakoscope/wiki/context-pack.json` before each stage, use `attention.use_first` for compact high-trust recall, hydrate `attention.hydrate_first` from source before risky or lower-trust decisions, refresh after findings or artifact changes, and validate before handoffs/final claims.\n- Source priority: current code/tests/config, decision contract, vgraph, beta, GX render/snapshot metadata, LLM Wiki coordinate index, then model knowledge only if allowed.\n- Final response before stop: summarize what was done, what changed for the user/repo, what was verified, and what remains unverified or blocked; then run Honest Mode. Say what passed and what was not verified.\n- `$From-Chat-IMG` uses forensic visual effort, not ordinary Team effort. Completion is blocked until source inventory, visual mapping, work-order coverage, scoped dogfood/QA, and post-fix verification artifacts are present and valid.\n\n## Safety\n\n- Database access is high risk. Use read-only inspection by default; live data mutation is out of scope unless a sealed contract allows local or branch-only migration files.\n- MAD and MAD-SKS widen only explicit scoped permissions; they still do not authorize unrequested fallback implementation code.\n- Task completion requires relevant tests or justification, zero unsupported critical claims, accepted visual/wiki drift, and final evidence.\n\n## Codex App\n\nUse `.codex/SNEAKOSCOPE.md`, generated `.agents/skills`, `.codex/hooks.json`, and SKS dollar commands (`$sks`, `$team`, `$computer-use`, `$cu`, `$goal`, `$dfix`, `$qa-loop`, etc.) as the app control surface.\n";
94
94
 
95
95
  export async function initProject(root, opts = {}) {
96
96
  const created = [];
@@ -527,14 +527,17 @@ function codexAppQuickReference(scope, commandPrefix) {
527
527
 
528
528
  export async function installSkills(root) {
529
529
  const skills = {
530
- 'dfix': `---\nname: dfix\ndescription: Ultralight fast design/content fix mode for $DFix or $dfix requests and inferred simple edits such as text color, copy, labels, spacing, or translation.\n---\n\nUse for tiny copy/color/label/spacing/translation edits. List exact micro-edits, inspect only needed files, apply only those edits, and run cheap verification. Bypass broad SKS routing, Goal, Research, eval, and redesign. Read \`design.md\` for UI work when present; use imagegen for image/logo/raster assets.\n`,
530
+ 'dfix': `---\nname: dfix\ndescription: Ultralight fast design/content fix mode for $DFix or $dfix requests and inferred simple edits such as text color, copy, labels, spacing, or translation.\n---\n\nUse for tiny copy/color/label/spacing/translation edits. List exact micro-edits, inspect only needed files, apply only those edits, and run cheap verification. Bypass broad SKS routing, Goal, Research, eval, redesign, and repeated full-route Honest Mode loops. Read \`design.md\` for UI work when present; use imagegen for image/logo/raster assets.\n`,
531
531
  'answer': `---\nname: answer\ndescription: Answer-only research route for ordinary questions that should not start implementation.\n---\n\nUse for explanations, comparisons, status, facts, source-backed research, or docs guidance. Use repo/TriWiki first for project-local facts; hydrate low-trust claims from source. Browse or use Context7 for current external package/API/framework/MCP docs. End with a concise answer summary plus Honest Mode; do not create missions, subagents, or file edits.\n`,
532
532
  'sks': `---\nname: sks\ndescription: General Sneakoscope Codex command route for $SKS or $sks usage, setup, status, and workflow help.\n---\n\nUse local SKS commands: bootstrap, deps, commands, quickstart, codex-app, context7, guard, conflicts, reasoning, wiki, pipeline. Promote code-changing work to Team unless Answer/DFix/Help/Wiki/safety route fits. Surface route/guard/scope, use TriWiki, do not edit installed harness files outside this engine repo, and require human-approved conflict cleanup.\n`,
533
533
  'wiki': `---\nname: wiki\ndescription: Dollar-command route for $Wiki TriWiki refresh, pack, validate, and prune commands.\n---\n\nUse for $Wiki or Korean wiki-refresh requests. Refresh/update/갱신: run sks wiki refresh, then validate .sneakoscope/wiki/context-pack.json. Pack: run sks wiki pack, then validate. Prune/clean/정리: use sks wiki refresh --prune, or sks wiki prune --dry-run for inspection. Report claims, anchors, trust, attention.use_first/hydrate_first, validation, and blockers. Do not start ambiguity-gated implementation, subagents, or unrelated work.\n`,
534
534
  'team': `---\nname: team\ndescription: SKS Team orchestration for $Team/code work; $From-Chat-IMG is the explicit chat-image alias.\n---\n\nUse for $Team/code work. Ambiguity gate first. Write team-roster.json; team-gate.json needs team_roster_confirmed=true. executor:N means N scouts, N debate voices, then fresh N executors. After consensus, compile team-graph.json, team-runtime-tasks.json, team-decomposition-report.json, and team-inbox/ so worker handoff uses concrete runtime task ids with role/path/domain/lane hints. Refresh/validate TriWiki before debate, implementation, review, and final; consume attention.use_first and hydrate attention.hydrate_first before risky decisions. Log events and use sks team message for bounded inter-agent communication in transcript/lane panes. Color-coded Warp lanes distinguish overview/scout/planning/execution/review/safety sessions. End with cleanup-warp or a cleanup event so follow panes show cleanup and stop; pass team-session-cleanup.json, then reflection and Honest Mode. Parent integrates/verifies.\n\n${chatCaptureIntakeText()}\n`,
535
535
  'from-chat-img': `---\nname: from-chat-img\ndescription: Explicit $From-Chat-IMG Team alias for chat screenshot plus attachment analysis.\n---\n\nUse only for From-Chat-IMG/$From-Chat-IMG. It enters the normal Team pipeline. Treat uploads as chat screenshot plus originals. Use Codex Computer Use visual inspection when available, list requirements first, match regions to attachments with confidence, write ${FROM_CHAT_IMG_COVERAGE_ARTIFACT}, ${FROM_CHAT_IMG_CHECKLIST_ARTIFACT}, ${FROM_CHAT_IMG_TEMP_TRIWIKI_ARTIFACT}, and ${FROM_CHAT_IMG_QA_LOOP_ARTIFACT}, then continue Team gates, review, reflection, and Honest Mode. ${CODEX_COMPUTER_USE_ONLY_POLICY} The ledger must account for every visible customer request, screenshot image region, and separate attachment; ${FROM_CHAT_IMG_CHECKLIST_ARTIFACT} must have a checked item for each request, image-region/attachment match, work item, scoped QA-LOOP, and verification step; ${FROM_CHAT_IMG_TEMP_TRIWIKI_ARTIFACT} stores temporary TriWiki-backed session context with expires_after_sessions=${FROM_CHAT_IMG_TEMP_TRIWIKI_SESSIONS}. ${FROM_CHAT_IMG_QA_LOOP_ARTIFACT} must prove QA-LOOP ran over the exact customer-request work-order range after implementation, with every work item covered, post-fix verification complete, and zero unresolved findings. team-gate.json cannot pass From-Chat-IMG completion until unresolved_items is empty, every checklist box is checked, and scoped_qa_loop_completed=true.\n`,
536
536
  'qa-loop': `---\nname: qa-loop\ndescription: $QA-LOOP dogfoods UI/API as human proxy with safety gates, Codex Computer Use-only UI evidence, safe fixes, rechecks, and a QA report.\n---\n\nUse only $QA-LOOP. Ask scope, target, mutation, login. Credentials are runtime-only; never save secrets. UI-level E2E needs Codex Computer Use evidence or must be marked unverified; Chrome MCP, Browser Use, Playwright, Selenium, Puppeteer, and other browser automation do not satisfy UI/browser verification. Deployed targets are read-only; destructive removal is forbidden. After answer/run, dogfood real flows, apply safe contract-allowed code/test/docs fixes, recheck, and do not pass qa-gate.json with unresolved findings or without post_fix_verification_complete. Finish qa-ledger, date/version report, gate, completion summary, and Honest Mode.\n`,
537
- 'goal': `---\nname: goal\ndescription: Dollar-command route for $Goal or $goal Codex native persisted /goal workflows.\n---\n\nUse when the user invokes $Goal/$goal or asks to persist a workflow with Codex native /goal continuation. Prepare with sks goal create or the $Goal route, then use native Codex /goal create, pause, resume, and clear controls where available. Do not recreate the old no-question loop.\n`,
537
+ 'computer-use': `---\nname: computer-use\ndescription: Maximum-speed $Computer-Use/$CU lane for Codex Computer Use UI/browser/visual tasks.\n---\n\nUse only when the user invokes $Computer-Use/$CU or asks for a Computer Use-specific fast lane. Skip Team debate, QA-LOOP clarification, upfront TriWiki refresh, Context7, subagents, and reflection unless explicitly requested. Infer the smallest target, use Codex Computer Use directly, and never substitute Playwright, Chrome MCP, Browser Use, Selenium, Puppeteer, or other browser automation for UI/browser evidence. If Computer Use is unavailable, mark UI/browser evidence unverified and stop with the blocker. At the end only, refresh or pack TriWiki, validate it, then provide a concise completion summary plus Honest Mode.\n`,
538
+ 'computer-use-fast': `---\nname: computer-use-fast\ndescription: Alias for the maximum-speed $Computer-Use/$CU Codex Computer Use lane.\n---\n\nUse the same rules as computer-use: skip Team debate, QA-LOOP clarification, upfront TriWiki refresh, Context7, subagents, and reflection unless explicitly requested. Use Codex Computer Use directly; never substitute Playwright, Chrome MCP, Browser Use, Selenium, Puppeteer, or other browser automation for UI/browser evidence. At the end only, refresh/pack TriWiki, validate it, then provide a concise completion summary plus Honest Mode.\n`,
539
+ 'cu': `---\nname: cu\ndescription: Short alias for the maximum-speed $Computer-Use Codex Computer Use lane.\n---\n\nUse the same rules as computer-use. This is a speed lane for focused UI/browser/visual tasks that require Codex Computer Use evidence, with TriWiki refresh/validate and Honest Mode deferred to final closeout.\n`,
540
+ 'goal': `---\nname: goal\ndescription: Fast $Goal/$goal bridge overlay for Codex native persisted /goal workflows.\n---\n\nUse when the user invokes $Goal/$goal or asks to persist a workflow with Codex native /goal continuation. Prepare with sks goal create or the $Goal route, write only the lightweight bridge artifacts, then use native Codex /goal create, pause, resume, and clear controls where available. Goal does not replace Team, QA, DB, or other SKS execution routes; continue implementation through the selected route and use Context7 only when external API/library docs are involved. Do not recreate the old no-question loop.\n`,
538
541
  'research': `---\nname: research\ndescription: Dollar-command route for $Research or $research frontier discovery workflows.\n---\n\nUse when the user invokes $Research/$research or asks for research, hypotheses, new mechanisms, falsification, or testable predictions. Prefer sks research prepare and sks research run. Do not use for ordinary code edits.\n`,
539
542
  'autoresearch': `---\nname: autoresearch\ndescription: Dollar-command route for $AutoResearch or $autoresearch iterative experiment loops.\n---\n\nUse for $AutoResearch, iterative improvement, SEO/GEO, ranking, workflow, benchmark, or experiments. Define program, hypothesis, experiment, metric, keep/discard, falsification, next step, and Honest Mode. Load seo-geo-optimizer for README/npm/GitHub/schema/AI-search work.\n`,
540
543
  'db': `---\nname: db\ndescription: Dollar-command route for $DB or $db database and Supabase safety checks.\n---\n\nUse when the user invokes $DB/$db or the task touches SQL, Supabase, Postgres, migrations, Prisma, Drizzle, Knex, MCP database tools, or production data. Run or follow sks db policy, sks db scan, sks db classify, and sks db check. Destructive database operations remain forbidden.\n`,
@@ -579,7 +582,7 @@ export async function installSkills(root) {
579
582
  }
580
583
 
581
584
  function enrichSkillContent(name, content) {
582
- if (!['sks', 'answer', 'wiki', 'team', 'qa-loop', 'goal', 'research', 'autoresearch', 'db', 'gx', 'reflection', 'prompt-pipeline', 'pipeline-runner', 'context7-docs', 'turbo-context-pack', 'hproof-evidence-bind'].includes(name)) return content;
585
+ if (!['sks', 'answer', 'wiki', 'team', 'qa-loop', 'computer-use', 'computer-use-fast', 'cu', 'goal', 'research', 'autoresearch', 'db', 'gx', 'reflection', 'prompt-pipeline', 'pipeline-runner', 'context7-docs', 'turbo-context-pack', 'hproof-evidence-bind'].includes(name)) return content;
583
586
  const text = String(content || '').trimEnd();
584
587
  if (text.includes('TriWiki context-tracking SSOT')) return text;
585
588
  return `${text}
@@ -594,7 +597,9 @@ Context tracking:
594
597
  }
595
598
 
596
599
  async function writeSkillMetadata(dir, name) {
597
- const effort = ['research', 'autoresearch', 'research-discovery', 'autoresearch-loop', 'from-chat-img'].includes(name)
600
+ const effort = ['computer-use', 'computer-use-fast', 'cu'].includes(name)
601
+ ? 'low'
602
+ : ['research', 'autoresearch', 'research-discovery', 'autoresearch-loop', 'from-chat-img'].includes(name)
598
603
  ? 'xhigh'
599
604
  : (['dfix', 'sks', 'help'].includes(name) ? 'medium' : 'high');
600
605
  await ensureDir(path.join(dir, 'agents'));
@@ -36,6 +36,7 @@ export function promptPipelineContext(prompt, route = routePrompt(prompt)) {
36
36
  const fastDesign = route?.id === 'DFix';
37
37
  if (fastDesign) return dfixQuickContext(prompt, route);
38
38
  if (route?.id === 'Answer') return answerOnlyContext(prompt, route);
39
+ if (route?.id === 'ComputerUse') return computerUseFastContext(prompt, route);
39
40
  const lines = [
40
41
  `SKS skill-first pipeline active. Route: ${route?.command || '$SKS'} (${route?.route || 'general SKS workflow'}).`,
41
42
  reasoningInstruction(reasoning),
@@ -81,7 +82,7 @@ export function dfixQuickContext(prompt, route = routePrompt(prompt)) {
81
82
  '2. Inspect only the files needed to locate that target.',
82
83
  '3. Apply only the listed design/content edit; for UI/UX micro-edits read design.md when present, and use imagegen for any image/logo/raster asset.',
83
84
  '4. Run only cheap verification when useful, such as syntax check, focused test, or local render smoke.',
84
- '5. Final response: one short completion summary explaining what changed, plus verification or the exact blocker.'
85
+ '5. Final response: one short DFix completion summary explaining what changed, plus cheap verification or the exact blocker. Do not enter repeated full-route Honest Mode loops.'
85
86
  ].join('\n');
86
87
  }
87
88
 
@@ -111,6 +112,7 @@ export async function prepareRoute(root, prompt, state = {}) {
111
112
  if (!route) return { route: null, additionalContext: promptPipelineContext(prompt, null) };
112
113
  if (route.id === 'DFix') return prepareDfixQuickRoute(route, task);
113
114
  if (route.id === 'Answer') return prepareAnswerOnlyRoute(route, task);
115
+ if (route.id === 'ComputerUse') return prepareComputerUseFastRoute(route, task);
114
116
  if (route.id === 'Wiki') return prepareWikiQuickRoute(route, task);
115
117
  if (route.id === 'Goal') return prepareGoal(root, route, task, routeNeedsContext7(route, prompt));
116
118
  const required = routeNeedsContext7(route, prompt);
@@ -143,6 +145,30 @@ async function prepareAnswerOnlyRoute(route, task) {
143
145
  };
144
146
  }
145
147
 
148
+ async function prepareComputerUseFastRoute(route, task) {
149
+ return {
150
+ route,
151
+ additionalContext: computerUseFastContext(task, route)
152
+ };
153
+ }
154
+
155
+ export function computerUseFastContext(prompt, route = routePrompt(prompt)) {
156
+ const task = stripDollarCommand(prompt) || String(prompt || '').trim();
157
+ return [
158
+ `Computer Use fast lane active. Route: ${route?.command || '$Computer-Use'} (${route?.route || 'Computer Use fast lane'}).`,
159
+ 'Speed contract: do not enter Team, QA-LOOP clarification, repeated upfront TriWiki refresh, Context7, subagent orchestration, debate, reflection, or broad planning unless the user explicitly requests that heavier route.',
160
+ `Task: ${task}`,
161
+ 'Execution order:',
162
+ '1. Infer the smallest UI/browser/visual target and acceptance from the prompt and current app context.',
163
+ '2. Use Codex Computer Use directly for the focused screen/browser action or inspection. Do not substitute Playwright, Chrome MCP, Browser Use, Selenium, Puppeteer, or other browser automation for UI/browser evidence.',
164
+ '3. If Computer Use is unavailable, mark UI/browser evidence unverified and stop with the exact blocker instead of switching tools.',
165
+ '4. Apply only safe, directly requested fixes when the prompt asks for correction; otherwise report observed evidence only.',
166
+ '5. At the end only, run `sks wiki refresh` or `sks wiki pack`, then `sks wiki validate .sneakoscope/wiki/context-pack.json` when the repo/runtime is available.',
167
+ '6. Final response must include a short completion summary plus SKS Honest Mode: evidence used, tests/checks run, and any unverified UI/browser claims.',
168
+ CODEX_COMPUTER_USE_ONLY_POLICY
169
+ ].join('\n');
170
+ }
171
+
146
172
  async function prepareWikiQuickRoute(route, task) {
147
173
  return {
148
174
  route,
@@ -187,8 +213,27 @@ export async function activeRouteContext(root, state) {
187
213
  async function prepareGoal(root, route, task, required) {
188
214
  const { id, dir, mission } = await createMission(root, { mode: 'goal', prompt: task });
189
215
  const workflow = await writeGoalWorkflow(dir, mission, { action: 'create', prompt: task });
190
- await writeJsonAtomic(path.join(dir, 'route-context.json'), { route: route.id, command: route.command, mode: route.mode, task, required_skills: route.requiredSkills, context7_required: required, native_goal: workflow.native_goal, stop_gate: 'honest_mode' });
191
- await setCurrent(root, routeState(id, route, 'GOAL_READY', required, { prompt: task, native_goal: workflow.native_goal, stop_gate: 'honest_mode', implementation_allowed: true, questions_allowed: true }));
216
+ await writeJsonAtomic(path.join(dir, 'route-context.json'), { route: route.id, command: route.command, mode: route.mode, task, required_skills: route.requiredSkills, context7_required: required, native_goal: workflow.native_goal, stop_gate: route.stopGate });
217
+ const executionRoute = routePrompt(task);
218
+ const shouldDelegateExecution = routeRequiresSubagents(route, task)
219
+ && executionRoute
220
+ && !['Answer', 'DFix', 'Goal', 'Help'].includes(executionRoute.id);
221
+ if (shouldDelegateExecution) {
222
+ await appendJsonl(path.join(dir, 'events.jsonl'), { ts: nowIso(), type: 'goal.delegated_execution_route', route: executionRoute.id, command: executionRoute.command });
223
+ const delegated = await prepareRoute(root, task, {});
224
+ return {
225
+ route,
226
+ additionalContext: [
227
+ `$Goal bridge prepared as a lightweight native /goal persistence overlay.
228
+ Goal bridge mission: ${id}
229
+ Goal artifact: .sneakoscope/missions/${id}/${GOAL_WORKFLOW_ARTIFACT}
230
+ Native Codex control: ${workflow.native_goal.slash_command}
231
+ Delegated execution route: ${executionRoute.command}. The delegated route mission is authoritative for implementation, verification, and final gates.`,
232
+ delegated.additionalContext
233
+ ].filter(Boolean).join('\n\n')
234
+ };
235
+ }
236
+ await setCurrent(root, routeState(id, route, 'GOAL_READY', required, { prompt: task, native_goal: workflow.native_goal, stop_gate: route.stopGate, implementation_allowed: true, questions_allowed: true }));
192
237
  return routeContext(route, id, task, required, `Use Codex native ${workflow.native_goal.slash_command} control for persisted continuation, then continue the relevant SKS route gates for any implementation work.`);
193
238
  }
194
239
 
@@ -45,6 +45,8 @@ export const RECOMMENDED_SKILLS = [
45
45
  'design-system-builder',
46
46
  'design-ui-editor',
47
47
  'imagegen',
48
+ 'computer-use',
49
+ 'computer-use-fast',
48
50
  'db-safety-guard',
49
51
  REFLECTION_SKILL_NAME,
50
52
  'honest-mode'
@@ -215,17 +217,33 @@ export const ROUTES = [
215
217
  cliEntrypoint: 'sks qa-loop prepare|answer|run|status',
216
218
  examples: ['$QA-LOOP dogfood UI and API against local dev', '$QA-LOOP deployed smoke only']
217
219
  },
220
+ {
221
+ id: 'ComputerUse',
222
+ command: '$Computer-Use',
223
+ mode: 'COMPUTER_USE',
224
+ route: 'Computer Use fast lane',
225
+ description: 'Maximum-speed Codex Computer Use lane for UI/browser/visual tasks: skip Team debate and upfront TriWiki loops, run only focused Computer Use steps, then finish with evidence, TriWiki refresh/validate, and Honest Mode.',
226
+ requiredSkills: ['computer-use', 'honest-mode'],
227
+ dollarAliases: ['$CU'],
228
+ appSkillAliases: ['computer-use-fast', 'cu'],
229
+ lifecycle: ['fast_intake', 'focused_computer_use_steps', 'evidence_summary', 'final_triwiki_refresh_validate', 'honest_mode'],
230
+ context7Policy: 'optional',
231
+ reasoningPolicy: 'low',
232
+ stopGate: 'none',
233
+ cliEntrypoint: 'Codex App prompt route only: $Computer-Use <target/task>',
234
+ examples: ['$Computer-Use check the local UI as fast as possible', '$CU localhost screen smoke']
235
+ },
218
236
  {
219
237
  id: 'Goal',
220
238
  command: '$Goal',
221
239
  mode: 'GOAL',
222
- route: 'native Codex goal workflow',
223
- description: 'Bridge SKS pipeline work into Codex native persisted /goal workflows for create, pause, resume, and clear.',
224
- requiredSkills: ['goal', 'pipeline-runner', 'context7-docs', REFLECTION_SKILL_NAME, 'honest-mode'],
225
- lifecycle: ['goal_workflow_artifact', 'native_goal_create_or_control', 'runtime_continuation', 'post_route_reflection', 'honest_mode'],
226
- context7Policy: 'required',
227
- reasoningPolicy: 'high',
228
- stopGate: 'honest_mode',
240
+ route: 'native /goal persistence bridge',
241
+ description: 'Fast overlay that records a bridge artifact for Codex native persisted /goal create, pause, resume, and clear controls; implementation continues through the selected SKS execution route.',
242
+ requiredSkills: ['goal', 'honest-mode'],
243
+ lifecycle: ['goal_bridge_artifact', 'native_goal_create_or_control', 'selected_sks_route_continuation', 'honest_mode'],
244
+ context7Policy: 'if_external_docs',
245
+ reasoningPolicy: 'medium',
246
+ stopGate: 'none',
229
247
  cliEntrypoint: 'sks goal create|pause|resume|clear|status',
230
248
  examples: ['$Goal persist this migration workflow with native /goal continuation']
231
249
  },
@@ -371,7 +389,7 @@ export const COMMAND_CATALOG = [
371
389
  { name: 'doctor', usage: 'sks doctor [--fix] [--local-only] [--json] [--install-scope global|project]', description: 'Check and repair SKS generated files, while blocking setup if another Codex harness is detected.' },
372
390
  { name: 'init', usage: 'sks init [--force] [--local-only] [--install-scope global|project]', description: 'Initialize the local SKS control surface.' },
373
391
  { name: 'selftest', usage: 'sks selftest [--mock]', description: 'Run local smoke tests without calling a model.' },
374
- { name: 'goal', usage: 'sks goal create|pause|resume|clear|status ...', description: 'Prepare and control SKS bridge artifacts for Codex native persisted /goal workflows.' },
392
+ { name: 'goal', usage: 'sks goal create|pause|resume|clear|status ...', description: 'Prepare and control the fast SKS bridge overlay for Codex native persisted /goal workflows.' },
375
393
  { name: 'research', usage: 'sks research prepare|run|status ...', description: 'Run frontier-style research missions with novelty and falsification gates.' },
376
394
  { name: 'db', usage: 'sks db policy|scan|mcp-config|classify|check ...', description: 'Inspect and enforce database/Supabase safety policy.' },
377
395
  { name: 'eval', usage: 'sks eval run|compare|thresholds ...', description: 'Run deterministic context-quality and performance evidence checks.' },
@@ -455,6 +473,7 @@ export function routePrompt(prompt) {
455
473
  return route;
456
474
  }
457
475
  if (hasFromChatImgSignal(text)) return routeById('Team');
476
+ if (looksLikeComputerUseFastLane(text)) return routeById('ComputerUse');
458
477
  if (looksLikeFastDesignFix(text)) return routeById('DFix');
459
478
  if (looksLikeQuestionShapedDirective(text)) return routeById('Team');
460
479
  if (looksLikeAnswerOnlyRequest(text)) return routeById('Answer');
@@ -464,12 +483,19 @@ export function routePrompt(prompt) {
464
483
  if (/\b(qa[-\s]?loop|qaloop|e2e\s+qa|qa\s+e2e)\b/i.test(text)) return routeById('QALoop');
465
484
  if (/\b(autoresearch|experiment|benchmark|SEO|GEO|ranking|optimi[sz]e|improve metric|discoverability|visibility|github stars?|npm downloads?|검색|노출|스타|다운로드)\b/i.test(text)) return routeById('AutoResearch');
466
485
  if (/\b(research|hypothesis|falsify|novelty|frontier|조사|연구)\b/i.test(text)) return routeById('Research');
467
- if (/(wiki\s+(refresh|pack|validate|prune)|triwiki\s+(refresh|pack|validate)|위키\s*(갱신|리프레시|정리|검증|패킹)|트라이위키|triwiki)/i.test(text)) return routeById('Wiki');
486
+ if (/(wiki\s+(refresh|pack|validate|prune)|triwiki\s+(refresh|pack|validate)|위키\s*(갱신|리프레시|정리|검증|패킹)|트라이위키|triwiki)/i.test(text) && !looksLikeDirectWorkRequest(text)) return routeById('Wiki');
468
487
  if (/\b(GX|vgraph|visual context|render cartridge|wiki coordinate|rgba|trig|llm wiki)\b/i.test(text)) return routeById('GX');
469
488
  if (looksLikeTeamDefaultWork(text)) return routeById('Team');
470
489
  return routeById('SKS');
471
490
  }
472
491
 
492
+ export function looksLikeComputerUseFastLane(prompt = '') {
493
+ const text = String(prompt || '');
494
+ const computerUseCue = /\b(computer\s*use|codex\s+computer\s+use|computer-use)\b|컴퓨터\s*유즈|컴퓨터\s*사용|컴퓨터유즈/i.test(text);
495
+ if (!computerUseCue) return false;
496
+ return /\b(ui|browser|visual|screen|screenshot|e2e|qa|dogfood|fast|lane|pipeline|localhost|web|app|page)\b|화면|브라우저|시각|스크린|캡처|검증|빠른|고속|파이프라인|작업|속도/i.test(text);
497
+ }
498
+
473
499
  export function looksLikeTeamDefaultWork(prompt = '') {
474
500
  const text = String(prompt || '').trim();
475
501
  if (!text) return false;
@@ -515,16 +541,17 @@ export function routeRequiresSubagents(route, prompt = '') {
515
541
  if (!route) return false;
516
542
  if (route.id === 'Team') return true;
517
543
  if (route.id === 'SKS') return looksLikeTeamDefaultWork(prompt);
518
- if (route.id === 'Help' || route.id === 'Answer' || route.id === 'Wiki') return false;
544
+ if (route.id === 'Help' || route.id === 'Answer' || route.id === 'Wiki' || route.id === 'ComputerUse') return false;
519
545
  if (route.id === 'Research' || route.id === 'AutoResearch') return true;
520
- if (route.id === 'Goal' || route.id === 'DB' || route.id === 'GX') return looksLikeExecutionWork(prompt);
546
+ if (route.id === 'Goal') return looksLikeExecutionWork(prompt) || looksLikeTeamDefaultWork(stripDollarCommand(prompt));
547
+ if (route.id === 'DB' || route.id === 'GX') return looksLikeExecutionWork(prompt);
521
548
  if (route.id === 'DFix') return looksLikeCodeChangingWork(prompt) && !looksLikeFastDesignFix(prompt);
522
549
  return looksLikeExecutionWork(prompt);
523
550
  }
524
551
 
525
552
  export function reflectionRequiredForRoute(route) {
526
553
  const id = String(route?.id || route?.mode || route?.route || route || '').replace(/^\$/, '');
527
- return /^(team|qaloop|qa-loop|goal|research|autoresearch|db|database|madsks|mad-sks|gx)$/i.test(id);
554
+ return /^(team|qaloop|qa-loop|research|autoresearch|db|database|madsks|mad-sks|gx)$/i.test(id);
528
555
  }
529
556
 
530
557
  export function looksLikeCodeChangingWork(prompt = '') {
@@ -539,6 +566,14 @@ export function looksLikeExecutionWork(prompt = '') {
539
566
 
540
567
  export function subagentExecutionPolicyText(route, prompt = '') {
541
568
  const required = routeRequiresSubagents(route, prompt);
569
+ if (route?.id === 'Goal') {
570
+ if (!required) return 'Subagent policy: Goal itself is a lightweight native /goal persistence overlay; subagents are not required for bridge creation/control.';
571
+ return [
572
+ 'Subagent policy: Goal itself remains a lightweight native /goal persistence overlay.',
573
+ 'Because the prompt also asks for code-changing or execution work, continue that work through the selected SKS execution route and apply that route\'s worker/reviewer policy there.',
574
+ noUnrequestedFallbackCodePolicyText()
575
+ ].join(' ');
576
+ }
542
577
  if (!required) {
543
578
  return 'Subagent policy: optional for this route; use subagents only when parallel exploration materially helps.';
544
579
  }