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

reference/qa.md

View on GitHub
# QA - black-box exercise of the running app

QA drives the real app like a user and records observable evidence. Applies to GREENFIELD/LEGACY and
web-bug DEBUG checks.

UI changes are browser app verification: if product code changes a user-facing browser surface, the run
must drive that surface with `agent-browser` and pass `bash templates/qa-gate.sh <vault> browser`.
Lint/typecheck/build/unit/static screenshots can support but not replace browser evidence.

QA-ONLY is the broad regression lane. For "QA only", broad verification, or post-change impact sweep, use
`reference/qa-only.md`'s Impact Matrix. GREENFIELD/LEGACY/DEBUG browser QA stays lean by default, but may
borrow the matrix for high-blast-radius changes.

## Characterization baseline (non-UI code changes)

Use when GREENFIELD / DEBUG / LEGACY work touches shared code/state: function, module, global state,
DB row/schema, config, cache, integration contract.

1. Enumerate consumers, don't guess: for each symbol/state the plan modifies, list its direct
   consumers - callers, importers, shared-state readers, contract consumers - via grep/LSP/code
   graph, whichever the repo has. Record the consumer list in `QA.md` `## Before`.
2. Cover every enumerated consumer with one of: (a) a characterization baseline saved to
   `<vault>/qa/baseline/<neighbor>.txt`, (b) a named existing REAL test the verifier re-runs, or
   (c) a named residual-risk line in `QA.md`. A silently uncovered consumer is red.
3. After editing, re-run the same checks and diff against the snapshots.

Unnamed drift is red. Intentional drift must be named in `QA.md`. Characterization is a
regression signal, not a correctness oracle; update snapshots only for intentional bug fixes.

## Scenario stencil (code changes)

Lean default for DEBUG/LEGACY/GREENFIELD code verification:

- Equivalence partitions: normal inputs that should follow the same rule.
- Boundary values: null/undefined/empty/min/max/ordering edges.
- Negative/error paths: rejected inputs, failed dependencies, recovery.
- Regression: previous passing neighbor scenarios the change could break; link to captured baselines.
- Metamorphic relation: when no exact oracle exists, transform equivalent inputs and require equivalent
  meaning across outputs. Candidate execution is required; otherwise record named residual risk.

For prod issues that do not reproduce exactly in dev, derive synthetic or similar data from prod evidence
(logs, stack, read-only schema/rows via `reference/db-access.md`) while preserving failure-triggering
properties such as null/boundary/scale/ordering/timing/concurrency. Scrub PII. Do not call one fabricated
green case conclusive; record reproduction fidelity and post-deploy confirmation in the proof.

## Always use the `qa-tester` subagent

Browser dumps/screenshots/logs stay in `qa-tester`. Conductor receives summary + evidence paths only.

## Browser context capture - default and fallback

Use one driver per run. agent-browser is the default browser driver (`reference/agent-browser.md`). Use
`playwright-cli` only when agent-browser cannot complete reliable QA; record why under `Fallback:` and
load `reference/playwright-cli.md`.

1. **Serve.** Start the app from the working tree (or the Verify worktree when one is used), poll
   until ready, record URL, tear down at end. Static/single HTML opens via `file://` from that tree.
2. **Get the driver.** `command -v agent-browser`; if absent, `npm install -g agent-browser`, then
   `agent-browser install`. If it cannot QA the required flow reliably, switch explicitly per
   `reference/playwright-cli.md`; never use an unrecorded substitute.
3. **Drive flows.** `open`, `snapshot` (get `@ref`s), `click`/`type`/`fill`, `screenshot`. Golden
   path, edge cases, and a11y must pass. UI/UX jobs also run `reference/ui-ux.md` pre-flight, record a
   `UI-tier: Expressive|Functional` line in `## QA`, and enumerate the
   text/background pairs to `qa/contrast-pairs.json` — `qa-gate.sh` runs the contrast gate and blocks on FAIL.
4. **Capture the network.** `agent-browser network requests` lists calls; `network request <id>` shows
   method + path + status + payload for one. This is the shared evidence for DEBUG `screen -> API` and
   LEGACY baseline (below). The Verify step still re-runs the project's REAL tests with no browser.
5. **Capture as-is/to-be.** Same route and viewport:
   `qa/as-is-<view>.png` before, `qa/to-be-<view>.png` after. For DEBUG, as-is is the failure and to-be
   is fixed behavior.

## Navigation map (load first; build on first entry; self-heal on drift)

Use `.domain-agent/qa/nav-map.md` to avoid rediscovering auth gates, popups, new tabs, and deep routes.
It also gives DEBUG `screen -> API` routing and LEGACY the exact screen/API to baseline. Repo-local and
gitignored; no app-specific selector, route, or credential lives in this skill.

1. **Load first.** Before driving, read `.domain-agent/qa/nav-map.md` if present and navigate by its
   entry/auth flow, route list, popup/new-tab triggers, tab-switch notes, and stable selectors.
2. **Build on first entry (when absent).** Within the action budget, do one light mapping pass and save
   it: the entry/auth flow; the `screen -> URL` route list; every click that opens a **new tab or
   popup** and the resulting target; how to switch the driver to that target; stable selectors for key
   controls; and each screen's real API calls from `agent-browser network requests` (method + path).
   Write `.domain-agent/qa/nav-map.md` and index it in `index.md`.
3. **Self-heal on drift.** When a saved entry no longer matches the live site - a selector ref is gone,
   a route 404s/redirects, a popup opens a different target, or an API path/method changed - re-map only
   that slice, correct that row, and bump `config.json.lastUpdated`. Never re-crawl the whole app.

**New tab / popup handling.** Run `agent-browser tab`, switch with `agent-browser tab <tN|label>`, then
re-`snapshot`; record `trigger -> target` in nav-map (`reference/agent-browser.md`).

## API behavior baseline (LEGACY preserve)

Before refactoring or integrating against an existing API, capture its exact behavior so the refactor
preserves it. DEBUG's `screen -> endpoint` only localizes. Save to the run vault
`<vault>/qa/api-baseline-<endpoint>.md`: method + path + status + a representative request and the
response shape (the contract, not every value).

- **UI-reachable** - reach the screen via `qa/nav-map.md` and capture real calls with `agent-browser
  network requests` (`network request <id>` for one call's full contract), through `qa-tester`;
  promote a confirmed `screen -> API` row back into nav-map.
- **Backend-only (no UI)** - capture at the HTTP level: a recorded curl/HAR or an HTTP probe (e.g. the
  `verify` skill) against the running endpoint.

After refactor, re-capture the same call and diff; unintended drift is red (role-loop Verify). Baselines
are per-run vault evidence, never domain pack; strip secrets, tokens, PII.

## Authenticated sessions

Use an agent-browser named session, `state save`/`state load`, or CDP `connect` for real login state
(`reference/agent-browser.md`). The same options exist in the Playwright fallback reference.

## CLI / library

Run an integration smoke: real invocation against a fixture, stdout/stderr/exit-code compared to
known-good output.

## Vault record

Put evidence under `<vault>/qa/` and summarize in `QA.md` `## QA`:

- `Tool: agent-browser` by default; `Tool: playwright-cli` plus `Fallback: agent-browser <reason>` only
  when the default cannot complete reliable QA.
- Commands run and pass/fail per check.
- Exact `qa/as-is-<view>.png` and `qa/to-be-<view>.png` paths.
- Served URL and teardown note.

## Exit gate

QA passes only when `bash templates/qa-gate.sh <vault> <browser|cli>` exits 0. Browser runs require
as-is/to-be evidence and the driver record above. Never edit the gate to pass.

## Repeatable script

First QA may be hand-driven. On re-check, save a repeatable agent-browser batch/script; when fallback is
required, save a Playwright spec. Record the path in `## QA`.
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: 471kUpdated 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