Skip to content

code-yeongyu/oh-my-openagent / packages/shared-skills/skills/ulw-research

ulw-research

Unverified

Runs maximum-saturation research with a cooperating team, claim-graph gating, and a cited, QA'd deliverable. Use when the user explicitly asks for research or a deep investigation, including any 'ulw' research wording.

FileKindSize
AGENTS.mdmarkdown9.2 KB
ATTRIBUTION.mdmarkdown2.4 KB
SKILL.mdskill md42.2 KB
references/deliverable-phase.mdmarkdown49.1 KB
references/fact-ledger-grammar.mdmarkdown6.8 KB
references/fact-ledger.mdmarkdown24.4 KB
references/fidelity-claim-kinds.mdmarkdown5.2 KB
references/markdown-blocks.mdmarkdown721 B
references/report-gates.mdmarkdown32.0 KB
references/report-visualization.mdmarkdown15.4 KB
references/research-collection.mdmarkdown26.8 KB
references/research-delivery.mdmarkdown14.3 KB
references/unit-rules.mdmarkdown16.3 KB
scripts/claim-kinds.mjsscript11.2 KB
scripts/claim-kinds.test.tsscript13.5 KB
scripts/claim-prefix.test.tsscript4.9 KB
scripts/claims-index.mjsscript5.3 KB
scripts/claims-index.test.tsscript5.7 KB
scripts/cli-support.mjsscript4.1 KB
scripts/cli-support.test.tsscript4.3 KB
scripts/contracts-validation.test.tsscript3.3 KB
scripts/contracts.mjsscript26.1 KB
scripts/contracts.test.tsscript7.9 KB
scripts/conversion-altered.test.tsscript11.0 KB
scripts/conversion-originals.test.tsscript22.7 KB
scripts/conversion-probe-classes.test.tsscript45.2 KB
scripts/conversion-probe.mjsscript13.5 KB
scripts/conversion-probe.test.tsscript11.6 KB
scripts/copy-returns-fidelity-policy.test.tsscript10.4 KB
scripts/copy-returns-polish.test.tsscript12.1 KB
scripts/copy-returns.test.tsscript10.6 KB
scripts/css-hiding.mjsscript9.1 KB
scripts/css-lite.mjsscript7.6 KB
scripts/css-lite.test.tsscript6.4 KB
scripts/delivery-barrier-meaning.test.tsscript12.3 KB
scripts/delivery-barrier.test.tsscript11.4 KB
scripts/design-spec.mjsscript7.2 KB
scripts/design-spec.test.tsscript6.7 KB
scripts/entities.mjsscript2.5 KB
scripts/entry-guard.mjsscript794 B
scripts/fact-commands-fill.mjsscript6.6 KB
scripts/fact-commands-meaning.mjsscript12.6 KB
scripts/fact-commands-polish.mjsscript10.3 KB
scripts/fact-commands-verify.mjsscript12.6 KB
scripts/fact-commands.mjsscript13.8 KB
scripts/fact-derive-2.test.tsscript7.2 KB
scripts/fact-derive.mjsscript4.9 KB
scripts/fact-derive.test.tsscript10.8 KB
scripts/fact-expr.mjsscript4.5 KB
scripts/fact-fill.mjsscript11.7 KB
scripts/fact-fill.test.tsscript10.7 KB
scripts/fact-ledger-grammar.test.tsscript11.8 KB
scripts/fact-ledger-kinds.mjsscript16.5 KB
scripts/fact-ledger-kinds.test.tsscript9.3 KB
scripts/fact-ledger-legacy.test.tsscript8.9 KB
scripts/fact-ledger-schema.mjsscript11.9 KB
scripts/fact-ledger-schema.test.tsscript1.5 KB
scripts/fact-ledger.mjsscript5.5 KB
scripts/fact-ledger.test.tsscript9.7 KB
scripts/fact-locate.mjsscript12.1 KB
scripts/fact-locate.test.tsscript7.2 KB
scripts/fact-pairs.mjsscript8.3 KB
scripts/fact-pairs.test.tsscript6.6 KB
scripts/fact-recompute.mjsscript4.8 KB
scripts/fact-unit-dimensions-2.test.tsscript8.4 KB
scripts/fact-unit-dimensions.test.tsscript11.9 KB
scripts/fact-unit-rules.test.tsscript8.9 KB
scripts/fidelity-binding.mjsscript6.7 KB
scripts/fidelity-binding.test.tsscript4.0 KB
scripts/fidelity-brief.mjsscript6.4 KB
scripts/fidelity-brief.test.tsscript7.8 KB
scripts/fidelity-claims.mjsscript5.1 KB
scripts/fidelity-csv.mjsscript1.1 KB
scripts/fidelity-lexicon.mjsscript8.1 KB
scripts/fidelity-lexicon.test.tsscript6.0 KB
scripts/fidelity-originals.mjsscript9.9 KB
scripts/fidelity-policy.mjsscript10.1 KB
scripts/fidelity-records.mjsscript13.4 KB
scripts/fidelity-snapshot-readability.mjsscript2.2 KB
scripts/fidelity-sources.mjsscript4.3 KB
scripts/fidelity-state.mjsscript2.1 KB
scripts/fidelity-state.test.tsscript1.7 KB
scripts/fidelity-trace.mjsscript6.1 KB
scripts/fidelity-trace.test.tsscript3.3 KB
scripts/fidelity-value-unit.mjsscript13.3 KB
scripts/fidelity-values.mjsscript16.1 KB
scripts/fidelity-values.test.tsscript15.8 KB
scripts/format-extract-css.mjsscript5.1 KB
scripts/format-extract.mjsscript10.3 KB
scripts/format-extract.test.tsscript11.2 KB
scripts/gates-context.test.tsscript2.6 KB
scripts/gates-fidelity.mjsscript6.3 KB
scripts/gates-fidelity.test.tsscript3.3 KB
scripts/gates-figures.mjsscript9.9 KB
scripts/gates-layout.mjsscript6.6 KB
scripts/gates-layout.test.tsscript12.4 KB
scripts/gates-static-headings.test.tsscript961 B
scripts/gates-static.mjsscript8.1 KB
scripts/gates-static.test.tsscript14.9 KB
scripts/gates-structure.mjsscript4.7 KB
scripts/gates-text.mjsscript7.2 KB
scripts/glossary-vocabulary.test.tsscript1.7 KB
scripts/html-foreign-object.mjsscript2.8 KB
scripts/html-lite.mjsscript9.7 KB
scripts/html-lite.test.tsscript7.9 KB
scripts/html-markup.mjsscript7.0 KB
scripts/html-text-map.mjsscript4.8 KB
scripts/html-text-map.test.tsscript15.2 KB
scripts/layout-probe.mjsscript4.6 KB
scripts/layout-probe.test.tsscript4.2 KB
scripts/lexicon.mjsscript2.6 KB
scripts/lexicon.test.tsscript3.2 KB
scripts/markdown-closers.mjsscript4.9 KB
scripts/md-lite-boundaries.test.tsscript2.2 KB
scripts/md-lite.mjsscript7.8 KB
scripts/md-lite.test.tsscript10.3 KB
scripts/meaning-check.mjsscript9.7 KB
scripts/meaning-check.test.tsscript12.0 KB
scripts/number-grammar.mjsscript2.1 KB
scripts/number-grammar.test.tsscript1.8 KB
scripts/numerals.mjsscript12.0 KB
scripts/numerals.test.tsscript6.1 KB
scripts/outcome-start.mjsscript3.8 KB
scripts/outcome-start.test.tsscript5.0 KB
scripts/outcome.mjsscript10.5 KB
scripts/outcome.test.tsscript12.8 KB
scripts/page-source-locator.test.tsscript11.7 KB
scripts/particles-ko.mjsscript4.8 KB
scripts/particles-ko.test.tsscript4.3 KB
scripts/placeholder.mjsscript9.3 KB
scripts/placeholder.test.tsscript3.8 KB
scripts/polish-apply.mjsscript6.8 KB
scripts/polish-apply.test.tsscript19.7 KB
scripts/polish-diff.mjsscript1.7 KB
scripts/polish-diff.test.tsscript10.1 KB
scripts/polish-markup.test.tsscript14.0 KB
scripts/polish-partial.test.tsscript2.5 KB
scripts/polish-project.mjsscript5.8 KB
scripts/polish-rules.mjsscript9.8 KB
scripts/rational.mjsscript5.2 KB
scripts/rational.test.tsscript1.9 KB
scripts/raw-decode.mjsscript4.5 KB
scripts/raw-locator.mjsscript2.4 KB
scripts/raw-snapshot.test.tsscript7.3 KB
scripts/references-fences.test.tsscript1.2 KB
scripts/repair-tracker.mjsscript7.5 KB
scripts/repair-tracker.test.tsscript10.8 KB
scripts/report-tools-2.test.tsscript16.1 KB
scripts/report-tools-3.test.tsscript9.3 KB
scripts/report-tools-4.test.tsscript10.1 KB
scripts/report-tools-5.test.tsscript14.6 KB
scripts/report-tools-commands.mjsscript12.9 KB
scripts/report-tools.mjsscript2.6 KB
scripts/report-tools.test.tsscript12.1 KB
scripts/sentence-split.mjsscript3.0 KB
scripts/sentence-split.test.tsscript4.5 KB
scripts/snapshot-readability.test.tsscript7.0 KB
scripts/source-commands.mjsscript12.4 KB
scripts/source-integrity.test.tsscript18.1 KB
scripts/source-refresh.mjsscript5.2 KB
scripts/source-snapshot.mjsscript9.9 KB
scripts/source-snapshot.test.tsscript6.3 KB
scripts/source-view.mjsscript5.0 KB
scripts/sources-citation.mjsscript12.1 KB
scripts/sources-citation.test.tsscript14.8 KB
scripts/tests/contracts-support.tsscript3.5 KB
scripts/tests/delivery-barrier-session.tsscript3.3 KB
scripts/tests/derive-clock.tsscript341 B
scripts/tests/fact-derive-support.tsscript1.9 KB
scripts/tests/fact-unit-dimensions-support.tsscript1.5 KB
scripts/tests/fact-unit-rules-support.tsscript16.8 KB
scripts/tests/fidelity-values-support.tsscript1.6 KB
scripts/tests/fixtures/assets/figure-1.svgother141 B
scripts/tests/fixtures/bad-report.htmlother2.1 KB
scripts/tests/fixtures/boxes.jsonconfig3.2 KB
scripts/tests/fixtures/conversion-probe.htmlother485 B
scripts/tests/fixtures/design-spec.mdmarkdown458 B
scripts/tests/fixtures/fidelity-brief-locked.mdmarkdown571 B
scripts/tests/fixtures/fidelity-brief-pending.mdmarkdown574 B
scripts/tests/fixtures/fidelity/assets/share.csvother40 B
scripts/tests/fixtures/fidelity/claim-graph.mdmarkdown449 B
scripts/tests/fixtures/fidelity/gen-legacy-dev.mjsscript5.0 KB
scripts/tests/fixtures/fidelity/ledger-basic.jsonconfig5.1 KB
scripts/tests/fixtures/fidelity/ledger-legacy-dev.jsonconfig18.3 KB
scripts/tests/fixtures/fidelity/ledger-verify.jsonconfig9.1 KB
scripts/tests/fixtures/fidelity/polish-edits.jsonconfig303 B
scripts/tests/fixtures/fidelity/report-bad.htmlother821 B
scripts/tests/fixtures/fidelity/report-good.htmlother2.4 KB
scripts/tests/fixtures/fidelity/sources/S4.htmlother680 B
scripts/tests/fixtures/fidelity/sources/S4/acronyms.jsonconfig36 B
scripts/tests/fixtures/fidelity/sources/S4/meta.jsonconfig256 B
scripts/tests/fixtures/fidelity/sources/S4/sentences.jsonlother623 B
scripts/tests/fixtures/fidelity/sources/S4/text.txtmarkdown300 B
scripts/tests/fixtures/fidelity/sources/S5/acronyms.jsonconfig3 B
scripts/tests/fixtures/fidelity/sources/S5/meta.jsonconfig235 B
scripts/tests/fixtures/fidelity/sources/S5/sentences.jsonlother53 B
scripts/tests/fixtures/fidelity/sources/S5/text.txtmarkdown10 B
scripts/tests/fixtures/fidelity/sources/S9.txtmarkdown128 B
scripts/tests/fixtures/good-report.htmlother2.7 KB
scripts/tests/fixtures/reference-report.htmlother2.5 KB

scripts/fact-ledger-legacy.test.ts

View on GitHub
import { describe, expect, onTestFinished, test } from "bun:test"
import { copyFileSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from "node:fs"
import { tmpdir } from "node:os"
import { join } from "node:path"

import { recompute } from "./fact-derive.mjs"
import { derive } from "./tests/derive-clock"
import { LEDGER_FILENAME, addRow, emptyLedger, readLedger, validateLedger, writeLedger } from "./fact-ledger.mjs"

// Generated by dev's own addRow (tests/fixtures/fidelity/gen-legacy-dev.mjs pins the dev commit):
// no context/precision/compatibility columns, alias units, unreduced and zero-padded exacts.
const FIXTURE = join(import.meta.dir, "tests", "fixtures", "fidelity", "ledger-legacy-dev.json")
const SOURCE_IDS = [
  "F1",
  "F2",
  "F3",
  "F4",
  "F5",
  "F6",
  "F7",
  "F8",
  "Q1",
  "F9",
  "F10",
  "F11",
  "F12",
  "F13",
  "F16",
  "F17",
  "F18",
]

type Row = Record<string, unknown>
type Ledger = { schemaVersion: number; rows: Row[]; events: unknown[] }

function tempDir(): string {
  const dir = mkdtempSync(join(tmpdir(), "ulw-legacy-"))
  onTestFinished(() => rmSync(dir, { recursive: true, force: true }))
  return dir
}

const fixture = (): Ledger => JSON.parse(readFileSync(FIXTURE, "utf8"))
const rowOf = (ledger: Ledger, id: string): Row => ledger.rows.find((row) => row.fact_id === id) as Row

function loaded(): { dir: string; ledger: Ledger } {
  const dir = tempDir()
  copyFileSync(FIXTURE, join(dir, LEDGER_FILENAME))
  return { dir, ledger: readLedger(dir) as Ledger }
}

describe("ledgers written by dev's writer (dimension 31 wins at read time)", () => {
  test("#given dev's generated ledger #when validated #then it has no errors", () => {
    expect(validateLedger(fixture())).toEqual([])
  })

  test("#given dev's ledger #when read #then exacts, decimals, and source units are normalized", () => {
    const { ledger } = loaded()
    expect(["F1", "F3", "F4", "F5", "F6", "F8", "F11"].map((id) => rowOf(ledger, id).unit)).toEqual([
      "km",
      "%",
      "%p",
      "person",
      "KRW-e3",
      "%",
      "km",
    ])
    const exacts = Object.fromEntries(
      ["F10", "F11", "F12", "F13", "F14", "F15", "F18"].map((id) => [id, rowOf(ledger, id).exact]),
    )
    expect(exacts).toEqual({
      F10: { num: "1", den: "1" },
      F11: { num: "5", den: "2" },
      F12: { num: "7", den: "1" },
      F13: { num: "-5", den: "2" },
      F14: { num: "41", den: "2" },
      F15: { num: "12000", den: "1" },
      F18: { num: "3", den: "1", note: "from the brief" },
    })
    expect(rowOf(ledger, "F7").value).toBe("7")
    for (const id of SOURCE_IDS) {
      for (const column of ["context", "precision", "compatibility"]) expect(rowOf(ledger, id)[column]).toBeNull()
    }
    for (const id of ["F14", "F15"]) expect(Object.hasOwn(rowOf(ledger, id), "precision")).toBe(false)
    expect(validateLedger(ledger)).toEqual([])
  })

  test("#given dev's ledger #when measured rows are summed #then the new row is canonical and recomputes", () => {
    for (const ledger of [fixture(), loaded().ledger]) {
      const result = derive(ledger, { op: "sum", operands: ["F1", "F2"], unit: "km" })
      expect(result.error).toBeUndefined()
      expect(result.row).toMatchObject({
        kind: "derived",
        unit: "km",
        value: "21",
        exact: { num: "41", den: "2" },
        compatibility: "checked",
      })
      const padded = derive(ledger, { op: "sum", operands: ["F1", "F7"], unit: "km" })
      expect(padded.row).toMatchObject({ value: "19", exact: { num: "19", den: "1" } })
      expect(validateLedger(ledger)).toEqual([])
      expect(recompute(ledger, result.row).ok).toBe(true)
    }
  })

  test("#given a legacy derived or converted row #when recomputed #then it reports a legacy derived row", () => {
    for (const ledger of [fixture(), loaded().ledger]) {
      for (const id of ["F14", "F15"]) {
        const result = recompute(ledger, rowOf(ledger, id))
        expect(result.ok).toBe(false)
        expect(result.shape).toBe("legacy derived row")
      }
    }
  })

  test("#given a legacy derived or converted row #when used as an operand #then derive refuses it", () => {
    const ledger = fixture()
    const before = ledger.rows.length
    for (const id of ["F14", "F15"]) {
      const result = derive(ledger, { op: "sum", operands: [id, "F2"], unit: "km" })
      expect(result.error).toBe("incompatible_operands")
      expect(result.shape).toBe("legacy derived row")
    }
    expect(ledger.rows.length).toBe(before)
  })

  test("#given a loadable row the strict dimensions reject #when used as an operand #then it is flagged by dimension", () => {
    const ledger = loaded().ledger
    const before = ledger.rows.length
    for (const [id, shape] of [
      ["F16", "dimension 18"],
      ["F17", "dimension 1"],
    ]) {
      const result = derive(ledger, { op: "sum", operands: [id, "F2"], unit: "km" })
      expect(result.error).toBe("incompatible_operands")
      expect(result.shape).toBe(shape)
    }
    expect(ledger.rows.length).toBe(before)
  })

  test("#given a new source row with a flaw dev accepted #when added #then this version's writer refuses it", () => {
    const ledger = fixture()
    const blank = { ...rowOf(ledger, "F16"), fact_id: undefined, label: "blank-again" }
    expect(() => addRow(ledger, blank)).toThrow("dimension 18")
  })

  test("#given dev's ledger #when read and written twice #then the second pass changes nothing", () => {
    const { dir, ledger } = loaded()
    writeLedger(dir, ledger)
    const once = readFileSync(join(dir, LEDGER_FILENAME), "utf8")
    const written = JSON.parse(once) as Ledger
    expect(rowOf(written, "F11").exact).toEqual({ num: "5", den: "2" })
    expect(Object.hasOwn(rowOf(written, "F14"), "precision")).toBe(false)
    writeLedger(dir, readLedger(dir))
    expect(readFileSync(join(dir, LEDGER_FILENAME), "utf8")).toBe(once)
    expect(readLedger(dir)).toEqual(written)
  })

  test("#given a current derived row with its later columns stripped #when validated #then it reads as legacy and never recomputes", () => {
    const ledger = fixture()
    const made = derive(ledger, { op: "sum", operands: ["F1", "F2"], unit: "km" }).row as Row
    const stripped = rowOf(ledger, made.fact_id as string)
    for (const column of ["context", "precision", "compatibility"]) delete stripped[column]
    stripped.unit = "kilometers"
    expect(validateLedger(ledger)).toEqual([])
    expect(recompute(ledger, stripped).shape).toBe("legacy derived row")
  })

  test("#given a ledger written by this version #when read and written #then it is unchanged", () => {
    const dir = tempDir()
    const ledger = emptyLedger() as Ledger
    const source = {
      kind: "measured",
      raw: "",
      quote: "",
      source_id: "S1",
      locator: { artifact: "sources/S1/text.txt", char_start: 0, char_end: 4 },
      snapshot_sha256: "b".repeat(64),
      extracted_by: "fact add --find",
      observed_at: "2026-10-23T08:00:00Z",
    }
    addRow(ledger, { ...source, value: "3", unit: "kilometers", label: "a" })
    addRow(ledger, { ...source, value: "4", unit: "km", label: "b" })
    expect(derive(ledger, { op: "sum", operands: ["F1", "F2"], unit: "km" }).error).toBeUndefined()
    writeLedger(dir, ledger)
    const first = readFileSync(join(dir, LEDGER_FILENAME), "utf8")
    writeLedger(dir, readLedger(dir))
    expect(readFileSync(join(dir, LEDGER_FILENAME), "utf8")).toBe(first)
    expect(readLedger(dir)).toEqual(JSON.parse(first))
  })

  test("#given a legacy exact with an unknown key #when read and written #then the key survives and the row is refused as an operand", () => {
    const { dir, ledger } = loaded()
    writeLedger(dir, ledger)
    const written = JSON.parse(readFileSync(join(dir, LEDGER_FILENAME), "utf8")) as Ledger
    expect(rowOf(written, "F18").exact).toEqual({ num: "3", den: "1", note: "from the brief" })
    const result = derive(ledger, { op: "sum", operands: ["F18", "F2"], unit: "km" })
    expect(result.error).toBe("incompatible_operands")
    expect(result.shape).toBe("dimension 7")
    expect(recompute(ledger, rowOf(ledger, "F18")).ok).toBe(false)
  })

  test("#given an assumed row whose value and exact disagree #when read #then it loads flagged and a new row is refused (dimension 32)", () => {
    const dir = tempDir()
    const seed = fixture()
    const mismatched = {
      ...rowOf(seed, "F11"),
      fact_id: "F19",
      label: "mismatched-exact",
      unit: "km",
      value: "1.5",
      exact: { num: "3", den: "1" },
    }
    seed.rows.push(mismatched)
    writeFileSync(join(dir, LEDGER_FILENAME), JSON.stringify(seed))
    const ledger = readLedger(dir) as Ledger
    expect(rowOf(ledger, "F19").value).toBe("1.5")
    const result = derive(ledger, { op: "sum", operands: ["F19", "F2"], unit: "km" })
    expect(result.error).toBe("incompatible_operands")
    expect(result.shape).toBe("dimension 32")
    expect(() => addRow(ledger, { ...mismatched, fact_id: undefined, label: "mismatch-new" })).toThrow("dimension 32")
  })
})
finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the workStars: 322kUpdated Claude CodeCodexVerifiedInstall
systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixesStars: 322kUpdated Claude CodeCodexVerifiedInstall
test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation codeStars: 322kUpdated Claude CodeCodexVerifiedInstall
skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.Stars: 198kUpdated Claude CodeCodexVerifiedInstall