PromptOps Plugin

Plugin de Claude Code para catalogacion de prompts AI y gestion de agentes.

Convierte una libreria de system prompts en comandos y agentes reutilizables.

---

Quick Start

# 1. Clonar el repositorio
git clone https://github.com/jaisenbe58r/promptops-plugin.git
cd promptops-plugin

# 2. Probar el plugin localmente
claude --plugin-dir .

# 3. Ver comandos disponibles
/help

# 4. Ejecutar guia rapida
/promptops:quickstart

---

Que es PromptOps?

graph LR
    A[Libreria de Prompts] --> B[PromptOps Plugin]
    B --> C[Catalogo Documentado]
    B --> D[Agentes Especializados]
    B --> E[Comandos Operativos]

    C --> F[PROMPTS_CATALOG.md]
    D --> G[10 Agentes]
    E --> H[11 Comandos]

PromptOps transforma una coleccion de prompts AI en un sistema organizado:

• Catalogo: Documentacion estructurada de 79+ prompts de 32 productos AI
• Agentes: 10 roles especializados (implementador, revisor, arquitecto, etc.)
• Comandos: Operaciones para desarrollo, release, docs y mantenimiento

---

Estructura del Plugin

graph TD
    subgraph Plugin
        A[.claude-plugin/plugin.json]
        B[commands/]
        C[agents/]
    end

    subgraph Documentacion
        D[docs/]
        E[README.md]
        F[CHANGELOG.md]
    end

    subgraph Contenido
        G[prompts/]
    end

    A --> B
    A --> C
    B --> D
    C --> D

promptops-plugin/
├── .claude-plugin/
│   └── plugin.json         # Manifiesto del plugin
├── agents/                  # 10 agentes especializados
│   ├── code-implementer.md
│   ├── code-reviewer.md
│   ├── planning-architect.md
│   └── ...
├── commands/                # 11 comandos operativos
│   ├── task.md             # Iniciar tarea
│   ├── ship.md             # Finalizar y PR
│   ├── bugfix.md           # Corregir bugs
│   ├── catalog.md          # Regenerar catalogo
│   └── ...
├── docs/                    # Documentacion
│   └── promptops/
│       ├── PROMPTS_CATALOG.md
│       ├── AGENT_GROUPS.md
│       └── INSTALL_PLUGIN.md
├── prompts/                 # 98 prompts de 32 productos AI
└── README.md

---

Comandos Disponibles

Desarrollo

| Comando | Descripcion | |---------|-------------| | /promptops:task | Inicia tarea con rama git | | /promptops:ship | Finaliza: commit, push, PR | | /promptops:bugfix | Flujo guiado para bugs | | /promptops:infra | Cambios de infraestructura |

Documentacion

| Comando | Descripcion | |---------|-------------| | /promptops:docs | Auditar y mantener docs | | /promptops:catalog | Regenerar catalogo de prompts | | /promptops:group | Regenerar grupos de agentes |

Mantenimiento

| Comando | Descripcion | |---------|-------------| | /promptops:promptops | Mantener el plugin | | /promptops:validate | Validar estructura | | /promptops:scaffold-plugin | Sincronizar agentes | | /promptops:quickstart | Guia de inicio |

---

Agentes Disponibles

graph TB
    subgraph Implementacion
        A[code-implementer]
        B[web-builder]
    end

    subgraph Revision
        C[code-reviewer]
        D[security-analyst]
    end

    subgraph Planificacion
        E[planning-architect]
        F[research-explorer]
    end

    subgraph Operaciones
        G[devops-deployer]
        H[debugging-specialist]
    end

    subgraph Documentacion
        I[documentation-writer]
        J[test-engineer]
    end

| Agente | Mision | |--------|--------| | code-implementer | Implementacion de codigo siguiendo convenciones | | code-reviewer | Revision de calidad y seguridad | | planning-architect | Diseno y planificacion de soluciones | | research-explorer | Exploracion y analisis de codebase | | security-analyst | Analisis de seguridad y vulnerabilidades | | web-builder | Desarrollo frontend y UI | | devops-deployer | Deployment e infraestructura | | documentation-writer | Documentacion tecnica | | debugging-specialist | Debugging sistematico | | test-engineer | Testing y QA |

---

Instalacion

Desarrollo Local (Recomendado)

# Probar el plugin desde el directorio
claude --plugin-dir /path/to/promptops-plugin

Instalacion Permanente

# Dentro de Claude Code
/plugin install /path/to/promptops-plugin

Troubleshooting

| Problema | Solucion | |----------|----------| | Comandos no aparecen | Reiniciar Claude Code | | Plugin no carga | Verificar plugin.json valido | | Errores de permisos | Verificar rutas absolutas |

---

Flujo de Trabajo

sequenceDiagram
    participant Dev as Developer
    participant Plugin as PromptOps
    participant Git as Git/GitHub

    Dev->>Plugin: /promptops:task nueva-feature
    Plugin->>Git: Crear rama feature/nueva-feature
    Plugin-->>Dev: Rama lista

    Dev->>Dev: Implementar cambios

    Dev->>Plugin: /promptops:ship
    Plugin->>Plugin: Verificar docs
    Plugin->>Plugin: Actualizar CHANGELOG
    Plugin->>Git: Commit + Push
    Plugin->>Git: Crear PR
    Plugin-->>Dev: PR creado

---

Ejemplos de Uso

Iniciar una feature

/promptops:task agregar-validacion-email

Corregir un bug

/promptops:bugfix
Archivo: src/parser.js
Repro: Llamar parse() con string vacio
Expected: Retorna null
Actual: Lanza excepcion

Regenerar catalogo de prompts

/promptops:catalog ./prompts

Validar estructura del plugin

/promptops:validate

---

Documentacion

| Documento | Contenido | |-----------|-----------| | docs/README.md | Portal de documentacion | | docs/promptops/PROMPTS_CATALOG.md | Catalogo de 79 prompts | | docs/promptops/AGENT_GROUPS.md | Definicion de agentes | | docs/promptops/INSTALL_PLUGIN.md | Guia de instalacion | | CONTRIBUTING.md | Como contribuir | | CHANGELOG.md | Historial de cambios |

---

Contribuir

Ver CONTRIBUTING.md para guias de contribucion.

# Fork y clone
git clone https://github.com/tu-usuario/promptops-plugin.git

# Crear rama
git checkout -b feature/mi-mejora

# Hacer cambios y commit
git commit -m "feat: descripcion"

# Push y crear PR
git push origin feature/mi-mejora

---

Licencia

MIT

---

Links

• Repositorio
• Issues
• Documentacion de Claude Code Plugins