Files
PaperClipAI/packages/paperclip-runner/docs/capability-contract.md
T
DottaandPaperclip b17019e14d fix(agents): reduce default instructions and qualify stock harnesses (#14948)
## Thinking Path

> - Paperclip is the open source app people use to manage AI agents for
work.
> - Its adapters supply task context and access to Paperclip skills and
tools.
> - The default hire manual and shared prompts also repeat general work
procedures.
> - Those procedures overlap with stock provider instructions and the
Paperclip skill.
> - Existing E2E fixtures supply a QA manual, so they do not qualify the
production default.
> - This pull request reduces the generic instructions and adds real
default-hire coverage.
> - The benefit is less competing guidance, with inspectable evidence
for preserved skills and task context.

## Linked Issues or Issue Description

Refs: #14920. That merged change preserves native Codex base
instructions. This PR covers the default manual, shared legacy prompts,
operational skill guidance, and the narrowly approved ACP
skill-discovery/session-environment repair for measured delivery and
credential-persistence failures.

**What existing behavior does this improve?**

New non-CEO hires without a custom bundle and legacy task/chat startup
and continuation prompts.

**Current behavior**

The shipped default manual contains 602 words. Generic task/chat prompts
and ordinary resume deltas repeat work procedures already available
through the harness and Paperclip skill.

**Proposed behavior**

The default manual contains only the eight-word company identity. Shared
startup prompts retain identity and connection guidance. Ordinary resume
deltas retain current work context without the generic execution
contract.

**Reason and benefit**

Let the stock harness guide general work. Keep Paperclip-specific
capabilities and independently test default hires, skills, ordered
comments, and chat restart.

**Breaking changes**

New default hires receive less guidance. Existing saved manuals,
explicit custom bundles, CEO templates, and specialized wake contracts
retain their behavior. The obsolete includeExecutionContract option
remains accepted for source compatibility.

## What Changed

- Reduce the default hire manual to one sentence.
- Reduce shared task/chat defaults and remove the generic
ordinary-resume contract.
- Keep connection guidance, auth, skills, custom prompts, and
specialized wake context.
- Add credential-free instruction-boundary gates and 26 explicit Product
E2E cells across eight legacy/native profiles, including two focused
Paperclip-storage cases.
- Capture public hire receipts before providers run, then grade
delivered prompts and independent task/chat outcomes.
- Add an early legacy skill API recipe for saving a task document,
checking the saved revision receipt and linking the document. Improve
stock task/heartbeat skill-selection metadata and show a clickable
Markdown UI-link example. Keep native tool completion separate.
- Advertise bounded routing descriptions and exact successfully staged
SKILL.md paths in legacy ACP Claude; keep full bodies on demand and
preserve remote path rebasing.
- Remove only the provider environment from copied persisted ACP session
records, while loading current run credentials and preserving all other
options/conversation state.
- Regenerate both capability metadata inventories and reject stale
manifests/inventories before provider admission.
- Publish the original reduction and focused skill-repair comparisons,
preserving all failures, automatic recovery, cost coverage and
limitations.

## Verification

**Behavioral qualification remains pending.** Original legacy ACP Claude
loses the issue document only in the reduced cohort beneath an unchanged
credential failure. A source-backed diagnosis finds that neither
ordinary assignment reads the staged operational skill, while the
runtime persists provider environment in session state. The new common
repairs expose skill metadata/path and omit persisted env; strict
document and credential guards stay intact. [Inspectable diagnosis and
retained
hashes](https://github.com/paperclipai/paperclip/blob/9f654db4541d3d002769c988f6e51fc0b08dadbd/doc/plans/2026-10-03-legacy-acp-claude-readiness.md).

Current repair head `de0965984ff3edf611ae6d0e7ca5c7d5ae3947bb`
incorporates master `569c7203aa24b95440682983ce7940ba1d4247bd` (merged
#14961/#15007). All 222 affected adapter tests, adapter-utils/E2E
typechecks, and final 96 variant/grader/retry calibrations pass. The
frozen historical comparator is
`c25697f4260b6f3adfea143c3ae9932e2f42986d`: 8,280 of 8,291 paths
identical, exactly two production instruction paths plus nine declared
unit expectations differ. The operational skill/discovery/environment
repairs, selected model/profile/task/core grader/auth/permissions/retry
policy are identical. Both actual launcher prepare→verify admissions
pass with zero providers. [Immutable manifest and exact
receipts](https://github.com/paperclipai/paperclip/blob/9f654db4541d3d002769c988f6e51fc0b08dadbd/doc/plans/2026-10-03-legacy-acp-claude-evidence/manifest.json).

One original legacy ACP Claude cell per variant is authorized, with
enforced single campaign attempts, 12-minute deadlines and company/agent
1,000-cent hard stops; every product recovery run/cost is counted.
Actual live outcomes are pending. Current normal CI has one failed
server shard and failed aggregate verify under diagnosis; other normal
gates including typecheck/build/Rust/all eight browser shards pass.
Fresh review completed successfully; the valid historical startup/resume
masking finding was fixed with per-invocation task/chat checks and
strict complete-snapshot capture, calibrated and resolved. Prior heads,
failures and campaigns below remain historical evidence, not checks on
this repair head.

- Prior head `36aa4d81c49a1a8f6f04b1a068fae19aa901955f` is replayed on
merged hiring master `862a5758ba0e88a33232c1f1fa645e85c38a3113`. All 52
current-head checks pass with two intentional Storybook skips, including
repository typecheck/test/build and the browser shard. Fresh Greptile is
5/5 with zero unresolved review threads. Exact-head stock prerequisites
pass 599 assertions (598 TypeScript + 1 Rust), all six gates and
retained receipt verification, zero providers/source errors. Fingerprint
`a7f5a22d860a88fe20cce213c6d5e0004788f32c8363930729aea4fd740ad16d`.
Combined catalog/hiring calibrations pass 67 assertions, E2E typecheck
and 26-cell stock discovery pass. Canonical contract/inventory checks
and the later issue-derived reference calibration are retained; that
reference-only follow-up is not live-qualified by earlier frozen runs.
- Prior full repository typecheck/build passed. The complete local
Vitest run executed 14,956 tests: 14,870 passed, 83 skipped, three
timing failures. All three affected files passed unchanged narrow
reruns; original failures remain retained. Current-head CI now passes
the full general checks; the original local failures remain retained.
- The original 24-pair default-manual/shared-prompt comparison has two
new overall classic Claude/OpenCode document-delivery failures plus an
additional legacy ACP Claude document loss beneath an unchanged
credential-guard failure (not closed by later runs), two newly passing
OpenCode ordered cases, seven unchanged failures and 13 unchanged
passes. Equal 15/24 totals do not establish behavioral equivalence.
[Complete original
report](https://github.com/paperclipai/paperclip/blob/875f4c397d9e8c3f12f39dedd59abaf1eaf5236e/doc/plans/2026-10-02-stock-harness-live-comparison.md).
- The skill-only repair holds the eight-word manual/shared prompts and
merged #14920 fixed. All four matched profile configurations and 203
fixture/behavior files match. Candidate
`abd0b628ca642c09a54a4edc56a5227402f6686e` varies only the two skill
sources against baseline `bc83fe030234439ac51279502a28803958963e2e`.
[Candidate
workflow](https://github.com/paperclipai/paperclip/actions/runs/37060885547)
and [baseline
workflow](https://github.com/paperclipai/paperclip/actions/runs/37060888047)
each pass 571 exact-source prerequisites before providers; all eight
cells clean up successfully. Failed campaigns publish successfully and
remain failed.
- Repair pairs: Claude original Fail → Pass; Claude explicit Pass →
Pass; both OpenCode cases Fail → Fail. Explicit OpenCode's handoff
worsens beneath the unchanged failing UI-link grade: baseline gives a
clickable API URL, candidate gives a code-formatted path without an
anchor. The request's usable-link wording is narrower in the UI-only
oracle. [Complete repair report and safe
projection](https://github.com/paperclipai/paperclip/blob/875f4c397d9e8c3f12f39dedd59abaf1eaf5236e/doc/plans/2026-10-02-legacy-document-skill-repair.md).
- The subsequent narrow stock metadata/link correction has two matched
Pass → Pass cases, zero new machine failures/passes and no pending
pairs. Both original-case handoff links remain deficient: candidate uses
a wrong PAP prefix, baseline supplies a bare prefix-less slug path; the
preserved original oracle only requires a durable document. Both
explicit clickable UI-link cases pass revision/content/link grading. All
four exact-source 587-check gates, single assignment runs and cleanup
pass. This does not establish fix causality because baseline also
succeeds. [Candidate
workflow](https://github.com/paperclipai/paperclip/actions/runs/37069547401)
freezes `fe9dc1e3c518825242ed889ab9c8352986f8c2ed`; [matched
baseline](https://github.com/paperclipai/paperclip/actions/runs/37069552374)
freezes `0d7ecfa96d72fba79b7f0a25052b42c0686c0488`. This is a skill-only
comparison with reduced manuals/shared prompts held constant, not a
repeat of the historical-manual comparison. Only original and clarified
explicit classic OpenCode cases are selected, two per variant/four
expected turns. 8,242 other tracked files and both profile hashes match;
protected workflows admit each exact source before credentials.
[Complete qualification
report](https://github.com/paperclipai/paperclip/blob/74d0d3d945f4c52d0814b5a845ab5bd09f33cd6b/doc/plans/2026-10-02-opencode-skill-routing-link-qualification.md).
Candidate original loads Paperclip/reference before saving publicly;
baseline original loads it after writing locally, then saves publicly
within the same assignment. Reported cost totals are $0.0107824490
candidate / $0.0107909015 baseline, with unmetered runtime. The later
reference-only issue-derived link correction is provider-free calibrated
and **not live-qualified** by these frozen runs; no further paid runs.
- Retained tool calls show the repaired original OpenCode assignment
loads only its assigned output skill before writing locally. Operational
Paperclip is first loaded during automatic disposition recovery; its
early recipe is visible then, but it never saves the missing document.
Explicit candidate loads Paperclip and reads the new reference before
saving successfully. All nine actual runs are counted. Reported LLM
totals are $0.3802537209 baseline and $0.4918990161 candidate; local
runtime is unmetered.
- Initial setup, packaging, cancelled/missing-cell recovery, callback
test and relative-output attempts remain retained. No completed provider
failure was rerun. Frozen measurement branches are unchanged by later
canonical metadata maintenance.
- Run `pnpm test:e2e:runner:stock-harness`, `pnpm test:e2e:runner:unit`,
and `pnpm test:e2e:runner:typecheck`. Select `stock-harness` explicitly
for paid execution; it is excluded from `--all`.

Prior-head integration: `36aa4d81c49a1a8f6f04b1a068fae19aa901955f`
replays this PR on merged hiring #14985
(`862a5758ba0e88a33232c1f1fa645e85c38a3113`), preserving the four
explicit custom-CEO-bundle checks, minimal generic manual boundary, and
both suites. The combined fixture catalog and hiring calibrations pass
67 assertions; exact-head stock prerequisites pass 599 assertions (598
TypeScript + 1 Rust), all six gates and retained-receipt verification,
zero providers/source errors, fingerprint
`a7f5a22d860a88fe20cce213c6d5e0004788f32c8363930729aea4fd740ad16d`. E2E
typecheck and 26-cell stock discovery pass. Fresh current-head CI passes
all 52 checks with two intentional skips, and fresh Greptile is 5/5 with
zero unresolved review threads.

The prior source-plan browser failure is retained: a deterministic
process fixture replayed its last `fixture:plan` command on
`chat_task_completed`, writing revision 2 with identical body after the
approval handoff. This was not paid provider execution. Rebased
current-head CI passes the same assertion without an old-head retry or a
change to that browser fixture.

The merged hiring change was measured separately on immutable matched
unions, with this reduced/shared/operational context and native
completion guidance held constant. [Complete original two-profile
report](https://github.com/paperclipai/paperclip/blob/f0512647656be78e48abd8c22a3078db8bf6bcd2/doc/plans/2026-10-02-hiring-template-live-comparison.md):
[candidate](https://github.com/paperclipai/paperclip/actions/runs/37075466208)
/ [historical
baseline](https://github.com/paperclipai/paperclip/actions/runs/37075469463),
705 provider-free prerequisites each. Both pairs are unchanged Fail →
Fail on the exact-five count, with six core delivery checks passing all
four cells; 28 actual successful runs include eight automatic completion
wakes, zero retries, four successful cleanups. Source-read coverage is
uncomparable, actual model charges unknown. Separately versioned
provider-free accounting remains analytical work; original verdicts are
preserved. This does not rerun or qualify the completed default-manual
or native campaigns.

## Risks

- Legacy ACP Claude's additional delivery loss is not closed by any
later matched run and blocks the no-extra-failing-behavior merge
criterion. Legacy document delivery may have relied on the prior
manual/shared prompts. The early skill repair improves Claude in one
trial; the later OpenCode pairs pass in both variants and cannot
establish causality or robust recovery. Both original-case links remain
deficient beneath the storage-only grade. The later issue-derived
reference correction has only provider-free validation. Native
finish/block descriptions must not be supplied to legacy agents.
- The comparison holds merged native Codex fix #14920 constant; it
cannot measure that fix's before/after task performance.
- These bounded skill/context/chat workflows do not measure general
coding quality. Unrepresented providers remain unqualified.
- Saved manuals and old Codex sessions are not automatically migrated.
Codex through ACP still has a separate base-instruction follow-up.

## Model Used

OpenAI Codex, GPT-6 family as identified by this session. The exact
deployment ID and context-window size are not exposed. The assistant
used reasoning, repository tools, code execution, and delegated PR/eval
work.

## Checklist

- [x] I have included a thinking path that traces from project context
to this change
- [x] I have specified the model used (with version and capability
details)
- [x] I have checked ROADMAP.md and confirmed this PR does not duplicate
planned core work
- [x] I have searched GitHub for duplicate or related PRs and linked
them above
- [x] I have either (a) linked existing issues with `Fixes: #` /
`Closes: #` / `Refs: #` OR (b) described the issue in-PR following the
relevant issue template
- [x] I have not referenced internal/instance-local Paperclip issues or
links (only public GitHub `#NNN` / `github.com/paperclipai/paperclip`
URLs)
- [x] My branch name describes the change (e.g. `docs/...`, `fix/...`)
and contains no internal Paperclip ticket id or instance-derived details
- [x] I have run tests locally and they pass (relevant suites and all
three unchanged narrow reruns pass; complete-run timing failures
retained in Verification)
- [x] I have added or updated tests where applicable
- [x] I have updated relevant documentation to reflect my changes
- [x] I have considered and documented any risks above
- [ ] All Paperclip CI gates are green on the new repair head
(prior-head checks retained above)
- [ ] Greptile is 5/5 with no open P2s, recommendations, or follow-ups
on the new repair head
- [x] I will address all Greptile and reviewer comments before
requesting merge

---------

Co-authored-by: Paperclip <noreply@paperclip.ing>
2026-10-03 12:32:42 -05:00

30 KiB

Capability Capability Contract

This generated contract is a self-contained derivative of the Paperclip skill, its seven references, the Paperclip Evals corpus, and the legacy MCP tool surface. It does not import or contact the Paperclip control plane.

The skill/reference inventory and eval cases are the only normative behavior sources. Paperclip does not use the legacy MCP calls as a production capability surface; all MCP names below are traceability aliases folded into normative eval rows. Their disposition, grants, assertions, and evidence contract are inherited from the target row rather than classified independently.

Baseline Counts

  • Skill/reference headings: 160
  • Eval cases: 106 across 16 groups
  • Total normative rows: 266
  • Legacy MCP aliases folded into normative rows: 42
Eval group Cases
hb 5
co 6
st 8
cm 6
se 4
su 4
bl 5
dp 3
ix 9
ap 6
ar 4
er 9
rf 22
mh 4
rs 3
wk 8

Regeneration

  • pnpm --dir packages/paperclip-runner generate:capability-inventory imports the canonical baselines and rewrites every generated file.
  • pnpm --dir packages/paperclip-runner check:capability-inventory validates counts, uniqueness, normative dispositions, one-to-one MCP folds, required fields, and generated-file drift without requiring the external eval repository.

Skill / Reference Rows

Capability Primary disposition Source anchor
skill:skills/paperclip/SKILL.md:paperclip-skill:10 optional_agent_tool skills/paperclip/SKILL.md:10
skill:skills/paperclip/SKILL.md:terminology:14 optional_agent_tool skills/paperclip/SKILL.md:14
skill:skills/paperclip/SKILL.md:authentication:20 control_plane_owned skills/paperclip/SKILL.md:20
skill:skills/paperclip/SKILL.md:conversation-tasks:32 optional_agent_tool skills/paperclip/SKILL.md:32
skill:skills/paperclip/SKILL.md:server-verified-external-chat-turns:49 control_plane_owned skills/paperclip/SKILL.md:49
skill:skills/paperclip/SKILL.md:the-heartbeat-procedure:89 optional_agent_tool skills/paperclip/SKILL.md:89
skill:skills/paperclip/SKILL.md:generated-artifacts-and-work-products:198 always_agent_tool skills/paperclip/SKILL.md:198
skill:skills/paperclip/SKILL.md:status-quick-guide:246 control_plane_owned skills/paperclip/SKILL.md:246
skill:skills/paperclip/SKILL.md:monitors-and-watchers-say-only-what-you-actually-scheduled:256 optional_agent_tool skills/paperclip/SKILL.md:256
skill:skills/paperclip/SKILL.md:delegating-review-tasks:269 always_agent_tool skills/paperclip/SKILL.md:269
skill:skills/paperclip/SKILL.md:managing-a-user-s-inbox:280 control_plane_owned skills/paperclip/SKILL.md:280
skill:skills/paperclip/SKILL.md:issue-dependencies-blockers:288 control_plane_owned skills/paperclip/SKILL.md:288
skill:skills/paperclip/SKILL.md:requesting-board-approval:313 optional_agent_tool skills/paperclip/SKILL.md:313
skill:skills/paperclip/SKILL.md:issue-thread-interactions:334 optional_agent_tool skills/paperclip/SKILL.md:334
skill:skills/paperclip/SKILL.md:standalone-decisions:363 optional_agent_tool skills/paperclip/SKILL.md:363
skill:skills/paperclip/SKILL.md:mcp-tool-approval-gates:467 optional_agent_tool skills/paperclip/SKILL.md:467
skill:skills/paperclip/SKILL.md:niche-workflow-pointers:509 optional_agent_tool skills/paperclip/SKILL.md:509
skill:skills/paperclip/SKILL.md:cases:519 optional_agent_tool skills/paperclip/SKILL.md:519
skill:skills/paperclip/SKILL.md:company-skills-workflow:524 optional_agent_tool skills/paperclip/SKILL.md:524
skill:skills/paperclip/SKILL.md:routines:535 optional_agent_tool skills/paperclip/SKILL.md:535
skill:skills/paperclip/SKILL.md:issue-workspace-runtime-controls:546 optional_agent_tool skills/paperclip/SKILL.md:546
skill:skills/paperclip/SKILL.md:proposing-credentials-safely:553 optional_agent_tool skills/paperclip/SKILL.md:553
skill:skills/paperclip/SKILL.md:reading-granted-secrets:560 optional_agent_tool skills/paperclip/SKILL.md:560
skill:skills/paperclip/SKILL.md:critical-rules:586 optional_agent_tool skills/paperclip/SKILL.md:586
skill:skills/paperclip/SKILL.md:comment-style-required:607 always_agent_tool skills/paperclip/SKILL.md:607
skill:skills/paperclip/SKILL.md:update:639 optional_agent_tool skills/paperclip/SKILL.md:639
skill:skills/paperclip/SKILL.md:planning-required-when-planning-requested:649 optional_agent_tool skills/paperclip/SKILL.md:649
skill:skills/paperclip/SKILL.md:key-endpoints-hot-routes:682 optional_agent_tool skills/paperclip/SKILL.md:682
skill:skills/paperclip/SKILL.md:searching-issues:711 optional_agent_tool skills/paperclip/SKILL.md:711
skill:skills/paperclip/SKILL.md:full-reference:721 optional_agent_tool skills/paperclip/SKILL.md:721
skill:skills/paperclip/SKILL.md:conversational-confirmation-answers:725 always_agent_tool skills/paperclip/SKILL.md:725
skill:skills/paperclip/references/api-reference.md:paperclip-api-reference:1 optional_agent_tool skills/paperclip/references/api-reference.md:1
skill:skills/paperclip/references/api-reference.md:response-schemas:9 optional_agent_tool skills/paperclip/references/api-reference.md:9
skill:skills/paperclip/references/api-reference.md:agent-record-get-api-agents-me-or-get-api-agents-agentid:11 optional_agent_tool skills/paperclip/references/api-reference.md:11
skill:skills/paperclip/references/api-reference.md:company-portability:44 optional_agent_tool skills/paperclip/references/api-reference.md:44
skill:skills/paperclip/references/api-reference.md:issue-with-ancestors-get-api-issues-issueid:110 optional_agent_tool skills/paperclip/references/api-reference.md:110
skill:skills/paperclip/references/api-reference.md:issue-update-response-patch-api-issues-issueid:196 optional_agent_tool skills/paperclip/references/api-reference.md:196
skill:skills/paperclip/references/api-reference.md:blocker-diagnostics-get-api-issues-issueid-diagnostics-blockers:238 control_plane_owned skills/paperclip/references/api-reference.md:238
skill:skills/paperclip/references/api-reference.md:wake-diagnostics-get-api-issues-issueid-diagnostics-wakes:277 control_plane_owned skills/paperclip/references/api-reference.md:277
skill:skills/paperclip/references/api-reference.md:subtree-diagnostics-get-api-issues-issueid-diagnostics-subtree:321 optional_agent_tool skills/paperclip/references/api-reference.md:321
skill:skills/paperclip/references/api-reference.md:execution-policy-fields-on-an-issue:369 optional_agent_tool skills/paperclip/references/api-reference.md:369
skill:skills/paperclip/references/api-reference.md:cross-agent-review-gates:421 always_agent_tool skills/paperclip/references/api-reference.md:421
skill:skills/paperclip/references/api-reference.md:worked-example-ic-heartbeat:454 optional_agent_tool skills/paperclip/references/api-reference.md:454
skill:skills/paperclip/references/api-reference.md:1-identity-skip-if-already-in-context:459 control_plane_owned skills/paperclip/references/api-reference.md:459
skill:skills/paperclip/references/api-reference.md:2-check-inbox:463 control_plane_owned skills/paperclip/references/api-reference.md:463
skill:skills/paperclip/references/api-reference.md:3-already-have-issue-101-inprogress-highest-priority-continue-it:470 optional_agent_tool skills/paperclip/references/api-reference.md:470
skill:skills/paperclip/references/api-reference.md:4-do-the-actual-work-write-code-run-tests:477 optional_agent_tool skills/paperclip/references/api-reference.md:477
skill:skills/paperclip/references/api-reference.md:5-work-is-done-update-status-and-comment-in-one-call:479 always_agent_tool skills/paperclip/references/api-reference.md:479
skill:skills/paperclip/references/api-reference.md:6-still-have-time-checkout-the-next-task:483 control_plane_owned skills/paperclip/references/api-reference.md:483
skill:skills/paperclip/references/api-reference.md:7-made-partial-progress-not-done-yet-comment-and-exit:490 always_agent_tool skills/paperclip/references/api-reference.md:490
skill:skills/paperclip/references/api-reference.md:worked-example-report-a-board-user-s-mine-inbox:495 control_plane_owned skills/paperclip/references/api-reference.md:495
skill:skills/paperclip/references/api-reference.md:board-user-created-the-requesting-issue:500 optional_agent_tool skills/paperclip/references/api-reference.md:500
skill:skills/paperclip/references/api-reference.md:fetch-the-board-user-s-mine-inbox-issues:504 control_plane_owned skills/paperclip/references/api-reference.md:504
skill:skills/paperclip/references/api-reference.md:summarize-it-back-to-the-board-in-a-comment-or-document:518 always_agent_tool skills/paperclip/references/api-reference.md:518
skill:skills/paperclip/references/api-reference.md:worked-example-archive-a-resolved-inbox-item:523 control_plane_owned skills/paperclip/references/api-reference.md:523
skill:skills/paperclip/references/api-reference.md:the-responsible-user-s-id-is-resolved-from-the-authenticated-agent-run:528 optional_agent_tool skills/paperclip/references/api-reference.md:528
skill:skills/paperclip/references/api-reference.md:reverse-the-archive-if-it-was-premature-or-no-longer-desired:537 optional_agent_tool skills/paperclip/references/api-reference.md:537
skill:skills/paperclip/references/api-reference.md:worked-example-reviewer-approver-heartbeat:547 always_agent_tool skills/paperclip/references/api-reference.md:547
skill:skills/paperclip/references/api-reference.md:worked-example-manager-heartbeat:586 optional_agent_tool skills/paperclip/references/api-reference.md:586
skill:skills/paperclip/references/api-reference.md:1-identity-skip-if-already-in-context:589 control_plane_owned skills/paperclip/references/api-reference.md:589
skill:skills/paperclip/references/api-reference.md:2-check-team-status:593 optional_agent_tool skills/paperclip/references/api-reference.md:593
skill:skills/paperclip/references/api-reference.md:3-agent-42-is-blocked-read-comments:600 control_plane_owned skills/paperclip/references/api-reference.md:600
skill:skills/paperclip/references/api-reference.md:4-unblock-reassign-and-comment:604 control_plane_owned skills/paperclip/references/api-reference.md:604
skill:skills/paperclip/references/api-reference.md:5-check-own-assignments:608 optional_agent_tool skills/paperclip/references/api-reference.md:608
skill:skills/paperclip/references/api-reference.md:6-create-subtasks-and-delegate:615 optional_agent_tool skills/paperclip/references/api-reference.md:615
skill:skills/paperclip/references/api-reference.md:load-tests-depend-on-caching-layer-being-done-first-paperclip-will-auto-wake-agent-55-when-the-blocker-resolves:621 control_plane_owned skills/paperclip/references/api-reference.md:621
skill:skills/paperclip/references/api-reference.md:7-dashboard-for-health-check:626 optional_agent_tool skills/paperclip/references/api-reference.md:626
skill:skills/paperclip/references/api-reference.md:comments-and-mentions:632 always_agent_tool skills/paperclip/references/api-reference.md:632
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:661 optional_agent_tool skills/paperclip/references/api-reference.md:661
skill:skills/paperclip/references/api-reference.md:receiving-cross-team-work:665 optional_agent_tool skills/paperclip/references/api-reference.md:665
skill:skills/paperclip/references/api-reference.md:questions-and-dependencies:675 always_agent_tool skills/paperclip/references/api-reference.md:675
skill:skills/paperclip/references/api-reference.md:company-context:687 optional_agent_tool skills/paperclip/references/api-reference.md:687
skill:skills/paperclip/references/api-reference.md:company-branding-ceo-board:699 optional_agent_tool skills/paperclip/references/api-reference.md:699
skill:skills/paperclip/references/api-reference.md:openclaw-invite-prompt-ceo:719 optional_agent_tool skills/paperclip/references/api-reference.md:719
skill:skills/paperclip/references/api-reference.md:setting-agent-instructions-path:738 optional_agent_tool skills/paperclip/references/api-reference.md:738
skill:skills/paperclip/references/api-reference.md:project-setup-create-workspace:771 optional_agent_tool skills/paperclip/references/api-reference.md:771
skill:skills/paperclip/references/api-reference.md:option-a-one-call-create-with-workspace:795 optional_agent_tool skills/paperclip/references/api-reference.md:795
skill:skills/paperclip/references/api-reference.md:option-b-two-calls-project-first-then-workspace:814 optional_agent_tool skills/paperclip/references/api-reference.md:814
skill:skills/paperclip/references/api-reference.md:governance-and-approvals:843 optional_agent_tool skills/paperclip/references/api-reference.md:843
skill:skills/paperclip/references/api-reference.md:requesting-a-hire-management-only:847 optional_agent_tool skills/paperclip/references/api-reference.md:847
skill:skills/paperclip/references/api-reference.md:ceo-strategy-approval:912 optional_agent_tool skills/paperclip/references/api-reference.md:912
skill:skills/paperclip/references/api-reference.md:questions-and-waiting-for-human-input:921 always_agent_tool skills/paperclip/references/api-reference.md:921
skill:skills/paperclip/references/api-reference.md:issue-thread-confirmations:1025 always_agent_tool skills/paperclip/references/api-reference.md:1025
skill:skills/paperclip/references/api-reference.md:conversational-confirmation-answers:1083 always_agent_tool skills/paperclip/references/api-reference.md:1083
skill:skills/paperclip/references/api-reference.md:checkbox-confirmations:1089 always_agent_tool skills/paperclip/references/api-reference.md:1089
skill:skills/paperclip/references/api-reference.md:item-verdict-requests:1204 optional_agent_tool skills/paperclip/references/api-reference.md:1204
skill:skills/paperclip/references/api-reference.md:checking-approval-status:1314 optional_agent_tool skills/paperclip/references/api-reference.md:1314
skill:skills/paperclip/references/api-reference.md:approval-follow-up-requesting-agent:1320 always_agent_tool skills/paperclip/references/api-reference.md:1320
skill:skills/paperclip/references/api-reference.md:issue-lifecycle:1338 always_agent_tool skills/paperclip/references/api-reference.md:1338
skill:skills/paperclip/references/api-reference.md:error-handling:1368 control_plane_owned skills/paperclip/references/api-reference.md:1368
skill:skills/paperclip/references/api-reference.md:full-api-reference:1382 optional_agent_tool skills/paperclip/references/api-reference.md:1382
skill:skills/paperclip/references/api-reference.md:agents:1384 optional_agent_tool skills/paperclip/references/api-reference.md:1384
skill:skills/paperclip/references/api-reference.md:issues-tasks:1405 optional_agent_tool skills/paperclip/references/api-reference.md:1405
skill:skills/paperclip/references/api-reference.md:companies-projects-goals:1446 optional_agent_tool skills/paperclip/references/api-reference.md:1446
skill:skills/paperclip/references/api-reference.md:routines:1470 optional_agent_tool skills/paperclip/references/api-reference.md:1470
skill:skills/paperclip/references/api-reference.md:approvals-costs-activity-dashboard:1486 optional_agent_tool skills/paperclip/references/api-reference.md:1486
skill:skills/paperclip/references/api-reference.md:secrets:1508 optional_agent_tool skills/paperclip/references/api-reference.md:1508
skill:skills/paperclip/references/api-reference.md:agent-secret-proposals:1521 optional_agent_tool skills/paperclip/references/api-reference.md:1521
skill:skills/paperclip/references/api-reference.md:agent-secret-access:1621 optional_agent_tool skills/paperclip/references/api-reference.md:1621
skill:skills/paperclip/references/api-reference.md:common-mistakes:1661 optional_agent_tool skills/paperclip/references/api-reference.md:1661
skill:skills/paperclip/references/artifacts.md:generated-artifacts-and-work-products:1 always_agent_tool skills/paperclip/references/artifacts.md:1
skill:skills/paperclip/references/artifacts.md:workspace-only-file-references:15 optional_agent_tool skills/paperclip/references/artifacts.md:15
skill:skills/paperclip/references/cases.md:cases:1 optional_agent_tool skills/paperclip/references/cases.md:1
skill:skills/paperclip/references/cases.md:core-model:12 optional_agent_tool skills/paperclip/references/cases.md:12
skill:skills/paperclip/references/cases.md:upsert-semantics:29 optional_agent_tool skills/paperclip/references/cases.md:29
skill:skills/paperclip/references/cases.md:read-and-search:67 optional_agent_tool skills/paperclip/references/cases.md:67
skill:skills/paperclip/references/cases.md:documents:90 always_agent_tool skills/paperclip/references/cases.md:90
skill:skills/paperclip/references/cases.md:fields:118 optional_agent_tool skills/paperclip/references/cases.md:118
skill:skills/paperclip/references/cases.md:issue-links:151 optional_agent_tool skills/paperclip/references/cases.md:151
skill:skills/paperclip/references/cases.md:child-cases:176 optional_agent_tool skills/paperclip/references/cases.md:176
skill:skills/paperclip/references/cases.md:attachments:195 optional_agent_tool skills/paperclip/references/cases.md:195
skill:skills/paperclip/references/cases.md:lifecycle:208 optional_agent_tool skills/paperclip/references/cases.md:208
skill:skills/paperclip/references/cases.md:worked-blog-post-example:222 optional_agent_tool skills/paperclip/references/cases.md:222
skill:skills/paperclip/references/company-skills.md:company-skills-workflow:1 optional_agent_tool skills/paperclip/references/company-skills.md:1
skill:skills/paperclip/references/company-skills.md:what-exists:5 optional_agent_tool skills/paperclip/references/company-skills.md:5
skill:skills/paperclip/references/company-skills.md:permission-model:22 optional_agent_tool skills/paperclip/references/company-skills.md:22
skill:skills/paperclip/references/company-skills.md:core-endpoints:29 optional_agent_tool skills/paperclip/references/company-skills.md:29
skill:skills/paperclip/references/company-skills.md:install-a-skill-into-the-company:65 optional_agent_tool skills/paperclip/references/company-skills.md:65
skill:skills/paperclip/references/company-skills.md:app-shipped-catalog:75 optional_agent_tool skills/paperclip/references/company-skills.md:75
skill:skills/paperclip/references/company-skills.md:external-source-import:101 optional_agent_tool skills/paperclip/references/company-skills.md:101
skill:skills/paperclip/references/company-skills.md:source-types-in-order-of-preference:105 optional_agent_tool skills/paperclip/references/company-skills.md:105
skill:skills/paperclip/references/company-skills.md:example-skills-sh-import-preferred:116 optional_agent_tool skills/paperclip/references/company-skills.md:116
skill:skills/paperclip/references/company-skills.md:example-github-import:138 optional_agent_tool skills/paperclip/references/company-skills.md:138
skill:skills/paperclip/references/company-skills.md:inspect-what-was-installed:164 optional_agent_tool skills/paperclip/references/company-skills.md:164
skill:skills/paperclip/references/company-skills.md:assign-skills-to-an-existing-agent:181 optional_agent_tool skills/paperclip/references/company-skills.md:181
skill:skills/paperclip/references/company-skills.md:include-skills-during-hire-or-create:216 optional_agent_tool skills/paperclip/references/company-skills.md:216
skill:skills/paperclip/references/company-skills.md:notes:256 optional_agent_tool skills/paperclip/references/company-skills.md:256
skill:skills/paperclip/references/issue-documents.md:issue-documents-through-the-api:1 always_agent_tool skills/paperclip/references/issue-documents.md:1
skill:skills/paperclip/references/issue-documents.md:create-a-document:8 always_agent_tool skills/paperclip/references/issue-documents.md:8
skill:skills/paperclip/references/issue-documents.md:update-or-resolve-an-unclear-write:49 optional_agent_tool skills/paperclip/references/issue-documents.md:49
skill:skills/paperclip/references/issue-workspaces.md:issue-workspace-runtime-controls:1 optional_agent_tool skills/paperclip/references/issue-workspaces.md:1
skill:skills/paperclip/references/issue-workspaces.md:discover-the-workspace:5 optional_agent_tool skills/paperclip/references/issue-workspaces.md:5
skill:skills/paperclip/references/issue-workspaces.md:control-services:23 optional_agent_tool skills/paperclip/references/issue-workspaces.md:23
skill:skills/paperclip/references/issue-workspaces.md:start-all-configured-services-waits-for-configured-readiness-checks:28 optional_agent_tool skills/paperclip/references/issue-workspaces.md:28
skill:skills/paperclip/references/issue-workspaces.md:restart-all-configured-services:36 optional_agent_tool skills/paperclip/references/issue-workspaces.md:36
skill:skills/paperclip/references/issue-workspaces.md:stop-all-running-services:44 optional_agent_tool skills/paperclip/references/issue-workspaces.md:44
skill:skills/paperclip/references/issue-workspaces.md:read-the-url:63 optional_agent_tool skills/paperclip/references/issue-workspaces.md:63
skill:skills/paperclip/references/issue-workspaces.md:mcp-tools:72 optional_agent_tool skills/paperclip/references/issue-workspaces.md:72
skill:skills/paperclip/references/routines.md:paperclip-routines:1 optional_agent_tool skills/paperclip/references/routines.md:1
skill:skills/paperclip/references/routines.md:lifecycle:16 optional_agent_tool skills/paperclip/references/routines.md:16
skill:skills/paperclip/references/routines.md:creating-a-routine:27 optional_agent_tool skills/paperclip/references/routines.md:27
skill:skills/paperclip/references/routines.md:concurrency-policies:64 optional_agent_tool skills/paperclip/references/routines.md:64
skill:skills/paperclip/references/routines.md:catch-up-policies:76 optional_agent_tool skills/paperclip/references/routines.md:76
skill:skills/paperclip/references/routines.md:activity-gated-scheduled-runs:87 optional_agent_tool skills/paperclip/references/routines.md:87
skill:skills/paperclip/references/routines.md:example-skip-quiet-nights:107 optional_agent_tool skills/paperclip/references/routines.md:107
skill:skills/paperclip/references/routines.md:adding-triggers:126 optional_agent_tool skills/paperclip/references/routines.md:126
skill:skills/paperclip/references/routines.md:schedule-cron:136 optional_agent_tool skills/paperclip/references/routines.md:136
skill:skills/paperclip/references/routines.md:webhook:150 optional_agent_tool skills/paperclip/references/routines.md:150
skill:skills/paperclip/references/routines.md:api-manual-only:167 optional_agent_tool skills/paperclip/references/routines.md:167
skill:skills/paperclip/references/routines.md:updating-and-deleting-triggers:179 optional_agent_tool skills/paperclip/references/routines.md:179
skill:skills/paperclip/references/routines.md:manual-run:196 optional_agent_tool skills/paperclip/references/routines.md:196
skill:skills/paperclip/references/routines.md:updating-a-routine:212 optional_agent_tool skills/paperclip/references/routines.md:212
skill:skills/paperclip/references/routines.md:reading-routines-and-runs:223 optional_agent_tool skills/paperclip/references/routines.md:223
skill:skills/paperclip/references/workflows.md:paperclip-workflow-playbooks:1 optional_agent_tool skills/paperclip/references/workflows.md:1
skill:skills/paperclip/references/workflows.md:project-setup-ceo-manager:7 optional_agent_tool skills/paperclip/references/workflows.md:7
skill:skills/paperclip/references/workflows.md:openclaw-invite-ceo:22 optional_agent_tool skills/paperclip/references/workflows.md:22
skill:skills/paperclip/references/workflows.md:setting-agent-instructions-path:50 optional_agent_tool skills/paperclip/references/workflows.md:50
skill:skills/paperclip/references/workflows.md:company-import-export:79 optional_agent_tool skills/paperclip/references/workflows.md:79
skill:skills/paperclip/references/workflows.md:self-test-playbook-app-level:106 optional_agent_tool skills/paperclip/references/workflows.md:106

Legacy MCP Alias Index

This is a compatibility/traceability index, not a tool catalog. “Inherited disposition” is shown only to make the normative target easy to audit.

Legacy MCP name Folded into normative row Inherited disposition Source anchor
paperclipMe eval:hb-inbox-lite-01 control_plane_owned packages/mcp-server/src/tools.ts:290
paperclipInboxLite eval:hb-inbox-lite-01 control_plane_owned packages/mcp-server/src/tools.ts:296
paperclipListAgents eval:rf-api-mgr-heartbeat-01 optional_agent_tool packages/mcp-server/src/tools.ts:302
paperclipListSkills eval:rf-cskill-audit-01 optional_agent_tool packages/mcp-server/src/tools.ts:308
paperclipGetAgent eval:rf-api-mgr-heartbeat-01 optional_agent_tool packages/mcp-server/src/tools.ts:314
paperclipListIssues eval:se-q-filters-01 optional_agent_tool packages/mcp-server/src/tools.ts:323
paperclipGetIssue eval:se-get-issue-01 optional_agent_tool packages/mcp-server/src/tools.ts:338
paperclipGetHeartbeatContext eval:hb-context-01 control_plane_owned packages/mcp-server/src/tools.ts:344
paperclipListComments eval:se-get-issue-01 optional_agent_tool packages/mcp-server/src/tools.ts:353
paperclipGetComment eval:hb-wake-comment-01 control_plane_owned packages/mcp-server/src/tools.ts:366
paperclipListIssueApprovals eval:ap-board-approval-01 optional_agent_tool packages/mcp-server/src/tools.ts:373
paperclipListDocuments eval:dp-base-revision-01 always_agent_tool packages/mcp-server/src/tools.ts:379
paperclipGetDocument eval:dp-base-revision-01 always_agent_tool packages/mcp-server/src/tools.ts:385
paperclipListDocumentRevisions eval:dp-base-revision-01 always_agent_tool packages/mcp-server/src/tools.ts:392
paperclipListProjects eval:rf-wf-project-setup-01 optional_agent_tool packages/mcp-server/src/tools.ts:402
paperclipGetProject eval:rf-wf-project-setup-01 optional_agent_tool packages/mcp-server/src/tools.ts:408
paperclipGetIssueWorkspaceRuntime eval:rf-iws-start-url-01 optional_agent_tool packages/mcp-server/src/tools.ts:417
paperclipControlIssueWorkspaceServices eval:rf-iws-start-url-01 optional_agent_tool packages/mcp-server/src/tools.ts:423
paperclipWaitForIssueWorkspaceService eval:rf-iws-target-restart-01 optional_agent_tool packages/mcp-server/src/tools.ts:440
paperclipListGoals eval:su-parent-goal-01 optional_agent_tool packages/mcp-server/src/tools.ts:466
paperclipGetGoal eval:su-parent-goal-01 optional_agent_tool packages/mcp-server/src/tools.ts:472
paperclipListApprovals eval:ap-approval-wake-01 optional_agent_tool packages/mcp-server/src/tools.ts:478
paperclipCreateApproval eval:ap-board-approval-01 optional_agent_tool packages/mcp-server/src/tools.ts:487
paperclipGetApproval eval:ap-approval-wake-01 optional_agent_tool packages/mcp-server/src/tools.ts:496
paperclipGetApprovalIssues eval:ap-approval-wake-01 optional_agent_tool packages/mcp-server/src/tools.ts:502
paperclipListApprovalComments eval:ap-approval-deny-01 optional_agent_tool packages/mcp-server/src/tools.ts:508
paperclipCreateIssue eval:su-parent-goal-01 optional_agent_tool packages/mcp-server/src/tools.ts:514
paperclipUpdateIssue eval:st-done-comment-01 always_agent_tool packages/mcp-server/src/tools.ts:521
paperclipCheckoutIssue eval:co-body-contract-01 control_plane_owned packages/mcp-server/src/tools.ts:528
paperclipReleaseIssue eval:er-release-01 control_plane_owned packages/mcp-server/src/tools.ts:540
paperclipAddComment eval:cm-multiline-01 always_agent_tool packages/mcp-server/src/tools.ts:546
paperclipSuggestTasks eval:ix-suggest-tasks-01 always_agent_tool packages/mcp-server/src/tools.ts:553
paperclipAskUserQuestions eval:ix-questions-01 always_agent_tool packages/mcp-server/src/tools.ts:565
paperclipRequestConfirmation eval:ix-confirmation-plan-01 always_agent_tool packages/mcp-server/src/tools.ts:577
paperclipRequestCheckboxConfirmation eval:ix-checkbox-01 always_agent_tool packages/mcp-server/src/tools.ts:589
paperclipUpsertIssueDocument eval:dp-plan-doc-01 always_agent_tool packages/mcp-server/src/tools.ts:601
paperclipRestoreIssueDocumentRevision eval:dp-base-revision-01 always_agent_tool packages/mcp-server/src/tools.ts:612
paperclipLinkIssueApproval eval:ap-board-approval-01 optional_agent_tool packages/mcp-server/src/tools.ts:627
paperclipUnlinkIssueApproval eval:ap-board-approval-01 optional_agent_tool packages/mcp-server/src/tools.ts:636
paperclipApprovalDecision eval:ap-approval-wake-01 optional_agent_tool packages/mcp-server/src/tools.ts:646
paperclipAddApprovalComment eval:ap-approval-deny-01 optional_agent_tool packages/mcp-server/src/tools.ts:668
paperclipApiRequest eval:rf-api-404-report-01 optional_agent_tool packages/mcp-server/src/tools.ts:677