> ## 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.

# Refinement flags

> All granular flags for refinement entities, state moves, Q&A, knowledge, mockups, architecture, and spec derivation.

# Refinement 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>
  Refinement permissions mirror ideation but use the investigation state machine.
</Note>

## `refinement` namespace

### entity

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

### move

| Flag                                    | Spec | Executor | QA | Validator | Full Control |
| --------------------------------------- | ---- | -------- | -- | --------- | ------------ |
| `refinement.move.draft_to_in_progress`  | yes  | -        | -  | -         | yes          |
| `refinement.move.in_progress_to_review` | yes  | -        | -  | -         | yes          |
| `refinement.move.review_to_approved`    | yes  | -        | -  | -         | yes          |
| `refinement.move.approved_to_done`      | yes  | -        | -  | -         | yes          |
| `refinement.move.any_to_cancelled`      | yes  | -        | -  | -         | yes          |

### interact\_in

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

### qa

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

### mockups

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

### architecture

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

### knowledge

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

### (direct)

| Flag                       | Spec | Executor | QA  | Validator | Full Control |
| -------------------------- | ---- | -------- | --- | --------- | ------------ |
| `refinement.specs_derive`  | yes  | -        | -   | -         | yes          |
| `refinement.versions_read` | yes  | -        | yes | yes       | yes          |
| `refinement.history_read`  | 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)