Add Task Assignment section to shared POLICIES.md
Provides every agent with the exact API calls for creating assigned issues and reassigning existing ones. Includes curl examples with assigneeAgentId, parentId, and run ID headers. Co-Authored-By: Paperclip <noreply@paperclip.ing>
This commit is contained in:
+26
@@ -38,6 +38,32 @@ A PR is not ready to merge until it has both QA and CTO approval. No agent merge
|
||||
- **GitHub issues are the primary tracker.** All bugs, features, and work items are tracked as GitHub issues in the relevant repo. Paperclip issues are secondary — use them to trigger and coordinate agents (assignments, status handoffs, heartbeat wakes), not as the primary record of work.
|
||||
- **GitHub issues stay open until deployed and validated.** A GitHub issue is not done when a PR is merged. It is done when the change is deployed to production and validated as working. Merging is a step in the process, not the finish line.
|
||||
|
||||
## Task Assignment
|
||||
|
||||
To hand off work to another agent, create a Paperclip issue with `assigneeAgentId` set:
|
||||
|
||||
curl -sf -X POST "$PAPERCLIP_API_URL/api/companies/$PAPERCLIP_COMPANY_ID/issues" \
|
||||
-H "Authorization: Bearer $PAPERCLIP_API_KEY" \
|
||||
-H "Content-Type: application/json" \
|
||||
-H "X-Paperclip-Run-Id: $PAPERCLIP_RUN_ID" \
|
||||
-d '{"title": "...", "description": "...", "status": "todo", "assigneeAgentId": "<target-agent-id>", "parentId": "<parent-issue-id-if-subtask>"}'
|
||||
|
||||
Always include:
|
||||
- A clear title and description so the assignee understands the work without asking questions
|
||||
- `assigneeAgentId` — the target agent's ID (find IDs in each agent's CONFIG.md)
|
||||
- `parentId` if this is a subtask of an existing issue
|
||||
- A comment on the parent issue noting the delegation
|
||||
|
||||
To reassign an existing issue:
|
||||
|
||||
curl -sf -X PATCH "$PAPERCLIP_API_URL/api/issues/{issueId}" \
|
||||
-H "Authorization: Bearer $PAPERCLIP_API_KEY" \
|
||||
-H "Content-Type: application/json" \
|
||||
-H "X-Paperclip-Run-Id: $PAPERCLIP_RUN_ID" \
|
||||
-d '{"assigneeAgentId": "<target-agent-id>", "comment": "Reassigning because..."}'
|
||||
|
||||
**Never leave work unassigned.** If you cannot do it yourself, assign it to the right agent with context.
|
||||
|
||||
## CI/CD Workflow Access
|
||||
|
||||
Only Hugh Hackman has write access to `.github/workflows/` files. All other agents must delegate CI/CD workflow changes to him.
|
||||
|
||||
Reference in New Issue
Block a user