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

# Card and KG flags

> All granular flags for cards, task validation, traceability, comments, attachments, and Knowledge Graph access.

# Card and KG 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>
  Do not give kg.admin.wipe\_board or card.validation.submit to implementation-only agents.
</Note>

## `card` namespace

### entity

| Flag                              | Spec | Executor | QA  | Validator | Full Control |
| --------------------------------- | ---- | -------- | --- | --------- | ------------ |
| `card.entity.read`                | yes  | yes      | yes | yes       | yes          |
| `card.entity.context_read`        | yes  | yes      | yes | yes       | yes          |
| `card.entity.create`              | yes  | yes      | yes | -         | yes          |
| `card.entity.create_test`         | yes  | -        | yes | -         | yes          |
| `card.entity.edit_fields`         | yes  | yes      | yes | -         | yes          |
| `card.entity.edit_bug_fields`     | -    | yes      | -   | -         | yes          |
| `card.entity.assign`              | yes  | yes      | -   | -         | yes          |
| `card.entity.label`               | yes  | yes      | -   | -         | yes          |
| `card.entity.link_spec`           | yes  | -        | -   | -         | yes          |
| `card.entity.link_tests`          | yes  | -        | -   | -         | yes          |
| `card.entity.manage_dependencies` | yes  | -        | -   | -         | yes          |
| `card.entity.delete`              | -    | -        | -   | -         | yes          |

### copy\_from\_spec

| Flag                               | Spec | Executor | QA | Validator | Full Control |
| ---------------------------------- | ---- | -------- | -- | --------- | ------------ |
| `card.copy_from_spec.mockups`      | yes  | -        | -  | -         | yes          |
| `card.copy_from_spec.knowledge`    | yes  | -        | -  | -         | yes          |
| `card.copy_from_spec.qa`           | yes  | -        | -  | -         | yes          |
| `card.copy_from_spec.architecture` | yes  | -        | -  | -         | yes          |

### link\_to

| Flag                    | Spec | Executor | QA  | Validator | Full Control |
| ----------------------- | ---- | -------- | --- | --------- | ------------ |
| `card.link_to.scenario` | yes  | -        | yes | -         | yes          |
| `card.link_to.tr`       | yes  | -        | -   | -         | yes          |
| `card.link_to.rule`     | yes  | -        | -   | -         | yes          |
| `card.link_to.contract` | yes  | -        | -   | -         | yes          |

### move

| Flag                                  | Spec | Executor | QA  | Validator | Full Control |
| ------------------------------------- | ---- | -------- | --- | --------- | ------------ |
| `card.move.not_started_to_started`    | -    | yes      | yes | -         | yes          |
| `card.move.started_to_in_progress`    | -    | yes      | yes | -         | yes          |
| `card.move.in_progress_to_on_hold`    | -    | yes      | yes | -         | yes          |
| `card.move.on_hold_to_in_progress`    | -    | yes      | yes | -         | yes          |
| `card.move.in_progress_to_done`       | -    | -        | yes | -         | yes          |
| `card.move.any_to_cancelled`          | -    | yes      | yes | -         | yes          |
| `card.move.in_progress_to_validation` | -    | yes      | -   | -         | yes          |
| `card.move.validation_to_done`        | -    | -        | -   | yes       | yes          |
| `card.move.validation_to_not_started` | -    | -        | -   | yes       | yes          |
| `card.move.validation_to_on_hold`     | -    | -        | -   | -         | yes          |
| `card.move.validation_to_cancelled`   | -    | -        | -   | -         | yes          |

### interact\_in

| Flag                           | Spec | Executor | QA  | Validator | Full Control |
| ------------------------------ | ---- | -------- | --- | --------- | ------------ |
| `card.interact_in.not_started` | yes  | yes      | yes | -         | yes          |
| `card.interact_in.started`     | -    | yes      | yes | -         | yes          |
| `card.interact_in.in_progress` | -    | yes      | yes | -         | yes          |
| `card.interact_in.on_hold`     | -    | yes      | yes | -         | yes          |
| `card.interact_in.done`        | -    | -        | yes | -         | yes          |
| `card.interact_in.cancelled`   | -    | -        | -   | -         | yes          |
| `card.interact_in.validation`  | -    | yes      | -   | yes       | yes          |

### validation

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

### qa

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

### comments

| Flag                           | Spec | Executor | QA  | Validator | Full Control |
| ------------------------------ | ---- | -------- | --- | --------- | ------------ |
| `card.comments.read`           | yes  | yes      | yes | yes       | yes          |
| `card.comments.create`         | yes  | yes      | yes | yes       | yes          |
| `card.comments.create_choice`  | -    | yes      | -   | -         | yes          |
| `card.comments.respond_choice` | -    | yes      | -   | -         | yes          |
| `card.comments.get_responses`  | -    | yes      | -   | -         | yes          |
| `card.comments.edit`           | -    | -        | -   | -         | yes          |
| `card.comments.delete`         | -    | -        | -   | -         | yes          |

### attachments

| Flag                      | Spec | Executor | QA  | Validator | Full Control |
| ------------------------- | ---- | -------- | --- | --------- | ------------ |
| `card.attachments.read`   | yes  | yes      | yes | yes       | yes          |
| `card.attachments.upload` | -    | yes      | yes | -         | yes          |
| `card.attachments.delete` | -    | yes      | -   | -         | yes          |

### mockups

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

### architecture

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

### tests

| Flag                       | Spec | Executor | QA  | Validator | Full Control |
| -------------------------- | ---- | -------- | --- | --------- | ------------ |
| `card.tests.read`          | yes  | yes      | yes | yes       | yes          |
| `card.tests.link`          | -    | -        | yes | -         | yes          |
| `card.tests.update_status` | -    | -        | yes | -         | yes          |

### conclusion

| Flag                    | Spec | Executor | QA  | Validator | Full Control |
| ----------------------- | ---- | -------- | --- | --------- | ------------ |
| `card.conclusion.read`  | -    | yes      | yes | yes       | yes          |
| `card.conclusion.write` | -    | yes      | yes | -         | yes          |

### (direct)

| Flag                 | Spec | Executor | QA  | Validator | Full Control |
| -------------------- | ---- | -------- | --- | --------- | ------------ |
| `card.activity_read` | yes  | yes      | yes | yes       | yes          |

## `comments` namespace

## `attachments` namespace

## `kg` namespace

### query

| Flag                          | Spec | Executor | QA  | Validator | Full Control |
| ----------------------------- | ---- | -------- | --- | --------- | ------------ |
| `kg.query.decision_history`   | yes  | yes      | yes | yes       | yes          |
| `kg.query.related_context`    | yes  | yes      | yes | yes       | yes          |
| `kg.query.supersedence_chain` | yes  | yes      | yes | yes       | yes          |
| `kg.query.contradictions`     | yes  | yes      | yes | yes       | yes          |
| `kg.query.similar_decisions`  | yes  | yes      | yes | yes       | yes          |
| `kg.query.constraint_explain` | yes  | yes      | yes | yes       | yes          |
| `kg.query.alternatives`       | yes  | yes      | yes | yes       | yes          |
| `kg.query.learning_from_bugs` | yes  | yes      | yes | yes       | yes          |
| `kg.query.global`             | yes  | yes      | yes | yes       | yes          |

### power

| Flag                   | Spec | Executor | QA  | Validator | Full Control |
| ---------------------- | ---- | -------- | --- | --------- | ------------ |
| `kg.power.cypher`      | yes  | -        | -   | yes       | yes          |
| `kg.power.natural`     | yes  | yes      | yes | yes       | yes          |
| `kg.power.schema_info` | yes  | yes      | yes | yes       | yes          |

### session

| Flag                     | Spec | Executor | QA  | Validator | Full Control |
| ------------------------ | ---- | -------- | --- | --------- | ------------ |
| `kg.session.begin`       | yes  | -        | yes | yes       | yes          |
| `kg.session.add_node`    | yes  | -        | yes | yes       | yes          |
| `kg.session.add_edge`    | yes  | -        | yes | yes       | yes          |
| `kg.session.get_similar` | yes  | -        | yes | yes       | yes          |
| `kg.session.propose`     | yes  | -        | yes | yes       | yes          |
| `kg.session.commit`      | yes  | -        | -   | yes       | yes          |
| `kg.session.abort`       | yes  | -        | -   | yes       | yes          |

### admin

| Flag                                | Spec | Executor | QA  | Validator | Full Control |
| ----------------------------------- | ---- | -------- | --- | --------- | ------------ |
| `kg.admin.wipe_board`               | -    | -        | -   | -         | yes          |
| `kg.admin.settings_write`           | yes  | -        | -   | -         | yes          |
| `kg.admin.settings_read`            | yes  | yes      | yes | yes       | yes          |
| `kg.admin.historical_consolidation` | 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)