Skip to content

cskwork/supergoal-skill / skills/supergoal

supergoal

Unverified

Route objective-driven development, verification, planning, "teach/explain", codebase learning, and skill evaluation through the Supergoal workflow. Use when Supergoal is requested or an autonomous delivery workflow is needed.

FileKindSize
SKILL.mdskill md12.8 KB
agents/analyst.mdmarkdown1.5 KB
agents/architect.mdmarkdown1.7 KB
agents/code-reviewer.mdmarkdown2.5 KB
agents/db-reader.mdmarkdown2.0 KB
agents/debugger.mdmarkdown2.0 KB
agents/designer.mdmarkdown6.3 KB
agents/executor.mdmarkdown2.8 KB
agents/explore.mdmarkdown2.0 KB
agents/qa-auditor.mdmarkdown4.3 KB
agents/qa-tester.mdmarkdown3.2 KB
agents/security-reviewer.mdmarkdown1.2 KB
agents/skill-forger.mdmarkdown1.6 KB
agents/skill-miner.mdmarkdown1.6 KB
reference/agent-browser.mdmarkdown2.8 KB
reference/arch.mdmarkdown5.1 KB
reference/archify.mdmarkdown3.6 KB
reference/db-access.mdmarkdown2.9 KB
reference/debugging.mdmarkdown6.5 KB
reference/delivery-gate.mdmarkdown6.6 KB
reference/domain-context.mdmarkdown7.8 KB
reference/domain-rules.mdmarkdown1.6 KB
reference/engagement.mdmarkdown3.8 KB
reference/functional-ui.mdmarkdown6.4 KB
reference/harness-eval.mdmarkdown28.7 KB
reference/interview.mdmarkdown7.7 KB
reference/learn-domain.mdmarkdown12.7 KB
reference/market-research.mdmarkdown1.7 KB
reference/observability.mdmarkdown5.0 KB
reference/plan-grounding.mdmarkdown4.3 KB
reference/playwright-cli.mdmarkdown2.6 KB
reference/prototype.mdmarkdown4.5 KB
reference/qa-only.mdmarkdown12.7 KB
reference/qa.mdmarkdown7.9 KB
reference/reporting.mdmarkdown1.5 KB
reference/research.mdmarkdown2.7 KB
reference/review-only.mdmarkdown2.4 KB
reference/role-loop.mdmarkdown26.7 KB
reference/rules.mdmarkdown982 B
reference/skill-mine.mdmarkdown7.6 KB
reference/taste-aesthetics.mdmarkdown7.5 KB
reference/taste-skill-v2.mdmarkdown18.8 KB
reference/taste-sources.mdmarkdown3.0 KB
reference/teach.mdmarkdown28.0 KB
reference/ui-ux.mdmarkdown4.0 KB
reference/vercel-host.mdmarkdown3.6 KB
reference/wayfinder.mdmarkdown7.2 KB
templates/GOAL.mdmarkdown1.3 KB
templates/PLAN.mdmarkdown1.4 KB
templates/QA.mdmarkdown1.2 KB
templates/R-LOOP.mdmarkdown569 B
templates/Z-DONE.mdmarkdown301 B
templates/arch-report.htmlother8.1 KB
templates/commit-gate.shexecutablescript11.6 KB
templates/contrast-gate.mjsexecutablescript4.3 KB
templates/db-access/.env.exampleother451 B
templates/db-access/check-connection.shexecutablescript134 B
templates/db-access/db-access.cmdscript39 B
templates/db-access/db-access.mjsexecutablescript5.2 KB
templates/db-access/read-only-query.shexecutablescript138 B
templates/db-access/schema-summary.shexecutablescript132 B
templates/domain-agent/code-map.mdmarkdown744 B
templates/domain-agent/config.jsonconfig291 B
templates/domain-agent/decisions/README.mdmarkdown270 B
templates/domain-agent/flows/README.mdmarkdown800 B
templates/domain-agent/freshness.mdmarkdown1.2 KB
templates/domain-agent/glossary.mdmarkdown781 B
templates/domain-agent/index.mdmarkdown1.3 KB
templates/domain-agent/invariants.mdmarkdown504 B
templates/domain-agent/qa/README.mdmarkdown879 B
templates/domain-agent/qa/nav-map.mdmarkdown1.2 KB
templates/domain-agent/test-map.mdmarkdown432 B
templates/domain-agent/tickets/README.mdmarkdown204 B
templates/domain-onboarding.htmlother9.2 KB
templates/harness-eval-case.yamlconfig4.4 KB
templates/harness-eval-cases/authored/authored-underspec-001-deepmerge.yamlconfig2.2 KB
templates/harness-eval-cases/authored/authored-underspec-002-csvline.yamlconfig2.0 KB
templates/harness-eval-cases/authored/authored-underspec-003-authz-cache.yamlconfig1.6 KB
templates/harness-eval-cases/fixtures/README.mdmarkdown2.8 KB
templates/harness-eval-cases/fixtures/revfactory-case-002-async-race/package.jsonmanifest124 B
templates/harness-eval-cases/fixtures/revfactory-case-002-async-race/src/cache.mjsscript494 B
templates/harness-eval-cases/fixtures/revfactory-case-002-async-race/test/cache.hidden.test.mjsscript2.2 KB
templates/harness-eval-cases/fixtures/revfactory-case-002-async-race/test/cache.visible.test.mjsscript950 B
templates/harness-eval-cases/fixtures/revfactory-case-003-refactoring/package.jsonmanifest125 B
templates/harness-eval-cases/fixtures/revfactory-case-003-refactoring/src/order.mjsscript1.3 KB
templates/harness-eval-cases/fixtures/revfactory-case-003-refactoring/test/order.hidden.test.mjsscript2.2 KB
templates/harness-eval-cases/fixtures/revfactory-case-003-refactoring/test/order.visible.test.mjsscript1.2 KB
templates/harness-eval-cases/fixtures/underspec-001-deepmerge/package.jsonmanifest124 B
templates/harness-eval-cases/fixtures/underspec-001-deepmerge/src/merge.mjsscript84 B
templates/harness-eval-cases/fixtures/underspec-001-deepmerge/test/merge.hidden.test.mjsscript1013 B
templates/harness-eval-cases/fixtures/underspec-001-deepmerge/test/merge.visible.test.mjsscript276 B
templates/harness-eval-cases/fixtures/underspec-002-csvline/package.jsonmanifest122 B
templates/harness-eval-cases/fixtures/underspec-002-csvline/src/csv.mjsscript77 B
templates/harness-eval-cases/fixtures/underspec-002-csvline/test/csv.hidden.test.mjsscript804 B
templates/harness-eval-cases/fixtures/underspec-002-csvline/test/csv.visible.test.mjsscript240 B
templates/harness-eval-cases/fixtures/underspec-003-authz-cache/package.jsonmanifest126 B
templates/harness-eval-cases/fixtures/underspec-003-authz-cache/src/authorizer.mjsscript601 B
templates/harness-eval-cases/fixtures/underspec-003-authz-cache/test/authorizer.hidden.test.mjsscript3.8 KB
templates/harness-eval-cases/fixtures/underspec-003-authz-cache/test/authorizer.visible.test.mjsscript1.2 KB
templates/harness-eval-cases/revfactory-case-001-rest-api.yamlconfig2.1 KB
templates/harness-eval-cases/revfactory-case-002-bug-fix.yamlconfig2.4 KB
templates/harness-eval-cases/revfactory-case-003-refactoring.yamlconfig2.4 KB
templates/harness-eval-cases/revfactory-case-004-documentation.yamlconfig2.1 KB
templates/harness-eval-cases/revfactory-case-005-complex.yamlconfig2.0 KB
templates/harness-eval-cases/revfactory-case-006-research.yamlconfig2.1 KB
templates/harness-eval-cases/revfactory-case-007-interpreter.yamlconfig2.1 KB
templates/harness-eval-cases/revfactory-case-008-microservice.yamlconfig2.1 KB
templates/harness-eval-cases/revfactory-case-009-sql-engine.yamlconfig2.0 KB
templates/harness-eval-cases/revfactory-case-010-crdt.yamlconfig2.0 KB
templates/harness-eval-cases/revfactory-case-011-raft-kv.yamlconfig2.1 KB
templates/harness-eval-cases/revfactory-case-012-spreadsheet.yamlconfig2.1 KB
templates/harness-eval-cases/revfactory-case-013-bytecode-vm.yamlconfig2.1 KB
templates/harness-eval-cases/revfactory-case-014-event-sourcing.yamlconfig2.1 KB
templates/harness-eval-cases/revfactory-case-015-lsp.yamlconfig2.3 KB
templates/harness-eval-cases/run-local-eval.mjsscript43.3 KB
templates/harness-eval-cases/run-underspec-n3.mjsscript41.1 KB
templates/harness-eval-external/deepswe/README.mdmarkdown9.9 KB
templates/harness-eval-external/deepswe/prepare-supergoal-arm.mjsscript4.4 KB
templates/harness-eval-external/deepswe/run-default-suite.mjsscript6.1 KB
templates/harness-eval-external/deepswe/run-full-cycle.mjsscript25.3 KB
templates/harness-eval-external/deepswe/task-set.yamlconfig12.2 KB
templates/harness-eval-external/featadd/README.mdmarkdown3.9 KB
templates/harness-eval-external/featadd/features.tsvother1.6 KB
templates/harness-eval-external/featadd/gen.shscript4.0 KB
templates/harness-eval-external/featadd/package.pyscript6.2 KB
templates/harness-eval-gate.mjsscript24.9 KB
templates/harness-eval-report.mdmarkdown5.8 KB
templates/harness-eval-result.jsonconfig11.9 KB
templates/harness-eval-runner.mjsscript19.9 KB
templates/harness-eval-stats.mjsscript1.8 KB
templates/learn-grounding-gate.mjsscript6.1 KB
templates/observability/heartbeat.schema.jsonconfig2.5 KB
templates/observability/sg-emit.shexecutablescript5.4 KB
templates/qa-gate.shexecutablescript6.9 KB
templates/qa-only-gate.shexecutablescript5.1 KB
templates/qa-report.mdmarkdown2.8 KB
templates/rules.mdmarkdown301 B
templates/run-state-gate.mjsscript2.2 KB
templates/run-state.jsonconfig474 B
templates/skill-frontmatter-gate.mjsscript3.7 KB
templates/skill-install-audit.mjsexecutablescript3.7 KB
templates/skill-mine/mine.mjsscript7.8 KB
templates/skill.md.templateother568 B
templates/teach-lesson-gate.mjsscript5.4 KB
templates/teach/README.mdmarkdown4.1 KB
templates/teach/assets/lesson-book.jsscript5.8 KB
templates/teach/assets/lesson-template.htmlother6.1 KB
templates/teach/assets/lesson.cssother11.8 KB
templates/teach/assets/quiz.jsscript3.2 KB

templates/domain-onboarding.html

View on GitHub
<!DOCTYPE html>
<!--
  /supergoal LEARN-DOMAIN Onboard handbook - HUMAN ONLY.

  This is a self-contained skeleton. Clone it and fill every <!-- FILL ... --> region
  FROM THE PERSISTED .domain-agent/ PACK ONLY. Rules:
    - Functional tier (reference/functional-ui.md): one accent + one type/spacing/radius scale,
      computed WCAG-AA contrast (body AAA), information density, minimal motion. The named-design-system
      rule is satisfied with this inline token set because the file must stay self-contained/offline.
    - Introduce no fact absent from the pack. Never upgrade an `unverified` fact to verified.
    - Self-contained: inline CSS only. NO external scripts, fonts, CDN, or network requests.
      Any diagram is inline SVG or CSS boxes. Works offline.
    - Carry each load-bearing fact's grounding as a visible badge (Verified / Unverified).
    - Put expert detail (signatures, file paths, probe commands) inside <details> blocks.
    - Prose in the user's language; keep identifiers, signatures, file paths, commands verbatim.
    - No secrets, tokens, raw logs, or PII.
  Source map: §1 index.md  §2 glossary.md  §3 index.md+code-map.md  §4 flows/*.md
              §5 invariants.md  §6 test-map.md  §7 config.json
-->
<html lang="en">
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <title><!-- FILL: System name --> — Domain Onboarding Handbook</title>
  <style>
    :root {
      color-scheme: light dark;
      --bg: #ffffff; --surface: #f5f6f8; --border: #d8dce2;
      --text: #1b1f24; --muted: #586069; --accent: #2f6feb;
      --ok-bg: #e6f4ea; --ok-fg: #1a7f37; --warn-bg: #fff4e5; --warn-fg: #9a6700;
      --code-bg: #f0f1f3;
    }
    @media (prefers-color-scheme: dark) {
      :root {
        --bg: #0d1117; --surface: #161b22; --border: #30363d;
        --text: #e6edf3; --muted: #9da7b3; --accent: #6ea8ff;
        --ok-bg: #11271a; --ok-fg: #56d364; --warn-bg: #2b2111; --warn-fg: #e3b341;
        --code-bg: #1c2128;
      }
    }
    * { box-sizing: border-box; }
    body {
      margin: 0; background: var(--bg); color: var(--text);
      font: 16px/1.65 system-ui, -apple-system, "Segoe UI", Roboto, sans-serif;
    }
    .wrap { max-width: 1080px; margin: 0 auto; padding: 0 24px 96px; }
    header.page {
      border-bottom: 1px solid var(--border); padding: 32px 0 24px; margin-bottom: 8px;
    }
    header.page h1 { margin: 0 0 4px; font-size: 1.9rem; line-height: 1.2; }
    header.page p.lede { margin: 0; color: var(--muted); max-width: 64ch; }
    nav.toc {
      position: sticky; top: 0; background: var(--bg); border-bottom: 1px solid var(--border);
      padding: 12px 0; margin-bottom: 32px; font-size: 0.92rem;
    }
    nav.toc ol { list-style: none; display: flex; flex-wrap: wrap; gap: 6px 18px; margin: 0; padding: 0; }
    nav.toc a { color: var(--accent); text-decoration: none; }
    nav.toc a:hover, nav.toc a:focus { text-decoration: underline; }
    section { margin: 0 0 48px; scroll-margin-top: 64px; }
    section > h2 { font-size: 1.4rem; border-bottom: 1px solid var(--border); padding-bottom: 6px; }
    h3 { font-size: 1.08rem; margin: 28px 0 8px; }
    p, li { max-width: 72ch; }
    code, pre {
      font-family: ui-monospace, SFMono-Regular, "SF Mono", Menlo, Consolas, monospace;
      background: var(--code-bg); border-radius: 4px;
    }
    code { padding: 1px 5px; font-size: 0.9em; }
    pre { padding: 12px 14px; overflow-x: auto; border: 1px solid var(--border); }
    .badge {
      display: inline-block; font-size: 0.72rem; font-weight: 600; letter-spacing: .02em;
      padding: 2px 8px; border-radius: 999px; vertical-align: middle; white-space: nowrap;
    }
    .badge.verified { background: var(--ok-bg); color: var(--ok-fg); }
    .badge.unverified { background: var(--warn-bg); color: var(--warn-fg); }
    dl.glossary { display: grid; grid-template-columns: minmax(140px, 1fr) 3fr; gap: 4px 20px; }
    dl.glossary dt { font-weight: 600; }
    dl.glossary dd { margin: 0 0 8px; color: var(--text); }
    table { border-collapse: collapse; width: 100%; font-size: 0.95rem; }
    th, td { text-align: left; padding: 8px 10px; border-bottom: 1px solid var(--border); vertical-align: top; }
    th { background: var(--surface); }
    .card {
      background: var(--surface); border: 1px solid var(--border);
      border-radius: 8px; padding: 14px 16px; margin: 12px 0;
    }
    details { background: var(--surface); border: 1px solid var(--border); border-radius: 6px; padding: 8px 14px; margin: 8px 0; }
    details > summary { cursor: pointer; font-weight: 600; color: var(--accent); }
    .legend { display: flex; flex-wrap: wrap; gap: 16px; align-items: center; }
    figure.diagram { margin: 16px 0; overflow-x: auto; }
    figure.diagram svg { max-width: 100%; height: auto; }
    .updated { color: var(--muted); font-size: 0.9rem; }
    @media (max-width: 768px) {
      dl.glossary { grid-template-columns: 1fr; gap: 2px; }
      .wrap { padding: 0 16px 64px; }
    }
  </style>
</head>
<body>
  <div class="wrap">
    <header class="page">
      <h1><!-- FILL: System name --></h1>
      <p class="lede"><!-- FILL §1: one-sentence "what this is and who it serves" --></p>
    </header>

    <nav class="toc" aria-label="Sections">
      <ol>
        <li><a href="#orientation">1. Orientation</a></li>
        <li><a href="#terms">2. Key terms</a></li>
        <li><a href="#architecture">3. Architecture</a></li>
        <li><a href="#flows">4. Key flows</a></li>
        <li><a href="#rules">5. Rules that must not break</a></li>
        <li><a href="#hands-on">6. Get hands-on</a></li>
        <li><a href="#trust">7. Trust &amp; freshness</a></li>
      </ol>
    </nav>

    <!-- §1 Orientation (source: index.md) -->
    <section id="orientation">
      <h2>1. Orientation</h2>
      <p><!-- FILL: plain-language mental model — what problem the system solves, the big pieces, in 1–2 short paragraphs --></p>
    </section>

    <!-- §2 Key terms (source: glossary.md — this repo's meaning, NOT generic industry meaning) -->
    <section id="terms">
      <h2>2. Key terms</h2>
      <dl class="glossary">
        <dt><!-- FILL: term --></dt>
        <dd><!-- FILL: what it means in THIS repo, in plain language --></dd>
        <!-- repeat dt/dd per glossary entry -->
      </dl>
    </section>

    <!-- §3 Architecture (source: index.md systems + code-map.md entry points) -->
    <section id="architecture">
      <h2>3. Architecture</h2>
      <p><!-- FILL: how a request / piece of data moves through the system, in plain language --></p>
      <figure class="diagram">
        <!-- FILL: inline SVG or CSS boxes only. No <script>, no external diagram libraries. -->
        <figcaption class="updated"><!-- FILL: one-line caption --></figcaption>
      </figure>
      <details>
        <summary>Entry points &amp; key symbols (expert detail)</summary>
        <!-- FILL: code-map.md signatures, file paths, routes — verbatim -->
      </details>
    </section>

    <!-- §4 Key flows (source: flows/<ctx>.md — one per flow, entry -> service -> data/external) -->
    <section id="flows">
      <h2>4. Key flows</h2>
      <article class="card">
        <h3><!-- FILL: flow name --> <span class="badge verified">Verified</span></h3>
        <p><!-- FILL: entry -> service -> data/external in human terms; name the invariants it touches --></p>
        <details>
          <summary>Code path &amp; probe (expert detail)</summary>
          <!-- FILL: cited file:line path and the proof command from test-map.md -->
        </details>
      </article>
      <!-- repeat one card per flow file -->
    </section>

    <!-- §5 Rules that must not break (source: invariants.md — show grounding status on each) -->
    <section id="rules">
      <h2>5. Rules that must not break</h2>
      <table>
        <thead><tr><th>Rule</th><th>Why it matters</th><th>Grounding</th></tr></thead>
        <tbody>
          <tr>
            <td><!-- FILL: invariant --></td>
            <td><!-- FILL: consequence if broken --></td>
            <td><span class="badge verified">Verified</span><!-- or unverified; match invariants.md --></td>
          </tr>
          <!-- repeat per invariant -->
        </tbody>
      </table>
    </section>

    <!-- §6 Get hands-on (source: test-map.md — exact commands a newcomer runs) -->
    <section id="hands-on">
      <h2>6. Get hands-on</h2>
      <p>Run these to see the system work and to verify the facts above yourself:</p>
      <pre><code><!-- FILL: exact commands from test-map.md, verbatim --></code></pre>
    </section>

    <!-- §7 Trust & freshness (source: config.json) -->
    <section id="trust">
      <h2>7. Trust &amp; freshness</h2>
      <div class="legend">
        <span><span class="badge verified">Verified</span> proven by a probe that ran (see the expert detail).</span>
        <span><span class="badge unverified">Unverified</span> not executable; treat with care.</span>
      </div>
      <p class="updated">Last learned: <!-- FILL: config.json.lastUpdated -->.</p>
      <p>Source of truth: the <code>.domain-agent/</code> markdown pack the agent reads. This handbook is
        a derived, human-facing snapshot — if it disagrees with current code or the pack, the pack and the
        code win. Regenerated on each LEARN-DOMAIN run.</p>
    </section>
  </div>
</body>
</html>
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall