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

# Risks and decisions

> Track risks that could affect your AI projects and record decisions with their rationale for a clear audit trail.

Risks and decisions help you maintain governance across your AI program. Log risks so they can be monitored and mitigated. Record decisions so your team has a clear audit trail of what was decided, when, and why.

## Risks

### What risks track

A risk is anything that could negatively affect a project's success. Each risk captures:

* **Title** — a clear name for the risk
* **Description** — what could go wrong and why it matters
* **Status** — the current state of the risk
* **Visibility** — whether the risk is visible to your team or internal to Kowalah

### Managing risks

Risks live within a project. To add one:

<Steps>
  ### Open a project

  Navigate to the project.

  ### Go to the Risks tab

  Click the **Risks** tab to see existing risks.

  ### Click "New risk"

  Describe the risk and its potential impact.
</Steps>

Your Kowalah partner may also create risks as they identify potential issues during delivery. You'll see all client-visible risks in the project's Risks tab.

<Tip>
  Don't wait until a risk materialises. Logging risks early gives your team time to plan mitigations and keeps everyone aligned on what could go wrong.
</Tip>

## Decisions

### What decisions track

A decision is a recorded choice that affects the project. Each decision captures:

* **Title** — what was decided
* **Description** — the context, reasoning, and any alternatives considered
* **Status** — the current state of the decision
* **Visibility** — whether visible to your team or internal to Kowalah

### Why record decisions

AI programs involve many choices: which use cases to prioritize, which platform to use, how to handle data governance, when to scale. Recording these decisions:

* Creates an **audit trail** for compliance and governance
* Prevents **revisiting settled questions** when new team members join
* Provides **context** for future decisions that build on previous ones

### Adding a decision

Decisions also live within a project:

<Steps>
  ### Open a project

  Navigate to the project.

  ### Go to the Decisions tab

  Click the **Decisions** tab.

  ### Click "New decision"

  Record what was decided and the reasoning behind it.
</Steps>

## Visibility

Both risks and decisions have a visibility flag. Some may be internal to the Kowalah team (for example, delivery-specific risks), while others are shared with your team. You'll see all items marked as client-visible.

<CardGroup cols={2}>
  <Card title="Projects" icon="folder-open" href="/platform/projects/overview">
    Risks and decisions belong to projects
  </Card>

  <Card title="Milestones" icon="flag" href="/platform/projects/milestones">
    Track key dates alongside risks
  </Card>
</CardGroup>