09d2ef1a37
- Restored docs/ directory that was accidentally deleted by `git add -A` in the v0.2.3 release script - Replaced generic "P" favicon with actual paperclip icon using brand primary color (#2563EB) - Added light/dark logo SVGs for Mintlify navbar (paperclip icon + wordmark) - Updated docs.json with logo configuration for dark/light mode - Fixed release.sh to stage only release-related files instead of `git add -A` to prevent sweeping unrelated changes into release commits Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
122 lines
2.2 KiB
Markdown
122 lines
2.2 KiB
Markdown
---
|
|
title: Goals and Projects
|
|
summary: Goal hierarchy and project management
|
|
---
|
|
|
|
Goals define the "why" and projects define the "what" for organizing work.
|
|
|
|
## Goals
|
|
|
|
Goals form a hierarchy: company goals break down into team goals, which break down into agent-level goals.
|
|
|
|
### List Goals
|
|
|
|
```
|
|
GET /api/companies/{companyId}/goals
|
|
```
|
|
|
|
### Get Goal
|
|
|
|
```
|
|
GET /api/goals/{goalId}
|
|
```
|
|
|
|
### Create Goal
|
|
|
|
```
|
|
POST /api/companies/{companyId}/goals
|
|
{
|
|
"title": "Launch MVP by Q1",
|
|
"description": "Ship minimum viable product",
|
|
"level": "company",
|
|
"status": "active"
|
|
}
|
|
```
|
|
|
|
### Update Goal
|
|
|
|
```
|
|
PATCH /api/goals/{goalId}
|
|
{
|
|
"status": "completed",
|
|
"description": "Updated description"
|
|
}
|
|
```
|
|
|
|
## Projects
|
|
|
|
Projects group related issues toward a deliverable. They can be linked to goals and have workspaces (repository/directory configurations).
|
|
|
|
### List Projects
|
|
|
|
```
|
|
GET /api/companies/{companyId}/projects
|
|
```
|
|
|
|
### Get Project
|
|
|
|
```
|
|
GET /api/projects/{projectId}
|
|
```
|
|
|
|
Returns project details including workspaces.
|
|
|
|
### Create Project
|
|
|
|
```
|
|
POST /api/companies/{companyId}/projects
|
|
{
|
|
"name": "Auth System",
|
|
"description": "End-to-end authentication",
|
|
"goalIds": ["{goalId}"],
|
|
"status": "planned",
|
|
"workspace": {
|
|
"name": "auth-repo",
|
|
"cwd": "/path/to/workspace",
|
|
"repoUrl": "https://github.com/org/repo",
|
|
"repoRef": "main",
|
|
"isPrimary": true
|
|
}
|
|
}
|
|
```
|
|
|
|
Notes:
|
|
|
|
- `workspace` is optional. If present, the project is created and seeded with that workspace.
|
|
- A workspace must include at least one of `cwd` or `repoUrl`.
|
|
- For repo-only projects, omit `cwd` and provide `repoUrl`.
|
|
|
|
### Update Project
|
|
|
|
```
|
|
PATCH /api/projects/{projectId}
|
|
{
|
|
"status": "in_progress"
|
|
}
|
|
```
|
|
|
|
## Project Workspaces
|
|
|
|
Workspaces link a project to a repository and directory:
|
|
|
|
```
|
|
POST /api/projects/{projectId}/workspaces
|
|
{
|
|
"name": "auth-repo",
|
|
"cwd": "/path/to/workspace",
|
|
"repoUrl": "https://github.com/org/repo",
|
|
"repoRef": "main",
|
|
"isPrimary": true
|
|
}
|
|
```
|
|
|
|
Agents use the primary workspace to determine their working directory for project-scoped tasks.
|
|
|
|
### Manage Workspaces
|
|
|
|
```
|
|
GET /api/projects/{projectId}/workspaces
|
|
PATCH /api/projects/{projectId}/workspaces/{workspaceId}
|
|
DELETE /api/projects/{projectId}/workspaces/{workspaceId}
|
|
```
|