/tia-openness-roadmap

name: tia-openness-roadmap
description: >
  Entry point for TIA Portal engineering automation tasks. Routes to the requested
  or appropriate MCP, Python, C#, MAC Module Builder, diagnostic, or Add-In
  implementation. Pure review of already supplied/exported PLC code uses the
  standalone plc-code-analysis skill.
license: MIT

tia-openness-roadmap

Goal

Route the task to the correct implementation path and load the right skill files.

Mandatory policy

1. Honor the user's explicit implementation and scope constraints (including a request to skip MCP, Python, C#, or live operations). 2. Otherwise prefer **TIA Portal MCP** for interactive, single-step read/write operations when available. 3. Prefer **TIA Scripting Python** for scripted/multi-step automation only when the exact wrapper operation is documented. 4. Use **C# TIA Portal Openness** when requested or when its exact installed API is the appropriate/required surface. 5. Use **MAC Module Builder** for Modular Application Creator modules, lifecycle phases, `.tiares`, generated/custom ownership, and MAC packaging or qualification. 6. Do not invent wrapper, Openness, MAC, or Module Builder methods. 7. For multi-domain tasks, select all required skills.

Standalone analysis exclusion

For review/security/quality analysis of pasted or exported PLC code, use `plc-code-analysis` as a standalone skill and do not load this roadmap. That skill accepts raw SCL/ST, SIMATIC SD, and SimaticML without authorizing engineering writes or live TIA operations.

Implementation paths

MCP path

Direct tool calls — no code generation. Use when the TIA Portal MCP server is available.

| Skill | Location | |---|---| | `tia-portal-mcp` | `skills/tia-portal-mcp/SKILL.md` |

Python path

Single skill owns all Python implementation:

| Skill | Location | |---|---| | `tia-python` | `skills/tia-python/SKILL.md` |

`tia-python` contains its own reference file table that routes to the correct `references/*.md` file based on the task domain (PLC, HMI, library, project, portal).

C# path

Always starts with the common foundation skill, then domain skill(s):

| Skill | Location | Role | |---|---|---| | `tia-csharp-common` | `skills/tia-csharp-common/SKILL.md` | Mandatory first load for every C# task | | `tia-project-general` | `skills/tia-project-general/SKILL.md` | Domain skill | | `tia-devices-general` | `skills/tia-devices-general/SKILL.md` | Domain skill | | `tia-hmi-operations` | `skills/tia-hmi-operations/SKILL.md` | Domain skill | | `tia-plc-operations` | `skills/tia-plc-operations/SKILL.md` | Domain skill | | `tia-networks` | `skills/tia-networks/SKILL.md` | Domain skill | | `tia-simatic-drives` | `skills/tia-simatic-drives/SKILL.md` | Domain skill | | `tia-import-export` | `skills/tia-import-export/SKILL.md` | Domain skill | | `tia-multiuser` | `skills/tia-multiuser/SKILL.md` | Domain skill | | `tia-teamcenter` | `skills/tia-teamcenter/SKILL.md` | Domain skill | | `tia-testsuite` | `skills/tia-testsuite/SKILL.md` | Domain skill | | `tia-sivarc` | `skills/tia-sivarc/SKILL.md` | Domain skill |

MAC Module Builder path

Dedicated higher-level path for Siemens Modular Application Creator source and Module Builder workflows:

| Skill | Location | |---|---| | `tia-mac-module-builder` | `skills/tia-mac-module-builder/SKILL.md` |

Use it for `TiaEquipmentModule`, MAC lifecycle/model/use-case code, `.tiares`, generated library wrappers, packaging, `MacFunctionTest`, and `MacGenerationTest`. If the module directly uses raw `Siemens.Engineering` objects, also route that part through the C# common and domain skills.

Add-In path

Standalone skill for TIA Portal Add-In development (always C#, VS Code workflow):

| Skill | Location | |---|---| | `addin-operations` | `skills/addin-operations/SKILL.md` |

Routing rules

| Task pattern | Implementation | Skill | |---|---|---| | browse / explore project tree structure | MCP | `tia-portal-mcp` | | read a single PLC block (view logic / generate code) | MCP | `tia-portal-mcp` | | targeted single-block edit | MCP | `tia-portal-mcp` | | list tag tables and tags | MCP | `tia-portal-mcp` | | inspect hardware topology / IP addresses | MCP | `tia-portal-mcp` | | cross-reference diagnostics / unused objects | MCP | `tia-portal-mcp` | | prerequisite / environment / missing install diagnostics | Diagnostic probe | `tia-doctor` | | add a single device to the project | MCP | `tia-portal-mcp` | | configure device network identity (IP, PN name) | MCP | `tia-portal-mcp` | | compile check / view errors and warnings | MCP | `tia-portal-mcp` | | open/create/save/archive/retrieve project | Python | `tia-python` | | project server / local session / portal attach | Python | `tia-python` | | PLC blocks / tags / UDTs / sources / compile | Python | `tia-python` | | PLC online / download / compare-to-online | Python | `tia-python` | | HMI tags / screens / scripts / alarms / lists | Python | `tia-python` | | HMI import/export / compile | Python | `tia-python` | | library types / versions / instantiate / update | Python | `tia-python` | | XML / SimaticML / AML / CAx import/export | Python | `tia-python` | | generic device compile / upgrade / properties | Python | `tia-python` | | topology / subnet / node / IO-system / port | C# | `tia-networks` | | Startdrive / SINAMICS / drive controller | C# | `tia-simatic-drives` | | device item slot/subslot/module manipulation | C# | `tia-devices-general` | | advanced PLC online/security/upload services | C# | `tia-plc-operations` | | advanced Classic or Unified HMI / screen items / runtime | C# | `tia-hmi-operations` | | VCI / version control interface | C# | `tia-project-general` | | project/global libraries, master copies, library types/versions, library update or harmonization | C# | `tia-project-general` | | multiuser engineering / server projects / local sessions | C# | `tia-multiuser` | | Teamcenter integration / managed projects | C# | `tia-teamcenter` | | a