---
since: 0.6.0
---

# Projects and Issues

## Project

A project is the primary workspace boundary.

It normally defines:

```text
name
key/identifier
description
members
permissions
issue configuration
```

## Issue

An issue represents a unit of work.

Typical attributes:

```text
title
description
status
priority
reporter
assignee
labels
timestamps
```

## Comments

Comments provide issue-level collaboration and context.

## Lifecycle

```text
Created
   │
   ▼
Open
   │
   ▼
In Progress
   │
   ▼
Resolved
   │
   ▼
Closed
```

The actual states and transition rules must follow the project's implemented
configuration.