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

# Add project context

> Tell your agent where to find your OFAuth code and settings.

Keep OFAuth project details in an `OFAUTH.md` file at your repository root. Record paths and configuration names so an agent can find the existing integration before changing it. Keep secret values and account data out of this file.

## Describe your application

Copy this template. Replace the example paths with the paths your app uses. Remove scopes and environments you do not use.

```markdown theme={null}
# OFAuth integration

This application uses OFAuth V3.
Documentation: https://docs.ofauth.com/v3

## Current task

Connect a Sandbox account and display its profile.

## Configuration

- Environment: Sandbox
- Client ID variable: OFAUTH_CLIENT_ID
- Client secret variable: OFAUTH_CLIENT_SECRET
- Sandbox authorization variable: OFAUTH_AUTHORIZATION_ID
- Linked account variable: OFAUTH_LINKED_ACCOUNT_ID
- Requested scopes: profile:read
- Webhook secret variable: OFAUTH_WEBHOOK_SECRET

## Application paths

- Authorization start: replace with our backend route
- OAuth callback: replace with our callback handler
- Token storage: replace with our encrypted storage module
- Linked-account records: replace with our account repository
- Webhook receiver: replace with our receiver route
- Integration checks: replace with our test command

## Integration rules

- Keep secrets, PKCE verifiers, and tokens on the backend.
- Associate authorizations and linked accounts with the user and environment.
- Let your auth framework or application own ordinary token persistence and refresh. Supply its access token or getter to the SDK.
- Verify the original webhook body before using event data.
- Save events and check for duplicates before updating customer records.
- Follow recovery.action. If a write has no clear result, check whether it completed before repeating it.
- Use the official V3 SDK for our language.
```

The template uses the quickstart's variable names. Adapt it when your implementation differs, then keep it current as the integration changes.

## Point your agent to the file

Add this instruction to the project instruction file your agent reads:

```markdown theme={null}
Read OFAUTH.md before changing the OFAuth integration.
Use the official V3 SDK and the matching guide for each task.
Check request and response fields in the API reference.
```

If you installed an [OFAuth skill](https://docs.ofauth.com/v3/agents/skills.md), reference its `SKILL.md` from the same instruction file.

## Check the context

Ask the agent to identify the callback handler, token storage, and webhook receiver from your context file before editing them. It should name existing files and describe the current environment without reading secret values into its response.

Use [Build with an AI agent](https://docs.ofauth.com/v3/reference/agents.md) to check requests and results. The context file describes your app. Use the API reference for request and response fields.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.