# Changelog — @lifeai/rdc-skills All notable changes to this project will be documented in this file. The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). --- ## v0.21.0 — channel-formatter skill ### Added - `rdc:channel-formatter` — channel-native output formatting for LinkedIn, Twitter/X, Slack/Teams, Email (external/internal), Pitch Deck, Word/DOCX, PDF Report, and Web/Landing Page. Ported from the `output-channel-formatter` claude.ai skill and **inlined into a single self-contained SKILL.md** (no `references/` files) so it works identically across the CLI plugin, the claude.ai web client (via `rdc_skill_get`, which serves only SKILL.md), and Codex. --- ## v0.9.38 — Clean-box npm install hardening ### Fixed - **Fresh Claude home install.** The installer now creates `CLAUDE_HOME` and `settings.json` when they do not exist, so a first-time machine is not blocked before Claude has written config files. - **Public package portability.** Removed the most brittle user-machine paths from public skill docs and hooks, replacing them with `{PROJECT_ROOT}`, `{RDC_SKILLS_ROOT}`, or environment-derived paths. - **Hook path fallback.** Commit hygiene hooks now use the current OS home directory instead of a user-specific fallback path. ### Added - **npm binaries.** `rdc-skills-install` and `rdc-skills-self-test` are exposed from the npm package for simpler clean-box installs. --- ## v0.9.37 — RDC hook loop guard and behavior tests ### Fixed - **Stop hook reentry.** `rdc-output-contract-gate.js` now exits cleanly when Claude is already inside an active Stop-hook retry, preventing noncompliant-but-legitimate turns from hard-looping the session. - **Marker deduplication.** `rdc-invocation-marker.js` now preserves the original marker when `UserPromptExpansion` and `UserPromptSubmit` both fire for the same RDC command within the same second. ### Added - **Hook behavioral tests.** New `scripts/test-rdc-hooks.mjs` executes the marker and Stop hooks against real JSON payloads, and `self-test --strict` now fails if those behavioral checks fail. --- ## v0.9.36 — Portable installer profiles and startup onboarding ### Added - **Installer profiles.** `--profile core` installs clean-box-safe hooks only; `--profile lifeai` keeps the LIFEAI/regen-root cwd, clauth, Supabase, and overnight hooks. `auto` chooses `lifeai` only when a sibling `regen-root` project is detected. - **Managed startup guide.** New `guides/rdc-skills-startup.md` explains what RDC skills add, the active profiles, and where to find skills, commands, guides, hooks, and installer behavior. - **Optional startup block writer.** `--project-root --write-startup-blocks` writes `.rdc/guides/rdc-skills-startup.md` plus managed RDC sections in project `CLAUDE.md` and `AGENTS.md`. - **Install welcome.** The installer now prints the selected profile, what it enables, and where to look next. ### Changed - The default clean-box profile no longer wires regen-root-specific hooks such as cwd lock, Supabase work-item exit gate, rate-limit retry, or overnight open-epic guard. --- ## v0.9.35 — RDC output-contract hook enforcement ### Added - **RDC slash-command marker hook.** `rdc-invocation-marker.js` marks direct `/rdc:*` skill invocations through `UserPromptExpansion`, with a `UserPromptSubmit` fallback for older runtimes, and injects the output/engineering contract reminder. - **RDC Stop gate.** `rdc-output-contract-gate.js` blocks completion for active RDC invocations until the final assistant message includes both a checklist row and a verdict line. - **Installer wiring and self-test coverage.** The Node and PowerShell installers now wire the RDC marker/gate hooks, and `self-test` fails when required hook files or installer references are missing. --- ## 0.6.1 — Tier 2 stability + rdc:watch session watcher ### Added - **`rdc:watch` skill.** Initializes a session log and opens a static HTML viewer that tails Claude activity live via `fetch()` polling. Zero infra — pure filesystem + `.rdc/session-log/current.log` + `viewer.html`. New skill at `skills/rdc-watch.md`, init helper at `scripts/watch-init.mjs`, viewer asset at `assets/watcher/viewer.html`. Dark terminal theme, color-coded event kinds (`dispatch`/`commit`/`test`/`error`/`note`/`banner`), auto-scroll, stall detection. - **Tier 2 behavioral harness (WP1–WP9).** Full work-item delta wiring through PostgREST, 13 baseline test manifests, Tier 2 runner, CI workflow, skill documentation. ### Fixed - **Windows spawn streaming.** `scripts/lib/runner.mjs` now passes `--verbose` alongside `--output-format stream-json` so Claude emits events to stdout on Windows. Without it, stream-json output was buffered/empty. - **Main-db sandbox mode.** Tier 2 runner supports free, read-only sandbox mode against the main Supabase project so behavioral tests don't accrue hourly branch costs. --- ## v0.6.0 — Plugin conversion + agent-hide ### Added - **Claude Code plugin format.** New `.claude-plugin/plugin.json` manifest at repo root (name, version, description, author, homepage, repository) plus `.claude-plugin/marketplace.json` declaring this repo as a single-plugin marketplace pointing at itself (`source: "."`). Matches the schema used by `hookify`, `commit-commands`, `huggingface-skills`, and other official Anthropic plugins — directories (`skills/`, `hooks/`, `commands/`, `agents/`) are auto-discovered by convention, no explicit path keys needed. - **New install path.** ``` /plugin marketplace add LIFEAI/rdc-skills /plugin install rdc-skills ``` All 16 user-invocable skills load automatically via Claude Code's plugin runtime — no copy scripts, no `~/.claude/skills/user/` writes. ### Changed - **10 agent-type skills moved out of `skills/` into `guides/agents/`** (Thread D). Reclaims slots in the Claude Code skill menu cap. Agent playbooks (frontend, backend, data, design, infrastructure, content, cs2, viz, setup, verify) are now dispatched internally by `rdc:build` and are no longer user-invocable slash commands. - **README install section rewritten** to lead with `/plugin install`. Legacy PowerShell/Bash install path documented under "Legacy install (deprecated)". ### Deprecated - `scripts/install.ps1`, `scripts/install.sh`, `scripts/install.js` — deprecation headers added. These will be **removed in v0.7.0**. Migrate to `/plugin install rdc-skills`. --- ## [0.4.0] — 2026-04-14 ### Added #### `rdc:verify` — Verification Gate Skill - New skill `skills/rdc-verify.md` — evidence-before-claims verification gate adapted from obra/superpowers `verification-before-completion` pattern - **Iron Law**: NO COMPLETION CLAIMS WITHOUT FRESH VERIFICATION EVIDENCE — no "should", no "probably", no reasoning from memory - **Stack-specific commands**: `npx vitest run --dir ` + `npx tsc --noEmit --project /tsconfig.json` - **Explicit ban**: `pnpm build` / `pnpm test` / `pnpm -r` — crashes machine (800MB/process) - Rationalization prevention table, required output format with quoted evidence ### Changed #### `rdc:build` — Mandatory Final Verification Phase - New step 10: invoke `rdc:verify` across every package/app touched before marking epic done - Step 11: push + version bump + summary **only after** verification evidence passes #### `rdc:review` — Verification Gate Before CLEAN Verdict - New step 9: invoke `rdc:verify` after fixes land — no CLEAN verdict without fresh vitest + tsc output quoted in report - If verify fails → loop back, fix, re-run (never emit CLEAN optimistically) --- ## [0.3.0] — 2026-04-13 ### Added #### Intelligent Project Detection (`scripts/install.js`) - **`detectProjectInfo(projectRoot)`** — scans `package.json`, git remote, `.env.local` (incl. `apps/**`), `CLAUDE.md`, existing `.rdc/config.json` to auto-populate setup interview defaults - **Auto-prompt setup interview** — default install now prompts `"No .rdc/config.json found. Run setup interview now? [Y/n]:"` instead of passive tip - **Pre-filled interview** — detected values shown in `[brackets]`; press Enter to accept. Eliminates manual re-entry of already-known project metadata - **Detection summary printed** — detected project name, GitHub, Supabase ref, branches, guides dir shown after preflight #### `/rdc:setup` Skill - **New Claude skill** `rdc-setup.md` — instructs Claude to perform a full project scan (15+ file types), emit structured detection summary, generate `.rdc/config.json` and overlay guides, offer docs/ migration, commit result - Complements the `install.js` script-level detection with a richer AI-driven scan when running interactively in Claude Code - Preserves existing `agent-bootstrap.md` custom sections when updating --- ## [0.2.0] — 2026-04-13 ### Added #### `.rdc/` Project Directory Convention - **`.rdc/config.json` schema** — project metadata: name, hook_scope, git config, Supabase ref, credential provider, repo list, path overrides, constraints - **Standardised paths**: `.rdc/guides/`, `.rdc/plans/`, `.rdc/reports/`, `.rdc/research/`, `.rdc/state/` - All 20 skills updated to read from `.rdc/` with fallback to legacy `docs/` structure for existing projects - `guides/agent-bootstrap.md` updated to instruct agents to check `.rdc/config.json` for project metadata #### Installer (`scripts/install.js`) - **`--migrate ` flag** — interactive wizard: scans for `docs/guides/`, `docs/plans/`, `docs/reports/`, `docs/research/`; offers to move each to `.rdc/`; merges files if destination already exists; auto-detects GitHub org/repo from git remote - **`--setup` generates `.rdc/config.json`** from interview answers in addition to `docs/guides/agent-bootstrap.md` - **Preflight checks** — Node ≥ 18 (hard error), clauth daemon ping (warn), `.rdc/config.json` presence check (suggest `--setup`) - **Multi-project support** — each project carries its own `.rdc/` committed to git; skills are global, intelligence travels with the repo #### Multi-Repo Support - `config.json` `repos[]` array — primary + satellite repos listed with roles - One project, many repos: monorepo root holds `.rdc/config.json`, lists satellite repo paths --- ## [0.1.0] — 2026-04-13 ### Added #### Core Architecture - **Plugin scaffold** — Complete rdc-skills plugin repo structure extracted from regen-root monorepo - **Two-layer guide system** — Plugin base guides + project overlay guides enabling skill portability across codebases - Plugin base covers generic patterns (work items RPC, git workflow, standard builds) - Project overlays (frontend.md, backend.md, data.md, etc.) inject stack-specific conventions - Agent receives merged context — project layer wins on conflicts - **Skill dispatch system** — Twelve skill commands integrated with Supabase work_items RPC - `/rdc:status` — Show open epics, kanban, Coolify health, next action - `/rdc:plan ` — Architecture planning, create epic + child tasks - `/rdc:preplan ` — Research phase before planning - `/rdc:build ` — Execute epic tasks in parallel with typed agents - `/rdc:review` — Quality gate: tests, types, stale docs, exports - `/rdc:overnight` — Unattended full pipeline (chains all skills across queue) - `/rdc:fixit ` — Sanctioned bypass for <5 files, <30 min hotfixes - `/rdc:report` — Generate nightly markdown report to docs/reports/YYYY-MM-DD.md - Plus agent bootstrap guide + domain-specific agent guides (frontend, backend, data, design, infrastructure, content, cs2) #### TDD Enforcement (Option B) - **Wave-based test-first builds** — rdc:build now requires tests-first per build wave - npx vitest run per package before proceeding to next wave - `pnpm build` NEVER invoked (memory constraints on dev machine) - Allows async test runs in subagent while supervisor waits - **Test harness integration** — skills coordinate with tsconfig paths, jest/vitest configs, test result tracking - **Coverage reporting** — per-wave coverage aggregation, integration with GitHub PR checks #### Stop Hook - **no-stop-open-epics.js** — Blocks Claude from stopping when `get_open_epics()` returns todo items - Only blocks when todo-status epics exist (in_progress = another session owns them) - Project scope guard — only fires in sessions where cwd contains PROJECT_SCOPE folder - Integrates with Supabase REST API (project-ref from env vars) - Exit code 2 = block, 0 = allow - Silent pass if Supabase credentials unavailable #### Installation & Management - **Windows installer** (scripts/install.ps1) — CLAUDE_HOME detection, symlink skills + hooks, summary report - **Unix installer** (scripts/install.sh) — Bash equivalent for macOS/Linux - **Update scripts** — git pull + reinstall (version bump reporting) - **Uninstall scripts** — Safe removal of rdc-skills files only (never touches user files) - **Validation test** (tests/validate-skills.js) — YAML frontmatter check, required sections, exit 1 on failure #### Documentation - **Plugin README** — Architecture diagram, quick start, skill reference table, guide types, Option B explanation - **Generic work-items-rpc.md** — Complete RPC reference (generic, no hardcoded project IDs) - get_open_epics, insert_work_item, update_work_item_status, get_work_items_by_epic, bump_epic_version - Valid enum values, JS client patterns, direct SQL patterns - **Project setup guide** — Two required files per project (agent-bootstrap.md, project overlay guides) - **Contributing guide** — Fork → branch → PR workflow, validate before submit #### Settings & Configuration - **.claude/settings.json** — Plugin harness permissions, nodeID detection - **.gitignore** — Standard Node.js + git exclusions ### Changed - N/A (initial release) ### Deprecated - N/A ### Removed - N/A ### Fixed - N/A ### Security - Credential handling via environment variables only (no hardcoded keys) - clauth daemon tunnel for all sensitive operations - Project scope guard prevents stop hook from firing in wrong context --- ## Installation & Setup ### For end users ```bash # Windows git clone https://github.com/LIFEAI/rdc-skills.git npm run install:win # macOS / Linux git clone https://github.com/LIFEAI/rdc-skills.git npm run install:unix ``` Then configure your project: 1. Create `docs/guides/agent-bootstrap.md` with credentials 2. Create per-role overlay guides in `docs/guides/` (frontend.md, backend.md, etc.) 3. Run `/rdc:status` to verify setup ### For contributors ```bash git clone https://github.com/LIFEAI/rdc-skills.git cd rdc-skills npm run validate # Check all skills npm run test # (future: comprehensive test suite) ``` --- ## Known Issues & Roadmap ### Current Limitations - Stop hook requires Supabase access (silent pass if unavailable) - No built-in skill/guide templating yet (manual creation) - Validation test basic (could extend to markdown lint, frontmatter schema, etc.) ### Phase 2 (Future) - Skill generator (`rdc:newskill`) for rapid skill creation - Guide templating system - Agent role auto-detection from codebase structure - Integration with GitHub Actions CI - Skill marketplace / package distribution - TDD enforcement integration for all major test frameworks (Vitest, Jest, pytest, Gotest) --- ## License MIT — See LICENSE file for details.