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

fixtures/routing-scenarios.json

View on GitHub
{
  "schema_version": "2.1",
  "descriptor_defaults": {
    "schema_version": "2.1",
    "task_id": "scenario",
    "deliverables": [
      {
        "id": "result",
        "kind": "response",
        "summary": "Produce the requested scenario result.",
        "acceptance_criteria": [
          "Honor the normalized task descriptor."
        ]
      }
    ],
    "action": {
      "primary": "answer",
      "operations": [
        "read"
      ],
      "execution_mode": "none",
      "command_effect": "not_applicable",
      "test_intent": "none",
      "behavior_change": false,
      "test_change": false,
      "coupled_change": false,
      "product_judgment": false,
      "ui_quality_judgment": false,
      "release_enforcement": false,
      "governance_tooling": false,
      "documentation_sync": false,
      "sequencing_required": false,
      "research_intensity": "standard",
      "help_requested": false,
      "approach_state": "not_applicable"
    },
    "mutation": {
      "level": "none",
      "targets": [],
      "destructive": false,
      "data_loss_risk": "none",
      "recovery_requirement": "not_required"
    },
    "effects": [],
    "surfaces": [
      "response"
    ],
    "domains": [
      "general"
    ],
    "authority": {
      "read": "granted"
    },
    "constraints": {
      "read_only": true,
      "artifact_policy": "forbid",
      "max_optional_skills": 5,
      "explicit_skills": [],
      "explicit": [],
      "non_goals": []
    },
    "inferred_requirements": [],
    "material_uncertainties": [],
    "evidence": {
      "root_cause": "not_applicable",
      "tests": "not_applicable",
      "rollback": "not_applicable",
      "backup": "not_applicable",
      "restore": "not_applicable",
      "exact_commit": "not_applicable",
      "artifacts": []
    },
    "checkpoint": "initial"
  },
  "scenarios": [
    {
      "id": "simple-answer",
      "description": "A direct answer needs core invariants but no formal skill stack.",
      "descriptor": {
        "task_id": "simple-answer"
      },
      "expected": {
        "decision": "allow",
        "selected_skills": [],
        "artifact_allowed": false,
        "max_selected_skills": 0
      }
    },
    {
      "id": "tiny-typo",
      "description": "A tiny non-behavioral documentation typo is a granted local write without process expansion.",
      "descriptor": {
        "task_id": "tiny-typo",
        "deliverables": [
          {
            "id": "typo",
            "kind": "file_change",
            "summary": "Correct one documentation typo.",
            "acceptance_criteria": [
              "Only the typo changes."
            ]
          }
        ],
        "action": {
          "primary": "edit",
          "operations": [
            "read",
            "write_files"
          ]
        },
        "mutation": {
          "level": "workspace",
          "targets": [
            "documentation file"
          ]
        },
        "effects": [
          "workspace_files",
          "documentation"
        ],
        "surfaces": [
          "documentation"
        ],
        "domains": [
          "documentation"
        ],
        "authority": {
          "write_files": "granted"
        },
        "constraints": {
          "read_only": false,
          "explicit": [
            "Change only the typo."
          ],
          "non_goals": [
            "Do not reformat the document."
          ]
        }
      },
      "expected": {
        "decision": "allow",
        "selected_skills": [],
        "artifact_allowed": false,
        "max_selected_skills": 0
      }
    },
    {
      "id": "diagnose-only-cli",
      "description": "Read-only command diagnostics verify a cause without authorizing a fix.",
      "descriptor": {
        "task_id": "diagnose-only-cli",
        "deliverables": [
          {
            "id": "diagnosis",
            "kind": "diagnosis",
            "summary": "Identify the verified failure cause.",
            "acceptance_criteria": [
              "No corrective mutation occurs."
            ]
          }
        ],
        "action": {
          "primary": "diagnose",
          "operations": [
            "read",
            "run_commands"
          ],
          "execution_mode": "deterministic_workflow",
          "command_effect": "read_only"
        },
        "surfaces": [
          "cli",
          "source"
        ],
        "domains": [
          "code"
        ],
        "authority": {
          "run_commands": "granted"
        },
        "evidence": {
          "root_cause": "pending"
        }
      },
      "expected": {
        "decision": "allow",
        "selected_skills": [
          "diagnose-before-fix",
          "scripted-command-execution"
        ],
        "artifact_allowed": false,
        "max_selected_skills": 2
      }
    },
    {
      "id": "challenged-approach",
      "description": "Disconfirming evidence challenges an otherwise read-only approach and activates a focused reassessment.",
      "descriptor": {
        "task_id": "challenged-approach",
        "action": {
          "approach_state": "challenged"
        }
      },
      "expected": {
        "decision": "allow",
        "selected_skills": [
          "agent-humility"
        ],
        "artifact_allowed": false,
        "max_selected_skills": 1
      }
    },
    {
      "id": "failed-diagnostic-approach",
      "description": "A verified diagnostic path has failed and must be reassessed without granting corrective mutation.",
      "descriptor": {
        "task_id": "failed-diagnostic-approach",
        "deliverables": [
          {
            "id": "reassessment",
            "kind": "diagnosis",
            "summary": "Reassess the failed diagnostic approach.",
            "acceptance_criteria": [
              "Choose a discriminating next probe without mutating the target."
            ]
          }
        ],
        "action": {
          "primary": "diagnose",
          "approach_state": "failed"
        },
        "surfaces": [
          "source"
        ],
        "domains": [
          "code"
        ],
        "evidence": {
          "root_cause": "pending"
        }
      },
      "expected": {
        "decision": "allow",
        "selected_skills": [
          "diagnose-before-fix",
          "agent-humility"
        ],
        "artifact_allowed": false,
        "max_selected_skills": 2
      }
    },
    {
      "id": "cli-code-implementation",
      "description": "A behavioral CLI implementation selects regression and command owners but not test design.",
      "descriptor": {
        "task_id": "cli-code-implementation",
        "deliverables": [
          {
            "id": "implementation",
            "kind": "file_change",
            "summary": "Implement a CLI behavior change.",
            "acceptance_criteria": [
              "The changed CLI behavior is validated."
            ]
          }
        ],
        "action": {
          "primary": "implement",
          "operations": [
            "read",
            "run_commands",
            "write_files"
          ],
          "execution_mode": "deterministic_workflow",
          "command_effect": "workspace",
          "test_intent": "run_existing",
          "behavior_change": true
        },
        "mutation": {
          "level": "workspace",
          "targets": [
            "CLI source"
          ]
        },
        "effects": [
          "workspace_files",
          "user_visible_behavior"
        ],
        "surfaces": [
          "source",
          "cli"
        ],
        "domains": [
          "code"
        ],
        "authority": {
          "run_commands": "granted",
          "write_files": "granted"
        },
        "constraints": {
          "read_only": false,
          "artifact_policy": "allow_required"
        },
        "evidence": {
          "tests": "pending"
        }
      },
      "expected": {
        "decision": "allow",
        "selected_skills": [
          "regression-prevention",
          "scripted-command-execution"
        ],
        "artifact_allowed": true,
        "max_selected_skills": 2
      }
    },
    {
      "id": "cli-code-with-test-design",
      "description": "Explicit test changes add the test-design owner.",
      "descriptor": {
        "task_id": "cli-code-with-test-design",
        "deliverables": [
          {
            "id": "implementation",
            "kind": "file_change",
            "summary": "Implement CLI behavior and tests.",
            "acceptance_criteria": [
              "Code and targeted tests change together."
            ]
          }
        ],
        "action": {
          "primary": "implement",
          "operations": [
            "read",
            "run_commands",
            "write_files"
          ],
          "execution_mode": "deterministic_workflow",
          "command_effect": "workspace",
          "test_intent": "design_or_change",
          "behavior_change": true,
          "test_change": true
        },
        "mutation": {
          "level": "workspace",
          "targets": [
            "CLI source",
            "CLI tests"
          ]
        },
        "effects": [
          "workspace_files",
          "user_visible_behavior",
          "test_suite"
        ],
        "surfaces": [
          "source",
          "cli",
          "tests"
        ],
        "domains": [
          "code",
          "testing"
        ],
        "authority": {
          "run_commands": "granted",
          "write_files": "granted"
        },
        "constraints": {
          "read_only": false,
          "artifact_policy": "allow_required"
        },
        "evidence": {
          "tests": "pending"
        }
      },
      "expected": {
        "decision": "allow",
        "selected_skills": [
          "regression-prevention",
          "effective-testing-methods",
          "scripted-command-execution"
        ],
        "artifact_allowed": true,
        "max_selected_skills": 3
      }
    },
    {
      "id": "qualitative-code-review",
      "description": "A qualitative code review excludes the numerical rating skill.",
      "descriptor": {
        "task_id": "qualitative-code-review",
        "deliverables": [
          {
            "id": "review",
            "kind": "review",
            "summary": "Review code qualitatively.",
            "acceptance_criteria": [
              "Report evidence-backed findings without a score."
            ]
          }
        ],
        "action": {
          "primary": "review"
        },
        "surfaces": [
          "source"
        ],
        "domains": [
          "code"
        ]
      },
      "expected": {
        "decision": "allow",
        "selected_skills": [
          "regression-prevention"
        ],
        "artifact_allowed": false,
        "max_selected_skills": 1
      }
    },
    {
      "id": "scored-code-review",
      "description": "An explicit score selects the rating owner.",
      "descriptor": {
        "task_id": "scored-code-review",
        "deliverables": [
          {
            "id": "score",
            "kind": "score",
            "summary": "Score code quality with a rubric.",
            "acceptance_criteria": [
              "Provide a weighted numeric score."
            ]
          }
        ],
        "action": {
          "primary": "score"
        },
        "surfaces": [
          "source"
        ],
        "domains": [
          "code"
        ]
      },
      "expected": {
        "decision": "allow",
        "selected_skills": [
          "thoroughly-rate-review"
        ],
        "artifact_allowed": false,
        "max_selected_skills": 1
      }
    },
    {
      "id": "generic-ui-implementation",
      "description": "Generic frontend implementation excludes Spatial Canvas.",
      "descriptor": {
        "task_id": "generic-ui-implementation",
        "deliverables": [
          {
            "id": "ui",
            "kind": "file_change",
            "summary": "Implement a generic frontend interaction.",
            "acceptance_criteria": [
              "Behavior and tests cover the user flow."
            ]
          }
        ],
        "action": {
          "primary": "implement",
          "operations": [
            "read",
            "run_commands",
            "write_files"
          ],
          "execution_mode": "deterministic_workflow",
          "command_effect": "workspace",
          "test_intent": "design_or_change",
          "ui_quality_judgment": true,
          "behavior_change": true,
          "test_change": true
        },
        "mutation": {
          "level": "workspace",
          "targets": [
            "frontend source",
            "frontend tests"
          ]
        },
        "effects": [
          "workspace_files",
          "user_visible_behavior",
          "test_suite"
        ],
        "surfaces": [
          "source",
          "frontend",
          "tests"
        ],
        "domains": [
          "code",
          "frontend"
        ],
        "authority": {
          "run_commands": "granted",
          "write_files": "granted"
        },
        "constraints": {
          "read_only": false,
          "artifact_policy": "allow_required"
        },
        "evidence": {
          "tests": "pending"
        }
      },
      "expected": {
        "decision": "allow",
        "selected_skills": [
          "ui-design-skills",
          "regression-prevention",
          "effective-testing-methods",
          "scripted-command-execution",
          "ui-dynamic-resizing"
        ],
        "artifact_allowed": true,
        "max_selected_skills": 5
      }
    },
    {
      "id": "spatial-canvas-implementation",
      "description": "An explicit normalized Spatial Canvas domain adds its specialist.",
      "descriptor": {
        "task_id": "spatial-canvas-implementation",
        "deliverables": [
          {
            "id": "spatial-ui",
            "kind": "file_change",
            "summary": "Implement an established Spatial Canvas flow.",
            "acceptance_criteria": [
              "Preserve the Spatial Canvas interaction model."
            ]
          }
        ],
        "action": {
          "primary": "implement",
          "operations": [
            "read",
            "run_commands",
            "write_files"
          ],
          "execution_mode": "deterministic_workflow",
          "command_effect": "workspace",
          "test_intent": "design_or_change",
          "ui_quality_judgment": true,
          "behavior_change": true,
          "test_change": true
        },
        "mutation": {
          "level": "workspace",
          "targets": [
            "spatial frontend",
            "frontend tests"
          ]
        },
        "effects": [
          "workspace_files",
          "user_visible_behavior",
          "test_suite"
        ],
        "surfaces": [
          "source",
          "frontend",
          "tests"
        ],
        "domains": [
          "code",
          "frontend",
          "spatial_canvas"
        ],
        "authority": {
          "run_commands": "granted",
          "write_files": "granted"
        },
        "constraints": {
          "read_only": false,
          "artifact_policy": "allow_required"
        },
        "evidence": {
          "tests": "pending"
        }
      },
      "expected": {
        "decision": "allow",
        "selected_skills": [
          "ui-design-skills",
          "ui-spatial-canvas",
          "regression-prevention",
          "effective-testing-methods",
          "scripted-command-execution",
          "ui-dynamic-resizing"
        ],
        "artifact_allowed": true,
        "max_selected_skills": 6
      }
    },
    {
      "id": "auth-source-change",
      "description": "Auth source code is regression-sensitive but does not imply live backup operations.",
      "descriptor": {
        "task_id": "auth-source-change",
        "deliverables": [
          {
            "id": "auth-code",
            "kind": "file_change",
            "summary": "Change an auth source-code path locally.",
            "acceptance_criteria": [
              "No live auth state is modified."
            ]
          }
        ],
        "action": {
          "primary": "implement",
          "operations": [
            "read",
            "run_commands",
            "write_files"
          ],
          "execution_mode": "deterministic_workflow",
          "command_effect": "workspace",
          "test_intent": "run_existing",
          "behavior_change": true
        },
        "mutation": {
          "level": "workspace",
          "targets": [
            "auth source"
          ]
        },
        "effects": [
          "workspace_files",
          "user_visible_behavior"
        ],
        "surfaces": [
          "source",
          "backend"
        ],
        "domains": [
          "code",
          "auth"
        ],
        "authority": {
          "run_commands": "granted",
          "write_files": "granted"
        },
        "constraints": {
          "read_only": false,
          "artifact_policy": "allow_required",
          "non_goals": [
            "Do not touch live sessions."
          ]
        },
        "evidence": {
          "tests": "pending"
        }
      },
      "expected": {
        "decision": "allow",
        "selected_skills": [
          "regression-prevention",
          "scripted-command-execution"
        ],
        "artifact_allowed": true,
        "max_selected_skills": 2
      }
    },
    {
      "id": "auth-live-operation",
      "description": "A live auth deployment activates governance, recovery, and rollback controls.",
      "descriptor": {
        "task_id": "auth-live-operation",
        "deliverables": [
          {
            "id": "auth-operation",
            "kind": "operation",
            "summary": "Apply an authorized auth runtime operation.",
            "acceptance_criteria": [
              "Rollback evidence is current before deployment."
            ]
          }
        ],
        "action": {
          "primary": "operate",
          "operations": [
            "read",
            "run_commands",
            "deploy"
          ],
          "execution_mode": "deterministic_workflow",
          "command_effect": "external",
          "test_intent": "run_existing"
        },
        "mutation": {
          "level": "external",
          "targets": [
            "auth runtime"
          ]
        },
        "effects": [
          "runtime_environment"
        ],
        "surfaces": [
          "cli",
          "runtime",
          "external_service"
        ],
        "domains": [
          "auth",
          "operations"
        ],
        "authority": {
          "run_commands": "granted",
          "deploy": "granted"
        },
        "constraints": {
          "read_only": false
        },
        "evidence": {
          "tests": "passed",
          "rollback": "passed",
          "backup": "passed",
          "restore": "passed",
          "artifacts": [
            {
              "kind": "governance_plan",
              "path": "skills/skill-governance/fixtures/passed-artifact-evidence.json",
              "sha256": "11e32c3d91c1e2a71518c7cf6f355449032fa1986eb82c0422e336ce890d6146",
              "status": "passed"
            }
          ]
        },
        "checkpoint": "pre_external_action"
      },
      "expected": {
        "decision": "allow",
        "artifact_allowed": false,
        "max_selected_skills": 8
      }
    },
    {
      "id": "migration-source-only",
      "description": "Source-only migration preparation excludes operational recovery gates.",
      "descriptor": {
        "task_id": "migration-source-only",
        "deliverables": [
          {
            "id": "migration-source",
            "kind": "file_change",
            "summary": "Prepare migration source and tests without applying it.",
            "acceptance_criteria": [
              "No live data changes."
            ]
          }
        ],
        "action": {
          "primary": "implement",
          "operations": [
            "read",
            "run_commands",
            "write_files"
          ],
          "execution_mode": "deterministic_workflow",
          "command_effect": "workspace",
          "test_intent": "design_or_change",
          "behavior_change": true,
          "test_change": true,
          "coupled_change": true
        },
        "mutation": {
          "level": "workspace",
          "targets": [
            "migration source",
            "migration tests"
          ]
        },
        "effects": [
          "workspace_files",
          "test_suite"
        ],
        "surfaces": [
          "source",
          "backend",
          "tests"
        ],
        "domains": [
          "code",
          "migration",
          "data",
          "testing"
        ],
        "authority": {
          "run_commands": "granted",
          "write_files": "granted"
        },
        "constraints": {
          "read_only": false,
          "artifact_policy": "allow_required"
        },
        "evidence": {
          "tests": "pending"
        }
      },
      "expected": {
        "decision": "allow",
        "selected_skills": [
          "interdependent-change-planning",
          "regression-prevention",
          "effective-testing-methods",
          "scripted-command-execution"
        ],
        "artifact_allowed": true,
        "max_selected_skills": 4
      }
    },
    {
      "id": "migration-apply",
      "description": "Applying a live migration requires authority, pre-action reroute, backup, restore, and rollback evidence.",
      "descriptor": {
        "task_id": "migration-apply",
        "deliverables": [
          {
            "id": "migration-operation",
            "kind": "operation",
            "summary": "Apply the approved live-data migration.",
            "acceptance_criteria": [
              "Backup, restore, and rollback gates pass first."
            ]
          }
        ],
        "action": {
          "primary": "operate",
          "operations": [
            "read",
            "run_commands",
            "migrate"
          ],
          "execution_mode": "deterministic_workflow",
          "command_effect": "external"
        },
        "mutation": {
          "level": "irreversible",
          "targets": [
            "production data"
          ],
          "destructive": true,
          "data_loss_risk": "credible",
          "recovery_requirement": "required"
        },
        "effects": [
          "live_data"
        ],
        "surfaces": [
          "cli",
          "live_data",
          "external_service"
        ],
        "domains": [
          "migration",
          "data",
          "operations"
        ],
        "authority": {
          "run_commands": "granted",
          "migrate": "granted"
        },
        "constraints": {
          "read_only": false
        },
        "evidence": {
          "rollback": "passed",
          "backup": "passed",
          "restore": "passed",
          "artifacts": [
            {
              "kind": "governance_plan",
              "path": "skills/skill-governance/fixtures/passed-artifact-evidence.json",
              "sha256": "11e32c3d91c1e2a71518c7cf6f355449032fa1986eb82c0422e336ce890d6146",
              "status": "passed"
            },
            {
              "kind": "backup_evidence",
              "path": "skills/skill-governance/fixtures/passed-artifact-evidence.json",
              "sha256": "11e32c3d91c1e2a71518c7cf6f355449032fa1986eb82c0422e336ce890d6146",
              "status": "passed"
            },
            {
              "kind": "restore_evidence",
              "path": "skills/skill-governance/fixtures/passed-artifact-evidence.json",
              "sha256": "11e32c3d91c1e2a71518c7cf6f355449032fa1986eb82c0422e336ce890d6146",
              "status": "passed"
            }
          ]
        },
        "checkpoint": "pre_external_action"
      },
      "expected": {
        "decision": "allow",
        "selected_skills": [
          "skill-governance",
          "regression-prevention",
          "project-backup",
          "restore-drill",
          "scripted-command-execution"
        ],
        "artifact_allowed": false,
        "max_selected_skills": 5
      }
    },
    {
      "id": "strict-read-only-policy-audit",
      "description": "A strict policy audit can run read-only commands but cannot create artifacts.",
      "descriptor": {
        "task_id": "strict-read-only-policy-audit",
        "deliverables": [
          {
            "id": "audit",
            "kind": "review",
            "summary": "Audit semantic policy behavior without mutation.",
            "acceptance_criteria": [
              "No files, trackers, or governance artifacts are written."
            ]
          }
        ],
        "action": {
          "primary": "inspect",
          "operations": [
            "read",
            "run_commands"
          ],
          "execution_mode": "incidental_validation",
          "command_effect": "read_only"
        },
        "surfaces": [
          "response",
          "governance"
        ],
        "domains": [
          "policy"
        ],
        "authority": {
          "run_commands": "granted"
        },
        "constraints": {
          "explicit": [
            "Remain strictly read-only."
          ],
          "non_goals": [
            "Do not generate governance artifacts."
          ]
        }
      },
      "expected": {
        "decision": "allow",
        "selected_skills": [
          "semantic-policy-audit"
        ],
        "artifact_allowed": false,
        "max_selected_skills": 2
      }
    },
    {
      "id": "ambiguous-login-request",
      "description": "Unknown mutation intent and critical ambiguity fail closed before auth work.",
      "descriptor": {
        "task_id": "ambiguous-login-request",
        "deliverables": [
          {
            "id": "login-request",
            "kind": "operation",
            "summary": "Handle a login-related request whose intended state effect is unknown.",
            "acceptance_criteria": [
              "Clarify whether source code or live state is in scope."
            ]
          }
        ],
        "action": {
          "primary": "operate"
        },
        "mutation": {
          "level": "unknown"
        },
        "surfaces": [
          "response",
          "external_service"
        ],
        "domains": [
          "auth"
        ],
        "constraints": {
          "read_only": false
        },
        "material_uncertainties": [
          {
            "id": "login-scope",
            "description": "It is unclear whether the request changes source code or live account state.",
            "severity": "critical",
            "status": "unresolved"
          }
        ]
      },
      "expected": {
        "decision": "needs_clarification",
        "selected_skills": [
          "requirement-clarifier",
          "eliminate-assumptions"
        ],
        "artifact_allowed": false,
        "max_selected_skills": 2
      }
    },
    {
      "id": "multi-deliverable-commit-no-push",
      "description": "Files, tests, and a local commit are authorized while push remains excluded.",
      "descriptor": {
        "task_id": "multi-deliverable-commit-no-push",
        "deliverables": [
          {
            "id": "code",
            "kind": "file_change",
            "summary": "Implement the coupled code change.",
            "acceptance_criteria": [
              "Implementation is complete."
            ]
          },
          {
            "id": "tests",
            "kind": "test_change",
            "summary": "Add proportional regression tests.",
            "acceptance_criteria": [
              "Tests pass."
            ]
          },
          {
            "id": "commit",
            "kind": "operation",
            "summary": "Create a local commit only.",
            "acceptance_criteria": [
              "No push occurs."
            ]
          }
        ],
        "action": {
          "primary": "implement",
          "operations": [
            "read",
            "run_commands",
            "write_files",
            "commit"
          ],
          "execution_mode": "deterministic_workflow",
          "command_effect": "repository",
          "test_intent": "design_or_change",
          "behavior_change": true,
          "test_change": true,
          "coupled_change": true
        },
        "mutation": {
          "level": "repository",
          "targets": [
            "source",
            "tests",
            "local repository history"
          ]
        },
        "effects": [
          "workspace_files",
          "repository_history",
          "user_visible_behavior",
          "test_suite"
        ],
        "surfaces": [
          "source",
          "tests",
          "repository"
        ],
        "domains": [
          "code",
          "testing",
          "repository"
        ],
        "authority": {
          "run_commands": "granted",
          "write_files": "granted",
          "commit": "granted",
          "push": "denied"
        },
        "constraints": {
          "read_only": false,
          "artifact_policy": "allow_required",
          "explicit": [
            "Commit locally after validation."
          ],
          "non_goals": [
            "Do not push."
          ]
        },
        "evidence": {
          "tests": "passed"
        },
        "checkpoint": "post_diff"
      },
      "expected": {
        "decision": "allow",
        "selected_skills": [
          "interdependent-change-planning",
          "regression-prevention",
          "effective-testing-methods",
          "scripted-command-execution"
        ],
        "artifact_allowed": true,
        "max_selected_skills": 4
      }
    },
    {
      "id": "release-ready",
      "description": "A release is allowed only with exact-commit and test evidence at the pre-external checkpoint.",
      "descriptor": {
        "task_id": "release-ready",
        "deliverables": [
          {
            "id": "release",
            "kind": "release",
            "summary": "Publish the verified release.",
            "acceptance_criteria": [
              "The exact published commit has green evidence."
            ]
          }
        ],
        "action": {
          "primary": "release",
          "operations": [
            "read",
            "run_commands",
            "publish"
          ],
          "execution_mode": "deterministic_workflow",
          "command_effect": "external",
          "test_intent": "run_existing",
          "release_enforcement": true
        },
        "mutation": {
          "level": "external",
          "targets": [
            "release registry",
            "release attestation"
          ]
        },
        "effects": [
          "published_artifact"
        ],
        "surfaces": [
          "cli",
          "repository",
          "release"
        ],
        "domains": [
          "release",
          "repository"
        ],
        "authority": {
          "run_commands": "granted",
          "publish": "granted"
        },
        "constraints": {
          "read_only": false
        },
        "evidence": {
          "tests": "passed",
          "exact_commit": "passed",
          "artifacts": [
            {
              "kind": "governance_plan",
              "path": "skills/skill-governance/fixtures/passed-artifact-evidence.json",
              "sha256": "11e32c3d91c1e2a71518c7cf6f355449032fa1986eb82c0422e336ce890d6146",
              "status": "passed"
            },
            {
              "kind": "release_attestation",
              "path": "skills/skill-governance/fixtures/passed-artifact-evidence.json",
              "sha256": "11e32c3d91c1e2a71518c7cf6f355449032fa1986eb82c0422e336ce890d6146",
              "status": "passed"
            }
          ]
        },
        "checkpoint": "pre_external_action"
      },
      "expected": {
        "decision": "allow",
        "selected_skills": [
          "skill-governance",
          "governance-enforcement",
          "regression-prevention",
          "scripted-command-execution"
        ],
        "artifact_allowed": false,
        "max_selected_skills": 4
      }
    },
    {
      "id": "release-missing-exact-commit",
      "description": "Publication is blocked when exact-commit evidence is missing.",
      "descriptor": {
        "task_id": "release-missing-exact-commit",
        "deliverables": [
          {
            "id": "release",
            "kind": "release",
            "summary": "Publish a release lacking exact-commit evidence.",
            "acceptance_criteria": [
              "Publication must not proceed without evidence."
            ]
          }
        ],
        "action": {
          "primary": "release",
          "operations": [
            "read",
            "run_commands",
            "publish"
          ],
          "execution_mode": "deterministic_workflow",
          "command_effect": "external",
          "test_intent": "run_existing",
          "release_enforcement": true
        },
        "mutation": {
          "level": "external",
          "targets": [
            "release registry"
          ]
        },
        "effects": [
          "published_artifact"
        ],
        "surfaces": [
          "cli",
          "release"
        ],
        "domains": [
          "release"
        ],
        "authority": {
          "run_commands": "granted",
          "publish": "granted"
        },
        "constraints": {
          "read_only": false
        },
        "evidence": {
          "tests": "passed",
          "exact_commit": "unknown",
          "artifacts": [
            {
              "kind": "governance_plan",
              "path": "skills/skill-governance/fixtures/passed-artifact-evidence.json",
              "sha256": "11e32c3d91c1e2a71518c7cf6f355449032fa1986eb82c0422e336ce890d6146",
              "status": "passed"
            },
            {
              "kind": "release_attestation",
              "path": "skills/skill-governance/fixtures/passed-artifact-evidence.json",
              "sha256": "11e32c3d91c1e2a71518c7cf6f355449032fa1986eb82c0422e336ce890d6146",
              "status": "passed"
            }
          ]
        },
        "checkpoint": "pre_external_action"
      },
      "expected": {
        "decision": "blocked",
        "artifact_allowed": false,
        "max_selected_skills": 4
      }
    },
    {
      "id": "read-only-conflict",
      "description": "Granted write authority cannot override an explicit read-only constraint.",
      "descriptor": {
        "task_id": "read-only-conflict",
        "action": {
          "primary": "inspect",
          "operations": [
            "read",
            "write_files"
          ]
        },
        "mutation": {
          "level": "workspace",
          "targets": [
            "audit notes"
          ]
        },
        "effects": [
          "workspace_files"
        ],
        "surfaces": [
          "source"
        ],
        "domains": [
          "code"
        ],
        "authority": {
          "write_files": "granted"
        }
      },
      "expected": {
        "decision": "blocked",
        "selected_skills": [],
        "artifact_allowed": false,
        "max_selected_skills": 0
      }
    },
    {
      "id": "quick-answer-paraphrase",
      "description": "The word quick does not alter a typed direct-answer route.",
      "descriptor": {
        "task_id": "quick-answer-paraphrase",
        "constraints": {
          "explicit": [
            "Keep the answer quick."
          ]
        }
      },
      "expected": {
        "decision": "allow",
        "selected_skills": [],
        "artifact_allowed": false,
        "max_selected_skills": 0,
        "same_route_as": "simple-answer"
      }
    },
    {
      "id": "just-answer-paraphrase",
      "description": "The word just does not alter a typed direct-answer route.",
      "descriptor": {
        "task_id": "just-answer-paraphrase",
        "constraints": {
          "explicit": [
            "Just answer the question."
          ]
        }
      },
      "expected": {
        "decision": "allow",
        "selected_skills": [],
        "artifact_allowed": false,
        "max_selected_skills": 0,
        "same_route_as": "simple-answer"
      }
    },
    {
      "id": "simple-answer-paraphrase",
      "description": "The word simple does not alter a typed direct-answer route.",
      "descriptor": {
        "task_id": "simple-answer-paraphrase",
        "constraints": {
          "explicit": [
            "This should be simple."
          ]
        }
      },
      "expected": {
        "decision": "allow",
        "selected_skills": [],
        "artifact_allowed": false,
        "max_selected_skills": 0,
        "same_route_as": "simple-answer"
      }
    },
    {
      "id": "migration-zero-optional-budget",
      "description": "A zero optional-skill budget cannot suppress mandatory migration safety.",
      "descriptor": {
        "task_id": "migration-zero-optional-budget",
        "deliverables": [
          {
            "id": "migration-operation",
            "kind": "operation",
            "summary": "Apply a migration with no optional-skill budget.",
            "acceptance_criteria": [
              "All mandatory safety remains active."
            ]
          }
        ],
        "action": {
          "primary": "operate",
          "operations": [
            "read",
            "run_commands",
            "migrate"
          ],
          "execution_mode": "deterministic_workflow",
          "command_effect": "external"
        },
        "mutation": {
          "level": "irreversible",
          "targets": [
            "production data"
          ],
          "destructive": true,
          "data_loss_risk": "credible",
          "recovery_requirement": "required"
        },
        "effects": [
          "live_data"
        ],
        "surfaces": [
          "cli",
          "live_data"
        ],
        "domains": [
          "migration",
          "data",
          "operations"
        ],
        "authority": {
          "run_commands": "granted",
          "migrate": "granted"
        },
        "constraints": {
          "read_only": false,
          "max_optional_skills": 0
        },
        "evidence": {
          "rollback": "passed",
          "backup": "passed",
          "restore": "passed",
          "artifacts": [
            {
              "kind": "governance_plan",
              "path": "skills/skill-governance/fixtures/passed-artifact-evidence.json",
              "sha256": "11e32c3d91c1e2a71518c7cf6f355449032fa1986eb82c0422e336ce890d6146",
              "status": "passed"
            },
            {
              "kind": "backup_evidence",
              "path": "skills/skill-governance/fixtures/passed-artifact-evidence.json",
              "sha256": "11e32c3d91c1e2a71518c7cf6f355449032fa1986eb82c0422e336ce890d6146",
              "status": "passed"
            },
            {
              "kind": "restore_evidence",
              "path": "skills/skill-governance/fixtures/passed-artifact-evidence.json",
              "sha256": "11e32c3d91c1e2a71518c7cf6f355449032fa1986eb82c0422e336ce890d6146",
              "status": "passed"
            }
          ]
        },
        "checkpoint": "pre_external_action"
      },
      "expected": {
        "decision": "allow",
        "selected_skills": [
          "skill-governance",
          "regression-prevention",
          "project-backup",
          "restore-drill",
          "scripted-command-execution"
        ],
        "artifact_allowed": false,
        "max_selected_skills": 5
      }
    },
    {
      "id": "remote-branch-protection-authorized",
      "description": "Remote repository configuration has exact authority without granting Git push.",
      "descriptor": {
        "task_id": "remote-branch-protection-authorized",
        "deliverables": [
          {
            "id": "branch-protection",
            "kind": "operation",
            "summary": "Configure the approved protected-branch policy.",
            "acceptance_criteria": [
              "Only the approved remote settings change."
            ]
          }
        ],
        "action": {
          "primary": "operate",
          "operations": [
            "read",
            "run_commands",
            "configure_remote"
          ],
          "execution_mode": "deterministic_workflow",
          "command_effect": "external"
        },
        "mutation": {
          "level": "external",
          "targets": [
            "main branch protection"
          ]
        },
        "effects": [
          "remote_repository",
          "governance_policy"
        ],
        "surfaces": [
          "repository",
          "governance",
          "external_service"
        ],
        "domains": [
          "repository",
          "policy",
          "operations"
        ],
        "authority": {
          "run_commands": "granted",
          "configure_remote": "granted",
          "push": "denied"
        },
        "constraints": {
          "read_only": false,
          "explicit": [
            "Do not push or change unrelated repository settings."
          ]
        },
        "evidence": {
          "rollback": "passed",
          "artifacts": [
            {
              "kind": "governance_plan",
              "path": "skills/skill-governance/fixtures/passed-artifact-evidence.json",
              "sha256": "11e32c3d91c1e2a71518c7cf6f355449032fa1986eb82c0422e336ce890d6146",
              "status": "passed"
            }
          ]
        },
        "checkpoint": "pre_external_action"
      },
      "expected": {
        "decision": "allow",
        "selected_skills": [
          "skill-governance",
          "scripted-command-execution"
        ],
        "artifact_allowed": false,
        "max_selected_skills": 2
      }
    },
    {
      "id": "external-message-authorized",
      "description": "External communication requires explicit authority and a pre-action reroute.",
      "descriptor": {
        "task_id": "external-message-authorized",
        "deliverables": [
          {
            "id": "message",
            "kind": "operation",
            "summary": "Send one explicitly authorized external message.",
            "acceptance_criteria": [
              "Only the approved message is sent."
            ]
          }
        ],
        "action": {
          "primary": "operate",
          "operations": [
            "read",
            "message"
          ]
        },
        "mutation": {
          "level": "external",
          "targets": [
            "approved recipient"
          ]
        },
        "effects": [
          "external_message"
        ],
        "surfaces": [
          "external_service"
        ],
        "domains": [
          "operations"
        ],
        "authority": {
          "message": "granted"
        },
        "constraints": {
          "read_only": false,
          "explicit": [
            "Send only the approved content."
          ]
        },
        "checkpoint": "pre_external_action"
      },
      "expected": {
        "decision": "allow",
        "selected_skills": [],
        "artifact_allowed": false,
        "max_selected_skills": 0
      }
    },
    {
      "id": "external-message-authority-unknown",
      "description": "Unknown message authority fails closed even when the requested content is harmless.",
      "descriptor": {
        "task_id": "external-message-authority-unknown",
        "deliverables": [
          {
            "id": "message",
            "kind": "operation",
            "summary": "Send an external message without known authority.",
            "acceptance_criteria": [
              "Do not send without explicit authority."
            ]
          }
        ],
        "action": {
          "primary": "operate",
          "operations": [
            "read",
            "message"
          ]
        },
        "mutation": {
          "level": "external",
          "targets": [
            "recipient"
          ]
        },
        "effects": [
          "external_message"
        ],
        "surfaces": [
          "external_service"
        ],
        "domains": [
          "operations"
        ],
        "authority": {
          "message": "unknown"
        },
        "constraints": {
          "read_only": false
        },
        "checkpoint": "pre_external_action"
      },
      "expected": {
        "decision": "needs_clarification",
        "selected_skills": [],
        "artifact_allowed": false,
        "max_selected_skills": 0
      }
    }
  ]
}
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 CodeCodexUnverifiedInstall
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