Skip to content

CLAUDE.md

Latest commit

 

History

History
23 lines (15 loc) · 1.93 KB

CLAUDE.md

File metadata and controls

23 lines (15 loc) · 1.93 KB

CLAUDE.md

SMILE-factory is a multi-project monorepo. The active project is delulu, a Discord → Claude Code orchestrator that dispatches tasks to ephemeral Modal sandboxes (under apps/delulu_discord and apps/delulu_sandbox_modal). It also hosts a LoRA-Instruct SFT training recipe (HuggingFace PEFT + LoRA) under training/lora_instruct/.

Quick Reference

Each project owns its own Makefile and tooling — there is no repo-wide poetry/pytest. Use the per-project entrypoints:

  • Delulu (active): make -C apps/delulu_discord check (lint + test), make -C apps/delulu_discord deploy, make -C apps/delulu_sandbox_modal modal-deploy. Top-level shortcuts: make check, make deploy-bot, make deploy-modal, make deploy-all.
  • LoRA-Instruct training: see training/lora_instruct/CLAUDE.md for setup, lint, test, and training commands — they no longer live at the repo root.

Docs

  • Monorepo conventions — how pre-commit, CI, branch protection, and per-app Makefiles interact in this multi-pyproject layout. Read this before touching .pre-commit-config.yaml, .github/workflows/delulu-deploy.yaml, or any root-level tooling
  • Architecture — project structure, key components, and dependencies
  • Development — setup, linting, testing, training, and code conventions

Git workflow

  • Never commit to main — always branch, push, open a PR.
  • Branch: <type>/<slug> (e.g. feat/streaming-renderer, fix/dispatcher-timeout).
  • Commits + PR titles: Conventional Commits (feat, fix, docs, refactor, test, chore, ci, build, perf, style, plus a local prd type for changes under prd/). Squash-merge uses the PR title, so it must be conventional.
  • Only commit, push, or open PRs when explicitly asked. Never merge PRs — that's a human call.