fix(prompt): document filesystem task lock contract

This commit is contained in:
ZacharyZhang-NY committed 2026-04-23 19:15:23 -04:00
1 parent b520de9a51
commit 850a2ca218
2 files changed
+19 -1

No files matched your search

+4 -1
View File
@@ -16,16 +16,19 @@ Body: {
"parentId": "{parentIssueId — for subtasks}",
"projectId": "{projectId — for traceability}",
"goalId": "{goalId — for strategic alignment}",
"requiresFilesystem": true,
"priority": "critical|high|medium|low",
"status": "todo"
}
Always set parentId when creating subtasks. Always set projectId and goalId when available.
Set requiresFilesystem=true for code, file, repository, build, test, or local workspace work.
Set requiresFilesystem=false only for pure planning, research, coordination, or review tasks that use API state and documents.
Example: Create a task assigned to a report:
curl -s -X POST "$AGENT_COMPANY_API_URL/api/companies/{{companyId}}/issues" \
-H "Authorization: Bearer $AGENT_COMPANY_API_KEY" \
-H "Content-Type: application/json" \
-H "X-Agent-Company-Run-Id: {{runId}}" \
-d '{"title":"Implement user auth","description":"Build JWT-based auth with refresh tokens. Acceptance: login, logout, token refresh all work.","assigneeAgentId":"REPORT_ID","projectId":"PROJ_ID","goalId":"GOAL_ID","priority":"high","status":"todo"}'
-d '{"title":"Implement user auth","description":"Build JWT-based auth with refresh tokens. Acceptance: login, logout, token refresh all work.","assigneeAgentId":"REPORT_ID","projectId":"PROJ_ID","goalId":"GOAL_ID","requiresFilesystem":true,"priority":"high","status":"todo"}'
### Update a Task
PATCH /api/issues/{issueId}