rdap-q 1.2.1 → 1.2.4
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.
- package/.agents/plugins/rdap-q/plugin.json +1 -1
- package/.agents/skills/rdap-q/README.md +1 -1
- package/.agents/skills/rdap-q/SKILL.md +1 -1
- package/.agents/skills/rdap-q/install/install-unix.sh +1 -1
- package/.agents/skills/rdap-q/manifest.json +1 -1
- package/.claude/commands/rdapq.md +1 -1
- package/.claude-plugin/marketplace.json +1 -1
- package/.claude-plugin/plugin-index.json +1 -1
- package/.claude-plugin/plugin.json +1 -1
- package/.clinerules +1 -1
- package/.codex/skill.json +1 -1
- package/.github/copilot-instructions.md +1 -1
- package/.goosehints +1 -1
- package/.grok/rules.md +1 -1
- package/.grok/skill.json +1 -1
- package/.grok-plugin/marketplace.json +1 -1
- package/.grok-plugin/plugin-index.json +1 -1
- package/AGENTS.md +1 -1
- package/CLAUDE.md +1 -1
- package/GEMINI.md +1 -1
- package/README.md +90 -224
- package/agentskills.json +1 -1
- package/install.ps1 +2 -2
- package/install.sh +2 -2
- package/lib/installer.js +43 -27
- package/manifest.json +1 -1
- package/marketplace.json +1 -1
- package/package.json +3 -2
- package/plugin.json +1 -1
- package/plugins/rdap-q/plugin.json +1 -1
- package/plugins/rdap-q/skills/rdap-q/README.md +1 -1
- package/plugins/rdap-q/skills/rdap-q/SKILL.md +1 -1
- package/plugins/rdap-q/skills/rdap-q/install/install-unix.sh +1 -1
- package/plugins/rdap-q/skills/rdap-q/manifest.json +1 -1
- package/rdap-q-skill/README.md +1 -1
- package/rdap-q-skill/SKILL.md +1 -1
- package/rdap-q-skill/install/install-unix.sh +1 -1
- package/rdap-q-skill/manifest.json +1 -1
- package/scripts/harness-audit/check.py +387 -0
- package/scripts/harness-audit/vendors.json +192 -0
- package/scripts/harness-audit/weekly.sh +22 -0
- package/skills.json +1 -1
|
@@ -4,7 +4,7 @@ description: Run the RDAP-Q evidence-first engineering protocol. Invoke with /rd
|
|
|
4
4
|
disable-model-invocation: true
|
|
5
5
|
---
|
|
6
6
|
name: rdap-q
|
|
7
|
-
version: "1.2.
|
|
7
|
+
version: "1.2.4"
|
|
8
8
|
description: Evidence-first engineering protocol. Load this file, then the current phase playbook only.
|
|
9
9
|
invocation: /rdapq
|
|
10
10
|
home_env: RDAPQ_HOME
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
#!/usr/bin/env sh
|
|
2
2
|
# Install the skill tree into $RDAPQ_HOME. Stage first, swap only after SKILL.md
|
|
3
3
|
# is present, so a failed copy cannot delete a working install.
|
|
4
|
-
# Prefer the repo installer (./install.sh or npx
|
|
4
|
+
# Prefer the repo installer (./install.sh or npx rdap-q) when you have the full checkout.
|
|
5
5
|
set -eu
|
|
6
6
|
|
|
7
7
|
SOURCE_DIR="$(CDPATH= cd -- "$(dirname -- "$0")/.." && pwd)"
|
|
@@ -8,7 +8,7 @@
|
|
|
8
8
|
"plugins": [
|
|
9
9
|
{
|
|
10
10
|
"name": "rdap-q",
|
|
11
|
-
"version": "1.2.
|
|
11
|
+
"version": "1.2.4",
|
|
12
12
|
"description": "Vendor-neutral engineering protocol for evidence-first software development, persistent state, calibrated 0-10 scoring, and diminishing-return exit gates.",
|
|
13
13
|
"category": "development",
|
|
14
14
|
"author": {
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "rdap-q",
|
|
3
|
-
"version": "1.2.
|
|
3
|
+
"version": "1.2.4",
|
|
4
4
|
"displayName": "RDAP-Q: Adaptive Planning with Quality Gates",
|
|
5
5
|
"description": "Vendor-neutral Research-Driven Adaptive Planning with Quality Gates protocol for Claude Code. Enforces evidence-first engineering, calibrated 0-10 scoring, and diminishing-return exit gates.",
|
|
6
6
|
"author": {
|
package/.clinerules
CHANGED
package/.codex/skill.json
CHANGED
package/.goosehints
CHANGED
package/.grok/rules.md
CHANGED
package/.grok/skill.json
CHANGED
|
@@ -8,7 +8,7 @@
|
|
|
8
8
|
"plugins": [
|
|
9
9
|
{
|
|
10
10
|
"name": "rdap-q",
|
|
11
|
-
"version": "1.2.
|
|
11
|
+
"version": "1.2.4",
|
|
12
12
|
"description": "Vendor-neutral engineering protocol for evidence-first software development, persistent state, calibrated 0-10 scoring, and diminishing-return exit gates.",
|
|
13
13
|
"category": "development",
|
|
14
14
|
"author": {
|
package/AGENTS.md
CHANGED
package/CLAUDE.md
CHANGED
package/GEMINI.md
CHANGED
package/README.md
CHANGED
|
@@ -3,17 +3,17 @@
|
|
|
3
3
|
|
|
4
4
|
[](https://github.com/coldcanuk/rdapq/actions/workflows/ci.yml)
|
|
5
5
|
[](https://www.gnu.org/licenses/gpl-3.0)
|
|
6
|
-
[](https://github.com/coldcanuk/rdapq)
|
|
7
7
|
[](https://github.com/coldcanuk/rdapq)
|
|
8
8
|
[](https://github.com/coldcanuk/rdapq/blob/main/marketplace.json)
|
|
9
|
-
[](#
|
|
10
|
-
[](#
|
|
11
|
-
[](#
|
|
12
|
-
[](#
|
|
13
|
-
[](#
|
|
14
|
-
[](#
|
|
15
|
-
[](#
|
|
16
|
-
[](#
|
|
9
|
+
[](#in-harness-marketplace-installation)
|
|
10
|
+
[](#in-harness-marketplace-installation)
|
|
11
|
+
[](#in-harness-marketplace-installation)
|
|
12
|
+
[](#in-harness-marketplace-installation)
|
|
13
|
+
[](#in-harness-marketplace-installation)
|
|
14
|
+
[](#in-harness-marketplace-installation)
|
|
15
|
+
[](#in-harness-marketplace-installation)
|
|
16
|
+
[](#in-harness-marketplace-installation)
|
|
17
17
|
|
|
18
18
|
---
|
|
19
19
|
|
|
@@ -29,7 +29,7 @@
|
|
|
29
29
|
"@type": "SoftwareSourceCode",
|
|
30
30
|
"name": "RDAP-Q",
|
|
31
31
|
"alternateName": "Research-Driven Adaptive Planning with Quality Gates",
|
|
32
|
-
"version": "1.2.
|
|
32
|
+
"version": "1.2.4",
|
|
33
33
|
"description": "Universal AI agent engineering protocol for evidence-first software development, calibrated scoring, and diminishing-return exit gates across OpenAI Codex, xAI Grok, GitHub Copilot, Google Antigravity, Block Goose, Anthropic Claude, Cline, and Cursor.",
|
|
34
34
|
"codeRepository": "https://github.com/coldcanuk/rdapq",
|
|
35
35
|
"license": "https://www.gnu.org/licenses/gpl-3.0",
|
|
@@ -68,18 +68,11 @@ $$\text{Evidence} \longrightarrow \text{Correctness} \longrightarrow \text{Measu
|
|
|
68
68
|
- [📌 Description](#description)
|
|
69
69
|
- [🚀 Overview](#overview)
|
|
70
70
|
- [🧭 System Architecture & Control Loop](#system-architecture)
|
|
71
|
-
- [📦
|
|
72
|
-
- [xAI Grok (TUI Menu GUI & CLI)](#xai-grok-marketplace)
|
|
73
|
-
- [Anthropic Claude Code (TUI Menu GUI & CLI)](#anthropic-claude-marketplace)
|
|
74
|
-
- [Google Antigravity (Skills Palette & CLI)](#google-antigravity-marketplace)
|
|
75
|
-
- [OpenAI Codex & Agents](#openai-codex-marketplace)
|
|
76
|
-
- [Block Goose](#block-goose-marketplace)
|
|
77
|
-
- [GitHub Copilot](#github-copilot-marketplace)
|
|
78
|
-
- [Cline & Roo Code](#cline--roo-code-marketplace)
|
|
79
|
-
- [Cursor](#cursor)
|
|
71
|
+
- [📦 Harness install](#in-harness-marketplace-installation)
|
|
80
72
|
- [⚡ Install](#npm-npx-installation)
|
|
81
73
|
- [📜 Local clone](#universal-install-scripts)
|
|
82
74
|
- [🔄 Update](#update)
|
|
75
|
+
- [🔁 Weekly harness audit](#harness-audit)
|
|
83
76
|
- [⚡ Canonical Commands (`/rdapq`)](#canonical-commands)
|
|
84
77
|
- [🎯 Calibrated Quality Scale (0–10)](#calibrated-quality-scale)
|
|
85
78
|
- [Default Implementation Dimensions](#default-implementation-dimensions)
|
|
@@ -117,199 +110,45 @@ flowchart TD
|
|
|
117
110
|
|
|
118
111
|
---
|
|
119
112
|
|
|
120
|
-
## <a id="in-harness-marketplace-installation"></a> 📦
|
|
113
|
+
## <a id="in-harness-marketplace-installation"></a> 📦 Harness install
|
|
121
114
|
|
|
122
|
-
|
|
115
|
+
This package is not in the Anthropic, xAI, or GitHub Copilot catalogs. Do not use `gh extension install`, a VS Code extension search, or `goose toolkit add`. Those commands do not install RDAP-Q.
|
|
123
116
|
|
|
124
|
-
|
|
117
|
+
The supported install is `npx --yes rdap-q`. `install --<harness>` writes that harness's user files. `init` writes the project files. A harness slash command is `/rdap-q` when the client loads `SKILL.md`. `/rdapq` works where a project bridge or Claude command file is present.
|
|
125
118
|
|
|
126
|
-
|
|
|
119
|
+
| Harness | User install | What it writes | Project install (`init`) | Invoke |
|
|
127
120
|
| :--- | :--- | :--- | :--- | :--- |
|
|
128
|
-
| **
|
|
129
|
-
| **
|
|
130
|
-
| **
|
|
131
|
-
| **
|
|
132
|
-
| **
|
|
133
|
-
| **
|
|
134
|
-
| **
|
|
135
|
-
| **
|
|
121
|
+
| **Cursor** | `--cursor` | `~/.cursor/skills/rdap-q/` | `AGENTS.md`, `.agents/skills/rdap-q/` | `/rdap-q`, or `/rdapq` after `init` |
|
|
122
|
+
| **Codex** | `--codex` | `~/.codex/AGENTS.md`, `~/.agents/skills/rdap-q/` | `AGENTS.md`, `.agents/skills/rdap-q/` | `/rdap-q` |
|
|
123
|
+
| **Claude Code** | `--claude` | `~/.claude/skills/rdap-q/`, `~/.claude/commands/rdapq.md` | `CLAUDE.md`, `.claude/skills/rdap-q/`, `.claude/commands/rdapq.md` | `/rdap-q` or `/rdapq` |
|
|
124
|
+
| **Copilot** | `--copilot` | `~/.copilot/copilot-instructions.md`, `~/.copilot/skills/rdap-q/` | `.github/copilot-instructions.md`, `.agents/skills/rdap-q/` | instructions are always on; `/rdap-q` where skills load |
|
|
125
|
+
| **Grok Build** | `--grok` | `~/.grok/skills/rdap-q/` | `.grok/rules.md` | `/rdap-q` |
|
|
126
|
+
| **Antigravity** | `--antigravity` | `~/.gemini/antigravity-cli/skills/rdap-q/`, `~/.gemini/config/skills/rdap-q/` | `GEMINI.md`, `AGENTS.md`, `.agents/skills/rdap-q/` | `/rdap-q` |
|
|
127
|
+
| **Goose** | `--goose` | `~/.config/goose/.goosehints` | `.goosehints` | no slash command; hints load when the Developer extension is on |
|
|
128
|
+
| **Cline** | `--cline` | `~/.cline/rules/rdapq.md` | `.clinerules/rdapq.md` | rules load with the workspace; there is no marketplace entry |
|
|
136
129
|
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
### <a id="xai-grok"></a><a id="xai-grok-marketplace"></a> 🤖 xAI Grok (TUI Menu GUI & CLI)
|
|
140
|
-
|
|
141
|
-
#### Step 1: Add marketplace and install plugin
|
|
142
|
-
```bash
|
|
143
|
-
grok plugin marketplace add coldcanuk/rdapq
|
|
144
|
-
grok plugin install rdap-q --trust
|
|
145
|
-
```
|
|
146
|
-
|
|
147
|
-
#### Step 2: Enable the plugin
|
|
148
|
-
```bash
|
|
149
|
-
grok plugin enable rdap-q
|
|
150
|
-
```
|
|
151
|
-
|
|
152
|
-
#### Step 3: Or install via the in-harness Text-Based Menu GUI (TUI):
|
|
153
|
-
1. In your Grok session, type `/skills` or `/plugins` to open the text-based interactive menu.
|
|
154
|
-
2. Use arrow keys or `Tab` to navigate to the **Marketplace** / **Plugins** tab.
|
|
155
|
-
3. Select **rdap-q**.
|
|
156
|
-
4. Press `Space` to enable/install.
|
|
157
|
-
5. Press `r` to reload (or start a new session).
|
|
130
|
+
`CURSOR_HOME`, `CODEX_HOME`, `CLAUDE_HOME`, `COPILOT_HOME`, `GROK_HOME`, `GEMINI_HOME`, `GOOSE_HOME`, `CLINE_HOME`, and `AGENTS_HOME` override those directories.
|
|
158
131
|
|
|
159
|
-
#### One-shot install from plugin path:
|
|
160
132
|
```bash
|
|
161
|
-
|
|
133
|
+
npx --yes rdap-q install --cursor
|
|
134
|
+
npx --yes rdap-q install --codex --claude
|
|
135
|
+
npx --yes rdap-q init
|
|
162
136
|
```
|
|
163
137
|
|
|
164
|
-
|
|
165
|
-
```bash
|
|
166
|
-
git clone https://github.com/coldcanuk/rdapq.git
|
|
167
|
-
grok plugin marketplace add ./rdapq
|
|
168
|
-
grok plugin install rdap-q --trust
|
|
169
|
-
```
|
|
170
|
-
|
|
171
|
-
#### How to use in Grok:
|
|
172
|
-
- Slash command: `/rdapq <task>`
|
|
173
|
-
- The installed bridge loads `rdap-q-skill/SKILL.md` only when you invoke `/rdapq`. It does not turn the protocol on for every engineering task.
|
|
174
|
-
|
|
175
|
-
---
|
|
176
|
-
|
|
177
|
-
### <a id="anthropic-claude--claude-code"></a><a id="anthropic-claude-marketplace"></a> 🎭 Anthropic Claude Code (TUI Menu GUI & CLI)
|
|
178
|
-
|
|
179
|
-
#### CLI Install:
|
|
180
|
-
```bash
|
|
181
|
-
claude plugin marketplace add coldcanuk/rdapq
|
|
182
|
-
claude plugin install rdap-q
|
|
183
|
-
```
|
|
184
|
-
|
|
185
|
-
#### In-Harness TUI Menu:
|
|
186
|
-
1. In Claude Code, run `/plugins` or `/skills` to display the interactive plugins menu.
|
|
187
|
-
2. Select **Marketplace** and choose **rdap-q**.
|
|
188
|
-
3. Hit `Enter` to install and enable.
|
|
189
|
-
4. Run `/rdapq <task>` in your project.
|
|
190
|
-
|
|
191
|
-
---
|
|
192
|
-
|
|
193
|
-
### <a id="google-antigravity"></a><a id="google-antigravity-marketplace"></a> 🛸 Google Antigravity (Skills Palette & CLI)
|
|
194
|
-
|
|
195
|
-
#### CLI Install:
|
|
196
|
-
```bash
|
|
197
|
-
# Register marketplace repository and install plugin:
|
|
198
|
-
agy plugin marketplace add coldcanuk/rdapq
|
|
199
|
-
agy plugin install rdap-q
|
|
200
|
-
|
|
201
|
-
# Or install skill directly:
|
|
202
|
-
agy skill add https://github.com/coldcanuk/rdapq
|
|
203
|
-
```
|
|
138
|
+
Claude Code can also add this repository as a plugin marketplace from inside a session, because `.claude-plugin/marketplace.json` is in the repo:
|
|
204
139
|
|
|
205
|
-
|
|
206
|
-
|
|
207
|
-
|
|
208
|
-
3. Select **rdap-q** to activate the engineering protocol.
|
|
209
|
-
|
|
210
|
-
---
|
|
211
|
-
|
|
212
|
-
### <a id="openai-codex"></a><a id="openai-codex-marketplace"></a> 🧠 OpenAI Codex & Agents
|
|
213
|
-
|
|
214
|
-
#### CLI Install:
|
|
215
|
-
```bash
|
|
216
|
-
codex skill add https://github.com/coldcanuk/rdapq
|
|
217
|
-
```
|
|
218
|
-
|
|
219
|
-
#### In-Harness GUI:
|
|
220
|
-
1. Open Codex / ChatGPT Developer Assistant.
|
|
221
|
-
2. Open `/skills` or the Agent Skills catalog.
|
|
222
|
-
3. Search for **RDAP-Q** (or paste repository URL `https://github.com/coldcanuk/rdapq`).
|
|
223
|
-
4. Toggle on **rdap-q** to enable evidence-first quality gating.
|
|
224
|
-
|
|
225
|
-
---
|
|
226
|
-
|
|
227
|
-
### <a id="block-goose"></a><a id="block-goose-marketplace"></a> 🪿 Block Goose
|
|
228
|
-
|
|
229
|
-
#### CLI Install:
|
|
230
|
-
```bash
|
|
231
|
-
goose toolkit add coldcanuk/rdapq
|
|
232
|
-
```
|
|
233
|
-
|
|
234
|
-
#### Interactive Session:
|
|
235
|
-
1. Run `goose session`.
|
|
236
|
-
2. Inspect toolkits via the session prompt.
|
|
237
|
-
3. Invoke `/rdapq <task>` or `goose run "/rdapq <task>"`.
|
|
238
|
-
|
|
239
|
-
---
|
|
240
|
-
|
|
241
|
-
### <a id="github-copilot"></a><a id="github-copilot-marketplace"></a> 🐙 GitHub Copilot
|
|
242
|
-
|
|
243
|
-
#### CLI / Extension Install:
|
|
244
|
-
```bash
|
|
245
|
-
gh extension install coldcanuk/rdapq
|
|
246
|
-
```
|
|
247
|
-
|
|
248
|
-
#### VS Code In-App Marketplace:
|
|
249
|
-
1. Press `Ctrl+Shift+X` (or `Cmd+Shift+X` on macOS) in VS Code.
|
|
250
|
-
2. Search for Copilot Extension: **RDAP-Q**.
|
|
251
|
-
3. In Copilot Chat, use `@workspace /rdapq <task>`.
|
|
252
|
-
|
|
253
|
-
---
|
|
254
|
-
|
|
255
|
-
### <a id="cline--roo-code"></a><a id="cline--roo-code-marketplace"></a> 💻 Cline & Roo Code
|
|
256
|
-
|
|
257
|
-
#### First-party install:
|
|
258
|
-
```bash
|
|
259
|
-
npx --yes github:coldcanuk/rdapq install --cline
|
|
260
|
-
```
|
|
261
|
-
|
|
262
|
-
#### Optional third-party installer:
|
|
263
|
-
```bash
|
|
264
|
-
# Smithery can auto-approve a remote install. Prefer the first-party command above.
|
|
265
|
-
npx -y @smithery/cli install coldcanuk/rdapq
|
|
266
|
-
```
|
|
267
|
-
|
|
268
|
-
#### In-App Settings GUI:
|
|
269
|
-
1. Open the Cline panel in VS Code.
|
|
270
|
-
2. Click on **Settings** (⚙️) → **Prompts / Rules**.
|
|
271
|
-
3. Import from URL: `https://github.com/coldcanuk/rdapq`.
|
|
272
|
-
4. In chat, type `/rdapq <task>`.
|
|
273
|
-
|
|
274
|
-
---
|
|
275
|
-
|
|
276
|
-
### <a id="cursor"></a> 🖱️ Cursor
|
|
277
|
-
|
|
278
|
-
Cursor has no marketplace flag in this repo. It reads `AGENTS.md` and skills in `.agents/skills/` or `~/.cursor/skills/`. The skill id is `rdap-q`, so the slash command is `/rdap-q`. `/rdapq` also works when `AGENTS.md` is in the project, because that file tells the agent to load the same skill.
|
|
279
|
-
|
|
280
|
-
The skill does not auto-run on every task. Cursor loads it when you invoke `/rdap-q`.
|
|
281
|
-
|
|
282
|
-
#### This project
|
|
283
|
-
```bash
|
|
284
|
-
npx --yes github:coldcanuk/rdapq init
|
|
285
|
-
```
|
|
286
|
-
|
|
287
|
-
Then open the folder in Cursor and start a new Agent chat. `init` writes `AGENTS.md` and `.agents/skills/rdap-q/`. Type `/rdap-q` or `/rdapq <task>`.
|
|
288
|
-
|
|
289
|
-
#### Every project on this machine
|
|
290
|
-
```bash
|
|
291
|
-
npx --yes github:coldcanuk/rdapq install --cursor
|
|
292
|
-
```
|
|
293
|
-
|
|
294
|
-
That installs the skill at `~/.cursor/skills/rdap-q/` (`CURSOR_HOME` overrides the directory). Restart Cursor, then type `/rdap-q` in Agent chat. This does not write `AGENTS.md` into other repositories. Run `init` in a repo when you also want `/rdapq` from the project bridge.
|
|
295
|
-
|
|
296
|
-
From a checkout:
|
|
297
|
-
|
|
298
|
-
```bash
|
|
299
|
-
./install.sh --cursor
|
|
140
|
+
```text
|
|
141
|
+
/plugin marketplace add coldcanuk/rdapq
|
|
142
|
+
/plugin install rdap-q@rdapq
|
|
300
143
|
```
|
|
301
144
|
|
|
302
|
-
|
|
303
|
-
.\install.ps1 -Cursor
|
|
304
|
-
```
|
|
145
|
+
That is optional. It is not required for `install --claude` or `init`.
|
|
305
146
|
|
|
306
147
|
---
|
|
307
148
|
|
|
308
149
|
## <a id="npm-npx-installation"></a> ⚡ Install
|
|
309
150
|
|
|
310
|
-
Node.js 18 or newer is required. Do not pipe
|
|
311
|
-
|
|
312
|
-
`rdap-q` is not on the npm registry yet. Use a checkout or the GitHub package. After a Trusted Publisher release, `npx rdap-q` will be the same CLI.
|
|
151
|
+
Node.js 18 or newer is required. Install from [`rdap-q`](https://www.npmjs.com/package/rdap-q) on the public npm registry. This tree is package version **1.2.4**. Do not pipe an installer from the network (`curl | bash`, `irm | iex`). A piped script cannot see the skill tree and is refused.
|
|
313
152
|
|
|
314
153
|
`SKILL.md` is the instruction source the agent loads. This README is the human guide.
|
|
315
154
|
|
|
@@ -320,26 +159,26 @@ Edited harness files are kept. Pass `--force` to replace one. The previous file
|
|
|
320
159
|
### One harness, or several:
|
|
321
160
|
```bash
|
|
322
161
|
# Core skill plus Claude only.
|
|
323
|
-
npx --yes
|
|
162
|
+
npx --yes rdap-q install --claude
|
|
324
163
|
|
|
325
164
|
# Cursor only. The skill lands in ~/.cursor/skills/rdap-q.
|
|
326
|
-
npx --yes
|
|
165
|
+
npx --yes rdap-q install --cursor
|
|
327
166
|
|
|
328
167
|
# Codex and Grok together:
|
|
329
|
-
npx --yes
|
|
168
|
+
npx --yes rdap-q install --codex --grok
|
|
330
169
|
|
|
331
|
-
#
|
|
332
|
-
npx --yes
|
|
170
|
+
# This release, not whatever is tagged latest later:
|
|
171
|
+
npx --yes rdap-q@1.2.4 install --claude
|
|
333
172
|
```
|
|
334
173
|
|
|
335
174
|
### All 8 harnesses:
|
|
336
175
|
```bash
|
|
337
|
-
npx --yes
|
|
176
|
+
npx --yes rdap-q install --all
|
|
338
177
|
```
|
|
339
178
|
|
|
340
179
|
### This repository only, no harness files:
|
|
341
180
|
```bash
|
|
342
|
-
npx --yes
|
|
181
|
+
npx --yes rdap-q install --global-only
|
|
343
182
|
```
|
|
344
183
|
|
|
345
184
|
That writes `$RDAPQ_HOME` (default `~/.rdapq`): `skills/rdap-q/`, plus empty `memory/`, `projects/`, and `registry/` directories. It does not create harness bridges.
|
|
@@ -347,31 +186,33 @@ That writes `$RDAPQ_HOME` (default `~/.rdapq`): `skills/rdap-q/`, plus empty `me
|
|
|
347
186
|
### Initialize the current project:
|
|
348
187
|
```bash
|
|
349
188
|
# Missing bridges and .rdapq/state. Does not clobber a file you already edited.
|
|
350
|
-
npx --yes
|
|
189
|
+
npx --yes rdap-q init
|
|
351
190
|
|
|
352
191
|
# Replace existing bridges, keeping backups:
|
|
353
|
-
npx --yes
|
|
192
|
+
npx --yes rdap-q init --force
|
|
354
193
|
|
|
355
194
|
# Or target a specific workspace:
|
|
356
|
-
npx --yes
|
|
195
|
+
npx --yes rdap-q --repo /path/to/my-project
|
|
357
196
|
```
|
|
358
197
|
|
|
359
|
-
`init` writes `AGENTS.md`, `CLAUDE.md`, `GEMINI.md`, `.clinerules`, `.goosehints`, `.grok/rules.md`, `.github/copilot-instructions.md`, `.claude/commands/rdapq.md`, and
|
|
198
|
+
`init` writes `AGENTS.md`, `CLAUDE.md`, `GEMINI.md`, `.clinerules/rdapq.md`, `.goosehints`, `.grok/rules.md`, `.github/copilot-instructions.md`, `.claude/commands/rdapq.md`, and skill trees at `.agents/skills/rdap-q/` and `.claude/skills/rdap-q/`. Cursor, Codex, Copilot, and Antigravity read `.agents/skills`. Claude Code reads `.claude/skills`.
|
|
360
199
|
|
|
361
200
|
### Check installation status:
|
|
362
201
|
```bash
|
|
363
|
-
npx --yes
|
|
202
|
+
npx --yes rdap-q status
|
|
364
203
|
```
|
|
365
204
|
|
|
366
205
|
### Install the command globally:
|
|
367
206
|
```bash
|
|
368
|
-
npm install -g
|
|
207
|
+
npm install -g rdap-q
|
|
369
208
|
rdapq install --claude
|
|
370
209
|
rdapq status
|
|
371
210
|
rdapq init
|
|
372
211
|
```
|
|
373
212
|
|
|
374
|
-
Harness homes can be redirected without touching the real user profile. `RDAPQ_HOME`, `GEMINI_HOME`, `GOOSE_HOME`, `CLAUDE_HOME`, `CLINE_HOME`, `CODEX_HOME`, `GROK_HOME`, and `
|
|
213
|
+
Harness homes can be redirected without touching the real user profile. `RDAPQ_HOME`, `GEMINI_HOME`, `GOOSE_HOME`, `CLAUDE_HOME`, `CLINE_HOME`, `CODEX_HOME`, `GROK_HOME`, `COPILOT_HOME`, and `CURSOR_HOME` are all honored.
|
|
214
|
+
|
|
215
|
+
A checkout of a branch that is not released yet can still be installed with `npx --yes github:coldcanuk/rdapq`. The registry package is the supported install.
|
|
375
216
|
|
|
376
217
|
---
|
|
377
218
|
|
|
@@ -403,7 +244,7 @@ cd rdapq
|
|
|
403
244
|
|
|
404
245
|
## <a id="update"></a> 🔄 Update
|
|
405
246
|
|
|
406
|
-
There is no `update` command. Install
|
|
247
|
+
There is no `update` command. Install the same flags again. A newer skill tree is staged and swapped in only after its `SKILL.md` verifies. The previous tree is removed only after that rename. If the copy fails, the previous tree is put back.
|
|
407
248
|
|
|
408
249
|
These are not inside the skill tree and are kept:
|
|
409
250
|
|
|
@@ -412,11 +253,32 @@ These are not inside the skill tree and are kept:
|
|
|
412
253
|
- repository task state in `<repo>/.rdapq/state/`
|
|
413
254
|
- a harness file you have edited, unless you pass `--force`
|
|
414
255
|
|
|
256
|
+
`npm install` updates the CLI package only. It does not refresh `~/.rdapq` or the harness files. Run `rdapq install` again after the package is newer.
|
|
257
|
+
|
|
258
|
+
### Registry (normal path)
|
|
259
|
+
```bash
|
|
260
|
+
npx --yes rdap-q@latest install --cursor
|
|
261
|
+
npx --yes rdap-q@latest status
|
|
262
|
+
```
|
|
263
|
+
|
|
264
|
+
Use the same harness flags you used the first time. `--cursor` above is only an example. To stay on this release:
|
|
265
|
+
|
|
266
|
+
```bash
|
|
267
|
+
npx --yes rdap-q@1.2.4 install --cursor
|
|
268
|
+
```
|
|
269
|
+
|
|
270
|
+
### Command installed globally
|
|
271
|
+
```bash
|
|
272
|
+
npm install -g rdap-q@latest
|
|
273
|
+
rdapq install --cursor
|
|
274
|
+
rdapq status
|
|
275
|
+
```
|
|
276
|
+
|
|
415
277
|
### Checkout you already have
|
|
416
278
|
```bash
|
|
417
279
|
cd rdapq
|
|
418
280
|
git fetch origin --tags
|
|
419
|
-
git checkout v1.2.
|
|
281
|
+
git checkout v1.2.4 # or: git pull origin main
|
|
420
282
|
./install.sh --claude # same flags as the first install
|
|
421
283
|
./install.sh status
|
|
422
284
|
```
|
|
@@ -424,38 +286,42 @@ git checkout v1.2.1 # or: git pull origin main
|
|
|
424
286
|
```powershell
|
|
425
287
|
cd rdapq
|
|
426
288
|
git fetch origin --tags
|
|
427
|
-
git checkout v1.2.
|
|
289
|
+
git checkout v1.2.4
|
|
428
290
|
.\install.ps1 -Claude
|
|
429
291
|
node .\bin\rdapq.js status
|
|
430
292
|
```
|
|
431
293
|
|
|
432
|
-
### Global npm install from GitHub
|
|
433
|
-
```bash
|
|
434
|
-
npm install -g github:coldcanuk/rdapq
|
|
435
|
-
rdapq install --claude
|
|
436
|
-
rdapq status
|
|
437
|
-
```
|
|
438
|
-
|
|
439
|
-
Pin a tag with `npm install -g github:coldcanuk/rdapq#v1.2.1`. Re-run that install to move later. Then run `rdapq install` again so the files on disk match the new package. `npm install -g` alone does not refresh `~/.rdapq` or the harness files.
|
|
440
|
-
|
|
441
294
|
### Take the new harness text
|
|
442
295
|
A re-install that sees a different `AGENTS.md`, `CLAUDE.md`, or other bridge leaves your file in place and writes the packaged copy next to it as `<file>.rdapq`. Diff that sidecar. When you want the packaged text:
|
|
443
296
|
|
|
444
297
|
```bash
|
|
445
|
-
|
|
298
|
+
npx --yes rdap-q install --claude --force
|
|
446
299
|
```
|
|
447
300
|
|
|
448
301
|
`--force` copies the current file to `<file>.rdapq-backup`, then writes the new one. It does not delete `$RDAPQ_HOME/memory`.
|
|
449
302
|
|
|
450
303
|
### Workspace already initialized
|
|
451
304
|
```bash
|
|
452
|
-
|
|
305
|
+
npx --yes rdap-q init
|
|
453
306
|
```
|
|
454
307
|
|
|
455
308
|
That refreshes `.agents/skills/rdap-q/` and creates any bridge that is missing. Add `--force` only when you want the bridges replaced. Start a new harness session afterward so it does not keep the previous `SKILL.md` in context.
|
|
456
309
|
|
|
457
310
|
---
|
|
458
311
|
|
|
312
|
+
## <a id="harness-audit"></a> 🔁 Weekly harness audit
|
|
313
|
+
|
|
314
|
+
Vendor docs move. `scripts/harness-audit/check.py` fetches each vendor `llms.txt`, then the skills and rules pages linked from it, and checks that the paths in `lib/installer.js` and this README are still on those pages. A passing run does not call a model. If a path disappears, it writes `reports/harness-audit/review-prompt.md` for a local model. That directory is gitignored.
|
|
315
|
+
|
|
316
|
+
```bash
|
|
317
|
+
python3 scripts/harness-audit/check.py --self-test
|
|
318
|
+
./scripts/harness-audit/weekly.sh
|
|
319
|
+
```
|
|
320
|
+
|
|
321
|
+
The weekly script is what you cron. It does not use Grok cloud credits. Set `RDAPQ_AUDIT_REVIEW` only if a failed run should be handed to a local model.
|
|
322
|
+
|
|
323
|
+
---
|
|
324
|
+
|
|
459
325
|
## <a id="canonical-commands"></a> ⚡ Canonical Commands
|
|
460
326
|
|
|
461
327
|
Every harness adheres to the standardized `/rdapq` command suite:
|
|
@@ -586,7 +452,7 @@ rdapq/
|
|
|
586
452
|
├── lib/installer.js # Installer implementation
|
|
587
453
|
├── test/ # node:test coverage for install/init/status/pack
|
|
588
454
|
├── scripts/ # Version, static, and npm pack checks
|
|
589
|
-
├── .clinerules
|
|
455
|
+
├── .clinerules/rdapq.md # Cline workspace rule
|
|
590
456
|
├── .goosehints # Block Goose agent hints
|
|
591
457
|
├── .claude-plugin/ # Claude Code marketplace definition
|
|
592
458
|
├── .grok-plugin/ # xAI Grok marketplace definition
|