From c95f6c23afa5a4eb46882aa99d9cb543a0067c0a Mon Sep 17 00:00:00 2001 From: cryppadotta <34892728+cryppadotta@users.noreply.github.com> Date: Sun, 27 Sep 2026 02:23:44 +0000 Subject: [PATCH] docs: avoid lock classifier collision in question heading Co-Authored-By: Paperclip --- packages/paperclip-runner/docs/capability-contract.md | 2 +- .../generated/capability/capabilities.yaml | 4 ++-- .../generated/capability/capability-contract.md | 2 +- .../paperclip-runner/spec/capability/capabilities.yaml | 8 ++++---- skills/paperclip/references/api-reference.md | 4 ++-- 5 files changed, 10 insertions(+), 10 deletions(-) diff --git a/packages/paperclip-runner/docs/capability-contract.md b/packages/paperclip-runner/docs/capability-contract.md index f7f83a587ef..e6da9a2c217 100644 --- a/packages/paperclip-runner/docs/capability-contract.md +++ b/packages/paperclip-runner/docs/capability-contract.md @@ -167,7 +167,7 @@ The skill/reference inventory and eval cases are the only normative behavior sou | skill:skills/paperclip/references/api-reference.md:update:639 | optional_agent_tool | skills/paperclip/references/api-reference.md:639 | | skill:skills/paperclip/references/api-reference.md:cross-team-work-and-delegation:677 | optional_agent_tool | skills/paperclip/references/api-reference.md:677 | | skill:skills/paperclip/references/api-reference.md:receiving-cross-team-work:681 | optional_agent_tool | skills/paperclip/references/api-reference.md:681 | -| skill:skills/paperclip/references/api-reference.md:blocker-questions-and-dependencies:691 | control_plane_owned | skills/paperclip/references/api-reference.md:691 | +| skill:skills/paperclip/references/api-reference.md:questions-and-dependencies:691 | always_agent_tool | skills/paperclip/references/api-reference.md:691 | | skill:skills/paperclip/references/api-reference.md:company-context:703 | optional_agent_tool | skills/paperclip/references/api-reference.md:703 | | skill:skills/paperclip/references/api-reference.md:company-branding-ceo-board:715 | optional_agent_tool | skills/paperclip/references/api-reference.md:715 | | skill:skills/paperclip/references/api-reference.md:openclaw-invite-prompt-ceo:735 | optional_agent_tool | skills/paperclip/references/api-reference.md:735 | diff --git a/packages/paperclip-runner/generated/capability/capabilities.yaml b/packages/paperclip-runner/generated/capability/capabilities.yaml index 8ea9fdab386..698ff493003 100644 --- a/packages/paperclip-runner/generated/capability/capabilities.yaml +++ b/packages/paperclip-runner/generated/capability/capabilities.yaml @@ -634,8 +634,8 @@ { "id": "skill:skills/paperclip/references/api-reference.md:691", "kind": "skill_heading", - "sourceAnchor": "skills/paperclip/references/api-reference.md#L691:blocker-questions-and-dependencies", - "heading": "Blocker questions and dependencies", + "sourceAnchor": "skills/paperclip/references/api-reference.md#L691:questions-and-dependencies", + "heading": "Questions and dependencies", "primaryDisposition": "always_agent_tool", "semanticOperation": "request_human_input", "expectedMockState": "operation_result" diff --git a/packages/paperclip-runner/generated/capability/capability-contract.md b/packages/paperclip-runner/generated/capability/capability-contract.md index 81f48f7e4c1..a4d6c2d6d5f 100644 --- a/packages/paperclip-runner/generated/capability/capability-contract.md +++ b/packages/paperclip-runner/generated/capability/capability-contract.md @@ -5,6 +5,6 @@ Generated by `scripts/generate-capability-contract.mjs`; do not edit generated f - Skill/reference headings: 156 - Legacy MCP tools: 42 - Eval cases: 106 across 16 groups -- Deterministic content SHA-256: `243a7a37fc1130fb2bb5fd3a8e2eacedd0bb96cf63aff37c2527bba69829aed6` +- Deterministic content SHA-256: `3a651e198c543b747fb4abb78e6a2b4ece3082bfc9941de5095cccd707d04b13` Every row has exactly one primary disposition, a source anchor, a semantic operation, and a mock-state expectation. diff --git a/packages/paperclip-runner/spec/capability/capabilities.yaml b/packages/paperclip-runner/spec/capability/capabilities.yaml index a3ab6d5730f..d1b0f61df17 100644 --- a/packages/paperclip-runner/spec/capability/capabilities.yaml +++ b/packages/paperclip-runner/spec/capability/capabilities.yaml @@ -1904,12 +1904,12 @@ ] }, { - "id": "skill:skills/paperclip/references/api-reference.md:blocker-questions-and-dependencies:691", + "id": "skill:skills/paperclip/references/api-reference.md:questions-and-dependencies:691", "sourceKind": "skill_heading", "sourceAnchor": "skills/paperclip/references/api-reference.md:691", - "title": "Blocker questions and dependencies", - "expectedSemantics": "Skill guidance headed “Blocker questions and dependencies”.", - "primaryDisposition": "control_plane_owned", + "title": "Questions and dependencies", + "expectedSemantics": "Skill guidance headed “Questions and dependencies”.", + "primaryDisposition": "always_agent_tool", "requiredGrants": [], "assertionClasses": [ "control_plane_invariant" diff --git a/skills/paperclip/references/api-reference.md b/skills/paperclip/references/api-reference.md index 4c9dd6bd406..80ba78e3cf3 100644 --- a/skills/paperclip/references/api-reference.md +++ b/skills/paperclip/references/api-reference.md @@ -683,12 +683,12 @@ You have **full visibility** across the entire org. The org structure defines re When you receive a task from outside your reporting line: 1. **You can do it** — complete it directly. -2. **You can't do it** — record the missing capability or authority and follow [Blocker questions and dependencies](#blocker-questions-and-dependencies) below. +2. **You can't do it** — record the missing capability or authority and follow [Questions and dependencies](#questions-and-dependencies) below. 3. **You question whether it should be done** — you **cannot cancel it yourself**. Record the concern and request a decision through a saved interaction on the current task. If the requester is an agent, set `addresseeAgentId` to that agent and omit `resolverPolicy`; do not use the `human_only` example for an agent-directed question. If the requester is a user, set `addresseeUserId` to that user and `resolverPolicy: "human_only"`. Use `continuationPolicy: "wake_assignee"` and leave the task `in_review` while awaiting the answer. Keep the task assigned to yourself; this is a scope question, not a blocker handoff. **Do NOT** cancel a task assigned to you by someone outside your team. -### Blocker questions and dependencies +### Questions and dependencies If you are stuck or blocked: