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

MCP vs Python vs C# vs MAC Module Builder decision rule

Apply the user's explicit implementation/scope choice before these defaults.

Choose MCP when:

• the task is a single read or targeted write (one block, one device, one compile check)
• the user wants to explore or inspect a project interactively
• no looping, no bulk changes, no code generation is needed
• the tia-portal MCP server is available (check mcp__tia-portal__* tools)

Choose Python when the exact required operation exists in the tia-python reference files.

Choose MAC Module Builder when the task's primary artifact is a Modular Application Creator module, Module Builder resource/generation input, or MAC package/test project. This path is source-first; it does not itself authorize a live generation run.

Choose C# when:

• the required operation is absent from the Python reference catalogue
• the task needs low-level object model traversal
• the task needs topology/network object manipulation
• the task needs drive-specific APIs
• the task needs advanced online/security/session/event APIs
• the task needs Teamcenter, VCI, advanced multiuser, or unsupported safety/Unified features
• the task needs SiVArc rules, definitions, layout exchange, expression resolution, or generation

Multi-skill execution order

1. project / portal
2. device selection
3. domain work
4. import/export
5. compile / compare / download / validation

Required response format

Use this exact structure:

• Use skill(s): ...
• Implementation path: MCP or Implementation path: Python or Implementation path: C# Openness or Implementation path: MAC Module Builder or Implementation path: Diagnostic probe
• Reason: ...
• Execution order: ...

Post-routing action — MANDATORY

If Diagnostic probe: read skills/tia-doctor/SKILL.md and run its probe command. Report the probe output and remediation items. Do not create or modify projects.

If MCP: read skills/tia-portal-mcp/SKILL.md. Use the MCP tools directly — no code generation.

If Python: read skills/tia-python/SKILL.md, then load the reference file(s) it points to for the task domain. Do NOT load domain skills — they are for C# only.

If MAC Module Builder: read skills/tia-mac-module-builder/SKILL.md, then load only the reference file(s) selected by its reference table. If direct raw Openness work is required, additionally follow the C# path for that domain.

If C#:

1. Read skills/tia-csharp-common/SKILL.md first — always, for every C# task.
2. Read the SKILL.md of each selected domain skill, then load only the references/*.md file(s) that skill's own reference table (or its reference_catalogue.md, where present) points to for the task.

If Add-In: read skills/addin-operations/SKILL.md. No other skills needed.

Do NOT write code based solely on the routing response — always load the skill files first.

Escalation rule

If implementation starts in Python and the required call is not documented:

• stop
• switch to the corresponding C# domain skill
• load tia-csharp-common first, then the domain skill
• keep the same task decomposition

Hard escalation triggers (always C#)

• device item slot/subslot operations
• subnet/node/IO-system/port/channel/address manipulation
• Teamcenter / ConnectSSO
• VCI / advanced multiuser
• advanced PLC online/security services
• advanced Unified internals
• drive-specific engineering
• SiVArc engineering or generation
• diagnostics / event handlers / self-description APIs