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/design-spec.test.ts

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

import { DESIGN_SPEC_SECTIONS } from "./contracts.mjs"
import { parseLineageMode, parsePalette, renderDesignSpec } from "./design-spec.mjs"

function sectionBody(markdown: string, heading: string): string {
  const start = markdown.indexOf(`## ${heading}\n`)
  const rest = markdown.slice(start + heading.length + 4)
  const next = rest.search(/^## /m)
  return next === -1 ? rest : rest.slice(0, next)
}

describe("parsePalette", () => {
  test("#given a css fence and a Palette bullet list #when parsed #then the union is returned", () => {
    // given
    const spec = [
      "# Spec",
      "```css",
      ":root { --bg: #FAF6EF; --accent: #c2410c; }",
      "```",
      "## Palette",
      "- accent #C2410C",
      "- good #15803d",
      "## Layout",
      "- divider #999999 is prose, not a token",
    ].join("\n")
    // when
    const palette = parsePalette(spec)
    // then
    expect([...palette].sort()).toEqual(["#15803d", "#c2410c", "#faf6ef"])
  })

  test("#given Tokens and Colours headings with nested subheadings #when parsed #then hex under them counts", () => {
    // given
    const spec = [
      "## Tokens (copied from the reference)",
      "- Light: --bg #faf6ef, --fg #24211b",
      "### Dark",
      "- --bg #0c0b0a",
      "## Colours",
      "good #abc",
      "## Structure",
      "#def is not a color heading",
    ].join("\n")
    // then
    expect([...parsePalette(spec)].sort()).toEqual(["#0c0b0a", "#24211b", "#aabbcc", "#faf6ef"])
  })

  test("#given a fence line starting with a hash #when parsed #then it is not read as a heading", () => {
    // given
    const spec = ["## Palette", "```", "# not a heading", "--x: #111111", "```", "- #222222"].join("\n")
    // then
    expect([...parsePalette(spec)].sort()).toEqual(["#111111", "#222222"])
  })

  test("#given a spec with no tokens #when parsed #then the palette is empty", () => {
    expect(parsePalette("# Spec\n\nPlain prose with #fff outside a palette.").size).toBe(0)
  })
})

describe("parseLineageMode", () => {
  test("#given a Lineage line under Citations #when parsed #then that mode is returned", () => {
    expect(parseLineageMode("## Citations\n- Style: bracket-S\n- Lineage: section\n")).toBe("section")
    expect(parseLineageMode("## Citations\nLineage: inline")).toBe("inline")
  })

  test("#given no Citations section or a Lineage line elsewhere #when parsed #then inline is the default", () => {
    expect(parseLineageMode("# Spec")).toBe("inline")
    expect(parseLineageMode("## Layout\nLineage: section\n## Citations\n- Style: footnote")).toBe("inline")
    expect(parseLineageMode("## Citations\nLineage: TODO: ask")).toBe("inline")
  })
})

describe("renderDesignSpec", () => {
  test("#given an empty extract #when rendered #then every section heading appears in order with TODO: ask under each", () => {
    // when
    const markdown = renderDesignSpec({})
    // then
    let cursor = -1
    for (const heading of DESIGN_SPEC_SECTIONS) {
      const index = markdown.indexOf(`## ${heading}\n`)
      expect(index, heading).toBeGreaterThan(cursor)
      cursor = index
      expect(sectionBody(markdown, heading), heading).toContain("TODO: ask")
    }
  })

  test("#given a full extract #when rendered #then values, provenance and a round-trippable palette and lineage appear", () => {
    // given
    const extract = {
      origin: "tests/fixtures/reference-report.html",
      bytes: 16500,
      date: "2026-09-24",
      tokens: {
        light: new Map([
          ["--bg", "#faf6ef"],
          ["--accent", "#c2410c"],
        ]),
        dark: new Map([["--bg", "#0c0b0a"]]),
      },
      fonts: { body: "Pretendard, sans-serif", heading: "Pretendard, sans-serif", mono: "ui-monospace, monospace" },
      colors: [{ hex: "#24211b", count: 12, roles: ["body"] }],
      breakpoints: [560, 640],
      headingNumbering: "double-digit",
      citationStyle: "bracket-S",
      lineageMode: "section",
      figureContainers: ["fig"],
      skeleton: [
        { level: 1, text: "Title" },
        { level: 2, text: "01 Findings" },
      ],
      measure: { fontSize: "17px", lineHeight: "1.75", maxWidth: "720px" },
      notes: ["skipped external stylesheet: theme.css"],
    }
    // when
    const markdown = renderDesignSpec(extract)
    // then
    const provenance = sectionBody(markdown, "Extracted from")
    expect(provenance).toContain("tests/fixtures/reference-report.html")
    expect(provenance).toContain("16500")
    expect(provenance).toContain("2026-09-24")
    expect(provenance).toContain("skipped external stylesheet: theme.css")
    expect([...parsePalette(markdown)].sort()).toEqual(["#0c0b0a", "#24211b", "#c2410c", "#faf6ef"])
    expect(parseLineageMode(markdown)).toBe("section")
    expect(sectionBody(markdown, "Layout")).toContain("560px, 640px")
    expect(sectionBody(markdown, "Structure")).toContain("  - 01 Findings")
    expect(sectionBody(markdown, "Figures")).toContain("fig")
    expect(sectionBody(markdown, "Open questions")).not.toContain("TODO: ask")
    for (const heading of ["Tokens", "Typography", "Layout", "Structure", "Figures", "Citations"]) {
      expect(sectionBody(markdown, heading), heading).not.toContain("TODO: ask")
    }
  })

  test("#given unknown enum values and plain-object tokens #when rendered #then unknowns are TODO: ask and listed as open questions", () => {
    // given
    const extract = {
      tokens: { light: { "--bg": "#ffffff" }, dark: {} },
      lineageMode: "unknown",
      citationStyle: "unknown",
    }
    // when
    const markdown = renderDesignSpec(extract)
    // then
    expect(sectionBody(markdown, "Tokens")).toContain("--bg: #ffffff;")
    expect(sectionBody(markdown, "Tokens")).toContain("Dark tokens: TODO: ask")
    expect(sectionBody(markdown, "Citations")).toContain("Lineage: TODO: ask")
    expect(parseLineageMode(markdown)).toBe("inline")
    expect(sectionBody(markdown, "Open questions")).toContain("Lineage mode")
  })
})

describe("parsePalette with Korean headings", () => {
  test("#given a spec whose token section is headed in Korean #when parsed #then the bullet hexes under it are the palette", () => {
    // given
    const md = [
      "# design-spec",
      "## 토큰 (변경 금지)",
      "- 라이트: bg #faf6ef · fg #24211b · accent #c2410c",
      "## 그림 표준",
      "- 테두리 #ffffff",
    ].join("\n")
    // when
    const palette = parsePalette(md)
    // then
    expect([...palette].sort()).toEqual(["#24211b", "#c2410c", "#faf6ef"])
  })

  test("#given Korean color and palette headings #when parsed #then each is recognized", () => {
    expect([...parsePalette("## 팔레트\n- #112233")]).toEqual(["#112233"])
    expect([...parsePalette("## 색상\n- #445566")]).toEqual(["#445566"])
  })
})
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