@jstn-sdk/rcs 0.1.0 → 0.1.6

package/package.json

@@ -1,14 +1,14 @@
 {
   "name": "@jstn-sdk/rcs",
-  "version": "0.1.0",
-  "description": "Roblox Creator Skills runtime and workflow layer for Codex CLI",
+  "version": "0.1.6",
+  "description": "Roblox Creator Skills toolkit and workflow layer for Codex CLI",
   "type": "module",
   "main": "dist/index.js",
   "bin": {
     "rcs": "dist/cli/rcs.js"
   },
   "scripts": {
-    "build": "tsc && node -e \"require('fs').chmodSync('dist/cli/rcs.js', 0o755)\"",
+    "build": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\" && tsc && node -e \"require('fs').chmodSync('dist/cli/rcs.js', 0o755)\"",
     "build:explore": "cargo build -p rcs-explore-harness",
     "build:full": "npm run build && npm run build:explore:release && npm run build:sparkshell",
     "build:explore:release": "node dist/scripts/build-explore-harness.js",
@@ -16,7 +16,7 @@
     "clean:native-package-assets": "node dist/scripts/cleanup-explore-harness.js",
     "dev": "tsc --watch",
     "lint": "biome lint src",
-    "prepack": "npm run build && npm run verify:native-agents && npm run sync:plugin && npm run verify:plugin-bundle && npm run clean:native-package-assets",
+    "prepack": "npm run build && npm run verify:native-agents && npm run sync:plugin && npm run verify:plugin-bundle && npm run surface:map:check && npm run clean:native-package-assets",
     "postinstall": "node src/scripts/postinstall-bootstrap.js",
     "setup": "node dist/cli/rcs.js setup",
     "doctor": "node dist/cli/rcs.js doctor",
@@ -32,16 +32,16 @@
     "test:plugin-boundaries:compiled": "node --test dist/cli/__tests__/codex-plugin-layout.test.js dist/cli/__tests__/package-bin-contract.test.js dist/cli/__tests__/setup-hooks-shared-ownership.test.js dist/catalog/__tests__/plugin-bundle-ssot.test.js",
     "test:node": "node dist/scripts/run-test-files.js dist",
     "test:node:cross-platform": "npm run test:node",
-    "test": "npm run build && npm run verify:native-agents && npm run verify:plugin-bundle && npm run test:node && node dist/scripts/generate-catalog-docs.js --check",
-    "test:ci:compiled": "npm run verify:native-agents && npm run verify:plugin-bundle && npm run test:node && node dist/scripts/generate-catalog-docs.js --check",
+    "test": "npm run build && npm run verify:native-agents && npm run verify:plugin-bundle && npm run test:node && node dist/scripts/generate-catalog-docs.js --check && npm run surface:map:check",
+    "test:ci:compiled": "npm run verify:native-agents && npm run verify:plugin-bundle && npm run test:node && node dist/scripts/generate-catalog-docs.js --check && npm run surface:map:check",
     "coverage:team-critical": "npm run build && c8 --all --src dist/team --src dist/state --include 'dist/team/**/*.js' --include 'dist/state/**/*.js' --exclude '**/__tests__/**' --reporter=text-summary --reporter=lcov --reporter=json-summary --report-dir coverage/team --check-coverage --lines=78 --functions=90 --branches=70 --statements=78 node dist/scripts/run-test-files.js dist/team/__tests__ dist/state/__tests__",
     "coverage:team-critical:compiled": "c8 --all --src dist/team --src dist/state --include 'dist/team/**/*.js' --include 'dist/state/**/*.js' --exclude '**/__tests__/**' --reporter=text-summary --reporter=lcov --reporter=json-summary --report-dir coverage/team --check-coverage --lines=78 --functions=90 --branches=70 --statements=78 node dist/scripts/run-test-files.js dist/team/__tests__ dist/state/__tests__",
     "coverage:team-critical:cross-platform": "npm run build && c8 --all --src dist/team --src dist/state --include 'dist/team/**/*.js' --include 'dist/state/**/*.js' --exclude '**/__tests__/**' --reporter=text-summary --reporter=lcov --reporter=json-summary --report-dir coverage/team --check-coverage --lines=78 --functions=90 --branches=70 --statements=78 node dist/scripts/run-test-files.js dist/team/__tests__ dist/state/__tests__",
     "coverage:ts:full": "npm run build && c8 --all --src dist --exclude '**/__tests__/**' --exclude 'dist/bin/**' --exclude 'dist/**/*.d.ts' --reporter=text-summary --reporter=lcov --reporter=json-summary --report-dir coverage/ts-full node dist/scripts/run-test-files.js dist",
     "coverage:ts:full:compiled": "c8 --all --src dist --exclude '**/__tests__/**' --exclude 'dist/bin/**' --exclude 'dist/**/*.d.ts' --reporter=text-summary --reporter=lcov --reporter=json-summary --report-dir coverage/ts-full node dist/scripts/run-test-files.js dist",
     "coverage:ts:full:cross-platform": "npm run build && c8 --all --src dist --exclude '**/__tests__/**' --exclude 'dist/bin/**' --exclude 'dist/**/*.d.ts' --reporter=text-summary --reporter=lcov --reporter=json-summary --report-dir coverage/ts-full node dist/scripts/run-test-files.js dist",
-    "test:ralph-persistence:compiled": "node --test dist/cli/__tests__/session-scoped-runtime.test.js dist/mcp/__tests__/trace-server.test.js dist/hud/__tests__/state.test.js dist/mcp/__tests__/state-server-ralph-phase.test.js dist/ralph/__tests__/persistence.test.js dist/verification/__tests__/ralph-persistence-gate.test.js",
-    "test:explicit-terminal-contract:compiled": "node --test dist/runtime/__tests__/run-outcome.test.js dist/mcp/__tests__/state-server.test.js dist/hooks/__tests__/notify-fallback-watcher.test.js dist/hooks/__tests__/notify-hook-ralph-resume.test.js dist/scripts/__tests__/codex-native-hook.test.js",
+    "test:forge-persistence:compiled": "node --test dist/cli/__tests__/session-scoped-runtime.test.js dist/mcp/__tests__/trace-server.test.js dist/hud/__tests__/state.test.js dist/mcp/__tests__/state-server-forge-phase.test.js dist/forge/__tests__/persistence.test.js dist/verification/__tests__/forge-persistence-gate.test.js",
+    "test:explicit-terminal-contract:compiled": "node --test dist/runtime/__tests__/run-outcome.test.js dist/mcp/__tests__/state-server.test.js dist/hooks/__tests__/notify-fallback-watcher.test.js dist/hooks/__tests__/notify-hook-forge-resume.test.js dist/scripts/__tests__/codex-native-hook.test.js",
     "test:compat:node": "npm run build && node dist/scripts/run-test-files.js dist/compat/__tests__",
     "test:compat:node:cross-platform": "npm run build && node dist/scripts/run-test-files.js dist/compat/__tests__",
     "test:compat:rust": "cargo build && RCS_COMPAT_TARGET=./target/debug/rcs npm run test:compat:node",
@@ -54,7 +54,9 @@
     "sync:plugin:check": "node dist/scripts/sync-plugin-mirror.js --check",
     "verify:plugin-bundle": "node dist/scripts/sync-plugin-mirror.js --check",
     "verify:native-agents": "node dist/scripts/verify-native-agents.js",
-    "prompt:inventory": "node dist/scripts/prompt-inventory.js"
+    "prompt:inventory": "node dist/scripts/prompt-inventory.js",
+    "surface:map": "node dist/scripts/surface-taxonomy.js",
+    "surface:map:check": "node dist/scripts/surface-taxonomy.js --check"
   },
   "engines": {
     "node": ">=20"
@@ -63,22 +65,24 @@
     "Cargo.toml",
     "Cargo.lock",
     "dist/",
+    "!dist/**/__tests__/**",
     "crates/",
     "docs/",
     "skills/",
     "prompts/",
     "templates/",
+    "!templates/roblox-scripts/**",
     "src/scripts/",
     "plugins/",
     ".agents/plugins/marketplace.json"
   ],
   "keywords": [
+    "roblox",
+    "luau",
+    "creator-tools",
     "codex",
     "openai",
-    "cli",
-    "agents",
-    "orchestration",
-    "multi-agent"
+    "cli"
   ],
   "author": "JustineDevs",
   "repository": {
@@ -89,6 +93,9 @@
   "bugs": {
     "url": "https://github.com/JustineDevs/roblox-ai-os/issues"
   },
+  "publishConfig": {
+    "access": "public"
+  },
   "license": "MIT",
   "dependencies": {
     "@iarna/toml": "^2.2.5",

package/plugins/roblox-ai-os-creator-skills/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "roblox-ai-os-creator-skills",
-  "version": "0.1.0",
+  "version": "0.1.6",
   "description": "Roblox Creator Skills workflow and runtime bundle for Codex CLI",
   "author": {
     "name": "JustineDevs",

package/plugins/roblox-ai-os-creator-skills/docs/reference/roblox-pre-action-protocol.md

@@ -77,6 +77,10 @@ Before implementation, answer:
 - what assumptions are unsafe
 - what must be verified before code generation
 
+Canonical terminology must align with:
+- `docs/reference/canonical-vocabulary.md`
+- `docs/reference/semantic-design-system.md`
+
 ## Phase 3: Architecture First
 
 Before code, produce:

package/plugins/roblox-ai-os-creator-skills/skills/ai-slop-cleaner/SKILL.md

@@ -1,6 +1,10 @@
 ---
 name: ai-slop-cleaner
 description: Run an anti-slop cleanup/refactor/deslop workflow
+surface-class: "operator"
+domain: "creator-runtime"
+audience: "operator"
+artifact-type: "skill"
 ---
 
 # AI Slop Cleaner Skill
@@ -22,11 +26,11 @@ Use this skill when:
 - Keep using inspection, tests, diagnostics, and verification until the cleanup is grounded.
 - Proceed automatically through clear, reversible cleanup steps; ask only when a choice materially changes scope or behavior.
 
-## Scoped File Lists and Ralph Workflow
+## Scoped File Lists and Forge Workflow
 
 - This skill can accept a **file list scope** instead of a whole feature area.
-- When the caller provides a changed-files list (for example, Ralph session-owned edits), keep the cleanup strictly bounded to those files.
-- In the **Ralph workflow**, the mandatory deslop pass should run this skill on Ralph's changed files only, in standard mode unless the caller explicitly requests otherwise.
+- When the caller provides a changed-files list (for example, Forge session-owned edits), keep the cleanup strictly bounded to those files.
+- In the **Forge workflow**, the mandatory deslop pass should run this skill on Forge's changed files only, in standard mode unless the caller explicitly requests otherwise.
 
 ## Procedure
 
@@ -50,8 +54,8 @@ Use this skill when:
      - **Masking fallback slop** — hides errors or evidence, bypasses the primary contract, suppresses tests or validation, swallows failures, silently defaults, or adds untested alternate paths
      - **Grounded compatibility/fail-safe fallback** — is scoped to an external/version/fail-safe boundary, documents the rationale, preserves failure evidence, and has regression tests for both the primary and fallback behavior
    - Prefer root-cause repair, deletion, boundary repair, or explicit failure behavior before preserving fallback paths
-   - For broad, ambiguous, cross-layer, or architectural fallback-like code, invoke `$ralplan` for consensus resolution before edits
-   - Recursion guard: when already inside ralplan, ralph, team, or another RCS workflow, do not spawn a nested `$ralplan`; record the finding and attach it to the active ralplan, leader, or plan handoff instead
+   - For broad, ambiguous, cross-layer, or architectural fallback-like code, invoke `$blueprint` for consensus resolution before edits
+   - Recursion guard: when already inside blueprint, forge, team, or another RCS workflow, do not spawn a nested `$blueprint`; record the finding and attach it to the active blueprint, leader, or plan handoff instead
 
 4. **Categorize issues before editing**
    - **Fallback-like code** — masking fallbacks, workaround branches, bypasses, swallowed errors, silent defaults, broad shims, alternate execution paths
@@ -99,7 +103,7 @@ Cleanup Plan: [bounded smells and order]
 Fallback Findings: [none, or finding -> masking fallback slop / grounded compatibility/fail-safe fallback -> escalation status]
 
 Passes Completed:
-- Fallback-like code resolution gate - [root-cause repair, explicit failure behavior, preserved grounded fallback, or ralplan handoff]
+- Fallback-like code resolution gate - [root-cause repair, explicit failure behavior, preserved grounded fallback, or blueprint handoff]
 1. Pass 1: Dead code deletion - [concise fix]
 2. Pass 2: Duplicate removal - [concise fix]
 3. Pass 3: Naming/error handling cleanup - [concise fix]
@@ -118,7 +122,7 @@ Changed Files:
 Fallback Review:
 - Findings: [fallback-like findings detected]
 - Classification: [masking fallback slop | grounded fallback]
-- Escalation Status: [none | raised to leader/ralplan | no escalation]
+- Escalation Status: [none | raised to leader/blueprint | no escalation]
 
 Remaining Risks:
 - [none or short deferred item]
@@ -137,3 +141,6 @@ Remaining Risks:
 **Bad:** Keep a `fallback if it fails` branch that silently defaults after a swallowed error instead of fixing the root cause or making failure explicit.
 
 **Good:** A version-specific compatibility shim is narrow, documented, preserves error evidence, has primary and fallback regression tests, and is reported as a grounded compatibility/fail-safe fallback.
+surface-class: "operator"
+domain: "creator-runtime"
+audience: "operator"

package/plugins/roblox-ai-os-creator-skills/skills/analyze/SKILL.md

@@ -1,6 +1,10 @@
 ---
 name: analyze
 description: "Run read-only deep repository analysis and return a ranked synthesis with explicit confidence, concrete file references, and clear evidence-vs-inference boundaries. Use when a user says 'analyze', 'investigate', 'why does', 'what's causing', or needs grounded cross-file explanation before any changes are proposed."
+surface-class: "operator"
+domain: "creator-runtime"
+audience: "operator"
+artifact-type: "skill"
 ---
 
 # Analyze — Read-Only Deep Analysis
@@ -25,7 +29,7 @@ Examples:
 ## Do not use `$analyze` when
 
 - the user explicitly wants code edits, a fix, or execution — use the appropriate implementation lane instead
-- the user wants a new product plan or acceptance criteria — use `$plan` / `$ralplan`
+- the user wants a new product plan or acceptance criteria — use `$plan` / `$blueprint`
 - the request is a simple one-file fact lookup — read the file and answer directly
 - the request is purely about running the RCS tmux team runtime — use `$team` only when RCS runtime is active
 
@@ -87,7 +91,7 @@ Parallel exploration is allowed when it improves quality, but it must stay runti
 
 A good default split for complex analysis is:
 - one lane for primary code path / contracts
-- one lane for config / orchestration / generated surfaces
+- one lane for config / workflow / generated surfaces
 - one lane for tests / docs / secondary corroboration
 
 ## Execution policy
@@ -146,3 +150,6 @@ A good analyze response is:
 - concise for simple cases, broader only when the question truly needs it
 
 Task: {{ARGUMENTS}}
+surface-class: "operator"
+domain: "creator-runtime"
+audience: "operator"

package/plugins/roblox-ai-os-creator-skills/skills/ask-claude/SKILL.md

@@ -1,6 +1,10 @@
 ---
 name: ask-claude
 description: Ask Claude via local CLI and capture a reusable artifact
+surface-class: "operator"
+domain: "creator-runtime"
+audience: "operator"
+artifact-type: "skill"
 ---
 
 # Ask Claude (Local CLI)
@@ -59,3 +63,6 @@ Minimum artifact sections:
 5. Action items / next steps
 
 Task: {{ARGUMENTS}}
+surface-class: "operator"
+domain: "creator-runtime"
+audience: "operator"

package/plugins/roblox-ai-os-creator-skills/skills/ask-gemini/SKILL.md

@@ -1,6 +1,10 @@
 ---
 name: ask-gemini
 description: Ask Gemini via local CLI and capture a reusable artifact
+surface-class: "operator"
+domain: "creator-runtime"
+audience: "operator"
+artifact-type: "skill"
 ---
 
 # Ask Gemini (Local CLI)
@@ -59,3 +63,6 @@ Minimum artifact sections:
 5. Action items / next steps
 
 Task: {{ARGUMENTS}}
+surface-class: "operator"
+domain: "creator-runtime"
+audience: "operator"

package/plugins/roblox-ai-os-creator-skills/skills/autoforge/SKILL.md

@@ -1,6 +1,10 @@
 ---
 name: autoforge
 description: Canonical end-to-end creator workflow surface for Roblox Creator Skills
+surface-class: "canonical"
+domain: "roblox-studio"
+audience: "creator"
+artifact-type: "skill"
 ---
 
 # Autoforge
@@ -16,3 +20,6 @@ For Roblox implementation tasks, `$autoforge` must still obey the mandatory gate
 5. only then begin execution
 
 `PRE_ACTION_COMPLETE` must become `true` before any Roblox code generation.
+surface-class: "operator"
+domain: "creator-runtime"
+audience: "operator"

package/plugins/roblox-ai-os-creator-skills/skills/autopilot/SKILL.md

@@ -1,16 +1,20 @@
 ---
 name: autopilot
-description: "[RCS] Strict autonomous loop: $ralplan -> $ralph -> $code-review"
+description: "[RCS] Strict autonomous loop: $blueprint -> $forge -> $code-review"
+surface-class: "operator"
+domain: "creator-runtime"
+audience: "operator"
+artifact-type: "skill"
 ---
 
 <Purpose>
 Autopilot is the strict autonomous delivery loop for non-trivial work. Its primary contract is exactly:
 
 ```text
-$ralplan -> $ralph -> $code-review
+$blueprint -> $forge -> $code-review
 ```
 
-If `$code-review` is not clean, Autopilot returns to `$ralplan` with the review findings as the next planning input, then continues again through `$ralph` and `$code-review` until the review is clean or a hard blocker is reported.
+If `$code-review` is not clean, Autopilot returns to `$blueprint` with the review findings as the next planning input, then continues again through `$forge` and `$code-review` until the review is clean or a hard blocker is reported.
 </Purpose>
 
 <Use_When>
@@ -20,37 +24,37 @@ If `$code-review` is not clean, Autopilot returns to `$ralplan` with the review
 </Use_When>
 
 <Do_Not_Use_When>
-- User wants to explore options or brainstorm -- use `$plan` / `$ralplan`
+- User wants to explore options or brainstorm -- use `$plan` / `$blueprint`
 - User says "just explain", "draft only", or "what would you suggest" -- respond conversationally
-- User wants a single focused code change -- use `$ralph` or direct executor work
+- User wants a single focused code change -- use `$forge` or direct executor work
 - User wants only review/critique of existing code -- use `$code-review`
 </Do_Not_Use_When>
 
 <Strict_Loop_Contract>
 Autopilot must not run a separate broad expansion/planning/execution/QA/validation lifecycle as its primary behavior. It delegates those concerns to the three canonical workflow phases below:
 
-1. **Phase `ralplan`** — consensus planning gate
+1. **Phase `blueprint`** — consensus planning gate
    - Ground the task with pre-context intake.
-   - Run or resume `$ralplan` to produce/update PRD and test-spec artifacts.
-   - When returning from a non-clean review, include `return_to_ralplan_reason` and the review findings as first-class planning input.
-   - Required handoff artifact: an approved plan/test spec suitable for `$ralph`.
+   - Run or resume `$blueprint` to produce/update PRD and test-spec artifacts.
+   - When returning from a non-clean review, include `return_to_blueprint_reason` and the review findings as first-class planning input.
+   - Required handoff artifact: an approved plan/test spec suitable for `$forge`.
 
-2. **Phase `ralph`** — implementation + verification loop
-   - Run `$ralph` from the approved ralplan artifacts.
-   - Ralph owns implementation, tests, build/lint/typecheck evidence, deslop where applicable, and architect verification.
+2. **Phase `forge`** — implementation + verification loop
+   - Run `$forge` from the approved blueprint artifacts.
+   - Forge owns implementation, tests, build/lint/typecheck evidence, deslop where applicable, and architect verification.
    - Required handoff artifact: implementation evidence and changed-file summary suitable for `$code-review`.
 
 3. **Phase `code-review`** — merge-readiness gate
-   - Run `$code-review` on the diff/artifacts produced by `$ralph`.
+   - Run `$code-review` on the diff/artifacts produced by `$forge`.
    - A clean review means final recommendation `APPROVE` with architectural status `CLEAR`.
    - `COMMENT`, `REQUEST CHANGES`, any architectural `WATCH`/`BLOCK`, or any unresolved finding is not clean.
-   - If not clean, increment the review cycle, persist `review_verdict`, set `return_to_ralplan_reason`, and transition back to Phase `ralplan`.
+   - If not clean, increment the review cycle, persist `review_verdict`, set `return_to_blueprint_reason`, and transition back to Phase `blueprint`.
 
 The only normal terminal state is `complete` after a clean code review. Cancellation, blocked credentials, unrecoverable repeated failures, or explicit user stop may terminate earlier with preserved state.
 </Strict_Loop_Contract>
 
 <Pre-context Intake>
-Before Phase `ralplan` starts or resumes:
+Before Phase `blueprint` starts or resumes:
 1. Derive a task slug from the request.
 2. Reuse the latest relevant `.rcs/context/{slug}-*.md` snapshot when available.
 3. If none exists, create `.rcs/context/{slug}-{timestamp}.md` (UTC `YYYYMMDDTHHMMSSZ`) with:
@@ -60,16 +64,16 @@ Before Phase `ralplan` starts or resumes:
    - constraints
    - unknowns/open questions
    - likely codebase touchpoints
-4. If ambiguity remains high, run `explore` first for brownfield facts, then run the Socratic `$deep-interview --quick <task>` before `$ralplan`.
+4. If ambiguity remains high, run `explore` first for brownfield facts, then run the Socratic `$deep-interview --quick <task>` before `$blueprint`.
 5. Carry the snapshot path in Autopilot state and all handoff artifacts.
 </Pre-context Intake>
 
 <Execution_Policy>
-- Always execute phases in order: `ralplan`, then `ralph`, then `code-review`.
-- Never skip directly from vague/freeform expansion to implementation; unclear input must be clarified or planned through `$ralplan`.
-- A non-clean `$code-review` always returns to `$ralplan`; do not patch findings ad hoc outside the loop.
+- Always execute phases in order: `blueprint`, then `forge`, then `code-review`.
+- Never skip directly from vague/freeform expansion to implementation; unclear input must be clarified or planned through `$blueprint`.
+- A non-clean `$code-review` always returns to `$blueprint`; do not patch findings ad hoc outside the loop.
 - Each phase must write/update Autopilot state before handing off.
-- Use existing hooks, `.rcs/state`, `$ralplan`, `$ralph`, `$code-review`, and pipeline primitives; do not invent a separate execution framework.
+- Use existing hooks, `.rcs/state`, `$blueprint`, `$forge`, `$code-review`, and pipeline primitives; do not invent a separate execution framework.
 - Continue automatically through safe reversible phase transitions. Ask only for destructive, credential-gated, or materially preference-dependent branches.
 - Apply the shared workflow guidance pattern: outcome-first framing, concise visible updates for multi-step execution, local overrides for the active workflow branch, validation proportional to risk, explicit stop rules, and automatic continuation for safe reversible steps. Ask only for material, destructive, credentialed, external-production, or preference-dependent branches.
 </Execution_Policy>
@@ -83,35 +87,35 @@ Required fields:
 {
   "mode": "autopilot",
   "active": true,
-  "current_phase": "ralplan",
+  "current_phase": "blueprint",
   "iteration": 1,
   "review_cycle": 0,
   "max_iterations": 10,
-  "phase_cycle": ["ralplan", "ralph", "code-review"],
+  "phase_cycle": ["blueprint", "forge", "code-review"],
   "handoff_artifacts": {
     "context_snapshot_path": ".rcs/context/<slug>-<timestamp>.md",
-    "ralplan": null,
-    "ralph": null,
+    "blueprint": null,
+    "forge": null,
     "code_review": null
   },
   "review_verdict": null,
-  "return_to_ralplan_reason": null
+  "return_to_blueprint_reason": null
 }
 ```
 
-- **On start**: `state_write({mode:"autopilot", active:true, current_phase:"ralplan", iteration:1, review_cycle:0, state:{phase_cycle:["ralplan","ralph","code-review"], handoff_artifacts:{context_snapshot_path, ralplan:null, ralph:null, code_review:null}, review_verdict:null, return_to_ralplan_reason:null}})`
-- **On ralplan -> ralph**: set `current_phase:"ralph"`, persist the plan/test-spec paths under `handoff_artifacts.ralplan`.
-- **On ralph -> code-review**: set `current_phase:"code-review"`, persist implementation/test evidence under `handoff_artifacts.ralph`.
+- **On start**: `state_write({mode:"autopilot", active:true, current_phase:"blueprint", iteration:1, review_cycle:0, state:{phase_cycle:["blueprint","forge","code-review"], handoff_artifacts:{context_snapshot_path, blueprint:null, forge:null, code_review:null}, review_verdict:null, return_to_blueprint_reason:null}})`
+- **On blueprint -> forge**: set `current_phase:"forge"`, persist the plan/test-spec paths under `handoff_artifacts.blueprint`.
+- **On forge -> code-review**: set `current_phase:"code-review"`, persist implementation/test evidence under `handoff_artifacts.forge`.
 - **On clean review**: set `active:false`, `current_phase:"complete"`, persist `review_verdict:{recommendation:"APPROVE", architectural_status:"CLEAR", clean:true}` and `completed_at`.
-- **On non-clean review**: increment `iteration` and `review_cycle`, set `current_phase:"ralplan"`, persist `review_verdict:{..., clean:false}`, persist `handoff_artifacts.code_review`, and set `return_to_ralplan_reason` to a concise review-driven reason.
+- **On non-clean review**: increment `iteration` and `review_cycle`, set `current_phase:"blueprint"`, persist `review_verdict:{..., clean:false}`, persist `handoff_artifacts.code_review`, and set `return_to_blueprint_reason` to a concise review-driven reason.
 - **On cancellation**: run `$cancel`; preserve progress for resume rather than deleting handoff artifacts.
 </State_Management>
 
 <Continuation_And_Resume>
 When the user says `continue`, `resume`, or `keep going` while Autopilot is active, read `autopilot-state.json` and continue from `current_phase`:
-- `ralplan`: run/update consensus planning from current handoffs and any `return_to_ralplan_reason`.
-- `ralph`: execute the approved plan and record verification evidence.
-- `code-review`: review the current diff and decide clean vs return-to-ralplan.
+- `blueprint`: run/update consensus planning from current handoffs and any `return_to_blueprint_reason`.
+- `forge`: execute the approved plan and record verification evidence.
+- `code-review`: review the current diff and decide clean vs return-to-blueprint.
 - `complete`: report completion evidence; do not restart.
 
 Do not restart discovery or discard handoff artifacts on continuation.
@@ -121,10 +125,10 @@ Do not restart discovery or discard handoff artifacts on continuation.
 Autopilot may be represented by the configurable pipeline orchestrator (`src/pipeline/`) when useful. The Autopilot pipeline contract is:
 
 ```text
-ralplan -> ralph -> code-review
+blueprint -> forge -> code-review
 ```
 
-Pipeline state should use `current_phase` values that match the same phase names (`ralplan`, `ralph`, `code-review`, `complete`, `failed`) and should carry `iteration`, `review_cycle`, `handoff_artifacts`, `review_verdict`, and `return_to_ralplan_reason` alongside stage results.
+Pipeline state should use `current_phase` values that match the same phase names (`blueprint`, `forge`, `code-review`, `complete`, `failed`) and should carry `iteration`, `review_cycle`, `handoff_artifacts`, `review_verdict`, and `return_to_blueprint_reason` alongside stage results.
 </Pipeline_Orchestrator>
 
 <Escalation_And_Stop_Conditions>
@@ -135,11 +139,11 @@ Pipeline state should use `current_phase` values that match the same phase names
 </Escalation_And_Stop_Conditions>
 
 <Final_Checklist>
-- [ ] Phase `ralplan` produced/updated approved planning artifacts
-- [ ] Phase `ralph` implemented and verified the plan with fresh evidence
+- [ ] Phase `blueprint` produced/updated approved planning artifacts
+- [ ] Phase `forge` implemented and verified the plan with fresh evidence
 - [ ] Phase `code-review` returned a clean verdict (`APPROVE` + `CLEAR`)
-- [ ] `review_verdict.clean` is true and `return_to_ralplan_reason` is null
-- [ ] Tests/build/lint/typecheck evidence from Ralph is available in handoff artifacts
+- [ ] `review_verdict.clean` is true and `return_to_blueprint_reason` is null
+- [ ] Tests/build/lint/typecheck evidence from Forge is available in handoff artifacts
 - [ ] Autopilot state is marked `complete` or cancellation state is preserved coherently
 - [ ] User receives a concise summary with plan, implementation, verification, and review evidence
 </Final_Checklist>
@@ -147,17 +151,20 @@ Pipeline state should use `current_phase` values that match the same phase names
 <Examples>
 <Good>
 User: `$autopilot implement GitHub issue #42`
-Flow: create/load context snapshot -> `$ralplan` issue plan -> `$ralph` implementation + tests -> `$code-review`; if review requests changes, return to `$ralplan` with findings.
+Flow: create/load context snapshot -> `$blueprint` issue plan -> `$forge` implementation + tests -> `$code-review`; if review requests changes, return to `$blueprint` with findings.
 </Good>
 
 <Good>
 User: `continue`
 Context: Autopilot state says `current_phase:"code-review"`.
-Flow: run `$code-review` on current diff, persist verdict, finish if clean or transition to `ralplan` with findings if not clean.
+Flow: run `$code-review` on current diff, persist verdict, finish if clean or transition to `blueprint` with findings if not clean.
 </Good>
 
 <Bad>
 Autopilot invents independent "Expansion", "QA", and "Validation" phases and treats them as the primary lifecycle.
-Why bad: this bypasses the strict `$ralplan -> $ralph -> $code-review` contract.
+Why bad: this bypasses the strict `$blueprint -> $forge -> $code-review` contract.
 </Bad>
 </Examples>
+surface-class: "operator"
+domain: "creator-runtime"
+audience: "operator"

package/plugins/roblox-ai-os-creator-skills/skills/autoresearch/SKILL.md

@@ -1,6 +1,10 @@
 ---
 name: autoresearch
 description: Stateful validator-gated research loop with native-hook persistence
+surface-class: "operator"
+domain: "creator-runtime"
+audience: "operator"
+artifact-type: "skill"
 ---
 
 # Autoresearch
@@ -9,7 +13,7 @@ Autoresearch is the skill-first replacement for the deprecated `rcs autoresearch
 It keeps the useful measured-research loop, but it now runs as a native-hook stateful workflow instead of a direct CLI or tmux launch surface.
 
 ## Use when
-- You want a Ralph-ish persistent research loop
+- You want a Forge-like persistent research loop
 - The task should keep nudging until explicit validation evidence exists
 - You want init-time choice between script validation and prompt+architect validation
 
@@ -66,3 +70,6 @@ The completion artifact must include both an architect approval verdict and an o
 - No direct CLI launch.
 - No tmux split-pane launch.
 - No noop-count completion gate.
+surface-class: "operator"
+domain: "creator-runtime"
+audience: "operator"