feat: RP agent_run pipeline, ADR/spec commands, shared RP orchestration, context eng, skill expansions (v0.1.49)

Major changes:
- RP agent_run pipeline integration for worker spawning
- New /flow-code:adr and /flow-code:spec commands
- Shared RP/MCP orchestration guide (_shared/rp-mcp-orchestration.md)
- Context engineering skill for token management
- Expanded brainstorm, export-context, rp-explorer, run skills
- Numerous flowctl core+CLI improvements across 34K lines of Rust
- Version bump 0.1.48 → 0.1.49

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: z23cc

.agents/plugins/marketplace.json

@@ -8,7 +8,7 @@
       "name": "flow-code",
       "source": {
         "source": "local",
-        "path": "./plugins/flow-code"
+        "path": "../../"
       },
       "policy": {
         "installation": "AVAILABLE",

.claude-plugin/flowctl-version

@@ -1 +1 @@
-v0.1.33
+v0.1.49

.claude-plugin/marketplace.json

@@ -6,13 +6,13 @@
   },
   "metadata": {
     "description": "Structured plan-first development plugin for Claude Code with .flow/ task tracking, Agent Teams, and Ralph autonomous mode",
-    "version": "0.1.47"
+    "version": "0.1.49"
   },
   "plugins": [
     {
       "name": "flow-code",
-      "description": "Zero-dependency planning + execution with .flow/ task tracking. Three-layer quality (guard + RP plan-review + Codex adversarial). Full-auto, zero questions. Teams auto-parallel, DAG mutation, Codex-driven decisions, auto draft-PR, session summary. 5 prompt templates. 24 subagents, 22 commands, 74 skills.",
-      "version": "0.1.47",
+      "description": "Zero-dependency planning + execution with .flow/ task tracking. Three-layer quality (guard + RP plan-review + Codex adversarial). Full-auto, zero questions. Teams auto-parallel, DAG mutation, Codex-driven decisions, auto draft-PR, session summary. 5 prompt templates plus dedicated subagents, slash commands, and skills.",
+      "version": "0.1.49",
       "source": "./",
       "category": "workflow",
       "tags": [
@@ -26,5 +26,5 @@
       "strict": true
     }
   ],
-  "version": "0.1.47"
+  "version": "0.1.49"
 }

.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "flow-code",
-  "version": "0.1.48",
-  "description": "Zero-dependency planning + execution with .flow/ task tracking and Ralph autonomous mode (multi-model review gates). Worker subagent per task with git worktree isolation for parallel execution. Three-layer quality system (guard + RP plan-review + Codex adversarial). Full-auto by default — AI decides from context, zero questions. Teams-default with file locking, DAG mutation, Codex-driven conflict resolution, auto draft-PR. Auto-detected stack profiles with one-command guard (test/lint/typecheck). Enhanced agent definitions with permissionMode/maxTurns/effort. Lifecycle hooks with state preservation (PreCompact injects .flow state into compaction, TaskCompleted auto-unlocks files, SubagentStart context injection). Memory v2 with atomic entries, dedup, and progressive disclosure. TDD enforcement mode. Multi-epic queue with dependency visualization. Includes 24 subagents, 22 commands, 74 skills.",
+  "version": "0.1.49",
+  "description": "Zero-dependency planning + execution with .flow/ task tracking and Ralph autonomous mode (multi-model review gates). Worker subagent per task with git worktree isolation for parallel execution. Three-layer quality system (guard + RP plan-review + Codex adversarial). Full-auto by default — AI decides from context, zero questions. Teams-default with file locking, DAG mutation, Codex-driven conflict resolution, auto draft-PR. Auto-detected stack profiles with one-command guard (test/lint/typecheck). Enhanced agent definitions with permissionMode/maxTurns/effort. Lifecycle hooks with state preservation (PreCompact injects .flow state into compaction, TaskCompleted auto-unlocks files, SubagentStart context injection). Memory v2 with atomic entries, dedup, and progressive disclosure. TDD enforcement mode. Multi-epic queue with dependency visualization. Includes dedicated subagents, slash commands, and skills for planning, execution, review, and autonomous operation.",
   "author": {
     "name": "z23cc",
     "url": "https://github.com/z23cc"

.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "flow-code",
-  "version": "0.1.47",
+  "version": "0.1.49",
   "description": "Zero-dependency planning + execution with .flow/ task tracking and Ralph autonomous mode (multi-model review gates). Worker subagent per task with git worktree isolation for parallel execution. Three-layer quality system (guard + RP plan-review + Codex adversarial). Full-auto by default. Teams-default with file locking, DAG mutation, Codex-driven conflict resolution, auto draft-PR.",
   "author": {
     "name": "z23cc",
@@ -21,7 +21,7 @@
   "interface": {
     "displayName": "Flow-Code",
     "shortDescription": "Plan-first workflow with subagent execution",
-    "longDescription": "Structured plan-first workflow engine. Tracks epics and tasks in .flow/ directory. Spawns isolated worker subagents per task. Ralph mode enables fully autonomous execution with multi-model review gates. 24 subagents, 22 commands, 74 skills.",
+    "longDescription": "Structured plan-first workflow engine. Tracks epics and tasks in .flow/ directory. Spawns isolated worker subagents per task. Ralph mode enables fully autonomous execution with multi-model review gates. Includes dedicated subagents, slash commands, and skills for planning, execution, review, and autonomous operation.",
     "developerName": "z23cc",
     "category": "Productivity",
     "capabilities": [

.github/workflows/ci.yml

@@ -7,13 +7,25 @@ on:
       - "flowctl/**"
       - "scripts/**"
       - "hooks/**"
+      - ".claude-plugin/**"
+      - ".codex-plugin/**"
+      - ".agents/plugins/marketplace.json"
+      - "README.md"
+      - "README_CN.md"
+      - "CHANGELOG.md"
       - ".github/workflows/ci.yml"
   pull_request:
     branches: [main]
     paths:
       - "flowctl/**"
       - "scripts/**"
       - "hooks/**"
+      - ".claude-plugin/**"
+      - ".codex-plugin/**"
+      - ".agents/plugins/marketplace.json"
+      - "README.md"
+      - "README_CN.md"
+      - "CHANGELOG.md"
       - ".github/workflows/ci.yml"
 
 env:
@@ -42,6 +54,13 @@ jobs:
         run: |
           python3 -c "import json; json.load(open('hooks/hooks.json'))"
           python3 -c "import json; json.load(open('.claude-plugin/plugin.json'))"
+          python3 -c "import json; json.load(open('.claude-plugin/marketplace.json'))"
+          python3 -c "import json; json.load(open('.codex-plugin/plugin.json'))"
+          python3 -c "import json; json.load(open('.agents/plugins/marketplace.json'))"
+
+      - name: Release surface preflight
+        working-directory: .
+        run: bash scripts/check-release-surface.sh
 
       - name: Install Rust toolchain
         uses: dtolnay/rust-toolchain@stable

.github/workflows/release.yml

@@ -16,8 +16,30 @@ defaults:
     working-directory: flowctl
 
 jobs:
+  preflight:
+    name: Release preflight
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Check release surface parity
+        working-directory: .
+        run: bash scripts/check-release-surface.sh
+
+      - name: Ensure tag matches manifest version
+        working-directory: .
+        shell: bash
+        run: |
+          tag_version="${GITHUB_REF_NAME#v}"
+          manifest_version="$(awk -F'\"' '/^version = /{print $2; exit}' flowctl/crates/flowctl-cli/Cargo.toml)"
+          if [[ "$tag_version" != "$manifest_version" ]]; then
+            echo "Tag version v$tag_version does not match manifest version v$manifest_version" >&2
+            exit 1
+          fi
+
   build:
     name: Build ${{ matrix.target }}
+    needs: preflight
     runs-on: ${{ matrix.os }}
     strategy:
       fail-fast: false
@@ -104,7 +126,7 @@ jobs:
 
   release:
     name: Create GitHub Release
-    needs: build
+    needs: [preflight, build]
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4

CHANGELOG.md

@@ -4,6 +4,21 @@ All notable changes to Flow-Code are documented in this file.
 
 Format follows [Keep a Changelog](https://keepachangelog.com/). Versions use [Semantic Versioning](https://semver.org/).
 
+## [0.1.49] - 2026-04-10
+
+### Changed
+- RP agent_run pipeline integration, ADR/spec commands, shared RP orchestration guide, context engineering, skill expansions, and numerous flowctl improvements across core+CLI crates.
+
+## [0.1.48] - 2026-04-10
+
+### Fixed
+- Aligned release/install version metadata across Cargo, Claude plugin manifests, Codex plugin manifest, and `flowctl-version` pin.
+- Corrected stale local marketplace source path to point at this repository root.
+- Updated `flowctl/README.md` repository/install links and architecture description to match the current workspace.
+
+### Changed
+- Added CI/release preflight checks for version parity and install-surface drift (`scripts/check-release-surface.sh`).
+
 ## [0.1.46] - 2026-04-09
 
 ### Added