catlog22/maestro-flow

Maestro Companion runs a single bounded task with a minimal lifecycle and logs evidence for the run. Use it for mechanically clear actions that do not need a gate, verdict, or multi-step orchestration.

Maestro Fork creates or syncs a session-level git worktree for parallel development. Use it to branch from a base ref, copy shared workflow files, and update scoped session artifacts.

Maestro Guard manages directory-level write boundaries in .workflow/config.json. Use it to turn protection on or off, set allow/deny paths, and check whether the workflow-guard hook is active.

Maestro Help provides command search, skill and agent browsing, workflow recommendations, and beginner guidance. Use it when you need to find a command, understand what to use next, or browse the Maestro catalog.

Maestro Help provides command search, skill and agent browsing, workflow recommendations, and beginner guidance for Maestro Flow. Use it when you need to find a command, choose a workflow, or learn what to do next.

Maestro Impeccable orchestrates UI design workflows for shaping, auditing, polishing, and codifying interfaces. Use it to route from raw input into structured design tasks and quality-gated chains.

Maestro Init initializes a project by detecting existing state and creating the .workflow/ project files. Use it to start a new Maestro workflow or onboard an existing codebase without overwriting protected state.

Maestro Issue classifies natural-language intent into issue operations like create, list, show, update, close, link, or discover. Use it to manage issue workflows without memorizing command syntax.

Maestro Knowhow captures reusable knowhow into .workflow/knowhow/ from an intent you provide. It infers the content type, extracts the content, and writes the entry using the workflow instructions.

Maestro Knowledge manages an intent-driven knowledge store for auditing, reviewing, staging, promoting, and harvesting knowledge. Use it when you want Maestro to route a knowledge lifecycle task from a natural-language intent or explicit keyword.

Maestro Learn guides reading, investigation, decomposition, and consultation to build understanding of code, decisions, and plans. It saves findings to workflow notes and learning entries for later reference.

Maestro Merge merges a session worktree branch back into main, then syncs Run artifacts and reconciles the artifact registry. Use it when finishing a session merge with required Git and artifact checks.

Skill Generator creates new Claude Code skills with a configurable sequential or autonomous execution model. Use it when scaffolding a skill, defining its phases, or building a new workflow.

Skill Iter Tune runs a skill through execute-evaluate-improve loops, using Claude to execute, Agy to evaluate, and Agent to apply changes. Use it when you want to refine a skill until it reaches a quality threshold or hits a max iteration limit.

Skill Simplify analyzes a skill file for redundancy, trims descriptive content, and checks that functional elements are still intact. Use it when simplifying or optimizing a skill without losing behavior.

Skill Tuning diagnoses and repairs Claude Code skill execution problems such as context explosion, memory loss, data flow disruption, and coordination failures. Use it when a skill is producing inconsistent results or needs optimization.

Team Architecture Optimization orchestrates a multi-agent workflow to analyze a codebase, design a refactoring plan, implement changes, validate results, and review code quality. Use it for architecture-focused refactors with coordinator and worker roles.

Team Coordinate coordinates tasks by generating role specs at runtime and spawning team-worker agents to execute them. Use it when you need phased multi-agent orchestration with status, resume, and revision commands.

Team Issue Resolution orchestrates a multi-step issue pipeline: explore context, plan, review, marshal work, and implement. Use it for team issue handling with coordinator and worker roles.

Team Lifecycle V4 orchestrates specification, planning, implementation, testing, and review across coordinated agents. Use it for end-to-end software tasks that need role-based handoff and checkpointing.

Team Performance Optimization coordinates profiling, strategy, implementation, benchmarking, and review for application performance work. Use it to run a single or parallel optimization pipeline through team-worker agents.

Team Review orchestrates a scanner, reviewer, and fixer pipeline for code review. Use it to run analysis, generate findings, and apply fixes with rollback on failure.

Team Swarm orchestrates ant-colony-style multi-agent exploration over a configurable task space. Use it when you want a coordinator to spawn parallel workers, score results, and iterate until convergence.

Team Testing orchestrates a strategist, generator, executor, and analyst to run layered test coverage with Generator-Critic loops. Use it for coordinated testing workflows with shared session state and role-based workers.

Workflow Skill Designer creates structured workflow skill packages with a SKILL.md coordinator and phased execution docs. Use it when designing multi-step Claude Code workflows with progressive loading, TodoWrite patterns, and inter-phase data flow.