Skip to content

Added Project scope and intent for AI workflow interoperability#2163

Open
nataliesea wants to merge 2 commits into
cncf:mainfrom
nataliesea:patch-1
Open

Added Project scope and intent for AI workflow interoperability#2163
nataliesea wants to merge 2 commits into
cncf:mainfrom
nataliesea:patch-1

Conversation

@nataliesea

Copy link
Copy Markdown

Updating the README to provide more detail on the project's scope, goals, and interoperability requirements.

Signed-off-by: Natalie Fisher <53450897+nataliesea@users.noreply.github.com>
@nataliesea nataliesea requested a review from a team as a code owner May 14, 2026 22:38
@github-actions github-actions Bot added needs-triage Indicates an issue or PR that has not been triaged yet (has a 'triage/foo' label applied) needs-kind Indicates an issue or PR that is missing an issue type or kind (a kind/foo label) needs-group Indicates an issue or PR that has not been assigned a group (toc or tag/foo label applied) and removed needs-triage Indicates an issue or PR that has not been triaged yet (has a 'triage/foo' label applied) needs-kind Indicates an issue or PR that is missing an issue type or kind (a kind/foo label) needs-group Indicates an issue or PR that has not been assigned a group (toc or tag/foo label applied) labels May 14, 2026
Signed-off-by: Natalie Fisher <53450897+nataliesea@users.noreply.github.com>
@github-actions github-actions Bot requested a review from danieloh30 May 18, 2026 21:39

@nataliesea nataliesea left a comment

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Resolved feedback from @danieloh30

@danieloh30 danieloh30 left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM!

Ensure the approach accounts for:
* Air-gapped and regulated environments
* Enterprise security and compliance requirements
* Regulated environments

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

feels like a repeat of line 86. If its a separate deployment consideration, can you add more detals? if not, lets keep line 86 in favor of this

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Recommend that we separate air-gapped and regulated environment as they are separate concerns

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

agree - separate concerns

* **A Published Interoperability Spec:** A validated specification that existing tools can adopt to ensure cloud native readiness.
* **Cross-Tool Portability:** Demonstrated ability for an artifact built by one tool to be verified and deployed by a different runtime.
* **The "10-Minute Flow":** A successful reference implementation demonstrating the journey from a local idea to a running inference service on Kubernetes.
* **Ecosystem Alignment:** Broad adoption of the "Compliance Profile" metadata across CNCF and LF AI & Data communities.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

is the adoption achievable in the given timeframe of the initiative? This initiative will get the conversation started and adoption can be a follow up. wdyt?

* **Agentic Assets:** Standardizing the packaging of “skills”, prompt templates and workflow definitions.
* To ensure interoperability, the internal format for skills will align with the <a href="https://agentskills.io/home" target="_blank">agentskills.io</a> community standard.
* The spec defines how these standardized skills are encapsulated into the OCI layers for consistent distribution and discovery.
* The initiative may leverage Skill DLC as the primary reference for demonstrating how these assets are dynamically loaded and managed.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

nit: add a link


#### 5. GitOps and Kubernetes Integration Patterns
Define the "Handoff" patterns for how artifacts transition into production cloud native systems.
* **GitOps Delivery Patterns:** Reference architectures for pulling compliant artifacts into Flux or Argo CD workflows.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should this support a step for verification of artifacts? like kitops init container, that deploys and verifies the artifacts before exiting - https://kitops.org/docs/deploy/#init-container

@savitharaghunathan

Copy link
Copy Markdown
Member

@caldeirav - do you have time for a quick review? thanks

## Initiative description

Focus on the developer inner loop, everything an AI engineer does on a laptop/desktop before code or models ever reach CI/CD in a cloud-native environment:
Focus on the developer inner loop, everything an AI engineer does on a laptop/desktop before code or models ever reach CI/CD in a cloud native environment:

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Focus on the developer inner loop, everything an AI engineer does on a laptop/desktop before code or models ever reach CI/CD in a cloud native environment:
Focus on inner loop development which incorporates everything an AI engineer does on a local environment before code or models ever reach CI/CD in a cloud native environment:

Focus on the developer inner loop, everything an AI engineer does on a laptop/desktop before code or models ever reach CI/CD in a cloud-native environment:
Focus on the developer inner loop, everything an AI engineer does on a laptop/desktop before code or models ever reach CI/CD in a cloud native environment:

* Local container workspaces: Reference inner loop workflow using desktop tooling such as Podman Desktop / Podman AI Lab for root-less, GPU-aware experimentation, including template images for PyTorch/LLM stacks and volume-mounted datasets. ​

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Would a cloud IDE (such as Eclipse Che / Coder, etc) also be in scope?

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

For simplicity, I prefer that we stick to laptop/desktop. If we decide to include cloud IDE in scope, I would like the setup and management of it be out of scope, mainly to avoid any integration issues.

Focus on the developer inner loop, everything an AI engineer does on a laptop/desktop before code or models ever reach CI/CD in a cloud native environment:

* Local container workspaces: Reference inner loop workflow using desktop tooling such as Podman Desktop / Podman AI Lab for root-less, GPU-aware experimentation, including template images for PyTorch/LLM stacks and volume-mounted datasets. ​
* Unified model build & run CLI: Hardening inference on developer machine and agentic frameworks to leverage container-based tooling so engineers can easily spin-up inference, RAG and multi-agent services locally with one command.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Unified model build & run CLI sounds awkward. Recommend a different set of terms for this goal

Integrating the AI developer inner loop into an end-to-end CI/CD process leveraging cloud-native technologies and tooling
Integrating the AI developer inner loop into an end-to-end CI/CD process leveraging cloud native technologies and tooling

## Initiative description

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should packaging and retrieval of AI artifacts/resources also be included i the description?

## Deliverable(s) or exit criteria

* An technical POC showing <10 min “idea-to-inference” path for cloud-native agent development on a developer laptop.
* An technical POC showing <10 min “idea-to-inference” path for cloud native agent development on a developer laptop.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
* An technical POC showing <10 min “idea-to-inference” path for cloud native agent development on a developer laptop.
* An technical POC showing <10 min “idea-to-inference” path for cloud native agent development on a developer environment.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

shouldn't this be "in" a developer environment?

* **Transparency Manifests:** Mandatory requirements for SBOM (Software Bill of Materials) generation and attachment for all artifact layers.
* **Provenance Metadata:** Defining the "Hardened Provenance" requirements to ensure the journey from local experimentation to a secure registry is immutable and documented.

The goal is to ensure artifacts are trusted and verifiable before entering CI/CD pipelines.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Some of the signing tools require that assets be made available in an OCI registry before signatures can be applied

The goal is to ensure artifacts are trusted and verifiable before entering CI/CD pipelines.

#### 4. Developer Inner-Loop & Workflow Interoperability
Define the operational patterns that allow the specification to be utilized in a portable "laptop-to-cluster" journey.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Define the operational patterns that allow the specification to be utilized in a portable "laptop-to-cluster" journey.
Define the operational patterns that allow the specification to be utilized in a portable "local environment-to-cluster" journey.

Ensure the approach accounts for:
* Air-gapped and regulated environments
* Enterprise security and compliance requirements
* Regulated environments

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Recommend that we separate air-gapped and regulated environment as they are separate concerns

#### 7. Ecosystem Collaboration
This initiative will be developed in collaboration with:
* ModelPack and related OCI-aligned initiatives
* CNCF projects

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ModelPack in the bullet point above is a CNCF project. Should we consolidate bullet points?

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

CNCF projects, such as ModelPack (if you also call out multiple projects here)

* **A Published Interoperability Spec:** A validated specification that existing tools can adopt to ensure cloud native readiness.
* **Cross-Tool Portability:** Demonstrated ability for an artifact built by one tool to be verified and deployed by a different runtime.
* **The "10-Minute Flow":** A successful reference implementation demonstrating the journey from a local idea to a running inference service on Kubernetes.
* **Ecosystem Alignment:** Broad adoption of the "Compliance Profile" metadata across CNCF and LF AI & Data communities.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Would a blog post highlighting the outputs of this effort also be a desired success criteria?

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

+1. My hope is that this initiative will lead to more smaller and focussed initiatives within ecosystem and/or more opportunities to collaborate outside of CNCF ecosystem. A blog post with future direction/goals will be really helpful.

## Deliverable(s) or exit criteria

* An technical POC showing <10 min “idea-to-inference” path for cloud-native agent development on a developer laptop.
* An technical POC showing <10 min “idea-to-inference” path for cloud native agent development on a developer laptop.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

shouldn't this be "in" a developer environment?

## Project Scope & Intent - Cloud Native AI Developer Workflow Interoperability

### Overview and Intent
AI developers today frequently work in fragmented local environments that are disconnected from cloud native operational workflows. While emerging standards like ModelPack and OCI-aligned AI artifact initiatives provide the “packaging” foundations, there is no unified interoperability specification that defines how these artifacts must be structured, secured, and described to move seamlessly from a developers laptop into a Kubernetes-based production system.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"environment" .. singular

## Project Scope & Intent - Cloud Native AI Developer Workflow Interoperability

### Overview and Intent
AI developers today frequently work in fragmented local environments that are disconnected from cloud native operational workflows. While emerging standards like ModelPack and OCI-aligned AI artifact initiatives provide the “packaging” foundations, there is no unified interoperability specification that defines how these artifacts must be structured, secured, and described to move seamlessly from a developers laptop into a Kubernetes-based production system.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"developer's environment"

Within this scope, the initiative will explore and document:
* **An Interoperability Profile Spec:** A set of mandatory annotation conventions and metadata requirements (the “Manifest Contract”).
* **Compliance & Trust Requirements:** Standards for signing, SBOMs, and openness classification.
* **Workflow Reference Patterns:** Validating the spec through “Laptop-to-Cluster” GitOps and runtime integration.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

yes, this is correct -- it doesn't have to be a laptop

Ensure the approach accounts for:
* Air-gapped and regulated environments
* Enterprise security and compliance requirements
* Regulated environments

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

agree - separate concerns

#### 7. Ecosystem Collaboration
This initiative will be developed in collaboration with:
* ModelPack and related OCI-aligned initiatives
* CNCF projects

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

CNCF projects, such as ModelPack (if you also call out multiple projects here)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants