docs: add CLAUDE.md for Claude Code guidance

Provides project overview, build commands, structure, and CI/CD info
for AI-assisted development.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

.claude/settings.local.json

@@ -0,0 +1,7 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(but status:*)"
+    ]
+  }
+}

CLAUDE.md

@@ -0,0 +1,40 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+This is a Docker image project for Robot Framework test automation. It packages Robot Framework with commonly used testing libraries and browser drivers (Firefox, Chrome) into a containerized environment for running automated tests.
+
+## Build Commands
+
+The project uses `build-tools` (not Docker buildx) for building:
+```bash
+build    # Build the Docker image
+push     # Push the image to registry
+```
+
+## Project Structure
+
+- `Dockerfile` - Main container definition based on Python slim, installs browsers and RF libraries
+- `requirements.txt` - Python dependencies (Robot Framework + libraries)
+- `.version` - JSON file containing the current version
+- `cliff.toml` - git-cliff configuration for changelog generation
+- `.gitea/workflows/ci.yaml` - CI pipeline (builds on push/PR to main)
+
+## Key Libraries Included
+
+- robotframework-browser (Playwright-based)
+- robotframework-seleniumlibrary
+- robotframework-appiumlibrary
+- robotframework-databaselibrary (with PostgreSQL/MySQL drivers)
+- robotframework-requests
+- robotframework-httplibrary
+
+## Versioning
+
+The project uses semantic versioning. Version is stored in `.version` as JSON. Changelog is auto-generated using git-cliff with conventional commits.
+
+## CI/CD
+
+Uses Gitea Actions. The pipeline runs `build` and `push` on main branch and pull requests.