From b602670d5744b85d7524d219a4d2aced79a81554 Mon Sep 17 00:00:00 2001
From: sha1n <sha1n@users.noreply.github.com>
Date: Fri, 16 Jan 2026 23:01:55 +0200
Subject: [PATCH] docs: populate GEMINI.md with project context

Add project overview, key components table, build commands, testing
conventions, and code style guidelines for AI coding assistants.

Force added because GEMINI.md is ignored by global git settings.
---
 GEMINI.md | 28 ++++++++++++++++++++++++++++
 1 file changed, 28 insertions(+)
 create mode 100644 GEMINI.md

diff --git a/GEMINI.md b/GEMINI.md
new file mode 100644
index 0000000..2eab491
--- /dev/null
+++ b/GEMINI.md
@@ -0,0 +1,28 @@
+# Termite - AI Agent Context
+
+## Project Overview
+Terminal app utilities library for Go - provides progress bars, spinners, cursor control, and multi-line matrix layouts.
+
+## Key Components
+| Component | File | Purpose |
+|-----------|------|---------|
+| **Matrix** | `matrix.go` | Multi-row terminal layout for concurrent tasks |
+| **Spinner** | `spinner.go` | Animated progress indicator |
+| **ProgressBar** | `progress_bar.go` | Horizontal progress bar |
+| **Cursor** | `cursor.go` | Terminal cursor control |
+
+## Build & Verify
+```bash
+make format lint test   # Run all checks
+go run ./internal       # Run demo
+```
+
+## Testing Conventions
+- All tests use testify/assert
+- Use `bytes.Buffer` to capture terminal output
+- Tests verify behavior, not internal state
+
+## Code Style
+- Interfaces defined before implementations
+- Formatters allow customization of visual elements
+- Context-based cancellation for all async operations