Files
lambda/CLAUDE.md
M.V. Hutz 475d79c334 docs: replace tea pr edit with tea comment in CLAUDE.md
The tea CLI does not have a pr edit command.
Updated documentation to use tea comment instead.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-16 19:02:29 -05:00

2.8 KiB

Guide To lambda

Documentation Style

Use full sentences. Every sentence gets its own line in Markdown. Every sentence ends in a period.

Coding Style

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

DO NOT advertise Claude.

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

DO NOT advertise Claude.

Issue Management

Use the tea CLI (Gitea command-line tool) for issue operations.

Common commands:

  • tea issues list - List all issues.
  • tea issues <number> - View details of a specific issue.
  • tea issues create --title "<title>" --body "<description>" - Create a new issue.
  • tea issues close <number> - Close an issue.

Reading issues: Use tea issues <number> to read the full details of an issue before starting work.

Issue Workflow

When working on an issue:

  1. Read the issue using tea issues <number> to understand requirements.
  2. Create a feature branch following the branch naming convention.
  3. Make commits following the conventional commit format.
  4. Submit a pull request when ready.

Important: Never commit directly to main. All work must be done in a feature branch and submitted via pull request.

Pull Request Management

Use the tea CLI (Gitea command-line tool) for PR operations instead of gh.

Common commands:

  • tea pr create --title "<title>" --description "<body>" - 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.

Note: Use --description (not --body) for PR body content.

Creating PRs: Always create PRs in a branch other than main, to the main branch unless specified otherwise. ALWAYS FOLLOW THE PR TEMPLATE, EXACTLY.

Linking issues: When a PR solves an issue, reference the issue in both the commit message and PR description using Closes #<number>. This automatically links and closes the issue when the PR is merged.

Adding Comments to PRs

Use the tea CLI to add comments to pull requests:

tea comment <number> "Comment text"

Examples

# Add a comment to PR #42
tea comment 42 "Updated implementation based on feedback"

# Add a multi-line comment
tea comment 42 "Summary of changes:
- Fixed bug in reducer
- Added new tests"