Skip to content

hoatv2211/GameStudio-CodexKIT / skills/studio-goal-progress

studio-goal-progress

Verified

Use when a KIT-managed Codex or Hermes Goal needs evidence-backed percentage, ETA range, live read-only progress views, or portable append-only progress recovery.

schemas/studio-goal-state.schema.json

View on GitHub
{
  "$comment": "Generated by scripts/sync_skill_resources.py. Do not edit manually.",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://gamestudio-codexkit.local/schema/studio-goal-state.schema.json",
  "title": "GameStudio goal progress state",
  "type": "object",
  "additionalProperties": false,
  "required": [
    "schema_version",
    "goal_id",
    "plan_version",
    "manifest_hash",
    "goal_state",
    "packets",
    "progress",
    "eta",
    "revision_history",
    "context_facts",
    "latest_evidence",
    "next_action",
    "updated_at",
    "stale",
    "warnings"
  ],
  "properties": {
    "schema_version": {
      "const": 1
    },
    "goal_id": {
      "type": "string",
      "minLength": 1,
      "pattern": "\\S"
    },
    "plan_version": {
      "type": "integer",
      "minimum": 1
    },
    "manifest_hash": {
      "type": "string",
      "pattern": "^[a-f0-9]{64}$"
    },
    "goal_state": {
      "enum": [
        "planned",
        "running",
        "waiting_input",
        "blocked",
        "failed",
        "completed",
        "cancelled"
      ]
    },
    "packets": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/packet_state"
      }
    },
    "progress": {
      "$ref": "#/$defs/progress"
    },
    "eta": {
      "$ref": "#/$defs/eta"
    },
    "revision_history": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/revision_history_item"
      }
    },
    "context_facts": {
      "$ref": "#/$defs/context_facts"
    },
    "latest_evidence": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/evidence_record"
      }
    },
    "next_action": {
      "type": "string",
      "minLength": 1,
      "pattern": "\\S"
    },
    "updated_at": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}Z$"
    },
    "stale": {
      "type": "boolean"
    },
    "warnings": {
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "pattern": "\\S"
      }
    }
  },
  "allOf": [
    {
      "if": {
        "properties": {
          "goal_state": {
            "not": {
              "const": "completed"
            }
          }
        },
        "required": [
          "goal_state"
        ]
      },
      "then": {
        "properties": {
          "progress": {
            "properties": {
              "display_percent": {
                "maximum": 99
              }
            }
          }
        }
      }
    }
  ],
  "$defs": {
    "packet_state": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "id",
        "status",
        "owner",
        "objective",
        "progress_weight"
      ],
      "properties": {
        "id": {
          "type": "string",
          "minLength": 1,
          "pattern": "\\S"
        },
        "status": {
          "enum": [
            "queued",
            "running",
            "waiting_input",
            "blocked",
            "failed",
            "verified",
            "skipped"
          ]
        },
        "owner": {
          "type": "string",
          "minLength": 1,
          "pattern": "\\S"
        },
        "objective": {
          "type": "string",
          "minLength": 1,
          "pattern": "\\S"
        },
        "progress_weight": {
          "type": "integer",
          "minimum": 1
        }
      }
    },
    "progress": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "verified_weight",
        "active_planned_weight",
        "percent",
        "display_percent"
      ],
      "properties": {
        "verified_weight": {
          "type": "integer",
          "minimum": 0
        },
        "active_planned_weight": {
          "type": "integer",
          "minimum": 1
        },
        "percent": {
          "type": "number",
          "minimum": 0,
          "maximum": 100
        },
        "display_percent": {
          "type": "integer",
          "minimum": 0,
          "maximum": 100
        }
      }
    },
    "eta": {
      "oneOf": [
        {
          "type": "object",
          "additionalProperties": false,
          "required": [
            "status",
            "summary"
          ],
          "properties": {
            "status": {
              "const": "Calculating"
            },
            "summary": {
              "type": "string",
              "minLength": 1,
              "pattern": "\\S"
            }
          }
        },
        {
          "type": "object",
          "additionalProperties": false,
          "required": [
            "status",
            "summary",
            "low_seconds",
            "high_seconds",
            "calibration_factor",
            "confidence",
            "warnings"
          ],
          "properties": {
            "status": {
              "const": "Ready"
            },
            "summary": {
              "type": "string",
              "minLength": 1,
              "pattern": "\\S"
            },
            "low_seconds": {
              "type": "integer",
              "minimum": 0
            },
            "high_seconds": {
              "type": "integer",
              "minimum": 0
            },
            "calibration_factor": {
              "type": "number",
              "minimum": 0.5,
              "maximum": 3.0
            },
            "confidence": {
              "enum": [
                "low",
                "medium",
                "high"
              ]
            },
            "warnings": {
              "type": "array",
              "items": {
                "enum": [
                  "writer-epoch-gap",
                  "plan-revision-calibration-reset",
                  "plan-revision-unversioned-timing-discarded",
                  "plan-revision-mismatched-timing-discarded"
                ]
              }
            }
          }
        },
        {
          "type": "object",
          "additionalProperties": false,
          "required": [
            "status",
            "reason",
            "summary"
          ],
          "properties": {
            "status": {
              "const": "Paused"
            },
            "reason": {
              "enum": [
                "waiting_input",
                "blocked",
                "stale"
              ]
            },
            "summary": {
              "type": "string",
              "minLength": 1,
              "pattern": "\\S"
            }
          }
        },
        {
          "type": "object",
          "additionalProperties": false,
          "required": [
            "status",
            "reason",
            "summary"
          ],
          "properties": {
            "status": {
              "const": "BLOCKED"
            },
            "reason": {
              "const": "unsupported_parallel_timing"
            },
            "summary": {
              "type": "string",
              "minLength": 1,
              "pattern": "\\S"
            }
          }
        }
      ]
    },
    "revision_history_item": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "event_id",
        "sequence",
        "previous_plan_version",
        "plan_version",
        "revision_reason",
        "approval_ref",
        "previous_manifest_hash",
        "new_manifest_hash",
        "progress_recalculated",
        "eta_recalculated"
      ],
      "properties": {
        "event_id": {
          "type": "string",
          "minLength": 1,
          "pattern": "\\S"
        },
        "sequence": {
          "type": "integer",
          "minimum": 1
        },
        "previous_plan_version": {
          "type": "integer",
          "minimum": 1
        },
        "plan_version": {
          "type": "integer",
          "minimum": 2
        },
        "revision_reason": {
          "type": "string",
          "minLength": 1,
          "maxLength": 500,
          "pattern": "\\S"
        },
        "approval_ref": {
          "type": "string",
          "minLength": 1,
          "maxLength": 500,
          "pattern": "\\S"
        },
        "previous_manifest_hash": {
          "type": "string",
          "pattern": "^[a-f0-9]{64}$"
        },
        "new_manifest_hash": {
          "type": "string",
          "pattern": "^[a-f0-9]{64}$"
        },
        "progress_recalculated": {
          "const": true
        },
        "eta_recalculated": {
          "const": true
        }
      }
    },
    "bounded_context_text": {
      "type": "string",
      "minLength": 1,
      "maxLength": 500,
      "pattern": "\\S"
    },
    "bounded_context_text_list": {
      "type": "array",
      "maxItems": 20,
      "items": {
        "$ref": "#/$defs/bounded_context_text"
      }
    },
    "context_failure": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "summary"
      ],
      "properties": {
        "summary": {
          "$ref": "#/$defs/bounded_context_text"
        },
        "command": {
          "$ref": "#/$defs/bounded_context_text"
        },
        "artifact_path": {
          "$ref": "#/$defs/bounded_context_text"
        }
      }
    },
    "context_facts": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "blockers",
        "failures",
        "changed_files",
        "decisions",
        "commands",
        "timing",
        "evidence_labels",
        "indivisible_paths",
        "dependencies"
      ],
      "properties": {
        "blockers": {
          "$ref": "#/$defs/bounded_context_text_list"
        },
        "failures": {
          "type": "array",
          "maxItems": 20,
          "items": {
            "$ref": "#/$defs/context_failure"
          }
        },
        "changed_files": {
          "$ref": "#/$defs/bounded_context_text_list"
        },
        "decisions": {
          "$ref": "#/$defs/bounded_context_text_list"
        },
        "commands": {
          "$ref": "#/$defs/bounded_context_text_list"
        },
        "timing": {
          "$ref": "#/$defs/bounded_context_text_list"
        },
        "evidence_labels": {
          "type": "array",
          "maxItems": 20,
          "items": {
            "enum": [
              "Verified",
              "Snapshot",
              "Unverified",
              "BLOCKED"
            ]
          }
        },
        "indivisible_paths": {
          "$ref": "#/$defs/bounded_context_text_list"
        },
        "dependencies": {
          "$ref": "#/$defs/bounded_context_text_list"
        }
      }
    },
    "evidence_record": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "id",
        "label",
        "kind",
        "summary",
        "command",
        "exit_code",
        "artifact_path",
        "sha256"
      ],
      "properties": {
        "id": {
          "type": "string",
          "minLength": 1,
          "pattern": "\\S"
        },
        "label": {
          "enum": [
            "Verified",
            "Snapshot",
            "Unverified",
            "BLOCKED"
          ]
        },
        "kind": {
          "enum": [
            "command",
            "artifact"
          ]
        },
        "summary": {
          "type": "string",
          "minLength": 1,
          "pattern": "\\S"
        },
        "command": {
          "type": [
            "string",
            "null"
          ],
          "minLength": 1,
          "pattern": "\\S"
        },
        "exit_code": {
          "type": [
            "integer",
            "null"
          ]
        },
        "artifact_path": {
          "type": [
            "string",
            "null"
          ],
          "minLength": 1,
          "pattern": "\\S"
        },
        "sha256": {
          "type": [
            "string",
            "null"
          ],
          "pattern": "^[a-f0-9]{64}$"
        }
      },
      "allOf": [
        {
          "if": {
            "properties": {
              "kind": {
                "const": "command"
              }
            },
            "required": [
              "kind"
            ]
          },
          "then": {
            "properties": {
              "command": {
                "type": "string",
                "minLength": 1,
                "pattern": "\\S"
              },
              "exit_code": {
                "type": "integer"
              },
              "artifact_path": {
                "const": null
              },
              "sha256": {
                "const": null
              }
            }
          }
        },
        {
          "if": {
            "properties": {
              "kind": {
                "const": "artifact"
              }
            },
            "required": [
              "kind"
            ]
          },
          "then": {
            "properties": {
              "command": {
                "const": null
              },
              "exit_code": {
                "const": null
              },
              "artifact_path": {
                "type": "string",
                "minLength": 1,
                "pattern": "\\S"
              },
              "sha256": {
                "type": "string",
                "pattern": "^[a-f0-9]{64}$"
              }
            }
          }
        }
      ]
    }
  }
}
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