epieczko-betty

**Betty agents are Claude Code plugins.** You do not invoke agents via standalone CLI commands (`betty` or direct Python scripts). Instead:

Orchestrates AI/ML workflows including model training, evaluation, and deployment

**api.analyzer** is a specialized agent that analyzes API specifications for backward compatibility and breaking changes between versions.

An agent that designs comprehensive REST APIs and validates them against best practices. Takes API requirements as input and produces validated OpenAPI specifications with generated data models ready for implementation.

**api.designer** is an intelligent agent that orchestrates the API design process from natural language requirements to validated, production-ready OpenAPI specifications with generated models.

Orchestrates complete API lifecycle from design through testing and deployment

Analyzes code changes and provides comprehensive feedback on code quality, security vulnerabilities, performance issues, and adherence to best practices.

Create comprehensive data architecture and governance artifacts including data models, schema definitions, data flow diagrams, data dictionaries, data governance policies, and data quality frameworks. Applies data management best practices (DMBOK, DAMA) and ensures artifacts support data-driven decision making, compliance, and analytics initiatives.

Orchestrates data workflows including transformation, validation, and quality assurance

Validates data files against schemas, business rules, and data quality standards. Ensures data integrity, completeness, and compliance.

Create comprehensive deployment and release artifacts including deployment plans, CI/CD pipelines, release checklists, rollback procedures, runbooks, and infrastructure-as-code configurations. Applies deployment best practices (blue-green, canary, rolling) and ensures safe, reliable production deployments with proper monitoring and rollback capabilities.

Processes files through various transformations including format conversion, compression, encryption, and batch operations.

Create comprehensive program and project governance artifacts including project charters, RAID logs (Risks, Assumptions, Issues, Decisions), decision logs, governance frameworks, compliance matrices, and steering committee artifacts. Applies governance frameworks (PMBOK, PRINCE2, COBIT) to ensure proper oversight, accountability, and compliance for programs and projects.

The meta-agent that creates other agents through skill composition.

THE single source of truth for all artifact type definitions in Betty Framework.

Creates complete, production-ready command manifests from natural language descriptions.

Analyzes agent compatibility and discovers multi-agent workflows based on artifact flows.

Configure Claude Code Router for Betty to support multi-model LLM routing across environments. This agent creates or previews a `config.json` file at `~/.claude-code-router/config.json` with model providers, routing profiles, and audit metadata.

The intelligent orchestrator for creating Betty skills, commands, and agents from natural language descriptions.

Generates Claude Code hooks from natural language descriptions.

Generates complete Betty skills from natural language descriptions.

Helps Claude decide what to do next after an agent completes by analyzing context and suggesting compatible next steps.

Orchestrates operational workflows including builds, deployments, and monitoring

Create comprehensive security architecture and assessment artifacts including threat models, security architecture diagrams, penetration testing reports, vulnerability management plans, and incident response plans. Applies security frameworks (STRIDE, NIST, ISO 27001, OWASP) and creates artifacts ready for security review and compliance audit.

Orchestrates security workflows including audits, compliance checks, and vulnerability management

Create comprehensive business strategy and planning artifacts including business cases, portfolio roadmaps, market analyses, competitive assessments, and strategic planning documents. Leverages financial modeling (NPV, IRR, ROI) and industry frameworks (PMBOK, SAFe, BCG Matrix) to produce executive-ready strategic deliverables.

Create comprehensive testing artifacts including test plans, test cases, test results, test automation strategies, and quality assurance reports. Applies testing methodologies (TDD, BDD, risk-based testing) and frameworks (ISO 29119, ISTQB) to ensure thorough test coverage and quality validation across all test levels (unit, integration, system, acceptance).

Orchestrates testing workflows across unit, integration, and end-to-end tests

Validates and registers agent manifests for the Betty Framework.

**Version:** 0.1.0

Detect breaking changes between API specification versions to maintain backward compatibility.

**api.define** scaffolds OpenAPI and AsyncAPI specifications from enterprise-compliant templates, generating production-ready API contracts with best practices built-in.

**api.generate-models** generates type-safe models from OpenAPI and AsyncAPI specifications, enabling shared models between frontend and backend using code generation.

**api.validate** validates OpenAPI and AsyncAPI specifications against enterprise guidelines, with built-in support for Zalando RESTful API Guidelines.

Validates artifact type names against the Betty Framework registry and returns complete metadata for each type. Provides intelligent fuzzy matching and suggestions for invalid types.

The `audit.log` skill provides centralized audit logging for the Betty Framework. It records timestamped JSON entries tracking skill execution, status, duration, and errors.

Format code using Prettier, supporting multiple languages and file types. This skill can format individual files or entire directories, check formatting without making changes, and respect custom Prettier configurations.

Validates and registers command manifest files (YAML) to integrate new slash commands into Betty.

**Version**: 0.1.0

**docs.lint.links** validates Markdown links to detect broken internal or external links, with optional autofix mode to correct common issues.

Reconcile plugin.yaml with Betty Framework registries

Automatically regenerate README.md from Betty Framework registries

The `docs.validate.skill_docs` skill validates SKILL.md documentation files against their corresponding skill.yaml manifests to ensure completeness, consistency, and quality. This skill helps maintain high documentation standards across all Betty Framework skills by automatically checking for required sections and verifying that documented fields match the manifest.

Take an Epic (as Markdown) and decompose it into user stories. Analyzes Epic document and identifies major deliverables, grouping them by persona or capability.

Generate an Agile Epic from a high-level goal, feature request, or strategic initiative. Creates structured Agile Epic document that follows best practices.

**generate.docs** automatically generates or updates SKILL.md documentation from skill.yaml manifest files, ensuring consistent and comprehensive documentation across all Betty skills.

Generate marketplace catalog files from Betty Framework registries

**hook.define** is a Betty skill that creates and registers validation hooks for Claude Code. Hooks enable automatic validation and policy enforcement by triggering skills on events like file edits, commits, and pushes.

Validates and registers hook manifest files (YAML) in the Hook Registry for versioned hook management.

**Version:** 0.1.0

Bundle plugin directory into a deployable Claude Code plugin package

Publish bundled plugin packages to local, marketplace, or GitHub Releases with dry-run and validation modes

Automatically generate plugin.yaml from Betty Framework registries

Enforces policy rules for skill and agent manifests

Compare current and previous versions of skills/agents and report differences.

**Version:** 0.1.0

Updates the Betty Framework Skill Registry when new skills are created or validated.

Generates a new Betty Framework Skill directory and manifest. Use when you need to bootstrap a new skill in the Betty Framework.

Validate and register new Claude Code Skill manifests (.skill.yaml) to ensure structure, inputs/outputs, and dependencies are correct.

Convert decomposed items from epic.decompose into fully formatted user stories. Generates individual Markdown files for each story following standard user story format.

**Version:** 0.1.0

Generate STRIDE-based threat models with intelligent threat analysis, CVSS risk scoring, and mitigation recommendations

Executes multi-step workflows by chaining Betty Framework skills.

Validates workflow YAML files to ensure structure and schema correctness.