PROMPTS

Prompts &
Agentes Expertos

Sesiones guiadas con IA para explorar y contribuir a la codebase
Cada prompt genera un agente especializado que se adapta al contexto del proyecto
heteronimos-semi-asistidos-sdk · v0.0.0

☞ ¿Cómo funciona?

Los prompts de este proyecto son plantillas de personalidad para agentes de IA. Cuando invocas un prompt, el agente se caracteriza según la información que le proporcionas: adopta un rol, analiza la codebase desde esa perspectiva y guía una sesión interactiva contigo.

El truco: puedes agregar lore y datos extra al final del prompt para que el agente se especialice aún más. Sin datos extra, actúa como codebase owner general. Con datos extra (ej. contexto de un componente, un artículo, un rol concreto), el agente se adapta y acota sus respuestas a esa información.

Uso en VS Code / GitHub Copilot:
.github/prompts/*.prompt.md → invócalos desde el chat con @workspace /hacker-devops o referencia el archivo y pega contexto adicional al final.

Uso con cualquier agente (Claude, ChatGPT, etc.):
Copia el contenido del .prompt.md, pégalo como system prompt o primer mensaje, y añade debajo tu lore/datos extra.
1Prompts
5Fases
Roles
+lorePersonalizable
★ FLAGSHIP

🔧 hacker-devops

.github/prompts/hacker-devops.prompt.md
Inicia una sesión interactiva asumiendo el rol de un hacker DevOps experimentado con actitud asertiva, crítica pero constructiva, que acaba de descubrir esta codebase. Analiza las puertas de entrada del proyecto (README + GH Pages), cruza documentación con realidad (git log, barrel, backlog) y guía la mejora paso a paso.
⚡ Clave: el prompt acepta información extra al final. Sin ella, el agente procede como codebase owner general. Con lore adicional (artículos, contexto de un componente, rol específico, datos técnicos), el agente se especializa y acota sus análisis a esa información.

Fases de la sesión

  1. La Revisión Inquisitiva — Analiza la puerta de entrada (README, GH Pages) y cruza con barrel + backlog
  2. Adaptación y Refactorización (DRY) — El usuario asigna un rol; rescaneo desde esa perspectiva
  3. Definición del Plan de Ataque — Localiza tareas en BACKLOG.md y propone iniciativa concreta
  4. El Offboarding / Salida Limpia — Valida que la codebase explica cómo probar, compilar y salir
  5. El Cierre Definitivo — Aplica mejoras acordadas, actualiza backlog, cierra sesión

Fuentes de verdad que consulta

BACKLOG.md specs/ git log src/index.ts examples/
☞ Ver ejemplo de uso con lore extra
# 1. Invoca el prompt en el chat de tu IDE @workspace /hacker-devops # 2. O copia el prompt y añade lore al final: [contenido de hacker-devops.prompt.md] ## Información adicional para esta sesión Quiero que te centres en el subsistema de menus del SDK. Aquí está el contexto relevante: - El menu-handler soporta paginación inline - Hay un spec en specs/05-console-ui.md - El backlog tiene tareas pendientes relacionadas Tu rol: QA especialista en UX de bots
Resultado: el agente arranca como un QA de UX especializado en el subsistema de menús, cruza la implementación real con los specs y el backlog, y guía la sesión acotado a ese contexto.
☞ VER PROMPT COMPLETO EN GITHUB

☞ Agentes Expertos en la Codebase

Configuraciones pre-armadas del prompt hacker-devops con lore específico para cada área.
🏗 Arquitecto SDK
Especializado en specs/ SDS-00 a SDS-03
PRÓXIMAMENTE
🧪 QA Tester
Foco en tests/, criterios de aceptación
PRÓXIMAMENTE
📦 Plugin Developer
Guía para crear BotPlugins
PRÓXIMAMENTE
📊 Dashboard Builder
Foco en examples/dashboard/ y TUI
PRÓXIMAMENTE

☞ Cómo Crear tu Propio Prompt

1. CREA EL ARCHIVO
touch .github/prompts/mi-agente.prompt.md
2. AÑADE EL FRONTMATTER
# .github/prompts/mi-agente.prompt.md --- name: mi-agente description: "Descripción corta del rol." --- Tu prompt aquí. Define la personalidad, las fuentes de verdad que debe consultar, y las fases de la sesión.
3. USA EL PROMPT
# En VS Code con Copilot Chat @workspace /mi-agente # O cópialo y pégalo en cualquier agente # añadiendo lore al final para especializar
Tip: Reutiliza la estructura de fases de hacker-devops como base y personaliza las fuentes de verdad según tu área de interés.

Keywords

prompts agentes hacker-devops lore roles sesiones guiadas codebase review DRY