project_create write
Create a project, the top of the tree. The key is what every issue in it will be named after (ENG becomes ENG-1, ENG-2), and it cannot be changed afterwards. Only an admin may create one. Set agent_done at creation: review, the default, refuses a token change setting done or canceled with agent_done_not_allowed (set in_review instead); allowed lets a token set either; proof requires a proof object on the finishing change. done_criteria is the markdown describing what finishing work means for this project, and the refusal quotes it, so write it before agents start.
Arguments
| Name | Type | Description |
|---|---|---|
agent_done | string | the project's agent completion policy. review: a token cannot set done or canceled. allowed: a token may set either. proof: a token must attach a proof object to finish work One of review, allowed, proof. |
done_criteria | string | markdown describing what finishing work means for this project; quoted back to an agent refused under the review policy |
key required | string | a short uppercase key like ENG: one letter then 1 to 5 letters or digits. Immutable once set, because it appears in every issue key |
lead_id | null | string | ULID of the user who leads the project; read roadmap://users |
name required | string | the project's display name |
target_date | string | when the project is due, as a calendar date YYYY-MM-DD such as 2026-09-01. No time and no timezone. Optional, and in no enforced order with its milestones' dates |
Input schema
Exactly what tools/list serves.
input schema
{
"additionalproperties": false,
"properties": {
"agent_done": {
"description": "the project's agent completion policy. review: a token cannot set done or canceled. allowed: a token may set either. proof: a token must attach a proof object to finish work",
"enum": [
"review",
"allowed",
"proof"
],
"type": "string"
},
"done_criteria": {
"description": "markdown describing what finishing work means for this project; quoted back to an agent refused under the review policy",
"type": "string"
},
"key": {
"description": "a short uppercase key like ENG: one letter then 1 to 5 letters or digits. Immutable once set, because it appears in every issue key",
"type": "string"
},
"lead_id": {
"description": "ULID of the user who leads the project; read roadmap://users",
"type": [
"null",
"string"
]
},
"name": {
"description": "the project's display name",
"type": "string"
},
"target_date": {
"description": "when the project is due, as a calendar date YYYY-MM-DD such as 2026-09-01. No time and no timezone. Optional, and in no enforced order with its milestones' dates",
"type": "string"
}
},
"required": [
"key",
"name"
],
"type": "object"
}