Home / agentworkforce / relay · AGENTS.md · GitHub

AGENTS.md agentsA

AGENTS.md is agent-read markdown (agents) from agentworkforce/relay.

Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.

What the file says

# Git Workflow Rules

## NEVER Push Directly to Main

**CRITICAL: Agents must NEVER push directly to the main branch.**

- Always work on a feature branch
- Commit and push to the feature branch only
- Let the user decide when to merge to main
- Do not merge to main without explicit user approval

```bash
# CORRECT workflow
git checkout -b feature/my-feature
# ... do work ...
git add .
git commit -m "My changes"
git push origin feature/my-feature
# STOP HERE - let user merge

# WRONG - never do this
git checkout main
git merge feature/my-feature
git push origin main  # NO!
```

This ensures the user maintains control over what goes into the main branch.

## Changelog

Curate `[Unreleased]` in `CHANGELOG.md` as you land PRs. The root changelog is
the cross-package, user-facing release narrative for Relay. It follows
[Keep a Changelog](https://keepachangelog.com/en/1.0.0/) and Semantic
Versioning.

An empty post-release changelog starts with `[Unreleased]`. The first pending
user-visible change must set the heading to `[Unreleased - Patch]`,
`[Unreleased - Minor]`, or `[Unreleased - Major]` according to its SemVer
…

Read the whole file at its exact version.

How to install

Latest version
mdr add agentworkforce/relay/AGENTS.md@git:20260919.270f08c
Exact content
mdr add agentworkforce/relay/AGENTS.md@sha256:21b6e63b2a2d5eda

Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_jqbkfqp44rg77c3w.svg)](https://markdownregistry.com/a/art_jqbkfqp44rg77c3w)

1 badge views in 30 days

Versions

versioncommittedcommitsizeaudit
git:20260919.270f08c latest2026-09-19 270f08c 10,318 BA view · diff
git:20260729.b36fa572026-07-29 b36fa57 9,002 BA view · diff
git:20260729.0005d142026-07-29 0005d14 7,827 BA view · diff
git:20260723.1a09cde2026-07-23 1a09cde 7,298 BA view · diff
git:20260713.aea16132026-07-13 aea1613 6,993 BA view

Audit of the latest version

A  14 of 14 checks passed. Deterministic, no model, same answer every run.
  • pass: Size between 200 bytes and 200 KB (10318 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

agentworkforce/relay · 849 stars · license Apache-2.0 · pushed 2026-09-23 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_jqbkfqp44rg77c3w
GET https://markdownregistry.com/api/v1/resolve?ref=agentworkforce/relay/AGENTS.md
GET https://markdownregistry.com/api/v1/blob/21b6e63b2a2d5eda5ee862576b89f68006d5df231235004240e0d32af812b5f3

Your agent does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

More from agentworkforce/relay

choosing-swarm-patterns skill
agentworkforce/relay · .agents/skills/choosing-swarm-patterns/SKILL.md · Use when coordinating multiple AI agents with Agent Relay's workflow engine and need to pick the right orchestration…
git:20260919.270f08c · audit A · 849 stars
creating-agent-skills skill
agentworkforce/relay · .agents/skills/creating-agent-skills-skill/SKILL.md · Use when creating Agent Skills packages (SKILL.md format) for Codex CLI, GitHub Copilot, or Amp - provides the…
git:20260919.270f08c · audit A · 849 stars
emil-design-eng skill
agentworkforce/relay · .agents/skills/emil-design-eng/SKILL.md · This skill encodes Emil Kowalski's philosophy on UI polish, component design, animation decisions, and the invisible…
git:20260619.f9a7ef7 · audit A · 849 stars
orchestrating-agent-relay skill
agentworkforce/relay · .agents/skills/orchestrating-agent-relay/SKILL.md · The canonical way to run agent-relay - self-bootstrap the local broker and autonomously spawn, monitor, and coordinate…
git:20260922.12ce647 · audit A · 849 stars
relay-80-100-workflow skill
agentworkforce/relay · .agents/skills/relay-80-100-workflow/SKILL.md · Use when writing agent-relay workflows that must fully validate features end-to-end before merging. Covers the…
git:20260919.270f08c · audit A · 849 stars
review-animations skill
agentworkforce/relay · .agents/skills/review-animations/SKILL.md · Reviews animation and motion code against a high craft bar derived from Emil Kowalski's design engineering philosophy…
git:20260619.f9a7ef7 · audit A · 849 stars
review-fix-signoff-loop skill
agentworkforce/relay · .agents/skills/review-fix-signoff-loop/SKILL.md · Use when writing Agent Relay or Ricky workflows that must loop review, fix, and validation with fresh agent context…
git:20260519.f5dd259 · audit A · 849 stars
setting-up-relayfile skill
agentworkforce/relay · .agents/skills/setting-up-relayfile/SKILL.md · Use when an agent or human needs to set up relayfile end-to-end so agents can read and write provider files through a…
git:20260919.270f08c · audit C · 849 stars
using-agent-relay skill
agentworkforce/relay · .agents/skills/using-agent-relay/SKILL.md · Use when you are a registered relay agent (a spawned worker, or a lead that called register_agent) coordinating with…
git:20260919.270f08c · audit A · 849 stars
writing-relayflows skill
agentworkforce/relay · .agents/skills/writing-relayflows/SKILL.md · Use when authoring a Relayflows flow (@relayflows/surface / @relayflows/sdk, the journal-based v2 engine — the CLI is…
git:20260919.270f08c · audit A · 849 stars
browser-testing-with-screenshots skill
agentworkforce/relay · .claude/skills/browser-testing-with-screenshots/SKILL.md · Use when testing web applications with visual verification - automates Chrome browser interactions, element selection…
git:20260525.164e16b · audit A · 849 stars
choosing-swarm-patterns skill
agentworkforce/relay · .claude/skills/choosing-swarm-patterns/SKILL.md · Use when coordinating multiple AI agents with Agent Relay's workflow engine and need to pick the right orchestration…
git:20260919.270f08c · audit A · 849 stars

Every file in agentworkforce/relay

Other files named AGENTS.md

AGENTS.md agents
obra/superpowers · AGENTS.md
git:20260919.5bf4e78 · audit A · 291,204 stars
AGENTS.md agents
affaan-m/ecc · AGENTS.md
git:20260919.91ba9b4 · audit A · 266,832 stars
AGENTS.md agents
firecrawl/firecrawl · AGENTS.md
git:20260613.d9a35c0 · audit A · 184,144 stars
AGENTS.md agents
dietrichgebert/ponytail · AGENTS.md
git:20260710.b6c0448 · audit A · 144,862 stars
AGENTS.md agents
garrytan/gstack · AGENTS.md
git:20260914.4a3c6a8 · audit A · 134,082 stars
AGENTS.md agents
graphify-labs/graphify · AGENTS.md
git:20260414.7ec92ec · audit A · 121,202 stars
AGENTS.md agents
juliusbrussee/caveman · AGENTS.md
git:20260902.d9faebc · audit A · 107,708 stars
AGENTS.md agents
addyosmani/agent-skills · AGENTS.md
git:20260709.b665c5c · audit A · 98,554 stars

Browse by kind, by grade A, or by owner.