AGENTS.md as the entry point.
Give the tool repository context
Ask the tool to read:AGENTS.md.ai/README.md- The relevant repository guidance under
.ai - The selected agent, skill, workflow, or task contract
- A closer
AGENTS.mdwhen working in a subtree such asapps/docs
.ai files into provider-specific directories.
Example request
Tools with native skills or agents
Map the repository contracts to native capabilities when useful:- Use
.ai/agentsas role and output contracts. - Use
.ai/skills/<name>/SKILL.mdas reusable procedures. - Use
.ai/workflowsto coordinate planning, implementation, review, and verification. - Parallelize independent read-only work only.
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.