Metadata-Version: 2.4
Name: argosai
Version: 0.1.1
Summary: ArgosAI — framework agnóstico de agente (Claude, Codex) para desarrollar con IA de forma ordenada: spec-driven development, bugfixing documentado y diseño frontend con Figma MCP.
Author: Alex
License: MIT
Project-URL: Homepage, https://github.com/alexlpz/ArgosAI
Project-URL: Repository, https://github.com/alexlpz/ArgosAI
Project-URL: Issues, https://github.com/alexlpz/ArgosAI/issues
Keywords: ai-agents,claude,codex,spec-driven-development,framework
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.9
Description-Content-Type: text/markdown

# argosai

Instalador de línea de comandos para **ArgosAI**: un framework agnóstico de agente (Claude,
Codex) para desarrollar software con IA de forma ordenada — spec-driven development, bugfixing
documentado con causa raíz y verificación, y diseño frontend conectado opcionalmente al Figma
Dev Mode MCP server.

Funciona igual que herramientas como `specify` (spec-kit) o el CLI de RAISE: se instala una vez
como paquete de Python y luego se usa el comando `argosai` dentro de cualquier proyecto, nuevo o
ya avanzado.

**Manual completo:** [`docs/MANUAL.md`](docs/MANUAL.md) — instalación, los cuatro flujos de
trabajo, referencia completa de comandos, monorepo, CI/hooks, costos, y todo lo demás. Este
README es solo el quickstart.

## Instalación

Desde el código fuente de este paquete (aún no publicado en PyPI):

```bash
pip install .
# o, para desarrollo/edición del propio framework:
pip install -e .
```

Una vez publicado en PyPI (paso que requiere tu cuenta, ver más abajo), sería simplemente:

```bash
pip install argosai
```

## Uso

```bash
# Proyecto nuevo o ya existente — instala AGENTS.md, CLAUDE.md, skills, plantillas, carpetas
argosai init /ruta/a/tu/proyecto
argosai init .            # o directo en el proyecto donde ya estás parado

# Volver a instalar sobre archivos ya existentes (excepto constitution.md, que nunca se pisa)
argosai init . --force

# Crear una nueva feature (spec.md numerado y con slug automático)
argosai new-feature "login social"

# Crear un nuevo bug (report.md)
argosai new-bug "el checkout no hace nada en Safari"

# Crear un nuevo esfuerzo de diseño (design-brief.md)
argosai new-design "rediseño del onboarding"

argosai --version
argosai --help
```

Después de `argosai init`, si el proyecto ya tiene código, dile a tu agente (Claude o Codex):

> "Corre el skill argos-onboard para analizar este proyecto."

## Configurar tu agente por defecto (para no repetir --agent siempre)

```bash
# Una sola vez — aplica a todos tus proyectos
argosai config set-agent claude

# Si un proyecto puntual necesita el otro agente, se sobreescribe solo ahí
argosai config set-agent codex --project

# Ver qué queda configurado (global, de proyecto, y el valor efectivo)
argosai config show

# Opcional: que run/ideate ya no pidan --yes tampoco (pierdes el freno del dry-run por defecto)
argosai config set-yes true
```

Con esto, en el día a día:

```bash
argosai run implement 003-user-auth --yes
argosai run review 003-user-auth --agent codex --yes   # revisión cruzada: explícito cuando quieras el otro agente
argosai ideate "una app para..." --yes
```

Orden de resolución: `--agent`/`--yes` explícitos en el comando > variables de entorno
`ARGOSAI_AGENT` / `ARGOSAI_YES` > `.argos/config/settings.json` del proyecto >
`~/.argosai/config.json` global. Si nada de eso está configurado, `argosai run`/`ideate` te lo
dicen claramente en vez de fallar en silencio. `--dry-run` fuerza el modo seguro para una sola
llamada aunque tengas `auto_yes` activado por defecto.

## Qué instala `argosai init`

```
AGENTS.md              ← instrucciones canónicas (Codex las lee nativo)
CLAUDE.md                ← apuntador a AGENTS.md (Claude lo lee nativo)
.argos/
  memory/constitution.md    ← plantilla de principios del proyecto (no se pisa si ya existe)
  memory/patterns.md        ← log corto de cosas ya aprendidas
  templates/                 ← spec, plan, tasks, bug-report, bug-fix-plan, design-brief, adr,
                                review, audit, analyze
  config/agents-setup.md    ← cómo queda conectado con Claude y Codex
.claude/skills/            ← 12 skills para Claude Code
.agents/skills/              ← mismas 12 skills, para Codex CLI
specs/  bugs/  design/  audits/  docs/  ← carpetas de trabajo vacías, listas para usarse
```

A diferencia de la versión de "copiar carpetas" del framework, aquí los skills viven en un solo
lugar dentro del paquete instalado — `argosai init` los copia a ambas rutas (`.claude/skills` y
`.agents/skills`) automáticamente en cada instalación, así que no hay riesgo de que se
desincronicen entre Claude y Codex. Re-correr `argosai init --force` actualiza esos archivos a
la versión más reciente sin pisar nunca tus personalizaciones (ver sección 14 del manual).

## Más allá del quickstart

El CLI también trae: `argosai lint` (chequeos deterministas de consistencia), `argosai
dashboard` (snapshot visual en HTML), `argosai hooks install/ci` (git pre-commit y GitHub
Actions, opt-in), `argosai costs` (log de $ y tokens por corrida), soporte de monorepo
(`--package` en `new-feature`/`new-bug`/`new-design`), lock de ejecución concurrente, y un ciclo
de revisión con escalación automática si `argos-review` se atora. Todo documentado con ejemplos
en [`docs/MANUAL.md`](docs/MANUAL.md).

## Publicar en PyPI (cuando quieras)

Este paquete está listo para publicarse tal cual. Cuando quieras que `pip install argosai`
funcione desde cualquier lado:

```bash
pip install build twine
python -m build
twine upload dist/*
```

`twine upload` te pedirá tu usuario/token de PyPI — eso solo lo puedes hacer tú, con tu cuenta.
Antes de publicar, confirma que el nombre `argosai` sigue disponible en pypi.org (nombres se
apartan por orden de llegada).

## Desarrollo

El código del CLI vive en `src/argosai/cli.py`. Las plantillas y skills que se copian a cada
proyecto están en `src/argosai/resources/` — edítalas ahí, no en un proyecto ya instalado, para
que la próxima versión del paquete las propague a todos.
