Onboarding your team

Use the Nomos Agent to submit a structured onboarding request. It validates team data and proposes changes through pull requests in the repositories that own each capability.

Ready to go?

You have your team's details and want to build a prompt to paste straight into the Nomos Agent.

Build your agent prompt →

How it works

📋

1. Collect your details

Gather the team key, display name, purpose, GitHub usernames, and administrator email.

💬

2. Build your prompt

Use the prompt builder below, then paste the generated text straight into the Nomos Agent.

🚀

3. Review and promote

Review the proposed pull request. Logos creates the team foundation; optional Corpus, Pneuma, or Kryptos changes follow their own promotion workflows.

Build your agent prompt

You have all the details

Fill in the form, select Copy, and paste the result into Nomos. The agent confirms the requested scope and opens the required pull request or pull requests. Toggle Optional for cloud, workflow, database, and Kubernetes capabilities.

Filter:✓ Required (5)

General

Team key

Team key. Must match the team_type prefix scheme: pt- (platform), st- (stream-aligned), ct- (complicated-subsystem), et- (enabling).

Display name

Team display name. Title Case; spaces and the lowercase word "and" are allowed.

Description required

Inline comment rendered after display_name in the tfvars file. Used for the team etymology blurb. Also used as the `description` frontmatter on the team's docs index page; render_team_docs_index and open_team_docs_pr require this field to be non-empty — an empty string will produce a docs_input_invalid error.

GitHub

Maintainers required

GitHub parent team memberships. All team members should be listed here. Use GitHub usernames (NOT email addresses).

Datadog

Admin email required

Datadog team memberships. admins manage the team; members have read-only access.

Generated prompt

Onboard a new team.

How to invoke the agent

💻

Copilot CLI

With Docker available, install the plugin, set NOMOS_GITHUB_TOKEN, and start Copilot CLI:

copilot plugin marketplace add osinfra-io/pt-ai-plugins
copilot plugin install techne-agents@osinfra-io
printf 'NOMOS_GITHUB_TOKEN: '
read -rs NOMOS_GITHUB_TOKEN
printf '\n'
export NOMOS_GITHUB_TOKEN
copilot

Type /agent, select Nomos Agent, and paste your prompt. The plugin registers its version-pinned MCP server automatically.

🌐

GitHub UI

Navigate to pt-techne-agents/agents on GitHub, select the Nomos Agent, and paste your prompt. The agent opens a PR automatically.

🤖

VS Code

Open pt-techne-agents in VS Code, start a Copilot Chat session, type /agent, select Nomos Agent, and paste your prompt.

GitHub MCP — configuration required

The agent opens pull requests and reads repository state using the GitHub MCP server. It must be enabled with write toolsets.

Configure the GitHub MCP server with a fine-grained Personal Access Token scoped to the osinfra-io organization with the following permissions:

Permission	Access
Contents	Read and write
Issues	Read and write
Pull requests	Read and write
Workflows	Read and write

Fine-grained PATs are created at github.com/settings/personal-access-tokens/new. Set the resource owner to the osinfra-io organization.