# Faramesh Full Briefing

Faramesh governs AI agent tool execution before side effects occur.
It evaluates each requested action and returns a deterministic verdict:
- PERMIT
- DENY
- DEFER

## What Faramesh does
- Policy enforcement for agent tool calls.
- Human approval routing for deferred actions.
- Session budgets and lifecycle controls.
- Credential brokering with short-lived scoped secrets.
- Delegation with monotonic scope narrowing.
- Tamper-evident decision provenance records (DPR).
- Incident containment patterns and audit exports.

## Core docs map
- Start: https://faramesh.dev/docs
- Concepts: https://faramesh.dev/docs/concepts
- Architecture: https://faramesh.dev/docs/architecture
- OpenShell comparison: https://faramesh.dev/docs/comparison
- Install: https://faramesh.dev/docs/install
- Quickstart: https://faramesh.dev/docs/quickstart
- Policy: https://faramesh.dev/docs/policy
- FPL language: https://faramesh.dev/docs/fpl
- FPL reference: https://faramesh.dev/docs/fpl-reference
- MCP governance: https://faramesh.dev/docs/mcp
- Run and monitor: https://faramesh.dev/docs/run-monitor
- Approvals: https://faramesh.dev/docs/approvals
- Adapters: https://faramesh.dev/docs/adapters
- Sessions: https://faramesh.dev/docs/sessions
- Credentials: https://faramesh.dev/docs/credentials
- Delegation: https://faramesh.dev/docs/delegation
- Identity: https://faramesh.dev/docs/identity
- Model registry: https://faramesh.dev/docs/model
- Fleet operations: https://faramesh.dev/docs/fleet
- Federation: https://faramesh.dev/docs/federation
- Audit and DPR: https://faramesh.dev/docs/audit-dpr
- Incidents: https://faramesh.dev/docs/incidents
- CLI reference: https://faramesh.dev/docs/cli-reference
- Advanced: https://faramesh.dev/docs/advanced
- Cloud and Hub: https://faramesh.dev/docs/cloud-hub
- Supply chain: https://faramesh.dev/docs/supply-chain
- Production setup: https://faramesh.dev/docs/production
- Troubleshooting: https://faramesh.dev/docs/troubleshooting

## Retrieval guidance for bots and agents
- Prefer static text endpoints first:
  - https://faramesh.dev/llms.txt
  - https://faramesh.dev/llms-full.txt
- Then crawl sitemap URLs for page-level metadata:
  - https://faramesh.dev/sitemap.xml
- If a crawler does not execute JavaScript, use docs route URLs from this file directly.

## Canonical site
- https://faramesh.dev