Skill354 repo starsupdated 3d ago

test-scope

The test-scope skill analyzes Git changes to identify which test suites are affected and runs only those, rather than the full test matrix. Use it to accelerate CI/CD pipelines and local development by skipping irrelevant tests based on file modifications, while ensuring typecheck and configuration-dependent tests always run when appropriate.

View source Repository: sdl-mcp

Install in Claude Code

Copy

git clone --depth 1 https://github.com/GlitterKill/sdl-mcp /tmp/test-scope && cp -r /tmp/test-scope/.agents/skills/test-scope ~/.claude/skills/test-scope

Then start a new Claude Code session; the skill loads automatically.

Definition

SKILL.md

# Targeted Test Runner

Analyze recent code changes to determine which test suites need to run, then execute only those.

## Test Suite Map

| Source Path Pattern | Test Suite | Run Command |
|---|---|---|
| `src/indexer/**`, `src/indexer/adapter/**` | Adapter harness | `npm run test:harness` |
| `src/mcp/tools/**`, `src/server.ts` | Golden snapshots | `npm run test:golden` |
| `src/code/skeleton*` | Skeleton determinism | `node --import tsx --test tests/skeleton-determinism.test.ts` |
| `src/graph/**`, `src/delta/**` | Slice/blast radius | `node --import tsx --test tests/slice-cache.test.ts tests/blastRadius.test.ts` |
| `src/mcp/**`, `src/db/**`, `src/config/**` | Unit tests | `npm test` |
| `native/**` | Native parity | `npm run test:native-parity` |
| `tests/property/**` | Property tests | `node --import tsx --test tests/property/*.test.ts` |
| Any `*.ts` in `src/` | Typecheck | `npm run typecheck` |

## Steps

1. **Detect changed files**:
   ```bash
   git diff --name-only HEAD
   git diff --name-only --cached
   ```
   If no uncommitted changes, use `git diff --name-only HEAD~1` instead.

2. **Map changes to test suites** using the table above. A single change can trigger multiple suites.

3. **Always run typecheck** if any `.ts` file in `src/` changed.

4. **Report the plan** before running:
   ```
   Changed files: 3
   Affected suites: typecheck, golden snapshots, unit tests
   Skipping: adapter harness, native parity, property tests, stress tests
   ```

5. **Execute the affected suites** sequentially. Use `sdl.workflow` with `runtimeExecute` if SDL-MCP is running, otherwise use Bash directly.

6. **Report results** with pass/fail status for each suite.

## Rules

- If changes touch `package.json`, `tsconfig.json`, or `eslint.config.mjs`, run the full suite (`npm test`)
- If changes touch only `.md`, `.json` (non-package), or config files, skip all test suites and report "No code changes — tests not needed"
- Never run `test:stress` or `test:mutation` automatically — those are opt-in only
- Run `npm run build:all` before any test suite that reads from `dist/`