> ## Documentation Index
> Fetch the complete documentation index at: https://vitruvio.sh/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Projects

> One project, many brains: what they share, how each is named, and where each one publishes.

A brain is the unit of *publication*. If somebody might want one subject without the other four, those are five
brains — each publishable, installable and droppable on its own.

What a project adds is the part they share: one actor, one retention policy, one embedder, one registry account.

```console theme={null}
vitruvio project init coursework --actor you@example.com
vitruvio --assisted-by anthropic/claude-code project add optics --description "optics notes"
vitruvio project add acoustics-ii
vitruvio project add dynamics
vitruvio project show
```

```toml theme={null}
[project]
name = "coursework"

[actor]
id = "you@example.com"

[brains.optics]
path = "./brains/optics"
description = "optics notes"

[[brains.optics.assisted_by]]
id = "anthropic/claude-code"
kind = "agent"

[brains.acoustics-ii]
path = "./brains/acoustics-ii"
```

The actor is the project's and is authoritative: a write naming another one is refused. A brain a different person
keeps may declare its own under `[brains.<name>.actor]`, and that one is authoritative for that brain instead. The
assistants are each brain's own — `optics` records `anthropic/claude-code`, `acoustics-ii` records whatever the
project declares under a top-level `[[assisted_by]]`, or nobody — and `--assisted-by` on a write may only select
among them.

A project answers two questions the rest of this section takes in turn: [which brain a command means](/docs/projects/selecting-a-brain), and [where each brain publishes](/docs/projects/publishing-a-project).

## Names are repository components

`acoustics-ii`, not `Acoustics II`. Lowercase letters, digits and single separators. Checked when the file is read
rather than when the artifact is pushed — a registry rejecting the name after a pack gives an error that says nothing
about which of the two names was wrong.

## Removing

```console theme={null}
vitruvio project remove acoustics-ii
```

Unregisters it and prints where the layout still is. It never deletes: "remove it from this project" and "destroy it"
are different requests, and a brain may be the only copy of what it holds.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.