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

# Alleato AI Platform

> How Alleato turns project information into traceable answers, recommendations, and controlled actions.

Alleato AI is part of the product experience. It helps teams find information,
understand project conditions, prepare work, and take approved actions—but it
does not bypass the product's permission, source, or confirmation rules.

## What the AI platform does

```text theme={null}
Question or request
        │
        ▼
In-product assistant
Intent, permissions, prompt assembly, tool selection
        │
        ├──────────────► Product and project data
        ├──────────────► Retrieval and source evidence
        ├──────────────► Specialist services when needed
        │
        ▼
Answer, source links, draft, preview, or confirmed action
```

## The three AI responsibilities

| Responsibility | What it means in Alleato                                                                                             |
| -------------- | -------------------------------------------------------------------------------------------------------------------- |
| Answer         | Retrieve and synthesize project, document, schedule, financial, and communication information with source awareness. |
| Advise         | Turn source signals into risks, decisions, priorities, and recommended next actions.                                 |
| Act safely     | Draft or preview structured changes first; execute only through validated, permission-aware product paths.           |

## How trust is built into the system

* **Source-backed responses.** Important answers should identify the underlying
  project records, documents, communications, or packets that informed them.
* **Bounded tools.** AI tools have typed inputs and scoped capabilities rather
  than unrestricted access to the database or external systems.
* **Preview before write.** Actions that change records follow a review and
  confirmation path instead of allowing model text to mutate data directly.
* **Visible operational state.** Ingestion, retrieval, and AI runs record their
  status so missing sources and degraded answers can be investigated.
* **Human review for learning.** AI suggestions and learned workflows are
  promoted through reviewable records rather than silently becoming permanent
  behavior.

## Where AI work runs

| Workload                 | Owner                       | Examples                                                                 |
| ------------------------ | --------------------------- | ------------------------------------------------------------------------ |
| Product assistant        | Next.js product runtime     | Chat streaming, tool routing, retrieval, action previews                 |
| Operational intelligence | FastAPI operational engine  | Source processing, project intelligence compilation, scheduled refreshes |
| Specialist assistance    | Backend specialist services | App expert, research, document research, executive assistance            |
| Standalone experiments   | Separate agent workspaces   | Evaluation, app-help labs, distinct agent channels                       |

## What AI is not allowed to do

* Treat unverified generated text as a source of truth.
* Quietly substitute empty or stale source data for an answer.
* Write directly to business records without deterministic validation,
  permissions, auditability, and the required confirmation path.
* Hide an operational failure behind a generic success message.

## What this means for Brandon

The goal is not “an AI chatbot.” It is a reliable project-intelligence layer
that can explain what is happening, show why it believes that, and help teams
move work forward without weakening the controls that protect project data.

## Further reading

* [Architecture Overview](/architecture/overview)
* [Codebase Map](/architecture/codebase-map)
* [AI architecture reference](https://github.com/The-Alleato-Group/project-management/blob/main/docs/architecture/AI-RAG-ARCHITECTURE.md)