Monorepo and tooling

Skill martian56/claude-engineer/plugins/claude-engineer/skills/monorepo-and-tooling

Claude Code marketplace and home of claude-engineer: an opinionated, design-system-first, plan-gated autonomous engineer for full greenfield React/Next and FastAPI projects.

Install

npx -y skills add martian56/claude-engineer --skill monorepo-and-tooling

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

2 stars2 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Use when scaffolding a project's repository or adding a new app/package/service, to set up the polyglot monorepo (JS + Python) with shared packages, workspaces, and task orchestration. Run early in Phase 0.

SKILL.md

2.0 KB, as published. Nobody here has run it

Monorepo & Tooling

Announce at start: "I'm using claude-engineer:monorepo-and-tooling to lay out the polyglot monorepo."

The layout (always a monorepo)

One repo, two dependency graphs side by side:

JS side - apps/* (React/Next frontends) + packages/* (ui, config, eslint-config, tsconfig), managed by pnpm (default) or Bun workspaces + Turborepo for caching/task orchestration.
Python side - services/* (FastAPI) + libs/* (shared libs) as uv workspace members sharing one uv.lock.
Bridge - give each Python service a thin package.json whose scripts shell out to uv, so Turborepo is the single task vocabulary across both languages.

Defaults & decisions

JS package manager: ask per project (Bun vs pnpm). Default pnpm for stability unless the user prefers Bun.
Shared packages/ui holds the design-system components; packages/config holds Tailwind/token config.
Root config: turbo.json, pnpm-workspace.yaml (or Bun workspaces), pyproject.toml (uv workspace), root tsconfig/eslint base.

Non-negotiables

Shared code is a package, not copy-paste - design tokens, UI, types, configs live once and are imported.
Tasks run through Turborepo (dev, build, lint, typecheck, test) for caching and one vocabulary.
App runs native; services in Docker (claude-engineer:docker-dev-environment).

Full detail (concrete directory tree, root config files, workspace wiring, pnpm-vs-Bun trade-offs): read references/polyglot-monorepo.md on demand.

Red flags - STOP

Duplicated component/token/type code across apps → extract to a packages/*.
Running tasks ad-hoc per app instead of through Turborepo.
A single-language repo when the project will clearly have both a frontend and a FastAPI backend.