# Shared Verb definition

URL: /code/project-structure/shared-verb · Id: `convention:shared-verb`

> A shared Verb definition declares a Verb that acts on more than one Noun, such as close, once for all of them.

A shared [Verb](/business/nouns/verb) definition declares a Verb that acts on more than one [Noun](/business/nouns/noun), such as close, once for all of them.

| Property | Value |
| --- | --- |
| Path | `verbs/[verb].mdx` |
| Holds | [Verb](/business/nouns/verb) |
| Kind | file |
| Leaders | db-first, git-first |
| Team | [Engineering Team](/agents/engineering) |
| Written by | [Change.merge](/business/nouns/change/merge) |
| Compiled by | [SoftwareBuilder](/code/builders/software) |

### Example
`verbs/close.mdx` in a Startup repository. Closewise, a sample business, declares a `Close` Noun.

```mdx title="verbs/close.mdx"
---
nouns: [Close, Period]
inverse: reopen
input:
  reviewer: Role
---
Closing locks a month: no entry posts to it until it is reopened, with a reason.
```

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

| Prop | Type | Required | Description |
| --- | --- | --- | --- |
| `nouns` | list of [Noun](/business/nouns/noun) | Yes | The Nouns that take the Verb. |
| `inverse` | `string` | No | The Verb that undoes it. |
| `input` | `json` | No | The input every Noun’s form shares, keyed by name with its type. |
| `forms` | `json` | No | Irregular forms only, such as `doneBy`. |

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

| Kind | What |
| --- | --- |
| Records | [Verb](/business/nouns/verb), [Event](/business/nouns/event) |
| Verbs | None. |
| Routes | None. |