Skip to content

docs(skills): pair-review goes harness-agnostic — Crush, operator, skills PRs, on-node passes - #2946

Merged
POWERFULMOVES merged 2 commits into
mainfrom
docs/pair-review-harness-agnostic
Sep 8, 2026
Merged

POWERFULMOVES merged 2 commits into
mainfrom
docs/pair-review-harness-agnostic

Conversation

@POWERFULMOVES

Copy link
Copy Markdown
Owner

What

Operator-directed adaptation of the pair-review workflow (during the #2943 review session): the skill and ops guide said "parallel-CLAUDE" — the fleet is multi-harness, and the reviewer surfaces were missing the operator and everything on-node.

  • Harness-agnostic peer surface: Claude Code, Crush, Codex CLI, Hermes, KiloCode claws, DeepSeek. Cross-harness reviews surface harness-assumption drift (the TS_Z890 roster drop was exactly this class).
  • Operator as the fourth surface (Three-Body Control): DARKXSIDE/POWERFULMOVES reviews are the highest-signal angle — docs(skills): a0-archon-bridge — align with live v2.11 surface + fix :8091 (supersedes #2865) #2942's :8091 port-map correction and fix(env): TS_Z890 gates three MCP servers and was defined nowhere #2938's topology challenge both came from operator pushback on confident agent drafts.
  • Crush specifics: same gh/AGNOTE/sign-trail mechanics; COMMENTED-not-APPROVED (same-account constraint); sign with the agent_signatures.yaml identity; skills-load-on-demand doubles as a description-as-trigger quality check.
  • Skills-PR checklist (4-class taxonomy mapped to SKILL.md diffs): frontmatter name==directory (Crush validator rejects colon-style names), description-is-a-trigger, validate_command_anchors.py ratchet, live-surface probes for port/endpoint claims, Tier 1/Tier 2 CI.
  • On-node/private review passes: Ollama local models (private by construction — motivated by the 2026-09-04 tailnet-address leak on a public PR), hf-agent model nomination, Archon 0.6.0 conversation endpoints (:8091, every node) for tool-using passes, and the provisioned coding plans via their CLIs. Guardrail: leads, not verdicts; never the Control angle.

Files: .claude/skills/pmoves-pair-review/SKILL.md, pmoves/docs/operations/PAIR_REVIEW_RECIPROCITY.md. No behavior change.

Testing

  • Skill frontmatter unchanged in name; description generalized (Tier 1 checks frontmatter shape)
  • skill_registry_validate.py: same 4 pre-existing errors as clean main (the pmoves-composio-mcp-plugin registry gap — unrelated, verified by stashing)
  • CLAIM filed via make -C pmoves register-claim (clock-read, postdate-safe)

@coderabbitai

coderabbitai Bot commented Sep 5, 2026

Copy link
Copy Markdown
Contributor

Important

Review skipped

Auto reviews are limited based on label configuration.

🏷️ Required labels (at least one) (1)
  • coderabbit

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Advanced

Run ID: afd6a5b8-af13-45a9-8da4-ade7d99e1fb7

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Sep 5, 2026

Copy link
Copy Markdown

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review Completed 2026-09-05T00:26:14.023989Z f076024 PR opened
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@github-actions github-actions Bot added docs Documentation governance AGNOTE register / agent definitions / damage-control hooks labels Sep 5, 2026

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: f076024c62

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread .claude/skills/pmoves-pair-review/SKILL.md
Comment thread .claude/skills/pmoves-pair-review/SKILL.md Outdated
Comment thread pmoves/docs/operations/PAIR_REVIEW_RECIPROCITY.md Outdated
Comment thread pmoves/docs/operations/PAIR_REVIEW_RECIPROCITY.md Outdated
Comment thread pmoves/docs/operations/PAIR_REVIEW_RECIPROCITY.md Outdated
@POWERFULMOVES

Copy link
Copy Markdown
Owner Author

◇ All five addressed in d31bdc4ce — stale CLAUDE-only Do-NOT block removed; operator identity corrected to darkxside/powerfulmoves; hf-agent reframed as autonomous discovery patrol (no per-diff endpoint); Archon entry now requires a /api/health JSON-body probe first (not on kvm4-2/kvm2); coding-plan credentials documented as per-harness tiers resolved from the secrets manifest (CLAUDE_CODE_OAUTH_TOKEN = agent tier).

@POWERFULMOVES
POWERFULMOVES force-pushed the docs/pair-review-harness-agnostic branch from d31bdc4 to 9484b82 Compare September 8, 2026 06:27
Agent Zero added 2 commits September 8, 2026 09:45
…ills PRs, on-node passes

Adapts pmoves-pair-review and PAIR_REVIEW_RECIPROCITY.md from
parallel-CLAUDE-only to the fleet as it actually is (operator-directed,
during the #2943 review session):

- Any harness counts as the peer surface: Claude Code, Crush, Codex CLI,
  Hermes, KiloCode claws, DeepSeek — cross-harness reviews are the point,
  they surface harness-assumption drift (env vars one launcher sources
  and another doesn't; the TS_Z890 roster drop was this class)
- Fourth reviewer surface: the operator (DARKXSIDE/POWERFULMOVES) as
  Control — both #2942's :8091 correction and #2938's topology challenge
  came from operator pushback on confident agent drafts; gate, don't
  bottleneck
- Harness notes for Crush: same gh/AGNOTE/sign-trail mechanics,
  COMMENTED-not-APPROVED (same-account constraint), sign with the
  agent_signatures.yaml identity, skills-load-on-demand as a trigger-
  quality check
- Skills-PR review checklist mapped to the 4-class taxonomy: frontmatter
  name==dir (Crush validator), description-is-a-trigger, anchors ratchet,
  live-surface probes for port/endpoint claims, Tier 1/Tier 2 CI
- On-node/private review passes: Ollama local models (private by
  construction — motivated by the 2026-09-04 tailnet-address leak),
  hf-agent model nomination, Archon 0.6.0 conversation endpoints for
  tool-using passes, and the already-provisioned coding plans via their
  CLIs — with the leads-not-verdicts guardrail

No behavior change — workflow docs + skill only.
…ity doc

- SKILL.md: drop the stale CLAUDE-only "do NOT invoke" block that
  contradicted the harness-agnostic one; operator signs as darkxside/
  powerfulmoves (dsh is not a registered signature identity)
- RECIPROCITY.md: hf-agent is an autonomous HF patrol with no per-diff
  endpoint — reframe as a discovery feed, selection stays with the
  session; Archon is not on every node — probe /api/health (JSON body)
  before offering it; coding-plan credentials land per-harness tiers
  (CLAUDE_CODE_OAUTH_TOKEN registers in the agent tier), resolve from
  the secrets manifest instead of assuming env.tier-llm

💘 Generated with Crush
@POWERFULMOVES
POWERFULMOVES force-pushed the docs/pair-review-harness-agnostic branch from 9484b82 to 53ca6b3 Compare September 8, 2026 09:46
@POWERFULMOVES
POWERFULMOVES merged commit 18f673a into main Sep 8, 2026
27 checks passed
@POWERFULMOVES
POWERFULMOVES deleted the docs/pair-review-harness-agnostic branch September 8, 2026 09:55
POWERFULMOVES added a commit that referenced this pull request Sep 8, 2026
…dy ACK (#2998)

* docs(register): five-PR merge wave closeout — RELEASE rows + three-body ACK

RELEASE rows for archon-native (#2943), pair-review (#2946),
a0-archon-bridge (#2942), gh-app mint (#2959), H3 V3 archive (#2980).
Signoff checklist carries the wave's delivery/control/memory ACKs;
control is the operator's in-session merge directive. Learnings artifacts
stayed runtime-generated per protocol.

💘 Generated with Crush

* fix(register): declare CRUSH-SPARK (KIMI) and the kimi-k2 model token

The 2026-09-08 RELEASE rows signed as CRUSH-SPARK (KIMI) -- the model+node
decoration shape the vocabulary already documents for CRUSH-GLM52 (Z890).
Alias folded to the crush identity; KIMI declared as the kimi-k2 model.

💘 Generated with Crush

---------

Co-authored-by: Agent Zero <agent.zero@pmoves.ai>
POWERFULMOVES added a commit that referenced this pull request Sep 11, 2026
…d-but-unreleased (#3007)

Six expired-and-unreleased claims were each blocking a future claimant while
nobody had said they were still on it. Five were already DELIVERED and simply
never released; one was mine and was genuinely unfinished.

MINE -- docs/reclaim-cipher-token-model, RELEASED with the real verdict: still
needed, never started, now SPLIT. Claimed twice (#2824, #2864) and both PRs were
REGISTER-ONLY -- #2864 was 6+ 0-, one file. Any audit keying on PR state reads
two merged PRs as closure. It kept expiring because one claim held two lanes and
the expensive half gated the cheap half. Cheap half landed as #2988; the
expensive half (unhashed storage on a live auth table, auth.ts:62-64 in a
submodule, bootstrap's six-scope shared identity) is named and left UNCLAIMED.

FIVE BACKFILL ACKNOWLEDGEMENTS, not owner-signed closures -- B850 x3, HERMES x1,
SPARK x1. Each carries filed-by: Z890-CLAUDE, merge SHA + timestamp, and states
that the owner-authored RELEASE and signed ACK remain OWED. Attribution stays
with the owner; only the signature is mine. That split is the point:
AGENT_IDENTITY_PROPOSAL_2026-09-04.md section 4 names "written about and never
writes" as the failure mode, so a backfill must not become another agent's
ledger entry authored by me.

CITATION CORRECTION. The precedent for this (#2960, the Mavis row) cites
"AGENTS.md:L60-62, co-owner has no authority to close another owner's claim".
That clause is not in AGENTS.md, and `git log -S` over AGENTS.md history returns
EMPTY -- it has never been there. The practice is sound and is followed here;
the phantom citation is not propagated. Grounded instead on the Village Rule
that AGENTS.md does carry: claim -> work -> sign -> release, "on completion
write a RELEASE row and a signed ACK block" -- which makes RELEASE the owner's
act without inventing a clause.

Verification: register is a strict byte prefix of origin/main plus 8589 appended
bytes, 6 rows, NUL count 1 preserved, postdate clean. Expired-and-unreleased
falls 6 -> 4.

SPARK's three remaining expired lanes are deliberately NOT backfilled: each has
an OPEN PR (#2946, #2959, #2943), so they are active work past TTL, not
abandoned work.


Claude-Session: https://claude.ai/code/session_01Jxd5gryAFPXwhjaCMw9Qrx

Co-authored-by: Claude Opus 5 <noreply@anthropic.com>
Co-authored-by: kiloclaw <kiloclaw@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

docs Documentation governance AGNOTE register / agent definitions / damage-control hooks

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant