write-failing-test

Step 1: Select Next Test Case

From your test plan, identify:
- The highest priority unimplemented test
- The specific behavior being tested
- The expected outcome

Step 2: Write the Test Shell

Create the Test with the proper structure. Identify the appripriate language for the component and review an example in one of these files:

• C#: /reference/test_example.cs
• Python: /reference/test_example.py
• TypeScript: /reference/test_example.ts

Step 3: Implement Arrange Section

Set up the test preconditions:
- Create test data using factories/builders
- Configure mocks for dependencies
- Initialize the system under test (SUT)

Keep setup minimal - only what's needed for THIS test.

Step 4: Implement Act Section

Execute the behavior under test:
- Single method call or action
- Capture the result if needed
- Should be ONE line in most cases

Step 5: Implement Assert Section

Verify the expected outcome:
- Use specific assertions (not just assertTrue)
- One logical assertion per test
- Assert on behavior, not implementation

Step 6: Verify Test Fails

Run the test and confirm:
✓ Test executes without setup errors
✓ Test fails for the RIGHT reason
✓ Failure message is clear and helpful
✗ Test should NOT pass yet

If test passes → Something is wrong:
- Test may not be testing new behavior
- Code already exists
- Test has a bug

// TODO - Add Run-Test Skill specific to the project's testing framework, supporting that projects structure

Step 7: Document the Failure

Update the test plan and mark the test as "failing".

Step 8: Write the Sentinel File

• create a sentinel file in the .process directory, named {skill-name}.done.json.
• the sentinel file will follow @/schema/sentinel.schema.json.
• set the task field to "{skill-name}".
• the verify_params of the sentinel file will follow @/schema/verify-params.schema.json.
• set the verify_params as follows:
  • set "test_cases_path" to the path of the test cases file relative to repo root.
  • set "failing_test_path" to the path of the failing test file relative to repo root.
  • set "failing_test_name" to the name of the failing test.