# 🚨 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.**
