cathrynlavery

Repo Atlas

Name: Repo Atlas
Author: cathrynlavery

AI community

SOURCE https://github.com/cathrynlavery/repo-atlas

Description

A Claude Code skill that builds a persistent context system (atlas) for any git repository — directory trees, entrypoints, architecture docs, and agent on-ramp for fast LLM onboarding.

Installation

This entry records only its repository, not the path inside it, so there is no exact command to give. Open the source below and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

README

Repo Atlas

A [Claude Code](https://claude.ai/code) skill that builds a **persistent context system** for any git repository — so engineers and LLM agents can understand your codebase fast with minimal searching.

Built by [@cathrynlavery](https://twitter.com/cathrynlavery) at [founder.codes](https://founder.codes)

What It Does

Run `/repo-atlas` in any project and it will:

Auto-generate a repo map with directory tree, entrypoints, file stats, and changelog
Guide you through writing architecture, domain model, critical flows, state sources, gotchas, and test docs
Add an agent on-ramp to your CLAUDE.md with a two-agent workflow (plan + verify)
Create build targets (make atlas-generate / make atlas-check) for CI integration

The result is a `docs/atlas/` folder with 10 structured docs that any engineer or AI agent can load for instant context.

Pair With Codex

After generating your atlas, use the [Codex skill](https://github.com/cathrynlavery/codex-skill) to get a second opinion. Codex will independently review your atlas docs for accuracy, gaps, and missed gotchas — giving you an automated quality check powered by OpenAI Codex.

/repo-atlas          # Build the atlas
/codex Review my atlas docs for accuracy and completeness

Supports

**Languages:** Python, JavaScript/TypeScript, Go, Rust, Swift, Java, Kotlin, C/C++, C#, PHP, Elixir, Dart

**Build systems:** npm, Cargo, Go modules, pip/pyproject, Gradle, Maven, XcodeGen, SPM, Bundler, CMake, Bazel, Earthly

**CI:** GitHub Actions, GitLab CI, CircleCI, Jenkins, Travis, Azure Pipelines, Bitbucket Pipelines, Cloud Build, CodeBuild

Install

Copy the skill into your Claude Code skills directory:

# Clone and copy
git clone https://github.com/cathrynlavery/repo-atlas.git
cp -r repo-atlas ~/.agents/skills/repo-atlas

# Or just copy the directory manually

Then in any project, say `/repo-atlas` or "map this repo" or "create atlas docs".