Skip to content
Skillpedia
Testing48k · #4577

wjttc-builder

Teaches your AI agent to test code and catch bugs before users do and plan projects before coding.

What it does

This agent creates detailed test plans to verify your code's quality. It analyzes your project and generates tests that ensure everything works perfectly, like in high-level competitions.

When to use it

  • ✓Before you start writing code.
  • ✓When you want to ensure your code is the best it can be.
  • ✓To find and fix bugs before they cause problems.

Example of what to ask your AI

“Create a test plan for this Python code that calculates averages.”

Want more? Open the sections below.

How to use

The easiest way: copy the message below and paste it into Claude, ChatGPT, Cursor or any AI. It reads the skill and follows the instructions.

Skill link

https://github.com/sickn33/agentic-awesome-skills/blob/main/plugins/agentic-awesome-skills-claude/skills/wjttc-builder/SKILL.md

Ready-to-paste message

Use this skill to help me: https://github.com/sickn33/agentic-awesome-skills/blob/main/plugins/agentic-awesome-skills-claude/skills/wjttc-builder/SKILL.md Read the SKILL.md file at that link and follow its instructions for my task.
How it works

It first understands what your project does and then defines success criteria (tests). Only then is the code written to meet these criteria, ensuring quality from the start.

Installation

Easiest way: copy the skill link and paste it into Claude, ChatGPT or Cursor asking it to follow the instructions.

In the terminal (Claude Code, Codex, Cursor), in your project folder:

npx skills add sickn33/agentic-awesome-skills --skill wjttc-builder

Or download just the file:

curl -L https://raw.githubusercontent.com/sickn33/agentic-awesome-skills/main/plugins/agentic-awesome-skills-claude/skills/wjttc-builder/SKILL.md -o SKILL.md
Technical content (original SKILL.md)

Original text by the author, straight from GitHub.

WJTTC Builder - Championship Test Suite Generator

Philosophy: "We break things so others never have to know they were broken."

This skill generates F1-inspired test suites following the WJTTC (Wolfe James Tests The Code) methodology.

GOALS

Goal How
Pre-defined Test plan before code → improves code quality
Inline Testing Tests/approves at write time → catches bugs at inception
Layer 1 → Layer 2 Industry + Expert = GOLD Code
AI Optimized 100% bi-sync with project.faf
Best Code Possible ✪ Championship standard

GOLD Code ✨

Code earns GOLD status when:

┌────────────────────────────────────────┐
│         ✪ GOLD CODE ✨                │
│  ════════════════════════════════════  │
│  ✓ Pre-test plan defined               │
│  ✓ Inline testing at write time        │
│  ✓ Layer 1: 100% industry coverage     │
│  ✓ Layer 2: WJTTC expert edge cases    │
│  ✓ Bi-sync with project.faf            │
│  ✓ All tests passing                   │
│  ════════════════════════════════════  │
│  This code has earned its name.        │
└────────────────────────────────────────┘

Position in Development Pipeline

WJTTC comes AFTER project.faf, BEFORE coding:

1. project.faf      → Define WHAT we're building (context)
2. WJTTC-TESTS.md   → Define SUCCESS CRITERIA (tests first)
3. Code             → Build to pass the tests
4. Test             → Pass/Fail
5. Repeat           → Until Championship grade

Test-Driven Code (TDC)

The WJTTC Cycle:

Think → Cross-check → Confirm → Code → Test → [Repeat]
  │         │           │        │       │
  │         │           │        │       └── Pass/Fail verdict
  │         │           │        └── Write implementation
  │         │           └── Green light to proceed
  │         └── STOP if missing info - get it first
  └── Understand what we're building

Cross-check Gate: STOP if missing information. Get it before proceeding.

  • Missing requirements? Ask.
  • Unclear acceptance criteria? Clarify.
  • Unknown edge cases? Define them.

Red → Green → Refactor:

  1. Write failing test (RED)
  2. Write code to pass (GREEN)
  3. Clean up (REFACTOR)

Never code without knowing what "done" looks like.

Two-Layer Testing Architecture

Layer 1: Industry Standard (100% Coverage)

Use the framework's native testing - Jest, pytest, Vitest, etc.

  • Unit tests
  • Integration tests
  • Standard assertions
  • Coverage requirements

This is the baseline. Non-negotiable.

Layer 2: WJTTC Expert (Stress + Edge Cases)

The championship layer that catches what industry tests miss:

Category What We Test
Syntax Special chars, escapes, quotes, brackets
Emoji 🏎️ in strings, filenames, variables
Typecases camelCase, snake_case, SCREAMING_CASE, mixed
Variables Empty, null, undefined, MAX_INT, negative
Unicode RTL text, combining chars, zero-width
Injection SQL, XSS, command injection attempts
Boundaries 0, 1, -1, MAX, MAX+1, empty array

Test Targets:

  • MCP servers and tools
  • CLI commands and flags
  • API endpoints and payloads
  • Engine internals
  • Infrastructure configs

We Test the Testing

Meta-testing checklist:

  • Do the tests actually run?
  • Do they fail when code is broken?
  • Do they pass when code is correct?
  • Are edge cases covered?
  • Can tests be run in isolation?
  • Do tests clean up after themselves?

Signal Integrity Audit (The Red-Means-Real Doctrine)

Before you measure coverage, measure signal trust.

Red CI is a contract: stop, look, fix. If red means "shrug, runner had a noisy neighbor, just rerun," the signal is dead — and dead signal is worse than no signal at all. A test suite with 100% coverage but flaky reds is less trustworthy than one with 80% coverage and zero false alarms, because the team has stopped reading the reds.

This is the parent doctrine. Every other testing principle serves it.

The Audit

For any test suite under review, classify the last 30 days of CI failures into three buckets:

Bucket Meaning Action
Real bug Red corresponded to an actual code defect that was fixed by a code change ✓ Signal worked
Flake Red was timing/network/concurrency noise; passed on rerun with no code change ✗ Test design defect

…

FAQ

What is WJTTC?

It's a testing methodology inspired by F1 racing, focused on creating the most reliable and high-quality code possible.

What does 'GOLD Code' mean?

Code that has passed all testing levels, including expert tests, and meets the highest standards of quality and reliability.

Why test before coding?

Defining tests first (as success criteria) ensures you know exactly what you need to build and avoids rework, improving overall quality.

Details

Original description by the author

PLAN and GENERATE WJTTC (Championship-Grade) test suites for any project. Analyzes the codebase, classifies components across the WJTTC five tiers (Brake · Engine · Aero · Tyre · Pit), writes a tiered test plan, and scaffolds executable test files.

repo: sickn33/agentic-awesome-skills

Popularity

GitHub stars
48k
Ranking position
#4577
License
MIT
Updated
10/15/2026

Is this skill useful?

0

Sign in to vote.

Comments

  • …

More skills from this repository

Similar skills