Merge branch 'develop' into mltheuser/kg-487

Author: mltheuser

examples/code-agent/step-01-basic-agent/README.md

@@ -0,0 +1,33 @@
+# Code Agent - Step 01: Minimal Agent
+
+> Code from the blog post: [Building AI Agents in Kotlin – Part 1: A Minimal Coding Agent](https://blog.jetbrains.com/ai/2025/11/building-ai-agents-in-kotlin-part-1-a-minimal-coding-agent/)
+
+A minimal code agent with three tools that can navigate codebases and make targeted changes.
+
+## Prerequisites
+
+- Java 17+
+- OpenAI API key
+
+## Setup
+
+```bash
+export OPENAI_API_KEY=your_openai_key
+```
+
+## Run
+
+Navigate to this example:
+```
+cd examples/code-agent/step-01-minimal-agent
+```
+
+Run the agent on any project:
+```
+./gradlew run --args="/absolute/path/to/project 'Task description'"
+```
+
+Example:
+```
+./gradlew run --args="/Users/yourname/my-project 'Add error handling'"
+```