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/md-lite.test.ts

View on GitHub
import { describe, expect, test } from "bun:test"

import * as gatesStatic from "./gates-static.mjs"
import { parseHtml } from "./html-lite.mjs"
import * as mdLite from "./md-lite.mjs"
import { parseMarkdown, sectionKindsMd } from "./md-lite.mjs"

type Cell = { text: string; start: number; end: number }
type Block = { kind: string; level?: number; text: string; start: number; end: number; cells?: Cell[] }

const FIXTURE = [
  "# 반도체 시장 보고서",
  "",
  "매출은 {{F1}}로 집계됐다. Revenue grew",
  "across two quarters.",
  "",
  "## Findings",
  "",
  "- 첫 번째 항목 120억 원",
  "* Second item 3.2 m",
  "1. Ordered item 45%",
  "",
  "| 지표 | Value |",
  "| --- | ---: |",
  "| 매출 | 100억 원 |",
  "",
  "> 원문 인용 그대로다.",
  "",
  "```js",
  "const total = 9999",
  "```",
  "",
  "## Sources",
  "",
  "S1 example.org",
  "",
  "## 출처",
  "",
  "## Closing",
  "",
  "### Method",
  "",
  "## 마무리",
  "",
].join("\n")

function blocksOf(text: string): Block[] {
  return (parseMarkdown(text) as { blocks: Block[] }).blocks
}

function expectSlices(text: string, blocks: Block[]): void {
  for (const block of blocks) {
    expect(text.slice(block.start, block.end)).toBe(block.text)
    for (const cell of block.cells ?? []) expect(text.slice(cell.start, cell.end)).toBe(cell.text)
  }
}

describe("parseMarkdown", () => {
  test("#given a Korean+English fixture #when parsed #then block kinds come in document order", () => {
    // given
    const text = FIXTURE
    // when
    const blocks = blocksOf(text)
    // then
    expect(blocks.map((b) => b.kind)).toEqual([
      "heading",
      "paragraph",
      "heading",
      "list_item",
      "list_item",
      "list_item",
      "table_row",
      "table_row",
      "blockquote",
      "code",
      "heading",
      "paragraph",
      "heading",
      "heading",
      "heading",
      "heading",
    ])
  })

  test("#given the fixture #when parsed #then every block and cell slices exactly from start to end", () => {
    // given
    const text = FIXTURE
    // when
    const blocks = blocksOf(text)
    // then
    expectSlices(text, blocks)
    expect(blocks[0]).toMatchObject({ kind: "heading", level: 1, text: "반도체 시장 보고서" })
    expect(blocks[1]?.text).toBe("매출은 {{F1}}로 집계됐다. Revenue grew\nacross two quarters.")
    expect(blocks.filter((b) => b.kind === "list_item").map((b) => b.text)).toEqual([
      "첫 번째 항목 120억 원",
      "Second item 3.2 m",
      "Ordered item 45%",
    ])
    expect(blocks.find((b) => b.kind === "blockquote")?.text).toBe("원문 인용 그대로다.")
  })

  test("#given a table with a separator row #when parsed #then rows carry trimmed cells and the separator is skipped", () => {
    // given
    const text = FIXTURE
    // when
    const rows = blocksOf(text).filter((b) => b.kind === "table_row")
    // then
    expect(rows.map((r) => (r.cells ?? []).map((c) => c.text))).toEqual([
      ["지표", "Value"],
      ["매출", "100억 원"],
    ])
    expectSlices(text, rows)
  })

  test("#given a fenced code block with numerals #when parsed #then the numerals sit only in a block of kind code", () => {
    // given
    const text = FIXTURE
    // when
    const blocks = blocksOf(text)
    // then
    const holders = blocks.filter((b) => b.text.includes("9999"))
    expect(holders.map((b) => b.kind)).toEqual(["code"])
    expect(holders[0]?.text).toBe("const total = 9999")
  })

  test("#given an unterminated code fence #when parsed #then it is code to EOF and an unterminated_fence problem names its line", () => {
    // given
    const text = "Intro 12.\n\n```\nlet a = 1\n## not a heading\n"
    // when
    const { blocks, problems } = parseMarkdown(text) as { blocks: Block[]; problems: { code: string; line: number }[] }
    // then
    expect(blocks.map((b) => b.kind)).toEqual(["paragraph", "code"])
    expect(blocks[1]?.text).toBe("let a = 1\n## not a heading\n")
    expectSlices(text, blocks)
    expect(problems).toEqual([expect.objectContaining({ code: "unterminated_fence", line: 3 })])
  })

  test("#given closed fences only #when parsed #then problems is empty", () => {
    // given
    const text = FIXTURE
    // when
    const { problems } = parseMarkdown(text) as { problems: unknown[] }
    // then
    expect(problems).toEqual([])
  })

  const NUMBER_LINES: [string, string, string[][]][] = [
    [
      "a year-led continuation line",
      "Revenue rose 12% in\n2024. Costs fell 3%.",
      [["paragraph", "Revenue rose 12% in\n2024. Costs fell 3%."]],
    ],
    [
      "a bare number at line start",
      "Sales grew in\n2024 revenue rose 4%.",
      [["paragraph", "Sales grew in\n2024 revenue rose 4%."]],
    ],
    [
      "a 1. marker after a paragraph",
      "Intro line\n1. x",
      [
        ["paragraph", "Intro line"],
        ["list_item", "x"],
      ],
    ],
    ["a 2) marker after a paragraph", "Intro line\n2) y", [["paragraph", "Intro line\n2) y"]]],
    [
      "a 2) marker after a blank line",
      "Intro line\n\n2) y",
      [
        ["paragraph", "Intro line"],
        ["list_item", "y"],
      ],
    ],
    [
      "a later ordered item in a list",
      "1. x\n2. y",
      [
        ["list_item", "x"],
        ["list_item", "y"],
      ],
    ],
  ]
  test.each(NUMBER_LINES)(
    "#given %s #when parsed #then no number drops out of the block text",
    (_label, text, expected) => {
      // given / when
      const blocks = blocksOf(text)
      // then
      expect(blocks.map((b) => [b.kind, b.text])).toEqual(expected)
      expectSlices(text, blocks)
    },
  )

  test("#given a line that opens with an inline triple-backtick span #when parsed #then it stays a paragraph and later claims are not code", () => {
    // given
    const text = "```inline``` code at start\n\nLater 42% claim."
    // when
    const { blocks, problems } = parseMarkdown(text) as { blocks: Block[]; problems: unknown[] }
    // then
    expect(blocks.map((b) => [b.kind, b.text])).toEqual([
      ["paragraph", "```inline``` code at start"],
      ["paragraph", "Later 42% claim."],
    ])
    expect(problems).toEqual([])
  })

  test("#given a tilde fence with an info string containing backticks #when parsed #then it is still a fence", () => {
    // given
    const text = "~~~ js `x`\nconst n = 5\n~~~\nAfter 6."
    // when
    const blocks = blocksOf(text)
    // then
    expect(blocks.map((b) => [b.kind, b.text])).toEqual([
      ["code", "const n = 5"],
      ["paragraph", "After 6."],
    ])
  })

  test("#given a table cell ending in an escaped backslash #when parsed #then the following pipe still splits cells", () => {
    // given
    const text = "| a\\\\| b \\| c |\n| --- | --- |\n| 1 | 2 |"
    // when
    const rows = blocksOf(text).filter((b) => b.kind === "table_row")
    // then
    expect((rows[0]?.cells ?? []).map((c) => c.text)).toEqual(["a\\\\", "b \\| c"])
    expectSlices(text, rows)
  })
})

describe("sectionKindsMd", () => {
  test("#given h2 headings in English and Korean #when classified #then sources and closing kinds match gates-static", () => {
    // given
    const blocks = blocksOf(FIXTURE)
    // when
    const kinds = sectionKindsMd(blocks) as (string | null)[]
    // then
    const byHeading: Record<string, string | null | undefined> = {}
    blocks.forEach((b, i) => {
      if (b.kind === "heading") byHeading[b.text] = kinds[i]
    })
    expect(byHeading.Findings).toBeNull()
    expect(byHeading.Sources).toBe("sources")
    expect(byHeading["출처"]).toBe("sources")
    expect(byHeading.Closing).toBe("closing")
    expect(byHeading["마무리"]).toBe("closing")
    expect(kinds).toHaveLength(blocks.length)
  })

  test("#given md-lite #when its section classifier is read #then it is the gates-static export itself", () => {
    // given / when / then
    expect(typeof gatesStatic.sectionKind).toBe("function")
    expect(mdLite.sectionKind).toBe(gatesStatic.sectionKind)
    expect(typeof gatesStatic.closingTest).toBe("function")
    expect(mdLite.closingTest).toBe(gatesStatic.closingTest)
  })

  test("#given one heading set as Markdown h2s and HTML h2s #when classified #then both editions give the same kinds", () => {
    // given
    const headings = [
      "Findings",
      "Sources",
      "\uCD9C\uCC98",
      "Closing",
      "\uB9C8\uBB34\uB9AC",
      "Methodology",
      "Contents",
      "Appendix A",
      "Glossary",
      "Closing the gap: GPU prices",
    ]
    const md = headings.map((h) => `## ${h}\n\nBody.`).join("\n\n")
    const html = `<html><body>${headings.map((h) => `<h2>${h}</h2><p>Body.</p>`).join("")}</body></html>`
    // when
    const blocks = blocksOf(md)
    const kinds = sectionKindsMd(blocks) as (string | null)[]
    const mdKinds = blocks.flatMap((b, i) => (b.kind === "heading" ? [kinds[i]] : []))
    const htmlKinds = gatesStatic.buildContext(parseHtml(html), {}).sections.map((s: { kind: string | null }) => s.kind)
    // then
    expect(mdKinds).toEqual(htmlKinds)
    expect(mdKinds).toEqual([
      null,
      "sources",
      "sources",
      "closing",
      "closing",
      "closing",
      "toc",
      "appendix",
      "glossary",
      null,
    ])
  })

  test("#given a findings heading that only starts with Closing #when classified #then it is not a closing section", () => {
    // given
    const blocks = blocksOf(
      "## Closing the gap: GPU prices\n\nPrices fell 8%.\n\n### Closing remarks on supply\n\nSupply rose 2%.",
    )
    // when
    const kinds = sectionKindsMd(blocks) as (string | null)[]
    // then
    expect(kinds).toEqual([null, null, null, null])
  })

  test("#given a caller closing pattern given as a string #when classified #then it is applied as in gates-static", () => {
    // given
    const blocks = blocksOf("## Wrap-up\n\nDone.")
    // when
    const kinds = sectionKindsMd(blocks, { closingPattern: "wrap-up" }) as (string | null)[]
    // then
    expect(kinds).toEqual(["closing", "closing"])
  })

  test("#given body blocks under a section #when classified #then they inherit the enclosing h2 kind", () => {
    // given
    const blocks = blocksOf(FIXTURE)
    // when
    const kinds = sectionKindsMd(blocks) as (string | null)[]
    // then
    const codeIndex = blocks.findIndex((b) => b.kind === "code")
    const sourceLine = blocks.findIndex((b) => b.text === "S1 example.org")
    expect(kinds[codeIndex]).toBeNull()
    expect(kinds[sourceLine]).toBe("sources")
    expect(kinds[0]).toBeNull()
  })
})
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