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/delivery-gate.md

View on GitHub
# DELIVERY-GATE - Before/After Eval for code projects

Use for GREENFIELD, DEBUG, and LEGACY code edits. It records before state, after target, proof commands,
and residual risk.

## Contract

Before/After Eval is required for every GREENFIELD / DEBUG / LEGACY code-project change. Before Build mutates files, the
run vault must contain `GOAL.md` (from `templates/GOAL.md`), an approved `PLAN.md`
(from `templates/PLAN.md`), `QA.md` with `## Before` filled (from `templates/QA.md`), and
`run-state.json` from `templates/run-state.json`. Keep all compact: proof/resume ledgers, not transcripts.
LIGHT tier (role-loop `## Tier selection`) holds the same fields as its in-context checklist; the
vault-file form applies to STANDARD/DEEP.

Required fields and where each lives:

- `eval_intent` -> `PLAN.md` `## Intent`: user goal, constraints, tradeoffs, rejected approaches.
- `completion_promise` -> `PLAN.md` `## Intent`: promised outcome, required proof, stop condition, and
  approved `max_iterations`. `run-state.json` mirrors only that cap for loop resume.
- `requirement_trace` -> `GOAL.md` `## Success Criteria`: falsifiable checkbox per requirement, each
  naming its verifying check; plus `Backward-trace: clean` in `QA.md` when no diff hunk is orphan scope.
- `before_state` -> `QA.md` `## Before`: observed current behavior before the change.
- `after_target` -> `GOAL.md` `## Spec` + `## Success Criteria`: falsifiable expected behavior after the
  change.
- `reproduction_fidelity` -> `QA.md` `## Reproduction Fidelity`: for DEBUG/prod issues, exact/proxy data
  level, failure-triggering properties, prod-vs-test deltas, residual risk, and post-deploy confirmation
  plan.
- `command_manifest` -> `QA.md` `## Commands`: exact commands used for proof, with source:
  - `frozen_repo` - repo-owned command from AGENTS.md, package scripts, Makefile, CI, docs, or config.
  - `evaluator_owned` - command authored by the evaluator outside either arm's solution.
  - `agent_detected` - command found by the implementation agent; useful, but not enough alone.
- `decision_gates` -> `GOAL.md` `## Decision Gates`: findings classified as `auto-fix`, `no-op`, or
  `ask-user`.
- `after_evidence` -> `QA.md` `## Results` + `## QA`: checklist sentences with command outputs, artifact
  paths, screenshots, DB reads, or API captures proving the after target.
- `residual_risk` -> `QA.md` `## Residual Risk`: what the checks do not prove.
- `run_state` -> `run-state.json`: compact mutable/resumable checkpoint for branch/ref safety,
  phase/iteration/loop cap, unresolved gates, blockers, regression state, next action, forced reflection,
  and timestamp. Approval remains canonical in `PLAN.md`; proof commands remain canonical in `QA.md`;
  final completion is inferred from `phase: Finalize` with empty blockers/gates.

## Before State

- **GREENFIELD:** prove the start: feature absent, scaffold empty, acceptance test red, route 404, command
  missing, UI unavailable, or "no implementation exists" plus the first failing acceptance check.
- **DEBUG:** reproduce the live symptom first. Record the failing command/request/screenshot/log/data.
  If exact dev reproduction is unavailable, synthetic/similar data must preserve failure-triggering
  properties; fill `## Reproduction Fidelity`; done is conditional on residual risk plus post-deploy
  confirmation plan.
- **LEGACY / brownfield:** preserve current behavior before changing it. Capture exact API calls,
  screenshots, CLI output, DB rows, or tests for behavior that must not drift.
- **Shared code/state:** in any code mode, capture neighbor characterization baseline snapshots before
  Build (`reference/qa.md`), not only refactors.

No meaningful before proof -> say why and mark `Not proven` until another proof source exists.

## After Eval

Run real verification commands, then compare against before state:

- New behavior works.
- Required old behavior still works: captured neighbor snapshots re-run with no unnamed drift.
- Intended drift is named.
- Unintended drift is fixed or reported.
- Every `GOAL.md` Success Criterion and QA Case is checked, and Backward-trace is clean.
- Browser UI changes include browser evidence from `qa-gate.sh <vault> browser`.
- Data-backed behavior includes read-only DB evidence when available.

Done requires at least one trusted command (`frozen_repo` or `evaluator_owned`) in `QA.md`.
Agent-detected commands can supplement proof, but cannot be the whole proof.

## Decision Gates

- `auto-fix`: mechanical and low-risk; fix and recheck.
- `no-op`: informational; record why no action is needed.
- `ask-user`: changes product behavior, scope, data, security posture, external publishing, or user intent.

Unresolved `ask-user` findings block a final done claim.

## Done

Done means the vault shows: before state (`QA.md`), completion promise and stop condition (`PLAN.md`),
every `GOAL.md` Success Criterion checked, trusted command outputs/artifacts, resolved decision gates,
residual risk, clean backward trace, DEBUG/prod reproduction fidelity, final `run-state.json`,
`Z-<YYYY-MM-DD>.md` written with run branch and completion timestamp, changelog alternatives, and
commit gate passed (`## Commit gate`).

The final checkpoint must be valid JSON with `refs_verified: true`, `phase: Finalize`, `blockers: []`,
and `unresolved_gates: []`. `templates/run-state-gate.mjs` enforces this final-only state; the starting
template intentionally begins at Frame with unverified refs until run setup completes.

## Commit gate

Commit or merge into the target/integration branch only when proof is green and the user has accepted.
Block while any holds: REAL tests or request/docs not satisfied; QA.md does not contain exactly one
canonical `- Verdict: PASS` line;
an unchecked Success Criterion or QA Case in `GOAL.md` (including surfaced criteria); `PLAN.md` approval
still pending; a missing or non-clean `Backward-trace` in `QA.md` (scope-creep orphan); an unresolved
`ask-user` decision gate; a missing `Z-*.md` completion marker (or one written while a criterion is still
unchecked); non-exact reproduction fidelity without residual risk and post-deploy confirmation plan; or
fulfillment is uncertain.

Blocked is fix-first: the role-loop resolves it (fix the red, finish QA, tick the criterion). Ask the
user about the requirement only when it is requirement-level (ambiguous or unmet), genuinely uncertain, or
the Build->Verify loop hit `max_iterations` (`reference/role-loop.md`); route via `reference/interview.md`.
Never commit on an assumption - resolve it or get explicit acceptance.

Backstop: `bash templates/commit-gate.sh <vault> <browser|cli|none>` must exit 0 before commit/merge.
Never edit the gate to pass.
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