# Tooling

> Use when changing package management, workspace config, build scripts, generated outputs, Turborepo/Lerna config, or local validation in aa-sdk.

- Skill: `alchemyplatform/tooling` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add alchemyplatform/tooling`
- Raw SKILL.md: https://api.skillmd.com/api/skills/alchemyplatform/tooling/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: alchemyplatform (https://skillmd.com/u/alchemyplatform)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/alchemyplatform/tooling

---


# Tooling

aa-sdk is a pnpm workspace on `main` (v5 SDK; graduated from `v5.x.x`) with
Turborepo for build/test graphs and Lerna for package versioning/publish. The
legacy v4 SDK lives on `v4.x.x` and only receives backports.

## Rules

| Rule                                                            | When to read                                                                |
| --------------------------------------------------------------- | --------------------------------------------------------------------------- |
| [Package manager and build](rules/package-manager-and-build.md) | Before changing scripts, dependencies, workspace config, or build commands. |
| [Tracked tree only](rules/tracked-tree-only.md)                 | Before auditing or generating guidance from repository contents.            |
| [Generated output policy](rules/generated-output-policy.md)     | Before editing generated outputs or files produced by build/doc scripts.    |

## Evidence

- `package.json` declares `packageManager: pnpm@9.15.4` and root scripts.
- `pnpm-workspace.yaml` lists `templates/*`, `.vitest`, `halp`, and `packages/*`.
- `turbo.json` defines build and test task graph behavior.
- `lerna.json` lists the four published packages and the current stable v5 version.