{
  "version": 1,
  "repository": "Knuckles-Team/universal-skills",
  "revision": "3681cc1b846429b2e45037dbe99fb5cf1c36e34b",
  "captured_at": "2026-11-06T04:17:03.840460+00:00",
  "records": [
    {
      "id": "US-CONTENT",
      "kind": "spec",
      "parent": null,
      "source": "specs/catalog-content/status.json",
      "title": "US-CONTENT \u2014 The catalog is served by the SDK content convention",
      "delivery_state": "SPECIFIED",
      "state": "specified",
      "done": false,
      "landed_in": [],
      "verified_by": [],
      "document": "specs/catalog-content/spec.md",
      "component": "Skill catalog",
      "code_refs": [
        {
          "declared_in": "specs/catalog-content/plan.md",
          "evidence": "file exists; coverage not verified",
          "label": "contracts/content-convention.md",
          "repository": "Knuckles-Team/universal-skills",
          "role": "documentation",
          "url": "https://github.com/Knuckles-Team/universal-skills/blob/3681cc1b846429b2e45037dbe99fb5cf1c36e34b/specs/catalog-content/contracts/content-convention.md"
        },
        {
          "declared_in": "specs/catalog-content/plan.md",
          "evidence": "file exists; coverage not verified",
          "label": "contracts/delivery-skill.md",
          "repository": "Knuckles-Team/universal-skills",
          "role": "documentation",
          "url": "https://github.com/Knuckles-Team/universal-skills/blob/3681cc1b846429b2e45037dbe99fb5cf1c36e34b/specs/catalog-content/contracts/delivery-skill.md"
        },
        {
          "declared_in": "specs/catalog-content/plan.md",
          "evidence": "file exists; coverage not verified",
          "label": "requirements.md",
          "repository": "Knuckles-Team/universal-skills",
          "role": "documentation",
          "url": "https://github.com/Knuckles-Team/universal-skills/blob/3681cc1b846429b2e45037dbe99fb5cf1c36e34b/specs/catalog-content/requirements.md"
        },
        {
          "declared_in": "specs/catalog-content/plan.md",
          "evidence": "file exists; coverage not verified",
          "label": "spec.md",
          "repository": "Knuckles-Team/universal-skills",
          "role": "documentation",
          "url": "https://github.com/Knuckles-Team/universal-skills/blob/3681cc1b846429b2e45037dbe99fb5cf1c36e34b/specs/catalog-content/spec.md"
        },
        {
          "declared_in": "specs/catalog-content/spec.md",
          "evidence": "file exists; coverage not verified",
          "label": "../../pyproject.toml",
          "repository": "Knuckles-Team/universal-skills",
          "role": "implementation",
          "url": "https://github.com/Knuckles-Team/universal-skills/blob/3681cc1b846429b2e45037dbe99fb5cf1c36e34b/pyproject.toml"
        },
        {
          "declared_in": "specs/catalog-content/spec.md",
          "evidence": "file exists; coverage not verified",
          "label": "../../scripts/sync_upstream_skills.py",
          "repository": "Knuckles-Team/universal-skills",
          "role": "implementation",
          "url": "https://github.com/Knuckles-Team/universal-skills/blob/3681cc1b846429b2e45037dbe99fb5cf1c36e34b/scripts/sync_upstream_skills.py"
        },
        {
          "declared_in": "specs/catalog-content/spec.md",
          "evidence": "file exists; coverage not verified",
          "label": "../../tests/test_catalog_content.py",
          "repository": "Knuckles-Team/universal-skills",
          "role": "test",
          "url": "https://github.com/Knuckles-Team/universal-skills/blob/3681cc1b846429b2e45037dbe99fb5cf1c36e34b/tests/test_catalog_content.py"
        }
      ],
      "relations": [
        {
          "declared_in": "specs/catalog-content/spec.md",
          "evidence": "missing source",
          "kind": "depends on",
          "label": "SCION-CONNECTOR-CONTROL-R071.1",
          "repository": "Unresolved",
          "url": ""
        },
        {
          "declared_in": "specs/catalog-content/spec.md",
          "evidence": "unresolved",
          "kind": "references",
          "label": "SCION-CONNECTOR-CONTROL",
          "repository": "Unresolved",
          "url": ""
        }
      ],
      "plan_diagrams": [],
      "unparsed_references": []
    },
    {
      "id": "US-CONTENT-R001",
      "kind": "requirement",
      "parent": "US-CONTENT",
      "source": "specs/catalog-content/status.json",
      "title": "`universal_skills` is served as a content-only connector",
      "delivery_state": "SPECIFIED",
      "state": "specified",
      "done": false,
      "landed_in": [],
      "verified_by": [],
      "parent_title": "US-CONTENT \u2014 The catalog is served by the SDK content convention",
      "definition": "**`universal_skills` is served as a content-only connector.** The package declares exactly one entry point, `agent_connector_sdk.connector = \"universal_skills\"`, and no provider entry-point group. Children `.1` to `.3` deliver it. | See each child.",
      "definition_source": "specs/catalog-content/requirements.md",
      "definition_line": 7
    },
    {
      "id": "US-CONTENT-R001.1",
      "kind": "requirement",
      "parent": "US-CONTENT",
      "source": "specs/catalog-content/status.json",
      "title": "`pyproject.toml` declares `[project.entry-points.\"agent_connector_sdk.connector\"]` with the single value `universal_skills` (bare package, content only), depends on `agent-connector-sdk[mcp]>=0.5.0,<0.6.0`, and declares no `agent_utilities.skill_providers` or other provider group. The SDK pytest plugin supplies the conformance checks, so the repository holds no copy of them. Caller chain: arbora resolves the installed distribution \u2192 the `agent_connector_sdk.connector` entry point of `pyproject.toml`. Shape: one entry-point table in `pyproject.toml`; the SDK pytest plugin supplies the checks. Proving test: `tests/test_catalog_content.py::test_declares_one_content_only_entry_point`",
      "delivery_state": "VERIFIED",
      "state": "verified",
      "done": true,
      "landed_in": [
        "b7adccaaf777",
        "d487973cc5cf"
      ],
      "verified_by": [
        "tests/test_catalog_content.py:22",
        "tests/test_skill_pack_frontmatter.py:65",
        "tests/test_skill_pack_frontmatter.py:70",
        "tests/test_skill_pack_frontmatter.py:76"
      ],
      "parent_title": "US-CONTENT \u2014 The catalog is served by the SDK content convention",
      "definition": "`pyproject.toml` declares `[project.entry-points.\"agent_connector_sdk.connector\"]` with the single value `universal_skills` (bare package, content only), depends on `agent-connector-sdk[mcp]>=0.5.0,<0.6.0`, and declares no `agent_utilities.skill_providers` or other provider group. The SDK pytest plugin supplies the conformance checks, so the repository holds no copy of them. Caller chain: arbora resolves the installed distribution \u2192 the `agent_connector_sdk.connector` entry point of `pyproject.toml`. Shape: one entry-point table in `pyproject.toml`; the SDK pytest plugin supplies the checks. Proving test: `tests/test_catalog_content.py::test_declares_one_content_only_entry_point`. | The test reads `pyproject.toml` and finds one entry point of the group, the bare package, the SDK floor and cap, and no provider group.",
      "definition_source": "specs/catalog-content/requirements.md",
      "definition_line": 8
    },
    {
      "id": "US-CONTENT-R001.2",
      "kind": "requirement",
      "parent": "US-CONTENT",
      "source": "specs/catalog-content/status.json",
      "title": "Every skill lives at `universal_skills/skills/<name>/SKILL.md`, one level deep, and its frontmatter `name` equals its folder name. Supporting files stay inside the skill folder so they are served with it. Caller chain: the SDK content convention \u2192 `universal_skills/skills/<name>/SKILL.md`. Shape: flat skill folders; the test reuses `tests/test_catalog_content.py` helpers. Proving test: `tests/test_catalog_content.py::test_every_skill_is_flat_and_named_by_folder`",
      "delivery_state": "SPECIFIED",
      "state": "specified",
      "done": false,
      "landed_in": [],
      "verified_by": [
        "tests/test_catalog_content.py:33"
      ],
      "parent_title": "US-CONTENT \u2014 The catalog is served by the SDK content convention",
      "definition": "Every skill lives at `universal_skills/skills/<name>/SKILL.md`, one level deep, and its frontmatter `name` equals its folder name. Supporting files stay inside the skill folder so they are served with it. Caller chain: the SDK content convention \u2192 `universal_skills/skills/<name>/SKILL.md`. Shape: flat skill folders; the test reuses `tests/test_catalog_content.py` helpers. Proving test: `tests/test_catalog_content.py::test_every_skill_is_flat_and_named_by_folder`. | The test finds no `SKILL.md` outside `skills/<name>/` (other than bundled assets) and no name that differs from its folder.",
      "definition_source": "specs/catalog-content/requirements.md",
      "definition_line": 9
    },
    {
      "id": "US-CONTENT-R001.3",
      "kind": "requirement",
      "parent": "US-CONTENT",
      "source": "specs/catalog-content/status.json",
      "title": "The server the SDK builds for `universal_skills` lists one `skill://<name>/SKILL.md` resource for every skill folder. Caller chain: arbora \u2192 the SDK server factory \u2192 the skills directory provider \u2192 each skill folder. Shape: no server code in this package; the test builds the SDK server in process. Proving test: `tests/test_catalog_content.py::test_server_lists_every_skill`",
      "delivery_state": "SPECIFIED",
      "state": "specified",
      "done": false,
      "landed_in": [],
      "verified_by": [
        "tests/test_catalog_content.py:43"
      ],
      "parent_title": "US-CONTENT \u2014 The catalog is served by the SDK content convention",
      "definition": "The server the SDK builds for `universal_skills` lists one `skill://<name>/SKILL.md` resource for every skill folder. Caller chain: arbora \u2192 the SDK server factory \u2192 the skills directory provider \u2192 each skill folder. Shape: no server code in this package; the test builds the SDK server in process. Proving test: `tests/test_catalog_content.py::test_server_lists_every_skill`. | The test builds the server in process and compares the listed skill names with the folders.",
      "definition_source": "specs/catalog-content/requirements.md",
      "definition_line": 10
    },
    {
      "id": "US-CONTENT-R002",
      "kind": "requirement",
      "parent": "US-CONTENT",
      "source": "specs/catalog-content/status.json",
      "title": "Skills can be vendored from pinned upstream repositories and kept current",
      "delivery_state": "VERIFIED",
      "state": "verified",
      "done": true,
      "landed_in": [
        "87b5fd589e52"
      ],
      "verified_by": [
        "tests/test_upstream_sources.py:105",
        "tests/test_upstream_sources.py:115",
        "tests/test_upstream_sources.py:129",
        "tests/test_upstream_sources.py:162",
        "tests/test_upstream_sources.py:236"
      ],
      "parent_title": "US-CONTENT \u2014 The catalog is served by the SDK content convention",
      "definition": "**Skills can be vendored from pinned upstream repositories and kept current.** The repository holds `upstream-sources.toml` and `scripts/sync_upstream_skills.py`. Children `.1` to `.10` deliver it. | See each child.",
      "definition_source": "specs/catalog-content/requirements.md",
      "definition_line": 11
    },
    {
      "id": "US-CONTENT-R002.1",
      "kind": "requirement",
      "parent": "US-CONTENT",
      "source": "specs/catalog-content/status.json",
      "title": "`upstream-sources.toml` lists each source with its repository URL, a pinned commit, path globs, the skills it produces, the license and a transform (`skill-md` or `command-md`). The loader rejects a manifest that omits one of them, that names a skill whose path matches no glob, or that has a duplicate source or skill. Caller chain: `scripts/sync_upstream_skills.py` \u2192 its manifest loader \u2192 `upstream-sources.toml`. Shape: one loader function in `scripts/sync_upstream_skills.py` that validates each source table. Proving test: `tests/test_upstream_sources.py::test_manifest_rejects_incomplete_sources`",
      "delivery_state": "VERIFIED",
      "state": "verified",
      "done": true,
      "landed_in": [
        "87b5fd589e52"
      ],
      "verified_by": [
        "tests/test_upstream_sources.py:86"
      ],
      "parent_title": "US-CONTENT \u2014 The catalog is served by the SDK content convention",
      "definition": "`upstream-sources.toml` lists each source with its repository URL, a pinned commit, path globs, the skills it produces, the license and a transform (`skill-md` or `command-md`). The loader rejects a manifest that omits one of them, that names a skill whose path matches no glob, or that has a duplicate source or skill. Caller chain: `scripts/sync_upstream_skills.py` \u2192 its manifest loader \u2192 `upstream-sources.toml`. Shape: one loader function in `scripts/sync_upstream_skills.py` that validates each source table. Proving test: `tests/test_upstream_sources.py::test_manifest_rejects_incomplete_sources`. | The test loads the real manifest and a set of broken manifests and finds the loader accepts the first and rejects each of the others.",
      "definition_source": "specs/catalog-content/requirements.md",
      "definition_line": 12
    },
    {
      "id": "US-CONTENT-R002.2",
      "kind": "requirement",
      "parent": "US-CONTENT",
      "source": "specs/catalog-content/status.json",
      "title": "A pin is a full 40-character commit SHA. A branch, tag or short SHA is rejected. `--update` is the only way a pin moves. Caller chain: `scripts/sync_upstream_skills.py` \u2192 the manifest loader \u2192 the pin check. Shape: a pin check in the loader of `scripts/sync_upstream_skills.py`. Proving test: `tests/test_upstream_sources.py::test_pin_must_be_full_commit_sha`",
      "delivery_state": "VERIFIED",
      "state": "verified",
      "done": true,
      "landed_in": [
        "87b5fd589e52"
      ],
      "verified_by": [
        "tests/test_upstream_sources.py:105"
      ],
      "parent_title": "US-CONTENT \u2014 The catalog is served by the SDK content convention",
      "definition": "A pin is a full 40-character commit SHA. A branch, tag or short SHA is rejected. `--update` is the only way a pin moves. Caller chain: `scripts/sync_upstream_skills.py` \u2192 the manifest loader \u2192 the pin check. Shape: a pin check in the loader of `scripts/sync_upstream_skills.py`. Proving test: `tests/test_upstream_sources.py::test_pin_must_be_full_commit_sha`. | The test loads manifests with a branch name, a tag and a short SHA and finds each rejected.",
      "definition_source": "specs/catalog-content/requirements.md",
      "definition_line": 13
    },
    {
      "id": "US-CONTENT-R002.3",
      "kind": "requirement",
      "parent": "US-CONTENT",
      "source": "specs/catalog-content/status.json",
      "title": "Each vendored skill keeps the upstream license text in `LICENSE` and names the license in its provenance file. A source without a license or license path is rejected. Caller chain: `scripts/sync_upstream_skills.py` \u2192 the license copy step \u2192 the skill folder. Shape: the license copy in `scripts/sync_upstream_skills.py`, reusing the snapshot reader. Proving test: `tests/test_upstream_sources.py::test_license_is_required_and_kept`",
      "delivery_state": "VERIFIED",
      "state": "verified",
      "done": true,
      "landed_in": [
        "87b5fd589e52"
      ],
      "verified_by": [
        "tests/test_upstream_sources.py:115"
      ],
      "parent_title": "US-CONTENT \u2014 The catalog is served by the SDK content convention",
      "definition": "Each vendored skill keeps the upstream license text in `LICENSE` and names the license in its provenance file. A source without a license or license path is rejected. Caller chain: `scripts/sync_upstream_skills.py` \u2192 the license copy step \u2192 the skill folder. Shape: the license copy in `scripts/sync_upstream_skills.py`, reusing the snapshot reader. Proving test: `tests/test_upstream_sources.py::test_license_is_required_and_kept`. | The test finds the loader rejecting a source with no license and each real vendored skill holding the upstream license text.",
      "definition_source": "specs/catalog-content/requirements.md",
      "definition_line": 14
    },
    {
      "id": "US-CONTENT-R002.4",
      "kind": "requirement",
      "parent": "US-CONTENT",
      "source": "specs/catalog-content/status.json",
      "title": "The `skill-md` transform copies a skill folder as it is and sets only `metadata.version` from this package. The `command-md` transform converts a command prompt into a `SKILL.md` with `name`, `description` and the package version, resolves the script and command placeholders, and drops the upstream handoff and script keys. Both produce identical bytes on every run. Caller chain: `scripts/sync_upstream_skills.py` \u2192 the transform named by the source \u2192 the rendered `SKILL.md`. Shape: two transform functions in `scripts/sync_upstream_skills.py`. Proving test: `tests/test_upstream_sources.py::test_transforms_are_deterministic`",
      "delivery_state": "VERIFIED",
      "state": "verified",
      "done": true,
      "landed_in": [
        "87b5fd589e52"
      ],
      "verified_by": [
        "tests/test_upstream_sources.py:129"
      ],
      "parent_title": "US-CONTENT \u2014 The catalog is served by the SDK content convention",
      "definition": "The `skill-md` transform copies a skill folder as it is and sets only `metadata.version` from this package. The `command-md` transform converts a command prompt into a `SKILL.md` with `name`, `description` and the package version, resolves the script and command placeholders, and drops the upstream handoff and script keys. Both produce identical bytes on every run. Caller chain: `scripts/sync_upstream_skills.py` \u2192 the transform named by the source \u2192 the rendered `SKILL.md`. Shape: two transform functions in `scripts/sync_upstream_skills.py`. Proving test: `tests/test_upstream_sources.py::test_transforms_are_deterministic`. | The test renders each transform twice from one input and finds identical bytes and the expected frontmatter.",
      "definition_source": "specs/catalog-content/requirements.md",
      "definition_line": 15
    },
    {
      "id": "US-CONTENT-R002.5",
      "kind": "requirement",
      "parent": "US-CONTENT",
      "source": "specs/catalog-content/status.json",
      "title": "Overlays in `universal_skills/overlays/<skill>/*.md` merge into the rendered skill in file-name order with the modes `append`, `prepend`, `replace`, `insert-after` and `file`. A `replace` or `insert-after` whose match does not hit exactly one line fails. Caller chain: `scripts/sync_upstream_skills.py` \u2192 the overlay merge after the render \u2192 `universal_skills/overlays/<skill>/*.md`. Shape: one merge function in `scripts/sync_upstream_skills.py`. Proving test: `tests/test_upstream_sources.py::test_overlay_merge_is_ordered_and_strict`",
      "delivery_state": "VERIFIED",
      "state": "verified",
      "done": true,
      "landed_in": [
        "87b5fd589e52"
      ],
      "verified_by": [
        "tests/test_upstream_sources.py:162"
      ],
      "parent_title": "US-CONTENT \u2014 The catalog is served by the SDK content convention",
      "definition": "Overlays in `universal_skills/overlays/<skill>/*.md` merge into the rendered skill in file-name order with the modes `append`, `prepend`, `replace`, `insert-after` and `file`. A `replace` or `insert-after` whose match does not hit exactly one line fails. Caller chain: `scripts/sync_upstream_skills.py` \u2192 the overlay merge after the render \u2192 `universal_skills/overlays/<skill>/*.md`. Shape: one merge function in `scripts/sync_upstream_skills.py`. Proving test: `tests/test_upstream_sources.py::test_overlay_merge_is_ordered_and_strict`. | The test applies each mode, finds the expected text and finds the ambiguous match rejected.",
      "definition_source": "specs/catalog-content/requirements.md",
      "definition_line": 16
    },
    {
      "id": "US-CONTENT-R002.6",
      "kind": "requirement",
      "parent": "US-CONTENT",
      "source": "specs/catalog-content/status.json",
      "title": "A sync fetches the pin into a throwaway repository, reads files from the git object store, executes none of them, and writes the snapshot under `universal_skills/upstream/<source>/`, the skill folder, `LICENSE` and `UPSTREAM.md` (source URL, pinned commit, path, license, transform, sync date, source digest, overlay list). Caller chain: `scripts/sync_upstream_skills.py` \u2192 the fetch into a throwaway repository \u2192 the snapshot writer. Shape: the sync command in `scripts/sync_upstream_skills.py`, reading blobs with `git cat-file`. Proving test: `tests/test_upstream_sources.py::test_sync_writes_provenance_without_running_code`",
      "delivery_state": "VERIFIED",
      "state": "verified",
      "done": true,
      "landed_in": [
        "87b5fd589e52"
      ],
      "verified_by": [
        "tests/test_upstream_sources.py:236"
      ],
      "parent_title": "US-CONTENT \u2014 The catalog is served by the SDK content convention",
      "definition": "A sync fetches the pin into a throwaway repository, reads files from the git object store, executes none of them, and writes the snapshot under `universal_skills/upstream/<source>/`, the skill folder, `LICENSE` and `UPSTREAM.md` (source URL, pinned commit, path, license, transform, sync date, source digest, overlay list). Caller chain: `scripts/sync_upstream_skills.py` \u2192 the fetch into a throwaway repository \u2192 the snapshot writer. Shape: the sync command in `scripts/sync_upstream_skills.py`, reading blobs with `git cat-file`. Proving test: `tests/test_upstream_sources.py::test_sync_writes_provenance_without_running_code`. | The test syncs from a local repository holding an executable script and finds the provenance fields, the license and no sign the script ran.",
      "definition_source": "specs/catalog-content/requirements.md",
      "definition_line": 17
    },
    {
      "id": "US-CONTENT-R002.7",
      "kind": "requirement",
      "parent": "US-CONTENT",
      "source": "specs/catalog-content/status.json",
      "title": "`--check` runs offline and fails when any vendored file differs from the pinned snapshot plus overlays, when a file is missing or extra, or (with `--verify-pin`) when the snapshot differs from upstream. Caller chain: the pre-commit hook \u2192 `scripts/sync_upstream_skills.py --check` \u2192 the drift comparison. Shape: the check mode of `scripts/sync_upstream_skills.py`, reusing the render and merge functions. Proving test: `tests/test_upstream_sources.py::test_check_detects_hand_edits_and_overlay_drift`",
      "delivery_state": "VERIFIED",
      "state": "verified",
      "done": true,
      "landed_in": [
        "87b5fd589e52"
      ],
      "verified_by": [
        "tests/test_upstream_sources.py:259"
      ],
      "parent_title": "US-CONTENT \u2014 The catalog is served by the SDK content convention",
      "definition": "`--check` runs offline and fails when any vendored file differs from the pinned snapshot plus overlays, when a file is missing or extra, or (with `--verify-pin`) when the snapshot differs from upstream. Caller chain: the pre-commit hook \u2192 `scripts/sync_upstream_skills.py --check` \u2192 the drift comparison. Shape: the check mode of `scripts/sync_upstream_skills.py`, reusing the render and merge functions. Proving test: `tests/test_upstream_sources.py::test_check_detects_hand_edits_and_overlay_drift`. | The test finds a clean tree passing, then a hand edit, an extra file and an overlay change each reported as drift.",
      "definition_source": "specs/catalog-content/requirements.md",
      "definition_line": 18
    },
    {
      "id": "US-CONTENT-R002.8",
      "kind": "requirement",
      "parent": "US-CONTENT",
      "source": "specs/catalog-content/status.json",
      "title": "`--update <source>` moves the pin to the latest commit of the source's tracked branch, keeps the manifest comments, and re-syncs so the change is one reviewable diff. Caller chain: a maintainer \u2192 `scripts/sync_upstream_skills.py --update <source>` \u2192 the pin rewrite and the re-sync. Shape: the update mode of `scripts/sync_upstream_skills.py`, reusing the sync command. Proving test: `tests/test_upstream_sources.py::test_update_moves_the_pin_and_resyncs`",
      "delivery_state": "VERIFIED",
      "state": "verified",
      "done": true,
      "landed_in": [
        "87b5fd589e52"
      ],
      "verified_by": [
        "tests/test_upstream_sources.py:288"
      ],
      "parent_title": "US-CONTENT \u2014 The catalog is served by the SDK content convention",
      "definition": "`--update <source>` moves the pin to the latest commit of the source's tracked branch, keeps the manifest comments, and re-syncs so the change is one reviewable diff. Caller chain: a maintainer \u2192 `scripts/sync_upstream_skills.py --update <source>` \u2192 the pin rewrite and the re-sync. Shape: the update mode of `scripts/sync_upstream_skills.py`, reusing the sync command. Proving test: `tests/test_upstream_sources.py::test_update_moves_the_pin_and_resyncs`. | The test updates a local source after a new upstream commit and finds the new pin, the kept comment and the new skill text.",
      "definition_source": "specs/catalog-content/requirements.md",
      "definition_line": 19
    },
    {
      "id": "US-CONTENT-R002.9",
      "kind": "requirement",
      "parent": "US-CONTENT",
      "source": "specs/catalog-content/status.json",
      "title": "The spec-kit source vendors `speckit-constitution`, `speckit-specify`, `speckit-clarify`, `speckit-plan`, `speckit-tasks`, `speckit-analyze`, `speckit-checklist` and `speckit-implement`, each with an overlay that carries the repository extensions. The skills `spec-generator`, `task-planner`, `spec-verifier`, `spec-intake-wizard` and `feature-development-pipeline` are removed and no file in the repository refers to them. Caller chain: `scripts/sync_upstream_skills.py` \u2192 the spec-kit source of `upstream-sources.toml` \u2192 eight skill folders. Shape: one source table in `upstream-sources.toml` and one overlay folder per skill. Proving test: `tests/test_upstream_sources.py::test_spec_kit_skills_replace_the_retired_skills`",
      "delivery_state": "VERIFIED",
      "state": "verified",
      "done": true,
      "landed_in": [
        "87b5fd589e52"
      ],
      "verified_by": [
        "tests/test_upstream_sources.py:311"
      ],
      "parent_title": "US-CONTENT \u2014 The catalog is served by the SDK content convention",
      "definition": "The spec-kit source vendors `speckit-constitution`, `speckit-specify`, `speckit-clarify`, `speckit-plan`, `speckit-tasks`, `speckit-analyze`, `speckit-checklist` and `speckit-implement`, each with an overlay that carries the repository extensions. The skills `spec-generator`, `task-planner`, `spec-verifier`, `spec-intake-wizard` and `feature-development-pipeline` are removed and no file in the repository refers to them. Caller chain: `scripts/sync_upstream_skills.py` \u2192 the spec-kit source of `upstream-sources.toml` \u2192 eight skill folders. Shape: one source table in `upstream-sources.toml` and one overlay folder per skill. Proving test: `tests/test_upstream_sources.py::test_spec_kit_skills_replace_the_retired_skills`. | The test finds the eight skills in sync with their pins, the five retired folders absent and no reference left.",
      "definition_source": "specs/catalog-content/requirements.md",
      "definition_line": 20
    },
    {
      "id": "US-CONTENT-R002.10",
      "kind": "requirement",
      "parent": "US-CONTENT",
      "source": "specs/catalog-content/status.json",
      "title": "The pre-commit configuration runs `scripts/sync_upstream_skills.py --check`, and the `universal-installer` skill describes the update procedure: `--update` per source, `--check --verify-pin`, the tests, then a pull request and never a push to the default branch. Caller chain: the pre-commit configuration \u2192 `scripts/sync_upstream_skills.py --check`. Shape: one hook entry in the pre-commit configuration and one procedure section in the `universal-installer` skill. Proving test: `tests/test_upstream_sources.py::test_hook_and_installer_are_wired`",
      "delivery_state": "VERIFIED",
      "state": "verified",
      "done": true,
      "landed_in": [
        "87b5fd589e52"
      ],
      "verified_by": [
        "tests/test_upstream_sources.py:338"
      ],
      "parent_title": "US-CONTENT \u2014 The catalog is served by the SDK content convention",
      "definition": "The pre-commit configuration runs `scripts/sync_upstream_skills.py --check`, and the `universal-installer` skill describes the update procedure: `--update` per source, `--check --verify-pin`, the tests, then a pull request and never a push to the default branch. Caller chain: the pre-commit configuration \u2192 `scripts/sync_upstream_skills.py --check`. Shape: one hook entry in the pre-commit configuration and one procedure section in the `universal-installer` skill. Proving test: `tests/test_upstream_sources.py::test_hook_and_installer_are_wired`. | The test finds the hook entry and the procedure in the installer skill.",
      "definition_source": "specs/catalog-content/requirements.md",
      "definition_line": 21
    },
    {
      "id": "US-CONTENT-R003",
      "kind": "requirement",
      "parent": "US-CONTENT",
      "source": "specs/catalog-content/status.json",
      "title": "The `code-enhancer` skill follows the organization constitution",
      "delivery_state": "VERIFIED",
      "state": "verified",
      "done": true,
      "landed_in": [
        "e0d20c6366d6"
      ],
      "verified_by": [
        "tests/test_code_enhancer.py:867"
      ],
      "parent_title": "US-CONTENT \u2014 The catalog is served by the SDK content convention",
      "definition": "**The `code-enhancer` skill follows the organization constitution.** Its scripts take size, complexity and clone limits from one module that mirrors the constitution thresholds table. It has no baseline or ratchet mode. It writes specs to `specs/<feature>/`. It names only current intent tools of the graph door. It carries no legacy concept IDs in its examples. Its dependency guidance points at article XXVII. Caller chain: a maintainer runs the `code-enhancer` skill scripts \u2192 its limits module. Shape: one limits module under `universal_skills/skills/code-enhancer/` that mirrors the constitution table. Proving test: `tests/test_code_enhancer.py::test_code_enhancer_follows_the_organization_constitution`. | The test finds the limits module holding the table values, no baseline script or flag, no `.specify` output path, no retired tool or package name, no legacy concept ID, and the article reference in the skill.",
      "definition_source": "specs/catalog-content/requirements.md",
      "definition_line": 22
    },
    {
      "id": "US-CONTENT-R004",
      "kind": "requirement",
      "parent": "US-CONTENT",
      "source": "specs/catalog-content/status.json",
      "title": "The `spec-row-delivery` skill guides one delivery assignment run (rollup)",
      "delivery_state": "SPECIFIED",
      "state": "specified",
      "done": false,
      "landed_in": [],
      "verified_by": [],
      "parent_title": "US-CONTENT \u2014 The catalog is served by the SDK content convention",
      "definition": "**The `spec-row-delivery` skill guides one delivery assignment run (rollup).** The catalog holds one skill that states the procedure for delivering one spec row as one change proposal. A delivery assignment run of meristem loads it (`MERISTEM-SCM-R012`). The run reports to the engine delivery records (`MEDULLA-SDLC-R019.7`). The skill holds procedure only; it decides nothing and calls no tool by itself. Children `.1` to `.3` deliver it. Depends on: US-CONTENT-R001.2. | Satisfied only when every child is satisfied. Root test: `tests/test_spec_row_delivery_skill.py::test_skill_states_the_full_delivery_procedure`.",
      "definition_source": "specs/catalog-content/requirements.md",
      "definition_line": 23
    },
    {
      "id": "US-CONTENT-R004.1",
      "kind": "requirement",
      "parent": "US-CONTENT",
      "source": "specs/catalog-content/status.json",
      "title": "Content: the delivery procedure",
      "delivery_state": "SPECIFIED",
      "state": "specified",
      "done": false,
      "landed_in": [],
      "verified_by": [],
      "parent_title": "US-CONTENT \u2014 The catalog is served by the SDK content convention",
      "definition": "**Content: the delivery procedure.** `universal_skills/skills/spec-row-delivery/SKILL.md` must state these steps in order. Read the row, its plan section and its contracts. Search the existing code before writing new code. Implement the row with a test bound to its ID. Commit with the `Spec:` trailer directly above the co-author line. Run the gates the change touches. End with one report state: `progress`, `waiting`, `ready`, `blocked`, `failed` or `dropped`. Resolve a review thread when its finding is fixed. Post one reply with a reason when a suggestion is declined. Stop work on an automated reviewer after a received `stop_addressing` verdict. The skill must forbid a merge, an auto-merge arming, a spec edit and a skipped gate. Caller chain: meristem delivery assignment run (`MERISTEM-SCM-R012.2`) \u2192 skill resource `skill://spec-row-delivery/SKILL.md` served by the SDK content convention (US-CONTENT-R001.3). Shape: one new `SKILL.md` in the flat layout of US-CONTENT-R001.2; no script and no server code. Refusal: the validation test fails and names the missing step or the missing prohibition. Knob: none. Depends on: US-CONTENT-R001.2, MERISTEM-SCM-R012. | Test: `tests/test_spec_row_delivery_skill.py::test_skill_states_the_full_delivery_procedure`.",
      "definition_source": "specs/catalog-content/requirements.md",
      "definition_line": 24
    },
    {
      "id": "US-CONTENT-R004.2",
      "kind": "requirement",
      "parent": "US-CONTENT",
      "source": "specs/catalog-content/status.json",
      "title": "Frontmatter and catalog registration",
      "delivery_state": "SPECIFIED",
      "state": "specified",
      "done": false,
      "landed_in": [],
      "verified_by": [],
      "parent_title": "US-CONTENT \u2014 The catalog is served by the SDK content convention",
      "definition": "**Frontmatter and catalog registration.** The skill frontmatter must carry `name: spec-row-delivery`, a one-sentence `description` with its trigger, `domain: development` and `skill_type: skill`. Its `metadata.version` must equal the package version. The served catalog must list `skill://spec-row-delivery/SKILL.md`. The skill must pass the hooks `check-atomicity`, `check-frontmatter-portability` and `skill-catalog-structure`. Caller chain: arbora serves the catalog \u2192 the SDK content convention (US-CONTENT-R001.3) \u2192 the skill folder. Shape: frontmatter keys in the style of `universal_skills/skills/sdd-implementer/SKILL.md`; reuse `tests/test_catalog_content.py::test_server_lists_every_skill` for the listing. Refusal: a portability or atomicity hook failure blocks the commit. Knob: none. Depends on: US-CONTENT-R004.1, US-CONTENT-R001.3. | Test: `tests/test_spec_row_delivery_skill.py::test_frontmatter_is_portable_and_the_catalog_lists_the_skill`.",
      "definition_source": "specs/catalog-content/requirements.md",
      "definition_line": 25
    },
    {
      "id": "US-CONTENT-R004.3",
      "kind": "requirement",
      "parent": "US-CONTENT",
      "source": "specs/catalog-content/status.json",
      "title": "Validation test: procedure, prohibitions and neutral text",
      "delivery_state": "SPECIFIED",
      "state": "specified",
      "done": false,
      "landed_in": [],
      "verified_by": [],
      "parent_title": "US-CONTENT \u2014 The catalog is served by the SDK content convention",
      "definition": "**Validation test: procedure, prohibitions and neutral text.** New `tests/test_spec_row_delivery_skill.py` must read the skill text. It asserts each step of US-CONTENT-R004.1 in order and each of the four prohibitions. It also asserts that the text names no host, private domain or local path. Caller chain: `pytest` \u2192 `tests/test_spec_row_delivery_skill.py` \u2192 `universal_skills/skills/spec-row-delivery/SKILL.md`. Shape: one test module that reuses the skill-path helpers of `tests/test_catalog_content.py`. Refusal: a missing step, a missing prohibition or a private name fails the test. Knob: none. Depends on: US-CONTENT-R004.1, US-CONTENT-R004.2. | Test: `tests/test_spec_row_delivery_skill.py::test_skill_text_is_neutral_and_forbids_merge_and_skips`.",
      "definition_source": "specs/catalog-content/requirements.md",
      "definition_line": 26
    },
    {
      "id": "US-CONTENT-R005",
      "kind": "requirement",
      "parent": "US-CONTENT",
      "source": "specs/catalog-content/status.json",
      "title": "Delivery skills point to the delivery practice reference and the constitution articles",
      "delivery_state": "VERIFIED",
      "state": "verified",
      "done": true,
      "landed_in": [
        "c8f6927cd743"
      ],
      "verified_by": [
        "tests/test_delivery_practice_links.py:16"
      ],
      "parent_title": "US-CONTENT \u2014 The catalog is served by the SDK content convention",
      "definition": "**Delivery skills point to the delivery practice reference and the constitution articles.** The skills `sdd-full-lifecycle`, `sdd-implementer`, `arbora-development` and `medulla-development`, and the overlay of `speckit-implement`, must link the delivery practice reference and name articles XVIII, XXV, XXVIII and XXIX of the constitution. They must not copy the rules of the reference. Caller chain: an agent loads a delivery skill \u2192 its Delivery practice section \u2192 the linked reference. Shape: one added section in each of four `SKILL.md` files and in `universal_skills/overlays/speckit-implement/10-workspace.md`, then `scripts/sync_upstream_skills.py` regenerates the vendored skill. Refusal: the test names the skill that lacks the link or the article. Knob: none. Proving test: `tests/test_delivery_practice_links.py::test_delivery_skills_link_the_reference_and_the_articles`. | The test finds the link and the four article numbers in each skill, and finds none of the reference's section titles copied.",
      "definition_source": "specs/catalog-content/requirements.md",
      "definition_line": 27
    },
    {
      "id": "US-MCP-BUILDER",
      "kind": "spec",
      "parent": null,
      "source": "specs/mcp-builder/status.json",
      "title": "US-MCP-BUILDER \u2014 The mcp-builder scaffold builds connectors on SDK components",
      "delivery_state": "SPECIFIED",
      "state": "specified",
      "done": false,
      "landed_in": [],
      "verified_by": [],
      "document": "specs/mcp-builder/spec.md",
      "component": "Unassigned",
      "code_refs": [
        {
          "declared_in": "specs/mcp-builder/plan.md",
          "evidence": "file exists; coverage not verified",
          "label": "spec.md",
          "repository": "Knuckles-Team/universal-skills",
          "role": "documentation",
          "url": "https://github.com/Knuckles-Team/universal-skills/blob/3681cc1b846429b2e45037dbe99fb5cf1c36e34b/specs/mcp-builder/spec.md"
        },
        {
          "declared_in": "specs/mcp-builder/plan.md",
          "evidence": "file exists; coverage not verified",
          "label": "tests/test_mcp_builder_connector_scaffold.py",
          "repository": "Knuckles-Team/universal-skills",
          "role": "test",
          "url": "https://github.com/Knuckles-Team/universal-skills/blob/3681cc1b846429b2e45037dbe99fb5cf1c36e34b/tests/test_mcp_builder_connector_scaffold.py"
        },
        {
          "declared_in": "specs/mcp-builder/spec.md",
          "evidence": "file exists; coverage not verified",
          "label": "requirements.md",
          "repository": "Knuckles-Team/universal-skills",
          "role": "documentation",
          "url": "https://github.com/Knuckles-Team/universal-skills/blob/3681cc1b846429b2e45037dbe99fb5cf1c36e34b/specs/mcp-builder/requirements.md"
        },
        {
          "declared_in": "specs/mcp-builder/spec.md",
          "evidence": "file exists; coverage not verified",
          "label": "test-spec.md",
          "repository": "Knuckles-Team/universal-skills",
          "role": "documentation",
          "url": "https://github.com/Knuckles-Team/universal-skills/blob/3681cc1b846429b2e45037dbe99fb5cf1c36e34b/specs/mcp-builder/test-spec.md"
        }
      ],
      "relations": [
        {
          "declared_in": "specs/mcp-builder/spec.md",
          "evidence": "external declaration; not verified",
          "kind": "references",
          "label": "SCION-CENTRALIZED-CAPABILITIES",
          "repository": "Knuckles-Team/scion-sdk",
          "url": "https://github.com/Knuckles-Team/scion-sdk/blob/main/specs/centralized-capabilities/spec.md"
        }
      ],
      "plan_diagrams": [],
      "unparsed_references": []
    },
    {
      "id": "US-MCP-BUILDER-R011",
      "kind": "requirement",
      "parent": "US-MCP-BUILDER",
      "source": "specs/mcp-builder/status.json",
      "title": "Connector scaffold on SDK components",
      "delivery_state": "VERIFIED",
      "state": "verified",
      "done": true,
      "landed_in": [
        "194946ca6443",
        "6b640594c734",
        "768aefce0622",
        "9a21e191c8b6",
        "ab2071875a33"
      ],
      "verified_by": [
        "tests/test_mcp_builder_connector_scaffold.py:118",
        "tests/test_mcp_builder_connector_scaffold.py:126",
        "tests/test_mcp_builder_connector_scaffold.py:132",
        "tests/test_mcp_builder_connector_scaffold.py:149",
        "tests/test_mcp_builder_connector_scaffold.py:231"
      ],
      "parent_title": "US-MCP-BUILDER \u2014 The mcp-builder scaffold builds connectors on SDK components",
      "definition": "**Connector scaffold on SDK components.** `scripts/scaffold_connector.py` must be the only connector generator. It must emit only connector-specific files and build the connector on SDK components. Parent of R011.1 to R011.13. SDK owners: `SCION-CONNECTOR-CONTROL-R019.1`, `SCION-QUALITY-RELEASE-R005.1`. | Every child row passes.",
      "definition_source": "specs/mcp-builder/requirements.md",
      "definition_line": 9
    },
    {
      "id": "US-MCP-BUILDER-R011.1",
      "kind": "requirement",
      "parent": "US-MCP-BUILDER",
      "source": "specs/mcp-builder/status.json",
      "title": "Exact connector-owned tree",
      "delivery_state": "VERIFIED",
      "state": "verified",
      "done": true,
      "landed_in": [
        "6b640594c734",
        "9a21e191c8b6",
        "b7adccaaf777"
      ],
      "verified_by": [
        "tests/test_mcp_builder_connector_scaffold.py:118",
        "tests/test_mcp_builder_connector_scaffold.py:231"
      ],
      "parent_title": "US-MCP-BUILDER \u2014 The mcp-builder scaffold builds connectors on SDK components",
      "definition": "**Exact connector-owned tree.** The generator must write exactly the 28 files of the minimal connector tree: the package/API/content/spec files plus the aggregate hook reference, dashboard config, release/PR/Pages callers, `pages/index.md`, and the repository development skill. It must write none of the files the SDK or pipelines own: no `mcp_server.py`, `tools.py`, `_version.py`, `.bumpversion.cfg`, `docker/` files, `certification.json`, shapes file, `mcp_config.json`, `conftest.py`, `kg_ingest.py`, or shared-theme assets. The Pages caller leaves `shared_theme_enabled` false until a pinned pipelines checkout generates canonical theme outputs with `scripts/sync_mkdocs_theme.py`. Caller chain: an operator or agent follows universal_skills/skills/mcp-builder/SKILL.md:32 and runs `scaffold_connector.py <fleet>`; `main` (universal_skills/skills/mcp-builder/scripts/scaffold_connector.py:659) \u2192 `scaffold` (:645) \u2192 `tree` (:605), whose `files` mapping is the whole connector-owned tree. Shape: file scaffold_connector.py, the `files` dict in `tree` and the Pages caller template `PAGES` (:454); reuse `tree` as the only list of generated paths. | `tests/test_mcp_builder_connector_scaffold.py::test_scaffold_emits_exactly_the_minimal_tree` and `tests/test_mcp_builder_connector_scaffold.py::test_generated_pages_caller_has_a_safe_shared_theme_preflight` pass.",
      "definition_source": "specs/mcp-builder/requirements.md",
      "definition_line": 10
    },
    {
      "id": "US-MCP-BUILDER-R011.2",
      "kind": "requirement",
      "parent": "US-MCP-BUILDER",
      "source": "specs/mcp-builder/status.json",
      "title": "Deterministic output",
      "delivery_state": "VERIFIED",
      "state": "verified",
      "done": true,
      "landed_in": [
        "6b640594c734",
        "b7adccaaf777",
        "cf9c2f83be62"
      ],
      "verified_by": [
        "tests/test_mcp_builder_connector_scaffold.py:126"
      ],
      "parent_title": "US-MCP-BUILDER \u2014 The mcp-builder scaffold builds connectors on SDK components",
      "definition": "**Deterministic output.** The generator must write byte-identical files for the same fleet name. It must write no date, user or host name. Caller chain: `main` (universal_skills/skills/mcp-builder/scripts/scaffold_connector.py:659) \u2192 `scaffold` (:645) \u2192 `tree` (:605), which returns `dict(sorted(out.items()))` from `fmt` over fleet-derived names only. Shape: file scaffold_connector.py (`_names` at :37, `tree`); the templates hold no clock, user or host call. | `tests/test_mcp_builder_connector_scaffold.py::test_generation_is_deterministic` passes.",
      "definition_source": "specs/mcp-builder/requirements.md",
      "definition_line": 11
    },
    {
      "id": "US-MCP-BUILDER-R011.3",
      "kind": "requirement",
      "parent": "US-MCP-BUILDER",
      "source": "specs/mcp-builder/status.json",
      "title": "Identity and version in pyproject only",
      "delivery_state": "VERIFIED",
      "state": "verified",
      "done": true,
      "landed_in": [
        "6b640594c734"
      ],
      "verified_by": [
        "tests/test_mcp_builder_connector_scaffold.py:132"
      ],
      "parent_title": "US-MCP-BUILDER \u2014 The mcp-builder scaffold builds connectors on SDK components",
      "definition": "**Identity and version in pyproject only.** The generated `pyproject.toml` must hold the version, the one `agent_connector_sdk.connector` entry point `<fleet> = \"<pkg>:connector\"`, the `agent_connector_sdk.cli:serve` console script and the floor `scion-sdk[mcp]>=0.5.1,<0.6`. No Python file may spell the version or the fleet name. Caller chain: `tree` (universal_skills/skills/mcp-builder/scripts/scaffold_connector.py:605) formats the `PYPROJECT` template (:53) with `SDK_FLOOR` (:27); the package modules (`INIT` at :84, `MAIN` at :98) carry no version or fleet literal. Shape: file scaffold_connector.py; the dependency is `scion-sdk[mcp]>={sdk},<0.6` and the console script and entry point sit in the PYPROJECT template. | `tests/test_mcp_builder_connector_scaffold.py::test_identity_and_version_live_in_pyproject_only` passes.",
      "definition_source": "specs/mcp-builder/requirements.md",
      "definition_line": 12
    },
    {
      "id": "US-MCP-BUILDER-R011.4",
      "kind": "requirement",
      "parent": "US-MCP-BUILDER",
      "source": "specs/mcp-builder/status.json",
      "title": "Shared workflows for release and PR",
      "delivery_state": "VERIFIED",
      "state": "verified",
      "done": true,
      "landed_in": [
        "6b640594c734"
      ],
      "verified_by": [
        "tests/test_mcp_builder_connector_scaffold.py:149"
      ],
      "parent_title": "US-MCP-BUILDER \u2014 The mcp-builder scaffold builds connectors on SDK components",
      "definition": "**Shared workflows for release and PR.** The release workflow must call the shared `python_pipeline.yml` with `connector: true` and `container_pipeline.yml` with `render_connector: true`, publishing to PyPI and Docker Hub. The PR workflow must call `connector_pr_pipeline.yml`. Caller chain: `tree` (universal_skills/skills/mcp-builder/scripts/scaffold_connector.py:605) writes `.github/workflows/pipeline.yml` from `PIPELINE` (:394) and `.github/workflows/connector-pr.yml` from `CONNECTOR_PR` (:427). Shape: file scaffold_connector.py; both workflows are callers of the shared pipelines workflows and hold no step of their own. | `tests/test_mcp_builder_connector_scaffold.py::test_workflows_call_the_shared_pipelines_for_pypi_and_docker` passes.",
      "definition_source": "specs/mcp-builder/requirements.md",
      "definition_line": 13
    },
    {
      "id": "US-MCP-BUILDER-R011.5",
      "kind": "requirement",
      "parent": "US-MCP-BUILDER",
      "source": "specs/mcp-builder/status.json",
      "title": "One tool per operation with risk classes",
      "delivery_state": "VERIFIED",
      "state": "verified",
      "done": true,
      "landed_in": [
        "6b640594c734"
      ],
      "verified_by": [
        "tests/test_mcp_builder_connector_scaffold.py:317"
      ],
      "parent_title": "US-MCP-BUILDER \u2014 The mcp-builder scaffold builds connectors on SDK components",
      "definition": "**One tool per operation with risk classes.** The generated `Api` class must hold one public method per API operation, and the SDK must serve one tool per method. Read, write and destructive annotations must follow the verb. No tool may take an `action` or `params_json` argument. Caller chain: `tree` (universal_skills/skills/mcp-builder/scripts/scaffold_connector.py:605) writes `{pkg}/api_client.py` from `API_CLIENT` (:126), whose `Api` class (:135) the SDK serves one tool per public method; `VERBS` (:29) maps the verb to the risk class. Shape: file scaffold_connector.py; the class holds named operation methods and no `action` or `params_json` argument. | `tests/test_mcp_builder_connector_scaffold.py::test_one_tool_per_operation_with_risk_annotations` passes.",
      "definition_source": "specs/mcp-builder/requirements.md",
      "definition_line": 14
    },
    {
      "id": "US-MCP-BUILDER-R011.6",
      "kind": "requirement",
      "parent": "US-MCP-BUILDER",
      "source": "specs/mcp-builder/status.json",
      "title": "Sources declared as data",
      "delivery_state": "VERIFIED",
      "state": "verified",
      "done": true,
      "landed_in": [
        "6b640594c734"
      ],
      "verified_by": [
        "tests/test_mcp_builder_connector_scaffold.py:328"
      ],
      "parent_title": "US-MCP-BUILDER \u2014 The mcp-builder scaffold builds connectors on SDK components",
      "definition": "**Sources declared as data.** `connector_sources.py` must declare each source with `source_meta(tool=...)`. The SDK must load it with `load_declaration` and serve it as `connector://resources`. The scaffold must write no manifest file and no `declaration()` function. Caller chain: `tree` (universal_skills/skills/mcp-builder/scripts/scaffold_connector.py:605) writes `{pkg}/connector_sources.py` from `SOURCES` (:158); the SDK reads it with `load_declaration`. Shape: file scaffold_connector.py; `SOURCES` declares each source with `source_meta` and `tree` writes no manifest file. | `tests/test_mcp_builder_connector_scaffold.py::test_sources_load_as_typed_declaration_with_no_manifest_file` passes.",
      "definition_source": "specs/mcp-builder/requirements.md",
      "definition_line": 15
    },
    {
      "id": "US-MCP-BUILDER-R011.7",
      "kind": "requirement",
      "parent": "US-MCP-BUILDER",
      "source": "specs/mcp-builder/status.json",
      "title": "Content served over MCP",
      "delivery_state": "VERIFIED",
      "state": "verified",
      "done": true,
      "landed_in": [
        "6b640594c734"
      ],
      "verified_by": [
        "tests/test_mcp_builder_connector_scaffold.py:338"
      ],
      "parent_title": "US-MCP-BUILDER \u2014 The mcp-builder scaffold builds connectors on SDK components",
      "definition": "**Content served over MCP.** The generated prompt must be a fastmcp prompt with a title and metadata. The generated skill and ontology must be served as resources. The scaffold must write no file that is served separately. Caller chain: `tree` (universal_skills/skills/mcp-builder/scripts/scaffold_connector.py:605) writes the prompt from `PROMPT` (:176), the skill from `SKILL` (:187) and the ontology from `ONTOLOGY` (:287); the SDK serves them as MCP prompt and resources. Shape: file scaffold_connector.py; the three live under `{pkg}/prompts`, `{pkg}/skills` and `{pkg}/ontology` and `tree` writes no separately served copy. | `tests/test_mcp_builder_connector_scaffold.py::test_prompt_skill_and_ontology_are_served_over_mcp` passes.",
      "definition_source": "specs/mcp-builder/requirements.md",
      "definition_line": 16
    },
    {
      "id": "US-MCP-BUILDER-R011.8",
      "kind": "requirement",
      "parent": "US-MCP-BUILDER",
      "source": "specs/mcp-builder/status.json",
      "title": "Ontology rolls up to a core class",
      "delivery_state": "VERIFIED",
      "state": "verified",
      "done": true,
      "landed_in": [
        "6b640594c734"
      ],
      "verified_by": [
        "tests/test_mcp_builder_connector_scaffold.py:349"
      ],
      "parent_title": "US-MCP-BUILDER \u2014 The mcp-builder scaffold builds connectors on SDK components",
      "definition": "**Ontology rolls up to a core class.** Every generated class must extend a core class of the parent ontology with `rdfs:subClassOf`. The pack must not use `owl:imports` for the parent ontology. Caller chain: `tree` (universal_skills/skills/mcp-builder/scripts/scaffold_connector.py:605) formats `ONTOLOGY` (:287) with `CORE_CLASS` (:28). Shape: file scaffold_connector.py; every generated class carries `rdfs:subClassOf` the core class and the template holds no `owl:imports`. | `tests/test_mcp_builder_connector_scaffold.py::test_ontology_rolls_up_to_a_core_class_and_never_imports_the_parent` passes.",
      "definition_source": "specs/mcp-builder/requirements.md",
      "definition_line": 17
    },
    {
      "id": "US-MCP-BUILDER-R011.9",
      "kind": "requirement",
      "parent": "US-MCP-BUILDER",
      "source": "specs/mcp-builder/status.json",
      "title": "Pipelines connector gates pass",
      "delivery_state": "VERIFIED",
      "state": "verified",
      "done": true,
      "landed_in": [
        "194946ca6443"
      ],
      "verified_by": [
        "tests/test_mcp_builder_connector_scaffold.py:387"
      ],
      "parent_title": "US-MCP-BUILDER \u2014 The mcp-builder scaffold builds connectors on SDK components",
      "definition": "**Pipelines connector gates pass.** The generated repository must pass the pipelines `connector-name` gate in strict mode and the `connector-standard` file and spelling checks. Caller chain: `main` (universal_skills/skills/mcp-builder/scripts/scaffold_connector.py:659) tells the operator to run `pipelines-hook connector-name --strict` before the first push; the gate reads the tree `tree` (:605) wrote. Shape: file scaffold_connector.py (`_names` at :37 builds the fleet, package and display names that the gate checks). | `tests/test_mcp_builder_connector_scaffold.py::test_pipelines_connector_gates_pass` passes.",
      "definition_source": "specs/mcp-builder/requirements.md",
      "definition_line": 18
    },
    {
      "id": "US-MCP-BUILDER-R011.10",
      "kind": "requirement",
      "parent": "US-MCP-BUILDER",
      "source": "specs/mcp-builder/status.json",
      "title": "Ontology graph check passes",
      "delivery_state": "VERIFIED",
      "state": "verified",
      "done": true,
      "landed_in": [
        "6b640594c734"
      ],
      "verified_by": [
        "tests/test_mcp_builder_connector_scaffold.py:443"
      ],
      "parent_title": "US-MCP-BUILDER \u2014 The mcp-builder scaffold builds connectors on SDK components",
      "definition": "**Ontology graph check passes.** The generated pack must raise no `connector-ontology-map graph-check` finding against the core ontology at the revision pinned in the test. The test fetches that revision; it needs no local checkout. Caller chain: `main` (universal_skills/skills/mcp-builder/scripts/scaffold_connector.py:659) tells the operator to run `pipelines-hook connector-ontology-map graph-check`; the gate reads `ONTOLOGY` (:287) as written by `tree` (:605). Shape: file scaffold_connector.py; the test fetches the core ontology at a pinned revision. | `tests/test_mcp_builder_connector_scaffold.py::test_ontology_graph_check_passes_against_the_core_ontology` passes.",
      "definition_source": "specs/mcp-builder/requirements.md",
      "definition_line": 19
    },
    {
      "id": "US-MCP-BUILDER-R011.11",
      "kind": "requirement",
      "parent": "US-MCP-BUILDER",
      "source": "specs/mcp-builder/status.json",
      "title": "SDK conformance plugin passes",
      "delivery_state": "VERIFIED",
      "state": "verified",
      "done": true,
      "landed_in": [
        "6b640594c734"
      ],
      "verified_by": [
        "tests/test_mcp_builder_connector_scaffold.py:461"
      ],
      "parent_title": "US-MCP-BUILDER \u2014 The mcp-builder scaffold builds connectors on SDK components",
      "definition": "**SDK conformance plugin passes.** The generated package must pass the SDK pytest conformance plugin and hold no copy of its tests. Caller chain: the generated tests/test_api_client.py (`TEST` at universal_skills/skills/mcp-builder/scripts/scaffold_connector.py:492) runs beside the SDK pytest plugin `agent_connector_sdk.testing.plugin`. Shape: file scaffold_connector.py; `TEST` holds only client-logic tests and copies none of the plugin tests. | `tests/test_mcp_builder_connector_scaffold.py::test_generated_package_passes_the_sdk_conformance_plugin` passes.",
      "definition_source": "specs/mcp-builder/requirements.md",
      "definition_line": 20
    },
    {
      "id": "US-MCP-BUILDER-R011.12",
      "kind": "requirement",
      "parent": "US-MCP-BUILDER",
      "source": "specs/mcp-builder/status.json",
      "title": "Client from one SDK auth declaration",
      "delivery_state": "VERIFIED",
      "state": "verified",
      "done": true,
      "landed_in": [
        "6b640594c734"
      ],
      "verified_by": [
        "tests/test_mcp_builder_connector_scaffold.py:474"
      ],
      "parent_title": "US-MCP-BUILDER \u2014 The mcp-builder scaffold builds connectors on SDK components",
      "definition": "**Client from one SDK auth declaration.** `auth.py` must build the client with `client_factory` and one auth declaration, a TLS profile name and delegation. No generated module may import `requests` or `httpx`, disable TLS verification, build an SSL context or hold a thread-local token. SDK owner: `SCION-CONNECTOR-CONTROL-R028.4`. Caller chain: `tree` (universal_skills/skills/mcp-builder/scripts/scaffold_connector.py:605) writes `{pkg}/auth.py` from `AUTH` (:104), whose `get_client` (:121) returns the client built by the SDK `client_factory`. Shape: file scaffold_connector.py; `AUTH` declares one auth, one TLS profile name and delegation, and imports no `requests` or `httpx`. | `tests/test_mcp_builder_connector_scaffold.py::test_client_is_one_sdk_auth_declaration_with_no_own_transport` passes.",
      "definition_source": "specs/mcp-builder/requirements.md",
      "definition_line": 21
    },
    {
      "id": "US-MCP-BUILDER-R011.13",
      "kind": "requirement",
      "parent": "US-MCP-BUILDER",
      "source": "specs/mcp-builder/status.json",
      "title": "Dependencies through SDK extras",
      "delivery_state": "VERIFIED",
      "state": "verified",
      "done": true,
      "landed_in": [
        "6b640594c734"
      ],
      "verified_by": [
        "tests/test_mcp_builder_connector_scaffold.py:486"
      ],
      "parent_title": "US-MCP-BUILDER \u2014 The mcp-builder scaffold builds connectors on SDK components",
      "definition": "**Dependencies through SDK extras.** The generated `pyproject.toml` must depend on the SDK only, declare no optional dependency and declare no entry point other than the connector identity. A connector adds optional dependencies as SDK extras. Caller chain: `tree` (universal_skills/skills/mcp-builder/scripts/scaffold_connector.py:605) formats the `PYPROJECT` template (:53), whose `dependencies` list holds only `scion-sdk[mcp]`. Shape: file scaffold_connector.py; the template has no optional-dependencies table and one entry point, the connector identity. | `tests/test_mcp_builder_connector_scaffold.py::test_optional_dependencies_are_sdk_extras_only` passes.",
      "definition_source": "specs/mcp-builder/requirements.md",
      "definition_line": 22
    },
    {
      "id": "US-MCP-BUILDER-R011.14",
      "kind": "requirement",
      "parent": "US-MCP-BUILDER",
      "source": "specs/mcp-builder/status.json",
      "title": "The connector inherits the organization constitution",
      "delivery_state": "VERIFIED",
      "state": "verified",
      "done": true,
      "landed_in": [
        "f34012aa6532"
      ],
      "verified_by": [
        "tests/test_mcp_builder_connector_scaffold.py:501"
      ],
      "parent_title": "US-MCP-BUILDER \u2014 The mcp-builder scaffold builds connectors on SDK components",
      "definition": "**The connector inherits the organization constitution.** The scaffold must write `.specify/memory/constitution.md`. The file must link the organization constitution by public URL, state the inherited version, and hold the connector articles: one external system, one tool per API operation, and the SDK as the only dependency. Caller chain: `tree` (universal_skills/skills/mcp-builder/scripts/scaffold_connector.py:605) writes `.specify/memory/constitution.md` from `CONSTITUTION` (:559). Shape: file scaffold_connector.py; the template links the organization constitution by public URL, names the inherited version and lists the three connector articles. | `tests/test_mcp_builder_connector_scaffold.py::test_connector_inherits_the_organization_constitution` passes.",
      "definition_source": "specs/mcp-builder/requirements.md",
      "definition_line": 23
    },
    {
      "id": "US-MCP-BUILDER-R012",
      "kind": "requirement",
      "parent": "US-MCP-BUILDER",
      "source": "specs/mcp-builder/status.json",
      "title": "Wrap an existing MCP server",
      "delivery_state": "SPECIFIED",
      "state": "specified",
      "done": false,
      "landed_in": [
        "3681cc1b8464"
      ],
      "verified_by": [],
      "parent_title": "US-MCP-BUILDER \u2014 The mcp-builder scaffold builds connectors on SDK components",
      "definition": "**Wrap an existing MCP server.** `scaffold_connector.py <fleet> --wrap-mcp <url-or-command>` must generate a connector that serves an existing MCP server through the SDK upstream registry (`SCION-CONNECTOR-CONTROL-R914`). It must write no REST client. Parent of R012.1 to R012.3. | Every child row passes.",
      "definition_source": "specs/mcp-builder/requirements.md",
      "definition_line": 24
    },
    {
      "id": "US-MCP-BUILDER-R012.1",
      "kind": "requirement",
      "parent": "US-MCP-BUILDER",
      "source": "specs/mcp-builder/status.json",
      "title": "Deterministic whole project",
      "delivery_state": "SPECIFIED",
      "state": "specified",
      "done": false,
      "landed_in": [],
      "verified_by": [
        "tests/test_mcp_builder_connector_scaffold.py:529"
      ],
      "parent_title": "US-MCP-BUILDER \u2014 The mcp-builder scaffold builds connectors on SDK components",
      "definition": "**Deterministic whole project.** The same arguments must give byte-identical output for the repository and the deployment bundle. No date, user or host name may be written. | `tests/test_mcp_builder_connector_scaffold.py::test_wrap_project_is_deterministic` passes.",
      "definition_source": "specs/mcp-builder/requirements.md",
      "definition_line": 25
    },
    {
      "id": "US-MCP-BUILDER-R012.2",
      "kind": "requirement",
      "parent": "US-MCP-BUILDER",
      "source": "specs/mcp-builder/status.json",
      "title": "Namespaced upstream with governance",
      "delivery_state": "VERIFIED",
      "state": "verified",
      "done": true,
      "landed_in": [
        "3681cc1b8464"
      ],
      "verified_by": [
        "tests/test_mcp_builder_connector_scaffold.py:535"
      ],
      "parent_title": "US-MCP-BUILDER \u2014 The mcp-builder scaffold builds connectors on SDK components",
      "definition": "**Namespaced upstream with governance.** The generated `upstreams.py` must declare one upstream with a credential reference, a TLS profile setting and a drift fingerprint setting, and no host. The generated `governance.py` must ask for approval on every write through the SDK confirmation, refuse a scope outside the allow list before any request, return a typed refusal code for each failure and audit each write without the credential. No tool may take an `action` argument. | `tests/test_mcp_builder_connector_scaffold.py::test_wrap_mounts_the_upstream_with_governance_and_no_rest_client` passes.",
      "definition_source": "specs/mcp-builder/requirements.md",
      "definition_line": 26
    },
    {
      "id": "US-MCP-BUILDER-R012.3",
      "kind": "requirement",
      "parent": "US-MCP-BUILDER",
      "source": "specs/mcp-builder/status.json",
      "title": "The generated repository passes its own gates",
      "delivery_state": "SPECIFIED",
      "state": "specified",
      "done": false,
      "landed_in": [],
      "verified_by": [
        "tests/test_mcp_builder_connector_scaffold.py:552"
      ],
      "parent_title": "US-MCP-BUILDER \u2014 The mcp-builder scaffold builds connectors on SDK components",
      "definition": "**The generated repository passes its own gates.** The generated repository must pass its own tests with nothing skipped, including a coverage test: the served tool count must be at least the upstream count, and every served schema must be typed. It must pass `connector-name --strict` and the `connector-standard` checks. | `tests/test_mcp_builder_connector_scaffold.py::test_wrapped_repo_passes_its_own_gates` passes.",
      "definition_source": "specs/mcp-builder/requirements.md",
      "definition_line": 27
    },
    {
      "id": "US-MCP-BUILDER-R013",
      "kind": "requirement",
      "parent": "US-MCP-BUILDER",
      "source": "specs/mcp-builder/status.json",
      "title": "Deployment bundle from the same command",
      "delivery_state": "SPECIFIED",
      "state": "specified",
      "done": false,
      "landed_in": [
        "3681cc1b8464"
      ],
      "verified_by": [],
      "parent_title": "US-MCP-BUILDER \u2014 The mcp-builder scaffold builds connectors on SDK components",
      "definition": "**Deployment bundle from the same command.** Beside the repository the scaffold must write the private-registry image build, the service manifests, the workspace manifest entry and the arbora onboarding entry. Parent of R013.1 to R013.3. | Every child row passes.",
      "definition_source": "specs/mcp-builder/requirements.md",
      "definition_line": 28
    },
    {
      "id": "US-MCP-BUILDER-R013.1",
      "kind": "requirement",
      "parent": "US-MCP-BUILDER",
      "source": "specs/mcp-builder/status.json",
      "title": "Bundle layout",
      "delivery_state": "SPECIFIED",
      "state": "specified",
      "done": false,
      "landed_in": [],
      "verified_by": [
        "tests/test_mcp_builder_connector_scaffold.py:578"
      ],
      "parent_title": "US-MCP-BUILDER \u2014 The mcp-builder scaffold builds connectors on SDK components",
      "definition": "**Bundle layout.** The scaffold must write `images/<fleet>/`, `services/<fleet>/k8s/manifests.yaml`, `onboarding/<fleet>/workspace-entry.yml` and `onboarding/<fleet>/arbora-connector.yml`. | `tests/test_mcp_builder_connector_scaffold.py::test_deploy_bundle_is_emitted_beside_the_repo` passes.",
      "definition_source": "specs/mcp-builder/requirements.md",
      "definition_line": 29
    },
    {
      "id": "US-MCP-BUILDER-R013.2",
      "kind": "requirement",
      "parent": "US-MCP-BUILDER",
      "source": "specs/mcp-builder/status.json",
      "title": "No secret value and release-only image",
      "delivery_state": "SPECIFIED",
      "state": "specified",
      "done": false,
      "landed_in": [],
      "verified_by": [
        "tests/test_mcp_builder_connector_scaffold.py:591"
      ],
      "parent_title": "US-MCP-BUILDER \u2014 The mcp-builder scaffold builds connectors on SDK components",
      "definition": "**No secret value and release-only image.** The manifests must reference secrets through an ExternalSecret store key only and must mount no source. The image must install the published release and copy no source. | `tests/test_mcp_builder_connector_scaffold.py::test_deploy_bundle_holds_no_secret_value_and_installs_the_release` passes.",
      "definition_source": "specs/mcp-builder/requirements.md",
      "definition_line": 30
    },
    {
      "id": "US-MCP-BUILDER-R013.3",
      "kind": "requirement",
      "parent": "US-MCP-BUILDER",
      "source": "specs/mcp-builder/status.json",
      "title": "Site values from a deploy profile",
      "delivery_state": "SPECIFIED",
      "state": "specified",
      "done": false,
      "landed_in": [],
      "verified_by": [
        "tests/test_mcp_builder_connector_scaffold.py:611"
      ],
      "parent_title": "US-MCP-BUILDER \u2014 The mcp-builder scaffold builds connectors on SDK components",
      "definition": "**Site values from a deploy profile.** Registry, domain, namespace, secret store and CI include must come from a deploy profile. The neutral default names no real host. An unknown profile key must refuse. | `tests/test_mcp_builder_connector_scaffold.py::test_deploy_profile_supplies_site_values` passes.",
      "definition_source": "specs/mcp-builder/requirements.md",
      "definition_line": 31
    },
    {
      "id": "US-PAGES",
      "kind": "spec",
      "parent": null,
      "source": "specs/pages/status.json",
      "title": "US-PAGES \u2014 Consolidate published documentation",
      "delivery_state": "LANDED",
      "state": "landed",
      "done": false,
      "landed_in": [],
      "verified_by": [],
      "document": "specs/pages/spec.md",
      "component": "Unassigned",
      "code_refs": [
        {
          "declared_in": "specs/pages/plan.md",
          "evidence": "file exists; coverage not verified",
          "label": "spec.md",
          "repository": "Knuckles-Team/universal-skills",
          "role": "documentation",
          "url": "https://github.com/Knuckles-Team/universal-skills/blob/3681cc1b846429b2e45037dbe99fb5cf1c36e34b/specs/pages/spec.md"
        },
        {
          "declared_in": "specs/pages/plan.md",
          "evidence": "file exists; coverage not verified",
          "label": "tests/pages_contracts.py",
          "repository": "Knuckles-Team/universal-skills",
          "role": "test",
          "url": "https://github.com/Knuckles-Team/universal-skills/blob/3681cc1b846429b2e45037dbe99fb5cf1c36e34b/tests/pages_contracts.py"
        },
        {
          "declared_in": "specs/pages/spec.md",
          "evidence": "file exists; coverage not verified",
          "label": ".github/workflows/pages.yml",
          "repository": "Knuckles-Team/universal-skills",
          "role": "implementation",
          "url": "https://github.com/Knuckles-Team/universal-skills/blob/3681cc1b846429b2e45037dbe99fb5cf1c36e34b/.github/workflows/pages.yml"
        },
        {
          "declared_in": "specs/pages/spec.md",
          "evidence": "file exists; coverage not verified",
          "label": "requirements.md",
          "repository": "Knuckles-Team/universal-skills",
          "role": "documentation",
          "url": "https://github.com/Knuckles-Team/universal-skills/blob/3681cc1b846429b2e45037dbe99fb5cf1c36e34b/specs/pages/requirements.md"
        }
      ],
      "relations": [],
      "plan_diagrams": [],
      "unparsed_references": []
    },
    {
      "id": "US-PAGES-R002",
      "kind": "requirement",
      "parent": "US-PAGES",
      "source": "specs/pages/status.json",
      "title": "Consolidate published documentation",
      "delivery_state": "LANDED",
      "state": "landed",
      "done": false,
      "landed_in": [
        "0813f09b14a4",
        "a32ae4574cbf",
        "d754f30cdf82"
      ],
      "verified_by": [],
      "parent_title": "US-PAGES \u2014 Consolidate published documentation",
      "definition": "**Consolidate published documentation.** GitHub Pages serves as the readable view of this repository's skill catalog, contribution workflow, and relevant specifications, while every page's content stays sourced from one canonical tracked file in Git rather than a duplicated copy. Caller chain: .github/workflows/pages.yml:13 calls the shared `pages_pipeline.yml`, which builds MkDocs with the hook `on_files` (scripts/pages_sources.py:118); the hook publishes root guides and the spec package from their tracked files through `public_links` (scripts/pages_sources.py:16) and `status_markdown` (:41). Shape: files scripts/pages_sources.py, mkdocs.yml (`hooks` at :55) and CONTRIBUTING.md; the build holds generated pages in memory only, so no second copy exists; reuse `File.generated` of MkDocs. | A Pages build check confirms the navigation's internal links resolve and that editing the canonical tracked document updates the published view without a manual copy. Test: `tests/pages_contracts.py::test_canonical_sources_and_existing_urls` and `tests/pages_contracts.py::test_invalid_sources_fail_closed`.",
      "definition_source": "specs/pages/requirements.md",
      "definition_line": 10
    },
    {
      "id": "US-PAGES-R001",
      "kind": "requirement",
      "parent": "US-PAGES",
      "source": "specs/pages/status.json",
      "title": "Shared documentation hierarchy across the fleet's sites",
      "delivery_state": "LANDED",
      "state": "landed",
      "done": false,
      "landed_in": [
        "0dae5c7db0f2"
      ],
      "verified_by": [],
      "parent_title": "US-PAGES \u2014 Consolidate published documentation",
      "definition": "**Shared documentation hierarchy across the fleet's sites.** universal-skills' published skill catalog and specifications follow the same reusable navigation and content hierarchy, assembled from the shared Pages template and workflow, used by the documentation sites of the other core ecosystem repositories, so a reader moving between them finds the same structure. Caller chain: a push of a `v*` tag or a manual dispatch starts .github/workflows/pages.yml:13, which calls the shared `pages_pipeline.yml`; MkDocs then reads the navigation in mkdocs.yml and the hook `on_files` (scripts/pages_sources.py:118). Shape: add a navigation and link-structure check as a new test in tests/pages_contracts.py that compares the nav tree of mkdocs.yml with the shared template; align the nav entries in mkdocs.yml to that template; reuse the `checkout` and `build` fixtures (tests/pages_contracts.py:16, :48). | A cross-site navigation and link-structure check confirms this repository's published hierarchy matches the shared template used across the fleet's documentation sites. Test: planned `tests/pages_contracts.py::test_navigation_matches_shared_template` (see test-spec.md).",
      "definition_source": "specs/pages/requirements.md",
      "definition_line": 11
    },
    {
      "id": "US-SKILL-GRAPH-BUILDER",
      "kind": "spec",
      "parent": null,
      "source": "specs/skill-graph-builder/status.json",
      "title": "US-SKILL-GRAPH-BUILDER \u2014 The builder distills any source into a skill graph",
      "delivery_state": "SPECIFIED",
      "state": "specified",
      "done": false,
      "landed_in": [],
      "verified_by": [],
      "document": "specs/skill-graph-builder/spec.md",
      "component": "the `skill-graph-builder` skill.",
      "code_refs": [
        {
          "declared_in": "specs/skill-graph-builder/plan.md",
          "evidence": "file exists; coverage not verified",
          "label": "quickstart.md",
          "repository": "Knuckles-Team/universal-skills",
          "role": "documentation",
          "url": "https://github.com/Knuckles-Team/universal-skills/blob/3681cc1b846429b2e45037dbe99fb5cf1c36e34b/specs/skill-graph-builder/quickstart.md"
        },
        {
          "declared_in": "specs/skill-graph-builder/plan.md",
          "evidence": "file exists; coverage not verified",
          "label": "requirements.md",
          "repository": "Knuckles-Team/universal-skills",
          "role": "documentation",
          "url": "https://github.com/Knuckles-Team/universal-skills/blob/3681cc1b846429b2e45037dbe99fb5cf1c36e34b/specs/skill-graph-builder/requirements.md"
        },
        {
          "declared_in": "specs/skill-graph-builder/plan.md",
          "evidence": "file exists; coverage not verified",
          "label": "research.md",
          "repository": "Knuckles-Team/universal-skills",
          "role": "documentation",
          "url": "https://github.com/Knuckles-Team/universal-skills/blob/3681cc1b846429b2e45037dbe99fb5cf1c36e34b/specs/skill-graph-builder/research.md"
        },
        {
          "declared_in": "specs/skill-graph-builder/plan.md",
          "evidence": "file exists; coverage not verified",
          "label": "spec.md",
          "repository": "Knuckles-Team/universal-skills",
          "role": "documentation",
          "url": "https://github.com/Knuckles-Team/universal-skills/blob/3681cc1b846429b2e45037dbe99fb5cf1c36e34b/specs/skill-graph-builder/spec.md"
        },
        {
          "declared_in": "specs/skill-graph-builder/plan.md",
          "evidence": "file exists; coverage not verified",
          "label": "tests/test_skill_graph_builder.py",
          "repository": "Knuckles-Team/universal-skills",
          "role": "test",
          "url": "https://github.com/Knuckles-Team/universal-skills/blob/3681cc1b846429b2e45037dbe99fb5cf1c36e34b/tests/test_skill_graph_builder.py"
        },
        {
          "declared_in": "specs/skill-graph-builder/spec.md",
          "evidence": "file exists; coverage not verified",
          "label": "crawl-source",
          "repository": "Knuckles-Team/universal-skills",
          "role": "documentation",
          "url": "https://github.com/Knuckles-Team/universal-skills/blob/3681cc1b846429b2e45037dbe99fb5cf1c36e34b/specs/skill-graph-builder/contracts/crawl-source.md"
        },
        {
          "declared_in": "specs/skill-graph-builder/spec.md",
          "evidence": "file exists; coverage not verified",
          "label": "graph-output",
          "repository": "Knuckles-Team/universal-skills",
          "role": "documentation",
          "url": "https://github.com/Knuckles-Team/universal-skills/blob/3681cc1b846429b2e45037dbe99fb5cf1c36e34b/specs/skill-graph-builder/contracts/graph-output.md"
        }
      ],
      "relations": [
        {
          "declared_in": "specs/skill-graph-builder/spec.md",
          "evidence": "local spec declaration",
          "kind": "depends on",
          "label": "US-WEB-RESEARCH-R001",
          "repository": "Knuckles-Team/universal-skills",
          "url": "https://github.com/Knuckles-Team/universal-skills/blob/3681cc1b846429b2e45037dbe99fb5cf1c36e34b/specs/web-research/spec.md"
        },
        {
          "declared_in": "specs/skill-graph-builder/spec.md",
          "evidence": "missing source",
          "kind": "depends on",
          "label": "SG-CONTENT-R002`.",
          "repository": "Unresolved",
          "url": ""
        }
      ],
      "plan_diagrams": [],
      "unparsed_references": []
    },
    {
      "id": "US-SKILL-GRAPH-BUILDER-R001",
      "kind": "requirement",
      "parent": "US-SKILL-GRAPH-BUILDER",
      "source": "specs/skill-graph-builder/status.json",
      "title": "The builder turns any source into a standard skill graph (rollup)",
      "delivery_state": "SPECIFIED",
      "state": "specified",
      "done": false,
      "landed_in": [],
      "verified_by": [],
      "parent_title": "US-SKILL-GRAPH-BUILDER \u2014 The builder distills any source into a skill graph",
      "definition": "**The builder turns any source into a standard skill graph (rollup).** The `skill-graph-builder` skill is the only producer of the graphs in `skill-graphs`. Its CLI `scripts/generate_skill.py` classifies the sources, hands them to the pipeline and flattens the result. Children `.1` to `.4` deliver it. | See each child.",
      "definition_source": "specs/skill-graph-builder/requirements.md",
      "definition_line": 7
    },
    {
      "id": "US-SKILL-GRAPH-BUILDER-R001.1",
      "kind": "requirement",
      "parent": "US-SKILL-GRAPH-BUILDER",
      "source": "specs/skill-graph-builder/status.json",
      "title": "Graph name",
      "delivery_state": "SPECIFIED",
      "state": "specified",
      "done": false,
      "landed_in": [],
      "verified_by": [
        "tests/test_skill_graph_builder.py:71"
      ],
      "parent_title": "US-SKILL-GRAPH-BUILDER \u2014 The builder distills any source into a skill graph",
      "definition": "**Graph name.** Caller chain: `main` \u2192 `generate_skill`. Shape: a name that does not end in `-docs` gets the suffix, then `_portable_name` limits each path component to 80 characters with a digest. | `tests/test_skill_graph_builder.py::test_graph_name_gets_docs_suffix_and_is_portable` (bound).",
      "definition_source": "specs/skill-graph-builder/requirements.md",
      "definition_line": 8
    },
    {
      "id": "US-SKILL-GRAPH-BUILDER-R001.2",
      "kind": "requirement",
      "parent": "US-SKILL-GRAPH-BUILDER",
      "source": "specs/skill-graph-builder/status.json",
      "title": "Source kinds",
      "delivery_state": "SPECIFIED",
      "state": "specified",
      "done": false,
      "landed_in": [],
      "verified_by": [
        "tests/test_skill_graph_builder.py:90"
      ],
      "parent_title": "US-SKILL-GRAPH-BUILDER \u2014 The builder distills any source into a skill graph",
      "definition": "**Source kinds.** Caller chain: `generate_skill` \u2192 `_classify_sources`. Shape: a comma-separated source list maps each item to a `SourceSpec`. An http(s) URL is `web`, a `.pdf` is `pdf`, other office extensions (`.docx`, `.pptx`, `.xlsx`, `.csv`) are `office`, anything else is `dir`. | `tests/test_skill_graph_builder.py::test_sources_are_classified_by_kind` (bound).",
      "definition_source": "specs/skill-graph-builder/requirements.md",
      "definition_line": 9
    },
    {
      "id": "US-SKILL-GRAPH-BUILDER-R001.3",
      "kind": "requirement",
      "parent": "US-SKILL-GRAPH-BUILDER",
      "source": "specs/skill-graph-builder/status.json",
      "title": "Flat portable corpus",
      "delivery_state": "VERIFIED",
      "state": "verified",
      "done": true,
      "landed_in": [
        "49883800ee93"
      ],
      "verified_by": [
        "tests/test_skill_graph_builder.py:110"
      ],
      "parent_title": "US-SKILL-GRAPH-BUILDER \u2014 The builder distills any source into a skill graph",
      "definition": "**Flat portable corpus.** Caller chain: `generate_skill` \u2192 `_flatten_reference_tree`. Shape: every `reference/**/*.md` moves to `reference/<sha256(url or title)[:8]>.md` (12 then 16 characters on a collision). `index.json` sections, `sources.json` files and the `SKILL.md` links follow the move. | `tests/test_skill_graph_builder.py::test_flatten_hashes_names_and_repoints_the_manifests` (bound).",
      "definition_source": "specs/skill-graph-builder/requirements.md",
      "definition_line": 10
    },
    {
      "id": "US-SKILL-GRAPH-BUILDER-R001.4",
      "kind": "requirement",
      "parent": "US-SKILL-GRAPH-BUILDER",
      "source": "specs/skill-graph-builder/status.json",
      "title": "Output target",
      "delivery_state": "SPECIFIED",
      "state": "specified",
      "done": false,
      "landed_in": [],
      "verified_by": [
        "tests/test_skill_graph_builder.py:142"
      ],
      "parent_title": "US-SKILL-GRAPH-BUILDER \u2014 The builder distills any source into a skill graph",
      "definition": "**Output target.** Caller chain: `generate_skill` \u2192 `_resolve_out_dir`. Shape: `--output-dir` wins. Otherwise the target is `skill_graphs/skills` of the sibling `skill-graphs` checkout, so the graph is served by `SG-CONTENT-R001.2`. Without that checkout the target is `~/.cache/universal-skills/skill-graphs`. | `tests/test_skill_graph_builder.py::test_output_goes_to_the_graph_collection_or_the_cache` (bound).",
      "definition_source": "specs/skill-graph-builder/requirements.md",
      "definition_line": 11
    },
    {
      "id": "US-SKILL-GRAPH-BUILDER-R002",
      "kind": "requirement",
      "parent": "US-SKILL-GRAPH-BUILDER",
      "source": "specs/skill-graph-builder/status.json",
      "title": "Web sources come from the web-crawler skill (rollup)",
      "delivery_state": "SPECIFIED",
      "state": "specified",
      "done": false,
      "landed_in": [],
      "verified_by": [],
      "parent_title": "US-SKILL-GRAPH-BUILDER \u2014 The builder distills any source into a skill graph",
      "definition": "**Web sources come from the web-crawler skill (rollup).** The `web-crawler` skill is the one page scraper of this repository; no `web-scraper` skill exists (`US-WEB-RESEARCH-R001`). The builder fetches a `web` source only through it. Children `.1` and `.2` deliver it. | See each child.",
      "definition_source": "specs/skill-graph-builder/requirements.md",
      "definition_line": 12
    },
    {
      "id": "US-SKILL-GRAPH-BUILDER-R002.1",
      "kind": "requirement",
      "parent": "US-SKILL-GRAPH-BUILDER",
      "source": "specs/skill-graph-builder/status.json",
      "title": "Crawl through the skill script",
      "delivery_state": "SPECIFIED",
      "state": "specified",
      "done": false,
      "landed_in": [],
      "verified_by": [
        "tests/test_skill_graph_builder.py:156"
      ],
      "parent_title": "US-SKILL-GRAPH-BUILDER \u2014 The builder distills any source into a skill graph",
      "definition": "**Crawl through the skill script.** Caller chain: `generate_skill` (`universal_skills/skills/skill-graph-builder/scripts/generate_skill.py:296`) \u2192 `SkillGraphPipeline(crawler_fn=_make_crawler_fn(...))` (`universal_skills/skills/skill-graph-builder/scripts/generate_skill.py:338`) \u2192 `crawler_fn` (`universal_skills/skills/skill-graph-builder/scripts/generate_skill.py:214`). Shape: the function runs `universal_skills/skills/web-crawler/scripts/crawl.py` (resolved by `_crawl_script`, `universal_skills/skills/skill-graph-builder/scripts/generate_skill.py:203`; run at `universal_skills/skills/skill-graph-builder/scripts/generate_skill.py:239`) with `--urls`, `--strategy recursive`, `--output-dir`, `--max-depth` and `--max-pages`. It forwards `--disable-magic-js`, `--no-sitemap` and `--wait-for`. It returns one `AcquiredDoc` per written markdown file. | `tests/test_skill_graph_builder.py::test_web_sources_are_fetched_by_the_web_crawler_skill` (bound).",
      "definition_source": "specs/skill-graph-builder/requirements.md",
      "definition_line": 13
    },
    {
      "id": "US-SKILL-GRAPH-BUILDER-R002.2",
      "kind": "requirement",
      "parent": "US-SKILL-GRAPH-BUILDER",
      "source": "specs/skill-graph-builder/status.json",
      "title": "Follow the served web operation",
      "delivery_state": "SPECIFIED",
      "state": "specified",
      "done": false,
      "landed_in": [],
      "verified_by": [],
      "parent_title": "US-SKILL-GRAPH-BUILDER \u2014 The builder distills any source into a skill graph",
      "definition": "**Follow the served web operation.** Caller chain: as `R002.1`. Shape: once `crawl.py` calls `research.web` (`US-WEB-RESEARCH-R001.1`), `crawler_fn` passes `--output-dir` and the skill writes one `<sha256(url)[:8]>.md` per cited page. The page text is the stored chunk text of each cited Document (`ARBORA-OPS-R067.1`). The builder keeps no HTTP client. Depends on: `US-WEB-RESEARCH-R001.1`. | `tests/test_skill_graph_builder_served.py::test_web_source_is_built_from_research_web_documents` (planned, see test-spec).",
      "definition_source": "specs/skill-graph-builder/requirements.md",
      "definition_line": 14
    },
    {
      "id": "US-SKILL-GRAPH-BUILDER-R003",
      "kind": "requirement",
      "parent": "US-SKILL-GRAPH-BUILDER",
      "source": "specs/skill-graph-builder/status.json",
      "title": "A graph records its provenance and its ontology layer (rollup)",
      "delivery_state": "SPECIFIED",
      "state": "specified",
      "done": false,
      "landed_in": [],
      "verified_by": [],
      "parent_title": "US-SKILL-GRAPH-BUILDER \u2014 The builder distills any source into a skill graph",
      "definition": "**A graph records its provenance and its ontology layer (rollup).** The builder writes the records that `SG-CONTENT-R002` checks and the concept layer that `SG-CONTENT-R003` stores. Children `.1` and `.2` deliver it. | See each child.",
      "definition_source": "specs/skill-graph-builder/requirements.md",
      "definition_line": 15
    },
    {
      "id": "US-SKILL-GRAPH-BUILDER-R003.1",
      "kind": "requirement",
      "parent": "US-SKILL-GRAPH-BUILDER",
      "source": "specs/skill-graph-builder/status.json",
      "title": "Provenance record",
      "delivery_state": "SPECIFIED",
      "state": "specified",
      "done": false,
      "landed_in": [],
      "verified_by": [],
      "parent_title": "US-SKILL-GRAPH-BUILDER \u2014 The builder distills any source into a skill graph",
      "definition": "**Provenance record.** Caller chain: `generate_skill` (`universal_skills/skills/skill-graph-builder/scripts/generate_skill.py:296`) \u2192 `pipe.build` (`universal_skills/skills/skill-graph-builder/scripts/generate_skill.py:343`) \u2192 `write_sources_manifest` (planned, new file `universal_skills/skill_graph_pipeline/manifest.py`; the package does not exist until `US-SKILL-GRAPH-BUILDER-R004.1` lands). Shape: `sources.json` holds schema `skill-graph-sources/v1`, `builder_version`, `built_at`, per-source `{kind, uri, options, extractor, fetched_at, content_hash, doc_count}` and per-file `{path, sha256, bytes}`. `SKILL.md` declares `skill_type: graph`. Depends on: `US-SKILL-GRAPH-BUILDER-R004.1`. | `tests/test_skill_graph_builder_pipeline.py::test_build_writes_manifest_and_graph_type` (planned, see test-spec).",
      "definition_source": "specs/skill-graph-builder/requirements.md",
      "definition_line": 16
    },
    {
      "id": "US-SKILL-GRAPH-BUILDER-R003.2",
      "kind": "requirement",
      "parent": "US-SKILL-GRAPH-BUILDER",
      "source": "specs/skill-graph-builder/status.json",
      "title": "Ontology layer emission",
      "delivery_state": "SPECIFIED",
      "state": "specified",
      "done": false,
      "landed_in": [],
      "verified_by": [],
      "parent_title": "US-SKILL-GRAPH-BUILDER \u2014 The builder distills any source into a skill graph",
      "definition": "**Ontology layer emission.** Caller chain: `generate_skill` (`universal_skills/skills/skill-graph-builder/scripts/generate_skill.py:296`) \u2192 `pipe.build` (`universal_skills/skills/skill-graph-builder/scripts/generate_skill.py:343`) \u2192 `write_ontology_module` (planned, new file `universal_skills/skill_graph_pipeline/ontology.py`; the package does not exist until `US-SKILL-GRAPH-BUILDER-R004.1` lands). Shape: when the build extracts concepts, it writes `skill_graphs/ontology/<graph>.ttl` with ontology IRI `http://knuckles.team/kg/skillgraph/<graph>`. Each class is `rdfs:subClassOf` a class of `http://knuckles.team/kg`. The file has no `owl:imports`. It sets `kg_ontology` to the file stem and lists the class IRIs in `concepts`. Without concepts both stay `null` and empty. Depends on: `SG-CONTENT-R003.1`, `SG-CONTENT-R003.2`, `US-SKILL-GRAPH-BUILDER-R004.1`. | `tests/test_skill_graph_builder_pipeline.py::test_build_writes_core_rooted_ontology_module` (planned, see test-spec).",
      "definition_source": "specs/skill-graph-builder/requirements.md",
      "definition_line": 17
    },
    {
      "id": "US-SKILL-GRAPH-BUILDER-R004",
      "kind": "requirement",
      "parent": "US-SKILL-GRAPH-BUILDER",
      "source": "specs/skill-graph-builder/status.json",
      "title": "The builder runs on current owners only (rollup)",
      "delivery_state": "SPECIFIED",
      "state": "specified",
      "done": false,
      "landed_in": [],
      "verified_by": [],
      "parent_title": "US-SKILL-GRAPH-BUILDER \u2014 The builder distills any source into a skill graph",
      "definition": "**The builder runs on current owners only (rollup).** `generate_skill.py` imports the retired `agent_utilities` package, so the builder cannot run in a clean environment. The pipeline moves into this repository, and graph ingestion becomes the engine pack import. Children `.1` and `.2` deliver it. | See each child.",
      "definition_source": "specs/skill-graph-builder/requirements.md",
      "definition_line": 18
    },
    {
      "id": "US-SKILL-GRAPH-BUILDER-R004.1",
      "kind": "requirement",
      "parent": "US-SKILL-GRAPH-BUILDER",
      "source": "specs/skill-graph-builder/status.json",
      "title": "Own the pipeline",
      "delivery_state": "SPECIFIED",
      "state": "specified",
      "done": false,
      "landed_in": [],
      "verified_by": [],
      "parent_title": "US-SKILL-GRAPH-BUILDER \u2014 The builder distills any source into a skill graph",
      "definition": "**Own the pipeline.** Caller chain: `generate_skill` \u2192 `SkillGraphPipeline.build`. Shape: new package `universal_skills/skill_graph_pipeline/` holds `SourceSpec`, `AcquiredDoc` and `SkillGraphPipeline` with the verbs `build`, `distill`, `restyle`, `status`, `refresh`, `rebuild`. The script imports it from there. No module of the repository imports `agent_utilities`. Refusal: the test fails on any `agent_utilities` import under `universal_skills/skills/skill-graph-builder`. | `tests/test_skill_graph_builder_pipeline.py::test_builder_imports_no_retired_package` (planned, see test-spec).",
      "definition_source": "specs/skill-graph-builder/requirements.md",
      "definition_line": 19
    },
    {
      "id": "US-SKILL-GRAPH-BUILDER-R004.2",
      "kind": "requirement",
      "parent": "US-SKILL-GRAPH-BUILDER",
      "source": "specs/skill-graph-builder/status.json",
      "title": "Delete the daemon enrichment and the retired flags",
      "delivery_state": "SPECIFIED",
      "state": "specified",
      "done": false,
      "landed_in": [],
      "verified_by": [],
      "parent_title": "US-SKILL-GRAPH-BUILDER \u2014 The builder distills any source into a skill graph",
      "definition": "**Delete the daemon enrichment and the retired flags.** Caller chain: `main` \u2192 `generate_skill`. Shape: the flags `--no-kg`, `--ingest-kg`, `--append` and the `kg_enrich` argument are deleted. The builder writes the offline corpus only. The engine ingests it as a pack (`MEDULLA-TYPED-PACKS-R701`). `sources.json` keeps `kg_ingested` out. Depends on: `MEDULLA-TYPED-PACKS-R701`. | `tests/test_skill_graph_builder_pipeline.py::test_retired_flags_are_refused` (planned, see test-spec).",
      "definition_source": "specs/skill-graph-builder/requirements.md",
      "definition_line": 20
    },
    {
      "id": "US-WEB-RESEARCH",
      "kind": "spec",
      "parent": null,
      "source": "specs/web-research/status.json",
      "title": "US-WEB-RESEARCH \u2014 Web research skills call the served operation",
      "delivery_state": "SPECIFIED",
      "state": "specified",
      "done": false,
      "landed_in": [],
      "verified_by": [],
      "document": "specs/web-research/spec.md",
      "component": "Unassigned",
      "code_refs": [
        {
          "declared_in": "specs/web-research/plan.md",
          "evidence": "file exists; coverage not verified",
          "label": "spec.md",
          "repository": "Knuckles-Team/universal-skills",
          "role": "documentation",
          "url": "https://github.com/Knuckles-Team/universal-skills/blob/3681cc1b846429b2e45037dbe99fb5cf1c36e34b/specs/web-research/spec.md"
        },
        {
          "declared_in": "specs/web-research/plan.md",
          "evidence": "file exists; coverage not verified",
          "label": "universal_skills/skills/web-crawler/scripts/crawl.py",
          "repository": "Knuckles-Team/universal-skills",
          "role": "implementation",
          "url": "https://github.com/Knuckles-Team/universal-skills/blob/3681cc1b846429b2e45037dbe99fb5cf1c36e34b/universal_skills/skills/web-crawler/scripts/crawl.py"
        },
        {
          "declared_in": "specs/web-research/spec.md",
          "evidence": "file exists; coverage not verified",
          "label": "requirements.md",
          "repository": "Knuckles-Team/universal-skills",
          "role": "documentation",
          "url": "https://github.com/Knuckles-Team/universal-skills/blob/3681cc1b846429b2e45037dbe99fb5cf1c36e34b/specs/web-research/requirements.md"
        },
        {
          "declared_in": "specs/web-research/spec.md",
          "evidence": "file exists; coverage not verified",
          "label": "test-spec.md",
          "repository": "Knuckles-Team/universal-skills",
          "role": "documentation",
          "url": "https://github.com/Knuckles-Team/universal-skills/blob/3681cc1b846429b2e45037dbe99fb5cf1c36e34b/specs/web-research/test-spec.md"
        }
      ],
      "relations": [
        {
          "declared_in": "specs/web-research/spec.md",
          "evidence": "external declaration; not verified",
          "kind": "references",
          "label": "ARBORA-OPS",
          "repository": "Knuckles-Team/arbora",
          "url": "https://github.com/Knuckles-Team/arbora/blob/main/specs/hosted-api-operations/spec.md"
        }
      ],
      "plan_diagrams": [],
      "unparsed_references": []
    },
    {
      "id": "US-WEB-RESEARCH-R001",
      "kind": "requirement",
      "parent": "US-WEB-RESEARCH",
      "source": "specs/web-research/status.json",
      "title": "The web-crawler skill is a thin skill over `research.web` (rollup)",
      "delivery_state": "SPECIFIED",
      "state": "specified",
      "done": false,
      "landed_in": [],
      "verified_by": [],
      "parent_title": "US-WEB-RESEARCH \u2014 Web research skills call the served operation",
      "definition": "**The web-crawler skill is a thin skill over `research.web` (rollup).** No skill named `web-scraper` exists. The `web-crawler` skill is the page scraper of this repository. It must call the arbora operation `research.web` (`ARBORA-OPS-R067`). It must hold no page fetch, render, crawl or extraction code. Children `.1` to `.5` deliver it. | See each child.",
      "definition_source": "specs/web-research/requirements.md",
      "definition_line": 9
    },
    {
      "id": "US-WEB-RESEARCH-R001.1",
      "kind": "requirement",
      "parent": "US-WEB-RESEARCH",
      "source": "specs/web-research/status.json",
      "title": "Call the operation",
      "delivery_state": "SPECIFIED",
      "state": "specified",
      "done": false,
      "landed_in": [],
      "verified_by": [],
      "parent_title": "US-WEB-RESEARCH \u2014 Web research skills call the served operation",
      "definition": "**Call the operation.** `universal_skills/skills/web-crawler/scripts/crawl.py` must call `research.web` through `arbora.client`. A `--query` argument maps to `query`. A `--urls` argument maps to `urls`. `--backend` maps to `backend`. The script prints the Document IDs with their citations. Proving test: `tests/test_web_research_skill.py::test_crawl_calls_research_web`. Caller chain: an agent follows universal_skills/skills/web-crawler/SKILL.md and runs `crawl.py`; `main` (universal_skills/skills/web-crawler/scripts/crawl.py:946) parses `--urls` and today drives the local crawler (:1241 builds `KGIngestor`). The target chain is `main` \u2192 `invoke` (arbora/client/invoke.py:17 in the arbora package) with the operation `research.web`. Shape: replace `main` in crawl.py with an argparse shell of about 40 lines that maps `--query`, `--urls` and `--backend` to the operation arguments and prints each Document ID with its citation; reuse `invoke` and `OperationError` (arbora/client/http.py:21) and add no HTTP client. | One script run sends one `research.web` call with the mapped arguments. Test: planned `tests/test_web_research_skill.py::test_crawl_calls_research_web` (see test-spec.md).",
      "definition_source": "specs/web-research/requirements.md",
      "definition_line": 10
    },
    {
      "id": "US-WEB-RESEARCH-R001.2",
      "kind": "requirement",
      "parent": "US-WEB-RESEARCH",
      "source": "specs/web-research/status.json",
      "title": "Delete local scraping",
      "delivery_state": "SPECIFIED",
      "state": "specified",
      "done": false,
      "landed_in": [],
      "verified_by": [],
      "parent_title": "US-WEB-RESEARCH \u2014 Web research skills call the served operation",
      "definition": "**Delete local scraping.** The skill must delete the HTTP, browser, `robots.txt`, sitemap and markdown code in `crawl.py` and `scripts/security_runtime.py`. `SKILL.md` must describe only the operation call. Proving test: `tests/test_web_research_skill.py::test_skill_has_no_http_client`. Caller chain: the same `main` (universal_skills/skills/web-crawler/scripts/crawl.py:946) today reaches `SafeHttpCrawler`, the sitemap and markdown helpers and `security_runtime.py` (universal_skills/skills/web-crawler/scripts/security_runtime.py:117 `CrawlerSecurityPolicy`). Shape: delete those definitions from crawl.py (1,360 lines) and delete security_runtime.py (478 lines); rewrite SKILL.md to describe only the `research.web` call; delete tests/test_web_crawler_security.py with the code it covers. | The test finds no HTTP client, browser driver or HTML parser import in the skill scripts. Test: planned `tests/test_web_research_skill.py::test_skill_has_no_http_client` (see test-spec.md).",
      "definition_source": "specs/web-research/requirements.md",
      "definition_line": 11
    },
    {
      "id": "US-WEB-RESEARCH-R001.3",
      "kind": "requirement",
      "parent": "US-WEB-RESEARCH",
      "source": "specs/web-research/status.json",
      "title": "Alias",
      "delivery_state": "SPECIFIED",
      "state": "specified",
      "done": false,
      "landed_in": [],
      "verified_by": [],
      "parent_title": "US-WEB-RESEARCH \u2014 Web research skills call the served operation",
      "definition": "**Alias.** The `web-fetch` skill must forward to `web-crawler` with one URL and `max_pages` 1. It must hold no code of its own beyond the forward. Proving test: `tests/test_web_research_skill.py::test_web_fetch_forwards`. Caller chain: an agent runs `fetch.py` of the `web-fetch` skill; `main` (universal_skills/skills/web-fetch/scripts/fetch.py:48) calls `fetch_page` (:34), which loads the crawler runtime through `_crawler_runtime` (:19). Shape: replace `fetch_page` with a call to the new `crawl.py` entry using one URL and `max_pages` 1, and delete `_crawler_runtime`; the file holds no other code. | A `web-fetch` run sends one `research.web` call with one URL. Test: planned `tests/test_web_research_skill.py::test_web_fetch_forwards` (see test-spec.md).",
      "definition_source": "specs/web-research/requirements.md",
      "definition_line": 12
    },
    {
      "id": "US-WEB-RESEARCH-R001.4",
      "kind": "requirement",
      "parent": "US-WEB-RESEARCH",
      "source": "specs/web-research/status.json",
      "title": "Refusal",
      "delivery_state": "SPECIFIED",
      "state": "specified",
      "done": false,
      "landed_in": [],
      "verified_by": [],
      "parent_title": "US-WEB-RESEARCH \u2014 Web research skills call the served operation",
      "definition": "**Refusal.** The skill must print the refusal code of the operation and exit with status 2. It must not fall back to a local fetch. Proving test: `tests/test_web_research_skill.py::test_refusal_exits_without_fallback`. Caller chain: `main` of the new crawl.py (universal_skills/skills/web-crawler/scripts/crawl.py:946) awaits `invoke` and catches `OperationError` (arbora/client/http.py:21). Shape: print the refusal code, return exit status 2 and catch nothing else; no branch calls a local fetch. | A refused call exits 2 and makes no other network call. Test: planned `tests/test_web_research_skill.py::test_refusal_exits_without_fallback` (see test-spec.md).",
      "definition_source": "specs/web-research/requirements.md",
      "definition_line": 13
    },
    {
      "id": "US-WEB-RESEARCH-R001.5",
      "kind": "requirement",
      "parent": "US-WEB-RESEARCH",
      "source": "specs/web-research/status.json",
      "title": "Hot-path proof",
      "delivery_state": "SPECIFIED",
      "state": "specified",
      "done": false,
      "landed_in": [],
      "verified_by": [],
      "parent_title": "US-WEB-RESEARCH \u2014 Web research skills call the served operation",
      "definition": "**Hot-path proof.** The test runs `crawl.py` against a fixture arbora server that serves `research.web`. It denies every other network destination. Proving test: `tests/test_web_research_skill_served.py::test_skill_reaches_research_web_only`. Caller chain: the test starts a fixture arbora server on loopback, sets the arbora base URL, runs `main` (universal_skills/skills/web-crawler/scripts/crawl.py:946) as a subprocess and denies every other destination. Shape: new tests/test_web_research_skill_served.py with the fixture server in the same file; the served operation is `research.web` of `ARBORA-OPS-R067`. | The fixture receives one call, and the skill makes no other network request. Test: planned `tests/test_web_research_skill_served.py::test_skill_reaches_research_web_only` (see test-spec.md).",
      "definition_source": "specs/web-research/requirements.md",
      "definition_line": 14
    }
  ],
  "github": {
    "issues": {
      "available": true,
      "items": []
    },
    "pull_requests": {
      "available": true,
      "items": []
    }
  },
  "spec_edges": [
    [
      "US-CONTENT",
      "depends on",
      "SCION-CONNECTOR-CONTROL-R071.1"
    ],
    [
      "US-CONTENT",
      "references",
      "SCION-CONNECTOR-CONTROL"
    ],
    [
      "US-MCP-BUILDER",
      "references",
      "https://github.com/Knuckles-Team/scion-sdk/blob/main/specs/centralized-capabilities/spec.md"
    ],
    [
      "US-SKILL-GRAPH-BUILDER",
      "depends on",
      "SG-CONTENT-R002`."
    ],
    [
      "US-SKILL-GRAPH-BUILDER",
      "depends on",
      "US-WEB-RESEARCH"
    ],
    [
      "US-WEB-RESEARCH",
      "references",
      "https://github.com/Knuckles-Team/arbora/blob/main/specs/hosted-api-operations/spec.md"
    ]
  ]
}
