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

# AI tool setup

> Connect any AI coding tool to AMiSi's portable repository guidance

AMiSi does not require a specific editor, model provider, or AI runtime. Open the repository root in your preferred coding tool and use `AGENTS.md` as the entry point.

## Give the tool repository context

Ask the tool to read:

1. `AGENTS.md`
2. `.ai/README.md`
3. The relevant repository guidance under `.ai`
4. The selected agent, skill, workflow, or task contract
5. A closer `AGENTS.md` when working in a subtree such as `apps/docs`

You do not need to copy the `.ai` files into provider-specific directories.

## Example request

```text theme={null}
Update the profile flow in apps/mobile/app/(app)/(tabs)/profile.tsx.
Read AGENTS.md and .ai/README.md first. Follow .ai/workflows/feature.md,
reuse @amisi-mobile-starter/ui and @amisi-mobile-starter/theme, preserve translations and typed analytics,
and run the targeted tests followed by bun run verify.
```

## Tools with native skills or agents

Map the repository contracts to native capabilities when useful:

* Use `.ai/agents` as role and output contracts.
* Use `.ai/skills/<name>/SKILL.md` as reusable procedures.
* Use `.ai/workflows` to coordinate planning, implementation, review, and verification.
* Parallelize independent read-only work only.

Native registration is optional. A tool can always read and follow the files directly.

## Tools without delegation

Run the same workflow sequentially in one conversation. Ask the tool to state which contract it is following and review the plan before broad changes.

## Security

Keep provider credentials in the AI tool's own secure configuration. Do not add model API keys, customer data, or private endpoints to `.ai`, task files, or the mobile application environment.

## Completion

Review all generated changes before committing and run:

```sh theme={null}
bun run verify
```