agentic-atlas
Profile agentic development approaches, frameworks, and skill collections on axes that can help you decide if it would work well for you or
Open source Open in the app JSON README (API)
About
Profile agentic development approaches, frameworks, and skill collections on axes that can help you decide if it would work well for you or your projects. It has a deterministic engine with an open rubric that is versioned and community driven. We provide hosted profiles of the popular workflows but we encourage you to experiment and improve the engine and rubric to keep this system objective and useful for everyone.
Details
- Kind
- Plugins
- Topic
- No topic detected
- Publisher
- adamcaviness
- Origin
- gemini
- Category
- ferramentas
- Version
- 0.2.0
- Open pull requests
- 2
- Last push
- 2026-09-07T18:35:33Z
- Repository state
- ativo
- Language
- HTML
- License
- MIT
- Added
- 2026-08-30 14:13:39
- Updated
- 2026-08-30 14:13:39
- Origin id
adamcaviness/agentic-atlas
README
<p align="center"><img src="docs/logo.svg" alt="Agentic Atlas" width="380"></p> An open profiler for agentic coding methodologies, built to help you find the ones that fit you and your projects. An "agentic methodology" is the plugin, framework, or skill collection you add to your coding harness (Claude Code, Cursor, Codex, Gemini CLI, etc). Popular examples include [Superpowers](https://github.com/obra/superpowers), [BMAD-METHOD](https://github.com/bmad-code-org/BMAD-METHOD), [GSD](https://github.com/jnuyens/gsd-plugin), [LFG](https://mcpmarket.com/tools/skills/lfg-autonomous-engineering-workflow), but Agentic Atlas can profile any framework, method, or skill collection. There's no single best agentic methodology, only a best fit for your project and how you like to work. Agentic Atlas shows you where each tool sits so you can pick. ## What it does Agentic Atlas reports what it sees, it doesn't grade, rank, or crown a winner, because every person and project has unique needs and collapsing independent axes into one number tells you nothing. It locates each tool on signed, diverging axes: `0.0` is neutral, the sign says which pole the tool leans toward, and the magnitude says how strongly. A tool at `-7.8` on Greenfield ↔ Brownfield isn't worse than one at `+2.0`, it is simply aimed at greenfield projects, and you are shown this to draw your own conclusions on fit. Each position is a deterministic function of small, named, evidence-backed indicators, every one cited to the target repository. So when you disagree with where a tool landed, trace it to the exact indicators behind it and open a pull request against the versioned rubric. The goal is for the rubric to be a community-maintained, open, and auditable standard for profiling agentic methodologies. See [`docs/design.md`](docs/design.md) for the architecture and [`docs/axes.md`](docs/axes.md) for the axis authoring method and the full candidate catalog. ## How an axis is scored An axis is a signed spectrum (negative/positive float) between two named poles, with a symmetric scale (default `10`, so scores run `-10` to `+10`). Neither pole is a failure mode. You never score an axis directly. It decomposes into indicators, each a narrow question with a bounded answer mapping to a value in `[-1, 1]` signed toward one pole. Two kinds: - **measured**: computed by the engine from the repository, no model (vocabulary density, file presence, git statistics, GitHub stars). Same input, same output. - **classified**: a model reads the repository and picks from a fixed answer set, backing the choice with a quote copied verbatim from the target. The engine rejects any answer whose quote it can't find, so nothing rests on an unverified claim. The score is then arithmetic, over resolved indicators, clamped to `[-scale, +scale]`: ``` axis_score = scale * sum(weight_i * value_i) / sum(weight_i) ``` Unresolved indicators are excluded and the profile reports coverage, so you never mistake a partial profile for a complete one. ## Axes in v1 A curated subset of the candidate catalog ships today; the full catalog is much larger, see [`docs/axes.md`](docs/axes.md). Heavily correlated axes dilute a profile rather than sharpen it, so the rest are backlog. | Axis (negative ↔ positive) | Meaning | |---|---| | **Interrogative ↔ Opinionated** | Elicits and asks vs prescribes a strong default path | | **Human-in-loop ↔ Autonomous** | Frequent checkpoints vs unattended autopilot | | **Greenfield ↔ Brownfield** | Excels from an idea vs excels inside an existing codebase | | **Small-scope ↔ Large-scope** | One task vs the whole delivery lifecycle | | **Prototype ↔ Production** | Fast throwaway output vs production hardening | | **Solo ↔ Team** | Single developer vs multi-contributor and team-safe | | **Generalist ↔ Specialist** | Any domain vs software delivery specifically | | **Fresh ↔ Mature** | New and fast-moving vs established and battle-tested | | **Spec-light ↔ Spec-driven** | Jumps to code vs plans and specs first | | **Test-optional ↔ Test-first** | Testing incidental vs TDD enforced | | **Single-agent ↔ Multi-agent** | One conversation vs specialized subagents or personas | | **Prescriptive ↔ Composable** | Fixed pipeline vs pick-and-choose parts | | **Lightweight ↔ Heavyweight** | Small footprint and little ceremony vs large and elaborate | Authoritative definitions live in `rubric/v1/`. ## Usage Everything runs through the Makefile. Run `make` to list targets. ```bash make setup # create the venv and install with dev deps make check # lint then test (the CI gate) make validate # validate the rubric against the schema make profile TARGET=/path/to/methodology FORMAT=md ``` The `agentic-atlas` CLI is available inside the venv: ```bash agentic-atlas validate rubric/v1 # check against the schema agentic-atlas docs rubric/v1 # regenerate axis README scoring blocks agentic-atlas profile /path/to/methodology # measured indicators, deterministic, no key agentic-atlas questions /path/to/methodology # emit the classified questions to answer agentic-atlas profile /path/to/methodology --answers answers.json # unlock classified indicators from answers agentic-atlas compare bmad-method superpowers gsd # (planned) overlay tools on the same axes ``` The engine is deterministic and needs no API key. A bare `profile` run resolves the **measured** indicators, the ones the engine computes directly from the repository, and reports how much of each axis that covers. The **classified** indicators, the ones that need the repository read and interpreted, are unlocked by supplying answers: `questions` lists them, an agent answers each with a value from its fixed set and a quote from the target, and `profile --answers` validates every answer (the quote must appear verbatim, the value must be one of the declared options) and scores the ones that pass. The engine never calls a model; it validates. The intended answerer is the `run` skill of the `agentic-atlas` plugin. Its host agent is already a capable model with repo access, so it answers the classified questions and feeds them back, no key required. Running the engine raw gives you the deterministic measured axes; running it through the skill unlocks the rest. ## Plugin installation The plugin ships three skills. Install from [agentic-marketplace](https://github.com/adamcaviness/agentic-marketplace); pick **one** path per harness. - `/agentic-atlas:run [path-or-git-url]` profiles a target and unlocks the classified axes (the flow described above). - `/agentic-atlas:open-explorer` opens the hosted **Explorer** at <https://adamcaviness.github.io/agentic-atlas/>, where ready-made profiles of popular methodologies let you browse and find your fit without running anything yourself. - `/agentic-atlas:explain [question]` explains the method and helps you read a profile, grounded in these docs and the rubric, upholding the no-ranking, no-aggregate-score stance. <details> <summary>Claude Code</summary> ```bash /plugin marketplace add adamcaviness/agentic-marketplace /plugin install agentic-atlas@agentic-marketplace ``` </details> <details> <summary>Cursor</summary> See [.cursor/INSTALL.md](.cursor/INSTALL.md). If you already installed via Claude Code, stop there. Cursor-only: clone into `~/.cursor/plugins/local/agentic-atlas`. Teams admins import the marketplace from [cursor.com/dashboard](https://cursor.com/dashboard). </details> <details> <summary>Codex / ChatGPT desktop</summary> See [.codex/INSTALL.md](.codex/INSTALL.md). In ChatGPT desktop: **Plugins → Add plugin marketplace**. Source `adamcaviness/agentic-marketplace`, Git ref `main`, Sparse paths empty. Then install **agentic-atlas**. ```bash codex plugin marketplace add adamcaviness/agentic-marketplace --ref main codex plugin add agentic-atlas@agentic-marketplace ``` </details> ## Reproducibility and fairness The rubric (`rubric/`) is versioned data (axes, poles, indicators, weights) and the engine (`agentic_atlas/`) is the code that reads it, each under its own semver. See [`docs/versioning.md`](docs/versioning.md). Every profile stamps the rubric version, engine version, target commit SHA, and, for classified indicators, the source of each supplied answer, so any profile is reproducible and arguable. I also maintain [agentic-toolkit](https://github.com/adamcaviness/agentic-toolkit), which is itself a target and gets profiled with the same rubric and engine as everything else, no special treatment. I built this tool specifically so I could evaluate my own work and get a picture on where it best fits. ## Status Early scaffold, actively developed. Working today: the per-axis rubric with schema validation, the deterministic scoring core, evidence collectors (vocabulary, path presence, git stats, GitHub API), the classified-indicator seam (a `questions` worklist plus a quote-verified `--answers` path, no API key), text/markdown/JSON/HTML reports, the `agentic-atlas docs` generator kept in sync by `make docs-check`, the three plugin skills (`run`, `open-explorer`, `explain`), a committed corpus of 18 profiles under `profiles/`, and the hosted **Explorer** built from that corpus by `scripts/build_site.py` and deployed to GitHub Pages. Next: the `compare` overlay and a wider corpus. See `docs/` and `specs/handoff.md`. ## License MIT. See `LICENSE`.