name: review-analytics description: Review analytics modules for correctness — verify axiom compliance, Beta-Binomial usage, detail JSON completeness, and DuckDB write patterns.
Review Analytics Module
Review one or more analytics modules in src/analytics/ for:
Checklist
- Axiom compliance — Does the module trace to exactly one axiom from
spec.md§3? - Beta-Binomial — If applicable, does it use
bayes.rs(not hand-rolled)? - Detail JSON — Does every
analyticsINSERT include detail with:horizon(e.g., "5D")conditioning_set(e.g., "trending, low_vol")sample_size(integer)ci_lowerandci_upper(95% credible interval)
- Config usage — Are signal parameters from
cfg.signals.*, not hardcoded? - DuckDB patterns:
INSERT OR REPLACE INTO analyticsfor idempotency- Date params as
YYYY-MM-DDstrings - No
Connectionacross.awaitboundaries
- Edge cases:
- Empty data (no prices for date) → returns
Ok(0), not error - Division by zero in z-scores →
zscore_clampedhandles std=0 - NaN/Inf propagation → clamped or skipped
- Empty data (no prices for date) → returns
How to Run
# Review a specific module
claude "Review src/analytics/momentum.rs using the review-analytics skill"
# Review all modules with codex-par
# (use the run-with-codex-par skill for parallel review)
Output Format
For each module, report:
- PASS / FAIL per checklist item
- Specific line numbers for issues
- Suggested fixes (code snippets if needed)