---
name: init
description: Initialize the project's agent-instructions file with codebase documentation. Use when asked to init the repo, bootstrap agent instructions, or create/refresh the project instruction file that future agent sessions load when working in this repository.
---

Please analyze this codebase and create the project's agent-instructions file, which will be given to future agent sessions operating in this repository.

**Filename:** the conventional name is `AGENT.md` at the repo root, but the exact filename is shell/deployment-configurable — if this deployment already loads a specific instructions file (check what the shell injects into sessions, or an existing instructions file at the repo root), write to that name instead of introducing a second one.

What to add:
1. Commands that will be commonly used, such as how to build, lint, and run tests. Include the necessary commands to develop in this codebase, such as how to run a single test.
2. High-level code architecture and structure so that future instances can be productive more quickly. Focus on the "big picture" architecture that requires reading multiple files to understand.

Usage notes:
- If there's already an agent-instructions file, suggest improvements to it.
- When you make the initial instructions file, do not repeat yourself and do not include obvious instructions like "Provide helpful error messages to users", "Write unit tests for all new utilities", "Never include sensitive information (API keys, tokens) in code or commits".
- Avoid listing every component or file structure that can be easily discovered.
- Don't include generic development practices.
- If there are Cursor rules (in .cursor/rules/ or .cursorrules) or Copilot rules (in .github/copilot-instructions.md), make sure to include the important parts.
- If there is a README.md, make sure to include the important parts.
- Do not make up information such as "Common Development Tasks", "Tips for Development", "Support and Documentation" unless this is expressly included in other files that you read.
- Be sure to prefix the file with the following text (substituting the actual filename you chose):

```
# AGENT.md

This file provides guidance to coding agents when working with code in this repository.
```