rdap-q 1.2.1

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

@@ -0,0 +1,4 @@
+role: durable memory
+path: $RDAPQ_HOME/memory
+schema: core/memory.md
+promote_if: [durable, reusable, material, safe, grounded]

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

@@ -0,0 +1,3 @@
+scope: global
+kind: constraints
+records: []

package/.agents/skills/rdap-q/memory/engineering-preferences.md

@@ -0,0 +1,3 @@
+scope: global
+kind: engineering-preferences
+records: []

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

@@ -0,0 +1,3 @@
+scope: global
+kind: lessons
+records: []

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

@@ -0,0 +1,3 @@
+scope: global
+kind: patterns
+records: []

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

@@ -0,0 +1,3 @@
+scope: global
+kind: tooling
+records: []

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

@@ -0,0 +1,17 @@
+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
+  - 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
+inspect:
+  - git status --short
+  - git branch --show-current
+  - git remote -v
+  - git branch -a
+  - git worktree list
+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]

package/.agents/skills/rdap-q/playbooks/01-discovery.md

@@ -0,0 +1,9 @@
+phase: DISCOVERY
+sources: [local_source, project_config, upstream_docs, upstream_source, experiment, secondary]
+per_assumption: [record, materiality, needed_evidence, investigate, status]
+block_exit:
+  critical_unknown: true
+  high_unresolved_if: [architecture, interfaces, security, persistence, compatibility, destructive]
+memory: may suggest questions; never replaces evidence; candidates stay unpromoted
+out: [questions, repo, architecture, external, experiments, resolved, unresolved, implications, evidence_ids]
+next: PLAN

package/.agents/skills/rdap-q/playbooks/02-planning.md

@@ -0,0 +1,6 @@
+phase: PLAN
+shape: [phases, milestones, tasks]
+task: [id, milestone, objective, files_if_known, evidence, action, commands_or_TBD-EVIDENCE, verification, observable, dependencies]
+plan_weights: {coverage: 15, grounding: 15, architecture: 15, completeness: 10, order: 10, verification: 15, risk: 10, repro: 5, git_safety: 5}
+block_execute_if: [ambiguous_success, critical_assumption_open, imagined_paths, task_without_verification, destructive_without_safeguard, bad_order]
+out: .rdapq/state/plan.md

package/.agents/skills/rdap-q/playbooks/03-architecture.md

@@ -0,0 +1,6 @@
+phase: ARCHITECTURE
+when: [interfaces, boundaries, persistence, security, concurrency, integration]
+record: [components, responsibilities, interfaces, data_flow, persistence, compatibility, failures, security, runtime, rejected]
+decision: [decision, evidence, alternatives, why, risks, verification]
+rules: [fit_current_system, no_unrelated_refactor, promote_only_if_durable_and_verified]
+out: decisions.md

package/.agents/skills/rdap-q/playbooks/04-implementation.md

@@ -0,0 +1,8 @@
+phase: IMPLEMENT
+loop: [observe, implement, verify, review]
+observe: [affected_code, interfaces, versions, nearby_tests, memory_if_it_affects_the_edit]
+implement: [smallest_change, no_driveby_refactor, preserve_behavior_unless_intended, no_secrets, no_speculative_abstraction]
+verify: planned checks only; an unrun test is not a pass
+review: [status, diff, whitespace, generated, debug, secrets, unrelated, todos]
+close_when: [tasks_done, definition_of_done, verification, diff_reviewed, state_updated, gates]
+vcs: commit only a coherent milestone

package/.agents/skills/rdap-q/playbooks/05-verification.md

@@ -0,0 +1,6 @@
+phase: VERIFY
+use_real_stack_only: [unit, integration, e2e, build, lint, format, types, static_analysis, security, race, migration, perf, manual]
+on_fail: [record, severity, cause, return_to_IMPLEMENT, rerun]
+if_cannot_run: "NOT VERIFIED — ENVIRONMENTAL CONSTRAINT"
+forbid: [invented_commands, averaging_a_failure_into_the_score]
+each_result: evidence_id

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

@@ -0,0 +1,7 @@
+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]
+report: [quality, confidence, coverage, gates, defects, unknowns, history, best_remaining, aqc]
+complete_only_if: all_applicable_gates_pass
+say: "Vibe Code Build complete."

package/.agents/skills/rdap-q/playbooks/07-git-worktree.md

@@ -0,0 +1,13 @@
+phase: GIT
+when: [worktree_requested, commit_requested, push_requested, audit_cleanup]
+inspect_already_in: playbooks/00-bootstrap.md
+never_without_explicit_authorization: ["git reset --hard", "git clean -fd", "git push --force"]
+forbid: destroying_unrelated_work
+worktree_when_requested:
+  - use the inspected default branch and remote; do not assume main
+  - "git checkout <default> && git pull --ff-only <remote> <default>"
+  - "git worktree add -b gb/<slug> ../gb-<slug>-wt"
+commit_when_milestone: ["git diff --check", "git add -A", "git diff --cached", "git commit -m 'Milestone X.Y: <summary>'"]
+empty_commits: false
+push: "git push -u <remote> <branch>"
+cleanup_after_merge: ["git worktree remove <path>", "git branch -d <branch>"]

package/.agents/skills/rdap-q/projects/architecture.md

@@ -0,0 +1,3 @@
+scope: project
+kind: architecture
+records: []

package/.agents/skills/rdap-q/projects/decisions.md

@@ -0,0 +1,3 @@
+scope: project
+kind: decisions
+records: []

package/.agents/skills/rdap-q/projects/lessons.md

@@ -0,0 +1,3 @@
+scope: project
+kind: lessons
+records: []

package/.agents/skills/rdap-q/projects/project.md

@@ -0,0 +1,3 @@
+scope: project
+kind: project
+records: []

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

@@ -0,0 +1,4 @@
+role: task state, not durable memory
+path: .rdapq/state
+create: on first write
+secrets: never

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

@@ -0,0 +1,3 @@
+# classes: SKILL.md facts plus RESOLVED
+records: [] # id, statement, status, materiality, evidence_ids, next
+block: critical UNKNOWN before implementation; unresolved HIGH on architecture, interfaces, security, persistence, compatibility, or destructive work

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

@@ -0,0 +1,2 @@
+# fields: playbooks/03-architecture.md decision
+records: []

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

@@ -0,0 +1,3 @@
+records: [] # id, type, claim, source, outcome
+types: [OBSERVED, USER_SPECIFIED, VERIFIED_EXTERNAL, INFERRED, UNKNOWN, TEST, BUILD, STATIC_ANALYSIS, RUNTIME, VCS, CONSTRAINT]
+forbid: [unrun_command_as_pass, secrets]

package/.agents/skills/rdap-q/state/iteration-log.md

@@ -0,0 +1 @@
+rounds: [] # from, to, reason, gates, unknowns, evidence, memory, quality, confidence, coverage, defects, dQ, effort, decision

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

@@ -0,0 +1,4 @@
+# task shape: playbooks/02-planning.md
+milestones: [] # id, phase, tasks
+plan_score:
+plan_gates:

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

@@ -0,0 +1,13 @@
+questions: []
+repo: []
+architecture: []
+external: []
+experiments: []
+resolved: []
+unresolved: []
+implications: []
+memory_candidates: []
+evidence_ids: []
+readiness:
+  score:
+  gates:

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

@@ -0,0 +1,2 @@
+records: [] # id, risk, probability, impact, evidence_ids, mitigation, status
+forbid: invented_risks_to_fill_a_quota

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

@@ -0,0 +1,9 @@
+goal:
+non_goals: []
+success: []
+constraints: []
+env: []
+risk: "LOW|MODERATE|HIGH|CRITICAL"
+target:
+confidence:
+coverage:

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

@@ -0,0 +1,15 @@
+# weights and anchors: SKILL.md. gate names: core/gates.md
+risk:
+target:
+quality:
+confidence:
+coverage:
+gates:
+critical:
+high:
+unknowns:
+previous:
+delta:
+aqc:
+rows: [] # dimension, score, evidence_ids, gap
+improvements: [] # severity, dQ, risk, effort, confidence, decision

package/.agents/skills/rdap-q/templates/final-report.md

@@ -0,0 +1,31 @@
+# fields already defined in SKILL.md and core/exit-logic.md
+result:
+risk:
+target:
+quality:
+confidence:
+coverage:
+gates:
+critical:
+high:
+unknowns:
+aqc:
+history: []
+exit:
+verification: []
+memory:
+  loaded: []
+  added: []
+  superseded: []
+  invalidated: []
+  secrets: NO
+residual: []
+git:
+  branch:
+  commits:
+  pr:
+  default:
+  worktree:
+  status:
+terminal: "COMPLETE|BLOCKED|STALLED|CONSTRAINT_LIMITED|FAILED_VERIFICATION"
+say_if_complete: "Vibe Code Build complete."

package/.agents/skills/rdap-q/templates/milestone.md

@@ -0,0 +1,8 @@
+id:
+goal:
+done: []
+tasks: []
+verification: []
+state: [assumptions, evidence, risks, scorecard, iteration-log]
+memory: [candidates_only, no_transient, no_secrets, revalidate_conflicts]
+close: [tasks_done, definition_of_done, verification, diff_reviewed, gates, commit_if_coherent]

package/.agents/skills/rdap-q/templates/task.md

@@ -0,0 +1,12 @@
+# shape: playbooks/02-planning.md task
+id:
+milestone:
+objective:
+files:
+evidence: []
+memory: []
+action:
+commands:
+verification:
+observable:
+dependencies:

package/.claude/commands/rdapq.md

@@ -0,0 +1,8 @@
+protocol: RDAP-Q
+version: "1.2.1"
+on: [/rdapq, /rdap-q]
+load: .agents/skills/rdap-q/SKILL.md
+fallback: rdap-q-skill/SKILL.md
+then: current phase playbook only
+state: .rdapq/state
+skip: [manifest.json, other playbooks, bulk memory]

package/.claude-plugin/marketplace.json

@@ -0,0 +1,40 @@
+{
+  "name": "rdapq",
+  "description": "RDAP-Q: Research-Driven Adaptive Planning with Quality Gates protocol for Claude Code.",
+  "owner": {
+    "name": "coldcanuk",
+    "email": "coldcanuk@users.noreply.github.com"
+  },
+  "plugins": [
+    {
+      "name": "rdap-q",
+      "version": "1.2.1",
+      "description": "Vendor-neutral engineering protocol for evidence-first software development, persistent state, calibrated 0-10 scoring, and diminishing-return exit gates.",
+      "category": "development",
+      "author": {
+        "name": "coldcanuk"
+      },
+      "homepage": "https://github.com/coldcanuk/rdapq",
+      "tags": [
+        "rdap-q",
+        "quality-gates",
+        "planning",
+        "sdlc",
+        "agent-skill",
+        "testing"
+      ],
+      "keywords": [
+        "rdap-q",
+        "adaptive-planning",
+        "quality-gates",
+        "scoring",
+        "evidence-first",
+        "diminishing-returns"
+      ],
+      "source": {
+        "type": "local",
+        "path": "./plugins/rdap-q"
+      }
+    }
+  ]
+}

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

@@ -0,0 +1,16 @@
+{
+  "version": 1,
+  "plugins": {
+    "rdap-q": {
+      "version": "1.2.1",
+      "components": {
+        "skills": [
+          {
+            "name": "rdap-q",
+            "description": "Vendor-neutral Research-Driven Adaptive Planning with Quality Gates protocol for evidence-first software development."
+          }
+        ]
+      }
+    }
+  }
+}

package/.claude-plugin/plugin.json

@@ -0,0 +1,25 @@
+{
+  "name": "rdap-q",
+  "version": "1.2.1",
+  "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": {
+    "name": "coldcanuk",
+    "url": "https://github.com/coldcanuk"
+  },
+  "homepage": "https://github.com/coldcanuk/rdapq",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/coldcanuk/rdapq.git"
+  },
+  "license": "GPL-3.0-or-later",
+  "commands": [
+    ".claude/commands/rdapq.md"
+  ],
+  "rules": [
+    "CLAUDE.md"
+  ],
+  "skills": [
+    "rdap-q-skill/SKILL.md"
+  ]
+}

package/.clinerules

@@ -0,0 +1,8 @@
+protocol: RDAP-Q
+version: "1.2.1"
+on: [/rdapq, /rdap-q]
+load: .agents/skills/rdap-q/SKILL.md
+fallback: rdap-q-skill/SKILL.md
+then: current phase playbook only
+state: .rdapq/state
+skip: [manifest.json, other playbooks, bulk memory]

package/.codex/skill.json

@@ -0,0 +1,9 @@
+{
+  "name": "rdap-q",
+  "version": "1.2.1",
+  "harness": "codex",
+  "rules": "AGENTS.md",
+  "entrypoint": "rdap-q-skill/SKILL.md",
+  "command": "/rdapq",
+  "description": "RDAP-Q engineering protocol for OpenAI Codex agents"
+}

package/.github/copilot-instructions.md

@@ -0,0 +1,8 @@
+protocol: RDAP-Q
+version: "1.2.1"
+on: [/rdapq, /rdap-q]
+load: .agents/skills/rdap-q/SKILL.md
+fallback: rdap-q-skill/SKILL.md
+then: current phase playbook only
+state: .rdapq/state
+skip: [manifest.json, other playbooks, bulk memory]

package/.github/workflows/ci.yml

@@ -0,0 +1,25 @@
+name: ci
+
+on:
+  push:
+  pull_request:
+
+permissions:
+  contents: read
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        node: [18, 22]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node }}
+      - name: Syntax-check the installer
+        run: node --check bin/rdapq.js && node --check lib/installer.js
+      - name: Test install, packaging, and version consistency
+        run: npm test

package/.github/workflows/release.yml

@@ -0,0 +1,34 @@
+name: release
+
+# Publishes to npm on a v* tag only after the repository variable NPM_PUBLISH
+# is set to "true". Configure an npm Trusted Publisher for coldcanuk/rdapq
+# (OIDC, no long-lived token) before flipping that variable.
+on:
+  push:
+    tags: ['v*']
+
+permissions:
+  contents: read
+  id-token: write
+
+jobs:
+  verify:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22
+      - run: npm test
+
+  publish:
+    needs: verify
+    if: vars.NPM_PUBLISH == 'true'
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          registry-url: https://registry.npmjs.org
+      - run: npm publish --access public --provenance

package/.goosehints

@@ -0,0 +1,8 @@
+protocol: RDAP-Q
+version: "1.2.1"
+on: [/rdapq, /rdap-q]
+load: .agents/skills/rdap-q/SKILL.md
+fallback: rdap-q-skill/SKILL.md
+then: current phase playbook only
+state: .rdapq/state
+skip: [manifest.json, other playbooks, bulk memory]

package/.grok/rules.md

@@ -0,0 +1,8 @@
+protocol: RDAP-Q
+version: "1.2.1"
+on: [/rdapq, /rdap-q]
+load: .agents/skills/rdap-q/SKILL.md
+fallback: rdap-q-skill/SKILL.md
+then: current phase playbook only
+state: .rdapq/state
+skip: [manifest.json, other playbooks, bulk memory]

package/.grok/skill.json

@@ -0,0 +1,9 @@
+{
+  "name": "rdap-q",
+  "version": "1.2.1",
+  "harness": "grok",
+  "rules": ".grok/rules.md",
+  "entrypoint": "rdap-q-skill/SKILL.md",
+  "command": "/rdapq",
+  "description": "RDAP-Q engineering protocol for xAI Grok agents"
+}

package/.grok-plugin/marketplace.json

@@ -0,0 +1,40 @@
+{
+  "name": "rdapq",
+  "description": "RDAP-Q: Research-Driven Adaptive Planning with Quality Gates protocol for Grok Build and AI agents.",
+  "owner": {
+    "name": "coldcanuk",
+    "email": "coldcanuk@users.noreply.github.com"
+  },
+  "plugins": [
+    {
+      "name": "rdap-q",
+      "version": "1.2.1",
+      "description": "Vendor-neutral engineering protocol for evidence-first software development, persistent state, calibrated 0-10 scoring, and diminishing-return exit gates.",
+      "category": "development",
+      "author": {
+        "name": "coldcanuk"
+      },
+      "homepage": "https://github.com/coldcanuk/rdapq",
+      "tags": [
+        "rdap-q",
+        "quality-gates",
+        "planning",
+        "sdlc",
+        "agent-skill",
+        "testing"
+      ],
+      "keywords": [
+        "rdap-q",
+        "adaptive-planning",
+        "quality-gates",
+        "scoring",
+        "evidence-first",
+        "diminishing-returns"
+      ],
+      "source": {
+        "type": "local",
+        "path": "./plugins/rdap-q"
+      }
+    }
+  ]
+}

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

@@ -0,0 +1,16 @@
+{
+  "version": 1,
+  "plugins": {
+    "rdap-q": {
+      "version": "1.2.1",
+      "components": {
+        "skills": [
+          {
+            "name": "rdap-q",
+            "description": "Vendor-neutral Research-Driven Adaptive Planning with Quality Gates protocol for evidence-first software development."
+          }
+        ]
+      }
+    }
+  }
+}

package/AGENTS.md

@@ -0,0 +1,8 @@
+protocol: RDAP-Q
+version: "1.2.1"
+on: [/rdapq, /rdap-q]
+load: .agents/skills/rdap-q/SKILL.md
+fallback: rdap-q-skill/SKILL.md
+then: current phase playbook only
+state: .rdapq/state
+skip: [manifest.json, other playbooks, bulk memory]

package/CLAUDE.md

@@ -0,0 +1,8 @@
+protocol: RDAP-Q
+version: "1.2.1"
+on: [/rdapq, /rdap-q]
+load: .agents/skills/rdap-q/SKILL.md
+fallback: rdap-q-skill/SKILL.md
+then: current phase playbook only
+state: .rdapq/state
+skip: [manifest.json, other playbooks, bulk memory]

package/GEMINI.md

@@ -0,0 +1,8 @@
+protocol: RDAP-Q
+version: "1.2.1"
+on: [/rdapq, /rdap-q]
+load: .agents/skills/rdap-q/SKILL.md
+fallback: rdap-q-skill/SKILL.md
+then: current phase playbook only
+state: .rdapq/state
+skip: [manifest.json, other playbooks, bulk memory]