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

​AGENTS.md

​HoopAI Docs — Agent Instructions

​Rules files

​.claude/ folder structure

​Project structure

​Branding rules (CRITICAL — always active)