rdap-q 1.2.4 → 1.2.5

package/.agents/plugins/rdap-q/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "rdap-q",
-  "version": "1.2.4",
+  "version": "1.2.5",
   "description": "RDAP-Q Agent Engineering Protocol plugin with progressive disclosure playbooks and calibrated scoring.",
   "rules": [
     "../../../AGENTS.md"

package/.agents/skills/rdap-q/README.md

@@ -1,4 +1,4 @@
-# RDAP-Q Skill v1.2.4
+# RDAP-Q Skill v1.2.5
 
 `SKILL.md` is the instruction source. This README is not a second copy of the protocol.
 

package/.agents/skills/rdap-q/SKILL.md

@@ -4,14 +4,26 @@ description: Run the RDAP-Q evidence-first engineering protocol. Invoke with /rd
 disable-model-invocation: true
 ---
 name: rdap-q
-version: "1.2.4"
+version: "1.2.5"
 description: Evidence-first engineering protocol. Load this file, then the current phase playbook only.
 invocation: /rdapq
 home_env: RDAPQ_HOME
 home: RDAPQ_HOME else ~/.rdapq (Windows %USERPROFILE%\.rdapq)
 state: .rdapq/state
 memory: $RDAPQ_HOME/memory
+memory_index: $RDAPQ_HOME/memory/index.md
 facts: [OBSERVED, USER_SPECIFIED, VERIFIED_EXTERNAL, INFERRED, UNKNOWN]
+memory_caps:
+  load_full_records: 12
+  load_index_rows: 80
+  fact_chars: 240
+  evidence_chars: 160
+  file_bytes: 24576
+  global_active: 80
+  project_active: 40
+  state_evidence_records: 80
+  state_iteration_rounds: 20
+  state_file_bytes: 49152
 rules:
   - evidence before inference; never invent paths, APIs, versions, flags, tests, env, or architecture
   - INFERRED or UNKNOWN cannot decide implementation when verification is possible
@@ -21,12 +33,14 @@ rules:
   - task state stays in .rdapq/state; memory is reusable only; current evidence beats memory
   - never store secret values; a source plus an identifier is allowed
   - do not load manifest.json, other playbooks, diagrams, or bulk memory
+  - load memory/index.md first, then at most 12 matching full records; compact before work if over cap
+  - never bulk-read memory/ or projects/; never gzip, base64, or one-line-tarball memory
 commands:
   status: phase, quality, confidence, gates, blockers, iteration
   score: evidence-linked scorecard
   audit: adversarial final audit
-  resume: reload memory and state, then check drift
-  memory: relevant memories and status; never print secrets
+  resume: compact if over cap, reload index and hits plus state, then check drift
+  memory: relevant ACTIVE memories and status; never print secrets; never dump the store
   research: discovery
   explain: why this phase or exit
 weights: {correctness: 25, coverage: 15, verification: 15, integration: 10, security: 10, maintainability: 10, architecture: 8, operability: 7}

package/.agents/skills/rdap-q/core/controller.md

@@ -1,14 +1,14 @@
 when: whole_loop_or_ambiguous_next_state
 order:
   - resolve home; if unwritable, record it and use repo state
-  - load SKILL.md, repo root, relevant memory, then .rdapq/state if present
+  - load SKILL.md, repo root, memory index, compact if over cap, then at most 12 hits, then .rdapq/state if present
   - load the current playbook only; observe before acting
   - update facts, assumptions, evidence, risks, decisions
   - milestone: verify, review, score, gate, decide, persist
   - invalid plan -> PLAN; worthwhile fix -> iterate
   - gates pass and diminishing -> audit, then COMPLETE
   - else emit the accurate non-complete terminal state
-  - promote only durable lessons
+  - promote only durable lessons that pass write_forbid and caps
 precedence: [user_intent, direct_evidence, repo_state, project_memory, global_memory, external_for_this_version, inference]
 replan_if_changes: [scope, architecture, dependencies, sequencing, risk, verification, success_criteria]
-context: targeted reads; do not replay chat or load the whole skill tree
+context: targeted reads; do not replay chat or load the whole skill tree; never bulk-read memory/

package/.agents/skills/rdap-q/core/gates.md

@@ -8,5 +8,5 @@ gates:
   regression: [existing_tests_pass, no_known_material_regression]
   security: [no_new_material_issue, no_secrets_stored, destructive_safeguards, risk_proportional_checks]
   repository: [diff_reviewed, no_unintended_files, no_conflicts, state_understood, unrelated_work_kept]
-  memory: [no_secrets, promotion_test, stale_handled, state_not_promoted_as_global]
+  memory: [no_secrets, promotion_test, stale_handled, state_not_promoted_as_global, under_cap, index_current]
   quality: target_met_or_diminishing_returns_and_other_gates_pass

package/.agents/skills/rdap-q/core/memory.md

@@ -2,10 +2,44 @@ scopes:
   global: "$RDAPQ_HOME/memory/{engineering-preferences,tooling,lessons,patterns,constraints}.md"
   project: "$RDAPQ_HOME/projects/<id>/{project,architecture,lessons,decisions}.md"
   task: .rdapq/state
+index: "$RDAPQ_HOME/memory/index.md"
+load: index_then_hits
 promote_if_all: [durable, reusable, material, safe, grounded]
 record: {id: M-<id>, scope: "global|project:<id>", status: [ACTIVE, STALE, SUPERSEDED, INVALID], class: [USER_SPECIFIED, OBSERVED, VERIFIED_EXTERNAL, INFERRED], confidence: "0-10", verified: YYYY-MM-DD, supersedes: "id|none", superseded_by: "id|none", fact: str, evidence: str}
+index_row: {id: M-<id>, kind: str, scope: "global|project:<id>", status: str, class: str, one_line: str}
 secrets: never values; source plus identifier only
 on_conflict: trust direct evidence; mark STALE, SUPERSEDED, or INVALID; link ids; do not silent-delete
-load: relevant project, then relevant global
-memory_cmd: relevant entries, status, conflicts; never print secrets
-resume: home, project memory, repo state, last phase, inspect drift, continue at first unverified step
+load_order: relevant index rows, then matching full records, project before global
+memory_cmd: relevant ACTIVE entries, status, conflicts; never print secrets; never dump the store
+resume: home, index, compact if over cap, load hits, repo state, last phase, inspect drift, continue at first unverified step
+caps:
+  load_full_records: 12
+  load_index_rows: 80
+  fact_chars: 240
+  evidence_chars: 160
+  file_bytes: 24576
+  global_active: 80
+  project_active: 40
+  state_evidence_records: 80
+  state_iteration_rounds: 20
+  state_file_bytes: 49152
+refuse:
+  - bulk_read of memory/ or projects/
+  - diagrams (.mmd)
+  - manifest.json
+  - playbooks other than current phase
+  - gzip, base64, or one-line tarball encodings
+write_forbid:
+  - secret values
+  - command output, diffs, logs, chat
+  - INFERRED when verification was possible
+  - duplicate of an ACTIVE one_line
+  - fact longer than fact_chars
+  - evidence longer than evidence_chars
+  - promoting .rdapq/state into global memory
+on_cap:
+  stop_append: true
+  compact: [STALE, SUPERSEDED, INVALID]
+  overflow: archive to memory/archive/YYYY-MM.md
+  say: "MEMORY_CAP — compacted, not loaded"
+over_cap_without_safe_compact: stop promoting; emit MEMORY_CAP; do not keep appending

package/.agents/skills/rdap-q/manifest.json

@@ -1,6 +1,6 @@
 {
   "name": "rdap-q",
-  "version": "1.2.4",
+  "version": "1.2.5",
   "protocol_name": "RDAP-Q Agent Engineering Protocol",
   "entrypoint": "SKILL.md",
   "invocation": "/rdapq",

package/.agents/skills/rdap-q/memory/README.md

@@ -1,4 +1,7 @@
 role: durable memory
 path: $RDAPQ_HOME/memory
+index: $RDAPQ_HOME/memory/index.md
 schema: core/memory.md
+load: index_then_hits
 promote_if: [durable, reusable, material, safe, grounded]
+caps: SKILL.md memory_caps

package/.agents/skills/rdap-q/memory/index.md

@@ -0,0 +1,3 @@
+schema: core/memory.md
+load: index_then_hits
+records: []

package/.agents/skills/rdap-q/playbooks/00-bootstrap.md

@@ -1,7 +1,10 @@
 phase: BOOTSTRAP
 do:
   - resolve home from SKILL.md; if unwritable, record that and use repo state only
-  - read task-relevant project memory, then global memory; do not bulk-load
+  - read memory/index.md; do not bulk-load memory/ or projects/
+  - if any memory or state file exceeds SKILL.md memory_caps, compact first: archive overflow, mark STALE/SUPERSEDED out of the load set, rewrite the index
+  - if compact would require guessing, emit MEMORY_CAP, stop promoting, continue with repo state only
+  - load at most 12 matching full records (project before global, ACTIVE only)
   - inspect root, status, branch, remotes, worktrees, languages, manifests, lockfiles, test, CI
   - do not assume main, a remote, or a package manager
   - create .rdapq/state files on first write; do not preload every template
@@ -14,4 +17,4 @@ inspect:
 git_mutation: playbooks/07-git-worktree.md # worktree, commit, push, or audit cleanup only
 out: [scope, assumptions, evidence, risks, iteration-log]
 next: DISCOVERY
-forbid: [imagined_repo, destroying_unrelated_work]
+forbid: [imagined_repo, destroying_unrelated_work, bulk_memory, diagrams, gzip_memory]

package/.agents/skills/rdap-q/playbooks/06-final-audit.md

@@ -1,7 +1,8 @@
 phase: AUDIT
 stance: disprove completion
-ask: [misread_requirement, unexercised_path, untested_failure, inferred_claim, stale_memory, false_dependency, regression, malformed_input, dependency_down, observable_errors, secrets, races, unintended_interface_change, extra_dependency, debug_or_unused, docs_match, diff_matches_scope]
-memory: [candidates, promotion_test, write_approved_only, invalidate_stale, no_secrets]
+ask: [misread_requirement, unexercised_path, untested_failure, inferred_claim, stale_memory, false_dependency, regression, malformed_input, dependency_down, observable_errors, secrets, races, unintended_interface_change, extra_dependency, debug_or_unused, docs_match, diff_matches_scope, memory_over_cap, index_stale]
+memory: [candidates, promotion_test, write_approved_only, invalidate_stale, no_secrets, under_cap, index_current]
 report: [quality, confidence, coverage, gates, defects, unknowns, history, best_remaining, aqc]
 complete_only_if: all_applicable_gates_pass
+fail_memory_gate_if: [secrets_stored, over_cap_uncompacted, index_missing_when_records_exist, bulk_memory_loaded, state_promoted_as_global]
 say: "Vibe Code Build complete."

package/.agents/skills/rdap-q/state/README.md

@@ -2,3 +2,5 @@ role: task state, not durable memory
 path: .rdapq/state
 create: on first write
 secrets: never
+caps: {evidence_records: 80, iteration_rounds: 20, file_bytes: 49152}
+store: ids and outcomes, not log bodies

package/.claude/commands/rdapq.md

@@ -1,5 +1,5 @@
 protocol: RDAP-Q
-version: "1.2.4"
+version: "1.2.5"
 on: [/rdapq, /rdap-q]
 load: .agents/skills/rdap-q/SKILL.md
 fallback: rdap-q-skill/SKILL.md

package/.claude-plugin/marketplace.json

@@ -8,7 +8,7 @@
   "plugins": [
     {
       "name": "rdap-q",
-      "version": "1.2.4",
+      "version": "1.2.5",
       "description": "Vendor-neutral engineering protocol for evidence-first software development, persistent state, calibrated 0-10 scoring, and diminishing-return exit gates.",
       "category": "development",
       "author": {

package/.claude-plugin/plugin-index.json

@@ -2,7 +2,7 @@
   "version": 1,
   "plugins": {
     "rdap-q": {
-      "version": "1.2.4",
+      "version": "1.2.5",
       "components": {
         "skills": [
           {

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "rdap-q",
-  "version": "1.2.4",
+  "version": "1.2.5",
   "displayName": "RDAP-Q: Adaptive Planning with Quality Gates",
   "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.",
   "author": {

package/.clinerules

@@ -1,5 +1,5 @@
 protocol: RDAP-Q
-version: "1.2.4"
+version: "1.2.5"
 on: [/rdapq, /rdap-q]
 load: .agents/skills/rdap-q/SKILL.md
 fallback: rdap-q-skill/SKILL.md

package/.codex/skill.json

@@ -1,6 +1,6 @@
 {
   "name": "rdap-q",
-  "version": "1.2.4",
+  "version": "1.2.5",
   "harness": "codex",
   "rules": "AGENTS.md",
   "entrypoint": "rdap-q-skill/SKILL.md",

package/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,38 @@
+---
+name: Bug report
+about: Create a report to help us improve
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+**Describe the bug**
+A clear and concise description of what the bug is.
+
+**To Reproduce**
+Steps to reproduce the behavior:
+1. Go to '...'
+2. Click on '....'
+3. Scroll down to '....'
+4. See error
+
+**Expected behavior**
+A clear and concise description of what you expected to happen.
+
+**Screenshots**
+If applicable, add screenshots to help explain your problem.
+
+**Desktop (please complete the following information):**
+ - OS: [e.g. iOS]
+ - Browser [e.g. chrome, safari]
+ - Version [e.g. 22]
+
+**Smartphone (please complete the following information):**
+ - Device: [e.g. iPhone6]
+ - OS: [e.g. iOS8.1]
+ - Browser [e.g. stock browser, safari]
+ - Version [e.g. 22]
+
+**Additional context**
+Add any other context about the problem here.

package/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,20 @@
+---
+name: Feature request
+about: Suggest an idea for this project
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+**Is your feature request related to a problem? Please describe.**
+A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+
+**Describe the solution you'd like**
+A clear and concise description of what you want to happen.
+
+**Describe alternatives you've considered**
+A clear and concise description of any alternative solutions or features you've considered.
+
+**Additional context**
+Add any other context or screenshots about the feature request here.

package/.github/copilot-instructions.md

@@ -1,5 +1,5 @@
 protocol: RDAP-Q
-version: "1.2.4"
+version: "1.2.5"
 on: [/rdapq, /rdap-q]
 load: .agents/skills/rdap-q/SKILL.md
 fallback: rdap-q-skill/SKILL.md

package/.goosehints

@@ -1,5 +1,5 @@
 protocol: RDAP-Q
-version: "1.2.4"
+version: "1.2.5"
 on: [/rdapq, /rdap-q]
 load: .agents/skills/rdap-q/SKILL.md
 fallback: rdap-q-skill/SKILL.md

package/.grok/rules.md

@@ -1,5 +1,5 @@
 protocol: RDAP-Q
-version: "1.2.4"
+version: "1.2.5"
 on: [/rdapq, /rdap-q]
 load: .agents/skills/rdap-q/SKILL.md
 fallback: rdap-q-skill/SKILL.md

package/.grok/skill.json

@@ -1,6 +1,6 @@
 {
   "name": "rdap-q",
-  "version": "1.2.4",
+  "version": "1.2.5",
   "harness": "grok",
   "rules": ".grok/rules.md",
   "entrypoint": "rdap-q-skill/SKILL.md",

package/.grok-plugin/marketplace.json

@@ -8,7 +8,7 @@
   "plugins": [
     {
       "name": "rdap-q",
-      "version": "1.2.4",
+      "version": "1.2.5",
       "description": "Vendor-neutral engineering protocol for evidence-first software development, persistent state, calibrated 0-10 scoring, and diminishing-return exit gates.",
       "category": "development",
       "author": {

package/.grok-plugin/plugin-index.json

@@ -2,7 +2,7 @@
   "version": 1,
   "plugins": {
     "rdap-q": {
-      "version": "1.2.4",
+      "version": "1.2.5",
       "components": {
         "skills": [
           {

package/AGENTS.md

@@ -1,5 +1,5 @@
 protocol: RDAP-Q
-version: "1.2.4"
+version: "1.2.5"
 on: [/rdapq, /rdap-q]
 load: .agents/skills/rdap-q/SKILL.md
 fallback: rdap-q-skill/SKILL.md

package/CLAUDE.md

@@ -1,5 +1,5 @@
 protocol: RDAP-Q
-version: "1.2.4"
+version: "1.2.5"
 on: [/rdapq, /rdap-q]
 load: .agents/skills/rdap-q/SKILL.md
 fallback: rdap-q-skill/SKILL.md

package/GEMINI.md

@@ -1,5 +1,5 @@
 protocol: RDAP-Q
-version: "1.2.4"
+version: "1.2.5"
 on: [/rdapq, /rdap-q]
 load: .agents/skills/rdap-q/SKILL.md
 fallback: rdap-q-skill/SKILL.md

package/README.md

@@ -3,7 +3,7 @@
 
 [![CI](https://github.com/coldcanuk/rdapq/actions/workflows/ci.yml/badge.svg)](https://github.com/coldcanuk/rdapq/actions/workflows/ci.yml)
 [![License: GPL-3.0](https://img.shields.io/badge/License-GPL--3.0-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)
-[![Protocol Version](https://img.shields.io/badge/Protocol-v1.2.4-emerald.svg)](https://github.com/coldcanuk/rdapq)
+[![Protocol Version](https://img.shields.io/badge/Protocol-v1.2.5-emerald.svg)](https://github.com/coldcanuk/rdapq)
 [![Command](https://img.shields.io/badge/Command-%2Frdapq-purple.svg)](https://github.com/coldcanuk/rdapq)
 [![Marketplace: Universal](https://img.shields.io/badge/Marketplace-Ready-orange.svg)](https://github.com/coldcanuk/rdapq/blob/main/marketplace.json)
 [![Codex](https://img.shields.io/badge/OpenAI%20Codex-Supported-green.svg)](#in-harness-marketplace-installation)
@@ -29,7 +29,7 @@
   "@type": "SoftwareSourceCode",
   "name": "RDAP-Q",
   "alternateName": "Research-Driven Adaptive Planning with Quality Gates",
-  "version": "1.2.4",
+  "version": "1.2.5",
   "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.",
   "codeRepository": "https://github.com/coldcanuk/rdapq",
   "license": "https://www.gnu.org/licenses/gpl-3.0",
@@ -148,7 +148,7 @@ That is optional. It is not required for `install --claude` or `init`.
 
 ## <a id="npm-npx-installation"></a> ⚡ Install
 
-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.
+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.5**. Do not pipe an installer from the network (`curl | bash`, `irm | iex`). A piped script cannot see the skill tree and is refused.
 
 `SKILL.md` is the instruction source the agent loads. This README is the human guide.
 
@@ -168,7 +168,7 @@ npx --yes rdap-q install --cursor
 npx --yes rdap-q install --codex --grok
 
 # This release, not whatever is tagged latest later:
-npx --yes rdap-q@1.2.4 install --claude
+npx --yes rdap-q@1.2.5 install --claude
 ```
 
 ### All 8 harnesses:
@@ -264,7 +264,7 @@ npx --yes rdap-q@latest status
 Use the same harness flags you used the first time. `--cursor` above is only an example. To stay on this release:
 
 ```bash
-npx --yes rdap-q@1.2.4 install --cursor
+npx --yes rdap-q@1.2.5 install --cursor
 ```
 
 ### Command installed globally
@@ -278,7 +278,7 @@ rdapq status
 ```bash
 cd rdapq
 git fetch origin --tags
-git checkout v1.2.4          # or: git pull origin main
+git checkout v1.2.5          # or: git pull origin main
 ./install.sh --claude        # same flags as the first install
 ./install.sh status
 ```
@@ -286,7 +286,7 @@ git checkout v1.2.4          # or: git pull origin main
 ```powershell
 cd rdapq
 git fetch origin --tags
-git checkout v1.2.4
+git checkout v1.2.5
 .\install.ps1 -Claude
 node .\bin\rdapq.js status
 ```

package/agentskills.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://raw.githubusercontent.com/agent-skills/spec/main/agentskills.schema.json",
   "name": "rdap-q",
-  "version": "1.2.4",
+  "version": "1.2.5",
   "type": "skill",
   "entrypoint": "rdap-q-skill/SKILL.md",
   "invocation": "/rdapq",

package/manifest.json

@@ -1,6 +1,6 @@
 {
   "name": "rdap-q",
-  "version": "1.2.4",
+  "version": "1.2.5",
   "protocol_name": "RDAP-Q Agent Engineering Protocol",
   "entrypoint": "rdap-q-skill/SKILL.md",
   "invocation": "/rdapq",

package/marketplace.json

@@ -2,7 +2,7 @@
   "$schema": "https://raw.githubusercontent.com/agent-skills/spec/main/marketplace.schema.json",
   "name": "rdap-q",
   "displayName": "RDAP-Q: Adaptive Planning with Quality Gates",
-  "version": "1.2.4",
+  "version": "1.2.5",
   "protocol": "RDAP-Q Agent Engineering Protocol",
   "summary": "Universal AI agent engineering protocol for evidence-first software development, calibrated scoring, and quality gates across Codex, Grok, Copilot, Antigravity, Goose, Claude, Cline, and Cursor.",
   "description": "Vendor-neutral Research-Driven Adaptive Planning with Quality Gates (RDAP-Q) enables autonomous AI coding agents to execute non-trivial software tasks with disciplined evidence collection, deterministic phase execution, persistent project state, calibrated quality scoring (0-10 scale), and diminishing-return exit logic. Native support for OpenAI Codex, xAI Grok, GitHub Copilot, Google Antigravity, Block Goose, Anthropic Claude, Cline, and Cursor.",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rdap-q",
-  "version": "1.2.4",
+  "version": "1.2.5",
   "description": "Research-Driven Adaptive Planning with Quality Gates (RDAP-Q) — Vendor-neutral AI agent engineering protocol & skill for Codex, Grok, Copilot, Antigravity, Goose, Claude, Cline, and Cursor. Evidence-first software engineering, persistent memory, and calibrated quality gates.",
   "main": "rdap-q-skill/SKILL.md",
   "bin": {

package/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "rdap-q",
-  "version": "1.2.4",
+  "version": "1.2.5",
   "description": "Research-Driven Adaptive Planning with Quality Gates protocol plugin for Google Antigravity & AI agents.",
   "rules": [
     "GEMINI.md",

package/plugins/rdap-q/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "rdap-q",
-  "version": "1.2.4",
+  "version": "1.2.5",
   "description": "Research-Driven Adaptive Planning with Quality Gates protocol for evidence-first software engineering and diminishing-return exit gates.",
   "author": {
     "name": "coldcanuk"

package/plugins/rdap-q/skills/rdap-q/README.md

@@ -1,4 +1,4 @@
-# RDAP-Q Skill v1.2.4
+# RDAP-Q Skill v1.2.5
 
 `SKILL.md` is the instruction source. This README is not a second copy of the protocol.
 

package/plugins/rdap-q/skills/rdap-q/SKILL.md

@@ -4,14 +4,26 @@ description: Run the RDAP-Q evidence-first engineering protocol. Invoke with /rd
 disable-model-invocation: true
 ---
 name: rdap-q
-version: "1.2.4"
+version: "1.2.5"
 description: Evidence-first engineering protocol. Load this file, then the current phase playbook only.
 invocation: /rdapq
 home_env: RDAPQ_HOME
 home: RDAPQ_HOME else ~/.rdapq (Windows %USERPROFILE%\.rdapq)
 state: .rdapq/state
 memory: $RDAPQ_HOME/memory
+memory_index: $RDAPQ_HOME/memory/index.md
 facts: [OBSERVED, USER_SPECIFIED, VERIFIED_EXTERNAL, INFERRED, UNKNOWN]
+memory_caps:
+  load_full_records: 12
+  load_index_rows: 80
+  fact_chars: 240
+  evidence_chars: 160
+  file_bytes: 24576
+  global_active: 80
+  project_active: 40
+  state_evidence_records: 80
+  state_iteration_rounds: 20
+  state_file_bytes: 49152
 rules:
   - evidence before inference; never invent paths, APIs, versions, flags, tests, env, or architecture
   - INFERRED or UNKNOWN cannot decide implementation when verification is possible
@@ -21,12 +33,14 @@ rules:
   - task state stays in .rdapq/state; memory is reusable only; current evidence beats memory
   - never store secret values; a source plus an identifier is allowed
   - do not load manifest.json, other playbooks, diagrams, or bulk memory
+  - load memory/index.md first, then at most 12 matching full records; compact before work if over cap
+  - never bulk-read memory/ or projects/; never gzip, base64, or one-line-tarball memory
 commands:
   status: phase, quality, confidence, gates, blockers, iteration
   score: evidence-linked scorecard
   audit: adversarial final audit
-  resume: reload memory and state, then check drift
-  memory: relevant memories and status; never print secrets
+  resume: compact if over cap, reload index and hits plus state, then check drift
+  memory: relevant ACTIVE memories and status; never print secrets; never dump the store
   research: discovery
   explain: why this phase or exit
 weights: {correctness: 25, coverage: 15, verification: 15, integration: 10, security: 10, maintainability: 10, architecture: 8, operability: 7}

package/plugins/rdap-q/skills/rdap-q/core/controller.md

@@ -1,14 +1,14 @@
 when: whole_loop_or_ambiguous_next_state
 order:
   - resolve home; if unwritable, record it and use repo state
-  - load SKILL.md, repo root, relevant memory, then .rdapq/state if present
+  - load SKILL.md, repo root, memory index, compact if over cap, then at most 12 hits, then .rdapq/state if present
   - load the current playbook only; observe before acting
   - update facts, assumptions, evidence, risks, decisions
   - milestone: verify, review, score, gate, decide, persist
   - invalid plan -> PLAN; worthwhile fix -> iterate
   - gates pass and diminishing -> audit, then COMPLETE
   - else emit the accurate non-complete terminal state
-  - promote only durable lessons
+  - promote only durable lessons that pass write_forbid and caps
 precedence: [user_intent, direct_evidence, repo_state, project_memory, global_memory, external_for_this_version, inference]
 replan_if_changes: [scope, architecture, dependencies, sequencing, risk, verification, success_criteria]
-context: targeted reads; do not replay chat or load the whole skill tree
+context: targeted reads; do not replay chat or load the whole skill tree; never bulk-read memory/

package/plugins/rdap-q/skills/rdap-q/core/gates.md

@@ -8,5 +8,5 @@ gates:
   regression: [existing_tests_pass, no_known_material_regression]
   security: [no_new_material_issue, no_secrets_stored, destructive_safeguards, risk_proportional_checks]
   repository: [diff_reviewed, no_unintended_files, no_conflicts, state_understood, unrelated_work_kept]
-  memory: [no_secrets, promotion_test, stale_handled, state_not_promoted_as_global]
+  memory: [no_secrets, promotion_test, stale_handled, state_not_promoted_as_global, under_cap, index_current]
   quality: target_met_or_diminishing_returns_and_other_gates_pass

package/plugins/rdap-q/skills/rdap-q/core/memory.md

@@ -2,10 +2,44 @@ scopes:
   global: "$RDAPQ_HOME/memory/{engineering-preferences,tooling,lessons,patterns,constraints}.md"
   project: "$RDAPQ_HOME/projects/<id>/{project,architecture,lessons,decisions}.md"
   task: .rdapq/state
+index: "$RDAPQ_HOME/memory/index.md"
+load: index_then_hits
 promote_if_all: [durable, reusable, material, safe, grounded]
 record: {id: M-<id>, scope: "global|project:<id>", status: [ACTIVE, STALE, SUPERSEDED, INVALID], class: [USER_SPECIFIED, OBSERVED, VERIFIED_EXTERNAL, INFERRED], confidence: "0-10", verified: YYYY-MM-DD, supersedes: "id|none", superseded_by: "id|none", fact: str, evidence: str}
+index_row: {id: M-<id>, kind: str, scope: "global|project:<id>", status: str, class: str, one_line: str}
 secrets: never values; source plus identifier only
 on_conflict: trust direct evidence; mark STALE, SUPERSEDED, or INVALID; link ids; do not silent-delete
-load: relevant project, then relevant global
-memory_cmd: relevant entries, status, conflicts; never print secrets
-resume: home, project memory, repo state, last phase, inspect drift, continue at first unverified step
+load_order: relevant index rows, then matching full records, project before global
+memory_cmd: relevant ACTIVE entries, status, conflicts; never print secrets; never dump the store
+resume: home, index, compact if over cap, load hits, repo state, last phase, inspect drift, continue at first unverified step
+caps:
+  load_full_records: 12
+  load_index_rows: 80
+  fact_chars: 240
+  evidence_chars: 160
+  file_bytes: 24576
+  global_active: 80
+  project_active: 40
+  state_evidence_records: 80
+  state_iteration_rounds: 20
+  state_file_bytes: 49152
+refuse:
+  - bulk_read of memory/ or projects/
+  - diagrams (.mmd)
+  - manifest.json
+  - playbooks other than current phase
+  - gzip, base64, or one-line tarball encodings
+write_forbid:
+  - secret values
+  - command output, diffs, logs, chat
+  - INFERRED when verification was possible
+  - duplicate of an ACTIVE one_line
+  - fact longer than fact_chars
+  - evidence longer than evidence_chars
+  - promoting .rdapq/state into global memory
+on_cap:
+  stop_append: true
+  compact: [STALE, SUPERSEDED, INVALID]
+  overflow: archive to memory/archive/YYYY-MM.md
+  say: "MEMORY_CAP — compacted, not loaded"
+over_cap_without_safe_compact: stop promoting; emit MEMORY_CAP; do not keep appending

package/plugins/rdap-q/skills/rdap-q/manifest.json

@@ -1,6 +1,6 @@
 {
   "name": "rdap-q",
-  "version": "1.2.4",
+  "version": "1.2.5",
   "protocol_name": "RDAP-Q Agent Engineering Protocol",
   "entrypoint": "SKILL.md",
   "invocation": "/rdapq",

package/plugins/rdap-q/skills/rdap-q/memory/README.md

@@ -1,4 +1,7 @@
 role: durable memory
 path: $RDAPQ_HOME/memory
+index: $RDAPQ_HOME/memory/index.md
 schema: core/memory.md
+load: index_then_hits
 promote_if: [durable, reusable, material, safe, grounded]
+caps: SKILL.md memory_caps

package/plugins/rdap-q/skills/rdap-q/memory/index.md

@@ -0,0 +1,3 @@
+schema: core/memory.md
+load: index_then_hits
+records: []

package/plugins/rdap-q/skills/rdap-q/playbooks/00-bootstrap.md

@@ -1,7 +1,10 @@
 phase: BOOTSTRAP
 do:
   - resolve home from SKILL.md; if unwritable, record that and use repo state only
-  - read task-relevant project memory, then global memory; do not bulk-load
+  - read memory/index.md; do not bulk-load memory/ or projects/
+  - if any memory or state file exceeds SKILL.md memory_caps, compact first: archive overflow, mark STALE/SUPERSEDED out of the load set, rewrite the index
+  - if compact would require guessing, emit MEMORY_CAP, stop promoting, continue with repo state only
+  - load at most 12 matching full records (project before global, ACTIVE only)
   - inspect root, status, branch, remotes, worktrees, languages, manifests, lockfiles, test, CI
   - do not assume main, a remote, or a package manager
   - create .rdapq/state files on first write; do not preload every template
@@ -14,4 +17,4 @@ inspect:
 git_mutation: playbooks/07-git-worktree.md # worktree, commit, push, or audit cleanup only
 out: [scope, assumptions, evidence, risks, iteration-log]
 next: DISCOVERY
-forbid: [imagined_repo, destroying_unrelated_work]
+forbid: [imagined_repo, destroying_unrelated_work, bulk_memory, diagrams, gzip_memory]

package/plugins/rdap-q/skills/rdap-q/playbooks/06-final-audit.md

@@ -1,7 +1,8 @@
 phase: AUDIT
 stance: disprove completion
-ask: [misread_requirement, unexercised_path, untested_failure, inferred_claim, stale_memory, false_dependency, regression, malformed_input, dependency_down, observable_errors, secrets, races, unintended_interface_change, extra_dependency, debug_or_unused, docs_match, diff_matches_scope]
-memory: [candidates, promotion_test, write_approved_only, invalidate_stale, no_secrets]
+ask: [misread_requirement, unexercised_path, untested_failure, inferred_claim, stale_memory, false_dependency, regression, malformed_input, dependency_down, observable_errors, secrets, races, unintended_interface_change, extra_dependency, debug_or_unused, docs_match, diff_matches_scope, memory_over_cap, index_stale]
+memory: [candidates, promotion_test, write_approved_only, invalidate_stale, no_secrets, under_cap, index_current]
 report: [quality, confidence, coverage, gates, defects, unknowns, history, best_remaining, aqc]
 complete_only_if: all_applicable_gates_pass
+fail_memory_gate_if: [secrets_stored, over_cap_uncompacted, index_missing_when_records_exist, bulk_memory_loaded, state_promoted_as_global]
 say: "Vibe Code Build complete."

package/plugins/rdap-q/skills/rdap-q/state/README.md

@@ -2,3 +2,5 @@ role: task state, not durable memory
 path: .rdapq/state
 create: on first write
 secrets: never
+caps: {evidence_records: 80, iteration_rounds: 20, file_bytes: 49152}
+store: ids and outcomes, not log bodies

package/rdap-q-skill/README.md

@@ -1,4 +1,4 @@
-# RDAP-Q Skill v1.2.4
+# RDAP-Q Skill v1.2.5
 
 `SKILL.md` is the instruction source. This README is not a second copy of the protocol.
 

package/rdap-q-skill/SKILL.md

@@ -4,14 +4,26 @@ description: Run the RDAP-Q evidence-first engineering protocol. Invoke with /rd
 disable-model-invocation: true
 ---
 name: rdap-q
-version: "1.2.4"
+version: "1.2.5"
 description: Evidence-first engineering protocol. Load this file, then the current phase playbook only.
 invocation: /rdapq
 home_env: RDAPQ_HOME
 home: RDAPQ_HOME else ~/.rdapq (Windows %USERPROFILE%\.rdapq)
 state: .rdapq/state
 memory: $RDAPQ_HOME/memory
+memory_index: $RDAPQ_HOME/memory/index.md
 facts: [OBSERVED, USER_SPECIFIED, VERIFIED_EXTERNAL, INFERRED, UNKNOWN]
+memory_caps:
+  load_full_records: 12
+  load_index_rows: 80
+  fact_chars: 240
+  evidence_chars: 160
+  file_bytes: 24576
+  global_active: 80
+  project_active: 40
+  state_evidence_records: 80
+  state_iteration_rounds: 20
+  state_file_bytes: 49152
 rules:
   - evidence before inference; never invent paths, APIs, versions, flags, tests, env, or architecture
   - INFERRED or UNKNOWN cannot decide implementation when verification is possible
@@ -21,12 +33,14 @@ rules:
   - task state stays in .rdapq/state; memory is reusable only; current evidence beats memory
   - never store secret values; a source plus an identifier is allowed
   - do not load manifest.json, other playbooks, diagrams, or bulk memory
+  - load memory/index.md first, then at most 12 matching full records; compact before work if over cap
+  - never bulk-read memory/ or projects/; never gzip, base64, or one-line-tarball memory
 commands:
   status: phase, quality, confidence, gates, blockers, iteration
   score: evidence-linked scorecard
   audit: adversarial final audit
-  resume: reload memory and state, then check drift
-  memory: relevant memories and status; never print secrets
+  resume: compact if over cap, reload index and hits plus state, then check drift
+  memory: relevant ACTIVE memories and status; never print secrets; never dump the store
   research: discovery
   explain: why this phase or exit
 weights: {correctness: 25, coverage: 15, verification: 15, integration: 10, security: 10, maintainability: 10, architecture: 8, operability: 7}

package/rdap-q-skill/core/controller.md

@@ -1,14 +1,14 @@
 when: whole_loop_or_ambiguous_next_state
 order:
   - resolve home; if unwritable, record it and use repo state
-  - load SKILL.md, repo root, relevant memory, then .rdapq/state if present
+  - load SKILL.md, repo root, memory index, compact if over cap, then at most 12 hits, then .rdapq/state if present
   - load the current playbook only; observe before acting
   - update facts, assumptions, evidence, risks, decisions
   - milestone: verify, review, score, gate, decide, persist
   - invalid plan -> PLAN; worthwhile fix -> iterate
   - gates pass and diminishing -> audit, then COMPLETE
   - else emit the accurate non-complete terminal state
-  - promote only durable lessons
+  - promote only durable lessons that pass write_forbid and caps
 precedence: [user_intent, direct_evidence, repo_state, project_memory, global_memory, external_for_this_version, inference]
 replan_if_changes: [scope, architecture, dependencies, sequencing, risk, verification, success_criteria]
-context: targeted reads; do not replay chat or load the whole skill tree
+context: targeted reads; do not replay chat or load the whole skill tree; never bulk-read memory/

package/rdap-q-skill/core/gates.md

@@ -8,5 +8,5 @@ gates:
   regression: [existing_tests_pass, no_known_material_regression]
   security: [no_new_material_issue, no_secrets_stored, destructive_safeguards, risk_proportional_checks]
   repository: [diff_reviewed, no_unintended_files, no_conflicts, state_understood, unrelated_work_kept]
-  memory: [no_secrets, promotion_test, stale_handled, state_not_promoted_as_global]
+  memory: [no_secrets, promotion_test, stale_handled, state_not_promoted_as_global, under_cap, index_current]
   quality: target_met_or_diminishing_returns_and_other_gates_pass

package/rdap-q-skill/core/memory.md

@@ -2,10 +2,44 @@ scopes:
   global: "$RDAPQ_HOME/memory/{engineering-preferences,tooling,lessons,patterns,constraints}.md"
   project: "$RDAPQ_HOME/projects/<id>/{project,architecture,lessons,decisions}.md"
   task: .rdapq/state
+index: "$RDAPQ_HOME/memory/index.md"
+load: index_then_hits
 promote_if_all: [durable, reusable, material, safe, grounded]
 record: {id: M-<id>, scope: "global|project:<id>", status: [ACTIVE, STALE, SUPERSEDED, INVALID], class: [USER_SPECIFIED, OBSERVED, VERIFIED_EXTERNAL, INFERRED], confidence: "0-10", verified: YYYY-MM-DD, supersedes: "id|none", superseded_by: "id|none", fact: str, evidence: str}
+index_row: {id: M-<id>, kind: str, scope: "global|project:<id>", status: str, class: str, one_line: str}
 secrets: never values; source plus identifier only
 on_conflict: trust direct evidence; mark STALE, SUPERSEDED, or INVALID; link ids; do not silent-delete
-load: relevant project, then relevant global
-memory_cmd: relevant entries, status, conflicts; never print secrets
-resume: home, project memory, repo state, last phase, inspect drift, continue at first unverified step
+load_order: relevant index rows, then matching full records, project before global
+memory_cmd: relevant ACTIVE entries, status, conflicts; never print secrets; never dump the store
+resume: home, index, compact if over cap, load hits, repo state, last phase, inspect drift, continue at first unverified step
+caps:
+  load_full_records: 12
+  load_index_rows: 80
+  fact_chars: 240
+  evidence_chars: 160
+  file_bytes: 24576
+  global_active: 80
+  project_active: 40
+  state_evidence_records: 80
+  state_iteration_rounds: 20
+  state_file_bytes: 49152
+refuse:
+  - bulk_read of memory/ or projects/
+  - diagrams (.mmd)
+  - manifest.json
+  - playbooks other than current phase
+  - gzip, base64, or one-line tarball encodings
+write_forbid:
+  - secret values
+  - command output, diffs, logs, chat
+  - INFERRED when verification was possible
+  - duplicate of an ACTIVE one_line
+  - fact longer than fact_chars
+  - evidence longer than evidence_chars
+  - promoting .rdapq/state into global memory
+on_cap:
+  stop_append: true
+  compact: [STALE, SUPERSEDED, INVALID]
+  overflow: archive to memory/archive/YYYY-MM.md
+  say: "MEMORY_CAP — compacted, not loaded"
+over_cap_without_safe_compact: stop promoting; emit MEMORY_CAP; do not keep appending

package/rdap-q-skill/manifest.json

@@ -1,6 +1,6 @@
 {
   "name": "rdap-q",
-  "version": "1.2.4",
+  "version": "1.2.5",
   "protocol_name": "RDAP-Q Agent Engineering Protocol",
   "entrypoint": "SKILL.md",
   "invocation": "/rdapq",

package/rdap-q-skill/memory/README.md

@@ -1,4 +1,7 @@
 role: durable memory
 path: $RDAPQ_HOME/memory
+index: $RDAPQ_HOME/memory/index.md
 schema: core/memory.md
+load: index_then_hits
 promote_if: [durable, reusable, material, safe, grounded]
+caps: SKILL.md memory_caps

package/rdap-q-skill/memory/index.md

@@ -0,0 +1,3 @@
+schema: core/memory.md
+load: index_then_hits
+records: []

package/rdap-q-skill/playbooks/00-bootstrap.md

@@ -1,7 +1,10 @@
 phase: BOOTSTRAP
 do:
   - resolve home from SKILL.md; if unwritable, record that and use repo state only
-  - read task-relevant project memory, then global memory; do not bulk-load
+  - read memory/index.md; do not bulk-load memory/ or projects/
+  - if any memory or state file exceeds SKILL.md memory_caps, compact first: archive overflow, mark STALE/SUPERSEDED out of the load set, rewrite the index
+  - if compact would require guessing, emit MEMORY_CAP, stop promoting, continue with repo state only
+  - load at most 12 matching full records (project before global, ACTIVE only)
   - inspect root, status, branch, remotes, worktrees, languages, manifests, lockfiles, test, CI
   - do not assume main, a remote, or a package manager
   - create .rdapq/state files on first write; do not preload every template
@@ -14,4 +17,4 @@ inspect:
 git_mutation: playbooks/07-git-worktree.md # worktree, commit, push, or audit cleanup only
 out: [scope, assumptions, evidence, risks, iteration-log]
 next: DISCOVERY
-forbid: [imagined_repo, destroying_unrelated_work]
+forbid: [imagined_repo, destroying_unrelated_work, bulk_memory, diagrams, gzip_memory]

package/rdap-q-skill/playbooks/06-final-audit.md

@@ -1,7 +1,8 @@
 phase: AUDIT
 stance: disprove completion
-ask: [misread_requirement, unexercised_path, untested_failure, inferred_claim, stale_memory, false_dependency, regression, malformed_input, dependency_down, observable_errors, secrets, races, unintended_interface_change, extra_dependency, debug_or_unused, docs_match, diff_matches_scope]
-memory: [candidates, promotion_test, write_approved_only, invalidate_stale, no_secrets]
+ask: [misread_requirement, unexercised_path, untested_failure, inferred_claim, stale_memory, false_dependency, regression, malformed_input, dependency_down, observable_errors, secrets, races, unintended_interface_change, extra_dependency, debug_or_unused, docs_match, diff_matches_scope, memory_over_cap, index_stale]
+memory: [candidates, promotion_test, write_approved_only, invalidate_stale, no_secrets, under_cap, index_current]
 report: [quality, confidence, coverage, gates, defects, unknowns, history, best_remaining, aqc]
 complete_only_if: all_applicable_gates_pass
+fail_memory_gate_if: [secrets_stored, over_cap_uncompacted, index_missing_when_records_exist, bulk_memory_loaded, state_promoted_as_global]
 say: "Vibe Code Build complete."

package/rdap-q-skill/state/README.md

@@ -2,3 +2,5 @@ role: task state, not durable memory
 path: .rdapq/state
 create: on first write
 secrets: never
+caps: {evidence_records: 80, iteration_rounds: 20, file_bytes: 49152}
+store: ids and outcomes, not log bodies

package/skills.json

@@ -3,7 +3,7 @@
   "skills": [
     {
       "name": "rdap-q",
-      "version": "1.2.4",
+      "version": "1.2.5",
       "title": "RDAP-Q: Research-Driven Adaptive Planning with Quality Gates",
       "description": "Vendor-neutral engineering protocol for evidence-first software development, persistent state, calibrated 0-10 scoring, and diminishing-return exit gates.",
       "entrypoint": "rdap-q-skill/SKILL.md",