# Projects

URL: /code/systems/projects · Id: `system:projects`

> Projects tracks each body of work toward a Goal: its Tasks and Issues, start and target date, triage and assignees.

[Projects](/business/nouns/project) tracks each body of work toward a [Goal](/business/nouns/goal): its [Tasks](/business/nouns/task) and [Issues](/business/nouns/issue), dates, triage and assignees, whether [Humans](/business/nouns/human) or [Agents](/business/nouns/agent). Issues live in [db.sb](/code/platform/db-sb); a GitHub repository can mirror them.

## Summary
| Part | This System |
| --- | --- |
| Group | Moves to Code |
| Status | Beta: it works, and its Verbs may still change |
| Shelf | Front: offered from a Startup’s first days |

You can ask:

- “What is the team working on this week?”
- “File this bug”
- “Plan the next two weeks of work”

## What you get
| Part | This System |
| --- | --- |
| Starts | On for every Startup at creation, with nothing to install. |
| Built from | [Database](/code/platform/capabilities/database), [Workflows](/code/platform/workflows), [Event streams](/code/platform/event-streams) |

## Nouns it owns
| Noun | Definition |
| --- | --- |
| [Project](/business/nouns/project) | A Project is a body of work toward a Goal: its Tasks and Issues, a start, and a target date. |
| [Issue](/business/nouns/issue) | An Issue is a Task reporting a problem or request, such as a bug or a feature request, with a reporter and a triage step. |
| [Comment](/business/nouns/comment) | A Comment is an internal note by a Worker about a Thing, never sent to a Contact. |

## Verbs
| Verb | Object | Approval | Event |
| --- | --- | --- | --- |
| [Project.create](/business/nouns/project/create) | [Project](/business/nouns/project) | None | `Project.created` |
| [Issue.triage](/business/nouns/issue/triage) | [Issue](/business/nouns/issue) | None | [`Issue.triaged`](/business/events/Issue.triaged) |
| [Issue.resolve](/business/nouns/issue/resolve) | [Issue](/business/nouns/issue) | None | [`Issue.resolved`](/business/events/Issue.resolved) |
| [Issue.reopen](/business/nouns/issue/reopen) | [Issue](/business/nouns/issue) | None | [`Issue.reopened`](/business/events/Issue.reopened) |
| [Comment.create](/business/nouns/comment/create) | [Comment](/business/nouns/comment) | None | `Comment.created` |
| [Issue.schedule](/business/nouns/issue/schedule) | [Issue](/business/nouns/issue) | None | [`Issue.scheduled`](/business/events/Issue.scheduled) |
| [Issue.estimate](/business/nouns/issue/estimate) | [Issue](/business/nouns/issue) | None | [`Issue.estimated`](/business/events/Issue.estimated) |

## Events
| Direction | Event | How |
| --- | --- | --- |
| Emits | `Project.created` | By [Project.create](/business/nouns/project/create) |
| Emits | [`Issue.triaged`](/business/events/Issue.triaged) | By [Issue.triage](/business/nouns/issue/triage) |
| Emits | [`Issue.resolved`](/business/events/Issue.resolved) | By [Issue.resolve](/business/nouns/issue/resolve) |
| Emits | [`Issue.reopened`](/business/events/Issue.reopened) | By [Issue.reopen](/business/nouns/issue/reopen) |
| Emits | `Comment.created` | By [Comment.create](/business/nouns/comment/create) |
| Emits | [`Issue.scheduled`](/business/events/Issue.scheduled) | By [Issue.schedule](/business/nouns/issue/schedule) |
| Emits | [`Issue.estimated`](/business/events/Issue.estimated) | By [Issue.estimate](/business/nouns/issue/estimate) |

## States
None.

## Who operates it
| Part | This System |
| --- | --- |
| Accountable | [Product Lead](/agents/product/product-lead) |
| Team | [Product Team](/agents/product) |
| Seat | A role agent holds it until a Human is seated. |
| Autonomy | `supervised` |
| Also calls its Verbs | [Reliability Engineer](/agents/engineering/reliability-engineer) |

## Approvals and limits
None.

## Processes that use it
| Process | How it uses it |
| --- | --- |
| [Iteration](/workflows/processes/iteration) | A Workflow writes [Issue](/business/nouns/issue) |
| [Shipping](/workflows/processes/shipping) | A step calls [Issue.triage](/business/nouns/issue/triage) |
| [Onboarding](/workflows/processes/onboarding) | A Workflow writes [Issue](/business/nouns/issue) |
| [Retention](/workflows/processes/retention) | A Workflow writes [Issue](/business/nouns/issue) |
| [Support](/workflows/processes/support) | A Workflow writes [Issue](/business/nouns/issue) |
| [Compliance](/workflows/processes/compliance) | A Workflow writes [Issue](/business/nouns/issue) |
| [Verification](/code/verification) | A Workflow writes [Issue](/business/nouns/issue) |
| [Hiring](/workflows/processes/hiring) | A Workflow writes [Project](/business/nouns/project) |
| [Vulnerability disclosure](/workflows/processes/vulnerability-disclosure) | A Workflow writes [Issue](/business/nouns/issue) |
| [Barrier reports](/workflows/processes/barrier-reports) | A Workflow writes [Issue](/business/nouns/issue) |
| [Continuity](/workflows/processes/continuity) | A Workflow writes [Issue](/business/nouns/issue) |

## Rail underneath
None.

## Views and dashboards
| View | Shows | Metrics |
| --- | --- | --- |
| The [Product Lead](/agents/product/product-lead)’s view | The Metrics its accountable Role answers for. | [Activation rate](/agents/product#activation-rate), [Must-have share](/agents/product#must-have-share), [Active calling keys](/agents/product#active-calling-keys), [Declared Verb attempts](/agents/product#declared-verb-attempts), [Time to first call](/agents/product#time-to-first-call) |

## Access
What each Access level may call here.

| Access level | May call |
| --- | --- |
| `owner` | Every Verb (20) |
| `admin` | Every Verb (20) |
| `member` | Every Verb (20) |
| `viewer` | Read only (6 of 20) |

## Import and export
| Connector | Mode |
| --- | --- |
| GitHub | Mirror: the db.sb record leads and the tool reflects it. |
| GitHub | Import: edits made in the tool arrive as Changes. |

## Fees and pricing
None.

## Availability and limits
| Part | This System |
| --- | --- |
| Status | Beta: it works, and its Verbs may still change |

## Compliance notes
Controls it carries:

- [Log completeness](/systems/trust-and-governance/controls/log-completeness)
- [Deviation closure](/systems/trust-and-governance/controls/deviation-closure)
- [Append-only records](/systems/trust-and-governance/controls/append-only-records)
- [Point-in-time recovery](/systems/trust-and-governance/controls/point-in-time-recovery)
- [Processing definitions](/systems/trust-and-governance/controls/processing-definitions)
- [Action completion](/systems/trust-and-governance/controls/action-completion)

## Related Systems
None.

## Example
A [Services-as-Software](/products/templates/services-as-software) security-readiness package runs each client as a Project with 64 Tasks and a target date. The [Product Lead](/agents/product/product-lead) Agent triages new Issues every morning and delegates evidence collection to Agents. Each client sees progress against the date, never a spreadsheet.