DIIG phases, steps and resources chart

Draw a DIIG “phases, steps and resources” chart as SVG from diig-phases-figure/v1 data on a who-iris library entry (DIIG Fig. 1.1.1, or a handbook’s republished version such as the product catalogue handbook’s Fig. 4), or from a folio’s diig-phases-adaptation/v1 file that adds its own tiles and marks itself “(this document)”. Every label comes from the data; tiles link to their library entry or glossary concept.

Skills it satisfies

A skill states the capability; this Tool is one way to exercise it. Each skill’s declared input and output contract follows, where it has one.

figure-rebuild

Turn a figure into a computable diagram: every figure of a source publication when a folio is built from its L1 entry, and any hand-drawn figure in a folio, an IG or a demonstrator that is redrawn from a source. Every declared figure gets a block, and each one is rebuilt in the form its type calls for: an ArchiMate view, BPMN, DMN, a FHIR logical model, or an SVG generated from data, always from one schema-backed source. The PDF crop stays beside the rebuild as the cited source, and the rebuild keeps the original’s layout. The figure-coverage check counts what is missing and what is still only a picture.

Source: folio-assistant-core/skills/library/ingestion/figure-rebuild.md.

Also satisfied by: figure-coverage, smart-approach-svg.

The skill declares no I/O contract (schemas/skills/figure-rebuild/{input,output}.schema.json).

Inputs and outputs

Each port names a shared type by IRI, so two Tools for one skill can be checked for interchangeability.

porttyperequireddescriptionconstraint
infigure-or-adaptationRepoPathyesA diig-phases-figure/v1 file, or a diig-phases-adaptation/v1 file whose adapts is a repository-root path to one.string · pattern ^[A-Za-z0-9._][A-Za-z0-9._/-]*$ · A path relative to the repository root. No .. segments.
inoutRepoPathWhere to write the SVG; stdout when absent.string · pattern ^[A-Za-z0-9._][A-Za-z0-9._/-]*$ · A path relative to the repository root. No .. segments.
outsvgRepoPathThe chart, with text as SVG text, one <g id="tile-<resource>"> per tile.string · pattern ^[A-Za-z0-9._][A-Za-z0-9._/-]*$ · A path relative to the repository root. No .. segments.

Processes and tasks

No process step names a skill this Tool satisfies.

How it is deployed and reached

  • Command line. From the repository root: bun run folio-assistant-core/scripts/diig-phases-svg.ts.
  • GitHub Actions. No workflow in this checkout runs its command.

As an API: its operation in the OpenAPI document and the MCP tool list of its layer.

installnone
runtimebun
networkno
when to choose it
whenA folio shows the DIIG phases chart (every Digital Transformation Handbook does) and should draw it from the one transcription instead of a picture or a hand-kept copy.
limitsDraws the seven-row DIIG layout only. Whether the transcription matches the published figure is a person’s review of the data.
costReads one or two JSON files; no network.

What it is made of

Linked data

The Tool is published as its own JSON-LD document at its IRI, https://litlfred.github.io/folio-assistant/folio-assistant-core/tools/diig-phases-svg.jsonld, partOf its layer’s document. The node below is the definition this page was drawn from, and is embedded in the page as application/ld+json.

{
  "@context": "https://litlfred.github.io/folio-assistant/folio-assistant-core/folio-assistant-core.context.jsonld",
  "@id": "https://litlfred.github.io/folio-assistant/folio-assistant-core/tools/diig-phases-svg.jsonld",
  "@type": "https://litlfred.github.io/cat-harness/v0/ns/Tool",
  "partOf": "https://litlfred.github.io/folio-assistant/folio-assistant-core/folio-assistant-core.jsonld",
  "name": "diig-phases-svg",
  "title": "DIIG phases, steps and resources chart",
  "description": "Draw a DIIG \"phases, steps and resources\" chart as SVG from `diig-phases-figure/v1` data on a who-iris library entry (DIIG Fig. 1.1.1, or a handbook's republished version such as the product catalogue handbook's Fig. 4), or from a folio's `diig-phases-adaptation/v1` file that adds its own tiles and marks itself \"(this document)\". Every label comes from the data; tiles link to their library entry or glossary concept.",
  "install": {
    "none": true
  },
  "invoke": {
    "shell": "bun run folio-assistant-core/scripts/diig-phases-svg.ts"
  },
  "io": {
    "inputs": [
      {
        "name": "figure-or-adaptation",
        "schema": "https://litlfred.github.io/folio-assistant/cat-harness/tool-types.schema.json#/$defs/RepoPath",
        "description": "A diig-phases-figure/v1 file, or a diig-phases-adaptation/v1 file whose `adapts` is a repository-root path to one.",
        "required": true,
        "arg": {
          "positional": 0
        }
      },
      {
        "name": "out",
        "schema": "https://litlfred.github.io/folio-assistant/cat-harness/tool-types.schema.json#/$defs/RepoPath",
        "description": "Where to write the SVG; stdout when absent.",
        "required": false,
        "arg": {
          "flag": "--out"
        }
      }
    ],
    "outputs": [
      {
        "name": "svg",
        "schema": "https://litlfred.github.io/folio-assistant/cat-harness/tool-types.schema.json#/$defs/RepoPath",
        "description": "The chart, with text as SVG text, one `<g id=\"tile-<resource>\">` per tile."
      }
    ]
  },
  "satisfies": [
    "figure-rebuild"
  ],
  "requirements": {
    "runtime": [
      "bun"
    ],
    "network": false
  },
  "selection": {
    "when": "A folio shows the DIIG phases chart (every Digital Transformation Handbook does) and should draw it from the one transcription instead of a picture or a hand-kept copy.",
    "limits": "Draws the seven-row DIIG layout only. Whether the transcription matches the published figure is a person's review of the data.",
    "cost": "Reads one or two JSON files; no network."
  }
}

folio-assistant — code under the Apache License 2.0, documentation under CC BY 3.0. Generated schema and API references are rebuilt from source on every push to main.

deployed dev