init

README.md

@@ -0,0 +1,113 @@
+# OIPF / generic-industrial-process
+
+**Generic Industrial Process Library** is the first ProcessGit library for OIPF — the Operational Intelligence Packaging Format.
+
+It is not a normal software repository and not a general documentation site. It is a **ProcessGit process library** intended to be published as:
+
+```text
+https://processgit.org/OIPF/generic-industrial-process
+```
+
+The library provides a reusable, industry-neutral production process skeleton for AI-native operational intelligence projects. It defines the common process pattern by which an industrial site is observed, contextualised, modelled, recommended, acted upon, recorded, and improved.
+
+## Purpose
+
+Most industrial AI deployments become bespoke because every plant has different tags, historians, maintenance records, recipes, operator workflows, and local terminology.
+
+This ProcessGit library provides a neutral starting point for repeatable industrial intelligence packages:
+
+```text
+Observe → Contextualise → Infer → Check → Recommend → Approve → Act → Record → Learn
+```
+
+It is designed to support future OIPF packages such as:
+
+- cleaning optimisation;
+- fouling detection;
+- energy-loss detection;
+- predictive maintenance;
+- quality drift detection;
+- downtime root-cause analysis.
+
+## What this repository contains
+
+```text
+.processgit/                 ProcessGit metadata hints
+processgit.yaml              ProcessGit library descriptor
+processgit.viewer.json       Viewer/editor hints for ProcessGit
+library.yaml                 OIPF process library manifest
+levels/                      UAPF-style L0-L4 process decomposition
+bpmn/                        BPMN model for the generic industrial process
+/dmn                         Decision model example
+process-cards/               Process cards for the library
+algorithm-cards/             Algorithm cards referenced by process tasks
+packages/                    First OIPF package skeletons
+resources/schemas/           OIPF schemas used by packages
+resources/examples/          Minimal deployable examples
+docs/                        Concept, architecture and publishing notes
+```
+
+## ProcessGit classification
+
+Recommended ProcessGit repository metadata:
+
+```yaml
+repo_type: process
+uapf_level: 0-4
+status: draft
+reference_kind: n/a
+```
+
+If your ProcessGit instance stores classification at platform level, set these values in the repository settings rather than treating this file as the source of truth.
+
+## Core idea
+
+The library treats production operations as versioned process assets:
+
+- assets and lines;
+- industrial tags;
+- operating states;
+- events;
+- constraints;
+- model contracts;
+- recommendations;
+- human approvals;
+- outcomes;
+- feedback loops.
+
+It does not replace OPC UA, ISA-88, ISA-95, MQTT/Sparkplug, MES, CMMS, ERP, SCADA, DCS, or historians. It defines an AI-native process layer above them.
+
+## First package
+
+The first concrete package is:
+
+```text
+packages/cleaning-optimisation/
+```
+
+It is intentionally simple. It is meant to become the first real OIPF package that can be evolved into a deployable production-intelligence process.
+
+## Publishing
+
+To publish to ProcessGit:
+
+```bash
+git clone https://processgit.org/OIPF/generic-industrial-process.git
+cp -R generic-industrial-process/* generic-industrial-process/.processgit generic-industrial-process/.github <repo>/
+cd <repo>
+git add .
+git commit -m "Initial OIPF generic industrial process library"
+git push origin main
+```
+
+To mirror to GitHub, create a repository such as:
+
+```text
+https://github.com/OIPFormat/generic-industrial-process
+```
+
+and push the same contents.
+
+## Status
+
+Draft reference library. Not yet a normative OIPF specification.