06-reference/research

improve cron design spec

2026-05-23·research-brief·source: deep-research
improve-skillcronverify-stackjudge-driftcalibrationpipeline-rlhfscheduled-jobs

/improve cron - design spec for monthly verify-* axis sample-and-regrade

The question

Set up a /improve cron - monthly sample-and-regrade pass over each verify-* axis (10% of PASS verdicts re-graded by founder; revert axis to assisted status if disagreement >15%). Critic drift documented at 500-1000-example interval in production. Folds into existing scheduled-jobs.txt rhythm. (Source: deep-research-derivative from 2026-05-22-reward-hacking-patterns-llm-critic-systems.md. Priority: High, auto-promoted 2026-05-23 at 12/15.)

What we already know (from the vault)

What the web says

Convergences and contradictions

Convergence: the parent brief's design parameters (monthly cadence, 10% sample, threshold-based reversion) align with industry-standard 2026 LLM-as-judge best practices. The design needs no major rework; the implementation needs refinement on metric choice (kappa) and the small-N reality (founder-override as primary signal).

Sharp contradiction with parent brief's "15% disagreement" framing: raw % disagreement is the wrong metric on PASS-skewed binary verdicts. A 95% PASS axis with 5% true FAIL has ~95% baseline raw agreement just from base-rate luck; "15% disagreement" becomes either trivially-met (axis dies on noise) or unreachable (no drift detected). Cohen's kappa fixes this. New recommendation: kappa < 0.6 OR three consecutive months of single-instance founder override = revert to assisted.

Convergence-but-amplified: the parent brief recommended quarterly RGFMD adversarial self-generation as separate. The web data on stealthy preference drift suggests this should be tightened to monthly co-fire with /improve - the regrade catches drift after the fact; RGFMD catches blind spots before the policy finds them. Combined, they cover both failure surfaces in one cron pass.

No contradiction with existing schema work: the two-gate PASS/FAIL architecture (from 2026-05-20 SOP) is compatible with kappa scoring. Binary kappa formula works directly on PASS/FAIL pairs.

Synthesis for RDCO

Concrete design spec for /improve cron:

schedule: monthly, 1st of month, 09:00 ET (Sunday-safe)
cron_line: "0 9 1 * * /Users/ray/.claude/scripts/run-improve-cron.sh"

per_axis_pass:
  1. enumerate PASS verdicts from prior month (read from per-axis log file)
  2. if N_verdicts < 10: skip axis (insufficient signal); log "below-threshold"
  3. sample = max(5, ceil(0.10 * N_verdicts))  # ensure minimum 5 samples
  4. queue sample for founder review (Notion task: "/improve regrade Q for axis X")
  5. RGFMD step: prompt critic to generate 3 artifacts that would PASS its rubric but should semantically FAIL. Append to /improve task notes.

per_axis_signal_aggregation (after founder responds):
  - compute Cohen's kappa on PASS/FAIL agreement
  - count single-instance founder overrides
  - emit revert signal if kappa < 0.6 OR (overrides >= 1 for 3 consecutive months)

revert_action:
  - update per-axis YAML: status: graduated -> assisted
  - notify founder via iMessage (this IS a decision, not just status)
  - log to vault: ~/rdco-vault/01-projects/self-review/improve-cron-log.md

output_format:
  - per axis: name, N_verdicts, N_sampled, kappa, override_count, status, action
  - aggregate: total review burden (minutes), axes-at-risk count

Initial axis coverage (3 axes from verify- stack):*

Add as new verify-* skills graduate. Out-of-scope for v1: pipeline-critic seat in build-haiku-generator (different shape - test/code review, not artifact verification).

Review-burden budget: 10% of low-volume axes at <50 verdicts/month = <5 regrades per axis. Three axes = <15 founder regrades per month = ~20-30 minutes founder time. RGFMD adds ~10 min per axis = ~30 min. Total: ~1 hour/month founder time. This is the calibration tax; it is non-negotiable per Future AGI 2026 guidance.

Execution path - smallest-possible build:

  1. Create /Users/ray/.claude/skills/improve-cron/SKILL.md with the above design.
  2. Wrapper script at ~/.claude/scripts/run-improve-cron.sh that triggers the skill in non-interactive mode + drops the regrade task on the Notion board.
  3. Append cron line to ~/.claude/scripts/scheduled-jobs.txt.
  4. First scheduled run: 2026-06-01 09:00 ET (8 days from now). Initial sample will be small (May 22 onwards = ~10 days of verdicts); manually adjust sample target downward for first month.
  5. Self-bootstrapping: the skill itself becomes a verify-* axis candidate after 3 months of clean operation (does /improve grade its own grading? recurse with discipline).

Strategic implication beyond the immediate build: /improve cron is the first piece of RDCO infrastructure that explicitly closes the autonomous-but-calibrated loop. Self-rewriting skills + cadenced human-in-loop check IS the pattern Tan's "Thin Harness, Fat Skills" gestures at. The implementation should be designed to generalize: when MAC ships and clients deploy their own verify-* equivalents, /improve cron becomes the operational template they need. This is content + product, not just internal hygiene.

Open follow-ups

Sources

Vault:

Web: