# OpenTentacle AI Content Labels — Specification v1.0

A standardized, open-source labeling system for content creators to declare AI involvement in their work.

## Why

As AI tools become ubiquitous in content creation, audiences deserve clear, consistent signals about how content was made. This spec provides:

- A simple, human-readable taxonomy
- Machine-readable metadata formats
- A visual badge system for publishers

## Label Format

```
OTL:<level>-<type>
```

Examples: `OTL:H-txt`, `OTL:C-img`, `OTL:G-vid`

---

## Axis 1 — AI Involvement Level

| Code | Name | Description |
|---|---|---|
| `H` | Human | No AI tools used in creation |
| `A` | Assisted | AI used for minor tasks (spell-check, autocomplete, background removal) |
| `C` | Collaborative | Significant AI contribution; human-directed, reviewed, and edited |
| `G` | Generated | AI-generated output; human curated, selected, or lightly edited |
| `X` | Autonomous | Fully AI-generated with minimal human review |

---

## Axis 2 — Content Type

| Code | Type |
|---|---|
| `txt` | Text (articles, blog posts, copy) |
| `img` | Image (photos, illustrations, graphics) |
| `vid` | Video |
| `aud` | Audio (music, voice, podcasts) |
| `code` | Source code |
| `mix` | Mixed / multiple types |

---

## Compound Labels

Multimedia content often has different AI involvement levels per content type. Use the `+` operator to express this in a single label:

```
OTL:H-txt+G-img+C-vid+A-aud
```

This means: human-written text, AI-generated images, collaboratively produced video, AI-assisted audio — all in one label string.

The compound label renders as a single **compound strip** badge showing one row per content type, each with its own marker on the Human→AI spectrum.

### Compound vs space-separated

| Format | When to use |
|---|---|
| `OTL:H-txt+G-img` | A single piece of multimedia content with multiple components |
| `OTL:H-txt OTL:G-img` | Two separate, independently labeled pieces of content on the same page |

### Ordering

List content types in order of prominence or production significance. No canonical order is enforced.

---

## Badge Colors

| Level | Color | Hex |
|---|---|---|
| H — Human | Green | `#2ea44f` |
| A — Assisted | Yellow | `#e3b341` |
| C — Collaborative | Orange | `#d97706` |
| G — Generated | Red | `#cf4a4a` |
| X — Autonomous | Purple | `#7c3aed` |

---

## Versioning

This is spec version `1.0`. Labels may optionally carry a version suffix:

```
OTL:C-txt@1
```

If omitted, the latest version is assumed.

---

## License

This specification and all badge assets are released under [CC0 1.0 Universal](https://creativecommons.org/publicdomain/zero/1.0/) — no attribution required.
