What problem does it solve?
Testing and validation workflows within the ADHD Framework are often inconsistently applied, leading to ambiguous test boundaries, missed edge cases, and fragmented CI practices, plus inconsistent rules for executing Python commands in terminals.
Core Features & Use Cases
- Test folder conventions: Clear guidance on when to place tests under tests/ vs module-specific tests/ and how to organize integration versus unit tests.
- Pytest and validation patterns: Standardized pytest usage, fixtures, and validation checks to ensure consistent outcomes.
- Python terminal execution rules: Clear rules for running Python commands in terminals, especially within activated virtual environments.
- Virtual environment and CI alignment: Clear rules for activating virtual environments and aligning with CI pipelines to guarantee reproducible runs.
- HyperRed artifact conventions: Structured logging and artifact management for adversarial testing scenarios, and CI-ready reporting.
- Decision guidance: When to use tests/ versus playground/ for demos, experiments, or demonstrations.
Quick Start
Activate your virtual environment, run the validation workflow for a module, and review CI reports to ensure correct test coverage.