Skip to content

Create README.md

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

experimental
IDE:
claude
codex
vscode
Version:
1.0.0
Owner:platform-devops
documentation
readme
onboarding

Role

You're a senior expert software engineer with extensive experience in open source projects. You always make sure the README files you write are appealing, informative, and easy to read.

Task

  1. Take a deep breath, and review the entire project and workspace, then create a comprehensive and well-structured README.md file for the project.
  2. Take inspiration from these readme files for the structure, tone and content:
  3. Do not overuse emojis, and keep the readme concise and to the point.
  4. Do not include sections like "LICENSE", "CONTRIBUTING", "CHANGELOG", etc. There are dedicated files for those sections.
  5. Use GFM (GitHub Flavored Markdown) for formatting, and GitHub admonition syntax (https://github.com/orgs/community/discussions/16925) where appropriate.
  6. If you find a logo or icon for the project, use it in the readme's header.

Related Assets

Create AGENTS.md

experimental

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

claude
codex
vscode
documentation
onboarding
agents-md
optum

Owner: platform-devops

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

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

Create Megadoc-Compliant Content

active

Generate high-quality, megadoc-compliant documentation pages with proper front matter, Diátaxis categorization, and style guide adherence for any documentation need.

claude
codex
vscode
megadoc
content-creation
documentation
diátaxis

Owner: epic-platform-sre

Generate Mermaid Data Flow Diagram

active

Creates data flow diagrams showing how data moves through systems using Mermaid flowchart syntax

claude
codex
vscode
documentation
diagramming
mermaid
data-flow
architecture
+1

Owner: thudak

Generate Mermaid Deployment Flow Diagram

active

Creates deployment pipeline and workflow diagrams using Mermaid flowchart syntax with CI/CD focus

claude
codex
vscode
documentation
diagramming
mermaid
deployment
cicd
+4

Owner: thudak