Skip to content

Create AGENTS.md

Create an AGENTS.md file for the current repository with secure and compliant Optum guidance.

experimental
IDE:
claude
codex
vscode
Version:
1.0.0
Owner:platform-devops
documentation
onboarding
agents-md
optum

Context

You are creating a repository-level AGENTS.md file that gives AI coding agents clear, enforceable instructions for this project. You can learn about AGENTS.md here. The guidance must reflect Optum and UnitedHealth Group engineering standards, including secure defaults, compliance expectations, and practical developer workflows.

Instructions

  1. Review the repository and identify existing signals for team conventions:
  • README.md
  • CONTRIBUTING.md
  • existing instructions, prompts, agents, and skills under shared/, vscode/, claude-code/, and codex/
  1. Create AGENTS.md tailored to this repository, not a generic template.
  2. Include explicit guardrails for:
  • secure software delivery
  • enterprise-approved Docker base images
  • Dojo Terraform modules and patterns
  • approved GitHub workflow practices
  1. Add a short section telling users to leverage the "OTC AWESOME LLM" toolset to discover relevant skills, prompts, instructions, and agents before implementing new work.
  2. Keep wording direct and actionable:
  • use MUST/ALWAYS/NEVER for non-negotiable requirements
  • avoid vague language
  1. Use markdown headings and concise bullet points.

Output

Produce only the final AGENTS.md content in markdown. The output MUST include:

  • purpose and scope
  • required workflow expectations
  • security/compliance guardrails
  • references to relevant local assets (skills/prompts/instructions/agents)
  • a short "How to use OTC AWESOME LLM here" section

Example

## Security Guardrails
- ALWAYS use enterprise-approved base images.
- NEVER hardcode secrets in source files.
- MUST route infrastructure changes through approved CI/CD workflows.

Related Assets

Create README.md

experimental

Create a concise and comprehensive README.md for the current repository.

claude
codex
vscode
documentation
readme
onboarding

Owner: platform-devops

AIRB Documentation Generator (Optum)

experimental

Generate first-draft AIRB documentation sections from project inputs, including architecture, data flow, PIA, and monitoring plans.

claude
codex
vscode
airb
documentation
uais
optum
m365

Owner: epic-platform-sre

Epic Onboarding Guide Agent

active

Comprehensive onboarding guide generator for new engineers joining the Epic on Azure platform team. Creates personalized onboarding plans covering infrastructure, tooling, processes, and team workflows specific to the OptumHealth EMR environment.

vscode
onboarding
epic
platform
azure
training
+2

Owner: platform-automation

abyss-documentation

active

Fetches and references Abyss Design System documentation for building frontend applications. Use when user asks about Abyss components, form inputs, layouts, UI patterns, styling, or needs Abyss implementation guidance. Trigger phrases include "how do I use Abyss", "Abyss Button", "Abyss form", "design system docs".

claude
codex
vscode
abyss
design-system
documentation
ui
components
+1

Owner: mtaugner_uhg

Changelog Generator

experimental

Automatically generate semantic, user-facing changelogs from merged PRs and closed issues, categorized by feature, fix, breaking change, and deprecation.

claude
codex
vscode
agile
release-planning
changelog
documentation
semantic-release

Owner: community

Optum Harmony Healthcare Demo App

experimental

Create a Harmony-based example healthcare application that showcases eligibility, claims, and remittance concepts using current Harmony skills, instructions, navigation, forms, and components.

claude
codex
vscode
harmony
react
healthcare
demo
optum

Owner: harmony-platform