ATFT Code Quality Skill

Mission

• Maintain production-readiness by catching regressions before merge or deployment.
• Automate formatting, static analysis, and targeted test execution.
• Surface remediation paths for failing checks with minimal GPU disruption.

Trigger Phrases

• “Run quality gate”, “lint/format the repo”, “execute tests”, “type check”, “pre-commit”.
• Requests mentioning Ruff, mypy, pytest, security audit, or dependency hygiene.

Quality Pipeline

1. Workspace scan

   • git status --short

   • tools/project-health-check.sh --section quality

2. Formatting & Lint

   • ruff check src/ --fix

   • ruff format src/ tests/

3. Type Safety

   • mypy src/gogooku3 scripts/

   • pyright

     if TypeScript integration touched.
4. Testing Layers

   • pytest tests/unit -n auto -q

   • pytest tests/integration -m "not slow"

   • python test_short_selling.py --strict

     for risk module.
5. Security & Secrets

   • pip install bandit safety

     (once) then

     bandit -qr src/

   • detect-secrets scan

     with baseline

     security/detect-secrets.baseline

     .
6. Pre-commit Sweeps

   • pre-commit run --all-files

   • pre-commit run --hook-stage manual conventional-pre-commit

     .

Specialized Workflows

Fast Feedback (single file change)

• ruff check src/gogooku3/<module>.py --fix

  .

• pytest tests/unit/test_<module>.py -k <case>

  .

• mypy src/gogooku3/<module>.py

  .

GPU-Sensitive Checks

• For CUDA kernels or Torch compile edits:
  

  pytest tests/integration/test_gpu_training.py::test_compile_path --maxfail=1

  .
• Validate memory usage script:

  python tools/gpu_memory_report.py --dry-run

  .

Dependency Hygiene

• pip-compile requirements.in

  (if edited).

• python tools/dependency_audit.py --fail-on-critical

  .
• Update lockfiles and note changes in

  docs/ops/dependency_log.md

  .

Failure Handling

• Lint failure → reference Ruff rule from output, fix quickly; prefer

  ruff --fix-only RULE

  .
• Type errors → add precise type hints, update

  mypy.ini

  only with justification in docstring.
• Flaky tests → rerun with

  pytest -k test_name --lf

  ; mark with

  @pytest.mark.flaky

  only when documented in

  tests/README.md

  .
• Security findings → rotate secrets, update

  .env.example

  , notify DevSecOps via

  security/alerts.md

  .

Codex Collaboration

• Launch

  ./tools/codex.sh "Perform deep static audit of src/gogooku3"

  for architectural refactors or elusive bug hunts.
• Use

  codex exec --model gpt-5-codex "Review failing pytest logs and propose fixes"

  when triaging stubborn CI failures.
• Reflect Codex recommendations into permanent lint/type rules and note significant changes in

  quality/last_quality_report.md

  .

Exit Criteria

• All commands exit 0.
• Updated artifacts recorded in

  quality/last_quality_report.md

  .
• Provide summary + next steps in PR description or change log.