Skip to content

Docs: sweep retired reaction-classifier narration from the samskara docs#382

Merged
sysread merged 2 commits into
mainfrom
claude/samskara-system-overview-gswh6i
Jul 3, 2026
Merged

Docs: sweep retired reaction-classifier narration from the samskara docs#382
sysread merged 2 commits into
mainfrom
claude/samskara-system-overview-gswh6i

Conversation

@sysread

@sysread sysread commented Jul 3, 2026

Copy link
Copy Markdown
Owner

SYNOPSIS

Docs-only hygiene: bring the samskara docs (dev + user) in line with the evaluation-judge era, log today's hosted QA runs, and capture the reasoning-token-budget convention in CLAUDE.md.

PURPOSE

The evaluation-judge redesign retired the live reaction classifier, the wall-clock decay sweep, and sqrt-N cohort reinforcement - but docs/dev/samskara.md still narrated all three in present tense in ~a dozen places, and two user-manual panels explained resolution via the retired classifier. A stale dev doc misleads the next session with full confidence.

DESCRIPTION

  • docs/dev/samskara.md: prompt inventory drops the nonexistent REACTION_PROMPT (five prompts, not six); data model gains the verdict column and describes was_confirmed as the judge-written legacy shadow; driver-split rationale now says evaluation rides its own day-gated cron; deleted the retired sqrt-N reinforcement gotcha; rewrote the "neutral has no boolean state" gotcha (the 15-minute backdate is gone - filter on verdict); Observability calibration note explains pending fires in judge terms (~88% not-engaged is recall working, not a defect)
  • docs/qa/use-cases/samskara-decay.md: append-only results rows for today's two hosted-judge executions (truncation fail @ a1c3424, post-budget-fix pass @ 09a25f3)
  • CLAUDE.md: new "Venice sub-completions on reasoning models" convention - max_completion_tokens pays for the thinking pass, which scales with input size; has bitten second-thoughts (Fix the second-thoughts reviewer: non-reasoning model + tolerant parse #370) and the samskara judge (Samskara judge: budget the reasoning pass, pin low effort #378)
  • docs/user/samskara.md + docs/user/chat.md: Activity note and cohort-pill description reworded to the next-day-judge model

Notes:

  • No code changes; vitest (incl. markdownlint + styles passes) green.
  • The deleted sqrt-N gotcha describes a mechanism that no longer exists in samskara_apply_evaluation - intentional removal, not lost documentation (git preserves it).

Generated by Claude Code

claude added 2 commits July 3, 2026 17:15
The evaluation-judge redesign retired the live 1-10 minute reaction
classifier, the wall-clock decay sweep, and the sqrt-N cohort
reinforcement, but samskara.md still narrated all three in present
tense in roughly a dozen places - the prompt inventory listed a
REACTION_PROMPT that no longer exists, the data model omitted the
verdict column and described was_confirmed as classifier-written, the
driver-split rationale explained a tail phase that is not a phase
anymore, and two gotchas (sqrt-N reinforcement, the 15-minute neutral
backdate) described mechanisms that are gone. Rewritten against
current reality: verdict is the authoritative fire judgment,
was_confirmed is the legacy shadow, evaluation rides its own
day-gated cron, and the Observability calibration note now explains
pending fires in judge terms.

Also: append the 2026-07-03 hosted-judge executions to the
samskara-decay QA results log (the pre-fix truncation fail and the
post-budget-fix pass), and capture the "max_completion_tokens pays
for the reasoning pass" constraint as a CLAUDE.md convention - it has
now bitten two features (second-thoughts reviewer, samskara judge)
and is repo-wide scope.
The samskara tab's Activity note and the per-message cohort pill
description both still explained resolution in terms of the retired
live reaction classifier ("only the turn right after an instinct
fires can confirm it"). Reworded to the next-day judge: fires resolve
in a batch after the conversation settles, recent fires are always
pending, and one-question conversations are skipped by design.
@sysread sysread merged commit 017dddc into main Jul 3, 2026
1 check passed
@sysread sysread deleted the claude/samskara-system-overview-gswh6i branch July 3, 2026 17:16
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants