@lifeaitools/rdc-skills 0.24.41 → 0.25.0

package/CHANGELOG.md

@@ -1,310 +1,310 @@
-# 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 <path> --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 <pkg>` + `npx tsc --noEmit --project <pkg>/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 <path>` 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 <topic>` — Architecture planning, create epic + child tasks
-  - `/rdc:preplan <topic>` — Research phase before planning
-  - `/rdc:build <epic-id>` — 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 <description>` — 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.
+# 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 <path> --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 <pkg>` + `npx tsc --noEmit --project <pkg>/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 <path>` 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 <topic>` — Architecture planning, create epic + child tasks
+  - `/rdc:preplan <topic>` — Research phase before planning
+  - `/rdc:build <epic-id>` — 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 <description>` — 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.