> ## Documentation Index
> Fetch the complete documentation index at: https://docs.encoreos.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Spec Status Taxonomy

> <!-- markdownlint-disable MD060 -->

**Purpose:** Single canonical set of status values for the spec portfolio. All registry entries, scripts, and reports should use these values. Legacy or variant strings are mapped here for consistency.

**Last Updated:** 2026-03-09

***

## Canonical Status Set

| Canonical Label | Registry Display | Meaning                                                                                  |
| --------------- | ---------------- | ---------------------------------------------------------------------------------------- |
| **Done**        | ✅ Complete       | Base implementation and in-scope enhancements complete.                                  |
| **In Progress** | 🚧 In Progress   | Implementation started; not yet complete.                                                |
| **Backlog**     | 📋 Specification | Spec written; implementation not started.                                                |
| **Specified**   | 📋 Specification | Same as Backlog (spec exists).                                                           |
| **In Review**   | 🚧 In Progress   | Work complete; verification/spec-complete pending. Treated as In Progress.               |
| **Archived**    | 🗄️ Archived     | Completed and moved to archive, or superseded/deprecated/consolidated into another spec. |

***

## Mapping: Legacy / Variant → Canonical

Use this table when normalizing existing data or parsing external sources.

| Seen in Registry / Source       | Map to Canonical | Registry Display |
| ------------------------------- | ---------------- | ---------------- |
| `✅ Complete`                    | Done             | ✅ Complete       |
| `Complete`                      | Done             | ✅ Complete       |
| `Implemented`                   | Done             | ✅ Complete       |
| `🚧 In Progress`                | In Progress      | 🚧 In Progress   |
| `In Progress`                   | In Progress      | 🚧 In Progress   |
| `Active Development`            | In Progress      | 🚧 In Progress   |
| `Scaffolded` / `🏗️ Scaffolded` | In Progress      | 🚧 In Progress   |
| `📋 Specification`              | Backlog          | 📋 Specification |
| `Specification`                 | Backlog          | 📋 Specification |
| `📝 Not Started (0%)`           | Backlog          | 📋 Specification |
| `Not Started`                   | Backlog          | 📋 Specification |
| `🔜 Planned`                    | Backlog          | 📋 Specification |
| `Planned`                       | Backlog          | 📋 Specification |
| `📋 Deferred`                   | Backlog          | 📋 Specification |
| *(empty / blank)*               | Backlog          | 📋 Specification |
| `Unknown`                       | Backlog          | 📋 Specification |
| `🗄️ Superseded/Archived`       | Archived         | 🗄️ Archived     |
| `Superseded`                    | Archived         | 🗄️ Archived     |
| `Archived`                      | Archived         | 🗄️ Archived     |

***

## Enhancement / Expansion Status

* **Enhancements:** Shown as `N/M` (e.g. `3/3`) in registry. All complete ⇒ treat spec as having enhancements done.
* **Expansion phases:** Tracked in [DEFERRED\_DASHBOARD.md](../../specs/DEFERRED_DASHBOARD.md). Status per expansion: ✅ Phase Complete, 📋 Specified, 🚧 In Progress.

***

## Usage

* **audit-spec-completion.js** uses this taxonomy in `formatStatus()` so that `--update-registry` writes only canonical values.
* **Weekly governance report** and any new tooling should classify specs into: Done, In Progress, Backlog/Specified, Archived.
* When adding new status variants (e.g. from a new core), add a mapping row above and update the audit script if it parses that source.

***

## See Also

* [SPEC\_STATUS\_REGISTRY.md](../../specs/SPEC_STATUS_REGISTRY.md) — Central registry (uses Registry Display column).
* [DEFERRED\_DASHBOARD.md](../../specs/DEFERRED_DASHBOARD.md) — Deferred and expansion status.
