Imported from yulongpo/signal_studio (
AGENTS.md). Install upstream withnpx skills add yulongpo/signal_studio. Copyright stays with the author.
Signal Studio Codex development rules
Task workflow
- Read this file and the assigned task document completely.
- Inspect
git statusbefore changing files. - Use the immutable approved baseline under
docs/baseline/Signal-Studio-Dev-Docsas the primary authority. - Implement only the assigned milestone and its validation/evidence.
- Update
docs/DEVELOPMENT_PLAN.md, the relevant core documents, anddocs/CHANGELOG.md. - Build, test, audit the diff, and create the milestone commit.
Product and toolchain
Signal Studio is a Windows offline IQ-signal analysis product and reusable C++20 platform. The production stack is Qt 6.11 Widgets, CMake, Ninja, and MSVC 2022 x64. Optional CUDA support must degrade cleanly to CPU and must never be installed automatically.
Authority and scope
Authority order:
docs/baseline/Signal-Studio-Dev-Docs/(immutable BL1.0 snapshot)CODEX_FULL_DEVELOPMENT_TASK.md- the active milestone task
docs/DEVELOPMENT_PLAN.mddocs/ARCHITECTURE.md,docs/UI_DESIGN.md,docs/TEST_PLAN.md,docs/DECISIONS.md,docs/CHANGELOG.md
The former upstream content is not an implementation dependency. Its preserved recovery refs are archive/pre-signal-studio-dev-20260722-145422 and pre-signal-studio-dev-20260722-145422.
Engineering rules
- Public modules must follow the approved dependency DAG and expose only public, third-party-free C++ contracts.
- Qt is private to Visualization and Workbench.
- UI work must not block the main thread; background work must not touch
QWidgetdirectly. - Large files are accessed in bounded chunks and are never committed.
- Do not add placeholders, fake results, disabled failing tests, or unverified completion claims.
- Every new behavior has a test or an explicit, honest reason why it is not currently testable.
- Do not edit the approved baseline, external source documents, external test recordings, or
references_rep/.
Completion gate
The milestone is complete only when its scoped implementation works, Debug and Release validations required by the task pass, install/consumer checks pass where required, evidence is recorded, the baseline remains intact, and the Git working tree is clean after the milestone commit.
