Create AGENTS.md
Create an AGENTS.md file for the current repository with secure and compliant Optum guidance.
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
- Review the repository and identify existing signals for team conventions:
README.mdCONTRIBUTING.md- existing instructions, prompts, agents, and skills under
shared/,vscode/,claude-code/, andcodex/
- Create
AGENTS.mdtailored to this repository, not a generic template. - Include explicit guardrails for:
- secure software delivery
- enterprise-approved Docker base images
- Dojo Terraform modules and patterns
- approved GitHub workflow practices
- 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.
- Keep wording direct and actionable:
- use MUST/ALWAYS/NEVER for non-negotiable requirements
- avoid vague language
- 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
Create a concise and comprehensive README.md for the current repository.
Owner: platform-devops
AIRB Documentation Generator (Optum)
Generate first-draft AIRB documentation sections from project inputs, including architecture, data flow, PIA, and monitoring plans.
Owner: epic-platform-sre
Epic Onboarding Guide Agent
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.
Owner: platform-automation
abyss-documentation
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".
Owner: mtaugner_uhg
Changelog Generator
Automatically generate semantic, user-facing changelogs from merged PRs and closed issues, categorized by feature, fix, breaking change, and deprecation.
Owner: community
Optum Harmony Healthcare Demo App
Create a Harmony-based example healthcare application that showcases eligibility, claims, and remittance concepts using current Harmony skills, instructions, navigation, forms, and components.
Owner: harmony-platform

