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

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

import { DELIVERABLE_FORMATS, GATE_NAMES, validateOutcomeManifest } from "./contracts.mjs"
import {
  MANIFEST_FILENAME,
  OutcomeError,
  addRender,
  briefingFacts,
  buildBriefing,
  deliverableState,
  initManifest,
  readManifest,
  setDeliverable,
  setGate,
  verifyManifest,
  writeManifest,
} from "./outcome.mjs"

const STAMP = "20260101-120000"
const START_LOCAL = new Date(2026, 0, 1, 12, 0, 0)

function tempRoot(): string {
  const root = mkdtempSync(join(tmpdir(), "ulw-outcome-"))
  onTestFinished(() => rmSync(root, { recursive: true, force: true }))
  return root
}

function sessionDir(): string {
  const dir = join(tempRoot(), STAMP)
  mkdirSync(dir)
  return dir
}

function oneByteFile(dir: string, name: string): string {
  const file = join(dir, name)
  writeFileSync(file, "x")
  return file
}

function codes(problems: { code: string }[]): string[] {
  return problems.map((problem) => problem.code)
}

describe("initManifest", () => {
  test("#given promised pdf and docx #when initialised #then there is one pending row per format and the schema validates", () => {
    // given
    const dir = sessionDir()
    // when
    const manifest = initManifest({ sessionDir: dir, promised: ["pdf", "docx"], lane: "no-format" })
    // then
    expect(manifest.deliverables.map((row) => [row.format, row.status, row.promised])).toEqual([
      ["pdf", "pending", true],
      ["docx", "pending", true],
    ])
    expect(manifest.startedAt).toBe(START_LOCAL.toISOString())
    expect(Object.keys(manifest.gates)).toEqual([...GATE_NAMES])
    expect(Object.values(manifest.gates).every((status) => status === "not_run")).toBe(true)
    expect(validateOutcomeManifest(manifest)).toEqual({ ok: true, errors: [] })
  })

  test("#given a session dir without a YYYYMMDD-HHMMSS basename #when initialised #then it throws a typed error", () => {
    // given
    const dir = tempRoot()
    // when / then
    expect(() => initManifest({ sessionDir: dir, promised: ["pdf"], lane: null })).toThrow(OutcomeError)
  })
})

describe("setDeliverable and verifyManifest", () => {
  test("#given a fresh pdf+docx manifest #when verified #then both pending rows are missing_promised_deliverable", () => {
    // given
    const manifest = initManifest({ sessionDir: sessionDir(), promised: ["pdf", "docx"], lane: "no-format" })
    // when
    const result = verifyManifest(manifest)
    // then
    expect(result.ok).toBe(false)
    expect(codes(result.problems)).toEqual(["missing_promised_deliverable", "missing_promised_deliverable"])
  })

  test("#given pdf delivered as a 1-byte file and docx blocked with a reason #when verified #then it passes", () => {
    // given
    const dir = sessionDir()
    const initial = initManifest({ sessionDir: dir, promised: ["pdf", "docx"], lane: "no-format" })
    // when
    const afterPdf = setDeliverable(initial, "pdf", "delivered", { path: oneByteFile(dir, "report.pdf") })
    const afterDocx = setDeliverable(afterPdf, "docx", "blocked_capability", { reason: "no docx renderer" })
    // then
    expect(afterPdf.deliverables.find((row) => row.format === "docx")?.status).toBe("pending")
    expect(codes(verifyManifest(afterPdf).problems)).toEqual(["missing_promised_deliverable"])
    expect(verifyManifest(afterDocx)).toEqual({ ok: true, problems: [] })
    expect(initial.deliverables.every((row) => row.status === "pending")).toBe(true)
  })

  test("#given a delivered row whose file is missing or empty #when verified #then each path is named in problems", () => {
    // given
    const dir = sessionDir()
    const missing = join(dir, "gone.pdf")
    const empty = join(dir, "empty.html")
    writeFileSync(empty, "")
    let manifest = initManifest({ sessionDir: dir, promised: ["pdf", "html"], lane: "no-format" })
    manifest = setDeliverable(manifest, "pdf", "delivered", { path: missing })
    manifest = setDeliverable(manifest, "html", "delivered", { path: empty })
    // when
    const result = verifyManifest(manifest)
    // then
    expect(result.ok).toBe(false)
    expect(result.problems.map((problem) => problem.path)).toEqual([missing, empty])
  })

  test("#given a skipped row without a reason #when verified #then it is a problem", () => {
    // given
    const base = initManifest({ sessionDir: sessionDir(), promised: ["md"], lane: null })
    // when
    const result = verifyManifest(setDeliverable(base, "md", "skipped", {}))
    // then
    expect(codes(result.problems)).toEqual(["missing_promised_deliverable"])
  })

  test("#given an unpromised format #when set #then a non-promised row is appended and the promised rows survive", () => {
    // given
    const dir = sessionDir()
    const base = initManifest({ sessionDir: dir, promised: ["pdf"], lane: null })
    // when
    const next = setDeliverable(base, "html", "delivered", { path: oneByteFile(dir, "r.html"), bytes: 1, pages: 1 })
    // then
    expect(next.deliverables.map((row) => [row.format, row.status, row.promised])).toEqual([
      ["pdf", "pending", true],
      ["html", "delivered", false],
    ])
    expect(validateOutcomeManifest(next).ok).toBe(true)
  })

  test("#given an unknown format #when set #then it throws a typed error naming the allowed list", () => {
    // given
    const base = initManifest({ sessionDir: sessionDir(), promised: ["pdf"], lane: null })
    // when
    let caught: unknown
    try {
      setDeliverable(base, "epub", "delivered", { path: "x" })
    } catch (error) {
      caught = error
    }
    // then
    expect(caught).toBeInstanceOf(OutcomeError)
    const error = caught as OutcomeError
    expect(error.code).toBe("unknown_format")
    expect(error.allowed).toEqual([...DELIVERABLE_FORMATS])
    for (const format of DELIVERABLE_FORMATS) expect(error.message).toContain(format)
  })
})

describe("setGate and addRender", () => {
  test("#given a manifest #when a gate and renders are recorded #then they land without mutating the input", () => {
    // given
    const base = initManifest({ sessionDir: sessionDir(), promised: ["pdf"], lane: null })
    // when
    const gated = setGate(base, "static", "pass")
    const rendered = addRender(addRender(addRender(gated, "p1.png", 1), "p2.png", 2), "p1.png", 1)
    // then
    expect(base.gates.static).toBe("not_run")
    expect(rendered.gates.static).toBe("pass")
    expect(rendered.renders).toEqual([
      { path: "p1.png", page: 1 },
      { path: "p2.png", page: 2 },
    ])
    expect(() => setGate(base, "spelling", "pass")).toThrow(OutcomeError)
    expect(() => setGate(base, "static", "ok")).toThrow(OutcomeError)
    expect(() => addRender(base, "p0.png", 0)).toThrow(OutcomeError)
  })
})

describe("deliverableState", () => {
  test("#given the draft marker, no marker, and a sibling manifest #when read #then state follows the file and the manifest", () => {
    // given
    const dir = sessionDir()
    const report = join(dir, "report.md")
    // when / then
    expect(deliverableState(report, null)).toBe("none")
    writeFileSync(report, "")
    expect(deliverableState(report, null)).toBe("none")
    writeFileSync(report, "# Report\nSTATUS: draft \u2014 3 sections open\n\nbody\n")
    expect(deliverableState(report, null)).toBe("partial")
    writeFileSync(report, "# Report\n\nbody\n")
    expect(deliverableState(report, null)).toBe("complete")
    const pending = initManifest({ sessionDir: dir, promised: ["md"], lane: null })
    writeManifest(join(dir, MANIFEST_FILENAME), pending)
    expect(deliverableState(report, null)).toBe("partial")
    const done = setDeliverable(pending, "md", "delivered", { path: report })
    expect(deliverableState(report, done)).toBe("complete")
    writeManifest(join(dir, MANIFEST_FILENAME), done)
    expect(deliverableState(report, null)).toBe("complete")
  })
})

describe("briefingFacts and buildBriefing", () => {
  test("#given 2 [S<n>] lines and 1 [Source 3] line on 2 hosts and now = start + 61 min #when briefed #then sources 3, domains 2, minutes 61", () => {
    // given
    const dir = sessionDir()
    const manifest = setDeliverable(
      initManifest({ sessionDir: dir, promised: ["pdf", "docx"], lane: "no-format" }),
      "docx",
      "skipped",
      { reason: "chat delivery" },
    )
    const ledger = [
      "# Sources ledger",
      "[S1] https://alpha.example/one - primary",
      "[S2] https://www.beta.example/two",
      "[Source 3] https://alpha.example/three",
      "note: https://gamma.example/not-a-source",
      "",
    ].join("\n")
    const now = new Date(2026, 0, 1, 13, 1, 0)
    // when
    const facts = briefingFacts(manifest, ledger, now)
    const text = buildBriefing(manifest, ledger, now)
    // then
    expect(facts.sources).toBe(3)
    expect(facts.domains).toBe(2)
    expect(facts.minutes).toBe(61)
    expect(facts.deliverables).toEqual([
      { format: "pdf", status: "pending", reason: null, path: null },
      { format: "docx", status: "skipped", reason: "chat delivery", path: null },
    ])
    expect(facts.gates).toEqual(manifest.gates)
    expect(facts.residualDefects).toBe(0)
    expect(facts.repair).toBeNull()
    expect(typeof text).toBe("string")
    for (const token of ["pdf", "docx", "chat delivery"]) expect(text).toContain(token)
  })
})

describe("readManifest and writeManifest", () => {
  test("#given an existing manifest file #when overwritten #then it round-trips and leaves no temp file", () => {
    // given
    const dir = sessionDir()
    const file = join(dir, MANIFEST_FILENAME)
    const first = initManifest({ sessionDir: dir, promised: ["pdf"], lane: null })
    writeManifest(file, first)
    // when
    const second = setGate(first, "visual", "fail")
    writeManifest(file, second)
    // then
    expect(readManifest(file)).toEqual(second)
    expect(readdirSync(dir)).toEqual([MANIFEST_FILENAME])
  })

  test("#given an invalid manifest #when written or read #then it throws a typed error and writes nothing", () => {
    // given
    const dir = sessionDir()
    const file = join(dir, MANIFEST_FILENAME)
    // when / then
    expect(() => writeManifest(file, { schemaVersion: 99 })).toThrow(OutcomeError)
    expect(existsSync(file)).toBe(false)
    writeFileSync(file, "{not json")
    expect(() => readManifest(file)).toThrow(OutcomeError)
  })

  test("#given a manifest file written before the fidelity gate (four gates) #when read and written back #then it loads and the file gains fidelity not_run", () => {
    // given
    const dir = sessionDir()
    const file = join(dir, MANIFEST_FILENAME)
    const old = {
      schemaVersion: 1,
      sessionDir: dir,
      startedAt: START_LOCAL.toISOString(),
      finishedAt: null,
      elapsedMinutes: null,
      lane: "no-format",
      interview: null,
      deliverables: [{ format: "pdf", status: "pending", promised: true, updatedAt: START_LOCAL.toISOString() }],
      renders: [],
      gates: { static: "pass", layout: "not_run", visual: "fail", proofread: "not_run" },
      residualDefects: [],
      repair: null,
      sources: null,
    }
    writeFileSync(file, JSON.stringify(old))
    // when
    const manifest = readManifest(file)
    writeManifest(file, manifest)
    // then
    const written = JSON.parse(readFileSync(file, "utf8"))
    expect(written.gates).toEqual({
      static: "pass",
      fidelity: "not_run",
      layout: "not_run",
      visual: "fail",
      proofread: "not_run",
    })
    expect(written.schemaVersion).toBe(1)
  })
})

describe("round trip in a stamped session dir", () => {
  test("#given session dir 20260101-120000 #when init, set, gate, render, verify, brief through the file #then verify passes and the briefing is computed", () => {
    // given
    const dir = sessionDir()
    const file = join(dir, MANIFEST_FILENAME)
    writeManifest(file, initManifest({ sessionDir: dir, promised: ["html", "post"], lane: "no-format" }))
    expect(verifyManifest(readManifest(file)).ok).toBe(false)
    // when
    let manifest = readManifest(file)
    manifest = setDeliverable(manifest, "html", "delivered", { path: oneByteFile(dir, "report.html"), bytes: 1 })
    manifest = setDeliverable(manifest, "post", "skipped", { reason: "chat delivery" })
    manifest = addRender(setGate(manifest, "static", "pass"), join(dir, "page-1.png"), 1)
    writeManifest(file, manifest)
    const reread = readManifest(file)
    const ledger = join(dir, "sources-ledger.md")
    writeFileSync(ledger, "[S1] https://a.example/\n")
    const facts = briefingFacts(reread, readFileSync(ledger, "utf8"), new Date(2026, 0, 1, 12, 30, 0))
    // then
    expect(verifyManifest(reread)).toEqual({ ok: true, problems: [] })
    expect(facts.sources).toBe(1)
    expect(facts.minutes).toBe(30)
    expect(facts.gates.static).toBe("pass")
    expect(deliverableState(join(dir, "report.html"), null)).toBe("complete")
  })
})
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