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

# Governance

> Run discovery, preview recommendations, and decide Operator Tasks.

## Agent discovery

Read the latest discovery snapshot:

```bash theme={null}
gforge agents discovery <agent-id> -o yaml
```

Check discovery progress:

```bash theme={null}
gforge agents discovery <agent-id> --status -o yaml
```

Start a fresh discovery while the external Agent is connected:

```bash theme={null}
gforge agents rediscover <agent-id> -o yaml
```

## MCP inventory and recommendations

```bash theme={null}
gforge providers inventory <provider-id>
gforge providers discoveries <provider-id> --limit 10
gforge providers recommendations <provider-id>
```

Preview a recommendation before applying it:

```bash theme={null}
gforge providers apply <provider-id> \
  --recommendation <recommendation-id> \
  --dry-run \
  -o yaml
```

## Operator Tasks

```bash theme={null}
gforge operator tasks list --status pending
gforge operator tasks describe <task-id> -o yaml
```

After checking the Agent, Channel, Gateway, capability, input, and linked Trace, decide the task:

```bash theme={null}
gforge operator tasks approve <task-id> --comment "Input verified"
gforge operator tasks reject <task-id> --comment "Outside approved scope"
```

## Observation review

Use a supported decision such as `escalate` or `resolve`:

```bash theme={null}
gforge observations review <observation-id> \
  --decision escalate \
  --comment "Capability does not match the latest discovery"
```

Run `gforge observations review --help` for the choices accepted by the installed CLI.


## Related topics

- [Governance](/sdk/governance.md)
- [Operator Tasks](/governance/approvals.md)
- [Gateways](/governance/gateways.md)
- [Traces](/concepts/traces-analytics.md)