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/domain-context.md

View on GitHub
# Domain context - repo-local knowledge without prompt bloat

Domain context is a durable, searchable knowledge pack at the target repo root. It stays separate from
the run vault and model memory.

- Vault: per-run evidence and decisions in `docs/changelog/<YYYY-MM>/<DD-topic>/` (one folder per
  run: `GOAL.md`, `PLAN.md`, `QA.md`, `R-LOOP.md`, `run-state.json`, `qa/` evidence, and `Z-<date>.md`
  on completion).
- Domain context: local reusable domain facts, stored by default in `.domain-agent/`.
- Model memory: optional reminders only; never the source of truth for a fix.

Current docs/code always win. Treat `.domain-agent/` as a routing index for code, tests, terms, and
flows.

Load for GREENFIELD domain fit, DEBUG proof/root-cause routing, and LEGACY affected-code maps. Skip for
pure TEACH unless the user asks about repo domain.

## First-run setup

Check for `<knowledgePath>/config.json` (default `.domain-agent` at the target repo root). If it does
not exist, ask one concise question:

```text
I do not see domain-agent knowledge for this repo. Should I create it at `.domain-agent/`, or use another path?
```

Then create the chosen folder from `templates/domain-agent/`; write `config.json` (repo, path, `language`,
dates); Add the chosen path to the repo root `.gitignore` if absent; record the path in the run vault
`PLAN.md`. Before Build, only knowledge scaffolding, `.gitignore`, and vault setup may write. If the
user declines storage, use an ephemeral Domain Brief in the vault.

Set `language` to the repo's docs language (SKILL.md), or `mixed` when no single one dominates.

## File contract

Use these folder/file names even when the user chooses a different root path:

- `config.json` - version, repo, language, knowledgePath, createdAt, lastUpdated.
- `index.md` - router only: systems, feature areas, flow files, search keys; short enough to read first.
- `glossary.md` - domain terms as used in THIS repo (not generic industry meaning); pick one
  canonical term per concept and list avoided aliases.
- `invariants.md` - business/safety rules; each with a source, confidence, and one way to verify it.
- `code-map.md` - stable entry points (routes, services, repositories, DTOs, migrations, queues,
  jobs, external clients); a map, not an architecture document.
- `test-map.md` - exact commands: targeted/integration tests, build/type/lint, fixtures, env
  prerequisites.
- `flows/*.md` - one source-grounded feature/business flow per file, named what tickets search for
  (`auth-session.md`, `checkout-refund.md`).
- `decisions/*.md` - durable domain decisions only; prefer the repo's own decision system; save here
  only when the choice is hard to reverse, surprising without context, and a real tradeoff.
- `tickets/*.md` - reusable postmortems only (a stable failure mode, invariant, or repro pattern);
  not every ticket.
- `qa/*.md` - Reusable QA suites from QA-ONLY runs (`reference/qa-only.md`): Impact Matrix, scenario
  list, `Comparison:` type, named DB checks, saved baseline values, reproduction notes, coverage,
  uncovered areas, residual risks, and driver-neutral re-run steps; Playwright spec paths only for
  documented fallback runs. Indexed in `index.md` under `## QA Suites`. No secrets, raw rows, or PII.
- `qa/nav-map.md` - one browser navigation map: entry/auth, `screen -> URL`, popup/new-tab handling,
  stable selectors, real API calls. Load before browser QA/observe and self-heal on drift
  (`reference/qa.md` "Navigation map"). No secrets, raw rows, or PII.

## Retrieval loop (every run; capped)

Goal: a small working brief, not a domain encyclopedia.

1. Read `config.json`, then `index.md` (keep it as the router).
2. Extract ticket keywords: routes, errors, domain terms, DTO/entity names, external systems,
   expected behavior.
3. Search the knowledge folder with literal terms first.
4. Select the smallest relevant set - usually `glossary.md`, `invariants.md`, `test-map.md`, and one
   `flows/*.md`.
5. Verify load-bearing saved facts against current code with structural tools (`codegraph_context`,
   `codegraph_explore`, call paths) and find current entry points.
6. Write a compact `## Domain Brief` to the run vault `PLAN.md` (beside the grounding ledger).

Hard caps: Select at most five domain files for a phase unless the human approves more. If more seem
relevant, route through `index.md` again and name the uncertainty. Prefer one `flows/*.md`; two means the
ticket may span domains. Keep the Domain Brief under 80 lines. Split broad files by feature area and
update `index.md`.

## Freshness loop

Do not refresh the whole pack every run; verify selected facts against current code.

- Light refresh threshold: 5 days after `config.json.lastUpdated` - run CodeGraph status for affected
  repos, check docs/source changed since `lastUpdated`, re-read only selected + cited files, patch
  stale entries surgically.
- Full review threshold: 30 days after `config.json.lastUpdated`, major repo changes, or repeated
  stale-context misses - review router, code map, test map, invariants, high-traffic flows; split broad
  files instead of appending context.
- Triggered refresh: saved knowledge conflicts with current code, or a run proves a stable new
  routing fact. `qa/nav-map.md` is verified against the live site on every browser run; correct a
  drifted row (selector, route, popup target, API path) in place as a triggered refresh, not a
  whole-app re-crawl.

## Domain Brief format

```md
## Domain Brief

- Knowledge path: `.domain-agent/`
- Selected knowledge files: `index.md`, `flows/<name>.md`, `test-map.md`
- Stable terms: <term -> meaning>
- Terminology conflicts: <conflicts found, or 'none'>
- Invariants: <rules that affect this change>
- Current-code verification: <symbols/routes/files checked now>
- Entry points: <route/method/class/file>
- Test commands: <targeted proof commands>
- Gaps: <unknowns, or 'none'>
```

By default, later phases receive only the Domain Brief.

## Saving loop

Save new knowledge only when ALL hold: stable across future tickets; verified against current
code/tests/docs; no secrets/tokens/raw logs/customer data/PII; improves future routing, reproduction,
planning, or verification. Ticket-specific evidence stays in the vault.

Do not save: Raw investigation transcripts, long code excerpts, complete tickets, temporary
hypotheses, or facts one current-code lookup finds just as fast.

Append surgically: term -> `glossary.md`; invariant -> `invariants.md`; entry point -> `code-map.md`;
command -> `test-map.md`; flow -> `flows/<flow>.md`; stable failure pattern ->
`tickets/<short-slug>.md`; reusable QA suite -> `qa/<suite>.md` (indexed under `## QA Suites`);
browser navigation fact (route, popup/new-tab, stable selector, `screen -> API`) -> `qa/nav-map.md`. After
each save, update `index.md` search keys and `config.json.lastUpdated`; keep entries short and split
files that accumulate unrelated content.

Terminology updates: capture a stable routing term; challenge vague/overloaded words against selected
files, current docs, and glossary before adding a synonym; keep implementation details in
`code-map.md`/`flows/*.md`/`test-map.md`, not glossary; record wording conflicts in the Domain Brief.

Decision updates: prefer the repo's existing decision records; use `decisions/*.md` only for choices
hard to reverse, surprising without context, and made between real alternatives - never ordinary
implementation notes.

## Trust rules

1. Saved knowledge can be stale. Verify load-bearing facts against current code before the plan
   freezes.
2. Saved knowledge is local and ignored by default. Do not assume another machine has it.
3. Do not commit `.domain-agent/` unless the user explicitly asks for a sanitized publication path.
4. `.gitignore` must contain the chosen knowledge path before local knowledge is written.
5. If saved context conflicts with code, write the conflict in the Domain Brief and let current code
   drive the plan.
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