From 50755c64ed28e37f471b97ff87545198a4f6e6fa Mon Sep 17 00:00:00 2001
From: Napas Udomsak <14320466+tian000@users.noreply.github.com>
Date: Tue, 18 Aug 2026 17:46:09 +0000
Subject: [PATCH] docs: add agent instruction entrypoints

Co-authored-by: casper-phantom <273411261+phantom-autopilot@users.noreply.github.com>
---
 AGENTS.md | 22 ++++++++++++++++++++++
 CLAUDE.md |  1 +
 2 files changed, 23 insertions(+)
 create mode 100644 AGENTS.md
 create mode 120000 CLAUDE.md

diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 000000000..8cd75add2
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,22 @@
+# Repository instructions
+
+## Purpose
+This repository contains Phantom's `@phantom/react-native-fast-image` package, a performant React Native image component backed by SDWebImage on iOS and Glide on Android.
+
+## Layout
+- `src/`: JavaScript and TypeScript package source.
+- `ios/`: native iOS implementation.
+- `android/`: native Android implementation.
+- `ReactNativeFastImageExample/`: React Native example app used for manual development.
+- `ReactNativeFastImageExampleServer/`: server used by the example project.
+- `docs/`: development and troubleshooting documentation.
+
+## Development and validation
+Use Yarn v1 and keep `yarn.lock` in sync with dependency changes.
+
+- Install dependencies: `yarn --frozen-lockfile`
+- Build the package: `yarn build`
+- Run tests with coverage: `yarn test --coverage`
+- Run the configured linter: `yarn lint`
+
+To exercise native changes, follow `docs/development.md` to link the package into `ReactNativeFastImageExample/`, start Metro, and run the iOS or Android app. This project targets the latest React Native version rather than backporting new features to older releases.
diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 120000
index 000000000..47dc3e3d8
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1 @@
+AGENTS.md
\ No newline at end of file