diff --git a/apps/readest-app/.agents/memory b/apps/readest-app/.agents/memory
new file mode 120000
index 00000000..56a116d1
--- /dev/null
+++ b/apps/readest-app/.agents/memory
@@ -0,0 +1 @@
+../.claude/memory
\ No newline at end of file
diff --git a/apps/readest-app/.agents/plans b/apps/readest-app/.agents/plans
new file mode 120000
index 00000000..c0fa92d9
--- /dev/null
+++ b/apps/readest-app/.agents/plans
@@ -0,0 +1 @@
+../.claude/plans
\ No newline at end of file
diff --git a/apps/readest-app/.agents/rules b/apps/readest-app/.agents/rules
new file mode 120000
index 00000000..52694831
--- /dev/null
+++ b/apps/readest-app/.agents/rules
@@ -0,0 +1 @@
+../.claude/rules
\ No newline at end of file
diff --git a/apps/readest-app/.claude/skills/gstack b/apps/readest-app/.claude/skills/gstack
index 19e699ab..22f8c7f4 160000
--- a/apps/readest-app/.claude/skills/gstack
+++ b/apps/readest-app/.claude/skills/gstack
@@ -1 +1 @@
-Subproject commit 19e699ab9b69de9e1bf10d4b7c2682703b56f984
+Subproject commit 22f8c7f4e1eda65680d4b87a2548429f44020277
diff --git a/apps/readest-app/AGENTS.md b/apps/readest-app/AGENTS.md
index 9ba0519b..c72ae4a0 100644
--- a/apps/readest-app/AGENTS.md
+++ b/apps/readest-app/AGENTS.md
@@ -65,9 +65,17 @@ pnpm worktree:new feat/my-feature   # New branch from origin/main
 pnpm worktree:new 3837              # Checkout PR #3837 with push access to fork
 ```
 
+## Agent Workspace
+
+Project-related agent context lives under `.agents/`, which is a symlink to `.claude/`. Treat `.agents/` as the canonical path when looking for or updating local agent material:
+
+- `.agents/memory/` — persistent project memory and recurring context
+- `.agents/plans/` — active or archived implementation plans
+- `.agents/rules/` — project rules for test-first work, TypeScript, verification, and related workflows
+
 ## Project Rules
 
-Rules are in `.claude/rules/`: test-first, typescript, verification.
+Rules are in `.agents/rules/`: test-first, typescript, verification.
 
 ### i18n
 
@@ -92,20 +100,3 @@ Every new UI widget must look right under `[data-eink='true']`. E-ink screens ha
 
 When in doubt, toggle E-ink in Settings → Misc and check. The rules in `globals.css` cover most cases automatically, but composite components (custom buttons, layered cards) often need `eink-bordered` on the right element to stay legible.
 
-Available gstack skills:
-
-- `/plan-ceo-review` — CEO/founder-mode plan review
-- `/plan-eng-review` — Eng manager-mode plan review
-- `/plan-design-review` — Designer's eye review of a live site
-- `/design-consultation` — Design system consultation
-- `/review` — Pre-landing PR review
-- `/ship` — Ship workflow (merge, test, review, bump, PR)
-- `/browse` — Fast headless browser for QA and site interaction
-- `/qa` — QA test and fix bugs
-- `/qa-only` — QA report only (no fixes)
-- `/qa-design-review` — Designer's eye QA with fixes
-- `/setup-browser-cookies` — Import cookies for authenticated testing
-- `/retro` — Weekly engineering retrospective
-- `/document-release` — Post-ship documentation update
-
-If gstack skills aren't working, run `cd .claude/skills/gstack && ./setup` to build the binary and register skills.