@jstn-sdk/rcs 0.1.7 → 0.1.8

package/docs/wiki/Release-Playbook.md

@@ -0,0 +1,57 @@
+# Release Playbook
+
+This page explains the public release surfaces for RCS.
+
+## Three separate release surfaces
+
+### 1. npm package
+
+Public package:
+
+- `@jstn-sdk/rcs`
+
+Registry:
+
+- `https://registry.npmjs.org`
+
+Purpose:
+
+- what end users install with `npm install -g @jstn-sdk/rcs`
+
+### 2. GitHub Packages
+
+Registry:
+
+- `https://npm.pkg.github.com`
+
+Purpose:
+
+- populates the repository Packages tab
+- keeps GitHub-native package visibility aligned with the repo
+
+### 3. GitHub Releases
+
+Purpose:
+
+- creates the Releases page entry
+- attaches release notes and binary assets to a tag
+
+Important:
+
+- a git tag alone is not a GitHub Release object
+- a successful npm publish alone does not populate GitHub Releases or GitHub Packages
+
+## Maintainer release expectations
+
+- verify Actions pre-flight before sign-off
+- keep changelog and release notes aligned
+- create or update the GitHub Release object from the tag workflow
+- publish npm and GitHub Packages from the workflow lanes, not by assumption
+
+## Contributor-facing outputs
+
+- release notes
+- changelog entry
+- package version bump
+- tagged release
+- attached native assets when applicable

package/docs/wiki/Roadmap.md

@@ -0,0 +1,90 @@
+# Roadmap
+
+This is the current contributor-facing roadmap for RCS.
+
+## Current priority themes
+
+- contributor experience and community hygiene
+- release reliability across GitHub Releases, GitHub Packages, and npm
+- Roblox-first prompt and skill quality
+- Studio workspace and reference-layer grounding
+
+## Next roadmap
+
+### Worldbuilding and design production skills
+
+Planned outputs:
+
+- moodboards
+- GDD structure
+- story outline
+- character sheets
+- map chunk specs
+- weekly implementation plans
+
+Why it matters:
+
+- helps RCS support pre-production and design-system work, not just coding
+- gives creators a disciplined planning path before implementation
+
+### Roblox monetization planner
+
+Planned outputs:
+
+- game pass ideas
+- dev product loops
+- subscription perks
+- private server strategy
+- Creator Rewards fit by genre
+
+Why it matters:
+
+- pushes monetization design into explicit, reviewable planning instead of ad hoc prompting
+
+### Patch assistant
+
+Planned outputs:
+
+- update notes
+- devlog copy
+- QA checklist
+- release readiness review
+
+Why it matters:
+
+- turns merged work into ship-ready communication and operational follow-through
+
+### Audience and retention planner
+
+Planned outputs:
+
+- target player habits
+- session length expectations
+- social hooks
+- replay loops
+
+Why it matters:
+
+- makes retention design a first-class creator workflow instead of an afterthought
+
+### Live ops mode
+
+Planned outputs:
+
+- weekly update planning
+- event cadence
+- private-server hooks
+- seasonal content beats
+- acquisition loops tied to Roblox monetization and Creator Rewards
+
+Why it matters:
+
+- aligns content cadence, retention, and monetization into one explicit operating surface
+
+## Contributor note
+
+If you want to help, prefer turning one roadmap item into:
+
+1. a scoped issue
+2. clear acceptance criteria
+3. one narrow implementation slice

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jstn-sdk/rcs",
-  "version": "0.1.7",
+  "version": "0.1.8",
   "description": "Roblox Creator Skills toolkit and workflow layer for Codex CLI",
   "type": "module",
   "main": "dist/index.js",

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

@@ -1,6 +1,6 @@
 {
   "name": "roblox-ai-os-creator-skills",
-  "version": "0.1.7",
+  "version": "0.1.8",
   "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

@@ -45,10 +45,18 @@ Priority 1: canonical platform truth
 - `https://gitmcp.io/Roblox/creator-docs`
 
 Priority 2: high-signal implementation references
+- `https://github.com/sentinelcore/roblox-skills`
 - `https://gitmcp.io/retpirato/Roblox-Scripts`
 - `https://gitmcp.io/sentinelcore/roblox-skills`
-- `https://gitmcp.io/frosteen/Roblox_LUA_Weapon_Scripts`
+- `https://github.com/greedychipmunk/agent-skills/tree/main/roblox-game-developer`
+- `https://github.com/omer-metin/skills-for-antigravity/tree/main/skills/roblox-development`
+- `https://github.com/dig1t/skills`
+- `https://github.com/Corecii/Devprod`
 - `https://gitmcp.io/Corecii/Devprod`
+
+Priority 3: raw script and corpus support
+- `https://github.com/retpirato/Roblox-Scripts`
+- `https://gitmcp.io/frosteen/Roblox_LUA_Weapon_Scripts`
 - `https://gitmcp.io/uhub/awesome-lua`
 - `https://gitmcp.io/LewisJEllis/awesome-lua`
 - `https://gitmcp.io/forhappy/awesome-lua`
@@ -61,11 +69,15 @@ Priority 3: dataset and corpus support
 - `https://datasets-server.huggingface.co/splits?dataset=TorpedoSoftware%2FRoblox-Luau-Reasoning-v1.0`
 - `https://huggingface.co/datasets/bartholomort/lua-obfuscator-corpus`
 
-Rules:
+Reference policy:
 - official Roblox docs define correctness
-- repos improve implementation awareness only
+- Roblox skill repos improve implementation awareness only
 - datasets are weak pattern support only
 
+Canonical reference-layer policy is documented in:
+- `docs/reference/roblox-mcp-reference-layer.md`
+- `templates/roblox/reference-sources.md`
+
 ## Phase 2: Understanding Synthesis
 
 Before implementation, answer:

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

@@ -141,6 +141,3 @@ 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

@@ -9,7 +9,7 @@ artifact-type: "skill"
 
 # Analyze — Read-Only Deep Analysis
 
-Use this skill to answer the user’s question through **read-only repository analysis**. The goal is to explain what the codebase most likely says about the question, not to drift into implementation, debugging theater, or generic fix planning.
+Use this skill to answer the user’s question through **read-only repository analysis**. In this repo, that usually means Roblox Studio, Luau, plugin, creator-runtime, or workflow evidence, not generic software diagnosis detached from the actual creator surface.
 
 ## Use `$analyze` when
 
@@ -20,11 +20,11 @@ Use this skill to answer the user’s question through **read-only repository an
 - the user wants to understand architecture, behavior, causality, impact, or tradeoffs before changing anything
 
 Examples:
-- why a workflow behaves a certain way
-- how a feature is wired across modules
-- what likely explains a failure, regression, or mismatch
-- what would be impacted by changing a dependency or contract
-- which interpretation of the current codebase is best supported
+- why a remote validation path behaves a certain way
+- how a creator HUD or plugin surface is wired across modules
+- what likely explains a trade, datastore, or workflow regression
+- what would be impacted by changing a provider contract, remote schema, or creator-runtime boundary
+- which interpretation of the current Roblox-facing codebase is best supported
 
 ## Do not use `$analyze` when
 
@@ -150,6 +150,3 @@ 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

@@ -63,6 +63,3 @@ 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

@@ -63,6 +63,3 @@ 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

@@ -20,6 +20,3 @@ 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

@@ -165,6 +165,3 @@ Autopilot invents independent "Expansion", "QA", and "Validation" phases and tre
 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

@@ -70,6 +70,3 @@ 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"

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

@@ -235,6 +235,3 @@ Need:
 - anti-duplication rules for queue join/leave
 - verification path for queue sync and teleport readiness"
 ```
-surface-class: "canonical"
-domain: "creator-runtime"
-audience: "creator"

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

@@ -21,6 +21,3 @@ Return a filled **Dopamine Loop Map** using `templates/psychology/dopamine-loop-
 - daily loop
 - weekly loop
 - comeback loop
-surface-class: "canonical"
-domain: "creator-runtime"
-audience: "creator"

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

@@ -23,6 +23,3 @@ Return:
 - fairness risks.
 
 Use `docs/reference/player-psychology-framework.md` as the framework source.
-surface-class: "canonical"
-domain: "creator-runtime"
-audience: "creator"

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

@@ -17,6 +17,3 @@ Return:
 - a filled **Retention Design Sheet** from `templates/psychology/retention-design-sheet.md`
 - a compact **Weekly LiveOps Plan**
 - comeback hooks and burnout guardrails
-surface-class: "canonical"
-domain: "creator-runtime"
-audience: "creator"

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

@@ -17,6 +17,3 @@ Return a **Social Retention Spec** using `templates/psychology/social-mechanic-s
 - parties / guilds / trading / co-op / invites / presence systems as appropriate
 - why solo-only design would underperform
 - anti-spam guardrails
-surface-class: "canonical"
-domain: "creator-runtime"
-audience: "creator"

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

@@ -29,6 +29,3 @@ Use the protocol in:
 Follow with:
 - `$brief:audience`
 - `$brief:motivation`
-surface-class: "canonical"
-domain: "creator-runtime"
-audience: "creator"

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

@@ -21,6 +21,3 @@ Return a filled **Player Motivation Profile** using `templates/psychology/player
 - Name the primary fantasy before talking about features.
 - Call out likely session length and why the player comes back.
 - End with 3 audience risks or mismatches.
-surface-class: "canonical"
-domain: "creator-runtime"
-audience: "creator"

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

@@ -24,6 +24,3 @@ Return a **Motivation Matrix** with:
 - Explain the dominant driver in one sentence.
 - Separate “good urgency” from manipulative pressure.
 - Prefer community when social play is naturally supported.
-surface-class: "canonical"
-domain: "creator-runtime"
-audience: "creator"

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

@@ -401,6 +401,3 @@ rm -rf .rcs/state/team/                  # All team state
 # Kill all rcs-team-* tmux sessions
 tmux list-sessions -F '#{session_name}' 2>/dev/null | grep '^rcs-team-' | while read s; do tmux kill-session -t "$s" 2>/dev/null; done
 ```
-surface-class: "operator"
-domain: "creator-runtime"
-audience: "operator"

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

@@ -9,7 +9,7 @@ artifact-type: "skill"
 
 # Code Review Skill
 
-Conduct a thorough code review for quality, security, and maintainability with severity-rated feedback.
+Conduct a thorough code review for Roblox Studio, Luau, creator-runtime, plugin, and workflow changes with severity-rated feedback.
 
 ## When to Use
 
@@ -38,11 +38,11 @@ Delegates to the `code-reviewer` and `architect` agents in parallel for a two-la
    - Both lanes run in parallel and produce distinct outputs before final synthesis
 
 3. **Review Categories**
-   - **Security** - Hardcoded secrets, injection risks, XSS, CSRF
-   - **Code Quality** - Function size, complexity, nesting depth
-   - **Performance** - Algorithm efficiency, N+1 queries, caching
-   - **Best Practices** - Naming, documentation, error handling
-   - **Maintainability** - Duplication, coupling, testability
+   - **Roblox Security** - server authority, remote validation, replicated secrets/data exposure, DataStore/economy safety
+   - **Code Quality** - function size, complexity, nesting depth, cross-module clarity
+   - **Performance** - replication churn, avoidable UI rebuilds, hot-path inefficiency, heavy runtime loops
+   - **Best Practices** - naming, documentation, error handling, service placement
+   - **Maintainability** - duplication, coupling, testability, workflow boundary clarity
 
 4. **Severity Rating**
    - **CRITICAL** - Security vulnerability (must fix before merge)
@@ -291,6 +291,3 @@ Parallel code review across multiple files.
 - **Address CRITICAL/HIGH first** - Fix security and bugs immediately
 - **Consider context** - Some "issues" may be intentional trade-offs
 - **Learn from reviews** - Use feedback to improve coding practices
-surface-class: "operator"
-domain: "creator-runtime"
-audience: "operator"

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

@@ -289,6 +289,3 @@ Show:
 - Whether explicit `notifications.openclaw` exists (and therefore overrides aliases)
 - Verbosity + idle cooldown + reply listener state
 - Config path (`~/.codex/.rcs-config.json`)
-surface-class: "operator"
-domain: "creator-runtime"
-audience: "operator"

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

@@ -12,6 +12,3 @@ artifact-type: "skill"
 Use `$crew` when the work needs coordinated creator lanes such as systems design, economy review, social design, and implementation planning in parallel.
 
 For Roblox tasks, the crew should not fan out implementation until the shared pre-action artifact exists and `PRE_ACTION_COMPLETE` is `true`.
-surface-class: "operator"
-domain: "creator-runtime"
-audience: "operator"

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

@@ -470,6 +470,3 @@ deep-interview -> blueprint -> autopilot
 </Advanced>
 
 Task: {{ARGUMENTS}}
-surface-class: "operator"
-domain: "creator-runtime"
-audience: "operator"

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

@@ -241,6 +241,3 @@ rm -rf ~/.agents/skills
 
 After applying fixes, inform user:
 > Fixes applied. **Restart Codex CLI** for changes to take effect.
-surface-class: "operator"
-domain: "creator-runtime"
-audience: "operator"

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

@@ -188,6 +188,3 @@ $forge "Implement the approved trading system:
 - StarterGui trade UI only mirrors server-confirmed state
 - verify duplicate acceptance cannot double-grant items"
 ```
-surface-class: "canonical"
-domain: "creator-runtime"
-audience: "creator"

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

@@ -18,6 +18,3 @@ Generate a **Community Stickiness Spec**.
 - group progression or co-op loops
 - social presence surfaces
 - anti-spam and anti-abuse guardrails
-surface-class: "canonical"
-domain: "creator-runtime"
-audience: "creator"

package/plugins/roblox-ai-os-creator-skills/skills/forge-daily-loop/SKILL.md

@@ -17,6 +17,3 @@ Generate a **Daily Return Loop Spec** for short-return Roblox play.
 - rotating goals or offers
 - event hooks
 - fairness and anti-burnout guardrails
-surface-class: "canonical"
-domain: "creator-runtime"
-audience: "creator"

package/plugins/roblox-ai-os-creator-skills/skills/forge-event-loop/SKILL.md

@@ -17,6 +17,3 @@ Generate an **Event / FOMO Plan** using `templates/psychology/event-fomo-design-
 - include re-entry logic
 - include rerun policy
 - call out frustration risks
-surface-class: "canonical"
-domain: "creator-runtime"
-audience: "creator"

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

@@ -18,6 +18,3 @@ Generate a **Fair Urgency Review** for limited-time mechanics.
 - fairness guardrails
 - comeback or rerun path
 - anti-frustration notes
-surface-class: "canonical"
-domain: "creator-runtime"
-audience: "creator"

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

@@ -18,6 +18,3 @@ Generate a **Mastery Depth Spec**.
 - discovery moments
 - skill-expression rewards
 - feedback surfaces that make mastery legible
-surface-class: "canonical"
-domain: "creator-runtime"
-audience: "creator"

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

@@ -18,6 +18,3 @@ Generate a **Progression Ladder**.
 - unlock cadence
 - multiplier / prestige / rebirth logic where fit
 - clarity notes for first-session payoff
-surface-class: "canonical"
-domain: "creator-runtime"
-audience: "creator"

package/plugins/roblox-ai-os-creator-skills/skills/forge-reward-loop/SKILL.md

@@ -21,6 +21,3 @@ Generate a concrete **Reward Loop Spec**.
 - fail state
 - recovery path
 - Roblox-fit note
-surface-class: "canonical"
-domain: "creator-runtime"
-audience: "creator"

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

@@ -19,6 +19,3 @@ Generate a **Prestige / Status Spec**.
 - visible milestones
 - pets, profile badges, or showcases where fit
 - visibility and fairness risks
-surface-class: "canonical"
-domain: "creator-runtime"
-audience: "creator"

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

@@ -77,6 +77,3 @@ Use:
 - `docs/reference/roblox-pre-action-protocol.md`
 - `templates/psychology/`
 - `templates/roblox/`
-surface-class: "operator"
-domain: "creator-runtime"
-audience: "operator"

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

@@ -100,6 +100,3 @@ If the TUI statusline is not showing:
 If `rcs hud` shows "No active modes":
 - This is expected when no workflows are running
 - Start a workflow (forge, autopilot, etc.) and check again
-surface-class: "operator"
-domain: "creator-runtime"
-audience: "operator"

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

@@ -64,6 +64,3 @@ Notepad content is automatically loaded on session start:
 - Working Memory: Loaded if recent entries exist
 
 This helps survive conversation compaction without losing critical context.
-surface-class: "operator"
-domain: "creator-runtime"
-audience: "operator"

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

@@ -88,6 +88,3 @@ const result = await runPipeline(config);
 - **team**: Pipeline delegates execution to team mode (Codex CLI workers)
 - **forge**: Pipeline delegates verification to forge (configurable iterations)
 - **blueprint**: Pipeline's first stage runs consensus planning
-surface-class: "operator"
-domain: "creator-runtime"
-audience: "operator"

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

@@ -279,6 +279,3 @@ Before asking any interview question, classify it:
 
 The separate `/planner` and `/review` skills have been merged into `$plan`. Consensus planning remains available through `$plan --consensus`, while `$blueprint` is the canonical creator-facing planning workflow when you want the full Roblox-native design lane.
 </Advanced>
-surface-class: "operator"
-domain: "creator-runtime"
-audience: "operator"

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

@@ -137,6 +137,3 @@ node bin/rcs.js doctor
 
 - If AGENTS.md was not overwritten during `--force`, stop active RCS session and rerun setup.
 - If AGENTS.md was not merged during `--merge-agents`, stop active RCS session and rerun setup.
-surface-class: "operator"
-domain: "creator-runtime"
-audience: "operator"

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

@@ -179,6 +179,3 @@ OVERALL: [POSTURE] — ship / fix-first / block live
 **Good:** The user says `continue` after you already listed the next remote to trace; keep tracing until the chain is complete.
 
 **Bad:** The user says `continue` and you restart from “what is Roblox” instead of finishing the active exploit hypothesis.
-surface-class: "operator"
-domain: "creator-runtime"
-audience: "operator"