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/delivery-barrier.test.ts

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

import { sha256Of } from "./cli-support.mjs"
import { DEFECT_CODES } from "./contracts.mjs"
import { fidelityProblems, FIDELITY_RECORDS, RECORD_ENVELOPE, writeFidelityRecord } from "./fidelity-records.mjs"
import { BLOCKER, delivered, expectRefused, fullyRecorded } from "./tests/delivery-barrier-session.ts"

// Enumerate the source registry, not a second list of today's fidelity codes.
for (const [code, entry] of Object.entries(DEFECT_CODES)) {
  if (!entry.integrity && entry.severity === "minor") continue
  test(`#given registry blocker ${code} #when verified and finished #then delivery refuses despite a demoted row`, async () => {
    const { dir, invoke } = await delivered("html", [code])
    for (const command of ["verify", "finish"]) {
      const result = await invoke([command])
      expect(result.exitCode).toBe(1)
      expect(result.json.problems).toContainEqual(
        expect.objectContaining({ code: "fidelity_unresolved", codes: [code] }),
      )
    }
    expect(JSON.parse(readFileSync(join(dir, "outcome.json"), "utf8")).finishedAt).toBeNull()
  })
}

test("#given an unknown defect code #when verified or finished #then delivery refuses with its reason", async () => {
  const { invoke } = await delivered("html", ["future_fidelity_defect"])
  for (const command of ["verify", "finish"]) {
    const result = await invoke([command])
    expect(result.exitCode).toBe(1)
    expect(JSON.stringify(result.json.problems)).toContain("unknown defect code future_fidelity_defect")
  }
})

test("#given a registry non-blocker #when verified and finished #then delivery passes", async () => {
  const entry = Object.entries(DEFECT_CODES).find(([, value]) => !value.integrity && value.severity === "minor")
  if (!entry) throw new Error("registry must have a non-blocking entry")
  const { invoke } = await delivered("html", [entry[0]])
  expect((await invoke(["verify"])).exitCode).toBe(0)
  expect((await invoke(["finish"])).exitCode).toBe(0)
})

for (const format of ["html", "pdf", "docx"]) {
  test(`#given delivered ${format} without any ledger or gate record #when verified and finished #then both refuse`, async () => {
    const { invoke } = await delivered(format)
    for (const command of ["verify", "finish"]) {
      const result = await invoke([command])
      expect(result.exitCode).toBe(1)
      expect(JSON.stringify(result.json.problems)).toContain("fidelity gate not run")
    }
  })
}

test("#given a missing gate #when explicitly skipped with a reason #then the logged choice permits delivery", async () => {
  const { dir, invoke } = await delivered()
  const now = "2026-01-01T12:01:00.000Z"
  await invoke(["gate", "fidelity", "not_run", "--reason", "No factual content in this edition", "--now", now])
  const manifest = JSON.parse(readFileSync(join(dir, "outcome.json"), "utf8"))
  expect(manifest.gateHistory).toContainEqual({
    gate: "fidelity",
    status: "not_run",
    reason: "No factual content in this edition",
    at: now,
  })
  expect((await invoke(["verify"])).exitCode).toBe(0)
  expect((await invoke(["finish"])).exitCode).toBe(0)
  await invoke(["gate", "fidelity", "pass"])
  expect((await invoke(["verify"])).exitCode).toBe(1)
})

test("#given a missing gate #when skipped without a meaningful reason #then the command refuses", async () => {
  const { invoke } = await delivered()
  for (const reason of [[], ["--reason", "   "]]) {
    await expect(invoke(["gate", "fidelity", "not_run", ...reason])).rejects.toThrow("reason")
  }
})

test("#given a fact ledger and an unverified edition #when the gate is skipped with a reason #then delivery still refuses", async () => {
  const { dir, invoke } = await delivered()
  writeFileSync(join(dir, "fact-ledger.json"), JSON.stringify({ version: 1, facts: [] }))
  await invoke(["gate", "fidelity", "not_run", "--reason", "This harness has no verifier"])
  for (const command of ["verify", "finish"]) {
    const result = await invoke([command])
    expect(result.exitCode).toBe(1)
    expect(JSON.stringify(result.json.problems)).toContain("fidelity gate not run")
  }
})

test("#given a stale fidelity record nobody attached #when the gate is skipped with a reason #then delivery still refuses", async () => {
  const { dir, path, invoke } = await delivered()
  writeFidelityRecord(join(dir, "fidelity-defects.json"), "fidelity", {
    artifact_sha256: "0".repeat(64),
    report: path,
    defects: [],
  })
  await invoke(["gate", "fidelity", "not_run", "--reason", "This harness has no verifier"])
  for (const command of ["verify", "finish"]) {
    const result = await invoke([command])
    expect(result.exitCode).toBe(1)
    expect(JSON.stringify(result.json.problems)).toContain("fidelity gate not run")
  }
})

test("#given an explicit skip and an existing blocker #when verified #then the skip cannot release the blocker", async () => {
  const { invoke } = await delivered("html", ["claim_status_invalid"])
  await invoke(["gate", "fidelity", "not_run", "--reason", "Unsupported edition"])
  expect((await invoke(["verify"])).exitCode).toBe(1)
})

test("#given the record table #when every row is read #then each row has every rule column and an arranged session path", async () => {
  const { recordPath } = await fullyRecorded()
  expect(Object.keys(recordPath).sort()).toEqual(FIDELITY_RECORDS.map((entry) => entry.kind).sort())
  for (const entry of FIDELITY_RECORDS) {
    for (const column of ["targets", "requiredWhen", "remedy", "blocking"] as const)
      expect(typeof entry[column], `${entry.kind}.${column}`).toBe("function")
    expect(RECORD_ENVELOPE).toContain(entry.bindsTo)
  }
})

// The table is the barrier's spec: every row gets the same six cases.
for (const entry of FIDELITY_RECORDS) {
  describe(`record row ${entry.kind}`, () => {
    test("#given the record is missing while required #when verified and finished #then delivery refuses", async () => {
      const session = await fullyRecorded()
      unlinkSync(session.recordPath[entry.kind])
      await expectRefused(session, { code: "edition_unverified", path: session.recordPath[entry.kind] })
    })

    test("#given the record is missing and the row names none #when verified and finished #then delivery refuses: the step was not run", async () => {
      const session = await fullyRecorded()
      unlinkSync(session.recordPath[entry.kind])
      await session.invoke(["set", "html", "delivered", "--path", session.path])
      await expectRefused(session, {
        code: "edition_unverified",
        message: expect.stringContaining(`${entry.step} not run`),
      })
    })

    test("#given the record is for other bytes #when verified and finished #then delivery refuses: a different edition", async () => {
      const session = await fullyRecorded()
      session.write(entry.kind, { artifact_sha256: sha256Of("an earlier draft") })
      await expectRefused(session, {
        code: "edition_unverified",
        path: session.recordPath[entry.kind],
        message: expect.stringContaining("is for a different edition"),
      })
    })

    test("#given a fresh record with a blocking defect #when verified and finished #then delivery refuses", async () => {
      const session = await fullyRecorded()
      session.write(entry.kind, { defects: [{ code: BLOCKER, severity: "minor", message: BLOCKER }] })
      await expectRefused(session, {
        code: "fidelity_unresolved",
        codes: [BLOCKER],
        path: session.recordPath[entry.kind],
      })
    })

    test("#given a fresh clean record #when verified and finished #then delivery passes", async () => {
      const session = await fullyRecorded()
      expect((await session.outcomes()).map((result) => result.exitCode)).toEqual([0, 0])
    })

    for (const [name, mutate] of [
      ["a missing envelope field", (record: Record<string, unknown>) => delete record.written_at],
      ["an unknown field", (record: Record<string, unknown>) => Object.assign(record, { verified_elsewhere: true })],
      [
        "another record kind",
        (record: Record<string, unknown>) => Object.assign(record, { record_kind: "not_a_record_kind" }),
      ],
    ] as const) {
      test(`#given a record with ${name} #when verified and finished #then delivery refuses it as malformed`, async () => {
        const session = await fullyRecorded()
        const path = session.recordPath[entry.kind]
        const record = JSON.parse(readFileSync(path, "utf8"))
        mutate(record)
        writeFileSync(path, JSON.stringify(record))
        await expectRefused(session, {
          code: "edition_unverified",
          path,
          message: expect.stringContaining("is malformed"),
        })
      })
    }
  })
}

test("#given a row whose --verified-by record is gone #when verified and finished #then delivery refuses: the record is missing", async () => {
  const session = await fullyRecorded()
  unlinkSync(session.record)
  await expectRefused(session, {
    code: "edition_unverified",
    format: "html",
    path: session.record,
    message: `html: fidelity record ${session.record} is missing`,
  })
})

test("#given a record kind outside the table or a malformed envelope #when written #then the writer refuses", () => {
  const dir = mkdtempSync(join(tmpdir(), "delivery-barrier-writer-"))
  onTestFinished(() => rmSync(dir, { recursive: true, force: true }))
  const fields = { artifact_sha256: sha256Of("x"), report: join(dir, "report.html"), defects: [] }
  expect(() => writeFidelityRecord(join(dir, "a.json"), "not_a_record_kind", fields)).toThrow(
    "unknown fidelity record kind",
  )
  expect(() => writeFidelityRecord(join(dir, "b.json"), "meaning", { ...fields, artifact_sha256: "draft" })).toThrow(
    "malformed",
  )
  expect(() => writeFidelityRecord(join(dir, "c.json"), "meaning", { ...fields, gatesRun: [] })).toThrow(
    "unknown field",
  )
})

test("#given an unattached session fidelity blocker and a clean attached record #when verified and finished #then the session blocker refuses", async () => {
  const session = await fullyRecorded()
  const other = join(session.dir, "other.json")
  writeFidelityRecord(other, "fidelity", {
    artifact_sha256: sha256Of(readFileSync(session.path)),
    report: session.path,
    defects: [],
  })
  await session.invoke(["set", "html", "delivered", "--path", session.path, "--verified-by", other])
  session.write("fidelity", { defects: [{ code: BLOCKER }] })
  await expectRefused(session, { code: "fidelity_unresolved", codes: [BLOCKER], path: session.record })
})

for (const [name, alias] of [
  ["a dot segment", (dir: string) => `${dir}/./fidelity-defects.json`],
  [
    "a directory link",
    (dir: string) => {
      const link = join(dirname(dir), "alias")
      symlinkSync(dir, link, "junction")
      return join(link, "fidelity-defects.json")
    },
  ],
] as const) {
  test(`#given two target paths reaching one blocking record through ${name} #when the barrier runs #then it reports the blocker once`, async () => {
    const session = await fullyRecorded()
    session.write("fidelity", { defects: [{ code: BLOCKER }] })
    const manifest = JSON.parse(readFileSync(join(session.dir, "outcome.json"), "utf8"))
    manifest.deliverables.push({ ...manifest.deliverables[0], format: "md", verifiedBy: alias(session.dir) })
    expect(
      fidelityProblems(session.dir, manifest).filter((problem) => problem.code === "fidelity_unresolved"),
    ).toHaveLength(1)
  })
}
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