atlas

atlas

Atlas is a self-configuring Claude Code plugin that turns any coding agent into a disciplined multi-agent architect. Run /atlas once to onboard a project, then drive work through the 20 auto-trigger skills and the atlas:<role> subagent squad. A SessionStart hook loads the runtime every session, and four self-improvement hooks (memory capture, auto-skill, nudge, session ingest) make the agent better the more it is used in a codebase (plugins/atlas/skills/atlas/SKILL.md:10, plugins/atlas/README.md:3-9, plugins/atlas/hooks/hooks.json:1-7).

The marketplace is published from this repo at .claude-plugin/marketplace.json (Claude Code, name atlas, version 3.0.0, .claude-plugin/marketplace.json:1-3) and at .kimi-plugin/marketplace.json (Kimi Code CLI, version 2, .kimi-plugin/marketplace.json:1-2). The Claude Code manifest currently ships two plugins: atlas and the optional armada org-deployment plugin (.claude-plugin/marketplace.json:18,28). The Kimi manifest ships the same two plugins (atlas, armada) from .kimi-plugin/marketplace.json.

Two separate version counters, not a typo: the marketplace wrapper above (3.0.0) versions the catalog file itself; the atlas plugin it lists versions independently at 5.1.1 (plugins/atlas/.claude-plugin/plugin.json:3). Both numbers moved in the same commit (ad7313c: marketplace 2.0.0 -> 3.0.0, plugin -> 5.0.0) but on unrelated scales, so every v5.x reference later in this README is the plugin version, never the marketplace version.

A separate armada plugin in this repo carries 11 department agents and 156 department skills for org deployment; install it alongside atlas only for org use (plugins/atlas/README.md:8-10, plugins/atlas/.claude-plugin/plugin.json:3).

Quickstart

1. Add this repo as a marketplace in Claude Code: open the marketplace .claude-plugin/marketplace.json via the /plugin command.
2. Install the atlas plugin from the marketplace (install armada too if you want the department skills).
3. In a project, type /atlas once. The atlas-setup skill scaffolds docs/ (plus .atlas/ internal state), verifies or installs claude-mem and context-mode, wires hooks, and recommends the next step (plugins/atlas/skills/atlas/SKILL.md:24-64, plugins/atlas/skills/atlas-setup/SKILL.md:78-111).
4. For a coding task, type the name of the skill you want (for example atlas-feature to build a feature, atlas-debug to root-cause a bug, atlas-audit to run a code or architecture audit). The 20 non-setup skills auto-trigger from the description field; you can also name them directly (plugins/atlas/skills/atlas-setup/SKILL.md:150-162).

Prerequisites

• Claude Code (Kimi Code CLI is also supported via the alternate marketplace manifest at .kimi-plugin/marketplace.json).
• Python 3, used by all 11 hooks and the scripts/ tooling (plugins/atlas/hooks/hooks.json).
• claude-mem and context-mode are required companions. atlas-setup detects them and offers to install if missing; do not install silently (plugins/atlas/skills/atlas/SKILL.md:24-32).
• No system-level package manager install is needed for atlas itself. The vendor MCP servers under mcp_servers/ are not part of the active marketplace and require their own setup; see .env.template if you use any of them.

Project structure

Top-level layout, one line each, every entry verified on disk: