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

# Spec flags

> All granular flags for spec content, gates, evidence, decisions, and card derivation.

# Spec flags

You can use this page to inspect the exact source-defined flags for this part of Pulse. The tables show whether each common preset grants the flag by default.

<Note>
  Validator is the intended holder of spec validation submit and approved-to-validated movement.
</Note>

## `spec` namespace

### entity

| Flag                              | Spec | Executor | QA  | Validator | Full Control |
| --------------------------------- | ---- | -------- | --- | --------- | ------------ |
| `spec.entity.read`                | yes  | yes      | yes | yes       | yes          |
| `spec.entity.create`              | yes  | -        | -   | -         | yes          |
| `spec.entity.edit_fields`         | yes  | -        | -   | -         | yes          |
| `spec.entity.edit_coverage_flags` | yes  | -        | -   | -         | yes          |
| `spec.entity.assign`              | yes  | -        | -   | -         | yes          |
| `spec.entity.label`               | yes  | -        | -   | -         | yes          |
| `spec.entity.link_card`           | yes  | -        | -   | -         | yes          |
| `spec.entity.archive`             | yes  | -        | -   | -         | yes          |
| `spec.entity.restore`             | yes  | -        | -   | -         | yes          |
| `spec.entity.delete`              | yes  | -        | -   | -         | yes          |

### move

| Flag                                 | Spec | Executor | QA | Validator | Full Control |
| ------------------------------------ | ---- | -------- | -- | --------- | ------------ |
| `spec.move.draft_to_review`          | yes  | -        | -  | -         | yes          |
| `spec.move.review_to_approved`       | yes  | -        | -  | -         | yes          |
| `spec.move.approved_to_validated`    | -    | -        | -  | yes       | yes          |
| `spec.move.validated_to_in_progress` | -    | -        | -  | yes       | yes          |
| `spec.move.in_progress_to_done`      | -    | -        | -  | yes       | yes          |
| `spec.move.any_to_cancelled`         | yes  | -        | -  | -         | yes          |
| `spec.move.approved_to_draft`        | -    | -        | -  | yes       | yes          |
| `spec.move.validated_to_draft`       | -    | -        | -  | yes       | yes          |

### interact\_in

| Flag                           | Spec | Executor | QA  | Validator | Full Control |
| ------------------------------ | ---- | -------- | --- | --------- | ------------ |
| `spec.interact_in.draft`       | yes  | -        | -   | -         | yes          |
| `spec.interact_in.review`      | yes  | -        | -   | -         | yes          |
| `spec.interact_in.approved`    | yes  | -        | yes | yes       | yes          |
| `spec.interact_in.validated`   | yes  | yes      | yes | yes       | yes          |
| `spec.interact_in.in_progress` | yes  | yes      | yes | yes       | yes          |
| `spec.interact_in.done`        | -    | yes      | -   | -         | yes          |
| `spec.interact_in.cancelled`   | -    | -        | -   | -         | yes          |

### qa

| Flag                 | Spec | Executor | QA  | Validator | Full Control |
| -------------------- | ---- | -------- | --- | --------- | ------------ |
| `spec.qa.read`       | yes  | yes      | yes | yes       | yes          |
| `spec.qa.ask`        | yes  | yes      | yes | yes       | yes          |
| `spec.qa.ask_choice` | yes  | -        | yes | -         | yes          |
| `spec.qa.answer`     | yes  | -        | yes | yes       | yes          |

### tests

| Flag                       | Spec | Executor | QA  | Validator | Full Control |
| -------------------------- | ---- | -------- | --- | --------- | ------------ |
| `spec.tests.read`          | yes  | yes      | yes | yes       | yes          |
| `spec.tests.create`        | yes  | -        | yes | -         | yes          |
| `spec.tests.update_status` | yes  | -        | yes | -         | yes          |

### rules

| Flag                | Spec | Executor | QA  | Validator | Full Control |
| ------------------- | ---- | -------- | --- | --------- | ------------ |
| `spec.rules.read`   | yes  | yes      | yes | yes       | yes          |
| `spec.rules.create` | yes  | -        | -   | -         | yes          |
| `spec.rules.edit`   | yes  | -        | -   | -         | yes          |
| `spec.rules.delete` | yes  | -        | -   | -         | yes          |

### contracts

| Flag                    | Spec | Executor | QA  | Validator | Full Control |
| ----------------------- | ---- | -------- | --- | --------- | ------------ |
| `spec.contracts.read`   | yes  | yes      | yes | yes       | yes          |
| `spec.contracts.create` | yes  | -        | -   | -         | yes          |
| `spec.contracts.edit`   | yes  | -        | -   | -         | yes          |
| `spec.contracts.delete` | yes  | -        | -   | -         | yes          |

### mockups

| Flag                    | Spec | Executor | QA  | Validator | Full Control |
| ----------------------- | ---- | -------- | --- | --------- | ------------ |
| `spec.mockups.read`     | yes  | yes      | yes | yes       | yes          |
| `spec.mockups.create`   | yes  | -        | -   | -         | yes          |
| `spec.mockups.edit`     | yes  | -        | -   | -         | yes          |
| `spec.mockups.delete`   | yes  | -        | -   | -         | yes          |
| `spec.mockups.annotate` | yes  | -        | -   | -         | yes          |

### architecture

| Flag                       | Spec | Executor | QA  | Validator | Full Control |
| -------------------------- | ---- | -------- | --- | --------- | ------------ |
| `spec.architecture.read`   | yes  | yes      | yes | yes       | yes          |
| `spec.architecture.create` | yes  | -        | -   | -         | yes          |
| `spec.architecture.edit`   | yes  | -        | -   | -         | yes          |
| `spec.architecture.delete` | yes  | -        | -   | -         | yes          |
| `spec.architecture.import` | yes  | -        | -   | -         | yes          |
| `spec.architecture.render` | yes  | -        | -   | -         | yes          |

### knowledge

| Flag                    | Spec | Executor | QA  | Validator | Full Control |
| ----------------------- | ---- | -------- | --- | --------- | ------------ |
| `spec.knowledge.read`   | yes  | yes      | yes | yes       | yes          |
| `spec.knowledge.create` | yes  | -        | -   | -         | yes          |
| `spec.knowledge.delete` | yes  | -        | -   | -         | yes          |

### evaluations

| Flag                      | Spec | Executor | QA  | Validator | Full Control |
| ------------------------- | ---- | -------- | --- | --------- | ------------ |
| `spec.evaluations.read`   | yes  | yes      | yes | yes       | yes          |
| `spec.evaluations.submit` | -    | -        | -   | yes       | yes          |
| `spec.evaluations.delete` | -    | -        | -   | -         | yes          |

### validation

| Flag                     | Spec | Executor | QA  | Validator | Full Control |
| ------------------------ | ---- | -------- | --- | --------- | ------------ |
| `spec.validation.submit` | -    | -        | -   | yes       | yes          |
| `spec.validation.read`   | yes  | yes      | yes | yes       | yes          |
| `spec.validation.delete` | -    | -        | -   | -         | yes          |

### (direct)

| Flag                | Spec | Executor | QA  | Validator | Full Control |
| ------------------- | ---- | -------- | --- | --------- | ------------ |
| `spec.cards_derive` | yes  | -        | -   | -         | yes          |
| `spec.history_read` | yes  | yes      | yes | yes       | yes          |

## Preset mapping notes

* Full Control grants every flag.
* Spec owns planning and contract-writing surfaces.
* Executor owns implementation through handoff to validation.
* QA owns test evidence and test cards.
* Validator owns gate submission and validation status routing.

## Related pages

* [Permission model](/permissions/model)
* [Built-in presets](/permissions/presets)
* [Custom permissions](/permissions/custom)