Projects and goals
Group tasks into projects with their own repositories, defaults, budget and access, and connect work to the goals it serves.
A project groups the tasks that make up one deliverable and carries the settings they share. A goal names an outcome; projects and tasks point at the goals they serve, so anyone can see why a piece of work exists.
Create a project
You need the Manage projects permission (projects:manage).
- Open Projects and select New project.
- Name it and add a short description of the deliverable.
- Optionally link a goal, choose a lead and make it private.
- Select Create. The project opens on its configuration.
Tasks created inside the project belong to it. You can also move an existing task by changing its Project property.
Project settings
Open the project and select Configuration:
- Instructions that every task in the project starts with, for example coding conventions or a style guide.
- Repositories and workspaces: the code the project's agents work on. See Workspaces.
- Environment: where agents run commands for this project.
- Decision owner: who receives decisions from the project's agents when no one else is named.
- Budget: a monthly limit for everything in the project.
Private projects
A private project, and every task in it, is visible only to its members. Use Private project, then Manage access to add or remove members. Making a project private does not publish anything that was private before.
Goals
- Open Goals and select New goal.
- Write the outcome, choose its level and, if it is part of a bigger goal, its parent.
- Link projects and tasks to it from their Goal property.
A goal's page shows the projects and tasks working toward it. Agents read a task's goal to understand why it matters, so a clear goal improves their judgment on trade-offs.
Note
A goal's status is set by people. Veyra does not measure business results on its own; mark a goal achieved when you decide it is.
From the API
curl -X POST "https://intelligence-api.veyra.so/api/companies/$COMPANY_ID/projects" \
-H "Authorization: Bearer $VEYRA_API_KEY" -H "Content-Type: application/json" \
-d '{"name": "Help center refresh", "description": "Rewrite the top 50 help articles."}'