···17173. **YAML/JSON/TOML validation**
18184. **Ruff linting and formatting**
19192020-### Manual Checks
2020+## Making Changes
2121+2222+1. **Sync Dependencies**
2323+ ```bash
2424+ uv sync --frozen
2525+ ```
2626+2727+2. **Create a new branch:**
2828+2929+ ```bash
3030+ git checkout -b username/feature-name
3131+ ```
3232+3333+3. **Make your changes**
3434+3535+4. **Run quality checks:**
3636+3737+ ```bash
3838+ # This prevents uv.lock from being modified
3939+ # this is preferred.
4040+ uv sync --frozen
4141+4242+ uv run ruff check --fix
4343+ uv run ruff format
4444+ ```
21452222-Before pushing, run:
4646+5. **Test your changes** (if tests exist)
23472424-```bash
2525-# Comprehensive linting check
2626-uv run ruff check
4848+6. **Commit your changes:**
4949+5050+ ```bash
5151+ git add .
5252+ git commit -m "feat: descriptive commit message"
5353+ ```
27542828-# Format all code
2929-uv run ruff format
5555+ Pre-commit hooks will run automatically and may fix formatting issues.
30563131-# Type checking (on specific files/modules)
3232-uv run mypy osprey_worker/src/osprey_worker/lib
3333-# Or you can type check every module (this will happen in CI)
3434-uv run mypy .
5757+7. **Push your branch:**
35583636-# Run all pre-commit hooks
3737-uv run pre-commit run --all-files
3838-```
5959+ ```bash
6060+ git push origin username/feature-name
6161+ ```
39624063## Commit Standards
4164···5780- `test:` - Adding or updating tests
5881- `chore:` - Maintenance tasks
59826060-## Making Changes
6161-6262-1. **Create a new branch:**
6363-6464- ```bash
6565- git checkout -b username/feature-name
6666- ```
6767-6868-2. **Make your changes**
6969-7070-3. **Run quality checks:**
7171-7272- ```bash
7373- uv run ruff check --fix
7474- uv run ruff format
7575- ```
7676-7777-4. **Test your changes** (if tests exist)
8383+### Manual Checks
78847979-5. **Commit your changes:**
8585+Before pushing, run:
80868181- ```bash
8282- git add .
8383- git commit -m "feat: descriptive commit message"
8484- ```
8787+```bash
8888+# Comprehensive linting check
8989+uv run ruff check
85908686- Pre-commit hooks will run automatically and may fix formatting issues.
9191+# Format all code
9292+uv run ruff format
87938888-6. **Push your branch:**
9494+# Type checking (on specific files/modules)
9595+uv run mypy osprey_worker/src/osprey_worker/lib
9696+# Or you can type check every module (this will happen in CI)
9797+uv run mypy .
89989090- ```bash
9191- git push origin username/feature-name
9292- ```
9999+# Run all pre-commit hooks
100100+uv run pre-commit run --all-files
101101+```