Instructions

Conventions and best practices for authoring maintainable Ansible playbooks and roles.

Complete development patterns for creating playbooks and roles that execute in AWX, including local development, requirements.yml role versioning, testing workflows, and AWX integration for Epic on Azure.

Comprehensive instructions for building secure, compliant Docker containers within Optum using golden images, SaaS Artifactory authentication, and enterprise best practices.

Standard patterns and safety rules for AWX operations using the ansible_role_awx_cac Configuration as Code model in Epic on Azure at Optum.

Comprehensive instructions for building secure, compliant Docker containers within Optum using golden images, SaaS Artifactory authentication, and enterprise best practices.

Foundational DevOps principles (CALMS) and key metrics (DORA) to guide effective software delivery.

Comprehensive instructions for building secure, compliant Docker containers within Optum using golden images, SaaS Artifactory authentication, and enterprise best practices.

Optum Dojo quick index (skills + workflow templates)

Mandatory git worktree policy preventing branch conflicts and lost work by requiring all feature work in worktrees/ subdirectories.

Github workflow examples and instructions for OIDC authentication with Optum AWS accounts and SaaS Artifactory integration.

Reference for Harmony Design System React components including buttons, modals, panels, form controls, navigation, and data display elements.

Harmony Design System foundation elements including typography, grid layout, icons, and design tokens with usage examples.

Overview of the Harmony Design System — Optum's unified React component library combining UITK and UICL for building scalable, brand-compliant, and accessible healthcare web applications.

Setup guide for creating new projects with the Harmony Design System, including license keys, Node.js prerequisites, Artifactory NPM configuration, and React integration.

Conventions for incident triage, communication, and documentation including timeline formatting, stakeholder updates, and postmortem structure.

Guidelines for using Kratos MCP memory system for project-isolated persistent memory storage, retrieval, and full-text search in AI coding workflows.

Comprehensive best practices for deploying and managing applications on Kubernetes (Pods, Deployments, Services, Ingress, health checks, resource limits, scaling, and security contexts).

Conventions and guardrails for Kubernetes operations in Optum clusters, emphasizing read-only diagnostics and GitOps-driven changes.

Documentation and content creation standards

Comprehensive markdown style guide based on markdownlint rules configured for this project. Use this before creating or editing any .md files to ensure compliance.

Standards, patterns, and guardrails for building Model Context Protocol (MCP) servers compatible with Wall-E, VS Code Copilot, and enterprise systems.

Establishes explicit preferences for MCP tools over CLI equivalents. Ensures consistent, reliable tool usage when multiple paths exist.

Comprehensive guide for ohemr-epic-megadoc architecture, documentation structure, and LLM-generated content standards

Comprehensive guide for maintaining the ohemr-epic-megadoc monorepo - managing the MkDocs configuration, monorepo plugin patterns, fallback mechanisms, and submodule integration.

Style and structure guidelines for megadoc-based documentation including YAML front matter, Diátaxis categorization, and markdown conventions.

Comprehensive guide for creating megadoc-compliant documentation in submodule repositories that integrate with the ohemr-epic-megadoc monorepo system.

Style guide and best practices for creating consistent, readable Mermaid diagrams for documentation. Covers C4, flowcharts, sequence diagrams, and ER diagrams.

Guidelines for writing Node.js and JavaScript code with Vitest testing

npm install instructions due to Supply chain attacks and Optum repository curation and blocking policies.

Responsible AI compliance requirements for Optum AI/ML development, covering AIRB submission, shadow mode pilots, RAI risk tiers, and governance processes.

Comprehensive instructions for Optum SaaS Artifactory implementation, authentication, golden container images, and CI/CD integration. Ensures compliance with enterprise security, governance, and supply chain requirements.

Instructions for building containers within Optum using golden container images from Chain Guard and Artifactory. Ensures compliance with enterprise security, governance, and supply chain requirements.

Instructs agents to proactively understand project constraints from pre-commit configs, CI/CD workflows, and linting rules before creating or modifying files

Safely prune git worktrees whose branches have been merged into the remote default. Uses authoritative gh API merged-PR detection plus remote-branch and ancestry checks. Skips worktrees with uncommitted or unpushed work.

Python coding conventions and guidelines

ReactJS development standards and best practices

Specification-Driven Workflow v1 provides a structured approach to software development, ensuring that requirements are clearly defined, designs are meticulously planned, and implementations are thoroughly documented and validated.

Comprehensive guidance for working with GitHub Super-Linter including configuration patterns, common pitfalls, resolution strategies, and Optum-specific integration.

Terraform conventions and guardrails for safe, maintainable Infrastructure as Code.

Terraform coding conventions, safety rules, and best practices for Terraform Enterprise (TFE) backed workspaces in Optum environments.

Corporate policy for allowed GitHub Actions sources in workflows

Patterns and guardrails for composing safe multi-agent workflows in Wall-E (Wide Array Large Language Engine), Optum's enterprise AI orchestration platform.