---
inclusion: always
---

# 🚨 CRITICAL SYSTEM INSTRUCTION 🚨

Before answering ANY prompt or executing ANY code in this repository,
you **MUST** first read and strictly adhere to ALL the rules defined
in the following directory:

## Step 1: Read ALL Core Rule Files

📁 `.agent/rules/` — Read in numerical order:

1. `.agent/rules/01-general.md` — Language, communication, idempotency, cross-platform, network, security & audit
2. `.agent/rules/02-coding-style.md` — Commit messages, code quality, error handling, documentation, naming conventions
3. `.agent/rules/03-architecture.md` — Project structure, AI IDE integration, design principles
4. `.agent/rules/04-security.md` — Credentials, access control, encryption, scanning, incident response
5. `.agent/rules/05-dependencies.md` — Locking, integrity, auditing, release process, changelog
6. `.agent/rules/06-ci-testing.md` — Test types, CI pipeline, test data, fast feedback, quality gates
7. `.agent/rules/07-git.md` — Commits, branching, pull requests, code review, history hygiene
8. `.agent/rules/08-dev-env.md` — Environment consistency, dev container, scripts, pre-commit hooks, debugging
9. `.agent/rules/09-ai-interaction.md` — Safety boundaries, code generation, communication, context handling, quality
10. `.agent/rules/10-ui-ux.md` — Styling, componentization, accessibility, performance, i18n (frontend projects only)
11. `.agent/rules/11-deployment.md` — Containerization, secrets, deployment pipeline, IaC, observability & DR

## Step 2: Read Relevant Language & Framework Rule Files

After reading the core rules, **inspect the project's file structure and configuration files** (e.g., `package.json`, `go.mod`, `Cargo.toml`, `pom.xml`, `pyproject.toml`, `*.csproj`) to identify the languages and frameworks in use.

Then read the corresponding rule files from `.agent/rules/`:

### Languages

| Detected   | Rule File                    |
| ---------- | ---------------------------- |
| JavaScript | `.agent/rules/javascript.md` |
| TypeScript | `.agent/rules/typescript.md` |
| Python     | `.agent/rules/python.md`     |
| Go         | `.agent/rules/go.md`         |
| Rust       | `.agent/rules/rust.md`       |
| Java       | `.agent/rules/java.md`       |
| Kotlin     | `.agent/rules/kotlin.md`     |
| C#         | `.agent/rules/csharp.md`     |
| Swift      | `.agent/rules/swift.md`      |
| PHP        | `.agent/rules/php.md`        |
| Ruby       | `.agent/rules/ruby.md`       |
| Scala      | `.agent/rules/scala.md`      |
| Elixir     | `.agent/rules/elixir.md`     |
| Lua        | `.agent/rules/lua.md`        |
| R          | `.agent/rules/r.md`          |
| C          | `.agent/rules/c.md`          |
| C++        | `.agent/rules/cpp.md`        |
| Shell/Bash | `.agent/rules/shell.md`      |
| HTML       | `.agent/rules/html.md`       |
| CSS        | `.agent/rules/css.md`        |
| SQL        | `.agent/rules/sql.md`        |
| GraphQL    | `.agent/rules/graphql.md`    |

### Frameworks & Libraries

| Detected             | Rule File                    |
| -------------------- | ---------------------------- |
| Node.js              | `.agent/rules/node.md`       |
| Bun                  | `.agent/rules/bun.md`        |
| Deno                 | `.agent/rules/deno.md`       |
| React                | `.agent/rules/react.md`      |
| Next.js              | `.agent/rules/nextjs.md`     |
| Vue                  | `.agent/rules/vue.md`        |
| Nuxt                 | `.agent/rules/nuxt.md`       |
| Angular              | `.agent/rules/angular.md`    |
| Svelte               | `.agent/rules/svelte.md`     |
| Astro                | `.agent/rules/astro.md`      |
| Remix                | `.agent/rules/remix.md`      |
| Express              | `.agent/rules/express.md`    |
| NestJS               | `.agent/rules/nestjs.md`     |
| Hono                 | `.agent/rules/hono.md`       |
| tRPC                 | `.agent/rules/trpc.md`       |
| FastAPI              | `.agent/rules/fastapi.md`    |
| Django               | `.agent/rules/django.md`     |
| Flask                | `.agent/rules/flask.md`      |
| Rails                | `.agent/rules/rails.md`      |
| Laravel              | `.agent/rules/laravel.md`    |
| Spring / Spring Boot | `.agent/rules/spring.md`     |
| Gin                  | `.agent/rules/gin.md`        |
| Echo                 | `.agent/rules/echo.md`       |
| Fiber                | `.agent/rules/fiber.md`      |
| Chi                  | `.agent/rules/chi.md`        |
| Beego                | `.agent/rules/beego.md`      |
| go-zero              | `.agent/rules/go-zero.md`    |
| Kratos               | `.agent/rules/kratos.md`     |
| Actix-web            | `.agent/rules/actix-web.md`  |
| Axum                 | `.agent/rules/axum.md`       |
| Flutter              | `.agent/rules/flutter.md`    |
| Prisma               | `.agent/rules/prisma.md`     |
| GORM                 | `.agent/rules/gorm.md`       |
| SQLAlchemy           | `.agent/rules/sqlalchemy.md` |
| gRPC                 | `.agent/rules/grpc.md`       |
| WebAssembly          | `.agent/rules/wasm.md`       |

### Infrastructure & Data

| Detected                        | Rule File                          |
| ------------------------------- | ---------------------------------- |
| Docker                          | `.agent/rules/docker.md`           |
| Kubernetes                      | `.agent/rules/kubernetes.md`       |
| Terraform                       | `.agent/rules/terraform.md`        |
| Ansible                         | `.agent/rules/ansible.md`          |
| GitHub Actions                  | `.agent/rules/github-actions.md`   |
| PostgreSQL                      | `.agent/rules/postgresql.md`       |
| MySQL                           | `.agent/rules/mysql.md`            |
| MongoDB                         | `.agent/rules/mongodb.md`          |
| Redis                           | `.agent/rules/redis.md`            |
| Elasticsearch                   | `.agent/rules/elasticsearch.md`    |
| Data Engineering                | `.agent/rules/data-engineering.md` |
| Monitoring (Prometheus/Grafana) | `.agent/rules/monitoring.md`       |

### Additional Topics

| Topic                  | Rule File                       |
| ---------------------- | ------------------------------- |
| API Design (REST/HTTP) | `.agent/rules/api-design.md`    |
| Accessibility (a11y)   | `.agent/rules/accessibility.md` |
| LLM Prompt Engineering | `.agent/rules/llm-prompt.md`    |

## Why This File Exists

This project uses a **unified rule system** to ensure consistent AI behavior
across all AI-powered IDEs and tools (Cursor, Windsurf, GitHub Copilot,
Cline, Claude, Gemini, Trae, Roo Code, Augment, Amazon Q, Kiro,
Continue, Junie, etc.). This file is a redirect entry point —
the actual rules live in `.agent/rules/` as the Single Source of Truth.

> **Failure to follow the rules inside `.agent/rules/` is completely unacceptable.**
