Align AGENTS.md with the established Ruff validation baseline #53

Merged

JackFrostbyte merged 1 commit from fix/agents-ruff-validation-baseline into develop

2026-08-02 01:43:48 -04:00

JackFrostbyte commented

2026-08-02 01:40:45 -04:00

Owner

Summary

Add the repository's existing Ruff lint and formatting checks to the validation commands documented in AGENTS.md.
Remove stale guidance that incorrectly prohibited Ruff and pyproject.toml, both of which were established by the Python tooling baseline.
Update the review checklist and sample pull-request verification section to include the configured Ruff checks.
Clarify that contributors must not introduce or replace tooling outside an active issue's scope.

Context

The Python project baseline established Ruff through pyproject.toml, and docs/development.md already documents these commands:

python -m ruff check src pipeline tests
python -m ruff format --check src pipeline tests

AGENTS.md still omitted these checks and incorrectly stated that Ruff and pyproject.toml must not be introduced. This pull request reconciles that stale guidance before further implementation work begins.

Verification

git diff --check
python pipeline/validate/validate_records.py
python -m unittest discover -s tests -v
python -m ruff check src pipeline tests
python -m ruff format --check src pipeline tests
Complete diff reviewed

Validation results:

Metadata validator: 6 sources, 6 documents, 2 chunks across 13 record files — all valid
Unit tests: 21 passed
Ruff linting: all checks passed
Ruff formatting: 4 files already formatted

Scope confirmation

Only AGENTS.md changed.
No production behavior changed.
No metadata schema or policy changed.
No source records or committed originals changed.
No dependency or tooling configuration changed.
qpdf and Poppler were not introduced; their evaluation remains deferred to Issue #13.

Follow-up correction to the tooling baseline established through Issue #7 and PR #30.

## Summary * Add the repository's existing Ruff lint and formatting checks to the validation commands documented in `AGENTS.md`. * Remove stale guidance that incorrectly prohibited Ruff and `pyproject.toml`, both of which were established by the Python tooling baseline. * Update the review checklist and sample pull-request verification section to include the configured Ruff checks. * Clarify that contributors must not introduce or replace tooling outside an active issue's scope. ## Context The Python project baseline established Ruff through `pyproject.toml`, and `docs/development.md` already documents these commands: * `python -m ruff check src pipeline tests` * `python -m ruff format --check src pipeline tests` `AGENTS.md` still omitted these checks and incorrectly stated that Ruff and `pyproject.toml` must not be introduced. This pull request reconciles that stale guidance before further implementation work begins. ## Verification * [x] `git diff --check` * [x] `python pipeline/validate/validate_records.py` * [x] `python -m unittest discover -s tests -v` * [x] `python -m ruff check src pipeline tests` * [x] `python -m ruff format --check src pipeline tests` * [x] Complete diff reviewed Validation results: * Metadata validator: 6 sources, 6 documents, 2 chunks across 13 record files — all valid * Unit tests: 21 passed * Ruff linting: all checks passed * Ruff formatting: 4 files already formatted ## Scope confirmation * Only `AGENTS.md` changed. * No production behavior changed. * No metadata schema or policy changed. * No source records or committed originals changed. * No dependency or tooling configuration changed. * qpdf and Poppler were not introduced; their evaluation remains deferred to Issue #13. ## Related issue Follow-up correction to the tooling baseline established through Issue #7 and PR #30.

JackFrostbyte added 1 commit

2026-08-02 01:40:45 -04:00