diff --git a/README.md b/README.md
index bf8c1b3..9ab11ef 100644
--- a/README.md
+++ b/README.md
@@ -1,41 +1,17 @@
-# core-claude
+# core-claude (ARCHIVED)
 
-Claude Code plugin for the Host UK federated monorepo.
+> **This repository has been superseded by [`core/agent`](https://forge.lthn.ai/core/agent).**
+>
+> All hooks, scripts, skills, and commands from this repo are included in core/agent,
+> which adds 37 additional scripts, 25 commands, 3 new skills, and 4 extra hooks.
 
-## Installation
+## Migration
 
 ```bash
-/plugin marketplace add host-uk/core-claude
-/plugin install core@core-claude
+# Remove old plugin
+/plugin uninstall core@core-claude
+
+# Install replacement
+/plugin marketplace add core/agent
+/plugin install code@core/agent
 ```
-
-## Features
-
-### Skills
-- **core** - Core CLI command reference for multi-repo management
-- **core-php** - PHP module patterns for Laravel packages
-- **core-go** - Go package patterns for the CLI
-
-### Commands
-- `/core:remember <fact>` - Save context facts that persist across compaction
-
-### Hooks
-
-**Safety hooks:**
-- Blocks destructive commands (`rm -rf`, `sed -i`, mass operations)
-- Enforces `core` CLI over raw `go`/`php` commands
-- Prevents random .md file creation
-
-**Context preservation:**
-- Saves state before auto-compact (prevents "amnesia")
-- Restores recent session context on startup
-- Extracts actionables from tool output
-
-**Auto-formatting:**
-- PHP files via Pint after edits
-- Go files via gofmt after edits
-- Warns about debug statements
-
-## Dependencies
-
-- [superpowers](https://github.com/anthropics/claude-plugins-official) from claude-plugins-official
\ No newline at end of file