CLAUDE.md git:20260713.5898eb4A

Immutable. This exact content never changes and is served at /api/v1/blob/2a23f6d22ffe79f1.

# CLAUDE.md

> **[AGENTS.md](./AGENTS.md) is the canonical guide for this repo — read it first.** It holds
> the conventions, commands, package map, and definition of done. This file only adds
> Claude-specific pointers and must not duplicate it.

## Notes

- **This is an [Nx](https://nx.dev) monorepo (pnpm).** Drive all tasks through Nx targets —
  `nx build <project>`, `nx test <project>`, and prefer `nx affected -t build test typecheck`
  over running things by hand. Each package has a `project.json`. Full command list is in
  [AGENTS.md](./AGENTS.md#this-is-an-nx-monorepo-pnpm--use-nx).
- **Reuse first.** Before writing code, check [docs/reuse.md](./docs/reuse.md) — much of what
  skein-js needs already exists in the MIT `@langchain/*` packages.
- **Style is codified**, not a matter of taste: [docs/code-practices.md](./docs/code-practices.md).
  Pragmatic functional style, named exports, kebab-case files; ESLint + Prettier are the
  source of truth — run `pnpm lint` / `pnpm format` rather than hand-formatting.
- **Testing:** Vitest + Testcontainers, shared conformance suite — [docs/testing.md](./docs/testing.md).

## Hard rules

These are non-negotiable in this repo (they extend, and never restate, AGENTS.md):

- **Names must reveal purpose.** A reader knows what a symbol does from its name alone. No vague
  names (`data`, `info`, `util`, `handle`, `manager`, `process`, `doIt`) and no unexplained
  abbreviations. Functions read verb-first (`startRun`, `resolveGraph`, `mirrorThreadState`); values
  are nouns (`activeRun`, `graphResolver`). Prefer a longer honest name over a short opaque one.
- **Scaffold libraries with the Nx CLI**, never by hand: `npx nx g @nx/js:lib <name>
--directory=packages/<dir> --importPath=@skein-js/<name>`, then align the generated files to the
  `@skein-js/core` template. Do not create a package tree file-by-file.

Everything else lives in [AGENTS.md](./AGENTS.md) and [`docs/`](./docs/index.md).