From 66ab8d6b1c890a2d350678f69a78f62a607885be Mon Sep 17 00:00:00 2001
From: "M.V. Hutz" <git@maximhutz.me>
Date: Sat, 10 Jan 2026 17:25:38 -0500
Subject: [PATCH] docs: add Claude Code project instructions

Add CLAUDE.md with project guidelines for:
- Conventional commit format and types
- Branch naming conventions
- PR management using tea CLI

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
---
 CLAUDE.md | 42 ++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 42 insertions(+)
 create mode 100644 CLAUDE.md

diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 100644
index 0000000..81df342
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1,42 @@
+# Guide To `lambda`
+
+## Coding Styles
+
+### Conventional Commits
+
+Use conventional commit format: `<type>: <description>`.
+
+**Types**: `feat`, `fix`, `docs`, `refactor`, `test`, `chore`, `perf`
+
+**Examples**:
+
+- `feat: add explanation mode flag to CLI`
+- `fix: correct variable renaming in nested abstractions`
+- `docs: update Makefile documentation`
+
+### Branch Names
+
+Use format: `<type>/<description>` with kebab-case.
+
+**Types**: Same as commits: `feat`, `fix`, `docs`, `refactor`, `test`, `chore`, `perf`.
+
+**Examples**:
+
+- `feat/explanation-mode`
+- `fix/variable-renaming`
+- `docs/makefile-improvements`
+- `refactor/silent-directive`
+
+## Pull Request Management
+
+Use the `tea` CLI (Gitea command-line tool) for PR operations instead of `gh`.
+
+**Common commands**:
+
+- `tea pr create` - Create a new pull request.
+- `tea pr list` - List pull requests.
+- `tea pr checkout <number>` - Check out a PR locally.
+- `tea pr close <number>` - Close a pull request.
+- `tea pr merge <number>` - Merge a pull request.
+
+**Creating PRs**: Always create PRs in a branch other than `main`, to the `main` branch unless specified otherwise.