Can this skill be customized for my team's specific rules?

While it provides a robust default framework for TDD and documentation, it serves as a foundational layer for setting boundaries and working agreements between the developer and Claude.

Does this skill require tests for every change?

Yes, the skill explicitly mandates a 'non-negotiable' rule: no production code should be written without a corresponding failing test first.

What is the primary focus of the Expectations skill?

The primary focus is to enforce a strict Test-Driven Development (TDD) workflow and establish a comprehensive framework for documenting institutional knowledge and architectural decisions.

How does this skill handle project documentation?

It provides a specific format for capturing 'Gotchas', 'Patterns', and 'Decisions', and requires Claude to update documentation like CLAUDE.md whenever meaningful changes are introduced.

Code Expectations & TDD Standards

Name: Code Expectations & TDD Standards
Author: mintuz

bymintuz

•

Security & Testing

Establishes strict Test-Driven Development (TDD) protocols and documentation standards to ensure code quality and institutional knowledge retention.

About

The Expectations skill acts as a formal set of working agreements for Claude within your codebase. It enforces a rigorous 'test-first' methodology where no production code is written without a failing test, ensuring high reliability and stability. Beyond testing, it provides a structured framework for documentation, prompting Claude to capture 'Gotchas,' architectural decisions, and patterns that would otherwise be lost. This skill is essential for teams looking to maintain high standards, minimize technical debt, and ensure that AI-generated code adheres to first-principles thinking and project-specific constraints.

Key Features

First-principles thinking prompts for complex problem solving
Structured documentation framework for gotchas, patterns, and anti-patterns
Explicit communication guidelines for trade-offs and design rationale
Automatic maintenance of CLAUDE.md and project documentation
Enforces mandatory Test-Driven Development (TDD) workflow
14 GitHub stars

Use Cases

Implementing complex features with high reliability using a test-first approach
Standardizing AI behavior across a development team to ensure consistent code quality
Building a searchable knowledge base of architectural decisions and edge cases

About

Key Features

First-principles thinking prompts for complex problem solving
Structured documentation framework for gotchas, patterns, and anti-patterns
Explicit communication guidelines for trade-offs and design rationale
Automatic maintenance of CLAUDE.md and project documentation
Enforces mandatory Test-Driven Development (TDD) workflow
14 GitHub stars

Use Cases

Implementing complex features with high reliability using a test-first approach
Standardizing AI behavior across a development team to ensure consistent code quality
Building a searchable knowledge base of architectural decisions and edge cases