@jstn-sdk/rcs 0.1.6 → 0.1.8

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.
Files changed (241) hide show
  1. package/README.md +64 -1
  2. package/dist/agents/definitions.d.ts +6 -0
  3. package/dist/agents/definitions.d.ts.map +1 -1
  4. package/dist/agents/definitions.js +14 -0
  5. package/dist/agents/definitions.js.map +1 -1
  6. package/dist/config/generator.d.ts.map +1 -1
  7. package/dist/config/generator.js +6 -2
  8. package/dist/config/generator.js.map +1 -1
  9. package/dist/config/models.d.ts +37 -0
  10. package/dist/config/models.d.ts.map +1 -1
  11. package/dist/config/models.js +121 -3
  12. package/dist/config/models.js.map +1 -1
  13. package/dist/config/roblox-reference-mcp.d.ts +16 -0
  14. package/dist/config/roblox-reference-mcp.d.ts.map +1 -0
  15. package/dist/config/roblox-reference-mcp.js +37 -0
  16. package/dist/config/roblox-reference-mcp.js.map +1 -0
  17. package/dist/index.d.ts +3 -1
  18. package/dist/index.d.ts.map +1 -1
  19. package/dist/index.js +2 -1
  20. package/dist/index.js.map +1 -1
  21. package/dist/platform-targets/reader.d.ts +3 -0
  22. package/dist/platform-targets/reader.d.ts.map +1 -0
  23. package/dist/platform-targets/reader.js +31 -0
  24. package/dist/platform-targets/reader.js.map +1 -0
  25. package/dist/platform-targets/schema.d.ts +22 -0
  26. package/dist/platform-targets/schema.d.ts.map +1 -0
  27. package/dist/platform-targets/schema.js +88 -0
  28. package/dist/platform-targets/schema.js.map +1 -0
  29. package/dist/scripts/publish-github-package.d.ts +3 -0
  30. package/dist/scripts/publish-github-package.d.ts.map +1 -0
  31. package/dist/scripts/publish-github-package.js +74 -0
  32. package/dist/scripts/publish-github-package.js.map +1 -0
  33. package/dist/scripts/surface-taxonomy.d.ts.map +1 -1
  34. package/dist/scripts/surface-taxonomy.js +0 -5
  35. package/dist/scripts/surface-taxonomy.js.map +1 -1
  36. package/docs/agents.html +1 -0
  37. package/docs/index.html +13 -1
  38. package/docs/plugin-bundle-ssot.md +2 -0
  39. package/docs/readme/README.de.md +46 -19
  40. package/docs/readme/README.el.md +47 -20
  41. package/docs/readme/README.es.md +47 -20
  42. package/docs/readme/README.fr.md +47 -20
  43. package/docs/readme/README.it.md +46 -19
  44. package/docs/readme/README.ja.md +47 -20
  45. package/docs/readme/README.ko.md +47 -20
  46. package/docs/readme/README.md +2 -1
  47. package/docs/readme/README.pl.md +47 -20
  48. package/docs/readme/README.pt.md +47 -20
  49. package/docs/readme/README.ru.md +47 -20
  50. package/docs/readme/README.tr.md +47 -20
  51. package/docs/readme/README.uk.md +47 -20
  52. package/docs/readme/README.vi.md +47 -20
  53. package/docs/readme/README.zh-TW.md +47 -20
  54. package/docs/readme/README.zh.md +47 -20
  55. package/docs/reference/agentic-platform-compatibility.md +147 -0
  56. package/docs/reference/canonical-vocabulary.md +0 -1
  57. package/docs/reference/llm-provider-abstraction.md +88 -0
  58. package/docs/reference/multi-agent-compatibility-architecture.md +120 -0
  59. package/docs/reference/rcs-config-schema-routing.md +3 -0
  60. package/docs/reference/roblox-mcp-reference-layer.md +75 -0
  61. package/docs/reference/roblox-pre-action-protocol.md +15 -3
  62. package/docs/reference/semantic-design-system.md +0 -7
  63. package/docs/reference/surface-map.md +0 -9
  64. package/docs/release-notes-v0.1.7.md +20 -0
  65. package/docs/release-notes-v0.1.8.md +24 -0
  66. package/docs/wiki/Contributing.md +45 -0
  67. package/docs/wiki/Good-First-Issues.md +44 -0
  68. package/docs/wiki/Home.md +35 -0
  69. package/docs/wiki/Release-Playbook.md +57 -0
  70. package/docs/wiki/Roadmap.md +90 -0
  71. package/package.json +1 -1
  72. package/plugins/roblox-ai-os-creator-skills/.codex-plugin/plugin.json +1 -1
  73. package/plugins/roblox-ai-os-creator-skills/docs/reference/roblox-pre-action-protocol.md +15 -3
  74. package/plugins/roblox-ai-os-creator-skills/skills/ai-slop-cleaner/SKILL.md +0 -3
  75. package/plugins/roblox-ai-os-creator-skills/skills/analyze/SKILL.md +6 -9
  76. package/plugins/roblox-ai-os-creator-skills/skills/ask-claude/SKILL.md +0 -3
  77. package/plugins/roblox-ai-os-creator-skills/skills/ask-gemini/SKILL.md +0 -3
  78. package/plugins/roblox-ai-os-creator-skills/skills/autoforge/SKILL.md +0 -3
  79. package/plugins/roblox-ai-os-creator-skills/skills/autopilot/SKILL.md +0 -3
  80. package/plugins/roblox-ai-os-creator-skills/skills/autoresearch/SKILL.md +0 -3
  81. package/plugins/roblox-ai-os-creator-skills/skills/blueprint/SKILL.md +0 -3
  82. package/plugins/roblox-ai-os-creator-skills/skills/blueprint-loop/SKILL.md +0 -3
  83. package/plugins/roblox-ai-os-creator-skills/skills/blueprint-psych/SKILL.md +0 -3
  84. package/plugins/roblox-ai-os-creator-skills/skills/blueprint-retention/SKILL.md +0 -3
  85. package/plugins/roblox-ai-os-creator-skills/skills/blueprint-social/SKILL.md +0 -3
  86. package/plugins/roblox-ai-os-creator-skills/skills/brief/SKILL.md +0 -3
  87. package/plugins/roblox-ai-os-creator-skills/skills/brief-audience/SKILL.md +0 -3
  88. package/plugins/roblox-ai-os-creator-skills/skills/brief-motivation/SKILL.md +0 -3
  89. package/plugins/roblox-ai-os-creator-skills/skills/cancel/SKILL.md +0 -3
  90. package/plugins/roblox-ai-os-creator-skills/skills/code-review/SKILL.md +6 -9
  91. package/plugins/roblox-ai-os-creator-skills/skills/configure-notifications/SKILL.md +0 -3
  92. package/plugins/roblox-ai-os-creator-skills/skills/crew/SKILL.md +0 -3
  93. package/plugins/roblox-ai-os-creator-skills/skills/deep-interview/SKILL.md +0 -3
  94. package/plugins/roblox-ai-os-creator-skills/skills/doctor/SKILL.md +0 -3
  95. package/plugins/roblox-ai-os-creator-skills/skills/forge/SKILL.md +0 -3
  96. package/plugins/roblox-ai-os-creator-skills/skills/forge-community/SKILL.md +0 -3
  97. package/plugins/roblox-ai-os-creator-skills/skills/forge-daily-loop/SKILL.md +0 -3
  98. package/plugins/roblox-ai-os-creator-skills/skills/forge-event-loop/SKILL.md +0 -3
  99. package/plugins/roblox-ai-os-creator-skills/skills/forge-fomo/SKILL.md +0 -3
  100. package/plugins/roblox-ai-os-creator-skills/skills/forge-mastery/SKILL.md +0 -3
  101. package/plugins/roblox-ai-os-creator-skills/skills/forge-progression/SKILL.md +0 -3
  102. package/plugins/roblox-ai-os-creator-skills/skills/forge-reward-loop/SKILL.md +0 -3
  103. package/plugins/roblox-ai-os-creator-skills/skills/forge-status/SKILL.md +0 -3
  104. package/plugins/roblox-ai-os-creator-skills/skills/help/SKILL.md +0 -3
  105. package/plugins/roblox-ai-os-creator-skills/skills/hud/SKILL.md +0 -3
  106. package/plugins/roblox-ai-os-creator-skills/skills/note/SKILL.md +0 -3
  107. package/plugins/roblox-ai-os-creator-skills/skills/pipeline/SKILL.md +0 -3
  108. package/plugins/roblox-ai-os-creator-skills/skills/plan/SKILL.md +0 -3
  109. package/plugins/roblox-ai-os-creator-skills/skills/rcs-setup/SKILL.md +0 -3
  110. package/plugins/roblox-ai-os-creator-skills/skills/security-review/SKILL.md +0 -3
  111. package/plugins/roblox-ai-os-creator-skills/skills/skill/SKILL.md +38 -40
  112. package/plugins/roblox-ai-os-creator-skills/skills/team/SKILL.md +0 -3
  113. package/plugins/roblox-ai-os-creator-skills/skills/trace/SKILL.md +0 -3
  114. package/plugins/roblox-ai-os-creator-skills/skills/ultraqa/SKILL.md +7 -10
  115. package/plugins/roblox-ai-os-creator-skills/skills/ultrawork/SKILL.md +0 -3
  116. package/plugins/roblox-ai-os-creator-skills/skills/visual-forge/SKILL.md +1 -4
  117. package/plugins/roblox-ai-os-creator-skills/skills/visual-verdict/SKILL.md +0 -3
  118. package/plugins/roblox-ai-os-creator-skills/skills/wiki/SKILL.md +0 -3
  119. package/plugins/roblox-ai-os-creator-skills/skills/worker/SKILL.md +1 -4
  120. package/prompts/analyst.md +3 -6
  121. package/prompts/architect.md +2 -4
  122. package/prompts/build-fixer.md +5 -5
  123. package/prompts/code-reviewer.md +3 -4
  124. package/prompts/critic.md +0 -3
  125. package/prompts/debugger.md +4 -6
  126. package/prompts/dependency-expert.md +1 -3
  127. package/prompts/designer.md +2 -5
  128. package/prompts/executor.md +2 -4
  129. package/prompts/explore-harness.md +0 -3
  130. package/prompts/explore.md +1 -4
  131. package/prompts/git-master.md +0 -3
  132. package/prompts/planner.md +2 -4
  133. package/prompts/researcher.md +2 -5
  134. package/prompts/security-reviewer.md +2 -4
  135. package/prompts/sisyphus-lite.md +0 -3
  136. package/prompts/team-executor.md +1 -3
  137. package/prompts/test-engineer.md +6 -8
  138. package/prompts/verifier.md +1 -3
  139. package/prompts/vision.md +1 -3
  140. package/prompts/writer.md +3 -5
  141. package/skills/ai-slop-cleaner/SKILL.md +0 -3
  142. package/skills/analyze/SKILL.md +6 -9
  143. package/skills/ask-claude/SKILL.md +0 -3
  144. package/skills/ask-gemini/SKILL.md +0 -3
  145. package/skills/autoforge/SKILL.md +0 -3
  146. package/skills/autopilot/SKILL.md +0 -3
  147. package/skills/autoresearch/SKILL.md +0 -3
  148. package/skills/blueprint/SKILL.md +0 -3
  149. package/skills/blueprint-loop/SKILL.md +0 -3
  150. package/skills/blueprint-psych/SKILL.md +0 -3
  151. package/skills/blueprint-retention/SKILL.md +0 -3
  152. package/skills/blueprint-social/SKILL.md +0 -3
  153. package/skills/brief/SKILL.md +0 -3
  154. package/skills/brief-audience/SKILL.md +0 -3
  155. package/skills/brief-motivation/SKILL.md +0 -3
  156. package/skills/build-fix/SKILL.md +2 -4
  157. package/skills/cancel/SKILL.md +0 -3
  158. package/skills/code-review/SKILL.md +6 -9
  159. package/skills/configure-notifications/SKILL.md +0 -3
  160. package/skills/crew/SKILL.md +0 -3
  161. package/skills/deep-interview/SKILL.md +0 -3
  162. package/skills/deepsearch/SKILL.md +0 -3
  163. package/skills/doctor/SKILL.md +0 -3
  164. package/skills/ecomode/SKILL.md +0 -3
  165. package/skills/forge/SKILL.md +0 -3
  166. package/skills/forge-community/SKILL.md +0 -3
  167. package/skills/forge-daily-loop/SKILL.md +0 -3
  168. package/skills/forge-event-loop/SKILL.md +0 -3
  169. package/skills/forge-fomo/SKILL.md +0 -3
  170. package/skills/forge-init/SKILL.md +0 -3
  171. package/skills/forge-mastery/SKILL.md +0 -3
  172. package/skills/forge-progression/SKILL.md +0 -3
  173. package/skills/forge-reward-loop/SKILL.md +0 -3
  174. package/skills/forge-status/SKILL.md +0 -3
  175. package/skills/git-master/SKILL.md +0 -3
  176. package/skills/help/SKILL.md +0 -3
  177. package/skills/hud/SKILL.md +0 -3
  178. package/skills/note/SKILL.md +0 -3
  179. package/skills/pipeline/SKILL.md +0 -3
  180. package/skills/plan/SKILL.md +0 -3
  181. package/skills/rcs-setup/SKILL.md +0 -3
  182. package/skills/review/SKILL.md +0 -3
  183. package/skills/security-review/SKILL.md +0 -3
  184. package/skills/skill/SKILL.md +38 -40
  185. package/skills/swarm/SKILL.md +1 -4
  186. package/skills/tdd/SKILL.md +0 -3
  187. package/skills/team/SKILL.md +0 -3
  188. package/skills/trace/SKILL.md +0 -3
  189. package/skills/ultraqa/SKILL.md +7 -10
  190. package/skills/ultrawork/SKILL.md +0 -3
  191. package/skills/visual-forge/SKILL.md +1 -4
  192. package/skills/visual-verdict/SKILL.md +0 -3
  193. package/skills/web-clone/SKILL.md +0 -3
  194. package/skills/wiki/SKILL.md +0 -3
  195. package/skills/worker/SKILL.md +1 -4
  196. package/src/scripts/publish-github-package.ts +94 -0
  197. package/src/scripts/surface-taxonomy.ts +0 -5
  198. package/templates/roblox/llm-provider-routing.json +42 -0
  199. package/templates/roblox/reference-sources.md +33 -0
  200. package/docs/archive/README.md +0 -15
  201. package/docs/archive/migration-mainline-post-v0.4.4.md +0 -90
  202. package/docs/archive/prompt-migration-changelog.md +0 -141
  203. package/docs/archive/qa-plan-0.4.2.md +0 -85
  204. package/docs/archive/qa-report-0.4.2.md +0 -55
  205. package/docs/archive/release-body-0.9.0.md +0 -86
  206. package/docs/archive/release-body-0.9.1.md +0 -41
  207. package/docs/benchmarks/tetris-benchmark-comparison-20260306.png +0 -0
  208. package/docs/issues/team-forge-followup-team.md +0 -38
  209. package/docs/qa/ci-speedups-after-prompt-worker-fix.md +0 -91
  210. package/docs/qa/deep-interview-phase-1-validation.md +0 -117
  211. package/docs/qa/explore-sparkshell-heavy-manual-stress.md +0 -244
  212. package/docs/qa/recent-bug-regression-hardening-2026-04-11.md +0 -24
  213. package/docs/qa/release-no-publish-0.15.0.md +0 -33
  214. package/docs/qa/release-readiness-0.11.13.md +0 -39
  215. package/docs/qa/release-readiness-0.12.0.md +0 -80
  216. package/docs/qa/release-readiness-0.12.1.md +0 -33
  217. package/docs/qa/release-readiness-0.12.2.md +0 -33
  218. package/docs/qa/release-readiness-0.12.3.md +0 -30
  219. package/docs/qa/release-readiness-0.12.5.md +0 -69
  220. package/docs/qa/release-readiness-0.12.6.md +0 -59
  221. package/docs/qa/release-readiness-0.13.0.md +0 -64
  222. package/docs/qa/release-readiness-0.13.1.md +0 -39
  223. package/docs/qa/release-readiness-0.14.0.md +0 -55
  224. package/docs/qa/release-readiness-0.14.1.md +0 -44
  225. package/docs/qa/release-readiness-0.14.2.md +0 -65
  226. package/docs/qa/release-readiness-0.14.3.md +0 -42
  227. package/docs/qa/release-readiness-0.14.4.md +0 -40
  228. package/docs/qa/release-readiness-0.15.0.md +0 -65
  229. package/docs/qa/release-readiness-0.15.1.md +0 -44
  230. package/docs/qa/release-readiness-0.8.1.md +0 -37
  231. package/docs/qa/release-readiness-0.8.2.md +0 -39
  232. package/docs/qa/release-readiness-0.8.3.md +0 -43
  233. package/docs/qa/release-readiness-0.8.4.md +0 -39
  234. package/docs/qa/release-readiness-0.9.0.md +0 -78
  235. package/docs/qa/release-readiness-0.9.1.md +0 -43
  236. package/docs/qa/release-readiness-follow-up.md +0 -26
  237. package/docs/qa/remaining-suite-drift-2026-03-19.md +0 -105
  238. package/docs/qa/research-specialist-eval-surface-2026-04-18.md +0 -42
  239. package/docs/qa/runtime-team-seam-audit-2026-04-01.md +0 -128
  240. package/docs/reports/macos-m1-high-cpu-usage-2026-04-16.md +0 -78
  241. package/docs/reports/open-prs-dev-readiness-2026-04-09.md +0 -45
@@ -260,14 +260,9 @@ export function buildSurfaceMapMarkdown(records: SurfaceTaxonomyRecord[]): strin
260
260
  '',
261
261
  ...renderTable(internal),
262
262
  '',
263
- '## Historical Surfaces',
264
- '',
265
- ...renderTable(historical),
266
- '',
267
263
  '## Additional Repo Lanes',
268
264
  '',
269
265
  '- `AGENTS.md` and `templates/AGENTS.md` remain the orchestration brain and guidance authority.',
270
- '- `docs/archive/` is the historical lane; archive content may describe removed surfaces but must not act as active onboarding.',
271
266
  '- `src/catalog/manifest.json`, `templates/catalog-manifest.json`, and `src/catalog/generated/public-catalog.json` are the catalog source/generated contract lane.',
272
267
  '- `dist/` is generated runtime output and should reflect the taxonomy, not redefine it.',
273
268
  '',
@@ -0,0 +1,42 @@
1
+ {
2
+ "providers": {
3
+ "openrouter": {
4
+ "base_url": "https://openrouter.ai/api/v1",
5
+ "api_format": "openai-compatible",
6
+ "env_key": "OPENROUTER_API_KEY",
7
+ "capabilities": [
8
+ "chat",
9
+ "reasoning"
10
+ ],
11
+ "label": "OpenRouter"
12
+ },
13
+ "anthropic_proxy": {
14
+ "base_url": "https://proxy.example.com/anthropic",
15
+ "api_format": "anthropic",
16
+ "env_key": "ANTHROPIC_PROXY_KEY",
17
+ "capabilities": [
18
+ "chat",
19
+ "long-context"
20
+ ],
21
+ "label": "Anthropic Proxy"
22
+ }
23
+ },
24
+ "routing": {
25
+ "default_provider": "openrouter",
26
+ "mode_providers": {
27
+ "forge": "openrouter",
28
+ "team": "anthropic_proxy"
29
+ },
30
+ "fallback_providers": [
31
+ "openrouter"
32
+ ],
33
+ "mode_fallback_providers": {
34
+ "forge": [
35
+ "openrouter",
36
+ "anthropic_proxy"
37
+ ]
38
+ },
39
+ "hot_swap": true,
40
+ "failover": true
41
+ }
42
+ }
@@ -0,0 +1,33 @@
1
+ # Roblox Reference Sources
2
+
3
+ Use this inventory when a Roblox task needs external grounding before implementation.
4
+
5
+ ## Official platform truth
6
+
7
+ - `https://github.com/Roblox/creator-docs`
8
+ - `https://gitmcp.io/Roblox/creator-docs`
9
+
10
+ ## Roblox implementation guidance
11
+
12
+ - `https://github.com/sentinelcore/roblox-skills`
13
+ - `https://gitmcp.io/sentinelcore/roblox-skills`
14
+ - `https://github.com/greedychipmunk/agent-skills/tree/main/roblox-game-developer`
15
+ - `https://github.com/omer-metin/skills-for-antigravity/tree/main/skills/roblox-development`
16
+ - `https://github.com/dig1t/skills`
17
+ - `https://github.com/Corecii/Devprod`
18
+ - `https://gitmcp.io/Corecii/Devprod`
19
+
20
+ ## Raw script / corpus support
21
+
22
+ - `https://github.com/retpirato/Roblox-Scripts`
23
+ - `https://gitmcp.io/retpirato/Roblox-Scripts`
24
+ - `https://gitmcp.io/frosteen/Roblox_LUA_Weapon_Scripts`
25
+ - `https://gitmcp.io/uhub/awesome-lua`
26
+ - `https://gitmcp.io/LewisJEllis/awesome-lua`
27
+ - `https://gitmcp.io/forhappy/awesome-lua`
28
+ - `http://lua-users.org/wiki/SampleCode`
29
+
30
+ Rules:
31
+ - official docs define correctness
32
+ - skill repos improve implementation awareness
33
+ - corpora are not trusted production code
@@ -1,15 +0,0 @@
1
- # Archive Docs
2
-
3
- This directory holds historical or migration-only collateral that is **not** part of the active
4
- RCS product surface.
5
-
6
- Archive docs may include:
7
- - migration changelogs
8
- - old release-body collateral
9
- - transitional QA snapshots
10
- - historical restructuring notes
11
-
12
- Rules:
13
- - do not use archive docs as active onboarding or canonical runtime guidance
14
- - if a file in `docs/archive/` is still needed by active runtime/code/tests, it should move back out
15
- - active source-of-truth docs stay under the main `docs/`, `docs/reference/`, `docs/contracts/`, and `docs/qa/` surfaces
@@ -1,90 +0,0 @@
1
- # Migration Guide: post-v0.4.4 mainline changes
2
-
3
- This guide covers migration from **v0.4.4** to the current mainline changes merged after it (including PR #137 and follow-up fixes).
4
-
5
- ## Who is affected
6
-
7
- You are affected if you:
8
-
9
- - invoke removed prompts or skills from old notes/scripts,
10
- - depend on pre-consolidation catalog names,
11
- - use `rcs setup` and need predictable install scope behavior,
12
- - run `rcs team`/tmux workflows and want the latest reliability fixes,
13
- - use notifier output and need verbosity control.
14
-
15
- ## What changed (high level)
16
-
17
- - Catalog consolidation for prompts/skills and cleanup of deprecated entries.
18
- - `rcs setup` now supports scope-aware install modes (`user`, `project`). Legacy `project-local` values are auto-migrated.
19
- - Spark worker routing added for team workers (`--spark`, `--madmax-spark`).
20
- - Notifier verbosity controls added.
21
- - tmux runtime hardening updates landed, including post-review pane capture/input hardening.
22
- - Stale references to removed `scientist`/`pipeline` were cleaned up.
23
-
24
- ## Removed prompts and skills
25
-
26
- ### Removed prompts
27
-
28
- - `deep-executor`
29
- - `scientist`
30
-
31
- ### Removed skills
32
-
33
- - `deepinit`
34
- - `learn-about-rcs`
35
- - `learner`
36
- - `pipeline`
37
- - `project-session-manager`
38
- - `psm`
39
- - `release`
40
- - `ultrapilot`
41
- - `writer-memory`
42
-
43
- ## Mapping old references to current ones
44
-
45
- Use these replacements in docs, scripts, and personal shortcuts.
46
-
47
- | Old reference | Use now | Notes |
48
- |---|---|---|
49
- | `/prompts:deep-executor` | `/prompts:executor` | `deep-executor` was a deprecated alias to executor behavior. |
50
- | `/prompts:scientist` | `/prompts:researcher` | Use researcher for research-focused workflows in current catalog. |
51
- | `$pipeline` | `$team` (or explicit `/prompts:*` sequencing) | Team is the default orchestrator pipeline surface. |
52
- | `$ultrapilot` | `$team` | Use team-based parallel orchestration. |
53
- | `$psm` / `$project-session-manager` | No in-repo replacement | Remove from automation or maintain out-of-tree tooling. |
54
- | `$release` | No in-repo replacement | Use your project release process directly. |
55
- | `$deepinit` | `rcs agents-init [path]` | Lightweight CLI successor for AGENTS.md bootstrap only; immediate child directories only, unmanaged files preserved unless `--force`. |
56
- | `$learn-about-rcs` / `$learner` / `$writer-memory` | No in-repo replacement | Remove stale references from workflows/docs. |
57
-
58
- ## Verification checklist after upgrade
59
-
60
- Run this checklist after pulling latest mainline:
61
-
62
- - [ ] Confirm removed references are gone from local notes/scripts:
63
- ```bash
64
- rg -n "deep-executor|scientist|pipeline|project-session-manager|\bpsm\b|ultrapilot|learn-about-rcs|writer-memory|learner|deepinit|\brelease\b" README.md docs scripts .rcs -S
65
- ```
66
- - [ ] Confirm current prompt catalog no longer contains removed prompts:
67
- ```bash
68
- ls prompts
69
- ```
70
- - [ ] Confirm current skill catalog no longer contains removed skills:
71
- ```bash
72
- ls skills
73
- ```
74
- - [ ] Validate setup scope options are available:
75
- ```bash
76
- rcs help | rg -e "--scope|project"
77
- ```
78
- - [ ] Validate team/tmux health checks:
79
- ```bash
80
- rcs doctor --team
81
- ```
82
- - [ ] If using spark worker routing, verify flags are available:
83
- ```bash
84
- rcs --help | rg "spark|madmax-spark"
85
- ```
86
-
87
- ## Related docs
88
-
89
- - Release notes: [CHANGELOG.md](../CHANGELOG.md)
90
- - Main overview: [README.md](../README.md)
@@ -1,141 +0,0 @@
1
- # Prompt Migration Changelog
2
-
3
- ## Scope
4
-
5
- - Migration window: `e21cb5e` -> `ff7ee14`
6
- - Surface: `prompts/*.md` (30 files)
7
- - Goal: document the prior XML-to-Markdown migration while reaffirming that prompt files remain the canonical XML-tagged subagent role surfaces for RCS.
8
-
9
- ## Global Changes (Applied to All Prompt Files)
10
-
11
- - Preserved frontmatter metadata (`description`, `argument-hint`).
12
- - Replaced wrapper tags such as `<Agent_Prompt>`, `<Role>`, `<Constraints>`, `<Output_Format>`, `<Final_Checklist>` with Markdown section headings.
13
- - Flattened nested XML-like sections into readable Markdown bullets/numbered steps.
14
- - Kept role semantics, tool usage intent, guardrails, and checklist expectations functionally equivalent.
15
- - Important current-state clarification: although the prompt text is now Markdown-first, each file in `prompts/*.md` is still the canonical XML-tagged subagent role surface consumed by RCS install/generation flows.
16
-
17
- ## Behavior Notes
18
-
19
- - No intentionally introduced functional behavior changes were made in this migration commit.
20
- - Behavior-relevant content (constraints, verification expectations, output templates) was preserved while syntax/formatting was normalized.
21
- - Any post-migration behavior differences are expected to come from readability and parser-compatibility improvements, not policy changes.
22
-
23
- ## Per-File Matrix
24
-
25
- | Prompt File | Added | Removed | Structural Highlights | Behavior Delta |
26
- |---|---:|---:|---|---|
27
- | `prompts/analyst.md` | 102 | 105 | XML-like wrapper blocks converted to Markdown section hierarchy; output/checklist sections normalized. | No intentional functional delta in migration commit. |
28
- | `prompts/architect.md` | 102 | 104 | XML-like wrapper blocks converted to Markdown section hierarchy; output/checklist sections normalized. | No intentional functional delta in migration commit. |
29
- | `prompts/build-fixer.md` | 81 | 84 | XML-like wrapper blocks converted to Markdown section hierarchy; output/checklist sections normalized. | No intentional functional delta in migration commit. |
30
- | `prompts/code-reviewer.md` | 98 | 100 | XML-like wrapper blocks converted to Markdown section hierarchy; output/checklist sections normalized. | No intentional functional delta in migration commit. |
31
- | `prompts/critic.md` | 79 | 82 | XML-like wrapper blocks converted to Markdown section hierarchy; output/checklist sections normalized. | No intentional functional delta in migration commit. |
32
- | `prompts/debugger.md` | 85 | 88 | XML-like wrapper blocks converted to Markdown section hierarchy; output/checklist sections normalized. | No intentional functional delta in migration commit. |
33
- | `prompts/deep-executor.md` | 105 | 107 | XML-like wrapper blocks converted to Markdown section hierarchy; output/checklist sections normalized. | No intentional functional delta in migration commit. |
34
- | `prompts/dependency-expert.md` | 91 | 94 | XML-like wrapper blocks converted to Markdown section hierarchy; output/checklist sections normalized. | No intentional functional delta in migration commit. |
35
- | `prompts/designer.md` | 96 | 98 | XML-like wrapper blocks converted to Markdown section hierarchy; output/checklist sections normalized. | No intentional functional delta in migration commit. |
36
- | `prompts/executor.md` | 92 | 94 | XML-like wrapper blocks converted to Markdown section hierarchy; output/checklist sections normalized. | No intentional functional delta in migration commit. |
37
- | `prompts/explore.md` | 104 | 107 | XML-like wrapper blocks converted to Markdown section hierarchy; output/checklist sections normalized. | No intentional functional delta in migration commit. |
38
- | `prompts/git-master.md` | 84 | 87 | XML-like wrapper blocks converted to Markdown section hierarchy; output/checklist sections normalized. | No intentional functional delta in migration commit. |
39
- | `prompts/planner.md` | 108 | 111 | XML-like wrapper blocks converted to Markdown section hierarchy; output/checklist sections normalized. | No intentional functional delta in migration commit. |
40
- | `prompts/researcher.md` | 88 | 91 | XML-like wrapper blocks converted to Markdown section hierarchy; output/checklist sections normalized. | No intentional functional delta in migration commit. |
41
- | `prompts/scientist.md` | 84 | 87 | XML-like wrapper blocks converted to Markdown section hierarchy; output/checklist sections normalized. | No intentional functional delta in migration commit. |
42
- | `prompts/security-reviewer.md` | 119 | 121 | XML-like wrapper blocks converted to Markdown section hierarchy; output/checklist sections normalized. | No intentional functional delta in migration commit. |
43
- | `prompts/test-engineer.md` | 96 | 98 | XML-like wrapper blocks converted to Markdown section hierarchy; output/checklist sections normalized. | No intentional functional delta in migration commit. |
44
- | `prompts/verifier.md` | 87 | 90 | XML-like wrapper blocks converted to Markdown section hierarchy; output/checklist sections normalized. | No intentional functional delta in migration commit. |
45
- | `prompts/vision.md` | 67 | 70 | XML-like wrapper blocks converted to Markdown section hierarchy; output/checklist sections normalized. | No intentional functional delta in migration commit. |
46
- | `prompts/writer.md` | 78 | 81 | XML-like wrapper blocks converted to Markdown section hierarchy; output/checklist sections normalized. | No intentional functional delta in migration commit. |
47
-
48
- ## Validation
49
-
50
- - Commit diff summary: `30 files changed, 2439 insertions(+), 2511 deletions(-)`
51
- - Spot-checks performed on role-heavy prompts (`planner`, `executor`, `explore`) confirmed semantic parity with formatting normalization.
52
-
53
- ---
54
-
55
- ## Orchestration Brain Migration (`AGENTS.md`, `templates/AGENTS.md`)
56
-
57
- ### Summary
58
-
59
- These files are the instruction root that RCS expects Codex to follow across a workspace.
60
- Changes here are primarily about aligning instructions with Codex CLI tool contracts.
61
-
62
- ### Key Deltas
63
-
64
- - Updated child-agent delegation guidance to reflect the Codex `spawn_agent` API:
65
- - Use `spawn_agent(message: "<role prompt>\n\nTask: ...")` conventions.
66
- - Removed legacy "instructions" phrasing.
67
- - Expanded MCP tooling catalog and mode lifecycle expectations so orchestrators can use the full MCP surface correctly.
68
- - `templates/AGENTS.md` header normalized to match `AGENTS.md` and removed the non-compliant template opener.
69
-
70
- ### Diff Stats
71
-
72
- | File | Added | Removed | Notes |
73
- |---|---:|---:|---|
74
- | `AGENTS.md` | 42 | 10 | Tooling + delegation guidance expanded; semantics preserved. |
75
- | `templates/AGENTS.md` | 7 | 7 | Header/tone normalized; still intended as a template copy. |
76
-
77
- ### Unified Guidance Schema Follow-Up (AGENTS + Runtime/Worker Alignment)
78
-
79
- - Added canonical schema document: `docs/guidance-schema.md`.
80
- - Added explicit schema-contract sections to:
81
- - `AGENTS.md`
82
- - `templates/AGENTS.md`
83
- - Normalized worker task guidance in `AGENTS.md` runtime worker overlay:
84
- - file path now uses `tasks/task-<id>.json`
85
- - API id rule now explicitly requires bare id `task_id: "<id>"` (never `"task-<id>"`).
86
- - Marker contracts remain unchanged:
87
- - `<!-- RCS:RUNTIME:START --> ... <!-- RCS:RUNTIME:END -->`
88
- - `<!-- RCS:TEAM:WORKER:START --> ... <!-- RCS:TEAM:WORKER:END -->`
89
-
90
- Behavior note: this follow-up is additive and wording-focused; no task-state model or MCP API contract changes were introduced.
91
-
92
- ---
93
-
94
- ## Skill Prompt Migration (`skills/*/SKILL.md`)
95
-
96
- ### Summary
97
-
98
- Skill docs are operational runbooks. The migration focused on:
99
- - Removing Claude-era paths/terminology
100
- - Aligning config guidance with Codex-first paths (`~/.codex/…`, `CODEX_HOME`)
101
- - Preserving each skill's contract/intent while improving correctness for Codex CLI users
102
-
103
- ### Behavior Notes
104
-
105
- - These are documentation / instruction changes; they do not directly change runtime logic.
106
- - One meaningful correction was made: the "agent teams" enablement guidance in `skills/rcs-setup/SKILL.md` was updated to enable Codex features via `~/.codex/config.toml` rather than legacy `settings.json` env vars.
107
-
108
- ### Per-File Matrix
109
-
110
- | Skill File | Added | Removed | Structural Highlights | Behavior Delta |
111
- |---|---:|---:|---|---|
112
- | `skills/analyze/SKILL.md` | 1 | 1 | Codex path/terminology normalization; examples updated to Codex-first conventions. | No direct runtime behavior change; instruction correctness improved. |
113
- | `skills/autopilot/SKILL.md` | 11 | 16 | Codex path/terminology normalization; examples updated to Codex-first conventions. | No direct runtime behavior change; instruction correctness improved. |
114
- | `skills/code-review/SKILL.md` | 1 | 1 | Codex path/terminology normalization; examples updated to Codex-first conventions. | No direct runtime behavior change; instruction correctness improved. |
115
- | `skills/configure-notifications/SKILL.md` | 0 | 0 | Canonical notification setup skill replacing standalone configure-* variants. | Catalog/install surface now converges on one entry point. |
116
- | `skills/doctor/SKILL.md` | 47 | 45 | Codex path/terminology normalization; examples updated to Codex-first conventions. | No direct runtime behavior change; instruction correctness improved. |
117
- | `skills/ecomode/SKILL.md` | 1 | 1 | Codex path/terminology normalization; examples updated to Codex-first conventions. | No direct runtime behavior change; instruction correctness improved. |
118
- | `skills/help/SKILL.md` | 1 | 1 | Codex path/terminology normalization; examples updated to Codex-first conventions. | No direct runtime behavior change; instruction correctness improved. |
119
- | `skills/learner/SKILL.md` | 5 | 5 | Codex path/terminology normalization; examples updated to Codex-first conventions. | No direct runtime behavior change; instruction correctness improved. |
120
- | `skills/rcs-setup/SKILL.md` | 144 | 156 | Codex path/terminology normalization; examples updated to Codex-first conventions. | No direct runtime behavior change; instruction correctness improved. |
121
- | `skills/plan/SKILL.md` | 1 | 1 | Codex path/terminology normalization; examples updated to Codex-first conventions. | No direct runtime behavior change; instruction correctness improved. |
122
- | `skills/project-session-manager/SKILL.md` | 5 | 5 | Codex path/terminology normalization; examples updated to Codex-first conventions. | No direct runtime behavior change; instruction correctness improved. |
123
- | `skills/release/SKILL.md` | 3 | 3 | Codex path/terminology normalization; examples updated to Codex-first conventions. | No direct runtime behavior change; instruction correctness improved. |
124
- | `skills/research/SKILL.md` | 10 | 15 | Codex path/terminology normalization; examples updated to Codex-first conventions. | No direct runtime behavior change; instruction correctness improved. |
125
- | `skills/security-review/SKILL.md` | 1 | 1 | Codex path/terminology normalization; examples updated to Codex-first conventions. | No direct runtime behavior change; instruction correctness improved. |
126
- | `skills/skill/SKILL.md` | 20 | 20 | Codex path/terminology normalization; examples updated to Codex-first conventions. | No direct runtime behavior change; instruction correctness improved. |
127
- | `skills/tdd/SKILL.md` | 1 | 1 | Codex path/terminology normalization; examples updated to Codex-first conventions. | No direct runtime behavior change; instruction correctness improved. |
128
- | `skills/ultrapilot/SKILL.md` | 11 | 16 | Codex path/terminology normalization; examples updated to Codex-first conventions. | No direct runtime behavior change; instruction correctness improved. |
129
- | `skills/writer-memory/SKILL.md` | 1 | 1 | Codex path/terminology normalization; examples updated to Codex-first conventions. | No direct runtime behavior change; instruction correctness improved. |
130
-
131
- ### Hotspots Worth Reviewing
132
-
133
- - `skills/rcs-setup/SKILL.md`: largest edit surface; includes team enablement guidance (`~/.codex/config.toml` `[features]` flags) and teammate display preference storage (`~/.codex/.rcs-config.json`).
134
- - `skills/doctor/SKILL.md`: updated hook/config inspection language; still contains optional legacy remediation guidance.
135
- - `skills/autopilot/SKILL.md`, `skills/research/SKILL.md`, `skills/ultrapilot/SKILL.md`: config examples updated to TOML.
136
-
137
- ## Follow-up Classification Notes
138
-
139
- - `prompts/*.md` should be treated as the canonical source set for XML-tagged subagent role prompts, even when install/runtime layers wrap them in TOML or other launcher-specific envelopes.
140
- - `prompts/sisyphus-lite.md` is intentionally classified as a specialized worker behavior prompt. It is not part of the primary public role catalog alongside prompts such as `executor`, `planner`, or `architect`.
141
- - Team worker/runtime overlays may borrow Sisyphus-lite behavior patterns, but that does not promote it to a first-class routed role.
@@ -1,85 +0,0 @@
1
- # QA Plan — v0.4.2 (dev vs deployed main)
2
-
3
- Date: 2026-02-18
4
- Scope: validate delta between `origin/main` (deployed, `v0.4.1`) and current `dev`.
5
-
6
- ## 1) Parity Validation Summary
7
-
8
- Run:
9
-
10
- ```bash
11
- git fetch origin --prune
12
- git rev-list --left-right --count origin/main...dev
13
- git log --oneline origin/main..dev
14
- git diff --name-status origin/main...dev
15
- ```
16
-
17
- Expected at time of writing:
18
- - `origin/main` is deployed at `v0.4.1`.
19
- - `dev` is ahead with feature/fix/test commits (auto-nudge improvements, all-workers-idle leader notification, tmux input/scrolling fixes, and coverage expansion).
20
- - No non-merge functional commits were found on `main` that are missing from `dev`.
21
-
22
- ## 2) Risk-Based Focus Areas
23
-
24
- 1. **Notify hook behavior**
25
- - Expanded stall phrase detection and new hot-zone detection logic.
26
- - All-workers-idle leader notification with cooldown/event logging.
27
- 2. **Tmux team UX/reliability**
28
- - Mouse scrolling enabled by default for team sessions.
29
- - `sendToWorker` timing changes around submit rounds.
30
- 3. **Config compatibility**
31
- - `collab` -> `multi_agent` migration in generated config + tests/docs.
32
- 4. **Lifecycle/process handling**
33
- - `bin/rcs.js` now awaits `main(...)` and exits explicitly.
34
-
35
- ## 3) Automated QA
36
-
37
- ```bash
38
- npm run test:run
39
- ```
40
-
41
- Pass criteria:
42
- - Full suite passes.
43
- - New/updated suites specifically pass:
44
- - `src/hooks/__tests__/notify-hook-all-workers-idle.test.ts`
45
- - `src/hooks/__tests__/notify-hook-auto-nudge.test.ts`
46
- - `src/team/__tests__/tmux-session.test.ts`
47
- - `src/config/__tests__/generator-notify.test.ts`
48
- - newly added extensibility/HUD/utils/verifier test files
49
-
50
- ## 4) Manual QA Checklist
51
-
52
- ### A. All workers idle notification
53
- - Start a team session with >=2 workers.
54
- - Let all workers transition to `idle` or `done`.
55
- - Verify leader receives one idle-summary prompt.
56
- - Re-trigger within cooldown window: verify no duplicate notification spam.
57
- - Verify event/log entries are emitted.
58
-
59
- ### B. Auto-nudge pattern detection
60
- - Feed outputs containing new phrases (e.g., "say go", "next I can", "keep driving").
61
- - Verify stall detection triggers in the last-lines hot zone.
62
- - Verify unrelated text does not false-trigger.
63
-
64
- ### C. Tmux input reliability + mouse scrolling
65
- - In team mode, verify mouse wheel scrolls pane history.
66
- - Confirm arrow keys still work for CLI input history.
67
- - Send repeated worker prompts and verify submission consistency.
68
- - Set `RCS_TEAM_MOUSE=0`, restart session, verify mouse mode is not forcibly enabled.
69
-
70
- ### D. Config generator migration
71
- - Run setup/generator path on fresh and existing configs.
72
- - Verify `[features]` includes `multi_agent = true` and `child_agents_md = true`.
73
- - Verify deprecated `collab` key is not reintroduced.
74
-
75
- ### E. `/exit` process termination
76
- - Launch `rcs` and invoke `/exit`.
77
- - Verify process exits cleanly without hanging.
78
-
79
- ## 5) Release Gate
80
-
81
- Release is approved only if:
82
- - [ ] Automated tests pass.
83
- - [ ] Manual checklist A–E passes.
84
- - [ ] Changelog entry matches shipped behavior.
85
- - [ ] Version is bumped consistently (`package.json`, `package-lock.json`).
@@ -1,55 +0,0 @@
1
- # QA Execution Report — v0.4.2
2
-
3
- Date: 2026-02-18
4
-
5
- ## Team Execution
6
-
7
- - Team run executed via `$team`.
8
- - Initial stale workers were detected and cleaned (`%1749`, `%1750` panes removed).
9
- - QA team completed with all tasks terminal (`completed=3, failed=0`) and was shut down cleanly.
10
-
11
- ## Parity Validation (deployed `main` vs `dev`)
12
-
13
- Commands:
14
-
15
- ```bash
16
- git rev-list --left-right --count origin/main...dev
17
- git rev-list --left-right --count --no-merges origin/main...dev
18
- git log --oneline --no-merges dev..origin/main
19
- ```
20
-
21
- Result:
22
- - Merge-aware divergence: `6 18`
23
- - Non-merge divergence: `0 15`
24
- - No non-merge commits on `main` missing from `dev`.
25
-
26
- ## Automated QA
27
-
28
- Command executed:
29
-
30
- ```bash
31
- npm test
32
- ```
33
-
34
- Result:
35
- - PASS — `664` tests passed, `0` failed.
36
-
37
- Notes:
38
- - `npm run test:run` is referenced in the QA plan but is not a script in current `package.json`.
39
-
40
- ## Release-Metadata Checks
41
-
42
- - `package.json` version: `0.4.2`
43
- - `package-lock.json` version: `0.4.2`
44
- - `CHANGELOG.md` contains `## [0.4.2] - 2026-02-18`
45
-
46
- ## Manual QA Checklist (A–E)
47
-
48
- - A/B/C/E require interactive runtime validation and were only partially validated through automated tests + code-path checks in this execution.
49
- - D (config migration) covered by automated tests (`generator-notify` + config generator suite) and passed.
50
-
51
- ## Overall
52
-
53
- - Automated quality gate: **PASS**
54
- - Parity validation gate: **PASS**
55
- - Manual interactive gate: **PARTIAL (requires explicit interactive pass if required before release)**
@@ -1,86 +0,0 @@
1
- # RCS v0.9.0
2
-
3
- <p align="center">
4
- <img src="./shared/rcs-character-spark-initiative.jpg" alt="RCS character sparked for the Spark Initiative" width="720">
5
- </p>
6
-
7
- `0.9.0` is the Spark Initiative release: RCS now has a stronger native fast path for repository discovery, shell-native inspection, and cross-platform native distribution.
8
-
9
- ## Highlights
10
-
11
- ### `rcs explore`
12
-
13
- - adds a dedicated read-only exploration entrypoint
14
- - uses a Rust-backed explore harness
15
- - keeps shell-native exploration constrained, allowlisted, and read-only
16
- - supports packaged native resolution plus source/repo-local fallback paths
17
-
18
- ### `rcs sparkshell`
19
-
20
- - adds an operator-facing native shell sidecar
21
- - supports direct command execution
22
- - summarizes long output into compact sections
23
- - supports explicit tmux-pane summarization:
24
-
25
- ```bash
26
- rcs sparkshell --tmux-pane %12 --tail-lines 400
27
- ```
28
-
29
- ### Explore ↔ sparkshell integration
30
-
31
- - qualifying read-only shell-native `rcs explore` prompts can route through `rcs sparkshell`
32
- - fallback behavior remains explicit and hardened
33
- - guidance/docs/tests were aligned around this contract
34
-
35
- ### Worker follow-through polish
36
-
37
- - worker mailbox guidance now asks for concrete progress updates without implying work should stop after replying
38
- - inbox/mailbox trigger wording now tells workers to continue assigned or next feasible work after reporting status
39
- - runtime/bootstrap wording and associated tests were aligned around this behavior
40
-
41
- ### Release pipeline upgrades
42
-
43
- - cross-platform native publishing for:
44
- - `rcs-explore-harness`
45
- - `rcs-sparkshell`
46
- - native release manifest generation with per-target metadata
47
- - packed-install smoke verification in the release workflow
48
- - `build:full` validated as the one-shot release-oriented build path
49
-
50
- ## Important Spark Initiative notes
51
-
52
- - Users can install RCS normally with `npm install -g @jstn-sdk/rcs`.
53
- - The npm tarball intentionally excludes staged cross-platform native binaries.
54
- - Tagged releases publish verified native archives for `rcs-explore-harness` and `rcs-sparkshell`.
55
- - Packaged installs hydrate the matching native binary through `native-release-manifest.json`.
56
- - CI now hardens the Rust path with explicit toolchain setup, `cargo fmt --all --check`, and `cargo clippy --workspace --all-targets -- -D warnings`.
57
-
58
- ## Upgrade note
59
-
60
- If you use project-scoped RCS installs, rerun:
61
-
62
- ```bash
63
- rcs setup --force --scope project
64
- ```
65
-
66
- after upgrading so managed config/native-agent paths are refreshed.
67
-
68
- ## Local release verification summary
69
-
70
- Validated locally on `dev` before tagging:
71
-
72
- - `node scripts/check-version-sync.mjs --tag v0.9.0`
73
- - `npm run lint`
74
- - `npx tsc --noEmit`
75
- - `npm run check:no-unused`
76
- - `npm test`
77
- - `npm run build:full`
78
- - `npm run test:explore`
79
- - `npm run test:sparkshell`
80
- - `node bin/rcs.js doctor`
81
- - `node bin/rcs.js setup --dry-run`
82
- - `npm pack --dry-run`
83
-
84
- ## Historical note
85
-
86
- This archived release note is retained for product history, but current first-party release ownership lives on the current RCS repository and package coordinates.
@@ -1,41 +0,0 @@
1
- # RCS v0.9.1
2
-
3
- <p align="center">
4
- <img src="./shared/rcs-character-spark-initiative.jpg" alt="RCS character sparked for the Spark Initiative" width="720">
5
- </p>
6
-
7
- `0.9.1` is a targeted Spark Initiative hotfix release.
8
-
9
- ## Why this release exists
10
-
11
- - `v0.9.0` remains historically red.
12
- - The required packed-install smoke hydration fix landed in the post-0.9.0 line and is reflected here as the superseding hotfix cut.
13
- - `v0.9.1` is the clean superseding release cut from `main` with that fix applied.
14
-
15
- ## Included fix
16
-
17
- ### Localize smoke hydration assets
18
-
19
- The packed-install smoke workflow now copies and resolves hydration assets from the local smoke workspace so release verification matches packaged-install behavior more reliably.
20
-
21
- Changed files:
22
- - `scripts/smoke-packed-install.mjs`
23
- - `scripts/__tests__/smoke-packed-install.test.mjs`
24
-
25
- ## Local release verification summary
26
-
27
- Planned local release-critical validation for `0.9.1`:
28
-
29
- - `node scripts/check-version-sync.mjs --tag v0.9.1`
30
- - `npm run lint`
31
- - `npx tsc --noEmit`
32
- - `npm run check:no-unused`
33
- - `npm test`
34
- - `node --test scripts/__tests__/smoke-packed-install.test.mjs`
35
- - `npm run build:full`
36
- - `npm run smoke:packed-install`
37
- - `npm pack --dry-run`
38
-
39
- ## Historical note
40
-
41
- `v0.9.0` remains historically red; `v0.9.1` is the clean superseding release.
@@ -1,38 +0,0 @@
1
- # Issue Draft: Make `blueprint` first-class for `team` follow-up planning
2
-
3
- ## Title
4
- [Feature] Make `blueprint` emit explicit `team` follow-up guidance (for example `--followup team`)
5
-
6
- ## Problem
7
- RCS already has the ingredients for a strong high-control workflow: `blueprint` for scoped planning and `team` for durable multi-worker execution with its own verification lanes. What is still under-explained and under-productized is the handoff between planning and team execution.
8
-
9
- Today, experienced users can manually infer the pattern: run `blueprint`, then launch `team`, and let team own delivery plus verification unless a later single-owner follow-up is genuinely needed. The workflow's biggest advantage is not just parallelism. It is coordinated execution: teammates can surface blockers early, redistribute work, and stay inspectable through panes plus runtime state. That benefit should be reflected directly in planning output.
10
-
11
- ## Proposed solution
12
- Teach `blueprint` to support an explicit team-oriented follow-up mode, such as `--followup team`, that produces:
13
-
14
- 1. a normal implementation plan and acceptance criteria
15
- 2. recommended worker lanes / role allocation
16
- 3. suggested reasoning levels by lane
17
- 4. explicit follow-up commands or launch hints for `rcs team` / `$team`
18
- 5. verification expectations that fit a standalone `team` execution path, plus optional later Forge follow-up guidance only when needed
19
-
20
- This would make the intended workflow clearer:
21
-
22
- ```text
23
- blueprint -> team
24
- ```
25
-
26
- ## Why this is good
27
- - Clarifies why `team` exists alongside `ultrawork`: team mode is about coordination and runtime control, not only fanout.
28
- - Reduces the gap between planning output and actual coordination flow.
29
- - Makes one of RCS's strongest workflows more discoverable for advanced users.
30
- - Improves execution quality on runtime-edge-case and workflow-edge-case work, where durable coordination matters more than raw task splitting.
31
- - Fits RCS's architecture well because the runtime already supports worker roles, mixed CLIs, runtime state, and inspectable team lifecycle commands.
32
-
33
- ## Alternatives considered
34
- - Keep the pattern implicit in docs only. This helps discovery, but still leaves users to translate plans into worker lanes manually.
35
- - Fold everything into `autopilot`. Useful for default automation, but weaker for users who want direct control over planning, staffing, and verification.
36
-
37
- ## Additional context
38
- Expected user outcome: a user runs `blueprint`, sees a plan that is already shaped for team execution, launches `team` with less guesswork, and only escalates to `forge` later if a persistent single-owner follow-up is still needed after team execution.