FakeBuilder Generator

Generate DDD aggregate FakeBuilders with Chance.js and fluent APIs.

Updated Apr 5, 2023
One-click install
npx skills add https://github.com/edneyreis999/zord-project --skill fakebuilder-generator
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: FakeBuilder Generator
Source: https://github.com/edneyreis999/zord-project/tree/main/service_financial-claude/skills/fakebuilder-generator
Command: npx skills add https://github.com/edneyreis999/zord-project --skill fakebuilder-generator

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Esta Skill orienta Claude Code a gerar FakeBuilders completos para aggregates DDD usando Chance.js, com fluent API, type augmentation e suporte a factories, para criar dados de teste realistas.

Core Features & Use Cases

  • Geração de FakeBuilders realistas com Chance.js.
  • Data builders com props default, permitindo overrides com factory ou valor fixo.
  • Commentários explicativos e exemplos de uso.
  • Suporte a PropOrFactory<T> para valores fixos ou funções.

Quick Start

Use o gerador para criar um builder para o agregado desejado, especificando props e regras especiais conforme o domínio.

Frequently Asked Questions about FakeBuilder Generator

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate test data builders for DDD aggregates?

FakeBuilder Generator creates complete, realistic test data builders for DDD aggregates using Chance.js. It generates fluent API builders with type augmentation, PropOrFactory support, and default properties you can override, outputting ready-to-use builder files with explanatory comments.

What is a FakeBuilder and why use it for unit tests?

A FakeBuilder is a fluent API that generates realistic test data for aggregates with sensible defaults and factory support. It eliminates boilerplate test fixture creation, ensures consistent fake data across tests, and keeps test setup readable and maintainable.

Can I use Chance.js with PropOrFactory to create flexible test fixtures?

Yes. FakeBuilder Generator integrates Chance.js with PropOrFactory<T> support, allowing each property to accept either a fixed value or a factory function, giving you fine-grained control over test data generation while maintaining type safety.

How does FakeBuilder handle default properties and overrides in tests?

FakeBuilder Generator creates builders with sensible Chance.js-generated defaults for all properties. During test setup, you override specific properties with fixed values or factories as needed, keeping most defaults intact while customizing only what matters for each test case.

What output structure does the generator create for FakeBuilders?

The generator outputs a typed FakeBuilder file to [module]/domain/[name].fake-builder.ts with static factory methods, fluent API chains, and inline comments explaining property generation logic and usage patterns.

Is FakeBuilder suitable for integration tests and test fixtures?

Yes. FakeBuilder Generator creates builders for both unit and integration test scenarios, generating realistic aggregate data with domain-appropriate values and factory support, making test fixtures maintainable across different test scales.