Home / punt-labs / prfaq · AGENTS.md · GitHub

AGENTS.md agentsA

This file is byte-identical to the first copy the registry indexed. Same content hash, same audit grade.

AGENTS.md is agent-read markdown (agents) from punt-labs/prfaq.

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

# Agent Instructions

This project uses **bd** (beads) for issue tracking. Run `bd onboard` to get started.

## Quick Reference

```bash
bd ready              # Find available work
bd show <id>          # View issue details
bd update <id> --status in_progress  # Claim work
bd close <id>         # Complete work
bd sync               # Sync with git
```

## Landing the Plane (Session Completion)

**When ending a work session**, you MUST complete ALL steps below. Work is NOT complete until `git push` succeeds.

**MANDATORY WORKFLOW:**

1. **File issues for remaining work** - Create issues for anything that needs follow-up
2. **Run quality gates** (if code changed) - Tests, linters, builds
3. **Update issue status** - Close finished work, update in-progress items
4. **PUSH TO REMOTE** - This is MANDATORY:
   ```bash
   git pull --rebase
   bd sync
   git push
   git status  # MUST show "up to date with origin"
   ```
5. **Clean up** - Clear stashes, prune remote branches
6. **Verify** - All changes committed AND pushed
7. **Hand off** - Provide context for next session

**CRITICAL RULES:**
- Work is NOT complete until `git push` succeeds
…

Read the whole file at its exact version.

How to install

Latest version
mdr add punt-labs/prfaq/AGENTS.md@git:20260214.a6e3c4c
Exact content
mdr add punt-labs/prfaq/AGENTS.md@sha256:bf83e48f58204bea

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_ulpcxgnnlm37jnar.svg)](https://markdownregistry.com/a/art_ulpcxgnnlm37jnar)

1 badge views in 30 days

Versions

versioncommittedcommitsizeaudit
git:20260214.a6e3c4c latest2026-02-14 a6e3c4c 1,327 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 (1327 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

punt-labs/prfaq · 25 stars · license MIT · pushed 2026-09-21 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_ulpcxgnnlm37jnar
GET https://markdownregistry.com/api/v1/resolve?ref=punt-labs/prfaq/AGENTS.md
GET https://markdownregistry.com/api/v1/blob/bf83e48f58204bea5bee22b987a833b36deedd15253ddafd6bac106a78c1ded2

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 punt-labs/prfaq

CLAUDE.md@.punt-labs/beadle claude
punt-labs/prfaq · .punt-labs/beadle/CLAUDE.md
git:20260829.e1e7acf · audit A · 25 stars
CLAUDE.md@.punt-labs/vox claude
punt-labs/prfaq · .punt-labs/vox/CLAUDE.md
git:20260829.e1e7acf · audit A · 25 stars
CLAUDE.md claude
punt-labs/prfaq · CLAUDE.md
git:20260901.833cea7 · audit A · 25 stars
DESIGN.md design
punt-labs/prfaq · DESIGN.md
git:20260303.b1e608c · audit A · 25 stars
prfaq skill
punt-labs/prfaq · plugin/skills/prfaq/SKILL.md · This skill should be used when the user asks to "write a PR/FAQ", "prfaq", "working backwards", "product discovery"…
git:20260830.f7edfe2 · audit A · 25 stars

Every file in punt-labs/prfaq

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.