Skip to content

matt-bat/got-skills / skills/skill-governance

skill-governance

Verified

Govern release-affecting, policy-changing, externally mutating, destructive, or otherwise high-risk work through typed effects, mandatory evidence, independent safety gates, and an explicit go/no-go decision. Do not use for ordinary answers, read-only inspection, tiny reversible edits, or a task made "multi-skill" only by optional process helpers.

FileKindSize
SKILL.mdskill md9.7 KB
fixtures/passed-artifact-evidence.jsonconfig104 B
fixtures/routing-scenarios.jsonconfig44.2 KB
references/governance-artifacts.mdmarkdown5.1 KB
references/risk-and-gates.mdmarkdown4.6 KB
requirements.txtmanifest89 B
schemas/governance-artifact.schema.jsonconfig13.6 KB
schemas/remote-configuration-policy.schema.jsonconfig4.3 KB
schemas/routing-result.schema.jsonconfig7.7 KB
schemas/task-descriptor.schema.jsonconfig13.3 KB
scripts/enforce_governance_ci.pyscript24.4 KB
scripts/generate_governance_artifact.pyscript43.4 KB
scripts/generate_routing_views.pyscript27.6 KB
scripts/governance_common.pyscript14.5 KB
scripts/record_routing_observation.pyscript9.3 KB
scripts/resolve_task_route.pyscript69.4 KB
scripts/validate_governance_artifact.pyscript39.9 KB
scripts/validate_skill_order_sync.pyscript4.0 KB
scripts/validate_skill_policy.pyscript32.3 KB
scripts/verify_remote_configuration.pyscript12.3 KB
tests/test_advanced_svg_render.pyscript5.1 KB
tests/test_conflict_matrix_integrity.pyscript2.1 KB
tests/test_default_skill_quality_gates.pyscript2.9 KB
tests/test_docs_website_navigation.pyscript2.7 KB
tests/test_enforce_governance_scope.pyscript1.7 KB
tests/test_generate_governance_startup.pyscript9.0 KB
tests/test_generate_routing_views.pyscript12.8 KB
tests/test_governance_history_and_pair_integrity.pyscript10.6 KB
tests/test_governance_integrity.pyscript55.7 KB
tests/test_new_skill_integration.pyscript8.3 KB
tests/test_project_index_integrity.pyscript6.4 KB
tests/test_remote_configuration.pyscript5.6 KB
tests/test_routing_observation.pyscript4.3 KB
tests/test_runtime_adapter.pyscript9.2 KB
tests/test_task_routing.pyscript47.5 KB
tests/test_validate_skill_order_sync.pyscript2.4 KB
tests/test_validate_skill_policy_smoke.pyscript869 B

schemas/routing-result.schema.json

View on GitHub
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://agent-command-center.local/schemas/routing-result.schema.json",
  "title": "Task Router v2 Result",
  "description": "Routing result contract. Frozen 2.0 results remain valid without configure_remote; 2.1 results require the complete current permission namespace.",
  "type": "object",
  "additionalProperties": false,
  "required": [
    "schema_version",
    "task_id",
    "checkpoint",
    "decision",
    "selected_skills",
    "decision_domain_owners",
    "typed_gates",
    "permissions",
    "artifact_allowance",
    "must_surface",
    "vetoes",
    "excluded_routes",
    "route_trace",
    "skill_budget"
  ],
  "properties": {
    "schema_version": {
      "enum": ["2.0", "2.1"]
    },
    "task_id": {
      "type": "string",
      "minLength": 1
    },
    "checkpoint": {
      "enum": [
        "initial",
        "post_inspection",
        "post_plan",
        "post_diff",
        "pre_external_action"
      ]
    },
    "decision": {
      "enum": ["allow", "needs_clarification", "blocked"]
    },
    "selected_skills": {
      "type": "array",
      "uniqueItems": true,
      "items": {
        "type": "string",
        "pattern": "^[a-z0-9][a-z0-9-]{0,63}$"
      }
    },
    "decision_domain_owners": {
      "type": "object",
      "minProperties": 2,
      "required": ["routing", "safety"],
      "propertyNames": {
        "pattern": "^[a-z][a-z0-9_]{0,63}$"
      },
      "additionalProperties": {
        "type": "string",
        "minLength": 1,
        "maxLength": 100
      }
    },
    "typed_gates": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": false,
                "required": [
                    "id",
                    "policy_gate_id",
                    "type",
          "operation",
          "status",
          "mandatory",
          "owner",
          "reason"
        ],
        "properties": {
                    "id": {
            "type": "string",
            "pattern": "^[a-z0-9][a-z0-9._-]{0,127}$"
                    },
                    "policy_gate_id": {
                        "type": "string",
                        "pattern": "^[a-z][a-z0-9_]{0,63}$"
                    },
          "type": {
            "enum": [
              "safety_boundary",
              "authorization",
              "descriptor_consistency",
              "uncertainty",
              "checkpoint",
              "evidence",
              "quality"
            ]
          },
          "operation": {
            "type": ["string", "null"]
          },
          "status": {
            "enum": ["passed", "required", "needs_resolution", "blocked"]
          },
          "mandatory": {
            "type": "boolean"
          },
          "owner": {
            "type": "string",
            "minLength": 1
          },
          "reason": {
            "type": "string",
            "minLength": 1
          }
        }
      }
    },
    "permissions": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "read",
        "run_commands",
        "write_files",
        "commit",
        "push",
        "publish",
        "deploy",
        "delete",
        "migrate",
        "message"
      ],
      "properties": {
        "read": {"type": "boolean"},
        "run_commands": {"type": "boolean"},
        "write_files": {"type": "boolean"},
        "commit": {"type": "boolean"},
        "configure_remote": {"type": "boolean"},
        "push": {"type": "boolean"},
        "publish": {"type": "boolean"},
        "deploy": {"type": "boolean"},
        "delete": {"type": "boolean"},
        "migrate": {"type": "boolean"},
        "message": {"type": "boolean"}
      }
    },
    "artifact_allowance": {
      "type": "object",
      "additionalProperties": false,
      "required": ["allowed", "kinds", "reason"],
      "properties": {
        "allowed": {"type": "boolean"},
        "kinds": {
          "type": "array",
          "uniqueItems": true,
          "items": {
            "type": "string",
            "pattern": "^[a-z][a-z0-9_]{0,63}$"
          }
        },
        "reason": {
          "type": "string",
          "minLength": 1
        }
      }
    },
    "must_surface": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": ["id", "source", "text"],
        "properties": {
          "id": {
            "type": "string",
            "pattern": "^[a-z0-9][a-z0-9._-]{0,127}$"
          },
          "source": {
            "enum": [
              "explicit_constraint",
              "non_goal",
              "inferred_requirement",
              "material_uncertainty",
              "safety_kernel"
            ]
          },
          "text": {
            "type": "string",
            "minLength": 1
          }
        }
      }
    },
    "vetoes": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": ["code", "operation", "disposition", "reason"],
        "properties": {
          "code": {
            "type": "string",
            "pattern": "^[a-z][a-z0-9_]{0,127}$"
          },
          "operation": {
            "type": ["string", "null"]
          },
          "disposition": {
            "enum": ["block", "clarify"]
          },
          "reason": {
            "type": "string",
            "minLength": 1
          }
        }
      }
    },
    "excluded_routes": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": ["route", "reason"],
        "properties": {
          "route": {
            "type": "string",
            "minLength": 1
          },
          "reason": {
            "type": "string",
            "minLength": 1
          }
        }
      }
    },
    "route_trace": {
      "type": "array",
      "minItems": 4,
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": ["stage", "outcome", "evidence"],
        "properties": {
          "stage": {
            "enum": [
              "descriptor",
              "intent_routing",
              "safety_kernel",
                            "skill_budget",
              "result"
            ]
          },
          "outcome": {
            "type": "string",
            "minLength": 1
          },
          "evidence": {
            "type": "array",
            "items": {
              "type": "string",
              "minLength": 1
            }
          }
        }
      }
    },
    "skill_budget": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "max_optional_skills",
        "optional_before_budget",
        "optional_after_budget",
        "mandatory_skills",
        "mandatory_safety_exempt"
      ],
      "properties": {
        "max_optional_skills": {
          "type": "integer",
          "minimum": 0
        },
        "optional_before_budget": {
          "type": "integer",
          "minimum": 0
        },
        "optional_after_budget": {
          "type": "integer",
          "minimum": 0
        },
        "mandatory_skills": {
          "type": "array",
          "uniqueItems": true,
          "items": {
            "type": "string",
            "pattern": "^[a-z0-9][a-z0-9-]{0,63}$"
          }
        },
        "mandatory_safety_exempt": {
          "const": true
        }
      }
    }
  },
  "allOf": [
    {
      "if": {
        "required": ["schema_version"],
        "properties": {
          "schema_version": {"const": "2.1"}
        }
      },
      "then": {
        "properties": {
          "permissions": {
            "required": ["configure_remote"]
          }
        }
      }
    }
  ]
}
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: 472kUpdated 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