Add AGENTS files (#7765)

* Add AGENTS files

* Fix for linters

* Cleanup AGENTS files

Author: dgarros

.vale/styles/spelling-exceptions.txt

@@ -39,6 +39,7 @@ cron
 Cron
 cypher
 Dagster
+Diataxis
 datacenter
 dataloader
 datastore
@@ -216,6 +217,7 @@ towncrier
 Towncrier
 UIs
 uncheck
+unoptimized
 uniqueness_constraints
 upsert
 upserting

AGENTS.md

@@ -0,0 +1,109 @@
+# AGENTS.md
+
+## Project Overview
+
+Infrahub is a graph-based infrastructure data management platform by OpsMill. It combines Git-like branching and version control with a flexible graph database (Neo4j) and a modern UI/API layer.
+
+## Tech Stack
+
+- **Backend:** Python 3.12, FastAPI 0.121.1, Neo4j 5.28, Pydantic 2.10
+- **Frontend:** TypeScript 5.9, React 19.2, Vite 7.2, Tailwind CSS 4.1
+- **Testing:** pytest 7.4, Vitest 4.0, Playwright 1.56
+- **Linting:** ruff 0.14.5, mypy 1.15, Biome 2.3
+- **Package Managers:** uv (Python), npm (Frontend)
+- **Task Runner:** Invoke 2.2.0
+
+## File Structure
+
+- `backend/` – Python backend (FastAPI, GraphQL, core logic) - see [backend/AGENTS.md](backend/AGENTS.md)
+- `frontend/app/` – React frontend - see [frontend/app/AGENTS.md](frontend/app/AGENTS.md)
+- `docs/` – Docusaurus documentation - see [docs/AGENTS.md](docs/AGENTS.md)
+- `python_sdk/` – Python SDK (Git submodule)
+- `tasks/` – Invoke task definitions
+- `schema/` – JSON/GraphQL schema definitions
+- `changelog/` – Towncrier changelog fragments
+
+## Commands
+
+### Setup
+
+```bash
+uv sync --all-groups                  # Install Python dependencies
+cd frontend/app && npm install        # Install frontend dependencies
+```
+
+### Testing
+
+```bash
+uv run invoke backend.test-unit       # Backend unit tests
+uv run invoke backend.test-integration # Backend integration tests
+cd frontend/app && npm run test       # Frontend unit tests
+cd frontend/app && npm run test:e2e   # Frontend E2E tests
+```
+
+### Linting & Formatting
+
+```bash
+uv run invoke format                  # Format all Python code
+uv run invoke lint                    # Lint all Python code
+cd frontend/app && npm run biome:fix  # Format/lint frontend
+uv run invoke docs.lint               # Lint documentation
+```
+
+### Build
+
+```bash
+uv run invoke dev.build               # Build Docker containers
+cd frontend/app && npm run build      # Build frontend
+cd docs && npm run build              # Build documentation
+```
+
+## Generated Files (Do Not Edit)
+
+- `backend/infrahub/core/schema/generated/` – Schema definitions
+- `backend/infrahub/core/protocols.py` – Protocol definitions
+- `frontend/app/src/shared/api/graphql/generated/` – GraphQL types
+- `frontend/app/src/shared/api/rest/types.generated.ts` – REST types
+- `schema/schema.graphql` - GraphQL schema of the Core Schema
+- `schema/openapi.json` - OpenAPI schema for the REST API
+
+Regenerate with: `uv run invoke backend.generate` or `cd frontend/app && npm run codegen`
+
+## Markdown Formatting
+
+When editing markdown files (enforced by markdownlint):
+
+- Use `-` for unordered lists
+- Add blank line before/after headings, code blocks, and lists
+- Use fenced code blocks with language identifier
+- No trailing spaces or multiple consecutive blank lines
+- No bare URLs (use `[text](url)` format)
+
+## Git Workflow
+
+- **Main branches:** `stable` (production), `develop` (development), `release-*` (releases)
+- **Commit messages:** Conventional commits; include issue references
+- **Changelog:** Add fragment to `changelog/` using Towncrier format
+
+## Boundaries
+
+### Always Do
+
+- Run formatters before committing (`uv run invoke format`, `npm run biome:fix`)
+- Write tests for new functionality
+- Use type hints for Python (backend) and TypeScript types (frontend)
+
+### Ask First
+
+- Database schema or migration changes
+- GraphQL schema modifications
+- New dependencies
+- CI/CD workflow changes
+- Authentication/authorization changes
+
+### Never Do
+
+- Commit secrets, API keys, or credentials
+- Edit generated files manually
+- Skip linting in CI
+- Force push to `stable` or `develop`