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/fidelity-brief.test.ts

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

import { FIDELITY_FIELDS, isLocked, parseFidelityBlock, requireLockedBrief } from "./fidelity-brief.mjs"

const fixture = (name: string) => join(import.meta.dir, "tests", "fixtures", name)
const lockedMd = await Bun.file(fixture("fidelity-brief-locked.md")).text()
const pendingMd = await Bun.file(fixture("fidelity-brief-pending.md")).text()

function withoutLine(markdown: string, prefix: string): string {
  return markdown
    .split("\n")
    .filter((line) => !line.startsWith(prefix))
    .join("\n")
}

describe("parseFidelityBlock", () => {
  test("#given a complete block #when parsed #then seven fields are read and the brief is locked", () => {
    // when
    const parsed = parseFidelityBlock(lockedMd)
    // then
    expect(parsed.errors).toEqual([])
    expect(Object.keys(parsed.fields).sort()).toEqual([...FIDELITY_FIELDS].sort())
    expect(parsed.fields["as of"]).toBe("latest at run start, 2026-10-23")
    expect(parsed.fields.languages).toBe("report ko; sources ko, en; quotes original with translation beside")
    expect(parsed.answered_by["derived numbers"]).toBe("user")
    expect(parsed.answered_by.fallback).toBe("request")
    expect(parsed.asked).toEqual(["derived numbers"])
    expect(isLocked(parsed)).toBe(true)
  })

  test("#given a block missing as of #when parsed #then it is not locked and the missing field is named", () => {
    // when
    const parsed = parseFidelityBlock(withoutLine(lockedMd, "as of:"))
    // then
    expect(isLocked(parsed)).toBe(false)
    expect(parsed.missing).toEqual(["as of"])
    expect(parsed.errors).toEqual([])
  })

  test("#given a field answered_by pending #when parsed #then it is not locked and not malformed", () => {
    // when
    const parsed = parseFidelityBlock(pendingMd)
    // then
    expect(parsed.errors).toEqual([])
    expect(parsed.answered_by["derived numbers"]).toBe("pending")
    expect(parsed.pending).toEqual(["derived numbers"])
    expect(isLocked(parsed)).toBe(false)
  })

  test("#given a malformed field line #when parsed #then errors name the line as malformed", () => {
    // given
    const markdown = lockedMd.replace("meaning check: on (answered_by: default)", "meaning check: on")
    // when
    const parsed = parseFidelityBlock(markdown)
    // then
    expect(parsed.errors.length).toBe(1)
    expect(parsed.errors[0]).toContain("malformed")
    expect(parsed.errors[0]).toContain("meaning check: on")
    expect(isLocked(parsed)).toBe(false)
  })

  test("#given grammar violations #when parsed #then each is a malformed error", () => {
    const cases = [
      lockedMd.replace("fallback: block-quote (answered_by: request)", "fallback: block-quote (answered_by: someone)"),
      lockedMd.replace("meaning check: on (answered_by: default)", "meaning check: on (maybe) (answered_by: default)"),
      lockedMd.replace("meaning check: on (answered_by: default)", "meaning check: on (answered_by: pending)"),
      lockedMd.replace("asked: derived numbers", "asked: derived numbers\ntone: formal (answered_by: user)"),
      lockedMd.replace("asked: derived numbers", "asked: derived numbers\nfallback: omit (answered_by: user)"),
      lockedMd.replace("asked: derived numbers", "asked: tone"),
    ]
    for (const markdown of cases) expect(parseFidelityBlock(markdown).errors.length).toBe(1)
  })

  test("#given a brief with no Fidelity block #when parsed #then it is not locked and every field is missing", () => {
    // when
    const parsed = parseFidelityBlock("# Brief\n\n## Deliverable\nformat: pdf (answered_by: request)\n")
    // then
    expect(parsed.present).toBe(false)
    expect(parsed.missing).toEqual([...FIDELITY_FIELDS])
    expect(isLocked(parsed)).toBe(false)
  })

  test("#given field lines after the next heading #when parsed #then they are outside the block", () => {
    // given
    const markdown = withoutLine(lockedMd, "fallback:") + "\nfallback: omit (answered_by: user)\n"
    // then
    expect(parseFidelityBlock(markdown).missing).toEqual(["fallback"])
  })

  test("#given a second Fidelity block #when parsed #then the duplicate is an error", () => {
    // given
    const markdown = lockedMd + "\n## Fidelity\nas of: x (answered_by: user)\n"
    // when
    const parsed = parseFidelityBlock(markdown)
    // then
    expect(parsed.errors.length).toBe(1)
    expect(parsed.errors[0]).toContain("duplicate")
    expect(parsed.fields["as of"]).toBe("latest at run start, 2026-10-23")
    expect(isLocked(parsed)).toBe(false)
  })
})

describe("requireLockedBrief", () => {
  function briefFile(contents: string | null): { path: string; cleanup: () => void } {
    const dir = mkdtempSync(join(tmpdir(), "fidelity-brief-"))
    const path = join(dir, "brief.md")
    if (contents !== null) writeFileSync(path, contents)
    return { path, cleanup: () => rmSync(dir, { recursive: true, force: true }) }
  }

  test("#given a locked brief #when required #then exit 0 and no defect", () => {
    const brief = briefFile(lockedMd)
    try {
      expect(requireLockedBrief(brief.path)).toMatchObject({ locked: true, exitCode: 0, defects: [], errors: [] })
    } finally {
      brief.cleanup()
    }
  })

  test("#given field lines with trailing spaces, a tab, and CRLF endings #when required #then they parse like trimmed lines", () => {
    // given
    const markdown = lockedMd
      .replace("meaning check: on (answered_by: default)", "meaning check: on (answered_by: default)  ")
      .replace("fallback: block-quote (answered_by: request)", "fallback: block-quote (answered_by: request)\t")
      .replace(
        "as of: latest at run start, 2026-10-23 (answered_by: default)\n",
        "as of: latest at run start, 2026-10-23 (answered_by: default)  \r\n",
      )
    const brief = briefFile(markdown)
    try {
      // when
      const result = requireLockedBrief(brief.path)
      // then
      expect(result).toMatchObject({ locked: true, exitCode: 0, defects: [], errors: [] })
      expect(result.parsed.fields.fallback).toBe("block-quote")
    } finally {
      brief.cleanup()
    }
  })

  test("#given a second Fidelity block #when required #then exit 2 naming the duplicate", () => {
    const brief = briefFile(lockedMd + "\n## Fidelity\nas of: x (answered_by: user)\n")
    try {
      const result = requireLockedBrief(brief.path)
      expect(result).toMatchObject({ locked: false, exitCode: 2, defects: [] })
      expect(result.errors[0]).toContain("duplicate ## Fidelity block")
    } finally {
      brief.cleanup()
    }
  })

  test("#given a pending, partial, or absent brief #when required #then exit 1 with the single lock defect", () => {
    for (const contents of [pendingMd, withoutLine(lockedMd, "as of:"), "# Brief\n", null]) {
      const brief = briefFile(contents)
      try {
        const result = requireLockedBrief(brief.path)
        expect(result.locked).toBe(false)
        expect(result.exitCode).toBe(1)
        expect(result.defects.length).toBe(1)
        expect(result.defects[0]).toMatchObject({
          code: "fidelity_interview_incomplete",
          severity: "blocker",
          integrity: true,
        })
        expect(typeof result.defects[0].message).toBe("string")
        expect(typeof result.defects[0].hint).toBe("string")
      } finally {
        brief.cleanup()
      }
    }
  })

  test("#given a malformed brief #when required #then exit 2 with the parse errors and no defect", () => {
    const brief = briefFile(lockedMd.replace("meaning check: on (answered_by: default)", "meaning check: on"))
    try {
      const result = requireLockedBrief(brief.path)
      expect(result).toMatchObject({ locked: false, exitCode: 2, defects: [] })
      expect(result.errors[0]).toContain("malformed")
    } finally {
      brief.cleanup()
    }
  })
})
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