mefisto

mefisto

Repositorio: eda-evsourcing-azure-harness · Nombre del plugin: mefisto

Plugin de Claude Code que provee un harness opinionado para construir aplicaciones .NET 10 serverless en Azure con Event Driven Architecture y Event Sourcing.

Estado: v0.1.0 (internal alpha) — extraído del proyecto Bitakora.ControlAsistencia el 2026-05-15. La API del harness puede cambiar entre versiones menores hasta v1.0.0.

El nombre

mefisto es un guiño a Mefistófeles, el espíritu de Fausto de Goethe. La analogía es simple: quien invoca el harness encarna a Fausto — fija la intención y firma el pacto —; el plugin, como Mefisto, ejecuta esa voluntad bajo las reglas del marco (EDA, Event Sourcing, Azure Functions, TDD).

«Ich will mich hier zu deinem Dienst verbinden, auf deinen Wink nicht rasten und nicht ruhn».

— Mefistófeles, Fausto I, escena «Studierzimmer», vv. 1656-1657

«Aquí me ataré a tu servicio, a tu menor seña no descansaré ni cesaré».

Qué incluye

• 14 skills (slash commands): /implement, /tooling, /infra, /scaffold, /parallel, /sequential, /bug, /draft, /fix-review, /health-check, /work-status, /show-flow, /eraser-diagram, /merge.
• 16 agentes especializados: planner, test-writer, implementer, reviewer, smoke-test-writer, domain-scaffolder, eda-modeler, event-stormer, historiador, infra-writer, infra-reviewer, infra-applier, infra-bootstrap, pr-sync, bug-investigator, tooling-investigator.
• Pipelines bash que orquestan el ciclo TDD, IaC y tooling sobre tmux y git worktree.
• 18 ADRs del marco arquitectónico.
• Hooks para logging del pipeline.

Stack supuesto en el consumidor

• .NET 10 + Azure Functions isolated worker
• Marten (event store) + Wolverine (mediador) sobre PostgreSQL
• Azure Service Bus (topic por evento)
• xUnit v3 + Cosmos.EventSourcing.Testing.Utilities
• Terraform para IaC
• GitHub Actions para CI/CD

Si tu proyecto no encaja con este stack, este harness no es para ti.

Instalación

1. Registrar el marketplace en .claude/settings.json del repo consumidor

{
  "extraKnownMarketplaces": {
    "augusto-romero-arango-harness": {
      "source": {
        "type": "github",
        "repo": "augusto-romero-arango/eda-evsourcing-azure-harness"
      }
    }
  }
}

2. Instalar el plugin (desde Claude Code)

/plugin marketplace add augusto-romero-arango-harness
/plugin install mefisto@augusto-romero-arango-harness

3. Configurar el consumidor

Crea .claude/harness.config.json en la raíz del proyecto consumidor:

{
  "projectName": "MiProyecto",
  "namespacePrefix": "MiOrg.MiProyecto",
  "solutionFile": "MiProyecto.slnx",
  "infraResourceGroupPrefix": "rg-miproyecto",
  "terraformStateStorage": "stmiproyectotfstatedev",
  "githubServicePrincipalName": "github-miproyecto-ci",
  "appInsightsApp": "miproyecto-dev-ai",
  "domainLabels": ["dominio1", "dominio2"]
}

Y añade una sección a CLAUDE.md raíz del consumidor declarando los tokens:

### Tokens del harness

- **RootNamespace**: MiOrg.MiProyecto
- **SolutionFile**: MiProyecto.slnx
- **ProjectDisplayName**: MiProyecto

4. Verificar instalación

/mefisto:show-flow
/mefisto:work-status

Si responden sin errores, está listo.

Uso

Los skills aparecen con el namespace del plugin: /mefisto:implement <issue>, /mefisto:scaffold <dominio>, etc.

Flujo típico:

/draft "registrar marcaciones biométricas"     # captura idea como issue borrador
# planner refina el issue a estado:listo
/implement <issue>                              # pipeline TDD
# pr-sync mergea el PR

Estructura del plugin

.claude-plugin/
  plugin.json          # metadata (name, version, author)
  marketplace.json     # catálogo
commands/              # skills publicados (los que ve el consumidor)
agents/                # agentes publicados
scripts/               # pipelines + utilidades bash publicadas
hooks/hooks.json       # PostToolUse para logging
.claude/               # skills/agentes/pipelines INTERNOS (no se publican)
  commands/            # /mefisto-tooling, /mefisto-plan, /mefisto-bug, ...
  agents/              # mefisto-investigator, mefisto-planner
  scripts/             # _mefisto-common.sh, mefisto-tooling-pipeline.sh, ...
docs/
  adr/                 # ADRs del marco
  tmux-cheatsheet.md
  testing/harness-cheatsheet.md
CLAUDE.md              # documentación viva para Claude Code
CHANGELOG.md

Desarrollo del propio plugin

Si vas a evolucionar Mefisto (este repo), no instales el plugin sobre sí mismo. Claude Code carga automáticamente los skills internos desde .claude/commands/ y .claude/agents/ del repo activo (separadamente del plugin distribuido).

Skills internos disponibles (todos con prefijo mefisto-):