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/task-descriptor.schema.json

View on GitHub
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://agent-command-center.local/schemas/task-descriptor.schema.json",
  "title": "Task Router v2 Descriptor",
  "description": "Normalized task intent consumed by the deterministic router contract. Version 2.0 remains accepted for compatibility; version 2.1 adds typed explicit-skill requests. Text is evidence only; routing decisions use typed action, effect, authority, and risk fields.",
  "type": "object",
  "additionalProperties": false,
  "required": [
    "schema_version",
    "task_id",
    "deliverables",
    "action",
    "mutation",
    "effects",
    "surfaces",
    "domains",
    "authority",
    "constraints",
    "inferred_requirements",
    "material_uncertainties",
    "evidence",
    "checkpoint"
  ],
  "properties": {
    "schema_version": {
      "enum": ["2.0", "2.1"]
    },
    "task_id": {
      "type": "string",
      "pattern": "^[a-zA-Z0-9][a-zA-Z0-9._-]{0,127}$"
    },
    "deliverables": {
      "type": "array",
      "minItems": 1,
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": ["id", "kind", "summary", "acceptance_criteria"],
        "properties": {
          "id": {
            "type": "string",
            "pattern": "^[a-zA-Z0-9][a-zA-Z0-9._-]{0,63}$"
          },
          "kind": {
            "enum": [
              "response",
              "file_change",
              "diagnosis",
              "review",
              "score",
              "test_change",
              "operation",
              "release"
            ]
          },
          "summary": {
            "type": "string",
            "minLength": 1,
            "maxLength": 500
          },
          "acceptance_criteria": {
            "type": "array",
            "minItems": 1,
            "items": {
              "type": "string",
              "minLength": 1,
              "maxLength": 500
            }
          }
        }
      }
    },
    "action": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "primary",
        "operations",
        "execution_mode",
        "command_effect",
        "test_intent",
        "behavior_change",
        "test_change",
        "coupled_change",
        "product_judgment",
        "ui_quality_judgment",
        "release_enforcement",
        "governance_tooling",
        "documentation_sync",
        "sequencing_required"
      ],
      "properties": {
        "primary": {
          "enum": [
            "answer",
            "inspect",
            "diagnose",
            "review",
            "score",
            "edit",
            "implement",
            "test",
            "operate",
            "release"
          ]
        },
        "operations": {
          "type": "array",
          "minItems": 1,
          "uniqueItems": true,
          "items": {
            "enum": [
              "read",
              "run_commands",
              "write_files",
              "commit",
              "configure_remote",
              "push",
              "publish",
              "deploy",
              "delete",
              "migrate",
              "message"
            ]
          }
        },
        "execution_mode": {
          "description": "How requested command or runtime execution should be routed. Incidental validation does not activate a workflow skill.",
          "enum": [
            "none",
            "incidental_validation",
            "deterministic_workflow",
            "adaptive_browser"
          ]
        },
        "command_effect": {
          "description": "Maximum state effect of requested command execution. Unknown fails closed.",
          "enum": [
            "not_applicable",
            "read_only",
            "workspace",
            "repository",
            "external",
            "unknown"
          ]
        },
        "test_intent": {
          "description": "Distinguishes running existing tests from designing or changing tests.",
          "enum": ["none", "run_existing", "design_or_change"]
        },
        "behavior_change": {
          "type": "boolean"
        },
        "test_change": {
          "type": "boolean"
        },
        "coupled_change": {
          "type": "boolean"
        },
        "product_judgment": {
          "type": "boolean"
        },
        "ui_quality_judgment": {
          "type": "boolean"
        },
        "release_enforcement": {
          "type": "boolean"
        },
        "governance_tooling": {
          "type": "boolean"
        },
        "documentation_sync": {
          "type": "boolean"
        },
        "sequencing_required": {
          "type": "boolean"
        },
        "research_intensity": {
          "description": "Evidence depth required before substantive work; advanced activates source-grounded R&D.",
          "enum": ["standard", "advanced"]
        },
        "help_requested": {
          "description": "True only for the exact Agent Command Center --help command.",
          "type": "boolean"
        },
        "approach_state": {
          "description": "Whether observable evidence still supports the current approach. Challenged or failed activates evidence-backed reassessment; routine first errors remain viable.",
          "enum": ["not_applicable", "viable", "challenged", "failed"]
        }
      }
    },
    "mutation": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "level",
        "targets",
        "destructive",
        "data_loss_risk",
        "recovery_requirement"
      ],
      "properties": {
        "level": {
          "enum": [
            "none",
            "workspace",
            "repository",
            "external",
            "irreversible",
            "unknown"
          ]
        },
        "targets": {
          "type": "array",
          "uniqueItems": true,
          "items": {
            "type": "string",
            "minLength": 1,
            "maxLength": 300
          }
        },
        "destructive": {
          "type": "boolean"
        },
        "data_loss_risk": {
          "description": "Credible loss exposure for the requested operation, independent of domain keywords.",
          "enum": ["none", "credible", "unknown"]
        },
        "recovery_requirement": {
          "description": "Whether execution requires a proven backup-and-restore path.",
          "enum": ["not_required", "required", "unknown"]
        }
      }
    },
    "effects": {
      "type": "array",
      "uniqueItems": true,
      "items": {
        "enum": [
          "workspace_files",
          "repository_history",
          "remote_repository",
          "published_artifact",
          "runtime_environment",
          "live_data",
          "external_message",
          "deletion",
          "user_visible_behavior",
          "test_suite",
          "documentation",
          "governance_policy",
          "unknown"
        ]
      }
    },
    "surfaces": {
      "type": "array",
      "minItems": 1,
      "uniqueItems": true,
      "items": {
        "enum": [
          "response",
          "source",
          "cli",
          "documentation",
          "tests",
          "frontend",
          "backend",
          "browser",
          "repository",
          "governance",
          "release",
          "runtime",
          "live_data",
          "external_service"
        ]
      }
    },
    "domains": {
      "type": "array",
      "minItems": 1,
      "uniqueItems": true,
      "items": {
        "enum": [
          "general",
          "code",
          "policy",
          "documentation",
          "testing",
          "frontend",
          "spatial_canvas",
          "vector_graphics",
          "auth",
          "migration",
          "release",
          "repository",
          "data",
          "operations"
        ]
      }
    },
    "authority": {
      "type": "object",
      "additionalProperties": false,
      "required": ["read"],
      "properties": {
        "read": {"$ref": "#/$defs/authorityStatus"},
        "run_commands": {"$ref": "#/$defs/authorityStatus"},
        "write_files": {"$ref": "#/$defs/authorityStatus"},
        "commit": {"$ref": "#/$defs/authorityStatus"},
        "configure_remote": {"$ref": "#/$defs/authorityStatus"},
        "push": {"$ref": "#/$defs/authorityStatus"},
        "publish": {"$ref": "#/$defs/authorityStatus"},
        "deploy": {"$ref": "#/$defs/authorityStatus"},
        "delete": {"$ref": "#/$defs/authorityStatus"},
        "migrate": {"$ref": "#/$defs/authorityStatus"},
        "message": {"$ref": "#/$defs/authorityStatus"}
      }
    },
    "constraints": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "read_only",
        "artifact_policy",
        "max_optional_skills",
        "explicit",
        "non_goals"
      ],
      "properties": {
        "read_only": {
          "type": "boolean"
        },
        "artifact_policy": {
          "enum": ["forbid", "allow_required", "allow"]
        },
        "max_optional_skills": {
          "type": "integer",
          "minimum": 0,
          "maximum": 20
        },
        "explicit_skills": {
          "description": "Canonical skill names explicitly requested by the user or an active conversation mode. Names are catalog-validated and never inferred from prompt keywords.",
          "type": "array",
          "uniqueItems": true,
          "items": {
            "type": "string",
            "pattern": "^[a-z0-9-]+$"
          }
        },
        "explicit": {
          "type": "array",
          "items": {
            "type": "string",
            "minLength": 1,
            "maxLength": 500
          }
        },
        "non_goals": {
          "type": "array",
          "items": {
            "type": "string",
            "minLength": 1,
            "maxLength": 500
          }
        }
      }
    },
    "inferred_requirements": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "id",
          "description",
          "provenance",
          "confidence",
          "material"
        ],
        "properties": {
          "id": {
            "type": "string",
            "pattern": "^[a-zA-Z0-9][a-zA-Z0-9._-]{0,63}$"
          },
          "description": {
            "type": "string",
            "minLength": 1,
            "maxLength": 500
          },
          "provenance": {
            "enum": [
              "repository_policy",
              "repository_convention",
              "task_context",
              "safety_invariant"
            ]
          },
          "confidence": {
            "enum": ["low", "medium", "high"]
          },
          "material": {
            "type": "boolean"
          }
        }
      }
    },
    "material_uncertainties": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": ["id", "description", "severity", "status"],
        "properties": {
          "id": {
            "type": "string",
            "pattern": "^[a-zA-Z0-9][a-zA-Z0-9._-]{0,63}$"
          },
          "description": {
            "type": "string",
            "minLength": 1,
            "maxLength": 500
          },
          "severity": {
            "enum": ["noncritical", "material", "critical"]
          },
          "status": {
            "enum": ["resolved", "unresolved", "conflicting"]
          }
        }
      }
    },
    "evidence": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "root_cause",
        "tests",
        "rollback",
        "backup",
        "restore",
        "exact_commit"
      ],
      "properties": {
        "root_cause": {"$ref": "#/$defs/evidenceStatus"},
        "tests": {"$ref": "#/$defs/evidenceStatus"},
        "rollback": {"$ref": "#/$defs/evidenceStatus"},
        "backup": {"$ref": "#/$defs/evidenceStatus"},
        "restore": {"$ref": "#/$defs/evidenceStatus"},
        "exact_commit": {"$ref": "#/$defs/evidenceStatus"},
        "artifacts": {
          "type": "array",
          "uniqueItems": true,
          "items": {"$ref": "#/$defs/artifactEvidence"}
        }
      }
    },
    "checkpoint": {
      "enum": [
        "initial",
        "post_inspection",
        "post_plan",
        "post_diff",
        "pre_external_action"
      ]
    }
  },
  "allOf": [
    {
      "if": {
        "required": ["schema_version"],
        "properties": {
          "schema_version": {"const": "2.1"}
        }
      },
      "then": {
        "properties": {
          "constraints": {
            "required": ["explicit_skills"]
          },
          "evidence": {
            "required": ["artifacts"]
          }
        }
      }
    }
  ],
  "$defs": {
    "authorityStatus": {
      "enum": ["granted", "denied", "unknown"]
    },
    "evidenceStatus": {
      "enum": [
        "not_applicable",
        "pending",
        "passed",
        "failed",
        "unknown"
      ]
    },
    "artifactEvidence": {
      "type": "object",
      "additionalProperties": false,
      "required": ["kind", "path", "sha256", "status"],
      "properties": {
        "kind": {"type": "string", "pattern": "^[a-z0-9][a-z0-9_-]{0,63}$"},
        "path": {"type": "string", "minLength": 1},
        "sha256": {"type": "string", "pattern": "^[0-9a-f]{64}$"},
        "status": {"enum": ["pending", "passed", "failed"]}
      }
    }
  }
}
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