Imported from peweet/dail_tracker (
extractors/AGENTS.md). Install upstream withnpx skills add peweet/dail_tracker --skill extractors. Copyright stays with the author.
Extractor guidance
- Use Polars and the shared helpers:
services.http_enginefor HTTP,services.coverage_io.save_coverage,services.parquet_io.save_parquet, andservices.extract_runner.run_extractor. - Treat source fidelity as part of the contract: retain source URL/page/date fields and quarantine ambiguous parses instead of silently guessing.
- Never inspect an entire source corpus or parquet in agent context. Use a bounded representative sample and report completeness/recall separately from parser correctness.
- Add or update the closest
test/extractors/test_<name>.pytest. Runuv run python tools/dev.py conventionsas well as focused tests.