CLAUDE.md · diff

git:20260327.c55f0d5 to git:20260508.4249183

18 added, 8 removed. Audit A to A.

# Turbo
- Turbo is a modular collection of Claude Code skills — each skill teaches Claude a specific dev workflow. Skills connect into larger pipelines like `/finalize` and `/review-pr`. See [README.md](README.md) for the full overview and dependency graph.
+ Turbo is a modular collection of agentic coding skills with sibling editions for Claude Code and Codex. Skills connect into larger pipelines like `/finalize` and `/review-pr`. See [README.md](README.md) for the full overview and dependency graph.
## Project Structure
```
- skills/<skill-name>/
- ├── SKILL.md # Skill definition (YAML frontmatter + markdown body)
- ├── scripts/ # Optional supporting scripts
- ├── references/ # Optional reference documentation
- └── assets/ # Optional templates or boilerplate
+ claude/ # Claude Code edition (canonical Claude tree)
+ ├── skills/<skill-name>/
+ │ ├── SKILL.md # Skill definition (YAML frontmatter + markdown body)
+ │ ├── scripts/ # Optional supporting scripts
+ │ ├── references/ # Optional reference documentation
+ │ └── assets/ # Optional templates or boilerplate
+ ├── SETUP.md
+ ├── UPDATE.md
+ ├── MIGRATION.md
+ ├── ADDITIONS.md
+ └── SKILL-CONVENTIONS.md
+ codex/ # Codex edition (parallel tree)
```
Each skill is self-contained. Skills compose other skills to any depth via `/skill-name` invocations. The key distinction is between analysis skills (return structured findings without acting) and workflow skills (compose analysis skills and act on results).
- @SKILL-CONVENTIONS.md
+ @claude/SKILL-CONVENTIONS.md
## Key Files
- - `~/.turbo/config.json` — User-level configuration (repoMode, excludeSkills, lastUpdateHead, configVersion, oracle settings)
+ - `~/.turbo/config.json` — User-level configuration. Top-level `repoMode` and `oracle` are shared. Per-edition state lives under `claude.{excludeSkills, lastUpdateHead, configVersion}`; the parallel `codex.*` object is present when the Codex edition is also installed.
- `~/.turbo/repo/` — Local clone or fork of the turbo repo (skill source for install/update)
+ - `~/.claude/skills/` — Installed Claude Code skills
+
+ When working inside `claude/`, also see [`claude/CLAUDE.md`](claude/CLAUDE.md) for edition-specific rules.