# build.clovernight.creation.spec

> Published by [studio.pds.clovernight.build](https://lexicon.garden/identity/did:plc:eylr5g42jkpwyputz3xbgynj)

✓ This is the authoritative definition for this NSID.

## Links

- [View on Lexicon Garden](https://lexicon.garden/lexicon/did:plc:eylr5g42jkpwyputz3xbgynj/build.clovernight.creation.spec)
- [Documentation](https://lexicon.garden/lexicon/did:plc:eylr5g42jkpwyputz3xbgynj/build.clovernight.creation.spec/docs)
- [Examples](https://lexicon.garden/lexicon/did:plc:eylr5g42jkpwyputz3xbgynj/build.clovernight.creation.spec/examples)

## Definitions

### `build.clovernight.creation.spec`

**Type**: `record`

The specification a creation was built from. Enables build-in-public and reproducibility. NOTE: includes the user's original prompt — public by design, so the provisioning UX must make that explicit.

**Key**: `tid`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `title` | `string` | Yes | Short spec title. |
| `prompt` | `string` | No | The original natural-language request that drove the build. |
| `specDoc` | `blob` | No | Full structured spec document (markdown). |
| `summary` | `string` | No | Human-readable summary of the spec. |
| `createdAt` | `string` (datetime) | Yes | ISO 8601 timestamp the spec was recorded. |
| `pipelineStages` | `array` | No | Foundry pipeline stages that ran. |

## Raw Schema

```json
{
  "id": "build.clovernight.creation.spec",
  "defs": {
    "main": {
      "key": "tid",
      "type": "record",
      "record": {
        "type": "object",
        "required": [
          "title",
          "createdAt"
        ],
        "properties": {
          "title": {
            "type": "string",
            "maxLength": 256,
            "description": "Short spec title."
          },
          "prompt": {
            "type": "string",
            "maxLength": 8192,
            "description": "The original natural-language request that drove the build."
          },
          "specDoc": {
            "type": "blob",
            "accept": [
              "text/markdown"
            ],
            "maxSize": 1048576,
            "description": "Full structured spec document (markdown)."
          },
          "summary": {
            "type": "string",
            "maxLength": 4096,
            "description": "Human-readable summary of the spec."
          },
          "createdAt": {
            "type": "string",
            "format": "datetime",
            "description": "ISO 8601 timestamp the spec was recorded."
          },
          "pipelineStages": {
            "type": "array",
            "items": {
              "type": "string",
              "knownValues": [
                "mine",
                "smelt",
                "forge",
                "architect",
                "temper",
                "ship"
              ]
            },
            "description": "Foundry pipeline stages that ran."
          }
        }
      },
      "description": "The specification a creation was built from. Enables build-in-public and reproducibility. NOTE: includes the user's original prompt — public by design, so the provisioning UX must make that explicit."
    }
  },
  "$type": "com.atproto.lexicon.schema",
  "lexicon": 1
}
```