berkus
/
wifi-densepose
mirror of https://github.com/ruvnet/wifi-densepose.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
wifi-densepose/plugins/ruview/codex
History
ruv 4557f6f614 docs+plugins: rvAgent + RVF agentic-flow integration exploration 
Land the rvAgent (vendor/ruvector/crates/rvAgent/) integration research
dossier and update both the Claude Code and Codex plugins so future
operators have a discoverable entry point for prototyping agentic flows
on top of RuView's existing sensing pipeline + RVF cognitive containers.

Added:
- docs/research/rvagent-rvf-integration/README.md
  Full integration thesis: rvAgent's 8 crates + 14 middlewares share
  RVF as their state-persistence format with RuView's existing
  v2/crates/wifi-densepose-sensing-server/src/rvf_container.rs. Three
  shippable touchpoints (each independent):
    1. Two new RVF segment types (SEG_AGENT_STATE = 0x08,
       SEG_DECISION = 0x09) so rvAgent sessions and RuView sensing
       sessions interleave in one witness-bundle-attestable blob
    2. BfldEvent → ToolOutput shim — agent reads BFLD events as
       tool context with no new IPC
    3. cog-* subagent registration under a queen-agent router
  Open questions: workspace inclusion path, sync/async adapter
  placement, privacy-class composition with rvagent-middleware
  sanitizer, Soul Signature ↔ SoulMatchOracle bridge, MCP surface.
  Proposed next: ADR-124 before scaffolding wifi-densepose-agent.

- plugins/ruview/skills/ruview-rvagent/SKILL.md
  New Claude Code skill exposing the integration surface, links to
  the research doc, and lists the three shippable touchpoints. Skill
  description tuned so Claude auto-discovers it for queries like
  "wire rvAgent into RuView" or "operator agent reacting to BFLD."

- plugins/ruview/codex/prompts/ruview-rvagent.md
  Codex counterpart prompt with trigger phrasing, reading order,
  same three touchpoints + open questions, and the ADR-124 next step.

Modified:
- plugins/ruview/.claude-plugin/plugin.json
  Version 0.1.0 → 0.2.0; description extended to mention "BFLD
  privacy layer" and "rvAgent + RVF agentic flows".

- plugins/ruview/codex/AGENTS.md
  Prompt table grows one row: `ruview-rvagent` for the new prompt.

No code changes; no test impact.

Co-Authored-By: claude-flow <ruv@ruv.net>
 		2026-05-24 17:33:12 -04:00
..
prompts docs+plugins: rvAgent + RVF agentic-flow integration exploration 2026-05-24 17:33:12 -04:00
AGENTS.md docs+plugins: rvAgent + RVF agentic-flow integration exploration 2026-05-24 17:33:12 -04:00
README.md feat(plugins): RuView Claude Code + Codex marketplace plugin 2026-05-11 17:39:16 -04:00

README.md

RuView prompts for Codex (OpenAI CLI)

This directory mirrors the Claude Code ruview plugin's operator commands as Codex prompts, plus an AGENTS.md carrying the RuView project rules.

Contents

File Purpose
AGENTS.md Project rules — repo layout, hard rules, build/test, ESP32 firmware on Windows, witness verification
prompts/ruview-start.md Onboarding — Docker demo / repo build / live ESP32
prompts/ruview-flash.md Build + flash ESP32 firmware (8MB / 4MB)
prompts/ruview-provision.md Provision WiFi creds + sink IP + channel/MAC overrides
prompts/ruview-app.md Run a sensing application (presence / vitals / pose / sleep / MAT / point cloud)
prompts/ruview-train.md Train / evaluate / publish a model (incl. GPU on GCloud)
prompts/ruview-advanced.md Multistatic / tomography / cross-viewpoint / field-model / mesh-security
prompts/ruview-verify.md Run the trust pipeline + pre-merge checklist

Prompt parity with the Claude Code plugin is enforced by plugins/ruview/scripts/smoke.sh (every commands/<name>.md must have a matching codex/prompts/<name>.md).

Install

Per-user prompts — copy the prompt files into Codex's prompt directory:

mkdir -p ~/.codex/prompts
cp plugins/ruview/codex/prompts/*.md ~/.codex/prompts/
# now in the codex TUI:  /ruview-start   /ruview-flash   /ruview-app   /ruview-train   /ruview-verify   /ruview-advanced

Project rules — point Codex at the AGENTS.md. Codex auto-discovers an AGENTS.md at the repo root and in the working directory; either symlink it or copy it:

ln -s plugins/ruview/codex/AGENTS.md AGENTS.md          # repo root (if you don't already have one)
# — or, if a root AGENTS.md exists, append the relevant sections from plugins/ruview/codex/AGENTS.md

Config (optional) — to keep prompts in-repo instead of ~/.codex/prompts, add to ~/.codex/config.toml:

# Codex reads prompts from ~/.codex/prompts by default; symlinking keeps them versioned with the repo:
#   ln -s "$PWD/plugins/ruview/codex/prompts" ~/.codex/prompts/ruview   (then prompts appear as /ruview/ruview-start, etc.)

Notes

  • The Codex mirror is the operator-facing subset — the seven /ruview-* commands. The Claude Code plugin additionally ships skills (ruview-quickstart, ruview-hardware-setup, ruview-configure, ruview-applications, ruview-model-training, ruview-advanced-sensing, ruview-cli-api, ruview-mmwave, ruview-verify) and agents (ruview-onboarding-guide, ruview-config-engineer, ruview-training-engineer) that have no Codex equivalent — their content is folded into AGENTS.md and the prompt files.
  • On Windows, ESP-IDF firmware builds go through the Python-subprocess pattern documented in CLAUDE.local.md (Git Bash / MSYS2 is not supported by ESP-IDF v5.4). Default ESP32 serial port: COM8.