docs: add project guide for Claude #1

Closed
mvhutz wants to merge 16 commits from docs/claude-guide into main
Owner

Adds CLAUDE.md with conventions for:

  • Conventional commits format
  • Branch naming conventions
  • PR management using tea CLI

This will help Claude better understand project conventions and make more consistent contributions.

Adds CLAUDE.md with conventions for: - Conventional commits format - Branch naming conventions - PR management using tea CLI This will help Claude better understand project conventions and make more consistent contributions.
mvhutz added 16 commits 2026-01-10 22:16:28 +00:00
Changed BINARY_NAME from lambda.exe to lambda for Unix systems.
The .exe extension is a Windows convention and is inappropriate
for macOS/Linux builds.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
Go build already sets the executable bit on binaries, making the
explicit chmod +x unnecessary.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
Declares all non-file targets as phony to prevent conflicts with
files of the same name and improve Make's performance.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
Adds standard clean target to remove binary, output files, and
profile directory.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
Adds help target that displays all available Make targets and their
descriptions, improving discoverability.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
Creates profile directory in profile and explain targets to prevent
errors on first run.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
Makes graph target depend on profile to ensure cpu.prof exists
before attempting to generate visualizations.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
Adds .SILENT directive to suppress command echoing for all targets,
replacing individual @ prefixes. Also moves TEST variable to top with
other variables for better organization.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
Documents all issues found and fixes applied to the Makefile,
including both implemented changes and remaining suggestions.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
Adds the lambda binary to .gitignore to prevent accidentally
committing the build artifact. Previously only *.exe was ignored,
which didn't cover the Unix binary name.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
Adds .DEFAULT_GOAL := help to make it clear that running 'make'
with no arguments will display the help message.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
Add CLAUDE.md with conventions for commits, branch naming, and PR management using tea CLI.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
mvhutz force-pushed docs/claude-guide from ffc292e22b to 19d0e6d3ea 2026-01-10 22:19:47 +00:00 Compare
mvhutz closed this pull request 2026-01-10 22:21:46 +00:00

Pull request closed

Sign in to join this conversation.