docs: add project guide for Claude #1

Closed
mvhutz wants to merge 16 commits from docs/claude-guide into main
Showing only changes of commit 19d0e6d3ea - Show all commits

42
CLAUDE.md Normal file
View File

@@ -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 to the `main` branch unless specified otherwise