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/report-tools-commands.mjs

View on GitHub
// report-tools-commands.mjs - one function per report-tools subcommand. Each returns
// { json | text, summary?, exitCode } and never exits the process; report-tools.mjs dispatches.

import { existsSync, readFileSync, statSync, writeFileSync } from "node:fs"
import { dirname, join, resolve } from "node:path"

import { CliError, parseArgs, readJsonFile, writeJsonAtomic } from "./cli-support.mjs"
import { GATE_NAMES, GATE_STATUSES, REPAIR_DEFAULTS } from "./contracts.mjs"
import { parseLineageMode, parsePalette, renderDesignSpec } from "./design-spec.mjs"
import { extractFromHtml, extractFromPath, fetchHtml } from "./format-extract.mjs"
import { checkLayout } from "./gates-layout.mjs"
import { checkStatic } from "./gates-static.mjs"
import { parseHtml } from "./html-lite.mjs"
import { buildProbeSource } from "./layout-probe.mjs"
import * as outcome from "./outcome.mjs"
import { createTracker, decide, deserializeState, isArtifactOk, serializeState } from "./repair-tracker.mjs"

const SEVERITY_ORDER = { blocker: 0, major: 1, minor: 2 }

function readText(path) {
  try {
    return readFileSync(path, "utf8")
  } catch (error) {
    throw new CliError(`cannot read ${path}: ${error.code ?? error.message}`)
  }
}

function nowFrom(flags) {
  if (flags.now === undefined) return new Date()
  const date = new Date(flags.now)
  if (Number.isNaN(date.getTime())) throw new CliError("--now requires an ISO timestamp")
  return date
}

function sessionDirFrom(flags) {
  const dir = flags["session-dir"] ?? process.env.SESSION_DIR
  if (!dir) throw new CliError("--session-dir is required (or set SESSION_DIR)")
  return resolve(dir)
}

export function runCheck(argv) {
  const args = parseArgs(argv, { repeatable: ["require-section"] })
  const reportPath = args.positionals[0]
  if (!reportPath)
    throw new CliError(
      "usage: check <report.html> --design-spec <design-spec.md> [--layout <boxes.json>] [--require-section <regex>]... [--max-defects N]",
    )
  const specText = readText(args.required("design-spec"))
  const doc = parseHtml(readText(reportPath))
  const requireSections = (args.flags["require-section"] ?? []).map((source) => new RegExp(source, "i"))
  const result = checkStatic(doc, {
    palette: parsePalette(specText),
    lineageMode: parseLineageMode(specText),
    requireSections,
    baseDir: dirname(resolve(reportPath)),
  })
  const defects = [...result.defects]
  const gatesRun = [...result.gatesRun]
  let layout = "not_run"
  if (args.flags.layout !== undefined) {
    const layoutResult = checkLayout(readJsonFile(args.flags.layout))
    defects.push(...layoutResult.defects)
    gatesRun.push("layout")
    layout = layoutResult.defects.some((d) => d.severity === "blocker") ? "fail" : "pass"
  }
  defects.sort(
    (a, b) =>
      SEVERITY_ORDER[a.severity] - SEVERITY_ORDER[b.severity] ||
      (a.line ?? 0) - (b.line ?? 0) ||
      a.code.localeCompare(b.code),
  )
  const counts = { blocker: 0, major: 0, minor: 0, total: defects.length }
  for (const defect of defects) counts[defect.severity] += 1
  const max = args.int("max-defects", 200)
  const status = counts.blocker > 0 ? "fail" : "pass"
  const exitCode = status === "fail" ? 1 : 0
  return {
    json: {
      command: "check",
      status,
      exitCode,
      layout,
      defects: defects.slice(0, max),
      counts,
      gatesRun,
      gatesSkipped: result.gatesSkipped,
    },
    summary: `check: ${status.toUpperCase()} - ${counts.blocker} blocker, ${counts.major} major, ${counts.minor} minor; layout ${layout}`,
    exitCode,
  }
}

export function runLayoutProbe(argv) {
  const args = parseArgs(argv, { booleans: ["json"] })
  const source = buildProbeSource({ cap: args.int("cap", 400), root: args.flags.root ?? "main, article" })
  return args.flags.json ? { json: { command: "layout-probe", source }, exitCode: 0 } : { text: source, exitCode: 0 }
}

export function runRepairDecide(argv) {
  const args = parseArgs(argv, { repeatable: ["defects"] })
  const statePath = args.required("state")
  const now = nowFrom(args.flags)
  // Every --defects file (check result, fidelity record, or bare array) joins one defect list.
  const defects = args.required("defects").flatMap((path) => {
    const input = readJsonFile(path)
    const list = Array.isArray(input) ? input : input.defects
    if (!Array.isArray(list))
      throw new CliError(`--defects ${path} must be a JSON array or a check result with a defects array`)
    return list
  })
  const state = existsSync(statePath)
    ? deserializeState(readText(statePath))
    : createTracker({
        maxAttempts: args.int("max-attempts", REPAIR_DEFAULTS.maxAttempts),
        plateauLimit: args.int("plateau-limit", REPAIR_DEFAULTS.plateauLimit),
        wallClockMs: args.int("wall-clock-ms", REPAIR_DEFAULTS.wallClockMs),
        startedAt: now,
      })
  // Fail closed: deliver-on-exhaustion needs proof of a usable artifact (bytes and renders).
  const artifactOk =
    args.flags["artifact-bytes"] !== undefined && args.flags.renders !== undefined
      ? isArtifactOk({ bytes: Number(args.flags["artifact-bytes"]), renders: Number(args.flags.renders) })
      : false
  const { state: next, decision } = decide(state, defects, now, { artifactOk })
  writeFileSync(statePath, serializeState(next))
  recordRepair(args.flags, next, decision)
  const exitCode = decision.action === "block" ? 1 : 0
  return {
    json: { command: "repair decide", decision },
    summary: `repair: ${decision.action}${decision.reason ? ` (${decision.reason})` : ""}`,
    exitCode,
  }
}

/** With a session dir that holds outcome.json, the repair summary and residual list land in the manifest. */
function recordRepair(flags, state, decision) {
  const dir = flags["session-dir"] ?? process.env.SESSION_DIR
  if (!dir) return
  const file = join(resolve(dir), outcome.MANIFEST_FILENAME)
  if (!existsSync(file)) return
  const manifest = outcome.readManifest(file)
  manifest.repair = { attempts: state.attempts.length, action: decision.action, reason: decision.reason }
  if (decision.action !== "repair")
    manifest.residualDefects = decision.residual.map((defect) => ({
      ...defect,
      message: defect.message ?? defect.code,
    }))
  outcome.writeManifest(file, manifest)
}

function manifestPath(flags) {
  return join(sessionDirFrom(flags), outcome.MANIFEST_FILENAME)
}

export async function runOutcome(argv) {
  const [sub, ...rest] = argv
  const args = parseArgs(rest, { booleans: ["json"] })
  const file = sub === "state" ? null : manifestPath(args.flags)
  switch (sub) {
    case "init": {
      const promised = args
        .required("promised")
        .split(",")
        .map((s) => s.trim())
        .filter(Boolean)
      const manifest = outcome.initManifest({
        sessionDir: sessionDirFrom(args.flags),
        promised,
        lane: args.flags.lane ?? null,
        now: nowFrom(args.flags),
        startedAt: args.flags["started-at"],
      })
      outcome.writeManifest(file, manifest)
      return { json: { command: "outcome init", path: file, deliverables: manifest.deliverables }, exitCode: 0 }
    }
    case "set": {
      const [format, status] = args.positionals
      if (!format || !status)
        throw new CliError(
          "usage: outcome set <format> <status> [--path p] [--reason r] [--pages n] [--verified-by fidelity-defects.json] [--rendered-from source]",
        )
      const manifest = outcome.readManifest(file)
      const detail = {}
      if (args.flags.path !== undefined) {
        detail.path = resolve(args.flags.path)
        if (existsSync(detail.path)) detail.bytes = statSync(detail.path).size
      }
      if (args.flags.reason !== undefined) detail.reason = args.flags.reason
      if (args.flags.pages !== undefined) detail.pages = args.int("pages")
      for (const [flag, key] of [
        ["verified-by", "verifiedBy"],
        ["rendered-from", "renderedFrom"],
      ])
        if (args.flags[flag] !== undefined) detail[key] = resolve(args.flags[flag])
      outcome.writeManifest(
        file,
        outcome.setDeliverable(manifest, format, status, { ...detail, now: nowFrom(args.flags) }),
      )
      return { json: { command: "outcome set", format, status }, exitCode: 0 }
    }
    case "gate": {
      const [gate, status] = args.positionals
      if (!gate || !status)
        throw new CliError(`usage: outcome gate <${GATE_NAMES.join("|")}> <${GATE_STATUSES.join("|")}>`)
      outcome.writeManifest(
        file,
        outcome.setGate(outcome.readManifest(file), gate, status, {
          reason: args.flags.reason,
          now: nowFrom(args.flags),
        }),
      )
      return { json: { command: "outcome gate", gate, status }, exitCode: 0 }
    }
    case "render": {
      const [path] = args.positionals
      if (!path) throw new CliError("usage: outcome render <path> --page N")
      outcome.writeManifest(file, outcome.addRender(outcome.readManifest(file), resolve(path), args.int("page")))
      return { json: { command: "outcome render", path: resolve(path) }, exitCode: 0 }
    }
    case "state": {
      const deliverable = args.required("deliverable")
      const sibling = join(dirname(resolve(deliverable)), outcome.MANIFEST_FILENAME)
      const dir = args.flags["session-dir"] ?? process.env.SESSION_DIR
      const candidate = dir ? join(resolve(dir), outcome.MANIFEST_FILENAME) : sibling
      const manifest = existsSync(candidate) ? outcome.readManifest(candidate) : null
      const state = outcome.deliverableState(resolve(deliverable), manifest)
      return { json: { command: "outcome state", state }, summary: `state: ${state}`, exitCode: 0 }
    }
    case "verify": {
      const manifest = outcome.readManifest(file)
      const base = outcome.verifyManifest(manifest)
      const { fidelityProblems } = await import("./fidelity-records.mjs")
      const problems = [...base.problems, ...fidelityProblems(sessionDirFrom(args.flags), manifest)]
      const result = { ok: problems.length === 0, problems }
      return {
        json: { command: "outcome verify", ...result },
        summary: `verify: ${result.ok ? "OK" : `${result.problems.length} problem(s)`}`,
        exitCode: result.ok ? 0 : 1,
      }
    }
    case "finish": {
      const manifest = outcome.readManifest(file)
      const refused = (await import("./fidelity-records.mjs")).fidelityProblems(sessionDirFrom(args.flags), manifest)
      if (refused.length > 0)
        return {
          json: { command: "outcome finish", refused: true, problems: refused },
          summary: `finish: refused (${refused.map((p) => p.code).join(", ")})`,
          exitCode: 1,
        }
      const ledgerPath = args.flags.ledger ?? join(sessionDirFrom(args.flags), "sources-ledger.md")
      const now = nowFrom(args.flags)
      const facts = outcome.briefingFacts(manifest, existsSync(ledgerPath) ? readText(ledgerPath) : "", now)
      manifest.finishedAt = now.toISOString()
      manifest.elapsedMinutes = facts.minutes
      manifest.sources = { total: facts.sources, domains: facts.domains }
      outcome.writeManifest(file, manifest)
      return {
        json: {
          command: "outcome finish",
          finishedAt: manifest.finishedAt,
          elapsedMinutes: facts.minutes,
          sources: manifest.sources,
        },
        exitCode: 0,
      }
    }
    case "briefing": {
      const manifest = outcome.readManifest(file)
      const ledgerPath = args.flags.ledger ?? join(sessionDirFrom(args.flags), "sources-ledger.md")
      const ledger = existsSync(ledgerPath) ? readText(ledgerPath) : ""
      const now = nowFrom(args.flags)
      if (args.flags.json)
        return { json: { command: "outcome briefing", ...outcome.briefingFacts(manifest, ledger, now) }, exitCode: 0 }
      return { text: outcome.buildBriefing(manifest, ledger, now), exitCode: 0 }
    }
    default:
      throw new CliError("usage: outcome <init|set|gate|render|state|verify|finish|briefing> ...")
  }
}

export async function runFormatExtract(argv) {
  const args = parseArgs(argv, { booleans: ["from-url"] })
  const [reference] = args.positionals
  if (!reference) throw new CliError("usage: format-extract <reference> --out <design-spec.md> [--from-url]")
  const out = args.required("out")
  let extract
  try {
    extract = args.flags["from-url"]
      ? extractFromHtml(await fetchHtml(reference), { origin: reference })
      : extractFromPath(reference)
  } catch (error) {
    // An unsupported, unreadable, or unreachable reference is an input problem (exit 2), not a gate result.
    throw new CliError(`format-extract ${reference}: ${error.message}`)
  }
  writeJsonAtomic(`${out}.extract.json`, {
    ...extract,
    tokens: {
      light: Object.fromEntries(extract.tokens?.light ?? []),
      dark: Object.fromEntries(extract.tokens?.dark ?? []),
    },
  })
  writeFileSync(out, renderDesignSpec(extract))
  return {
    json: {
      command: "format-extract",
      out: resolve(out),
      origin: extract.origin,
      lineageMode: extract.lineageMode,
      notes: extract.notes ?? [],
    },
    summary: `format-extract: wrote ${out}`,
    exitCode: 0,
  }
}
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