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_project_index_integrity.py

View on GitHub
from pathlib import Path
import sys
import tempfile
from types import SimpleNamespace
import unittest


SCRIPTS = Path(__file__).resolve().parents[1] / "scripts"
if str(SCRIPTS) not in sys.path:
    sys.path.insert(0, str(SCRIPTS))

import generate_governance_artifact as generator  # noqa: E402
import validate_skill_policy as policy  # noqa: E402


VALID_HEADER = (
    "# Project Index\n\n"
    "| Project ID | Language | Description (<=4 words) | "
    "Model Runs Tests/Build by Default (yes/no) | Last Confirmed UTC |\n"
    "|---|---|---|---|---|\n"
)


class TestProjectIndexIntegrity(unittest.TestCase):
    def write_index(self, root: Path, body: str) -> Path:
        path = root / "project-index.md"
        path.write_text(body, encoding="utf-8")
        return path

    def assert_invalid(self, content: str, message: str) -> None:
        with tempfile.TemporaryDirectory() as raw:
            path = self.write_index(Path(raw), content)
            with self.assertRaisesRegex(generator.ProjectIndexValidationError, message):
                generator.validate_project_index(path)

    def test_valid_write_and_parse_round_trip(self) -> None:
        entries = {
            "agent-command-center": {
                "language": "Markdown/Python",
                "description": "Agent command center",
                "model_default_test_build": "yes",
                "last_confirmed_utc": "2026-07-18T02:20:37.146744Z",
            },
            "rust-tool": {
                "language": "Rust",
                "description": "Fast local tool",
                "model_default_test_build": "no",
                "last_confirmed_utc": "2026-07-18T03:00:00+00:00",
            },
        }
        with tempfile.TemporaryDirectory() as raw:
            path = Path(raw) / "project-index.md"
            generator.write_project_index(path, entries)

            self.assertEqual(generator.validate_project_index(path), entries)
            self.assertEqual(policy.validate_project_index_policy(path), [])

            generator.sync_project_index(
                path,
                SimpleNamespace(
                    project_id="rust-tool",
                    project_language="Rust 2",
                    project_description_max4="Updated local tool",
                    model_runs_test_build_default="yes",
                    created_at_utc="2026-07-18T04:00:00+00:00",
                ),
            )
            updated = generator.validate_project_index(path)
            self.assertEqual(updated["agent-command-center"], entries["agent-command-center"])
            self.assertEqual(
                updated["rust-tool"],
                {
                    "language": "Rust 2",
                    "description": "Updated local tool",
                    "model_default_test_build": "yes",
                    "last_confirmed_utc": "2026-07-18T04:00:00Z",
                },
            )

    def test_missing_or_malformed_preamble_fails_closed(self) -> None:
        cases = {
            "wrong heading": VALID_HEADER.replace("# Project Index", "# Projects", 1),
            "wrong header": VALID_HEADER.replace("Project ID", "Project", 1),
            "wrong separator": VALID_HEADER.replace("|---|---|---|---|---|", "| --- | --- | --- | --- | --- |", 1),
        }
        for name, content in cases.items():
            with self.subTest(name=name):
                self.assert_invalid(content, "exact (heading|table header|table separator)")

    def test_duplicate_project_ids_are_rejected(self) -> None:
        row = "| duplicate-id | Python | Duplicate project | yes | 2026-07-18T00:00:00Z |\n"
        self.assert_invalid(VALID_HEADER + row + row, "duplicates project ID")

    def test_invalid_utc_timestamps_are_rejected(self) -> None:
        timestamps = (
            "2026-02-30T00:00:00Z",
            "2026-07-18T00:00:00",
            "2026-07-18T01:00:00+01:00",
        )
        for timestamp in timestamps:
            with self.subTest(timestamp=timestamp):
                self.assert_invalid(
                    VALID_HEADER
                    + f"| test-project | Python | Test project | yes | {timestamp} |\n",
                    "valid timezone-aware UTC timestamp",
                )

    def test_description_over_four_words_is_rejected(self) -> None:
        self.assert_invalid(
            VALID_HEADER
            + "| test-project | Python | This description has five words | yes | 2026-07-18T00:00:00Z |\n",
            "maximum is 4",
        )

    def test_field_and_row_shape_errors_are_rejected(self) -> None:
        cases = {
            "invalid ID": "| Invalid-ID | Python | Test project | yes | 2026-07-18T00:00:00Z |\n",
            "empty language": "| test-project |  | Test project | yes | 2026-07-18T00:00:00Z |\n",
            "invalid flag": "| test-project | Python | Test project | true | 2026-07-18T00:00:00Z |\n",
            "six cells": "| test-project | Python | Test project | yes | extra | 2026-07-18T00:00:00Z |\n",
            "non-table": "This content must not be ignored.\n",
        }
        for name, row in cases.items():
            with self.subTest(name=name):
                self.assert_invalid(VALID_HEADER + row, ".+")

    def test_policy_validator_reports_project_index_errors(self) -> None:
        with tempfile.TemporaryDirectory() as raw:
            path = self.write_index(
                Path(raw),
                VALID_HEADER
                + "| bad-project | Python | Too many description words here | maybe | not-a-time |\n",
            )

            errors = policy.validate_project_index_policy(path)

            self.assertGreaterEqual(len(errors), 3)
            self.assertTrue(all(error.startswith("project index: ") for error in errors))

    def test_sync_rejects_malformed_index_without_clobbering_it(self) -> None:
        malformed = VALID_HEADER + "This content must not be ignored.\n"
        artifact = SimpleNamespace(
            project_id="test-project",
            project_language="Python",
            project_description_max4="Test project",
            model_runs_test_build_default="yes",
            created_at_utc="2026-07-18T00:00:00+00:00",
        )
        with tempfile.TemporaryDirectory() as raw:
            path = self.write_index(Path(raw), malformed)

            with self.assertRaisesRegex(SystemExit, "non-table content"):
                generator.sync_project_index(path, artifact)

            self.assertEqual(path.read_text(encoding="utf-8"), malformed)


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