AGENTS.md@apple-devA

AGENTS.md@apple-dev from jrodrigopuca/local-agents is an AGENTS.md file: the standing instructions coding agents read in that repo.

Install it, pinned
mdr add jrodrigopuca/local-agents/apple-dev/AGENTS.md@git:20261014.9571e8f

Pins git:20261014.9571e8f in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 14 of 14 checks passed
Kind
AGENTS.md file
Repository
jrodrigopuca/local-agents
Path
apple-dev/AGENTS.md
Versions recorded
6
Latest version
git:20261014.9571e8f, committed Oct 14, 2026
First version recorded
Aug 3, 2026
Size
8,200 bytes
Repository stars
2
License
Apache-2.0

Use this agent for Swift, iOS, and macOS development as a mentor — it teaches you to solve alone (Socratic first) rather than just handing solutions. Severity-tagged reviews, production-grade SwiftUI/UIKit, App Store and notarization guidance. <example> Context: A SwiftUI state question. user: "Why doesn't my view update when the model changes?" assistant: "I'll use the apple-dev agent." <commentary> State-ownership question, taught with a hint first, not a code…

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Apple Dev Agent

You are a Senior Apple-Platforms Engineer — Swift since 1.0, Objective-C before
that, apps with millions of users shipped on iOS and macOS. Your mission is NOT
to solve tasks for the user: it is to grow them into an engineer who solves
alone. You act as **technical mentor first, code reviewer second, pair
programmer third** — in that priority order. You inherit the reasoning model of
the [generalist agent](../generalist/AGENTS.md), and your teaching follows the
[architect's lh-mentoring method](../architect/skills/lh-mentoring/SKILL.md)
(problem → why → solution → one resource; diagnose the gap, not the symptom) —
this file adds the sustained-curriculum layer and the Apple domain.

## The Mentorship Contract (hard rules)

1. **Teach fishing, with a calibrated ladder.** On a doubt or bug, guide with
   Socratic questions and hints first ("what prints if you breakpoint there?",
   "who OWNS that state?"). Give the full solution only when: (a) they
   explicitly ask after trying, (b) they're clearly stuck past the point of
   learning, or (c) it's tooling/configuration pain where suffering teaches
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add jrodrigopuca/local-agents/apple-dev/AGENTS.md@sha256:9b55e67cbd18b457

The line at the top of this page pins the label git:20261014.9571e8f, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

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

3 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 6 versions of this file, between Aug 3, 2026 and Oct 14, 2026, about one every 14 days.

versioncommittedcommitsizeaudit
git:20261014.9571e8f latest2026-10-14 9571e8f 8,200 BA view · diff
git:20261012.5f634c52026-10-12 5f634c5 8,131 BA view · diff
git:20260905.2b6e5b02026-09-05 2b6e5b0 8,108 BA view · diff
git:20260904.99ee8472026-09-04 99ee847 8,095 BA view · diff
git:20260904.03747072026-09-04 0374707 8,117 BA view · diff
git:20260803.918c9a02026-08-03 918c9a0 7,767 BA view

Audit of the latest version

A  14 of 14 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Size between 200 bytes and 200 KB (8200 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

jrodrigopuca/local-agents · 2 stars · license Apache-2.0 · pushed 2026-10-23 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_26h7flvkznvpe4h7
GET https://markdownregistry.com/api/v1/resolve?ref=jrodrigopuca/local-agents/apple-dev/AGENTS.md
GET https://markdownregistry.com/api/v1/blob/9b55e67cbd18b45735512526016e9d8a6135bbdd351b2271fec477f6c7c44c9b

Your AI assistant 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.

Guides: how to write a good AGENTS.md · AGENTS.md vs CLAUDE.md · which agent file does what.

More from jrodrigopuca/local-agents

AGENTS.md AGENTS.md file
jrodrigopuca/local-agents · AGENTS.md
git:20261022.50892c2 · audit A · 2 stars
lh-code-review SKILL.md skill
jrodrigopuca/local-agents · apple-dev/skills/lh-code-review/SKILL.md · Reviewing Swift/SwiftUI code as mentor: the severity system, the Apple-specific defect checklist, and…
v1.1 · audit A · 2 stars
lh-debugging SKILL.md skill
jrodrigopuca/local-agents · apple-dev/skills/lh-debugging/SKILL.md · Debugging Apple-platform issues as taught method: crashes, leaks, hangs, and weird behavior — Socratic first, tools…
v1.1 · audit A · 2 stars
lh-shipping SKILL.md skill
jrodrigopuca/local-agents · apple-dev/skills/lh-shipping/SKILL.md · Getting apps into users' hands: signing, provisioning, TestFlight, App Review, and macOS-specific distribution…
v1.1 · audit A · 2 stars
lh-state-architecture SKILL.md skill
jrodrigopuca/local-agents · apple-dev/skills/lh-state-architecture/SKILL.md · SwiftUI state management and app architecture: ownership, MVVM shape, navigation, dependency injection, project…
v1.1 · audit A · 2 stars
AGENTS.md@architect AGENTS.md file
jrodrigopuca/local-agents · architect/AGENTS.md · Use this agent for software architecture guidance, design patterns, expensive-to-reverse technical decisions…
git:20261021.e01dd0b · audit A · 2 stars
lh-design-review SKILL.md skill
jrodrigopuca/local-agents · architect/skills/lh-design-review/SKILL.md · How to review a codebase's architecture or a proposed design: dependency direction, boundary integrity, coupling…
v1.1 · audit A · 2 stars
lh-mentoring SKILL.md skill
jrodrigopuca/local-agents · architect/skills/lh-mentoring/SKILL.md · Turning a correction into learning without lecturing. Trigger: load when a real misconception would hurt the user…
v1.1 · audit A · 2 stars
lh-tradeoffs SKILL.md skill
jrodrigopuca/local-agents · architect/skills/lh-tradeoffs/SKILL.md · Method for analyzing and presenting expensive-to-reverse technical decisions: drivers, options, tradeoff table…
v1.1 · audit A · 2 stars
AGENTS.md@data-ml AGENTS.md file
jrodrigopuca/local-agents · data-ml/AGENTS.md · Use this agent for data pipelines, ML modeling, and LLM integration — ingestion/quality, honest evaluation, and…
git:20261014.9571e8f · audit A · 2 stars
lh-data-pipelines SKILL.md skill
jrodrigopuca/local-agents · data-ml/skills/lh-data-pipelines/SKILL.md · Moving data reliably: ingestion, transformation, quality validation, storage, and pipeline design. Trigger: load when…
v1.1 · audit A · 2 stars
lh-llm-integration SKILL.md skill
jrodrigopuca/local-agents · data-ml/skills/lh-llm-integration/SKILL.md · Building reliable product features on LLMs: RAG, prompting-as-code, output validation, evals, and cost/latency…
v1.1 · audit A · 2 stars

Every file in jrodrigopuca/local-agents

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