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

# AGENTS

# AGENTS.md

This file provides guidance to AI coding agents (Codex and Claude Code) when working with code in this repository.

# HoopAI Docs — Agent Instructions

This is a **Mintlify** documentation site for HoopAI (\~743 MDX pages, 4 top-level nav tabs).

## Rules files

Detailed rules live in `.claude/rules/` — read them when the task requires:

| File                               | Read when                                              |
| ---------------------------------- | ------------------------------------------------------ |
| `.claude/rules/content-sources.md` | Sourcing content, browsing JS SPAs, downloading images |
| `.claude/rules/workflow.md`        | Running the dev server, CLI commands, MDX conventions  |
| `.claude/rules/agents.md`          | Launching parallel subagents, verifying pages          |
| `.claude/rules/styling.md`         | Editing CSS, docs.json, or debugging common errors     |

## .claude/ folder structure

```
.claude/
├── docs/           # Reference lookups (components, CSS selectors, project map, theme)
├── skills/         # Behavioral instructions (mintlify, icon-audit, openapi-fixer, qa-audit)
├── agents/         # Subagent configs (doc-cloner, batch-doc-creator, nav-updater, …)
└── rules/          # Rule files loaded on-demand (see table above)
```

* **Docs**: Read for lookups — component props, CSS selectors, site structure. Never modified.
* **Skills**: Read to learn HOW to perform tasks — writing pages, configuring nav, API setup.
* **Agents**: Delegate specific tasks to subagents via the Agent tool.

## Project structure

```
docs/
├── docs.json              # Site config — theme, nav, colors, branding
├── theme/custom.css       # Custom CSS overrides
├── getting-started/       # Getting Started tab
├── dashboard/  contacts/  opportunities/  calendars/   # Modules tab — CRM
├── conversations/         # Modules tab — Conversations
├── marketing/  reputation/                             # Modules tab — Marketing
├── automation/  ai-agents/                             # Modules tab — Automation & AI
├── sites/  memberships-and-communities/  media-storage/ # Modules tab — Sites
├── payments/  reporting/  settings/                    # Modules tab — Payments / Admin
├── mobile-app/            # Modules tab — Mobile App
├── api-reference/         # Developer Tools tab
├── academy/               # Resources tab
├── troubleshooting/       # Resources tab
├── images/                # Static assets (screenshots, GIFs, logos)
└── snippets/              # Reusable MDX components
```

For full tab-to-directory mapping, read `.claude/docs/project-map.md`.

## Branding rules (CRITICAL — always active)

* **NEVER** write "GoHighLevel", "HighLevel", "GHL", or "Go High Level" in any output
* **NEVER** write "Marketing Muse", "Marketing Muse Inc", or "Marketing Muse Collective" in any output
* **NEVER** write "WhoPayI" in any output
* **ALWAYS** use **"HoopAI platform"** (first/formal) or **"Hoop"** (short)
* Replace all vendor/white-label brand names when cloning content from any source