🎯

tdd-mastery

🎯Skill

from xenitv1/claude-code-maestro

AI Summary

Automates test-driven development (TDD) workflows by generating comprehensive test suites, scaffolding test cases, and guiding developers through systematic test-first implementation strategies.

tdd-mastery

Installation

Install skill:

npx skills add https://github.com/xenitv1/claude-code-maestro --skill tdd-mastery

Stars187

AddedJan 25, 2026

View on GitHub Back to Skills

Skill Details

SKILL.md

Overview

# Maestro: AI Development Orchestrator

Elite-tier orchestration framework for Claude Code CLI. Supercharges AI development through specialized agents, modular skills, intelligent hooks, and persistent memory systems.

> Version: 0.6.0

> Author: [xenitV1](https://github.com/xenitV1) • [X/Twitter](https://x.com/xenit_v0)

> Philosophy: "Why over How. Architecture precedes implementation."

Quick Start

Installation

One-line Install (Skills.sh):

```bash

npx skills add xenitV1/claude-code-maestro

```

Manual Plugin Install:

Maestro is distributed as a Claude Code Plugin. To install it manually:

```bash

# 1. Add Maestro as a marketplace

/plugin marketplace add xenitV1/claude-code-maestro

# 2. Install the Maestro plugin

/plugin install maestro@xenitV1-claude-code-maestro

```

Prerequisites

Node.js 18+ (required for hooks)
Claude Code CLI

Usage

Since Maestro is a plugin, its commands are namespaced. Use the format /maestro:command.

```bash

# Basic orchestration

/maestro your task description

# With Ralph Wiggum (autonomous iterations)

/maestro fix bugs and improve code. ralph 5 iterations

# Design mode

/maestro design new authentication system

# Plan mode

/maestro plan implement user dashboard

# Use the Grandmaster agent directly

/agent:grandmaster

```

Architecture

```

┌─────────────────────────────────────────────────────────────────────┐

│ MAESTRO SYSTEM │

├─────────────────────────────────────────────────────────────────────┤

│ ┌──────────┐ ┌──────────────┐ ┌─────────────────────────┐ │

│ │ /maestro │───▶│ grandmaster │───▶│ SKILLS │ │

│ │ command │ │ agent │ │ (frontend, backend, │ │

│ └──────────┘ └──────────────┘ │ tdd, debug, etc.) │ │

│ │ └─────────────────────────┘ │

│ ▼ │

│ ┌─────────────────────────────────────────────────────────────┐ │

│ │ HOOK SYSTEM │ │

│ │ SessionStart │ PostToolUse │ Stop │ PreCompact │ etc. │ │

│ └─────────────────────────────────────────────────────────────┘ │

│ │ │

│ ▼ │

│ ┌──────────────────────────────────────────────────────────────┐ │

│ │ LONG-TERM MEMORY (LTM) │ │

│ │ (brain.jsonl) │ │

│ └──────────────────────────────────────────────────────────────┘ │

└─────────────────────────────────────────────────────────────────────┘

```

Project Structure

```

maestro/

├── .claude-plugin/

│ └── plugin.json # Plugin manifest

├── agents/

│ └── grandmaster.md # Central orchestrator agent

├── commands/

│ └── maestro.md # /maestro slash command

├── hooks/

│ ├── hooks.json # Hook configuration

│ ├── lib/ # Shared JS utilities

│ │ ├── utils.js # Cross-platform utilities

│ │ ├── brain.js # LTM operations

│ │ └── ralph.js # Ralph state management

│ ├── session-start.js # Tech stack detection + LTM injection

│ ├── brain-sync.js # LTM sync (PostToolUse)

│ ├── stop.js # Ralph Wiggum iteration

│ ├── ralph.js # QA enforcement

│ ├── sentinel.js # Change detection

│ └── pre-maestro.js # Skill recommendation

├── skills/

│ ├── clean-code/ # Code quality standards

│ ├── frontend-design/ # Elite UI/UX

│ ├── backend-design/ # API & Database patterns

│ ├── tdd-mastery/ # Test-Driven Development

│ ├── debug-mastery/ # Systematic debugging

│ ├── verification-mastery/# Evidence-based completion

│ ├── brainstorming/ # Design-first methodolo