@silviase/refactoring-11-ci-automation

---
name: refactoring-11-ci-automation
description: Use when adding minimal CI automation for lint, tests, and type checks in Python research code.
---

# Refactoring 11: CI and Automation

## Goal

Automate the minimum checks to keep the codebase healthy.

## Sequence

- Order: 11
- Previous: refactoring-10-security-privacy
- Next: refactoring-12-data-versioning

## Workflow

- Check for existing CI; extend it instead of replacing.
  - Success: Existing CI remains intact with minimal additions.
- Add a simple pipeline for linting, tests, and type checks.
  - Success: CI runs lint, test, and type checks on pushes or PRs.
- Keep runtime short; split heavy jobs into optional workflows.
  - Success: Default CI completes quickly.
- Ensure commands run via `uv run` where applicable.
  - Success: CI uses `uv run` consistently for Python checks.
- Document how to run the same checks locally.
  - Success: Local check commands are documented.

## Guardrails

- Avoid complex CI matrices unless required.
- Keep CI changes isolated from refactor changes.
- Do not break existing deployment workflows.