Open Knowledge Format for Crossplane v2
LLM wiki kit
First committed by jkroepke
Published in jkroepke/okf-crossplane-v2. Publisher page
37 GitHub stars
What it is
LLM-wiki in OKF (Open Knowledge Format) for Crossplane v2
AutoGineer overview, from the brain’s own files
The okf-crossplane-v2 repository provides a versioned, source-backed knowledge catalog designed to help AI agents and developers navigate the Crossplane v2 ecosystem. It aggregates information from Go API types, CRDs, package metadata, and documentation into a structured format. By utilizing the Open Knowledge Format (OKF), it enables agents to perform precise lookups on providers, composition functions, and API definitions. The project includes a dedicated MCP server that allows agents to query live repository data, such as CRD definitions, versioning, and examples, ensuring that the information retrieved is grounded in specific, versioned source code.
How it works
Memory model: LLM wiki
AutoGineer overview, from the brain’s own files
The system organizes technical knowledge into a catalog of Markdown files stored in the catalog folder. These files contain OKF metadata and provenance links. An MCP server, which can be self-hosted or used via a public endpoint, ingests this catalog into a DuckDB instance. Agents interact with this data through specific tools that resolve provider versions, search CRDs, and retrieve documentation or examples. The system relies on specialized researcher agents defined in the .agents folder to maintain and validate the knowledge base, ensuring that facts are linked to stable source code and documentation.
| Folder | Role | Files |
|---|---|---|
| .codex | agent-config | 25 |
| .github | agent-config | 2 |
| skills | agent-instructions | 1 |
| .agents | folder | 37 |
| .codex-plugin | folder | 1 |
| .okf | folder | 2 |
| .pi | folder | 27 |
| .plugin | folder | 1 |
| catalog | folder | 120 |
| mcp | folder | 12 |
Requirements
Apps: Docker
API keys (by name): GITHUB_TOKEN
Works with: Claude Code, OpenAI Codex, GitHub Copilot, Cursor, Gemini CLI, Kiro, OpenCode, Amp, Cline, JetBrains Junie, Devin (ex-Windsurf)
Set it up
- Download the brain as a ZIP and unzip it where you keep your notes or project: https://mp-staging.autogineer.com/agent-brains/jkroepke/okf-crossplane-v2/download
Point Claude Code at .codex-plugin/plugin.json: it does not read that file on its own.
cd okf-crossplane-v2 && claude
AutoGineer scanned these files at commit df24ac2.
Add crossplane-v2-okf to .mcp.json:
{ "mcpServers": { "crossplane-v2-okf": { "type": "http", "url": "https://crossplane.mcp.jkroepke.de/mcp" } } }Or add it with the Claude Code CLI:
claude mcp add --transport http crossplane-v2-okf https://crossplane.mcp.jkroepke.de/mcpYour data is sent to crossplane.mcp.jkroepke.de.
First committed by jkroepke. Published in jkroepke/okf-crossplane-v2. Licence: Apache License 2.0.
Usage
AutoGineer overview, from the brain’s own files
- Querying CRD definitions for specific Crossplane providers
- Retrieving versioned examples for composition functions
- Resolving stable provider versions and their associated documentation
- Integrating Crossplane knowledge into AI agent workflows via MCP
- “Find the latest version of the AWS provider and list its CRDs.”
- The agent uses the get_versions and provider_crd_search tools to return the canonical repository name and a list of available CRDs for the specified provider.
- “Show me the definition for the S3Bucket CRD in the latest AWS provider.”
- The agent retrieves the YAML definition of the requested CRD using the provider_crd_get_definition tool, ensuring the output is token-efficient.
Documentation by jkroepke
Image: CI Image: GitHub license Image: GitHub Repo stars Image: BundleDex
Open Knowledge Format for Crossplane v2
This repository provides a structured knowledge catalog for the Crossplane v2 ecosystem using Open Knowledge Format v0.2.
The goal is to make Crossplane concepts, APIs, providers, composition functions, documentation, and practical examples easier to discover and understand. The catalog is designed for both humans and knowledge-aware tools.
Installation
WARNING
The public MCP server is a temporary early-access service for early adopters. Its availability is not guaranteed, and it may change or be removed without notice. It is intended to bridge the current tooling gap until the OKF ecosystem provides practical, end-user-friendly solutions that run locally. For reliable or production use, self-host the included container.
Install the companion skill and hosted OKF-aware MCP server together as a plugin for every detected supported agent:
npx plugins add jkroepke/okf-crossplane-v2Pass --target codex to install only in Codex. Restart the selected agents
after installation.
Alternatively, install the hosted OKF-aware MCP server globally:
npx add-mcp \
https://crossplane.mcp.jkroepke.de/mcp \
--name crossplane-v2-okf \
--globalThen install the companion skill so the agent prefers this bundle over generic documentation providers for Crossplane v2 questions:
npx skills add jkroepke/okf-crossplane-v2 \
--skill crossplane-v2-okf \
--globalBoth standalone installers detect supported agents and ask where the integration should be installed. Restart the selected agent after installation.
The public MCP health endpoint is available at https://crossplane.mcp.jkroepke.de/healthz.
Self-hosting the MCP server
The included container fetches this repository, ingests catalog/ into a DuckDB catalog, and serves the okf-mcp tools over Streamable HTTP.
docker compose up --build --detachTo authenticate the server's GitHub requests, export GITHUB_TOKEN before
starting the container. The token is optional.
The local MCP endpoint is http://127.0.0.1:8000/mcp. Put it behind a TLS reverse proxy for crossplane.mcp.jkroepke.de.
The catalog is refreshed at container startup. If fetching or ingestion fails and a previous catalog exists in the volume, the server continues with that last successful catalog.
The MCP tools are read-only, but the public endpoint has no application-level authentication. Apply request limits and access controls at the reverse proxy when required.
Crossplane package tools
The server adds these tools backed by OSS GitHub repositories:
get_versions(name)resolves an OSS provider or function repository and returns its canonical repository name,versions.latest, a compact list of recent stable versions, and tag counts. Pass the returned provider name to the CRD tools.provider_crd_search(provider_name, provider_version, crd_search_term)searches CRDs in one explicit provider package version. The search term supports case-insensitive shell-style wildcards.provider_crd_get_definition(provider_name, provider_version, crd_name, path?)returns the complete CRD definition as token-efficient YAML. Use a dotted path such as.specor.spec.versions[0]to return only a subtree.provider_crd_get_examples(provider_name, provider_version, crd_name)returns GitHub repository paths for generated and handwritten examples. Without an API version, it selects the latest served CRD API version, for exampleexamples-generated/namespaced/ec2/v1beta2/route.yaml.provider_crd_get_terraform_docs(provider_name, provider_version, crd_name)returns the Terraform provider repository, version, and documentation path. It reads the Crossplane provider Makefile and the generated controller mapping instead of inferring the Terraform resource name.
crd_name accepts a Kind, group/Kind, group/version/Kind, or a YAML fragment containing apiVersion and kind.
Use an OSS GitHub repository name such as crossplane-contrib/provider-upjet-aws or crossplane-contrib/function-go-templating. A small set of historical package aliases is mapped to their known OSS source repositories; unmapped upbound/... names are rejected rather than guessed.
The CRD tools require an explicit provider version. The value latest is also supported and selects the highest stable semantic-version Git tag. Self-hosted deployments need outbound HTTPS access to GITHUB_API_URL and GITHUB_RAW_URL.
Successful remote fetches are cached in memory. Git tag listings use the configurable short FETCH_CACHE_TTL_SECONDS (default: 300 seconds); CRDs, definitions, examples, and Terraform metadata resolved at immutable Git tags are cached for 30 days. FETCH_CACHE_MAX_ENTRIES (default: 512) bounds memory use.
Why this repository exists
Crossplane knowledge is distributed across many repositories and kinds of sources:
Go API types and runtime implementations
CustomResourceDefinitions and OpenAPI schemas
package metadata
tests and executable examples
official Crossplane documentation
community implementations and real-world composition examples
Upjet-based providers add another layer. Their Crossplane managed resources are generated from Terraform provider resources, while the Terraform documentation often contains more details about the underlying cloud APIs and configuration fields.
This repository connects these sources in one versioned catalog without replacing the original documentation.
Knowledge structure
Knowledge is stored as small Markdown documents under catalog/. Each document represents an independently useful concept and includes OKF metadata, provenance in sources, keyed claim footnotes, and relationships to related concepts.
Repository validation pins okf-ingest 0.11.0, which adds OKF v0.2 core support, including generated.at freshness fallback and preservation of the new frontmatter families (upstream support commit).
If the task is to build a Crossplane v2 Composition, start with the Composition developer route. It routes agents through separate API/provider, pipeline/security, and testing/packaging concepts without pretending that provider-specific schemas or credentials are universal.
The catalog is intended to be:
Source-backed: important statements link to source code, schemas, tests, examples, or official documentation.
Version-aware: sources are tied to specific repository revisions.
Navigable: overview documents connect related concepts without requiring readers to know the source repository layout.
Incremental: providers, functions, services, documentation areas, and example repositories can be added in focused batches.
License
This project is licensed under the Apache License 2.0.
.okf/sources.lock.yaml
Shown as plain text.
version: 1
sources:
okf-spec-v0.2:
repository: GoogleCloudPlatform/knowledge-catalog
branch: main
commit: 8e389230b1056946cbf98825da29ec75e5748b73
source_path: okf/SPEC.md
selected_by: user-requested OKF v0.2 migration
resolved_at: 2026-08-20
okf-ingest-v0.11.0:
repository: travisjakel/okf-ingest
version: 0.11.0
commit: f3b58994e54870dde37b2d42a7bff1c0ddbe17b0
source_path: py/okf/okf.py
selected_by: OKF v0.2 validation support
resolved_at: 2026-08-20
upbound-docs:
repository: upbound/docs
commit: 889d144d40620e05129a935824c592aece77657a
source_path: docs/manuals/packages/providers/provider-families.md
selected_by: user-supplied provider-family documentation
resolved_at: 2026-07-16
crossplane:
repository: crossplane/crossplane
tag: v2.4.0
commit: 61fa450c0c14a75bf5632872bd4a5b6945ec5a26
previous_tag: v2.3.3
previous_commit: 09ffaea39ccaea0f80817e35b5bbd3632b4e7e0d
selected_by: user-requested update-discovery checkpoint and provider-development orientation; no feature selected
resolved_at: 2026-09-05
crossplane-v2.4.2:
repository: crossplane/crossplane
tag: v2.4.2
commit: bf8ffd4048a0bb1b408b8b745e31960c717009cb
selected_by: latest stable Crossplane release; pipeline TTL selection for function-go-templating response TTL
resolved_at: 2026-10-16
crossplane-v2.0.0:
repository: crossplane/crossplane
tag: v2.0.0
commit: b639502e2f93680ff83417a0f517ec459ce079cc
selected_by: PR #6588 release containment and initial released behavior
resolved_at: 2026-07-16
crossplane-pr-6588:
repository: crossplane/crossplane
commit: b22c2bb24d30ef2c199e198353e33402484efed3
selected_by: merged PR #6588 project-history provenance
resolved_at: 2026-07-16
crossplane-v2.2.0:
repository: crossplane/crossplane
tag: v2.2.0
commit: b7aa9852801ca9959eefdad8233f95635df348c2
selected_by: XRD schema-root CEL validation release boundary
resolved_at: 2026-07-15
crossplane-pr-7018:
repository: crossplane/crossplane
commit: 7e8d6e108b846555abdd09f60188b7adcf451495
selected_by: post-v2.3.3 root XRD CEL-validation propagation, PR #7018 merge commit
resolved_at: 2026-07-15
crossplane-v1.17:
repository: crossplane/crossplane
tag: v1.17.3
commit: 481d3ca7193c89708b9a40375381862d25d64006
selected_by: native Composition environment removal boundary
resolved_at: 2026-07-14
crossplane-v1.18:
repository: crossplane/crossplane
tag: v1.18.0
commit: e663a43ece850e93fe5cdebb2e478e2fb9762ad1
selected_by: native Composition environment removal boundary
resolved_at: 2026-07-14
crossplane-docs:
repository: crossplane/docs
series: v2.4
commit: 1c17fdbf7fbadbb2399a40f86885deac0a35b867
selected_by: user-requested update-discovery checkpoint; no feature selected
resolved_at: 2026-09-05
crossplane-docs-v2.4:
repository: crossplane/docs
series: v2.4
commit: f51137d2f8e92a167bb580be528c78b879ed406d
selected_by: crossplane/v2.4.0 provider documentation
resolved_at: 2026-08-21
provider-template:
repository: crossplane/provider-template
branch: main
commit: a74b386da0ec848036e16ff0a207c5a16bc9827f
revision: immutable-main-snapshot
selected_by: user-requested provider-development SDK starting point
resolved_at: 2026-08-21
crossplane-runtime-provider-template:
repository: crossplane/crossplane-runtime
tag: v2.3.3
commit: fcf6aaa11ef4b56b9a8b1b91a446e0f6b8fc2827
selected_by: provider-template@a74b386da0ec848036e16ff0a207c5a16bc9827f go.mod
resolved_at: 2026-08-21
crossplane-build-provider-template:
repository: crossplane/build
commit: b964dbe0ff0856a762f1a06fe554c647d22af7f0
selected_by: provider-template@a74b386da0ec848036e16ff0a207c5a16bc9827f build submodule
resolved_at: 2026-08-21
crossplane-tools-provider-template:
repository: crossplane/crossplane-tools
version: v0.0.0-20260715161912-60e57f817ad1
commit: 60e57f817ad1f80dcf052a940cf923fde56fab1f
selected_by: provider-template@a74b386da0ec848036e16ff0a207c5a16bc9827f go.mod
resolved_at: 2026-08-21
crossplane-cli:
repository: crossplane/cli
tag: v2.5.0
commit: 1acb525095a4e43c9a765954efa66a47667a432b
previous_tag: v2.4.0
previous_commit: ef9b974770a45e085aacee3b2cdda6284ab6cf51
selected_by: user-selected okf-updates candidates [email protected]:F01-F06
resolved_at: 2026-10-16
crossplane-docs-cli-v2.5:
repository: crossplane/docs
series: cli-v2.5
commit: d1c9eb7fd1548d0d61ab3901781919a5b4aaf69d
selected_by: user-selected okf-updates candidates for [email protected]
resolved_at: 2026-10-16
xprin:
repository: crossplane-contrib/xprin
tag: v0.5.0
commit: eb5d7131c596e9a5663da349149184d54d704f42
previous_tag: v0.2.0
previous_commit: b5a100aa3e7118c1acdd2096b7993929939624b2
selected_by: user-selected okf-updates candidates [email protected]:F01-F05
resolved_at: 2026-10-16
kubernetes-website-v1.35:
repository: kubernetes/website
branch: release-1.35
commit: be897babb9149b808e2ab8ed5367e5d0651b3dca
selected_by: XRD-backed CRD schema, validation, versioning, and scale guidance
resolved_at: 2026-07-15
kubernetes-v1.35:
repository: kubernetes/kubernetes
tag: v1.35.0
commit: 66452049f3d692768c39c797b21b793dce80314e
selected_by: ValidatingAdmissionPolicy match-condition behavior and composed-resource metadata.name immutability
resolved_at: 2026-07-15
kyverno:
repository: kyverno/kyverno
tag: v1.18.2
commit: 945ac9ce8546ea6cd51370f24b615148c577da5e
selected_by: tenant namespace-label validation and controller exclusions
resolved_at: 2026-07-15
kyverno-website:
repository: kyverno/website
commit: e8d76c57e95060e61a8e864178862747a3a693fb
selected_by: official Kyverno admission-policy documentation
resolved_at: 2026-07-15
crossplane-docs-v1.18:
repository: crossplane/docs
series: v1.18
commit: ad7f75a96dc902b1cdfee213255d87612fccbdbe
selected_by: historical migration documentation
resolved_at: 2026-07-14
argo-cd:
repository: argoproj/argo-cd
tag: v3.1.16
commit: 5d001b80990d14c0fc9b2cbee1eac25fc288da15
feature_first_stable_tag: v3.1.0
feature_first_stable_commit: 03c4ad854c1e6d922a121cd40f505d9bc6e402da
feature_merge_commit: 9149021b2cd1f7ed7d2ba711643b560127f81ad0
selected_by: user-requested Argo CD 3.1 release line
resolved_at: 2026-07-14
cli-utils-kstatus:
repository: kubernetes-sigs/cli-utils
commit: 45a0b5b7e6b292c0a59c899aa50a3662a0c1cf7d
selected_by: crossplane/crossplane issue 2672 maintainer reference
resolved_at: 2026-07-14
crd-catalog:
repository: CustomResourceDefinition/catalog
commit: 0584c9f7e6eaef8367cd65e59266d8ad49764f0c
selected_by: community CRD definition discovery for local validation coverage
resolved_at: 2026-07-16
flux-website:
repository: fluxcd/website
series: v2-9
commit: 32b8fe6417a23265c1d8eb2851ce8f0f7ef85317
selected_by: user-requested Flux v2.9 documentation track
resolved_at: 2026-07-14
crossplane-runtime:
repository: crossplane/crossplane-runtime
tag: v2.4.0
commit: 71f319796d597c2c6cf004cc4bf5f44011a5aeaa
previous_tag: v2.3.3
previous_commit: fcf6aaa11ef4b56b9a8b1b91a446e0f6b8fc2827
selected_by: [email protected]:F01 CRD cache schema-stripping transform
resolved_at: 2026-08-19
crossplane-runtime-pr-788:
repository: crossplane/crossplane-runtime
commit: 5faceb9d8a2cf6d839ab193d91a503dd619f8f2c
selected_by: PR #788 merge containment base for management-policy project history
resolved_at: 2026-07-16
crossplane-runtime-pr-906:
repository: crossplane/crossplane-runtime
commit: 311ca76bbd30f86e196438771062091a39e39e0d
selected_by: PR #906 merge containment base for real-time composition project history
resolved_at: 2026-07-16
function-kro:
repository: crossplane-contrib/function-kro
tag: v0.3.0
commit: a0b4c088bd950cb407901d01ee29263e6d54d639
release_status: prerelease
selected_by: user-approved preview revision
resolved_at: 2026-08-21
function-kro-kro:
repository: kubernetes-sigs/kro
tag: v0.9.2
commit: 22f5645777c86ebd40b6143f248549f1dbe2923f
source_path: website/docs
selected_by: function-kro v0.3.0 go.mod
resolved_at: 2026-08-21
crossplane-cli-kro:
repository: kubernetes-sigs/kro
tag: v0.9.2
commit: 22f5645777c86ebd40b6143f248549f1dbe2923f
source_path: website/docs/api/specifications/simple-schema.md
selected_by: crossplane/cli v2.5.0 go.mod SimpleSchema dependency
resolved_at: 2026-10-16
function-go-templating:
repository: crossplane-contrib/function-go-templating
tag: v0.13.0
commit: 9b7ea49394a7cef38fe517d2b60f55d64c4c8511
previous_tag: v0.12.4
previous_commit: fe17e68927afd64046232f39a2376e87b45e2f58
selected_by: user-selected okf-updates candidates [email protected]:F01-F04
resolved_at: 2026-10-16
function-sdk-go-v0.7.1:
repository: crossplane/function-sdk-go
tag: v0.7.1
commit: 176ccd5428a608f823c8c7562ffb090ca2c166d5
selected_by: function-go-templating v0.13.0 go.mod; response TTL default and semantics
resolved_at: 2026-10-16
function-go-templating-pr-498:
repository: crossplane-contrib/function-go-templating
commit: fba11b570e75660b1ff52b05979ba805baae1a51
selected_by: PR #498 merge containment base for ExtraResources namespace project history
resolved_at: 2026-07-16
function-sequencer:
repository: crossplane-contrib/function-sequencer
tag: v0.6.0
commit: 8ee29b46b7b9491fb307cf6caf339541a8d93422
previous_tag: v0.5.0
previous_commit: 33505d3c6fb203b1f5f7a0257c28a8de3001ebf9
resolved_at: 2026-07-16
crossplane-pr-6345:
repository: crossplane/crossplane
commit: b90c89203554e2a4a0d5af0eecd72846a4b48c6d
selected_by: PR #6345 diverged merge comparison for Usage API historical context
resolved_at: 2026-07-16
function-environment-configs:
repository: crossplane-contrib/function-environment-configs
tag: v0.7.2
commit: 5589092483aea1d65b9988f5116106585c4b516b
previous_tag: v0.7.1
previous_commit: 054a6b8d08ae3e0c957a0e75359b14f88340ca39
resolved_at: 2026-07-14
function-auto-ready:
repository: crossplane-contrib/function-auto-ready
tag: v0.7.0
commit: ed7886de159af73b9d6976f04f9171ec7a4cb411
previous_tag: v0.6.6
previous_commit: 046fe9eca400dfdb835911d8b22da9b0e27a5547
resolved_at: 2026-07-14
function-sequencer-post-v060:
repository: crossplane-contrib/function-sequencer
commit: e277a4070f65fc50dfb08b03d2acdcbdbfe1350b
selected_by: user-requested post-v0.6.0 Input-property research; not a released stable source
resolved_at: 2026-07-16
sveltos-addon-controller:
repository: projectsveltos/addon-controller
tag: v1.12.0
commit: b528b72dedf369566470709796d23d93fa1827b1
resolved_at: 2026-07-14
sveltos-libsveltos:
repository: projectsveltos/libsveltos
tag: v1.12.0
commit: 82cc79ba33929ffd061ee75f106a3bd8b70addcd
resolved_at: 2026-07-14
provider-opentofu:
repository: upbound/provider-opentofu
tag: v1.1.4
commit: 6a1a4f3a3c174b4f6d91c84e74c4a5b6781b0609
resolved_at: 2026-07-14
provider-upjet-aws:
repository: crossplane-contrib/provider-upjet-aws
tag: v2.6.0
commit: 857b535dd0eb9b8242ad9d7c4e54aaa3e4616d60
selected_by: provider-domain foundation and AWS provider comparison
resolved_at: 2026-07-15
provider-upjet-azure:
repository: crossplane-contrib/provider-upjet-azure
tag: v2.6.0
commit: e0398bae1693e229c9060631e048b93177df6fa4
selected_by: provider connection-detail source retrieval
resolved_at: 2026-07-18
crossplane-runtime-provider-upjet-azure:
repository: crossplane/crossplane-runtime
tag: v2.2.1
commit: 504c43e478d7364d73a1834ba277e3a9f94b8e0a
selected_by: provider-upjet-azure v2.6.0 connection-detail key constants
resolved_at: 2026-07-18
provider-aws:
repository: crossplane-contrib/provider-aws
tag: v0.58.0
commit: 405d4d48d20c332ee427beb4187f80cc4b0af4ea
selected_by: provider-domain foundation and AWS provider comparison
resolved_at: 2026-07-15
upjet:
repository: crossplane/upjet
tag: v2.3.0
commit: b02902e67b336b94e6bd119b86d14077ed0a0a32
selected_by: provider-domain implementation-family guidance
resolved_at: 2026-07-15
terraform-provider-aws:
repository: hashicorp/terraform-provider-aws
tag: v6.34.0
commit: b53a72bc2e0bf0395b4b1f91e06340785ddaac86
selected_by: provider-upjet-aws v2.6.0 Makefile documentation baseline
resolved_at: 2026-07-15
provider-kubernetes:
repository: crossplane-contrib/provider-kubernetes
tag: v1.2.1
commit: 0ea671a4dab090ff3b14877d35086f1950fa35e3
resolved_at: 2026-07-14
provider-sql-schema-navigation:
repository: crossplane-contrib/provider-sql
commit: 9665c434424129d54f2bc265f5921fa3dab29581
selected_by: provider CRD source-tree navigation snapshot
resolved_at: 2026-07-16
provider-sql-connection-details:
repository: crossplane-contrib/provider-sql
tag: v0.15.0
commit: 0c8113bf3811a8b7d469d1dc88fed4f46ad5ec96
selected_by: provider connection-detail source retrieval
resolved_at: 2026-07-18
crossplane-runtime-provider-sql:
repository: crossplane/crossplane-runtime
tag: v2.1.0
commit: 9711defba79c6128064740b18b38a4991a0e9db2
selected_by: provider-sql v0.15.0 connection-detail type and publisher
resolved_at: 2026-07-18
provider-gitlab-schema-navigation:
repository: crossplane-contrib/provider-gitlab
commit: c2a24e3ffe91fc25926c2f558f6b1cc97d60e3ee
selected_by: provider CRD source-tree navigation snapshot
resolved_at: 2026-07-16
provider-kubernetes-schema-navigation:
repository: crossplane-contrib/provider-kubernetes
commit: 46af47297f636dc015afdf5743929c12990a5fc5
selected_by: provider CRD source-tree navigation snapshot
resolved_at: 2026-07-16
upbound-provider-aws-s3-api:
package: upbound/provider-aws-s3
version: v2.6.1
resource_inventory: https://api.upbound.io/v1/packages/upbound/provider-aws-s3/v2.6.1/resources
selected_by: provider CRD registry discovery reference
resolved_at: 2026-07-16
kubernetes-reflector:
repository: emberstack/kubernetes-reflector
tag: v10.0.59
commit: d5b9b2f83269cdb94647088a1fcf83b1b0081ff6
resolved_at: 2026-07-14
kubernetes-replicator:
repository: mittwald/kubernetes-replicator
tag: v2.12.4
commit: 44dc6db78c584771832a84a41cd06a1701a39fc0
resolved_at: 2026-07-14
sprig:
repository: Masterminds/sprig
tag: v3.3.0
commit: e708470d529a10ac1a3f02ab6fdd339b65958372
selected_by: function-go-templating/go.mod
resolved_at: 2026-07-12
go-text-template:
repository: golang/go
tag: go1.25.3
commit: 28622c19591d95c9a83f706f2ed1b303d58da85f
selected_by: Go text/template whitespace-trimming behavior for function-go-templating YAML rendering guidance
resolved_at: 2026-07-16
go-text-template-v1.25.11:
repository: golang/go
tag: go1.25.11
commit: d563bc4ba3301156c1e6b115a89c659b00d71fe7
selected_by: Go text/template variable assignment and break behavior for ExtraResources consumption filtering
resolved_at: 2026-07-16
yq:
repository: mikefarah/yq
tag: v4.53.3
commit: 1b9b4ac5187171d2e5e3129be0cfa827c7f9d53d
selected_by: multi-document YAML parse and pretty-print validation guidance
resolved_at: 2026-07-16
external-secrets:
repository: external-secrets/external-secrets
tag: v2.7.0
commit: e215053f3e68504de7483f9542b49f19f98293a1
selected_by: user-requested PushSecret pattern
resolved_at: 2026-07-16
242 files
- .agents/agents/okf-crossplane-cli-update-researcher/AGENT.md
- .agents/agents/okf-crossplane-core-code-researcher/AGENT.md
- .agents/agents/okf-crossplane-core-design-researcher/AGENT.md
- .agents/agents/okf-crossplane-core-docs-researcher/AGENT.md
- .agents/agents/okf-crossplane-core-update-researcher/AGENT.md
- .agents/agents/okf-crossplane-docs-update-researcher/AGENT.md
- .agents/agents/okf-crossplane-researcher/AGENT.md
- .agents/agents/okf-crossplane-runtime-update-researcher/AGENT.md
- .agents/agents/okf-function-auto-ready-researcher/AGENT.md
- .agents/agents/okf-function-environment-configs-researcher/AGENT.md
- .agents/agents/okf-function-go-templating-project-history-researcher/AGENT.md
- .agents/agents/okf-function-go-templating-researcher/AGENT.md
- .agents/agents/okf-function-go-templating-sprig-researcher/AGENT.md
- .agents/agents/okf-function-go-templating-update-researcher/AGENT.md
- .agents/agents/okf-function-kro-kro-researcher/AGENT.md
- .agents/agents/okf-function-kro-researcher/AGENT.md
- .agents/agents/okf-function-sdk-go-researcher/AGENT.md
- .agents/agents/okf-function-sequencer-researcher/AGENT.md
- .agents/agents/okf-function-sequencer-update-researcher/AGENT.md
- .agents/agents/okf-function-tag-manager-researcher/AGENT.md
- .agents/agents/okf-reviewer/AGENT.md
- .agents/agents/okf-source-scout/AGENT.md
- .agents/agents/okf-upjet-researcher/AGENT.md
- .agents/agents/okf-xprin-update-researcher/AGENT.md
- .agents/skills/okf-open-knowledge-format/SKILL.md
- .agents/skills/okf-open-knowledge-format/references/conversion.md
- .agents/skills/okf-open-knowledge-format/references/examples.md
- .agents/skills/okf-open-knowledge-format/references/spec-v02.md
- .agents/skills/okf-open-knowledge-format/scripts/validate.sh
- .agents/skills/okf-updates/SKILL.md
- .agents/skills/okf-updates/agents/openai.yaml
- .agents/skills/okf/SKILL.md
- .agents/skills/okf/agents/openai.yaml
- .agents/skills/okf/references/evidence-contract.md
- .agents/skills/okf/references/okf-profile.md
- .agents/skills/okf/references/okf-spec.md
- .agents/skills/okf/references/sources.yaml
- .codespellrc
- .codex-plugin/plugin.json
- .codex/agents/okf-crossplane-cli-update-researcher.toml
- .codex/agents/okf-crossplane-core-code-researcher.toml
- .codex/agents/okf-crossplane-core-design-researcher.toml
- .codex/agents/okf-crossplane-core-docs-researcher.toml
- .codex/agents/okf-crossplane-core-update-researcher.toml
- .codex/agents/okf-crossplane-docs-update-researcher.toml
- .codex/agents/okf-crossplane-researcher.toml
- .codex/agents/okf-crossplane-runtime-update-researcher.toml
- .codex/agents/okf-function-auto-ready-researcher.toml
- .codex/agents/okf-function-environment-configs-researcher.toml
- .codex/agents/okf-function-go-templating-project-history-researcher.toml
- .codex/agents/okf-function-go-templating-researcher.toml
- .codex/agents/okf-function-go-templating-sprig-researcher.toml
- .codex/agents/okf-function-go-templating-update-researcher.toml
- .codex/agents/okf-function-kro-kro-researcher.toml
- .codex/agents/okf-function-kro-researcher.toml
- .codex/agents/okf-function-sdk-go-researcher.toml
- .codex/agents/okf-function-sequencer-researcher.toml
- .codex/agents/okf-function-sequencer-update-researcher.toml
- .codex/agents/okf-function-tag-manager-researcher.toml
- .codex/agents/okf-reviewer.toml
- .codex/agents/okf-source-scout.toml
- .codex/agents/okf-upjet-researcher.toml
- .codex/agents/okf-xprin-update-researcher.toml
- .codex/config.toml
- .dockerignore
- .editorconfig
- .github/workflows/ci.yaml
- .github/zizmor.yml
- .gitignore
- .mcp.json
- .okf/claim-ledger.md
- .okf/sources.lock.yaml
- .pi/agents/okf-crossplane-cli-update-researcher.md
- .pi/agents/okf-crossplane-core-code-researcher.md
- .pi/agents/okf-crossplane-core-design-researcher.md
- .pi/agents/okf-crossplane-core-docs-researcher.md
- .pi/agents/okf-crossplane-core-update-researcher.md
- .pi/agents/okf-crossplane-docs-update-researcher.md
- .pi/agents/okf-crossplane-researcher.md
- .pi/agents/okf-crossplane-runtime-update-researcher.md
- .pi/agents/okf-function-auto-ready-researcher.md
- .pi/agents/okf-function-environment-configs-researcher.md
- .pi/agents/okf-function-go-templating-project-history-researcher.md
- .pi/agents/okf-function-go-templating-researcher.md
- .pi/agents/okf-function-go-templating-sprig-researcher.md
- .pi/agents/okf-function-go-templating-update-researcher.md
- .pi/agents/okf-function-kro-kro-researcher.md
- .pi/agents/okf-function-kro-researcher.md
- .pi/agents/okf-function-sdk-go-researcher.md
- .pi/agents/okf-function-sequencer-researcher.md
- .pi/agents/okf-function-sequencer-update-researcher.md
- .pi/agents/okf-function-tag-manager-researcher.md
- .pi/agents/okf-reviewer.md
- .pi/agents/okf-source-scout.md
- .pi/agents/okf-upjet-researcher.md
- .pi/agents/okf-xprin-update-researcher.md
- .pi/prompts/okf-updates.md
- .pi/prompts/okf.md
- .pi/settings.json
- .plugin/plugin.json
- AGENTS.md
- ATTRIBUTION.md
- Dockerfile
- LICENSE
- README.md
- catalog/cli/control-plane-projects.md
- catalog/cli/generated-go-model-accessors.md
- catalog/cli/generated-go-runtime-objects.md
- catalog/cli/index.md
- catalog/cli/local-composition-rendering.md
- catalog/cli/xrd-convert.md
- catalog/composition-api-and-provider-contracts.md
- catalog/composition-developer-starter.md
- catalog/composition-pipeline-and-security.md
- catalog/composition-testing-and-packaging.md
- catalog/core/composed-resource-identity-and-replacement.md
- catalog/core/composed-resource-rbac.md
- catalog/core/composite-resource-definition.md
- catalog/core/composite-resource-model.md
- catalog/core/composition-gitops-health.md
- catalog/core/composition-project-layout.md
- catalog/core/composition.md
- catalog/core/configurations/configuration.md
- catalog/core/configurations/dependencies-and-authoring.md
- catalog/core/configurations/index.md
- catalog/core/configurations/package.md
- catalog/core/configurations/revision.md
- catalog/core/controlled-rollout-of-composition-functions-design.md
- catalog/core/cross-namespace-synchronization-patterns.md
- catalog/core/environment-config.md
- catalog/core/index.md
- catalog/core/managed-resource-activation-policy.md
- catalog/core/managed-resource-anatomy.md
- catalog/core/managed-resource-controls-and-conditions.md
- catalog/core/managed-resource-definition.md
- catalog/core/managed-resource-external-identity.md
- catalog/core/managed-resource-lifecycle.md
- catalog/core/managed-resource-management-policies-project-history.md
- catalog/core/managed-resource-management-policies.md
- catalog/core/managed-resource-references-and-provider-config.md
- catalog/core/managed-resources.md
- catalog/core/minimal-managed-resource-activation.md
- catalog/core/namespaced-composition-boundaries.md
- catalog/core/native-composition-environment-removal.md
- catalog/core/pushsecret-external-store-pattern.md
- catalog/core/realtime-composition-project-history.md
- catalog/core/realtime-composition-reconciliation.md
- catalog/core/tenant-xr-api-security.md
- catalog/core/usages-and-clusterusages.md
- catalog/core/xrd-api-version-evolution.md
- catalog/core/xrd-cel-validation.md
- catalog/core/xrd-openapi-schema.md
- catalog/core/xrd-subresources-and-display.md
- catalog/core/xrd-unknown-data.md
- catalog/functions/composition-function-specification.md
- catalog/functions/composition-functions.md
- catalog/functions/environment-config-pipeline.md
- catalog/functions/function-auto-ready/built-in-health-checks.md
- catalog/functions/function-auto-ready/cel-health-checks.md
- catalog/functions/function-auto-ready/index.md
- catalog/functions/function-auto-ready/input.md
- catalog/functions/function-auto-ready/package.md
- catalog/functions/function-auto-ready/readiness.md
- catalog/functions/function-environment-configs/index.md
- catalog/functions/function-environment-configs/input.md
- catalog/functions/function-environment-configs/package.md
- catalog/functions/function-environment-configs/selection-and-merge.md
- catalog/functions/function-go-templating/connection-details.md
- catalog/functions/function-go-templating/context.md
- catalog/functions/function-go-templating/environment-source.md
- catalog/functions/function-go-templating/extra-resources.md
- catalog/functions/function-go-templating/index.md
- catalog/functions/function-go-templating/input.md
- catalog/functions/function-go-templating/package.md
- catalog/functions/function-go-templating/patterns/index.md
- catalog/functions/function-go-templating/patterns/manual-readiness.md
- catalog/functions/function-go-templating/patterns/non-composed-resource-readiness.md
- catalog/functions/function-go-templating/patterns/provider-backed-external-query.md
- catalog/functions/function-go-templating/patterns/provider-kubernetes-object-readiness.md
- catalog/functions/function-go-templating/patterns/safe-status-and-connection-publication.md
- catalog/functions/function-go-templating/patterns/sveltos-clustersummary-readiness.md
- catalog/functions/function-go-templating/patterns/yaml-document-boundaries.md
- catalog/functions/function-go-templating/project-history.md
- catalog/functions/function-go-templating/rendered-output.md
- catalog/functions/function-go-templating/request-data.md
- catalog/functions/function-go-templating/response-ttl.md
- catalog/functions/function-go-templating/runtime-options.md
- catalog/functions/function-go-templating/sprig.md
- catalog/functions/function-go-templating/template-functions.md
- catalog/functions/function-kro/graph-evaluation.md
- catalog/functions/function-kro/index.md
- catalog/functions/function-kro/input.md
- catalog/functions/function-kro/package.md
- catalog/functions/function-sequencer/index.md
- catalog/functions/function-sequencer/input.md
- catalog/functions/function-sequencer/sequencing.md
- catalog/functions/index.md
- catalog/functions/operation-functions.md
- catalog/functions/overview.md
- catalog/functions/package.md
- catalog/functions/scheduled-and-watched-operations.md
- catalog/index.md
- catalog/log.md
- catalog/providers/crd-schema-discovery.md
- catalog/providers/index.md
- catalog/providers/provider-connection-details-source-retrieval.md
- catalog/providers/provider-families.md
- catalog/providers/provider-landscape.md
- catalog/providers/provider-package-revisions.md
- catalog/providers/upjet-terraform-provenance.md
- catalog/sdk/crd-cache-schema-stripping.md
- catalog/sdk/index.md
- catalog/sdk/provider-development/generate-test-package.md
- catalog/sdk/provider-development/index.md
- catalog/sdk/provider-development/managed-reconciler.md
- catalog/sdk/provider-development/managed-resource-apis.md
- catalog/sdk/provider-development/provider-configuration.md
- catalog/sdk/provider-development/start-here.md
- catalog/tools/index.md
- catalog/tools/xprin-crossplane-cli-tiers.md
- catalog/tools/xprin-crossplane-version.md
- catalog/tools/xprin-function-container-reuse.md
- catalog/tools/xprin-test-artifacts-export.md
- catalog/tools/xprin-test-suites.md
- catalog/tools/xprin-update-goldens.md
- compose.yaml
- mcp/README.md
- mcp/entrypoint.sh
- mcp/fetch_cache.py
- mcp/git_source.py
- mcp/github_source.py
- mcp/provider_crd_tools.py
- mcp/pyproject.toml
- mcp/server.py
- mcp/tests/test_git_source.py
- mcp/tests/test_github_source.py
- mcp/tests/test_provider_crd_tools.py
- mcp/uv.lock
- mise.toml
- renovate.json
- skills-lock.json
- skills/crossplane-v2-okf/SKILL.md
Advantages
- Provides version-aware knowledge by linking facts to specific repository revisions. evidence: README.md
- Connects distributed sources like Go APIs, CRDs, and documentation into a single navigable catalog. evidence: README.md
Limitations
- The public MCP server is provided as an early-access service and is not intended for production use without self-hosting. evidence: README.md
- Requires explicit provider versions for CRD tools, as it does not guess or infer versions automatically. evidence: README.md
Security
Risk level: Low risk
This brain runs
Agent instructions that run or fetch something (26)
.agents/agents/okf-function-go-templating-researcher/AGENT.md:Write for Crossplane users who want to install and use `function-go-templating` in Compositions..agents/agents/okf-reviewer/AGENT.md:`mise run lint` succeeds after the final fixes and before the root or parent agent creates a commit..agents/agents/okf-reviewer/AGENT.md:Run `mise run lint` as the final validation command..agents/skills/okf-open-knowledge-format/SKILL.md:If the user agrees to install:.agents/skills/okf-open-knowledge-format/SKILL.md:uv tool install okflint.agents/skills/okf-open-knowledge-format/SKILL.md:pip install okflint.agents/skills/okf-open-knowledge-format/SKILL.md:kcmd push --dry-run.agents/skills/okf-updates/SKILL.md:Run this workflow only after the user explicitly invokes `$okf-updates`, `/skill:okf-updates`, or `/okf-updates`..agents/skills/okf-updates/SKILL.md:Run at most three direct researchers at once..agents/skills/okf-updates/SKILL.md:A requester reply that selects one or more candidate IDs from this explicitly invoked workflow is explicit permission to run the normal OKF update logic for those candidates..agents/skills/okf-updates/SKILL.md:Run deterministic validation, `okf-reviewer`, and `mise run lint`..agents/skills/okf/SKILL.md:Run this workflow only after the user explicitly invokes `$okf`, `/skill:okf`, or `/okf`..agents/skills/okf/SKILL.md:After all review fixes, run `mise run lint`..agents/skills/okf/SKILL.md:Commit every intended file only after reviewer approval and a successful lint run..agents/skills/okf/SKILL.md:Run the Core docs and Core code researchers together when a concept needs both user-facing guidance and exact served API shape..agents/skills/okf/SKILL.md:Run independent read-heavy research in parallel, with at most three direct agents..agents/skills/okf/SKILL.md:After all fixes, run `mise run lint` and fix every reported issue..agents/skills/okf/SKILL.md:The reviewer may return `APPROVED` only after the final lint run succeeds..agents/skills/okf/SKILL.md:Non-thinking coding models such as Qwen3-Coder-Next can run every project agent without incompatible reasoning controls..agents/skills/okf/SKILL.md:deterministic validation and `mise run lint` resultsAGENTS.md:Run the normal workflow only when the user explicitly invokes `$okf`, `/skill:okf`, or `/okf`, or selects a feature candidate returned by an explicitly invoked `$okf-updates`, `/skill:okf-updates`, or `/okf-updates` workflow.AGENTS.md:Run update discovery only when the user explicitly invokes `$okf-updates`, `/skill:okf-updates`, or `/okf-updates`.AGENTS.md:Run deterministic validation and the `okf-reviewer` before committing the changes.AGENTS.md:After the final review fixes, run `mise run lint` before creating any commit.AGENTS.md:After reviewer approval and a successful lint run, commit every intended change.AGENTS.md:Create commits with a Developer Certificate of Origin sign-off by default by using `git commit --signoff` (or `git commit -s`).
MCP servers (1)
.mcp.json(crossplane-v2-okf):https://crossplane.mcp.jkroepke.de/mcp· uses the network
- Low risk: network-instructions (.agents/skills/okf-open-knowledge-format/SKILL.md:214)
Attribution and licence
- First committed by
jkroepke
- Publisher
- Jan-Otto Kröpke (Community)
- Source
- jkroepke/okf-crossplane-v2 · commit df24ac2
- Licence
- Apache License 2.0 (files served here)
- ATTRIBUTION.md (written by AutoGineer)
- Synced
- Contributors
- jkroepke
AutoGineer is not affiliated with or endorsed by jkroepke.
Download
The ZIP holds the files AutoGineer serves, with ATTRIBUTION.md and the licence. Download okf-crossplane-v2.zip