rdap-q 1.2.1

package/plugins/rdap-q/skills/rdap-q/diagrams/rdapq-selective-loading.mmd

@@ -0,0 +1,40 @@
+flowchart LR
+    CMD[/rdapq/] --> S[SKILL.md]
+    S --> P{Current Phase}
+
+    P --> B[Bootstrap]
+    P --> D[Discovery]
+    P --> PL[Planning]
+    P --> A[Architecture]
+    P --> I[Implementation]
+    P --> V[Verification]
+    P --> F[Final Audit]
+
+    EVT{Event} --> C[Constitution]
+    EVT --> SC[Scoring]
+    EVT --> G[Gates]
+    EVT --> E[Exit Logic]
+    EVT --> M[Memory Protocol]
+    EVT --> CTRL[Controller]
+
+    H[RDAPQ_HOME] --> GM[(Global / Project Memory)]
+    R[Repository] --> RS[(.rdapq/state)]
+
+    GM --> AG[Agent]
+    RS --> AG
+    S --> AG
+    B --> AG
+    D --> AG
+    PL --> AG
+    A --> AG
+    I --> AG
+    V --> AG
+    F --> AG
+    C --> AG
+    SC --> AG
+    G --> AG
+    E --> AG
+    M --> AG
+    CTRL --> AG
+
+    AG --> X[Repository / Runtime / Tools]

package/plugins/rdap-q/skills/rdap-q/install/install-unix.sh

@@ -0,0 +1,48 @@
+#!/usr/bin/env sh
+# Install the skill tree into $RDAPQ_HOME. Stage first, swap only after SKILL.md
+# is present, so a failed copy cannot delete a working install.
+# Prefer the repo installer (./install.sh or npx --yes github:coldcanuk/rdapq) when you have the full checkout.
+set -eu
+
+SOURCE_DIR="$(CDPATH= cd -- "$(dirname -- "$0")/.." && pwd)"
+if [ ! -f "$SOURCE_DIR/SKILL.md" ]; then
+  echo "error: SKILL.md not found next to this installer ($SOURCE_DIR)" >&2
+  exit 1
+fi
+
+TARGET="${RDAPQ_HOME:-${HOME}/.rdapq}"
+SKILLS="$TARGET/skills"
+DEST="$SKILLS/rdap-q"
+STAGE="$SKILLS/.rdap-q.staging.$$"
+BACKUP="$SKILLS/.rdap-q.backup.$$"
+
+mkdir -p "$SKILLS" "$TARGET/memory" "$TARGET/projects" "$TARGET/registry"
+rm -rf "$STAGE"
+cp -R "$SOURCE_DIR" "$STAGE"
+
+if [ ! -f "$STAGE/SKILL.md" ]; then
+  rm -rf "$STAGE"
+  echo "error: staged copy is missing SKILL.md; existing install left untouched" >&2
+  exit 1
+fi
+
+moved=0
+if [ -e "$DEST" ]; then
+  rm -rf "$BACKUP"
+  mv "$DEST" "$BACKUP"
+  moved=1
+fi
+
+if ! mv "$STAGE" "$DEST"; then
+  if [ "$moved" -eq 1 ]; then
+    mv "$BACKUP" "$DEST"
+  fi
+  echo "error: failed to publish staged skill; previous install restored if it existed" >&2
+  exit 1
+fi
+
+if [ "$moved" -eq 1 ]; then
+  rm -rf "$BACKUP"
+fi
+
+printf 'Installed RDAP-Q to %s\n' "$DEST"

package/plugins/rdap-q/skills/rdap-q/install/install-windows.ps1

@@ -0,0 +1,65 @@
+# Install the skill tree into $env:RDAPQ_HOME. Stage first, swap only after SKILL.md
+# is present, so a failed copy cannot delete a working install.
+$ErrorActionPreference = "Stop"
+
+if (-not $PSCommandPath) {
+    Write-Error "refusing a piped install. Run this script from the skill directory."
+    exit 1
+}
+
+$SourceDir = Split-Path -Parent (Split-Path -Parent $PSCommandPath)
+$SkillFile = Join-Path $SourceDir "SKILL.md"
+if (-not (Test-Path -LiteralPath $SkillFile)) {
+    throw "SKILL.md not found in $SourceDir"
+}
+
+if ($env:RDAPQ_HOME) {
+    $Target = $env:RDAPQ_HOME
+} else {
+    $Target = Join-Path $env:USERPROFILE ".rdapq"
+}
+
+$SkillsDir = Join-Path $Target "skills"
+$Dest = Join-Path $SkillsDir "rdap-q"
+$Stage = Join-Path $SkillsDir ".rdap-q.staging-$PID"
+$Backup = Join-Path $SkillsDir ".rdap-q.backup-$PID"
+
+New-Item -ItemType Directory -Force -Path $SkillsDir | Out-Null
+New-Item -ItemType Directory -Force -Path (Join-Path $Target "memory") | Out-Null
+New-Item -ItemType Directory -Force -Path (Join-Path $Target "projects") | Out-Null
+New-Item -ItemType Directory -Force -Path (Join-Path $Target "registry") | Out-Null
+
+if (Test-Path -LiteralPath $Stage) {
+    Remove-Item -LiteralPath $Stage -Recurse -Force
+}
+Copy-Item -LiteralPath $SourceDir -Destination $Stage -Recurse -Force
+
+$StagedSkill = Join-Path $Stage "SKILL.md"
+if (-not (Test-Path -LiteralPath $StagedSkill)) {
+    Remove-Item -LiteralPath $Stage -Recurse -Force
+    throw "Staged copy is missing SKILL.md; existing install left untouched."
+}
+
+$moved = $false
+if (Test-Path -LiteralPath $Dest) {
+    if (Test-Path -LiteralPath $Backup) {
+        Remove-Item -LiteralPath $Backup -Recurse -Force
+    }
+    Move-Item -LiteralPath $Dest -Destination $Backup
+    $moved = $true
+}
+
+try {
+    Move-Item -LiteralPath $Stage -Destination $Dest
+} catch {
+    if ($moved -and -not (Test-Path -LiteralPath $Dest) -and (Test-Path -LiteralPath $Backup)) {
+        Move-Item -LiteralPath $Backup -Destination $Dest
+    }
+    throw
+}
+
+if ($moved -and (Test-Path -LiteralPath $Backup)) {
+    Remove-Item -LiteralPath $Backup -Recurse -Force
+}
+
+Write-Output "Installed RDAP-Q to $Dest"

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

@@ -0,0 +1,87 @@
+{
+  "name": "rdap-q",
+  "version": "1.2.1",
+  "protocol_name": "RDAP-Q Agent Engineering Protocol",
+  "entrypoint": "SKILL.md",
+  "invocation": "/rdapq",
+  "home_env": "RDAPQ_HOME",
+  "home_defaults": {
+    "windows": "%USERPROFILE%\\.rdapq",
+    "unix": "${HOME}/.rdapq"
+  },
+  "repository_state": ".rdapq/state",
+  "always_load": [
+    "SKILL.md"
+  ],
+  "phase_load": {
+    "BOOTSTRAP": [
+      "playbooks/00-bootstrap.md"
+    ],
+    "DISCOVERY": [
+      "playbooks/01-discovery.md"
+    ],
+    "PLAN": [
+      "playbooks/02-planning.md"
+    ],
+    "ARCHITECTURE": [
+      "playbooks/03-architecture.md"
+    ],
+    "IMPLEMENT": [
+      "playbooks/04-implementation.md"
+    ],
+    "VERIFY": [
+      "playbooks/05-verification.md"
+    ],
+    "AUDIT": [
+      "playbooks/06-final-audit.md",
+      "playbooks/07-git-worktree.md"
+    ]
+  },
+  "event_load": {
+    "controller_ambiguity": [
+      "core/controller.md"
+    ],
+    "tool_mapping": [
+      "core/capabilities.md"
+    ],
+    "memory_read_write_invalidate": [
+      "core/memory.md"
+    ],
+    "gate_evaluation": [
+      "core/gates.md"
+    ],
+    "score_calculation": [
+      "core/scoring.md"
+    ],
+    "milestone_quality_decision": [
+      "core/scoring.md",
+      "core/gates.md",
+      "core/exit-logic.md"
+    ],
+    "terminal_decision": [
+      "core/scoring.md",
+      "core/gates.md",
+      "core/exit-logic.md"
+    ],
+    "git_mutation": [
+      "playbooks/07-git-worktree.md"
+    ]
+  },
+  "commands": {
+    "/rdapq": "Start or continue RDAP-Q execution on the supplied task.",
+    "/rdapq status": "Show phase, quality, confidence, gates, blockers, and iteration state.",
+    "/rdapq score": "Calculate or display the current evidence-linked scorecard.",
+    "/rdapq audit": "Run the adversarial final-audit procedure.",
+    "/rdapq resume": "Reload persistent memory/state, inspect drift, and resume safely.",
+    "/rdapq memory": "Show relevant RDAP-Q memory and its validity status.",
+    "/rdapq research": "Enter or re-enter discovery/research.",
+    "/rdapq explain": "Explain the current RDAP-Q phase/decision."
+  },
+  "terminal_states": [
+    "COMPLETE",
+    "BLOCKED",
+    "STALLED",
+    "CONSTRAINT_LIMITED",
+    "FAILED_VERIFICATION"
+  ]
+}

package/plugins/rdap-q/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/plugins/rdap-q/skills/rdap-q/memory/constraints.md

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

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

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

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

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

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

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

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

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

package/plugins/rdap-q/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/plugins/rdap-q/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/plugins/rdap-q/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/plugins/rdap-q/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/plugins/rdap-q/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/plugins/rdap-q/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/plugins/rdap-q/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/plugins/rdap-q/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/plugins/rdap-q/skills/rdap-q/projects/architecture.md

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

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

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

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

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

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

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

package/plugins/rdap-q/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/plugins/rdap-q/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/plugins/rdap-q/skills/rdap-q/state/decisions.md

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

package/plugins/rdap-q/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/plugins/rdap-q/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/plugins/rdap-q/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/plugins/rdap-q/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/plugins/rdap-q/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/plugins/rdap-q/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/plugins/rdap-q/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/plugins/rdap-q/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/plugins/rdap-q/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/plugins/rdap-q/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: