Files
PaperClipAI/packages/teams-catalog/generated/catalog.json
T
DottaandPaperclip ce1ee9e89f fix: stop prompts from encouraging subtasks (#20362)
## Thinking Path

> - Paperclip is the open source app people use to manage AI agents for
work.
> - Agents read runtime prompts, tool help, skills, and role
instructions.
> - Several of these texts tell agents to create child tasks as a normal
next step.
> - One accepted-plan prompt even forbids work on the current task.
> - Task parentage is useful, but it does not need a prompt that
encourages task creation.
> - This pull request removes those prompts and keeps the task APIs
available.

## Linked Issues or Issue Description

Refs #10642. This change adjusts prompt wording; it does not add
delegation-cycle guards.

**Current behavior**
Prompts tell agents to create children after plan approval, use children
for long work, and create a task just to pass context. Onboarding
requires a child even for a single request.

**Proposed behavior**
Continue work on the current task. Keep explicit assignments, optional
task creation, parentage, dependencies, and approval gates. Use the
separate-task recipes when the user requests that structure or when
continuing existing work.

**Reason and benefit**
Reduce needless task trees without removing subtask support. Keep the
patch limited to wording, existing test expectations, and generated
catalog data.

## What Changed

- Align accepted-plan prompts and remove direct child-creation advice
from runtime and error text.
- Make task tool descriptions neutral. Keep their fields, defaults, and
handlers.
- Update the main skill, onboarding, CEO instructions, company
templates, specialist workflows, and matching guides.
- Keep historical release snapshots intact. Refresh the explicitly
seeded schema fixture's catalog digest; the server still verifies
historical release snapshot hashes.
- Refresh the affected generated catalogs, capability inventory,
semantic contracts, and fixture manifest.

## Verification

- Final tested head: `c6e304d0c105cdbfbe0b2ab0a233307fcd91a04b`.
- All 66 check runs are complete: 60 pass, one is neutral, and five are
skipped by CI conditions. Snyk also passes. No checks fail or remain
pending.
- [PR
CI](https://github.com/paperclipai/paperclip/actions/runs/42846226554)
passes typecheck, build, server/general tests, all eight E2E shards,
Runner support, Runner Rust, and the aggregate verify gate.
[Windows](https://github.com/paperclipai/paperclip/actions/runs/42846226546)
and [Docker
Runner](https://github.com/paperclipai/paperclip/actions/runs/42846226108)
also pass.
-
[Greptile](https://github.com/paperclipai/paperclip/pull/20362#issuecomment-6751419835)
and [Paperclip
review](https://github.com/paperclipai/paperclip/pull/20362#issuecomment-6751454010)
give this exact head 5/5. All six inline threads are resolved. Neither
current summary has findings.
- Merged master `bf0220d34a156c81853755c3d1365ddc527037de`. Resolved
three generated-file conflicts with the canonical generators.
- Local verification passes: 473 focused prompt, continuation, UI,
catalog, runtime and native-execution tests; Runner TypeScript build;
generated metadata; UI token gates; and diff checks.
- The prior head `c22018cb0f` failed three SDK evidence tests because
two source hashes were stale. Reproduced all three failures locally. The
existing generator refreshed only the hashes for the denial-copy file
and its test. All 53 affected evidence/source-pin tests then passed,
including private-value rejection. No scanner logic, assertions, or
runtime dependency pins changed. Current CI confirms the support suite
passes.
- A prior commit failed the Rust process reaping test. Its cause remains
unproven. No Rust code or assertions changed. Later Rust runs pass; this
does not establish the cause of the earlier failure.
- Local preflight built shared/plugin SDK packages, then stopped because
`cargo` is absent. Current-head CI supplies Rust and full build
coverage. `pnpm verify --explain` selects broad required CI; full local
suites were not repeated.

## Risks

- Wording changes guide the model; they do not enforce a ban on
subtasks.
- Existing installed skill versions and saved custom instructions need
their normal refresh process. This PR does not migrate company
configuration.
- Existing approved task assignments and approval gates remain in
effect.

## Model Used

- OpenAI GPT-6, through Codex, with reasoning, tool use, and code
execution. The exact routed model ID and context-window size were not
exposed in this session.

## 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
- [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
- [x] All Paperclip CI gates are green
- [x] Greptile is 5/5 with no open P2s, recommendations, or follow-ups
- [x] I will address all Greptile and reviewer comments before
requesting merge

---------

Co-authored-by: Paperclip <noreply@paperclip.ing>
2026-11-10 09:58:54 -06:00

540 lines
17 KiB
JSON

{
"schemaVersion": 1,
"packageName": "@paperclipai/teams-catalog",
"packageVersion": "0.1.0",
"generatedAt": "2026-11-09T20:56:53.242Z",
"teams": [
{
"id": "paperclipai:bundled:company-defaults:core-exec-team",
"key": "paperclipai/bundled/company-defaults/core-exec-team",
"kind": "bundled",
"category": "company-defaults",
"slug": "core-exec-team",
"name": "Core Exec Team",
"description": "Default leadership and engineering team for bootstrapping a Paperclip company with a CEO, CTO, QA Engineer, starter project, and a recurring CEO heartbeat review task.",
"path": "catalog/bundled/company-defaults/core-exec-team",
"entrypoint": "TEAM.md",
"schema": "agentcompanies/v1",
"defaultInstall": true,
"recommendedForCompanyTypes": [
"startup",
"software",
"generalist"
],
"tags": [
"default",
"executive",
"engineering",
"qa"
],
"counts": {
"agents": 3,
"projects": 1,
"tasks": 0,
"routines": 1,
"localSkills": 0,
"catalogSkills": 4,
"externalSkillSources": 0
},
"rootAgentSlugs": [
"ceo"
],
"agentSlugs": [
"ceo",
"cto",
"qa"
],
"projectSlugs": [
"first-project"
],
"requiredSkills": [
{
"type": "catalog",
"ref": "github-pr-workflow",
"agentSlugs": [
"cto"
],
"resolved": true,
"catalogSkillId": "paperclipai:bundled:software-development:github-pr-workflow",
"catalogSkillKey": "paperclipai/bundled/software-development/github-pr-workflow"
},
{
"type": "catalog",
"ref": "issue-triage",
"agentSlugs": [
"ceo"
],
"resolved": true,
"catalogSkillId": "paperclipai:bundled:paperclip-operations:issue-triage",
"catalogSkillKey": "paperclipai/bundled/paperclip-operations/issue-triage"
},
{
"type": "catalog",
"ref": "qa-acceptance",
"agentSlugs": [
"qa"
],
"resolved": true,
"catalogSkillId": "paperclipai:bundled:quality:qa-acceptance",
"catalogSkillKey": "paperclipai/bundled/quality/qa-acceptance"
},
{
"type": "catalog",
"ref": "task-planning",
"agentSlugs": [
"ceo",
"cto"
],
"resolved": true,
"catalogSkillId": "paperclipai:bundled:paperclip-operations:task-planning",
"catalogSkillKey": "paperclipai/bundled/paperclip-operations/task-planning"
}
],
"envInputs": [],
"sourceRefs": [],
"files": [
{
"path": "TEAM.md",
"kind": "team",
"sizeBytes": 2014,
"sha256": "e0c38e9af1a5dd1888fb81a72feba75a9ab1be4c78d8ceb658e2e5cd621c5096"
},
{
"path": "agents/ceo/AGENTS.md",
"kind": "agent",
"sizeBytes": 263,
"sha256": "75848c6f794646a93e23bc73b80d31ef0eb8b83c105423eb98ea29e7685d2fd0"
},
{
"path": "agents/cto/AGENTS.md",
"kind": "agent",
"sizeBytes": 279,
"sha256": "d33bfdecdf2edcedde25599c72c383445365c595430109469a3919bf9cb12a3d"
},
{
"path": "agents/qa/AGENTS.md",
"kind": "agent",
"sizeBytes": 215,
"sha256": "8b7fbdd93c0ecebddc1c87fb87d201340bd5f90297015da6cacd1681e7be70b8"
},
{
"path": "projects/first-project/PROJECT.md",
"kind": "project",
"sizeBytes": 364,
"sha256": "1f457ae956da52ff83adc1cf63a3fb84337a4afb25bd43f0d123902d75e871cc"
},
{
"path": "projects/first-project/tasks/first-heartbeat/TASK.md",
"kind": "task",
"sizeBytes": 292,
"sha256": "bdc979cafa43fc9b8f0d6f0e4120c01cecfb899082781a5da88e26fa262f18e4"
}
],
"trustLevel": "markdown_only",
"compatibility": "compatible",
"contentHash": "sha256:9d0416ebc0a81585dc51b73efb25decba9e1e3f3741940fc9fca74f3238f344d"
},
{
"id": "paperclipai:bundled:product:product-design",
"key": "paperclipai/bundled/product/product-design",
"kind": "bundled",
"category": "product",
"slug": "product-design",
"name": "Product Design",
"description": "Bundled product design team with a Principal Product Designer who owns wireframes, design critiques, and UX quality reviews for a product company.",
"path": "catalog/bundled/product/product-design",
"entrypoint": "TEAM.md",
"schema": "agentcompanies/v1",
"defaultInstall": false,
"recommendedForCompanyTypes": [
"software",
"product",
"design"
],
"tags": [
"design",
"ux",
"product"
],
"counts": {
"agents": 1,
"projects": 1,
"tasks": 0,
"routines": 1,
"localSkills": 0,
"catalogSkills": 3,
"externalSkillSources": 0
},
"rootAgentSlugs": [
"ux-designer"
],
"agentSlugs": [
"ux-designer"
],
"projectSlugs": [
"product-design"
],
"requiredSkills": [
{
"type": "catalog",
"ref": "design-critique",
"agentSlugs": [
"ux-designer"
],
"resolved": true,
"catalogSkillId": "paperclipai:optional:product:design-critique",
"catalogSkillKey": "paperclipai/optional/product/design-critique"
},
{
"type": "catalog",
"ref": "task-planning",
"agentSlugs": [
"ux-designer"
],
"resolved": true,
"catalogSkillId": "paperclipai:bundled:paperclip-operations:task-planning",
"catalogSkillKey": "paperclipai/bundled/paperclip-operations/task-planning"
},
{
"type": "catalog",
"ref": "wireframe",
"agentSlugs": [
"ux-designer"
],
"resolved": true,
"catalogSkillId": "paperclipai:bundled:product:wireframe",
"catalogSkillKey": "paperclipai/bundled/product/wireframe"
}
],
"envInputs": [],
"sourceRefs": [],
"files": [
{
"path": "TEAM.md",
"kind": "team",
"sizeBytes": 2024,
"sha256": "358e1039e2ced32e8b40ecdb91e8be922451eac1283a81546030fdae1f0ac22c"
},
{
"path": "agents/ux-designer/AGENTS.md",
"kind": "agent",
"sizeBytes": 306,
"sha256": "301f2c7ed92bdd98036c06530588c77d74c3a3c6a8b9c724a3d35fee1142af6f"
},
{
"path": "projects/product-design/PROJECT.md",
"kind": "project",
"sizeBytes": 353,
"sha256": "4afe346bc5d5958216542d60a06be12983e1e018960cf2709c85c7d578f28420"
},
{
"path": "projects/product-design/tasks/weekly-design-review/TASK.md",
"kind": "task",
"sizeBytes": 313,
"sha256": "d255115eccc5c8b9f576c34fc2fb46a1cbb86ab36a56b980bdab35a952482d8a"
}
],
"trustLevel": "markdown_only",
"compatibility": "compatible",
"contentHash": "sha256:ce0c76ace4fe19fca6a1b3b59e63ea6717366e90d1c437f3a7215d5c1da1bcf1"
},
{
"id": "paperclipai:bundled:software-development:product-engineering",
"key": "paperclipai/bundled/software-development/product-engineering",
"kind": "bundled",
"category": "software-development",
"slug": "product-engineering",
"name": "Product Engineering",
"description": "Bundled engineering team that pairs a CTO with a senior coder and a QA engineer to deliver, review, and verify product changes.",
"path": "catalog/bundled/software-development/product-engineering",
"entrypoint": "TEAM.md",
"schema": "agentcompanies/v1",
"defaultInstall": false,
"recommendedForCompanyTypes": [
"software",
"startup",
"product"
],
"tags": [
"engineering",
"delivery",
"qa",
"code-review"
],
"counts": {
"agents": 3,
"projects": 1,
"tasks": 0,
"routines": 1,
"localSkills": 0,
"catalogSkills": 4,
"externalSkillSources": 0
},
"rootAgentSlugs": [
"cto"
],
"agentSlugs": [
"cto",
"qa",
"senior-coder"
],
"projectSlugs": [
"product-engineering"
],
"requiredSkills": [
{
"type": "catalog",
"ref": "doc-maintenance",
"agentSlugs": [
"cto",
"senior-coder"
],
"resolved": true,
"catalogSkillId": "paperclipai:bundled:docs:doc-maintenance",
"catalogSkillKey": "paperclipai/bundled/docs/doc-maintenance"
},
{
"type": "catalog",
"ref": "github-pr-workflow",
"agentSlugs": [
"cto",
"senior-coder"
],
"resolved": true,
"catalogSkillId": "paperclipai:bundled:software-development:github-pr-workflow",
"catalogSkillKey": "paperclipai/bundled/software-development/github-pr-workflow"
},
{
"type": "catalog",
"ref": "qa-acceptance",
"agentSlugs": [
"qa"
],
"resolved": true,
"catalogSkillId": "paperclipai:bundled:quality:qa-acceptance",
"catalogSkillKey": "paperclipai/bundled/quality/qa-acceptance"
},
{
"type": "catalog",
"ref": "task-planning",
"agentSlugs": [
"cto"
],
"resolved": true,
"catalogSkillId": "paperclipai:bundled:paperclip-operations:task-planning",
"catalogSkillKey": "paperclipai/bundled/paperclip-operations/task-planning"
}
],
"envInputs": [],
"sourceRefs": [],
"files": [
{
"path": "TEAM.md",
"kind": "team",
"sizeBytes": 2570,
"sha256": "36da9b22db9087340a5cf30c5bdf5072ea68bf14fd4d2a2ddd0486b4725f78fe"
},
{
"path": ".paperclip.yaml",
"kind": "extension",
"sizeBytes": 81,
"sha256": "54babf05ba130ec54a143abf01581d99c0ac2936fd0d929bf0e0edd00e29d861"
},
{
"path": "agents/cto/AGENTS.md",
"kind": "agent",
"sizeBytes": 331,
"sha256": "28849cb94cb506c4437fa4f9fa19dccb3e29b16175a9b99204a006dac721da48"
},
{
"path": "agents/qa/AGENTS.md",
"kind": "agent",
"sizeBytes": 247,
"sha256": "577f585f6db5271cb7335861debe91fc3201fba9e1565e32611e957ddfab8e05"
},
{
"path": "agents/senior-coder/AGENTS.md",
"kind": "agent",
"sizeBytes": 292,
"sha256": "e03e0eef79adc04b4ee558ac920bf2ef0581e9494510b7a12d5f1aea70858f18"
},
{
"path": "projects/product-engineering/PROJECT.md",
"kind": "project",
"sizeBytes": 353,
"sha256": "2570ca611c78da876759458167706981777fa7b4e4efd8d0db57c7412976f376"
},
{
"path": "projects/product-engineering/tasks/weekly-engineering-sync/TASK.md",
"kind": "task",
"sizeBytes": 322,
"sha256": "6acf3ed2da3dfa48de163810b4bc9d385dad537fd34037ca881eec713986a2a8"
}
],
"trustLevel": "assets",
"compatibility": "compatible",
"contentHash": "sha256:78aeac52e7052b74dd8a3770a0f3c8f3c19bf6e5201cf87e56428ad51d59af66"
},
{
"id": "paperclipai:optional:communications:speko-company-phone-agent",
"key": "paperclipai/optional/communications/speko-company-phone-agent",
"kind": "optional",
"category": "communications",
"slug": "speko-company-phone-agent",
"name": "Speko Company Phone Agent",
"description": "Optional company voice receptionist for greeting, intake, clarification, delegation, and concise task follow-up through Speko.",
"path": "catalog/optional/communications/speko-company-phone-agent",
"entrypoint": "TEAM.md",
"schema": "agentcompanies/v1",
"defaultInstall": false,
"recommendedForCompanyTypes": [
"agency",
"services",
"software"
],
"tags": [
"speko",
"voice",
"phone",
"intake"
],
"counts": {
"agents": 1,
"projects": 0,
"tasks": 0,
"routines": 0,
"localSkills": 0,
"catalogSkills": 0,
"externalSkillSources": 0
},
"rootAgentSlugs": [
"speko-company-phone-agent"
],
"agentSlugs": [
"speko-company-phone-agent"
],
"projectSlugs": [],
"requiredSkills": [],
"envInputs": [],
"sourceRefs": [],
"files": [
{
"path": "TEAM.md",
"kind": "team",
"sizeBytes": 1097,
"sha256": "04c89ffaf7d8d778b1e18bae7cbea3c5740c359a61c42a139759eaad443b7f76"
},
{
"path": "agents/speko-company-phone-agent/AGENTS.md",
"kind": "agent",
"sizeBytes": 3202,
"sha256": "76953ef1ab541a219d9835bd0a3461845e92a1861e90675a167734854f2647f2"
},
{
"path": "LICENSE",
"kind": "other",
"sizeBytes": 1069,
"sha256": "7f8a27f0979bded50e240caa8c8c29f3088ddf87032cb83e5a9732bff91d18b4"
},
{
"path": "README.md",
"kind": "readme",
"sizeBytes": 1417,
"sha256": "445c4b7ec5a201b73123aba1ce5dbb5a52352ed488364eed62a041c30656c7d7"
}
],
"trustLevel": "assets",
"compatibility": "compatible",
"contentHash": "sha256:4a38efe38a407db87a6872880aa9c575f39b34dbb8c0c65dbac0d28aec69116c"
},
{
"id": "paperclipai:optional:content:content-machine",
"key": "paperclipai/optional/content/content-machine",
"kind": "optional",
"category": "content",
"slug": "content-machine",
"name": "Content Machine",
"description": "Optional content operations team with a lead agent, a recurring review task, and a vendored local content planning skill.",
"path": "catalog/optional/content/content-machine",
"entrypoint": "TEAM.md",
"schema": "agentcompanies/v1",
"defaultInstall": false,
"recommendedForCompanyTypes": [
"agency",
"marketing"
],
"tags": [
"content",
"marketing",
"routines"
],
"counts": {
"agents": 1,
"projects": 1,
"tasks": 0,
"routines": 1,
"localSkills": 1,
"catalogSkills": 0,
"externalSkillSources": 0
},
"rootAgentSlugs": [
"content-lead"
],
"agentSlugs": [
"content-lead"
],
"projectSlugs": [
"content-operations"
],
"requiredSkills": [
{
"type": "local",
"ref": "content-calendar",
"agentSlugs": [
"content-lead"
],
"resolved": true,
"localPath": "skills/content-calendar/SKILL.md"
}
],
"envInputs": [],
"sourceRefs": [],
"files": [
{
"path": "TEAM.md",
"kind": "team",
"sizeBytes": 1032,
"sha256": "f7c272c8b0c183fc840d49eb4851b7cdd1a30a5aa8d6415d215110f3238f6f13"
},
{
"path": "agents/content-lead/AGENTS.md",
"kind": "agent",
"sizeBytes": 251,
"sha256": "6fc2071ff463b6981780d5b40b2c0784cb119900062f8dc40ed372e7b8415bf7"
},
{
"path": "projects/content-operations/PROJECT.md",
"kind": "project",
"sizeBytes": 338,
"sha256": "1471f61cb0b3ffbb9c639a99d2d370f08217a0c63f97b3e24dbbd47861110206"
},
{
"path": "projects/content-operations/tasks/weekly-content-review/TASK.md",
"kind": "task",
"sizeBytes": 236,
"sha256": "3777de716334f2c3f24176f0fe121584ce9c53a7f59e1fca942a2f57995cef77"
},
{
"path": "skills/content-calendar/SKILL.md",
"kind": "skill",
"sizeBytes": 340,
"sha256": "aa62a332fc3149d6c0d58ca589c6b3910a373d542f16f749ec68ef2f3d7f29e9"
}
],
"trustLevel": "markdown_only",
"compatibility": "compatible",
"contentHash": "sha256:06822cec5f2b6910cb37ba0ebd5e04ed5c7e34f77225564ddddc2470779cdaa6"
}
]
}