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

tests/test_generate_governance_startup.py

View on GitHub
import importlib.util
from pathlib import Path
import sys
from types import SimpleNamespace
import unittest


SCRIPT = Path(__file__).resolve().parents[1] / "scripts" / "generate_governance_artifact.py"


spec = importlib.util.spec_from_file_location("generate_governance_artifact", SCRIPT)
module = importlib.util.module_from_spec(spec)
assert spec and spec.loader
sys.modules[spec.name] = module
spec.loader.exec_module(module)


class TestStartupDeclarationValidation(unittest.TestCase):
    def test_render_markdown_does_not_emit_trailing_whitespace_for_empty_waiver(self) -> None:
        artifact = SimpleNamespace(
            task_id="TASK-1",
            schema_version=3,
            purpose="change",
            authorized_operations=[],
            release_metadata=None,
            created_at_utc="2026-07-18T00:00:00+00:00",
            project_id="agent-command-center",
            profile="internal",
            project_language="Markdown/Python",
            project_description_max4="Agent command center",
            model_runs_test_build_default="yes",
            execution_scope="local_only",
            deployment_requested=False,
            execution_skill="scripted-command-execution",
            uncertainty_high=False,
            requires_backup=False,
            requires_restore=False,
            quizme_mode="off",
            quizme_multiple_choice=False,
            quizme_one_at_a_time=False,
            quizme_confirm=False,
            quizme_record=False,
            selected_mode="quick",
            total_score=1,
            recommendation="no-go",
            scores={"data_impact": 0},
            critical_overrides=[],
            required_gates=["scripted-command-execution"],
            gate_status={
                "scripted-command-execution": {
                    "status": "pending",
                    "evidence": [],
                    "waiver_reason": "",
                }
            },
            startup_declaration={
                "skills_in_use": ["skill-governance", "scripted-command-execution"],
                "skills_selection_rationale": "Governed command execution.",
                "skills_execution_order": [
                    "skill-governance",
                    "scripted-command-execution",
                ],
            },
            evidence_requirements=[],
            break_glass={"enabled": False},
            notes="",
            change_binding={
                "base_sha": "a" * 40,
                "manifest_sha256": "b" * 64,
                "manifest": [],
            },
            catalog_binding={
                "path": "skills/skill-catalog.json",
                "sha256": "c" * 64,
                "catalog_version": "2.1.0",
                "router_contract": "2.1",
                "components": [],
                "skills": {},
            },
        )

        rendered = module.render_markdown(artifact)

        self.assertIn("  - waiver_reason:\n", rendered)
        self.assertEqual([], [line for line in rendered.splitlines() if line.rstrip() != line])
        self.assertFalse(rendered.endswith("\n"))
        self.assertFalse((rendered + "\n").endswith("\n\n"))

    def test_mode_gates_are_proportional_and_do_not_restore_v1_defaults(self) -> None:
        self.assertEqual(
            module.build_required_gates("quick", "scripted-command-execution", False),
            ["scripted-command-execution"],
        )
        self.assertEqual(
            module.build_required_gates("standard", "scripted-command-execution", False),
            ["scripted-command-execution", "regression-prevention"],
        )
        self.assertEqual(
            module.build_required_gates("critical", "scripted-command-execution", False),
            [
                "scripted-command-execution",
                "regression-prevention",
                "semantic-policy-audit",
                "governance-enforcement",
            ],
        )
        for mode in ("quick", "standard", "critical"):
            gates = module.build_required_gates(mode, "scripted-command-execution", False)
            self.assertNotIn("token-reduction", gates)
            self.assertNotIn("order-of-operations", gates)
            self.assertNotIn("project-backup", gates)
            self.assertNotIn("restore-drill", gates)

    def test_backup_and_restore_are_effect_gated_not_mode_gated(self) -> None:
        backup = module.build_required_gates(
            "critical",
            "scripted-command-execution",
            False,
            requires_backup=True,
        )
        restore = module.build_required_gates(
            "critical",
            "scripted-command-execution",
            False,
            requires_restore=True,
        )
        self.assertEqual(backup[-1:], ["project-backup"])
        self.assertEqual(restore[-2:], ["project-backup", "restore-drill"])
        self.assertEqual(
            module.build_evidence_requirements("quick", requires_restore=True)[-2:],
            ["backup artifact + integrity evidence", "restore freshness/pass status"],
        )

    def test_valid_startup_skills(self) -> None:
        module.validate_startup_declaration_skills(
            [
                "skill-governance",
                "order-of-operations",
                "scripted-command-execution",
                "doc-maintenance",
            ],
            [
                "skill-governance",
                "order-of-operations",
                "scripted-command-execution",
                "doc-maintenance",
            ],
            "scripted-command-execution",
        )

    def test_rejects_mismatched_sets(self) -> None:
        with self.assertRaises(SystemExit):
            module.validate_startup_declaration_skills(
                ["skill-governance", "order-of-operations"],
                ["skill-governance", "order-of-operations", "scripted-command-execution"],
                "scripted-command-execution",
            )

    def test_rejects_missing_required_governed_skill(self) -> None:
        with self.assertRaises(SystemExit):
            module.validate_startup_declaration_skills(
                ["order-of-operations", "doc-maintenance"],
                ["order-of-operations", "doc-maintenance"],
                "scripted-command-execution",
            )

    def test_order_of_operations_is_conditional_not_a_governance_baseline(self) -> None:
        module.validate_startup_declaration_skills(
            ["skill-governance", "scripted-command-execution"],
            ["skill-governance", "scripted-command-execution"],
            "scripted-command-execution",
        )

    def test_quizme_mode_requires_quizme_skill(self) -> None:
        with self.assertRaises(SystemExit):
            module.validate_startup_declaration_skills(
                [
                    "skill-governance",
                    "order-of-operations",
                    "scripted-command-execution",
                ],
                [
                    "skill-governance",
                    "order-of-operations",
                    "scripted-command-execution",
                ],
                "scripted-command-execution",
                "on",
            )

    def test_quizme_mode_accepts_quizme_skill(self) -> None:
        module.validate_startup_declaration_skills(
            [
                "quizme-mode",
                "skill-governance",
                "order-of-operations",
                "scripted-command-execution",
            ],
            [
                "quizme-mode",
                "skill-governance",
                "order-of-operations",
                "scripted-command-execution",
            ],
            "scripted-command-execution",
            "on",
        )

    def test_catalog_binding_rejects_missing_quizme_prerequisite(self) -> None:
        repo_root = Path(__file__).resolve().parents[3]
        with self.assertRaisesRegex(SystemExit, "missing prerequisites"):
            module.build_catalog_binding(
                repo_root / "skills" / "skill-catalog.json",
                ["skill-governance", "quizme-mode", "scripted-command-execution"],
                ["skill-governance", "quizme-mode", "scripted-command-execution"],
                repo_root=repo_root,
            )

    def test_quizme_mc_requires_active_mode(self) -> None:
        with self.assertRaises(SystemExit):
            module.validate_quizme_fields("off", True)

    def test_quizme_mc_accepts_active_mode(self) -> None:
        module.validate_quizme_fields("on", True)

    def test_each_quizme_option_requires_active_mode(self) -> None:
        option_sets = [
            (False, True, False, False),
            (False, False, True, False),
            (False, False, False, True),
        ]
        for options in option_sets:
            with self.subTest(options=options):
                with self.assertRaises(SystemExit):
                    module.validate_quizme_fields("off", *options)

    def test_combined_quizme_options_accept_active_mode(self) -> None:
        module.validate_quizme_fields("on", True, True, True, True)


if __name__ == "__main__":
    unittest.main()
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