AGENTS.md examples from real projects

JetBrainsAGENTS.md

kotlin

JetBrains/kotlin/AGENTS.md

CRITICAL: guidelines.md MUST be followed at all times.

No other project uses it yet

JetBrainsAGENTS.md

kotlin / analysis

JetBrains/kotlin/analysis/AGENTS.md

A library for analyzing Kotlin code at the semantic level, providing structured access to symbols, types, and semantic relationships. Entry point: Use analyze() to start an analysis session. See Analysis…

JetBrainsAGENTS.md

kotlin / compiler

JetBrains/kotlin/compiler/AGENTS.md

Consider reading fir-basics.md. FIR processes code through sequential phases (see FirResolvePhase.kt). Key invariant: In phase B following phase A, all FIR elements visible in B are resolved to phase A.

No other project uses it yet

JetBrainsAGENTS.md

intellij-community

JetBrains/intellij-community/AGENTS.md

Write every user-visible artifact in ASD-STE100 Simplified Technical English, and keep it short. This covers a comment, KDoc, a commit message, documentation, a spec, and a report to the user.…

JetBrainsAGENTS.md

intellij-community / java

JetBrains/intellij-community/java/AGENTS.md

Rules for this directory and every directory below it. They override the root AGENTS.md. More intellij.java.* modules live outside this tree, under ../plugins/ and ../platform/. This file does not reach…

JetBrainsAGENTS.md

intellij-community / python

JetBrains/intellij-community/python/AGENTS.md

Start a PY-NNNNN issue or Python support work at .ai/index.md.

JetBrainsAGENTS.md

thinkrail

JetBrains/thinkrail/AGENTS.md

The agentic IDE that gets better every time you use it, built around the pi coding agent. The app is a thin host that runs pi and bridges it to a rich UI; pi owns models, skills, compaction, cost, and session state. - Use goal-and-requirements.md for the product's goal, principles, capabilities, and non-goals. - Use architecture.md for system topology, cross-module decisions, and repo-wide invariants. - For a pi upgrade or a host workaround around pi, read pi-compatibility.md: verify every applicable…

JetBrainsAGENTS.md

koog

JetBrains/koog/AGENTS.md

Koog is a Kotlin multiplatform framework for building AI agents with graph-based workflows. It supports JVM and JS targets and integrates with multiple LLM providers (OpenAI, Anthropic, Google, OpenRouter, Ollama) and Model Context Protocol (MCP). The project follows a modular architecture with a clear separation of concerns: AIAgent — Main orchestrator that executes strategies in coroutine scopes, manages tools via ToolRegistry, runs features through AIAgentPipeline, and handles LLM communication via PromptExecutor. AIAgentStrategy — Graph-based execution logic that defines workflows as…

No other project uses it yet

JetBrainsAGENTS.md

intellij-plugins / CloudFormation

JetBrains/intellij-plugins/CloudFormation/AGENTS.md

These notes are specific to contrib/CloudFormation and its metadata-crawler subproject.

JetBrainsAGENTS.md

intellij-plugins / terraform

JetBrains/intellij-plugins/terraform/AGENTS.md

Use these conventions when writing or changing tests in this plugin. Run asynchronous tests inside timeoutRunBlocking. Invoke editor actions in a narrow withContext(Dispatchers.EDT) block with the required lock context. Await…

JetBrainsAGENTS.md

MPS

JetBrains/MPS/AGENTS.md

This project is a mixed JetBrains MPS + plain Java/Kotlin codebase. Developers typically use two environments against the same checkout: - IntelliJ IDEA for editing, debugging, testing, and inspecting Java/Kotlin code, including code generated by MPS. - JetBrains MPS for editing languages, models, generators, and other MPS artifacts. Agents must adapt to the tools available in the current session. Use this file as the cross-environment entry point. For detailed MPS node, model, language, generator, validation, and MCP workflows, load the…

No other project uses it yet

JetBrainsAGENTS.md

android / compose-designer

JetBrains/android/compose-designer/AGENTS.md

This document describes how an AI agent can interact specifically with the Compose Designer. For common preview interaction patterns, see the Preview Designer Agent Guide.

JetBrainsAGENTS.md

android / designer

JetBrains/android/designer/AGENTS.md

This document describes how an AI agent can interact with the Layout Editor (Designer).

JetBrainsAGENTS.md

android / preview-designer

JetBrains/android/preview-designer/AGENTS.md

This document describes how an AI agent can interact with common Preview Designer features.

JetBrainsAGENTS.md

lincheck

JetBrains/lincheck/AGENTS.md

Guidance for AI coding agents working in the Lincheck repository. Follows the agents.md convention; CLAUDE.md just imports this file. check aggregates test + testIsolated. traceRecorderIntegrationTest downloads the target external projects…

JetBrainsAGENTS.md

lincheck / live-debugger

JetBrains/lincheck/live-debugger/AGENTS.md

Module-specific guidance for lincheck/live-debugger/. Parent guidance: ../AGENTS.md. A JVM agent for dynamic, non-suspending breakpoints. A snapshot breakpoint captures the program state at a source line — stack trace, local variables,…

JetBrainsAGENTS.md

lincheck / tracer

JetBrains/lincheck/tracer/AGENTS.md

Module-specific guidance for lincheck/tracer/. Parent guidance: ../AGENTS.md. The runtime tracing engine shared by the trace-recorder and live-debugger JVM agents. It provides the common agent scaffolding (premain/agentmain), manages tracing sessions, and…

JetBrainsAGENTS.md

compose-multiplatform-core

JetBrains/compose-multiplatform-core/AGENTS.md

This is a fork of androidx monorepo dedicated for Compose Multiplatform (CMP) work. The purpose of the fork is to provide missing Kotlin targets for modules registered in JetBrainsPublication.kt (mainly Compose-related). Generally we add support for iOS, Web and Desktop. and we do not validate, build and test Android. The full list of which targets are not maintained is defined in the associated build-fork.gradle, in the redirect block. The primary focus of Compose Multiplatform is the ./compose directory. Most often,…

JetBrainsAGENTS.md

compose-multiplatform-core / compose

JetBrains/compose-multiplatform-core/compose/AGENTS.md

This directory contains the libraries that make up Compose Multiplatform Core. Refer to AGENTS.md for general instructions.

JetBrainsAGENTS.md

compose-multiplatform-core / navigation3

JetBrains/compose-multiplatform-core/navigation3/AGENTS.md

- When modifying any .kt file, format it via the following command: ./gradlew :ktCheckFile --format --file <file>. If more than one file needs formatting, continue adding --file <next-file> to the command. - When a public API is changed or when asked to update the public API files, execute: ./gradlew <project>:updateApi, the projects and their root paths can be found in settings.gradle. - When moving files, use git mv to keep version control history. - Do not make a git commit…