dojo: Instructions file for Claude Code

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Repository Overview

This is a comprehensive coding practice and learning repository called "Nab's dojo" containing exercises and implementations across multiple programming languages, platforms, and technologies.

Build and Test Commands

Go Projects

Go projects use Ginkgo/Gomega BDD testing framework. All Go projects have similar structure:

# Navigate to any Go project directory (a_tour_of_go, atcoder, codewars, leetcode, project_euler)
cd <go_project_directory>

# Run tests
go test

# Run with verbose output
ginkgo -v

# Build
go build

AWS Lambda Project

Complex project with both Go Lambda functions and TypeScript CDK infrastructure:

cd aws_lambda

# Build all (Go lambdas + TypeScript CDK)
npm run build

# Build only Go lambdas
npm run build:go

# Build only TypeScript
npm run build:ts

# Run tests
npm test

# Deploy infrastructure
npm run deploy

# Local Lambda invocation (requires AWS SAM)
npm run invoke -- <function_name> <event_type>

AWS CDK Projects

cd aws_cdk/cdk-workshop

# Build TypeScript
npm run build

# Watch mode
npm run watch

# Run tests
npm test

# CDK commands
npm run cdk diff
npm run cdk deploy

DataCamp Python Projects

Uses Poetry for dependency management:

cd datacamp

# Install dependencies
poetry install

# Activate virtual environment
poetry shell

# Run Python scripts or notebooks
python <script_name>.py

Haskell Project (lyhgg)

cd lyhgg

# Build with Cabal
cabal build

# Run tests
cabal test

# Run executable
cabal run

Code Architecture

Go Projects Structure

• Each algorithmic challenge directory follows same pattern:
  • <name>.go - main implementation file
  • <name>_suite_test.go - BDD test suite using Ginkgo/Gomega
  • go.mod - Go module definition with dependencies
• All Go projects target Go 1.12
• Tests use descriptive BDD-style descriptions with nested contexts