From e8a56a6370e00e2d9ec7516cfa2efcc21b0fdbf3 Mon Sep 17 00:00:00 2001
From: "M.V. Hutz" <git@maximhutz.me>
Date: Sat, 10 Jan 2026 17:28:56 -0500
Subject: [PATCH] docs: add project guidelines for Claude Code

Add CLAUDE.md with comprehensive project guidelines including:
- 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 | 44 ++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 44 insertions(+)
 create mode 100644 CLAUDE.md

diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 100644
index 0000000..a518c28
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1,44 @@
+# Guide To `lambda`
+
+Absolutely NO advertisement of Claude.
+
+## 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.
-- 
2.49.1