# docs-spec

Create the next numbered specification record for a project


## When to use it

Create the next numbered specification record for a project. Use this when you want to add the corresponding files or task to your workspace.

## Usage

```sh
npm exec -- nx generate @megamono/plugin:docs-spec --project="<project>" --dry-run
```

Replace angle-bracket placeholders with reviewed values. Nx's `--dry-run` previews generator writes; remove it only after reviewing the plan. Examples use npm; use your workspace's package manager if it differs.

## Options

Use these options with `@megamono/plugin:docs-spec`. Nx uses the camelCase names shown here; the [CLI reference](/docs/cli) describes command-line aliases. Some options are required only for particular choices.

| Option | Required | Type | Default | Description |
| --- | --- | --- | --- | --- |
| `project` | Yes | string | — | Which project does this spec describe? |
| `projects` | No | array | — | Nx projects governed by this specification; defaults to project. |
| `title` | No | string | — | Spec title; defaults to '<project> specification'. |
| `topics` | No | array | ["architecture"] | — |
| `references` | No | array | [] | — |
| `externalReferences` | No | array | [] | — |
| `allowedDependencies` | No | array | — | Expected directed project-graph edges. |
| `forbiddenDependencies` | No | array | — | Directed project-graph edges that must remain absent. |
| `date` | No | string | — | — |

## Next steps

Review changed files and run the affected project's checks. For options that accept structured values, run the generator's `--help` or consult the schema in the installed package.

- [All generators](/docs/generators)
- [CLI overview](/docs/cli)
- [Adopt an existing workspace](/docs/workflows/adoption)