orbit-code-ai 0.1.0

package/skills/ace-app-mq/SKILL.md

@@ -0,0 +1,554 @@
+---
+name: ace-app-mq
+description: Scaffold a complete IBM ACE MQ application using a two-phase multi-agent approach — Phase 1 creates all directories and empty files, Phase 2 fills each file with correct content.
+trigger: /ace-app-mq
+---
+
+# /ace-app-mq
+
+Scaffold a complete IBM ACE MQ application.
+
+## Usage
+
+```
+/ace-app-mq <AppName> [description of what the app does]
+
+Examples:
+  /ace-app-mq GetAccountDetails returns account details by customer ID
+  /ace-app-mq ProcessBatchFile processes incoming batch files
+```
+
+## Variables to Derive
+
+From `{AppName}` (PascalCase input):
+- `{appnamelowercase}` = all lowercase, no separators. e.g. `GetAccountDetails` → `getaccountdetails`
+- `{DOMAIN}` = uppercase with dashes. e.g. `GetAccountDetails` → `GET-ACCOUNT-DETAILS`
+
+**MQ applications have exactly TWO msgflow files:**
+- `GW_{AppName}.msgflow` — gateway/entry flow (NO "Flow" suffix)
+- `{AppName}Flow.msgflow` — main orchestration flow (WITH "Flow" suffix)
+
+---
+
+## PHASE 1 — Launch Scaffold Agent
+
+Use the Agent tool to launch a general-purpose agent with this exact prompt:
+
+> Create the following directory structure and empty files for the IBM ACE MQ application `{AppName}`. Use the Bash tool to create directories (mkdir -p) and the Write tool to create each file with a single comment placeholder `<!-- TODO -->` for XML/JSON/SQL files, `#!/bin/bash` for shell files, or `-- TODO` for ESQL files. Do not add any real content yet.
+>
+> Directories to create:
+> - `{AppName}/XSD&Swagger/XSD/`
+> - `{AppName}/XSD&Swagger/common/types/`
+> - `{AppName}/com/qiwa/esb/{appnamelowercase}/`
+>
+> Files to create (empty placeholders):
+> - `{AppName}/.project`
+> - `{AppName}/application.descriptor`
+> - `{AppName}/XSD&Swagger/{DOMAIN}.xml`
+> - `{AppName}/XSD&Swagger/{AppName}.json`
+> - `{AppName}/XSD&Swagger/XSD/{AppName}.xsd`
+> - `{AppName}/com/qiwa/esb/{appnamelowercase}/GW_{AppName}.msgflow`
+> - `{AppName}/com/qiwa/esb/{appnamelowercase}/{AppName}Flow.msgflow`
+> - `{AppName}/com/qiwa/esb/{appnamelowercase}/{AppName}Flow_Compute.esql`
+> - `{AppName}/com/qiwa/esb/{appnamelowercase}/{AppName}Flow_MapResponse.esql`
+> - `{AppName}/{AppName}QueuesDefinition.sh`
+> - `{AppName}/{AppName}DBScript.sql`
+>
+> Report "SCAFFOLD DONE" when all files and directories exist.
+
+Wait for the scaffold agent to complete before proceeding to Phase 2.
+
+---
+
+## PHASE 2 — Launch Content Agents (in parallel)
+
+After scaffold is confirmed, launch multiple agents in parallel using the Agent tool — one per file group. Each agent uses the Write tool to overwrite the placeholder with real content.
+
+### Agent A — Project files
+
+Write these two files:
+
+**`{AppName}/.project`** — exact content:
+```xml
+<?xml version="1.0" encoding="UTF-8"?>
+<projectDescription>
+	<name>{AppName}</name>
+	<comment></comment>
+	<projects>
+		<project>Framework</project>
+	</projects>
+	<buildSpec>
+		<buildCommand>
+			<name>com.ibm.etools.mft.applib.applibbuilder</name>
+			<arguments>
+			</arguments>
+		</buildCommand>
+		<buildCommand>
+			<name>com.ibm.etools.mft.applib.applibresourcevalidator</name>
+			<arguments>
+			</arguments>
+		</buildCommand>
+		<buildCommand>
+			<name>com.ibm.etools.mft.connector.policy.ui.PolicyBuilder</name>
+			<arguments>
+			</arguments>
+		</buildCommand>
+		<buildCommand>
+			<name>com.ibm.etools.mft.applib.mbprojectbuilder</name>
+			<arguments>
+			</arguments>
+		</buildCommand>
+		<buildCommand>
+			<name>com.ibm.etools.msg.validation.dfdl.mlibdfdlbuilder</name>
+			<arguments>
+			</arguments>
+		</buildCommand>
+		<buildCommand>
+			<name>com.ibm.etools.mft.flow.adapters.adapterbuilder</name>
+			<arguments>
+			</arguments>
+		</buildCommand>
+		<buildCommand>
+			<name>com.ibm.etools.mft.flow.sca.scabuilder</name>
+			<arguments>
+			</arguments>
+		</buildCommand>
+		<buildCommand>
+			<name>com.ibm.etools.msg.validation.dfdl.mbprojectresourcesbuilder</name>
+			<arguments>
+			</arguments>
+		</buildCommand>
+		<buildCommand>
+			<name>com.ibm.etools.mft.esql.lang.esqllangbuilder</name>
+			<arguments>
+			</arguments>
+		</buildCommand>
+		<buildCommand>
+			<name>com.ibm.etools.mft.map.builder.mslmappingbuilder</name>
+			<arguments>
+			</arguments>
+		</buildCommand>
+		<buildCommand>
+			<name>com.ibm.etools.mft.flow.msgflowxsltbuilder</name>
+			<arguments>
+			</arguments>
+		</buildCommand>
+		<buildCommand>
+			<name>com.ibm.etools.mft.flow.msgflowbuilder</name>
+			<arguments>
+			</arguments>
+		</buildCommand>
+		<buildCommand>
+			<name>com.ibm.etools.mft.decision.service.ui.decisionservicerulebuilder</name>
+			<arguments>
+			</arguments>
+		</buildCommand>
+		<buildCommand>
+			<name>com.ibm.etools.mft.pattern.capture.PatternBuilder</name>
+			<arguments>
+			</arguments>
+		</buildCommand>
+		<buildCommand>
+			<name>com.ibm.etools.mft.json.builder.JSONBuilder</name>
+			<arguments>
+			</arguments>
+		</buildCommand>
+		<buildCommand>
+			<name>com.ibm.etools.mft.restapi.ui.restApiDefinitionsBuilder</name>
+			<arguments>
+			</arguments>
+		</buildCommand>
+		<buildCommand>
+			<name>com.ibm.etools.mft.policy.ui.policybuilder</name>
+			<arguments>
+			</arguments>
+		</buildCommand>
+		<buildCommand>
+			<name>com.ibm.etools.msg.validation.dfdl.dfdlqnamevalidator</name>
+			<arguments>
+			</arguments>
+		</buildCommand>
+		<buildCommand>
+			<name>com.ibm.etools.mft.bar.ext.barbuilder</name>
+			<arguments>
+			</arguments>
+		</buildCommand>
+		<buildCommand>
+			<name>com.ibm.etools.mft.unittest.ui.TestCaseBuilder</name>
+			<arguments>
+			</arguments>
+		</buildCommand>
+	</buildSpec>
+	<natures>
+		<nature>com.ibm.etools.msgbroker.tooling.applicationNature</nature>
+		<nature>com.ibm.etools.msgbroker.tooling.messageBrokerProjectNature</nature>
+	</natures>
+</projectDescription>
+```
+
+**`{AppName}/application.descriptor`** — exact content (single line, no line breaks):
+```xml
+<?xml version="1.0" encoding="UTF-8" standalone="yes"?><ns2:appDescriptor xmlns="http://com.ibm.etools.mft.descriptor.base" xmlns:ns2="http://com.ibm.etools.mft.descriptor.app"><references><sharedLibraryReference><libraryName>Framework</libraryName></sharedLibraryReference></references></ns2:appDescriptor>
+```
+
+---
+
+### Agent B — Msgflow files
+
+Write these two files:
+
+**`{AppName}/com/qiwa/esb/{appnamelowercase}/GW_{AppName}.msgflow`**
+
+CRITICAL: This is the gateway flow. Name is `GW_{AppName}.msgflow` — NO "Flow" suffix.
+
+```xml
+<?xml version="1.0" encoding="UTF-8"?>
+<ecore:EPackage xmi:version="2.0"
+  xmlns:xmi="http://www.omg.org/XMI"
+  xmlns:ComIbmMQInput.msgnode="ComIbmMQInput.msgnode"
+  xmlns:ComIbmCompute.msgnode="ComIbmCompute.msgnode"
+  xmlns:ecore="http://www.eclipse.org/emf/2002/Ecore"
+  xmlns:eflow="http://www.ibm.com/wbi/2005/eflow"
+  xmlns:utility="http://www.ibm.com/wbi/2005/eflow_utility"
+  nsURI="com/qiwa/esb/{appnamelowercase}/GW_{AppName}.msgflow"
+  nsPrefix="com_qiwa_esb_{appnamelowercase}_GW_{AppName}.msgflow">
+  <eClassifiers xmi:type="eflow:FCMComposite" name="FCMComposite_1">
+    <eSuperTypes href="http://www.ibm.com/wbi/2005/eflow#//FCMBlock"/>
+    <translation xmi:type="utility:TranslatableString" key="GW_{AppName}"
+      bundleName="com/qiwa/esb/{appnamelowercase}/GW_{AppName}"
+      pluginId="{AppName}"/>
+    <composition>
+      <nodes xmi:type="ComIbmMQInput.msgnode:FCMComposite_1"
+        xmi:id="FCMComposite_1_1" location="23,170"
+        queueName="BS.{VERB}.{RESOURCE}.RQ">
+        <translation xmi:type="utility:ConstantString" string="MQ Input"/>
+      </nodes>
+      <nodes xmi:type="ComIbmCompute.msgnode:FCMComposite_1"
+        xmi:id="FCMComposite_1_2" location="300,170"
+        computeExpression="esql://routine/com.qiwa.esb.{appnamelowercase}#{AppName}Flow_Compute.Main"
+        computeMode="all">
+        <translation xmi:type="utility:ConstantString" string="{AppName}Flow_Compute"/>
+      </nodes>
+      <connections xmi:type="eflow:FCMConnection" xmi:id="FCMConnection_1"
+        targetNode="FCMComposite_1_2" sourceNode="FCMComposite_1_1"
+        sourceTerminalName="OutTerminal.out" targetTerminalName="InTerminal.in"/>
+    </composition>
+    <propertyOrganizer/>
+    <stickyBoard/>
+  </eClassifiers>
+</ecore:EPackage>
+```
+
+**`{AppName}/com/qiwa/esb/{appnamelowercase}/{AppName}Flow.msgflow`**
+
+CRITICAL: This is the main flow. Name is `{AppName}Flow.msgflow` — WITH "Flow" suffix.
+
+```xml
+<?xml version="1.0" encoding="UTF-8"?>
+<ecore:EPackage xmi:version="2.0"
+  xmlns:xmi="http://www.omg.org/XMI"
+  xmlns:ComIbmCompute.msgnode="ComIbmCompute.msgnode"
+  xmlns:ComIbmMQOutput.msgnode="ComIbmMQOutput.msgnode"
+  xmlns:ecore="http://www.eclipse.org/emf/2002/Ecore"
+  xmlns:eflow="http://www.ibm.com/wbi/2005/eflow"
+  xmlns:utility="http://www.ibm.com/wbi/2005/eflow_utility"
+  nsURI="com/qiwa/esb/{appnamelowercase}/{AppName}Flow.msgflow"
+  nsPrefix="com_qiwa_esb_{appnamelowercase}_{AppName}Flow.msgflow">
+  <eClassifiers xmi:type="eflow:FCMComposite" name="FCMComposite_1">
+    <eSuperTypes href="http://www.ibm.com/wbi/2005/eflow#//FCMBlock"/>
+    <translation xmi:type="utility:TranslatableString" key="{AppName}Flow"
+      bundleName="com/qiwa/esb/{appnamelowercase}/{AppName}Flow"
+      pluginId="{AppName}"/>
+    <composition>
+      <nodes xmi:type="ComIbmCompute.msgnode:FCMComposite_1"
+        xmi:id="FCMComposite_1_1" location="23,170"
+        computeExpression="esql://routine/com.qiwa.esb.{appnamelowercase}#{AppName}Flow_PrepDpRq.Main"
+        computeMode="all">
+        <translation xmi:type="utility:ConstantString" string="{AppName}Flow_PrepDpRq"/>
+      </nodes>
+      <nodes xmi:type="ComIbmCompute.msgnode:FCMComposite_1"
+        xmi:id="FCMComposite_1_2" location="300,170"
+        computeExpression="esql://routine/com.qiwa.esb.{appnamelowercase}#{AppName}Flow_MapResponse.Main"
+        computeMode="all">
+        <translation xmi:type="utility:ConstantString" string="{AppName}Flow_MapResponse"/>
+      </nodes>
+      <nodes xmi:type="ComIbmMQOutput.msgnode:FCMComposite_1"
+        xmi:id="FCMComposite_1_3" location="580,170"
+        queueName="BS.{VERB}.{RESOURCE}.RS">
+        <translation xmi:type="utility:ConstantString" string="MQ Output"/>
+      </nodes>
+      <connections xmi:type="eflow:FCMConnection" xmi:id="FCMConnection_1"
+        targetNode="FCMComposite_1_2" sourceNode="FCMComposite_1_1"
+        sourceTerminalName="OutTerminal.out" targetTerminalName="InTerminal.in"/>
+      <connections xmi:type="eflow:FCMConnection" xmi:id="FCMConnection_2"
+        targetNode="FCMComposite_1_3" sourceNode="FCMComposite_1_2"
+        sourceTerminalName="OutTerminal.out" targetTerminalName="InTerminal.in"/>
+    </composition>
+    <propertyOrganizer/>
+    <stickyBoard/>
+  </eClassifiers>
+</ecore:EPackage>
+```
+
+---
+
+### Agent C — ESQL files
+
+Write these two files:
+
+**`{AppName}/com/qiwa/esb/{appnamelowercase}/{AppName}Flow_Compute.esql`**
+
+```esql
+BROKER SCHEMA com.qiwa.esb.{appnamelowercase}
+PATH Qiwa.Framework.Lib;
+
+CREATE COMPUTE MODULE {AppName}Flow_Compute
+	CREATE FUNCTION Main() RETURNS BOOLEAN
+	BEGIN
+		CALL CopyMessageHeaders();
+
+		SET Environment.Variables.Properties = InputRoot.Properties;
+		SET Environment.Variables.MQMD = InputRoot.MQMD;
+		SET Environment.Variables.MQRFH2 = InputRoot.MQRFH2;
+		SET Environment.Variables.XMLNSC = InputRoot.XMLNSC;
+
+		DECLARE rInBodyRef   REFERENCE TO InputRoot.XMLNSC.{AppName}Rq.Body;
+		DECLARE rInHeaderRef REFERENCE TO InputRoot.XMLNSC.{AppName}Rq.Header;
+
+		-- *** Implement business logic here based on user's description ***
+
+		RETURN TRUE;
+	END;
+
+	CREATE PROCEDURE CopyMessageHeaders() BEGIN
+		DECLARE I INTEGER 1;
+		DECLARE J INTEGER;
+		SET J = CARDINALITY(InputRoot.*[]);
+		WHILE I < J DO
+			SET OutputRoot.*[I] = InputRoot.*[I];
+			SET I = I + 1;
+		END WHILE;
+	END;
+
+	CREATE PROCEDURE CopyEntireMessage() BEGIN
+		SET OutputRoot = InputRoot;
+	END;
+END MODULE;
+```
+
+**`{AppName}/com/qiwa/esb/{appnamelowercase}/{AppName}Flow_MapResponse.esql`**
+
+```esql
+BROKER SCHEMA com.qiwa.esb.{appnamelowercase}
+PATH Qiwa.Framework.Lib;
+
+CREATE COMPUTE MODULE {AppName}Flow_MapResponse
+	CREATE FUNCTION Main() RETURNS BOOLEAN
+	BEGIN
+		SET OutputRoot.Properties = Environment.Variables.Properties;
+		SET OutputRoot.MQMD = Environment.Variables.MQMD;
+		SET OutputRoot.MQRFH2 = Environment.Variables.MQRFH2;
+
+		DECLARE rInHeader REFERENCE TO Environment.Variables.XMLNSC.{AppName}Rq.Header;
+
+		CREATE LASTCHILD OF OutputRoot DOMAIN 'XMLNSC';
+		CREATE FIRSTCHILD OF OutputRoot.XMLNSC.{AppName}Rs NAME 'Header';
+		DECLARE rOutHeader REFERENCE TO OutputRoot.XMLNSC.{AppName}Rs.Header;
+		CREATE LASTCHILD OF OutputRoot.XMLNSC.{AppName}Rs NAME 'Body';
+
+		-- *** Map output fields here based on user's description ***
+
+		CALL Create_esbXML_Response_Header(GetESBSuccessCode(), rInHeader, rOutHeader);
+		RETURN TRUE;
+	END;
+
+	CREATE PROCEDURE CopyMessageHeaders() BEGIN
+		DECLARE I INTEGER 1;
+		DECLARE J INTEGER;
+		SET J = CARDINALITY(InputRoot.*[]);
+		WHILE I < J DO
+			SET OutputRoot.*[I] = InputRoot.*[I];
+			SET I = I + 1;
+		END WHILE;
+	END;
+
+	CREATE PROCEDURE CopyEntireMessage() BEGIN
+		SET OutputRoot = InputRoot;
+	END;
+END MODULE;
+```
+
+---
+
+### Agent D — Config files
+
+Write these five files:
+
+**`{AppName}/XSD&Swagger/{DOMAIN}.xml`**
+
+```xml
+<properties refresh-policy="automatic">
+
+  <group name="{AppName}.{AppName}Flow">
+    <group name="Logging">
+      <property name="LogEnabled" value="TRUE" />
+      <property name="AuditEnabled" value="TRUE" />
+      <property name="MaskingEnabled" value="TRUE" />
+      <property name="key1" value="" />
+      <property name="value1" value="" />
+      <property name="key2" value="" />
+      <property name="value2" value="" />
+      <property name="key3" value="" />
+      <property name="value3" value="" />
+      <property name="key4" value="" />
+      <property name="value4" value="" />
+    </group>
+    <group name="Variables">
+      <property name="ServerDown" value="E0000616" />
+      <property name="TimeOutError" value="E9999998" />
+    </group>
+    <group name="SchemaValidation">
+      <property name="ValidationEnabled" value="TRUE" />
+    </group>
+    <group name="Retry">
+      <property name="RetryEnabled" value="FALSE" />
+      <property name="minWaitDurationSec" value="60" />
+      <property name="maxRetryCount" value="5" />
+    </group>
+  </group>
+
+</properties>
+```
+
+**`{AppName}/XSD&Swagger/XSD/{AppName}.xsd`**
+
+Generate appropriate request/response body fields based on the user's description:
+
+```xml
+<?xml version="1.0" encoding="UTF-8"?>
+<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema"
+           xmlns:tns="http://www.qiwa.sa/esb/{appnamelowercase}/v1"
+           xmlns:common="http://www.qiwa.sa/esb/common/types/v1"
+           targetNamespace="http://www.qiwa.sa/esb/{appnamelowercase}/v1"
+           elementFormDefault="qualified">
+
+  <xs:import namespace="http://www.qiwa.sa/esb/common/types/v1"
+             schemaLocation="../common/types/ESB_common_types_v1.0.xsd"/>
+
+  <xs:complexType name="{AppName}Rq_BodyType">
+    <xs:sequence>
+      <!-- Fields derived from user description -->
+    </xs:sequence>
+  </xs:complexType>
+
+  <xs:complexType name="{AppName}Rs_BodyType">
+    <xs:sequence>
+      <!-- Fields derived from user description -->
+    </xs:sequence>
+  </xs:complexType>
+
+  <xs:complexType name="{AppName}Rq_MessageType">
+    <xs:sequence>
+      <xs:element name="Header" type="common:ESBXMLRequestHeader_Type"/>
+      <xs:element name="Body"   type="tns:{AppName}Rq_BodyType"/>
+    </xs:sequence>
+  </xs:complexType>
+
+  <xs:complexType name="{AppName}Rs_MessageType">
+    <xs:sequence>
+      <xs:element name="Header" type="common:ESBXMLResponseHeader_Type"/>
+      <xs:element name="Body"   type="tns:{AppName}Rs_BodyType"/>
+    </xs:sequence>
+  </xs:complexType>
+
+  <xs:element name="{AppName}Rq" type="tns:{AppName}Rq_MessageType"/>
+  <xs:element name="{AppName}Rs" type="tns:{AppName}Rs_MessageType"/>
+
+</xs:schema>
+```
+
+**`{AppName}/XSD&Swagger/{AppName}.json`**
+
+```json
+{
+  "swagger": "2.0",
+  "info": { "title": "{AppName}", "version": "1.0" },
+  "basePath": "/esb/{AppName}",
+  "consumes": ["application/xml"],
+  "produces": ["application/xml"],
+  "paths": {
+    "/{appnamelowercase}": {
+      "post": {
+        "operationId": "{AppName}",
+        "parameters": [{ "in": "body", "name": "body", "schema": { "$ref": "#/definitions/{AppName}Rq_MessageType" } }],
+        "responses": { "200": { "schema": { "$ref": "#/definitions/{AppName}Rs_MessageType" } } }
+      }
+    }
+  },
+  "definitions": {
+    "{AppName}Rq_MessageType": {},
+    "{AppName}Rs_MessageType": {}
+  }
+}
+```
+
+**`{AppName}/{AppName}QueuesDefinition.sh`**
+
+```bash
+#!/bin/bash
+# Queue definitions for {AppName}
+
+runmqsc QMGR_NAME << EOF
+
+DEFINE QLOCAL('BS.{VERB}.{RESOURCE}.RQ.BACKOUT') DEFPSIST(YES) MAXDEPTH(640000) REPLACE
+DEFINE QLOCAL('BS.{VERB}.{RESOURCE}.RQ') DEFPSIST(YES) MAXDEPTH(640000) BOQNAME('BS.{VERB}.{RESOURCE}.RQ.BACKOUT') BOTHRESH(5) REPLACE
+
+DEFINE QLOCAL('BS.{VERB}.{RESOURCE}.RS.BACKOUT') DEFPSIST(YES) MAXDEPTH(640000) REPLACE
+DEFINE QLOCAL('BS.{VERB}.{RESOURCE}.RS') DEFPSIST(YES) MAXDEPTH(640000) BOQNAME('BS.{VERB}.{RESOURCE}.RS.BACKOUT') BOTHRESH(5) REPLACE
+
+EOF
+```
+
+**`{AppName}/{AppName}DBScript.sql`**
+
+```sql
+-- Register the service in routing table
+INSERT INTO MCR_CHANNESBFUNC_TBL (ESBFUNCID, ESBFUNCNAME, REQUEST_QUEUE_NAME, RESPONSE_QUEUE_NAME)
+VALUES ('{ABBREV}0001', '{AppName}', 'BS.{VERB}.{RESOURCE}.RQ', 'BS.{VERB}.{RESOURCE}.RS');
+
+-- Grant channel access (add channels as needed)
+INSERT INTO MCR_CHANNAUTH_TBL (CHANNID, ESBFUNCID) VALUES ('MOBILE', '{ABBREV}0001');
+INSERT INTO MCR_CHANNAUTH_TBL (CHANNID, ESBFUNCID) VALUES ('WEB',    '{ABBREV}0001');
+```
+
+---
+
+## After All Agents Complete
+
+Print this summary:
+
+```
+✓ {AppName} MQ application created
+
+  {AppName}/
+  ├── .project
+  ├── application.descriptor
+  ├── {AppName}QueuesDefinition.sh
+  ├── {AppName}DBScript.sql
+  ├── XSD&Swagger/
+  │   ├── {DOMAIN}.xml
+  │   ├── {AppName}.json
+  │   └── XSD/
+  │       └── {AppName}.xsd
+  └── com/qiwa/esb/{appnamelowercase}/
+      ├── GW_{AppName}.msgflow          ← gateway (no "Flow" suffix)
+      ├── {AppName}Flow.msgflow         ← main flow
+      ├── {AppName}Flow_Compute.esql
+      └── {AppName}Flow_MapResponse.esql
+
+Reminder:
+- Copy ESB_common_types_v1.0.xsd into XSD&Swagger/common/types/
+- Replace {VERB} and {RESOURCE} in queue names with actual values
+- Fill in XSD body field definitions
+- Update ESBFUNCID to a unique 4-char abbreviation + 4-digit sequence
+```