Anthropic · Claude Code

ChooChoo for Claude.

Give Claude the institutional memory it needs.

Claude Code reads CLAUDE.md and AGENTS.md at every session start. ChooChoo generates both — packed with your code standards, architectural decisions, and security guardrails — so Claude ships right the first time.

Get Started Read the Docs →

Configuration

ChooChoo generates your Claude context files.

Claude Code reads CLAUDE.md and AGENTS.md at session start. ChooChoo keeps them accurate, up-to-date, and git-tracked — no manual maintenance required.

CLAUDE.md with commands, architecture, and guardrails
AGENTS.md with skills, boundaries, and architecture decisions
Auto-regenerated on every commit via CI hook

CLAUDE.md

# CLAUDE.md
# Generated by ChooChoo — do not edit by hand.
# Run: choochoo context generate

## What this is
payments-api: a FastAPI service handling financial
transactions. Provides Claude Code with structured
startup context for this repository.

## Commands
mise run dev     Start dev server (hot-reload on)
mise run test    Full test suite (pytest -v)
mise run lint    Ruff lint check
mise run fix     Auto-fix lint + format

## Code Standards
- Python 3.12 with strict mypy — no untyped Any
- Ruff formatting (line-length = 100)
- Pydantic models for all API inputs/outputs
- Tests required for all new business logic

## Guardrails
- Never log secrets, payment tokens, or card data
- SQL through SQLAlchemy ORM — no raw strings
- All external inputs validated at the API boundary

## Architecture
ADR-001  JWT (RS256) — keys in secrets manager
ADR-007  API versioned under /v1/, /v2/ namespaces

AGENTS.md

# AGENTS.md
# Generated by ChooChoo — do not edit by hand.
# Run: choochoo context generate

## Project: payments-api
Stack: Python 3.12 · FastAPI · PostgreSQL · Redis
Style: Ruff (line-length=100) · strict mypy
Tests: pytest · coverage ≥ 85% enforced on CI

## Standards
- Validate all inputs with Pydantic at API boundaries
- No raw SQL — use SQLAlchemy ORM
- Never log secrets, tokens, or payment data
- Annotate all public functions with types

## Boundaries
READ:   src/** · tests/** · docs/**
WRITE:  src/** · tests/**
NEVER:  .github/** · migrations/** · infra/**

## Architecture Decisions
ADR-001  JWT (RS256) for auth
ADR-004  Event-driven webhooks via Redis Streams
ADR-007  API versioning under /v1/, /v2/ namespaces

Why use ChooChoo with Claude?

Stop rediscovering your own codebase. Claude ships better code when it starts with the full picture.

Consistent Output

Generated code follows your linting rules from the start, reducing cleanup work before code review.

Fewer Iterations

The AI understands your standards upfront, producing acceptable code faster and with less back-and-forth.

Team Alignment

Everyone's AI assistant generates code that matches your team's style guide — automatically.

Zero Configuration

Get started instantly with sensible defaults that work out of the box for most projects.

Type-Safe Code

Strict linting rules catch potential bugs and enforce type safety before they reach review.

AI-Ready Rules

Purpose-built rules that AI models understand and follow consistently, session after session.

Ready to supercharge Claude?

Structured context generation for Claude Code. Set up in minutes, pays off on every session.

Install ChooChoo Book a Demo