cskwork/supergoal-skill / skills/supergoal
supergoal
UnverifiedRoute 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.
templates/observability/heartbeat.schema.json
View on GitHub{
"$schema": "http://json-schema.org/draft-07/schema#",
"$id": "supergoal/observability/heartbeat.schema.json",
"title": "Supergoal Board heartbeat",
"description": "One file per agent at $SUPERGOAL_RUN_DIR/agents/<agent_id>.json, replaced atomically by sg-emit. A point-in-time snapshot; tasks[] is a full board snapshot, never a delta.",
"type": "object",
"additionalProperties": false,
"required": ["schemaVersion", "agent_id", "repo_path", "repo", "branch", "worktree", "started_at", "updated_at", "tasks"],
"properties": {
"schemaVersion": { "const": 1 },
"agent_id": { "type": "string", "minLength": 1, "description": "stable per agent for the run: slug(repo-branch-worktreehash[-slot])" },
"repo_path": { "type": "string", "minLength": 1, "description": "absolute worktree path" },
"repo": { "type": "string", "description": "basename, for column grouping" },
"branch": { "type": "string", "description": "advisory only; multiple agents may share it; never a mutex" },
"worktree": { "type": "string", "description": "worktree root (== repo_path unless a linked worktree)" },
"mode": { "type": ["string", "null"], "description": "supergoal mode (GREENFIELD|DEBUG|LEGACY|WAYFINDER|PROTOTYPE|...)" },
"phase": { "type": ["string", "null"], "enum": ["Frame", "Build", "Critic", "Fixer", "Verify", "Done", null], "description": "current loop position" },
"current_task": { "type": ["string", "null"] },
"started_at": { "type": "string", "description": "ISO-8601 UTC Z; agent registration time, immutable" },
"updated_at": { "type": "string", "description": "ISO-8601 UTC Z; bumped on every emit; the PRIMARY liveness clock" },
"pid": { "type": "integer", "description": "advisory only; readers use updated_at age as the primary liveness signal (Claude Code tool calls have no stable per-agent pid)" },
"host": { "type": "string" },
"note": { "type": ["string", "null"], "maxLength": 120 },
"tasks": {
"type": "array",
"description": "full board snapshot each emit; small list, re-serialized so the reader stays stateless",
"items": {
"type": "object",
"additionalProperties": false,
"required": ["id", "title", "status"],
"properties": {
"id": { "type": "string" },
"title": { "type": "string" },
"status": { "type": "string", "enum": ["backlog", "in-progress", "review", "done", "blocked"], "description": "Jira columns" }
}
}
}
}
}
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 472k | Updated | Claude CodeCodex | Verified | Install |
| 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: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| 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 available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |