# Team file

URL: /code/project-structure/team-definition · Id: `convention:team-definition`

> A Team file names a Team’s lead Role and states its purpose; a default Team left unchanged has no file.

A [Team](/business/nouns/team) file names a Team’s lead [Role](/business/nouns/role) and states its purpose; a default Team left unchanged has no file.

| Property | Value |
| --- | --- |
| Path | `agents/[team]/index.mdx` |
| Holds | [Team](/business/nouns/team) |
| Kind | file |
| Leaders | db-first, git-first |
| Team | [People Team](/agents/people) |
| Written by | None. |
| Compiled by | [StartupBuilder](/code/builders/startup) |

### Example
`agents/finance/index.mdx` in a Startup repository.

```mdx title="agents/finance/index.mdx"
---
lead: finance/controller
---
Finance keeps every client's books closed, reconciled and tied out.
```

### Props
The frontmatter keys the file takes. The body is its prose.

| Prop | Type | Required | Description |
| --- | --- | --- | --- |
| `lead` | [Role](/business/nouns/role) | Yes | The Role that leads the Team. |

### Generates
[StartupBuilder](/code/builders/startup) compiles it into these records, Verbs and routes.

| Kind | What |
| --- | --- |
| Records | [Team](/business/nouns/team) |
| Verbs | None. |
| Routes | None. |