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/gates-static.mjs

View on GitHub
// gates-static.mjs - deterministic static gates (G1-G17) over a parsed report.
//
// Builds one document context (a document-order walk with h2 sections, citation helpers and a
// defect factory) and hands it to the text, figure and structure gate modules. Every severity
// comes from contracts.DEFECT_CODES; the single override is unsourced_number under
// `Lineage: section`, derived from the spec mode passed in, never from a caller-supplied
// severity. Plain Node ESM, node: builtins and siblings only.

import * as nodeFs from "node:fs"

import { DEFECT_CODES, LINEAGE_MODES } from "./contracts.mjs"
import { customProperties } from "./css-lite.mjs"
import { figureGates } from "./gates-figures.mjs"
import { structureGates } from "./gates-structure.mjs"
import { textGates } from "./gates-text.mjs"
import { PROSE_TAGS, proseText, selectorPath } from "./html-lite.mjs"
import { sourcesClaims } from "./sources-citation.mjs"

const CITATION_MARKER = /\[S\d+\]|\[Source\s*\d+\]|\[\uCD9C\uCC98[^\]]*\]|\[\^\d+\]/i
const ANCHOR_HREF = /^#(?:s|src|source|ref|fn)/i
const ANCHOR_TEXT = /^\[(?:\uCD9C\uCC98|Source\s*\d+|S\d+)\]$/i
/**
 * Closing ("how this report was made") heading; Korean alternates cover the same register. A
 * heading that is exactly "Closing" (or the Korean word for it) also counts; a heading that only
 * starts with it ("Closing the gap") does not.
 */
export const CLOSING_HEADING =
  /\b(?:method(?:ology)?|how)\b|\uB4B7\uBA74|\uBC29\uBC95|\uC5B4\uB5BB\uAC8C|\uB9CC\uB4E4\uC5B4|^\s*(?:closing|\uB9C8\uBB34\uB9AC)\s*$/i
export const SOURCES_HEADING =
  /references|sources|bibliography|\uCD9C\uCC98|\uCC38\uACE0\s*(?:\uBB38\uD5CC|\uC790\uB8CC)/i
/** Section kinds after sources and closing, in match order; HTML and Markdown share this table. */
export const OTHER_KINDS = Object.freeze([
  ["toc", /\b(?:contents|toc)\b|\uBAA9\uCC28/i],
  ["appendix", /appendix|\uBD80\uB85D/i],
  ["glossary", /glossary|\uC6A9\uC5B4/i],
])
const TEXT_SKIP = new Set(["code", "pre", "kbd", "samp", "script", "style", "svg", "template", "noscript"])
const HEADING_TAG = /^h[1-6]$/
/** The one sanctioned severity override: section-level lineage demotes unsourced_number. */
const SECTION_LINEAGE_SEVERITY = "minor"

const GATES = [...textGates, ...figureGates, ...structureGates]

function classTokens(node) {
  return String(node.attrs.class ?? "")
    .toLowerCase()
    .split(/\s+/)
    .filter(Boolean)
}

function closest(node, predicate) {
  for (let cur = node.parent; cur; cur = cur.parent) if (predicate(cur)) return cur
  return null
}

function descendants(node, out = []) {
  for (const child of node.children) {
    if (child.tag === "#text") continue
    out.push(child)
    descendants(child, out)
  }
  return out
}

function isCitationAnchor(node) {
  return node.tag === "a" && (ANCHOR_HREF.test(node.attrs.href ?? "") || ANCHOR_TEXT.test(proseText(node)))
}

/** A citation marker in the element's prose or a citation anchor below it. */
function hasCitation(node) {
  return CITATION_MARKER.test(proseText(node)) || descendants(node).some(isCitationAnchor)
}

function proseScope(scope, owner) {
  if (scope.section?.kind !== "sources" || !owner || sourcesClaims(owner).length === 0) return scope
  return { ...scope, section: { ...scope.section, kind: null } }
}

function toRegExp(pattern) {
  const re = pattern instanceof RegExp ? pattern : new RegExp(String(pattern), "i")
  return new RegExp(re.source, re.flags.replace(/[gy]/g, ""))
}

function findBody(doc) {
  const stack = [doc]
  while (stack.length) {
    const node = stack.pop()
    if (node.tag === "body") return node
    for (const child of node.children) if (child.tag !== "#text") stack.push(child)
  }
  return doc
}

/**
 * Closing-heading test for both editions: CLOSING_HEADING plus the spec's optional pattern.
 * @param {RegExp|string|null} [pattern]
 * @returns {(text: string) => boolean}
 */
export function closingTest(pattern) {
  const extra = pattern ? toRegExp(pattern) : null
  return (text) => CLOSING_HEADING.test(text) || Boolean(extra?.test(text))
}

/**
 * Section kind of an h2 heading text: sources, closing, toc, appendix, glossary, or null.
 * @param {string} text
 * @param {(text: string) => boolean} isClosing
 * @returns {string|null}
 */
export function sectionKind(text, isClosing) {
  if (SOURCES_HEADING.test(text)) return "sources"
  if (isClosing(text)) return "closing"
  return OTHER_KINDS.find(([, re]) => re.test(text))?.[0] ?? null
}

/** Document-order walk of body: element scopes, prose text entries with owners, h2 sections. */
function walkBody(ctx, node, state) {
  for (const child of node.children) {
    if (child.tag === "#text") {
      if (state.skip) continue
      ctx.texts.push({ node: child, owner: state.owner ?? node, cell: state.cell, scope: ctx.scope })
      if (ctx.scope.section && !state.heading) ctx.scope.section.prose.push(child.text)
      continue
    }
    if (child.tag === "h2") {
      const section = { heading: child, kind: sectionKind(proseText(child), ctx.isClosing), prose: [], anchors: 0 }
      ctx.sections.push(section)
      ctx.scope = { section, closingH3: false }
    } else if (child.tag === "h3") {
      ctx.scope = { section: ctx.scope.section, closingH3: ctx.isClosing(proseText(child)) }
    }
    ctx.elements.push({ node: child, scope: ctx.scope })
    if (ctx.scope.section && isCitationAnchor(child)) ctx.scope.section.anchors++
    walkBody(ctx, child, {
      skip: state.skip || TEXT_SKIP.has(child.tag),
      owner: PROSE_TAGS.has(child.tag) ? child : state.owner,
      cell: state.cell || child.tag === "td" || child.tag === "th",
      heading: state.heading || HEADING_TAG.test(child.tag),
    })
  }
}

export function buildContext(doc, options) {
  const lineageMode = options.lineageMode ?? "inline"
  if (!LINEAGE_MODES.includes(lineageMode))
    throw new TypeError(`lineageMode must be one of ${LINEAGE_MODES.join(", ")}`)
  const all = descendants(doc)
  const styleBlocks = all.filter((node) => node.tag === "style").map((node) => ({ node, css: node.raw ?? "" }))
  const styleAttrs = all.filter((node) => node.attrs.style).map((node) => ({ node, css: node.attrs.style }))
  const ctx = {
    doc,
    body: findBody(doc),
    all,
    elements: [],
    texts: [],
    sections: [],
    scope: { section: null, closingH3: false },
    styleBlocks,
    styleAttrs,
    tokens: customProperties(styleBlocks.map((entry) => entry.css).join("\n")).light,
    palette: new Set(options.palette ?? []),
    requireSections: (options.requireSections ?? []).map(toRegExp),
    baseDir: options.baseDir ?? null,
    fs: options.fs ?? nodeFs,
    isClosing: closingTest(options.closingPattern),
    util: { classTokens, closest, descendants, hasCitation, citationMarker: CITATION_MARKER },
    kindOf: (scope) => (scope.closingH3 ? "closing" : (scope.section?.kind ?? null)),
    defect(code, node, message) {
      const entry = DEFECT_CODES[code]
      const severity =
        code === "unsourced_number" && lineageMode === "section" ? SECTION_LINEAGE_SEVERITY : entry.severity
      return { code, severity, selector: selectorPath(node) || node.tag, line: node.line, message, hint: entry.hint }
    },
  }
  walkBody(ctx, ctx.body, { skip: false, owner: null, cell: false, heading: false })
  return ctx
}

/**
 * Run G1-G17 over a parsed report (html-lite root).
 * @param {object} doc parseHtml(...) result
 * @param {{ palette?: Set<string>, lineageMode?: "inline"|"section", requireSections?: (RegExp|string)[],
 *   baseDir?: string, fs?: { statSync(path: string): { size: number } }, closingPattern?: RegExp|string }} options
 * @returns {{ defects: object[], gatesRun: string[], gatesSkipped: string[] }}
 */
export function checkStatic(doc, options = {}) {
  const ctx = buildContext(doc, options)
  const defects = []
  const gatesRun = []
  const gatesSkipped = []
  for (const gate of GATES) {
    if (gate.skip?.(ctx)) {
      gatesSkipped.push(...gate.codes)
      continue
    }
    gatesRun.push(...gate.codes)
    const context = gate.codes.includes("unsourced_number")
      ? { ...ctx, elements: ctx.elements.map(({ node, scope }) => ({ node, scope: proseScope(scope, node) })) }
      : ctx
    defects.push(...gate.run(context))
  }
  return { defects, gatesRun, gatesSkipped }
}
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