git:20260713.aba6422 to git:20260713.43fe752

12 added, 0 removed. Audit A to A.

# 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 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/<name>`, then align the generated files to the

+ `@skein/core` template. Do not create a package tree file-by-file.

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