# tests/quarantine/

This directory holds tests that have been **quarantined** because they are
flaky or temporarily broken.  Quarantine keeps the main test suite green while
ensuring no test is silently deleted or forgotten.

## Rules

1. Every file here must correspond to an open issue.
2. Every test here must carry `@pytest.mark.quarantine(reason="#NNN")`.
3. Quarantined tests are **excluded from the default CI run** but are included
   when you pass `--run-quarantine`.
4. The quarantine is a **temporary holding area**, not a graveyard.  If a
   quarantined test's issue has been open for more than 30 days with no
   progress, escalate it.

## Adding a test

```python
# tests/quarantine/test_my_flaky_thing.py
import pytest

@pytest.mark.quarantine(reason="Flaky: #1234")
def test_my_flaky_thing():
    ...
```

See `docs/QUARANTINE_PROCESS.md` for the complete workflow.