> For the complete documentation index, see [llms.txt](https://cogna8-io.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cogna8-io.gitbook.io/docs/troubleshooting/common-issues.md).

# Common Issues

Most issues in Cogna8 are not random failures. They are usually one of a few understandable conditions in the state, conflict, or gate path. That is a strength of the system design: when something looks wrong, there is usually a traceable reason.

***

## Fast Triage Sequence

{% stepper %}
{% step %}
**Identify the symptom**

Missing state, unresolved conflict, blocked action, slow processing, access issue, or voice issue.
{% endstep %}

{% step %}
**Open the relevant panel**

State, Conflicts, Actions, or Why.
{% endstep %}

{% step %}
**Inspect the reason chain**

Use Why and Audit when the cause is not obvious.
{% endstep %}

{% step %}
**Confirm scope and policy context**

Many apparent bugs are context or policy expectation mismatches.
{% endstep %}
{% endstepper %}

{% hint style="info" %}
**Do not assume every block or warning is a failure.** In many cases the system is correctly preventing execution on incomplete or contradictory state.
{% endhint %}