bax-local

BAX Dev Plugin

Plugin del comando /bax para el workflow estándar de desarrollo BAX. Soporta Claude Code y Cursor.

Qué hace

El comando /bax gestiona el ciclo completo de desarrollo:

/bax [BAX-123]
      │
      ▼
[FASE 1] Asociar issue ──► Assignee ──► In Progress ──► Setup de rama
      │
      │   (dev codea)
      │
      ▼
[FASE 2] Commits ──► PR ──► Linear (Ready for QA) ──► Resumen ✅

Requisitos

• MCP oficial de Linear configurado (ver sección de cada editor)
• gh CLI autenticado en bax-exchange
• git configurado en el repo correspondiente

⚠️ Seguridad: Usá SOLO el servidor MCP oficial de Linear (https://mcp.linear.app/mcp). No uses paquetes npm de terceros ni servidores MCP de la comunidad — evitá dar tus credenciales a código no verificado.

---

Configuración del MCP de Linear

El servidor oficial de Linear usa OAuth — no necesitás API keys ni tokens en la configuración. La primera vez que te conectés, se va a abrir el browser para que autorices la conexión con tu cuenta de Linear.

Claude Code

claude mcp add Linear --transport http https://mcp.linear.app/mcp

Cursor

Agregá en tu .cursor/mcp.json (o instalá desde https://linear.app/docs/mcp):

{
  "mcpServers": {
    "Linear": {
      "url": "https://mcp.linear.app/mcp"
    }
  }
}

---

Instalación — Claude Code

# 1. Clonar este repo
git clone https://github.com/bax-exchange/bax-claude-plugin.git ~/bax-claude-plugin

# 2. Registrar el marketplace local
claude plugin marketplace add bax-local ~/bax-claude-plugin

# 3. Instalar el plugin
claude plugin install bax@bax-local

---

Instalación — Cursor

Opción A: Script automático

# 1. Clonar este repo (si no lo tenés)
git clone https://github.com/bax-exchange/bax-claude-plugin.git ~/bax-claude-plugin

# 2. Ejecutar el instalador
cd ~/bax-claude-plugin
./cursor/install.sh

El script:

1. Copia cursor/commands/bax.md → ~/.cursor/commands/bax.md
2. Te pide tu email de Linear y lo guarda en ~/.cursor/rules/bax-user.mdc

Opción B: Manual

El comando /bax en Cursor es simplemente un archivo .md dentro de la carpeta commands. Podés copiarlo vos mismo:

# Global (disponible en todos los proyectos)
mkdir -p ~/.cursor/commands
cp cursor/commands/bax.md ~/.cursor/commands/bax.md

# O por proyecto (solo disponible en ese repo)
mkdir -p <tu-proyecto>/.cursor/commands
cp cursor/commands/bax.md <tu-proyecto>/.cursor/commands/bax.md

Para que el comando recuerde tu email de Linear sin preguntarte cada vez, creá ~/.cursor/rules/bax-user.mdc:

---
description: BAX user identity for /bax workflow
alwaysApply: true
---
linear_email: [email protected]

---

Uso

/bax            # Flujo interactivo — pregunta por el issue al inicio
/bax BAX-123   # Inicia directamente con el issue BAX-123

Flujo detallado

FASE 1 — Antes de codear

1. Asociar issue de Linear — Busca y muestra el issue, valida formato BAX-XXX
2. Assignee — Verifica quién está asignado y ofrece autoasignarse
3. In Progress — Pregunta si mover el issue a In Progress
4. Setup de rama — Diagnostica el estado del repo y crea la rama desde development

FASE 2 — Después de codear

1. Commits — Guía con Conventional Commits según el label del issue
2. Pull Request — Crea el PR contra development con el formato correcto
3. Actualizar Linear — Appendea solución + test cases al issue y lo mueve a Ready for QA
4. Resumen final — Muestra rama, URL del PR y link al issue

Convenciones

Nombre de rama:

username/bax-267-descripcion-corta

Commit:

fix(BAX-267): descripción breve en minúscula
feat(BAX-301): descripción breve en minúscula

Labels → tipo de commit:

Label Linear	Tipo
Bug	fix
Feature	feat
Improvement	refactor o feat

Diferencias entre editores

El workflow es idéntico en ambos editores. Las únicas diferencias son internas:

Aspecto	Claude Code	Cursor
MCP tool prefix	mcp__claude_ai_Linear__	mcp_Linear_
Email storage	MEMORY.md del proyecto	~/.cursor/rules/bax-user.mdc
Instalación	claude plugin install	Copiar .md a ~/.cursor/commands/

Actualizaciones

cd ~/bax-claude-plugin
git pull

# Si usás Cursor, volver a correr el instalador:
./cursor/install.sh

Estructura del repo

bax-claude-plugin/
├── .claude-plugin/              # Claude Code marketplace config
│   └── marketplace.json
├── plugins/                     # Claude Code plugin
│   └── bax/
│       ├── .claude-plugin/plugin.json
│       └── commands/bax.md
├── cursor/                      # Cursor command
│   ├── commands/
│   │   └── bax.md
│   └── install.sh
└── README.md