Claude
Skills
Sign in
Back

create-tests-extract

Included with Lifetime
$97 forever

Extract large inline test modules into adjacent test files while preserving the same effective visibility, helper access, and coverage shape. Use when the user wants implementation files slimmed down without accidentally turning private unit tests into weaker integration tests.

Code Review

What this skill does


<EXTREMELY-IMPORTANT>
The point is readability without semantic drift.

Non-negotiable rules:
1. Read the source file and its inline tests fully before moving anything.
2. Preserve the original visibility and helper access model.
3. Prefer adjacent test modules over integration tests when private access matters.
4. Change production code only as much as module wiring requires.
5. Run the narrowest relevant tests after extraction.
</EXTREMELY-IMPORTANT>

# create-tests-extract

## Inputs

- `$request`: Source file, module, or cleanup goal

## Goal

Move bulky inline tests into adjacent files while keeping:

- the same effective test coverage
- the same access to private items where needed
- a clearer production file

## Step 0: Read and classify the test block

Inspect:

- the production file
- the inline test module
- helper functions or fixtures used only by tests
- whether the tests depend on `super::*` or private module items

If the file belongs to a Rust crate, use `rust` for conventions before changing the module layout.

**Success criteria**: The tests are classified as local-inline, adjacent-module, or true integration candidates.

## Step 1: Choose the smallest safe extraction boundary

Prefer:

- `foo.rs` + `#[cfg(test)] mod foo_tests;` + `foo_tests.rs`
- or `foo/mod.rs` + `tests.rs` for directory modules

Avoid pushing tests into top-level `tests/` unless they genuinely should become public-API integration tests.

**Success criteria**: The new layout preserves the intended visibility model.

## Step 2: Extract without semantic drift

When moving the tests:

- add the minimal `#[cfg(test)] mod ...;` wiring
- keep `use super::*;` or equivalent imports when needed
- preserve test names and attributes
- move test-only helpers with the suite that needs them

Do not rename tests or restructure production modules unless the extraction requires it.

**Success criteria**: The moved tests still compile in the same effective context.

## Step 3: Verify the moved suite

After extraction:

- run the narrowest relevant tests
- check for warnings or visibility regressions
- verify the production file is materially easier to scan

**Success criteria**: The new layout passes and preserves behavior.

## Guardrails

- Do not turn private unit tests into public-only integration tests by accident.
- Do not move tiny, explanatory inline tests that still improve readability where they are.
- Do not broaden the refactor beyond the requested extraction.
- Do not drop fixtures or helper coverage just to shorten the production file.

## Output Contract

Report:

1. files created or modified
2. extraction layout chosen
3. any tests intentionally left inline
4. validation run after the move
Files: 1
Size: 3.4 KB
Complexity: 13/100
Category: Code Review

Related in Code Review