ElixirScope Testing & LLM Best Practices

A Cursor rules skill for ElixirScope development that optimizes testing workflow, bypasses slow LLM API tests by default, and provides code mapping guidance for the AI-powered execution cinema debugger.

Purpose

This skill enforces smart testing practices for ElixirScope development:

Instructions

1. Default Testing Strategy

**ALWAYS use `mix test.trace` by default** when running tests in ElixirScope development. This bypasses slow live LLM API tests and provides fast feedback.

```bash

mix test.trace

```

2. When to Use Full Test Suite

**Only run `mix test.all` or `mix test.live` when:**

```bash

Full suite including live LLM tests

mix test.all

Only live LLM integration tests

mix test.live

```

3. Suppress Warnings

Use the `mixsw` command alias to suppress compiler warnings and show only errors:

```bash

mixsw test.trace

mixsw compile

```

4. Reference Documentation

Before making changes to ElixirScope code:

**Check CURSOR_CODE_MAPPING.md** for:

**Check CURSOR_IMPLEMENTATION_GUIDE.md** for:

5. Date Awareness

When working with date-dependent features or logging, remember that the current date context is **May 28, 2025**.

6. Workflow Integration

**Standard development loop:**

1. Make code changes

2. Run `mix test.trace` for fast feedback

3. If test fails, debug with tracing output

4. Before committing, run `mix test.all` for full validation

5. Use `mixsw` to reduce noise in output

**Example session:**

```bash

Fast iteration

mixsw test.trace

Fix issues found

Pre-commit full check

mixsw test.all

```

7. LLM Test Bypass Pattern

ElixirScope uses a test configuration pattern to bypass slow LLM calls:

When writing new tests involving LLM features, follow this pattern:

```elixir

Fast test - no LLM call

test "parses trace data" do

# Uses mocked/stubbed responses

end

Slow test - requires LLM API

@tag :live_llm

test "generates insights via LLM" do

# Makes actual API calls

end

```

Constraints

Examples

**Bad - slow default test run:**

```bash

mix test

Takes minutes due to LLM API calls

```

**Good - fast traced tests:**

```bash

mix test.trace

Completes in seconds, skips LLM calls

```

**Good - pre-commit validation:**

```bash

mixsw test.all

Full coverage, clean output

```

**Good - LLM feature development:**

```bash

mixsw test.live

Only LLM tests, no noise

```