Skip to content

sno-ai/sno-station-skills / skills/R-recursive-self-improvement/rem-reflect/skill

rem-reflect

Verified

Self Learning from this machine's Claude Code, Codex, Hermes, OpenClaw and Cursor sessions. Decide skill changes and lessons with accept/reject/tbd; recall lessons at session start.

FileKindSize
SKILL.mdskill md14.1 KB
references/labeler.mdmarkdown1.2 KB
references/labeler.schema.jsonconfig1.7 KB
references/local-settings.jsonconfig126 B
references/local-writer.schema.jsonconfig2.3 KB
references/proposal.schema.jsonconfig3.2 KB
references/render.jsonconfig245 B
references/signals.jsonconfig71 B
references/text.jsonconfig4.0 KB
scripts/adopt.test.tsscript13.0 KB
scripts/adopt.tsscript14.3 KB
scripts/agent-sessions.tsscript9.1 KB
scripts/allowance-fallback.test.tsscript16.0 KB
scripts/allowance-request-isolation.test.tsscript7.1 KB
scripts/backend.tsscript9.1 KB
scripts/calls.tsscript8.6 KB
scripts/catalogue-cloud.test.tsscript1.5 KB
scripts/catalogue.tsscript3.2 KB
scripts/chunk.tsscript2.1 KB
scripts/cloud-apply.test.tsscript25.2 KB
scripts/cloud-batch.test.tsscript11.2 KB
scripts/cloud-day.test.tsscript6.8 KB
scripts/cloud-verdict.test.tsscript12.1 KB
scripts/cloud-wait.test.tsscript1.3 KB
scripts/cloud.tsscript24.4 KB
scripts/config.tsscript8.1 KB
scripts/cursor.test.tsscript16.1 KB
scripts/cursor.tsscript6.7 KB
scripts/evidence.tsscript1.5 KB
scripts/first-message.test.tsscript10.3 KB
scripts/harvest.test.tsscript16.5 KB
scripts/harvest.tsscript22.6 KB
scripts/hermes-openclaw.test.tsscript25.6 KB
scripts/identity.test.tsscript3.3 KB
scripts/identity.tsscript3.5 KB
scripts/installed-roots.test.tsscript11.0 KB
scripts/journey-adopt-lesson.test.tsscript4.1 KB
scripts/journey-ops.test.tsscript8.0 KB
scripts/labeler.test.tsscript3.6 KB
scripts/labeler.tsscript9.5 KB
scripts/ledger.tsscript2.1 KB
scripts/lessons.tsscript4.7 KB
scripts/local-filter.test.tsscript3.9 KB
scripts/local-first-output.test.tsscript22.1 KB
scripts/local-settings.tsscript1.4 KB
scripts/local-writer.tsscript12.6 KB
scripts/login-in-place.test.tsscript5.8 KB
scripts/model-json.tsscript4.1 KB
scripts/no-network.test.tsscript5.0 KB
scripts/observe.tsscript1.4 KB
scripts/page-journey.test.tsscript6.7 KB
scripts/pages.test.tsscript4.1 KB
scripts/pages.tsscript4.8 KB
scripts/proposer-loop.test.tsscript1.5 KB
scripts/proposer-validate.test.tsscript9.1 KB
scripts/proposer.tsscript8.7 KB
scripts/recall-hook.test.tsscript20.9 KB
scripts/recall.test.tsscript31.4 KB
scripts/recall.tsscript18.2 KB
scripts/reflect.test.tsscript9.3 KB
scripts/reflect.tsscript14.3 KB
scripts/rem-reflectexecutablescript823 B
scripts/rem-reflect.tsscript17.8 KB
scripts/render-chunk.test.tsscript7.2 KB
scripts/render.tsscript9.7 KB
scripts/report.tsscript8.2 KB
scripts/run-status.test.tsscript19.1 KB
scripts/sampling.test.tsscript2.1 KB
scripts/sampling.tsscript915 B
scripts/selftest-guard.test.tsscript4.2 KB
scripts/selftest/bin/claudeexecutablescript94 B
scripts/selftest/bin/codexexecutablescript93 B
scripts/selftest/bin/shim-core.cjsscript4.6 KB
scripts/selftest/bin/snoexecutablescript5.7 KB
scripts/selftest/fixtures/hermes-session-export.jsonlother1.5 KB
scripts/selftest/fixtures/openclaw-events.jsonlother3.7 KB
scripts/selftest/fixtures/verdict-traces.jsonconfig16.6 KB
scripts/selftest/journey-e2e.shexecutablescript1.4 KB
scripts/selftest/journey.mjsscript9.5 KB
scripts/selftest/observe-journey.mjsscript12.5 KB
scripts/selftest/run-selftest.shexecutablescript7.0 KB
scripts/selftest/spawn-python.mjsexecutablescript765 B
scripts/session.test.tsscript5.2 KB
scripts/session.tsscript251 B
scripts/signal-local.test.tsscript7.0 KB
scripts/skill-impact.test.tsscript6.2 KB
scripts/station-settings.test.tsscript13.6 KB
scripts/store-memory.test.tsscript3.4 KB
scripts/store.tsscript7.7 KB
scripts/test-helpers.tsscript15.3 KB
scripts/text.tsscript760 B
scripts/trigger.test.tsscript3.6 KB
scripts/trigger.tsscript2.5 KB
scripts/verdicts.test.tsscript8.1 KB
scripts/verdicts.tsscript8.0 KB

scripts/lessons.ts

View on GitHub
import { reflectionFiles, isObject } from './config.ts';
import { message } from './text.ts';
import { closeSync, existsSync, fsyncSync, openSync, readFileSync, writeSync } from 'node:fs';
import { dirname, join } from 'node:path';
import type { Evidence } from './evidence.ts';
import type { CounterExamples, Scenario } from './pages.ts';
import type { VerdictRef } from './verdicts.ts';
import type { TriggerMatch } from './trigger.ts';
import { privateDirectory } from './store.ts';

export interface LessonInput {
  situation: Scenario; advice: string; because: string; applies_to: string;
  expected_result?: string; success_criteria?: string; memory_fact_ids?: string[];
  polarity: 'from_failure' | 'from_success'; evidence: Evidence[]; counter_examples: CounterExamples;
}
export interface Lesson extends LessonInput {
  lesson_id: string; page_id: string; status: 'candidate' | 'accepted' | 'rejected' | 'tbd' | 'under_review';
  count: number; helped: number; harmful: number; measured: boolean; created_run: string;
  project_id: string; agent_id: string; user_id: string; skill_target: string | null; scenario: Scenario;
  listed?: boolean; judgment_id?: string; verification?: { accepted?: boolean };
  verdict_ref?: VerdictRef; trigger_match?: TriggerMatch | null;
  did_not_prevent?: boolean; criterion_judgment?: Record<string, unknown>;
}

export function lessonContext(lesson: Lesson): string {
  const fields: [string, string | undefined][] = [
    ['situation', JSON.stringify(lesson.situation)], ['advice', lesson.advice],
    ['expected_result', lesson.expected_result], ['success_criteria', lesson.success_criteria],
    ['memory_fact_ids', lesson.memory_fact_ids === undefined ? undefined : JSON.stringify(lesson.memory_fact_ids)],
    ['skill_target', JSON.stringify(lesson.skill_target)],
  ];
  return fields.flatMap(([key, value]) => value === undefined ? [] : [message('lessonField', { key, value })]).join('\n');
}
export function appendRows(path: string, rows: readonly unknown[]): void {
  if (!rows.length) return;
  privateDirectory(dirname(path));
  const fd = openSync(path, 'a', 0o600);
  try { for (const row of rows) writeSync(fd, `${JSON.stringify(row)}\n`); fsyncSync(fd); }
  finally { closeSync(fd); }
}
// Last-row-wins over an append-only lessons file. `readLessons` reads the working file;
// recall reads the same shape from a HEAD snapshot, so the parse lives here.
export function lessonsFrom(text: string): Lesson[] {
  const current = new Map<string, Lesson>();
  for (const line of text.split('\n').filter(Boolean)) {
    const value: unknown = JSON.parse(line);
    if (!isObject(value) || typeof value.lesson_id !== 'string' || typeof value.status !== 'string') throw new Error(message('lessonRow'));
    current.set(value.lesson_id, value as unknown as Lesson);
  }
  return [...current.values()];
}
export function readLessons(store: string): Lesson[] {
  const path = join(store, reflectionFiles.lessons);
  if (!existsSync(path)) return [];
  return lessonsFrom(readFileSync(path, 'utf8'));
}
export interface LessonRead { session_id: string; lesson_id: string }
export function readLessonReads(store: string, log: string[]): LessonRead[] {
  const path = join(store, reflectionFiles.usage);
  if (!existsSync(path)) return [];
  const reads: LessonRead[] = [];
  for (const line of readFileSync(path, 'utf8').split('\n').filter(Boolean)) {
    let value: unknown;
    try { value = JSON.parse(line); } catch { log.push(message('usageMalformed')); continue; }
    if (isObject(value) && value.type === 'read' && typeof value.session_id === 'string' && typeof value.lesson_id === 'string') {
      reads.push({ session_id: value.session_id, lesson_id: value.lesson_id });
    }
  }
  return reads;
}
export interface LessonsShown { session_id: string; lesson_ids: string[] }
// Lessons each session was shown (session-start list and first-message recall), merged per session.
export function readLessonsShown(store: string, log: string[]): LessonsShown[] {
  const path = join(store, reflectionFiles.usage);
  if (!existsSync(path)) return [];
  const shown = new Map<string, Set<string>>();
  for (const line of readFileSync(path, 'utf8').split('\n').filter(Boolean)) {
    let value: unknown;
    try { value = JSON.parse(line); } catch { log.push(message('usageMalformed')); continue; }
    if (!isObject(value) || value.type !== 'shown' || typeof value.session_id !== 'string' || !Array.isArray(value.lesson_ids)) continue;
    const ids = shown.get(value.session_id) ?? new Set<string>();
    for (const id of value.lesson_ids) if (typeof id === 'string') ids.add(id);
    shown.set(value.session_id, ids);
  }
  return [...shown].filter(([, ids]) => ids.size > 0).map(([session_id, ids]) => ({ session_id, lesson_ids: [...ids] }));
}
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 472kUpdated Claude CodeCodexUnverifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall