Skip to content

[PROJECT ONBOARDING] Agent Substrate #542

Open

Description

@github-actions

Welcome to CNCF Project Onboarding

ref: #523

This is an issue created to help onboard your project into the CNCF after the TOC has voted to accept your project.

We would like your project to complete onboarding within one month of acceptance.

Please track your progress by using "Quote reply" to create your own copy of this checklist in the issue, so that you can update the status as you finish items.

REQUIRED BEFORE PROCEEDING WITH ONBOARDING

A "Project Contribution Agreement" must be completed and any existing trademarks MUST be transferred to the Linux Foundation BEFORE the CNCF staff onboarding tasks can be completed. Other tasks can be done by projects themselves in the meantime.

  • Review and understand the CNCF IP Policy. Ensure you are using a CNCF compatible license; inbound projects must use the Apache 2.0 license. Licenses for dependencies are covered separately below.
  • Review and understand the CNCF Third Party License Policy. This policy governs the licenses used by third party libraries in your project. CNCF FOSSA or CNCF Snyk are configured to check that projects are in compliance with this policy. Let us know which service you would prefer to use.
  • Review and understand the LF trademark guidelines. Let the TOC know if you plan to change your project name.
  • Transfer any trademark and logo assets to the Linux Foundation via the Contribution Agreement. CNCF staff will send this document to the contact emails listed in the Sandbox application.

Review and understand other documents

Contribute and transfer other materials

  • Move your project to its own separate neutral GitHub organization. This will make it transferable to the CNCF's GitHub Enterprise account. If it's already in another GHE account, you will need to remove it from that first.
  • Accept the invite to join the CNCF GitHub Enterprise account. We'll then add thelinuxfoundation as an organization owner to ensure neutral hosting of your project.
  • Migrate your Slack channels (if any) to the Kubernetes or CNCF Slack workspace. CNCF staff can help. This allows project communities to be more discoverable, allows the CNCF to enforce its Code of Conduct, and enables unlimited message retention.
  • Join the #maintainers-circle Slack channel to find and share knowledge with other project teams.
  • Transfer your domain(s) to the CNCF if they exist. The "LF Contact" is [email protected]. The "Project Selection" is CNCF.
  • Submit a pull request with your artwork if it exists. If you don't have artwork, CNCF can help design some.
  • Transfer website analytics if they exist. Make [email protected] an admin of your existing Google Analytics org account so that we can move it to a CNCF-managed account.

Update and document project details

  • Create or ensure your .project repo is up to date with maintainer information.
  • Ensure each maintainer has an up-to-date LFX Individual Dashboard profile that includes an active email address in order to get access to the mailing list and Service Desk.
  • Ensure the DCO app is enabled for all GitHub repositories of the project. You may also choose to use a CLA in addition to the DCO.
  • Ensure that the CNCF Code of Conduct (or your adopted version of it) are explicitly referenced in the project's README.md on GitHub.
  • Ensure the LF footer is on your website and guidelines are followed (if your project doesn't have a dedicated website, please adopt those guidelines for the README.md file).
  • Start working on written, open governance and consider adding this to a GOVERNANCE.md file at the root of your repo.
  • Start working on a security policy and consider adding this to a SECURITY.md file at the root of your repo.
  • Start working on an OpenSSF Best Practices Badge.
  • Import all project repos into your chosen license scanning service (CNCF FOSSA or CNCF Snyk).

CNCF staff tasks to support the project


Related Issue: This onboarding issue was automatically created after the community vote was completed in issue #523.

Activity

  1. riaankleinhans commented on Oct 21, 2026

    @riaankleinhans
    Contributor

    Hi @zlammerts-svg onboarding can begin! Please let us know if you've already completed any tasks.

    A good place to start would be to create the project's .project repo. Here is the instructions. Please reach out if you need help.
    https://github.com/cncf/automation/tree/main/utilities/dot-project

    Once the /.project/maintainers.yaml file exist we can give maintainers access to CNCF services.
    Please ask all maintainers to link the Github handle to the LFID at openprofile.dev as we use that link to determine their primary email address for services access.

  2. zlammerts-svg commented on Oct 21, 2026

    @zlammerts-svg

    Thanks a lot @riaankleinhans! This is super helpful. We will follow the instructions.

  3. krook commented on Oct 21, 2026

    @krook
    Member

    FYI, https://github.com/agent-substrate needs to be released from the GitHub Enterprise account it's currently in before we can invite it to the CNCF one

  4. zlammerts-svg commented on Oct 21, 2026

    @zlammerts-svg

    @krook Ack, I will follow up on this today via the internal Google process to request the org to be released.

  5. lukaszgryglicki commented on Oct 23, 2026

    @lukaszgryglicki
    Member

    DevStats instance added.

  6. BenTheElder commented on Oct 23, 2026

    @BenTheElder

    Start working on a security policy and consider adding this to a SECURITY.md file at the root of your repo

    This exists in .github since before this issue was created, do we have to move it? The .github location is picked up by GitHub's dedicated security tab, where it is rendered. It's fully detailed. https://github.com/agent-substrate/substrate/blob/main/.github/SECURITY.md

    https://github.com/agent-substrate/substrate/security/policy

  7. krook commented on Oct 23, 2026

    @krook
    Member

    @BenTheElder I don't see a reason to move it, especially since it's found by GitHub

  8. BenTheElder commented on Oct 26, 2026

    @BenTheElder

    FYI, https://github.com/agent-substrate needs to be released from the GitHub Enterprise account it's currently in before we can invite it to the CNCF one

    1. This is done! Thanks @zlammerts-svg
    2. Can you also invite https://github.com/orgs/agent-substrate-plugins ? (and add it to any stats tracking, apologies)

    @thockin was just sitting on it as an empty org, so it's was never in the Google GHE account and starts clean as substrate project owned.
    I'm going to enforce the DCO2 app from day one on the plugins org.
    We will use it to host cloud integration plugins (like gcp secrets, azure storage).
    We held off before the donation agreement to simplify approvals.

    Thanks! 🙇

  9. krook commented on Oct 26, 2026

    @krook
    Member

    Both orgs have been invited to GHE

  10. BenTheElder commented on Oct 28, 2026

    @BenTheElder

    Ensure the DCO app is enabled for all GitHub repositories of the project. You may also choose to use a CLA in addition to the DCO.

    This is done. DCO is enabled and enforced org-wide (both orgs). Google CLA is disabled.
    The community has been notified with instructions.

    Accept the invite to join the CNCF GitHub Enterprise account. We'll then add thelinuxfoundation as an organization owner to ensure neutral hosting of your project.

    Both invites accepted. IIUC you'll do adding thelinuxfoundation.

  11. zlammerts-svg commented on Oct 29, 2026

    @zlammerts-svg

    @krook Thanks for all the help! We need some trade mark related help. I was told that I would need to open a Jira ticket to reach your service desk for this kind of requests. How can I do this?

  12. krook commented on Oct 29, 2026

    @krook
    Member

    @krook Thanks for all the help! We need some trade mark related help. I was told that I would need to open a Jira ticket to reach your service desk for this kind of requests. How can I do this?

    In general, yes you'd use Service Desk for this (adding maintainers to your .project repo automates the invites). But in this case it's an LF legal Jira ticket which I'll open based on the info Mofi gave me.

  13. cynthia-sg commented on Oct 29, 2026

    @cynthia-sg

    Project has been added to CLOMonitor

  14. lukaszgryglicki commented on Oct 31, 2026

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

Metadata

Metadata

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions