Open Knowledge Format for Crossplane v2: LLM wiki kit by Jan-Otto Kröpke

What it is

LLM-wiki in OKF (Open Knowledge Format) for Crossplane v2

— the description by jkroepke

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.

Folders
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/mcp

Your 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-v2

Pass --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 \
  --global

Then 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 \
  --global

Both 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 --detach

To 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 .spec or .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 example examples-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.

.agents/skills/okf/references/sources.yaml

Shown as plain text.

version: 2

normative_sources:
  - id: okf-spec
    version: "0.2"
    url: https://github.com/GoogleCloudPlatform/knowledge-catalog/blob/main/okf/SPEC.md

reference_sources:
  - id: okf-demo-catalog
    repository: GoogleCloudPlatform/knowledge-catalog
    paths:
      - toolbox/mdcode/demo/okf/catalog

primary_sources:
  - id: crossplane
    repository: crossplane/crossplane
    kind: crossplane-core
    release_policy: latest-stable
    research_profiles:
      core-crds:
        agent: okf-crossplane-core-code-researcher
        paths:
          - cluster/crds
        legacy_exclusions:
          - Claims and claim APIs
          - deprecated CompositeResourceDefinition v1 schema
          - legacy v1 composite-resource semantics
  - id: crossplane-cli
    repository: crossplane/cli
    kind: cli
    domain: crossplane-cli
    core_scope: false
  - id: crossplane-runtime
    repository: crossplane/crossplane-runtime
    kind: provider-sdk
  - id: crossplane-tools
    repository: crossplane/crossplane-tools
    kind: development-tools
  - id: provider-template
    repository: crossplane/provider-template
    kind: provider-development-template
    audience: developer
    revision_policy: pin-current-main-commit-at-research-time
    agent: okf-crossplane-researcher
    paths:
      - README.md
      - PROVIDER_CHECKLIST.md
      - .gitmodules
      - Makefile
      - go.mod
      - apis
      - internal/controller
      - cmd/provider
      - hack/helpers
      - examples
      - package
      - cluster/local/integration_tests.sh
      - LICENSE
    version_dependencies:
      crossplane-runtime: exact-version-from-go-mod
      crossplane-build: exact-submodule-commit
      crossplane-tools: exact-version-from-go-mod
    supporting_sources:
      - crossplane-build
      - crossplane-tools
    legacy_exclusions:
      - Claims and claim references
      - deprecated XRD v1 and legacy v1 XR semantics
      - deprecated generator modes not selected by the template's modern APIs
  - id: function-sdk-go
    repository: crossplane/function-sdk-go
    kind: function-sdk
    audience: developer
    agent: okf-function-sdk-go-researcher
  - id: function-kro
    repository: crossplane-contrib/function-kro
    kind: function
    audience: user
    release_policy: discover-highest-stable-semver-tag
    agent_set:
      primary: okf-function-kro-researcher
      kro: okf-function-kro-kro-researcher
    paths:
      - README.md
      - package/crossplane.yaml
      - package/input
      - input
      - fn.go
      - fn_test.go
      - main.go
      - kro
      - schemas
      - example
      - go.mod
      - LICENSE
    supporting_sources:
      - function-kro-kro
    legacy_exclusions:
      - examples requiring Claims or claim references
      - examples requiring deprecated v1 XRD or legacy v1 XR semantics
  - id: function-go-templating
    repository: crossplane-contrib/function-go-templating
    kind: function
    audience: user
    release_policy: discover-highest-stable-semver-tag
    agent_set:
      primary: okf-function-go-templating-researcher
      sprig: okf-function-go-templating-sprig-researcher
      project_history: okf-function-go-templating-project-history-researcher
    paths:
      - README.md
      - example
      - package/input/gotemplating.fn.crossplane.io_gotemplates.yaml
      - function_maps.go
      - go.mod
    supporting_sources:
      - sprig
      - function-go-templating-project-history
    legacy_exclusions:
      - README section v1 Composite Resources (Legacy)
      - examples requiring Claims or claim references
      - examples requiring deprecated v1 XRD or legacy v1 XR semantics
  - id: function-environment-configs
    repository: crossplane-contrib/function-environment-configs
    kind: function
    audience: user
    release_policy: discover-highest-stable-semver-tag
    agent_set:
      primary: okf-function-environment-configs-researcher
    paths:
      - README.md
      - package/crossplane.yaml
      - fn.go
      - fn_test.go
      - input
      - package/input
      - examples
      - go.mod
    legacy_exclusions:
      - examples requiring Claims or claim references
      - examples requiring deprecated v1 XRD or legacy v1 XR semantics
  - id: xprin
    repository: crossplane-contrib/xprin
    kind: composition-test-tool
  - id: function-sequencer
    repository: crossplane-contrib/function-sequencer
    kind: function
    audience: user
    release_policy: discover-highest-stable-semver-tag
    agent_set:
      primary: okf-function-sequencer-researcher
    paths:
      - README.md
      - package/crossplane.yaml
      - package/input
      - input
      - fn.go
      - fn_test.go
      - main.go
      - example
      - examples
      - go.mod
    legacy_exclusions:
      - examples requiring Claims or claim references
      - examples requiring deprecated v1 XRD or legacy v1 XR semantics
  - id: function-auto-ready
    repository: crossplane-contrib/function-auto-ready
    kind: function
    audience: user
    release_policy: discover-highest-stable-semver-tag
    agent_set:
      primary: okf-function-auto-ready-researcher
    paths:
      - README.md
      - package/crossplane.yaml
      - fn.go
      - fn_test.go
      - main.go
      - features
      - cel
      - healthchecks
      - input
      - package/input/autoready.fn.crossplane.io_inputs.yaml
      - example
      - go.mod
    legacy_exclusions:
      - examples requiring Claims or claim references
      - examples requiring deprecated v1 XRD or legacy v1 XR semantics
  - id: provider-kubernetes
    repository: crossplane-contrib/provider-kubernetes
    kind: native-provider
  - id: provider-sql
    repository: crossplane-contrib/provider-sql
    kind: native-provider
  - id: provider-gitlab
    repository: crossplane-contrib/provider-gitlab
    kind: native-provider
  - id: provider-helm
    repository: crossplane-contrib/provider-helm
    kind: native-provider
  - id: provider-opentofu
    repository: upbound/provider-opentofu
    kind: native-provider
    release_policy: discover-highest-stable-semver-tag
    provider_family: bespoke-opentofu-workspace-provider
  - id: function-patch-and-transform
    repository: crossplane-contrib/function-patch-and-transform
    kind: function
  - id: provider-upjet-aws
    repository: crossplane-contrib/provider-upjet-aws
    kind: upjet-provider
    terraform_source: terraform-provider-aws
    release_policy: discover-highest-stable-semver-tag
    provider_family: upjet-generated
    supporting_sources:
      - upjet
      - terraform-provider-aws
    family_provider_source:
      package_metadata: package/crossplane.yaml.tmpl
      resource_packages: docs/family
  - id: provider-aws
    repository: crossplane-contrib/provider-aws
    kind: provider
    release_policy: discover-highest-stable-semver-tag
    provider_family: aws-go-codegen-with-manual-controller-work
    related_provider: provider-upjet-aws
  - id: provider-upjet-azure
    repository: crossplane-contrib/provider-upjet-azure
    kind: upjet-provider
    terraform_source: terraform-provider-azurerm
  - id: function-tag-manager
    repository: crossplane-contrib/function-tag-manager
    kind: function
    audience: user
    release_policy: discover-highest-stable-semver-tag
    agent_set:
      primary: okf-function-tag-manager-researcher
    paths:
      - README.md
      - package/crossplane.yaml
      - package/input/tag-manager.fn.crossplane.io_managedtags.yaml
      - input
      - fn.go
      - fn_test.go
      - filter.go
      - filter_test.go
      - filters
      - tags.go
      - tags_test.go
      - main.go
      - examples
      - go.mod
      - LICENSE
    legacy_exclusions:
      - examples requiring Claims or claim references
      - examples requiring deprecated v1 XRD or legacy v1 XR semantics

documentation_sources:
  - id: crossplane-cli-docs
    repository: crossplane/docs
    kind: official-documentation
    domain: crossplane-cli
    core_scope: false
    agent: okf-crossplane-researcher
    revision_policy: reuse-existing-lock
    lock_id: crossplane-docs-v2.4
    paths:
      - content/cli/v2.4/get-started/get-started-with-control-plane-projects.md
      - content/cli/v2.4/command-reference.md
    focus:
      - control-plane-projects
      - composition-authoring
      - local-development
      - package-build-and-push
    legacy_exclusions:
      - Claims and claim workflows
      - deprecated CompositeResourceDefinition v1 schema
      - legacy v1 composite-resource semantics
    version_scope: cli-v2.4
  - id: crossplane-docs
    repository: crossplane/docs
    kind: official-documentation
    agent: okf-crossplane-core-docs-researcher
    release_policy: match-latest-stable-crossplane-major-minor
    path_template: content/v{major}.{minor}
    exclude_paths:
      - content/master
      - content/cli
      - content/v1.*
    focus:
      - composition
      - managed-resources
      - operations
      - packages/providers
      - packages/functions
      - release-cycle
      - feature-lifecycle
    legacy_exclusions:
      - Claims and claim workflows
      - v1 Composite Resources (Legacy)
      - deprecated CompositeResourceDefinition v1 schema
      - v1-to-v2 migration guidance unless explicitly requested
    version_scope: current-stable-v2

historical_design_sources:
  - id: crossplane-core-designs
    repository: crossplane/crossplane
    kind: historical-design
    authority: historical-design
    agent: okf-crossplane-core-design-researcher
    revision_policy: pin-current-main-commit-at-research-time
    paths:
      - design
    discovery: disabled
    invocation: last-resort-for-specific-known-feature
    requires_current_corroboration: true
    cannot_define:
      - current API shape
      - runtime behavior
      - supported workflow
      - release inclusion
      - feature maturity
      - general feature inventory

supporting_sources:
  - id: crossplane-build
    repository: crossplane/build
    kind: shared-build-tooling
    authority: supporting
    version_policy: exact-submodule-commit-from-selected-provider-template
    paths:
      - makelib/common.mk
      - makelib/golang.mk
      - makelib/k8s_tools.mk
      - makelib/imagelight.mk
      - makelib/xpkg.mk
      - LICENSE
    usage: version-matched build, test, image, and xpkg behavior invoked by provider-template
  - id: function-kro-kro
    repository: kubernetes-sigs/kro
    kind: resource-graph-orchestrator-documentation
    authority: supporting
    version_policy: exact-version-from-selected-function-kro-go-mod
    agent: okf-function-kro-kro-researcher
    paths:
      - website/docs
      - LICENSE
    usage: version-matched KRO ResourceGraphDefinition terminology and documented semantics; function-kro source remains authoritative for exposed behavior
  - id: crd-catalog
    repository: CustomResourceDefinition/catalog
    kind: community-crd-schema-catalog
    authority: supporting
    usage: discovery of non-Crossplane CRD schema snapshots; never replace the installed operator CRD or imply Crossplane CLI integration
  - id: upbound-package-api
    url: https://api.upbound.io/v1/packages/
    kind: provider-schema-registry
    authority: official-registry
    usage: rapid schema discovery; version-addressed routes preferred over latest
  - id: upbound-marketplace
    url: https://marketplace.upbound.io/
    kind: provider-package-marketplace
    authority: official-registry
    usage: package identity, source metadata, and published support-capability metadata
  - id: crossplane-provider-families-blog
    url: https://blog.crossplane.io/crd-scaling-provider-families/
    kind: historical-provider-context
    authority: historical-context
    published_at: 2023-06-13
    usage: historical-rationale-only; corroborate-current-behavior-with-released-provider-source
  - id: argo-cd
    repository: argoproj/argo-cd
    kind: gitops-controller
    authority: supporting
    release_policy: requested-stable-minor-release
    paths:
      - resource_customizations
      - util/lua
      - docs/operator-manual/health.md
  - id: cli-utils-kstatus
    repository: kubernetes-sigs/cli-utils
    kind: kubernetes-status-library
    authority: supporting
    paths:
      - pkg/kstatus/status
  - id: flux-website
    repository: fluxcd/website
    kind: official-flux-documentation
    authority: supporting
    release_policy: requested-minor-release-track
    paths:
      - content/en/flux/cheatsheets/cel-healthchecks.md
  - id: sprig
    repository: Masterminds/sprig
    kind: template-function-library
    authority: supporting
    version_policy: exact-version-from-selected-function-go-templating-go-mod
    agent: okf-function-go-templating-sprig-researcher
    paths:
      - README.md
      - docs
    availability_source: function-go-templating/function_maps.go
  - id: upjet
    repository: crossplane/upjet
    kind: upjet-framework
  - id: terraform-provider-aws
    repository: hashicorp/terraform-provider-aws
    kind: terraform-provider
    documentation: https://registry.terraform.io/providers/hashicorp/aws/latest/docs
  - id: terraform-provider-azurerm
    repository: hashicorp/terraform-provider-azurerm
    kind: terraform-provider
    documentation: https://registry.terraform.io/providers/hashicorp/azurerm/latest/docs
  - id: external-secrets
    repository: external-secrets/external-secrets
    kind: kubernetes-secrets-operator
    authority: supporting
    release_policy: user-requested-stable-tag
    paths:
      - docs/api/pushsecret.md
      - docs/guides/pushsecrets.md
      - docs/snippets/vault-pushsecret.yaml
      - docs/snippets/aws-sm-push-secret-with-metadata.yaml
      - apis/externalsecrets/v1alpha1/pushsecret_types.go
      - config/crds/bases/external-secrets.io_pushsecrets.yaml
      - LICENSE
    usage: platform secret-publication pattern; not evidence of Crossplane behavior

project_history_sources:
  - id: argo-cd-project-history
    repository: argoproj/argo-cd
    kind: github-issues-and-pull-requests
    authority: project-history
    author_policy: humans-only
    exclude_authors:
      - bots
      - apps
      - dependabot
      - renovate
      - github-actions
      - release-automation
    usage: bounded supporting-tool release provenance
  - id: crossplane-project-history
    repository: crossplane/crossplane
    kind: github-issues-and-pull-requests
    authority: project-history
    author_policy: humans-only
    exclude_authors:
      - bots
      - apps
      - dependabot
      - renovate
      - github-actions
      - release-automation
    usage: bounded reports that are corroborated by selected-release evidence
  - id: function-sequencer-project-history
    repository: crossplane-contrib/function-sequencer
    kind: github-issues-and-pull-requests
    authority: project-history
    author_policy: humans-only
    exclude_authors:
      - bots
      - apps
      - dependabot
      - renovate
      - github-actions
      - release-automation
    usage: bounded supporting reports for related Core limitations
  - id: function-go-templating-project-history
    repository: crossplane-contrib/function-go-templating
    kind: github-issues-and-pull-requests
    authority: project-history
    agent: okf-function-go-templating-project-history-researcher
    author_policy: humans-only
    exclude_authors:
      - bots
      - apps
      - dependabot
      - renovate
      - github-actions
      - release-automation
    windows:
      release_changes: previous-stable-tag-to-selected-stable-tag
      known_reports: open-items-relevant-to-selected-stable-tag
      post_release: created-or-updated-after-selected-stable-tag
    usage: summarize-by-user-facing-theme

example_sources:
  - id: sveltos-addon-controller
    repository: projectsveltos/addon-controller
    kind: kubernetes-addon-controller
    origin: third-party
    authority: illustrative
    release_policy: discover-highest-stable-semver-tag
    paths:
      - api/v1beta1/clustersummary_types.go
      - controllers/profile_utils.go
      - controllers/utils.go
      - lib/clusterops/clustersummary.go
      - LICENSE
    usage: summarize-and-cite
  - id: sveltos-libsveltos
    repository: projectsveltos/libsveltos
    kind: kubernetes-api-library
    origin: third-party
    authority: illustrative
    release_policy: match-sveltos-addon-controller
    paths:
      - api/v1beta1/common_types.go
      - LICENSE
    usage: summarize-and-cite
  - id: kubernetes-reflector
    repository: emberstack/kubernetes-reflector
    kind: kubernetes-resource-replication-controller
    origin: third-party
    authority: illustrative
    paths:
      - README.md
      - src/ES.Kubernetes.Reflector/Mirroring
      - src/helm/reflector/templates/clusterRole.yaml
      - LICENSE
    usage: summarize-and-cite
  - id: kubernetes-replicator
    repository: mittwald/kubernetes-replicator
    kind: kubernetes-resource-replication-controller
    origin: third-party
    authority: illustrative
    paths:
      - README.md
      - main.go
      - replicate
      - deploy/helm-chart/kubernetes-replicator
      - LICENSE.txt
    usage: summarize-and-cite
  - id: homelab-idp-crossplane-compositions
    repository: 0xayf/homelab-idp
    kind: crossplane-compositions
    origin: third-party
    authority: illustrative
    paths:
      - platform-core/controlplane/crossplane-compositions
    usage: summarize-and-cite

source_policy:
  pin_commits: true
  prefer_primary_sources: true
  allow_unpinned_citations: false
  allow_name_only_upjet_mapping: false
  historical_design_can_discover_features: false
  historical_design_can_define_current_facts: false
  historical_design_requires_current_corroboration: true
  historical_design_can_define_feature_state: false
  third_party_examples_can_define_behavior: false
  third_party_examples_require_corroboration: true
  verify_license_before_copying: true
  resolve_current_stable_release_before_core_research: true
  resolve_current_stable_release_before_function_research: true
  stable_release_definition: highest-semver-tag-excluding-draft-prerelease-rc-beta-alpha
  allow_function_main_fallback: false
  infer_feature_state_from_api_version: false
  exclude_legacy_claims: true
  exclude_deprecated_xrd_v1: true
  treat_all_v1_api_versions_as_legacy: false
  require_dedicated_agent_set_per_function: true
  project_history_requires_research_timestamp: true
  project_history_excludes_bots_and_apps: true
  project_history_can_define_released_behavior: false
  merged_pr_requires_release_commit_containment: true
  closed_issue_implies_fixed: false

242 files

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` results
AGENTS.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)

Download

The ZIP holds the files AutoGineer serves, with ATTRIBUTION.md and the licence. Download okf-crossplane-v2.zip

What it is

How it works

Requirements

Set it up

Usage

Documentation by jkroepke

Open Knowledge Format for Crossplane v2

Installation

Self-hosting the MCP server

Crossplane package tools

Why this repository exists

Knowledge structure

License

Advantages

Limitations

Security

This brain runs

Attribution and licence

Download