MinervaStack - OpenCode Atlas Plugin

MinervaStack is a Spec-Driven Development suite of reusable AI tools, skills, plugins, and agents designed to integrate into any project with minimal setup.

Atlas is a Spec-Driven Development plugin for OpenCode. By defining your project's directory tree, files, and templates in a .atlasrc.kdl schema, AI agents gain instant awareness of your codebase structure — making context-aware assistance seamless.

Quick Start

Prerrequisitos

• Bun >= 1.0 — Atlas usa Bun nativo (Bun.file, Bun.argv)
• OpenCode (solo si usas el plugin) — configurado en tu proyecto

CLI global

bun install -g @minervastack/opencode-atlas
minerva-atlas tree [--depth N]

Plugin OpenCode

Añádelo en la configuración de OpenCode a nivel de proyecto (.opencode/opencode.json o .opencode/opencode.jsonc) o a nivel global (~/.config/opencode/opencode.json):

{
  "plugins": ["@minervastack/opencode-atlas"]
}

Crea tu primer .atlasrc.kdl

atlas name="mi-proyecto" version="1" {
  file "README.md"
  directory "src" {
    file "index.ts"
  }
  directory "tests" {
    file "index.test.ts"
  }
}

Visualiza el árbol

minerva-atlas tree

Salida:

mi-proyecto/
├── README.md
├── src/
│   └── index.ts
└── tests/
    └── index.test.ts

Úsalo en OpenCode

El agente AI tiene disponible el tool atlas_tree. Cuando le pidas trabajar en el proyecto, puede invocarlo automáticamente para conocer la estructura esperada y generar código coherente con ella. También puedes pedírselo explícitamente:

"Lee la estructura del proyecto con atlas_tree"

Authors

• Alejandro Alonso Mayo — Creator & Lead Maintainer
  • Codeberg: https://codeberg.org/aalonsomayo
  • Email: [email protected]

License

This project is distributed under the MIT License.