diff --git a/docs/index.md b/docs/index.md
index d5e1f83e..47dbb80d 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -98,9 +98,11 @@ Instructions for loading agents and running workflows in your development enviro
 
 ### Custom Agents
 
-- **[Custom Agent Installation](./custom-agent-installation.md)** - Install and personalize agents with `bmad agent-install`
+- **[Custom Agent Installation](./custom-agent-installation.md)** - Install and personalize agents using `custom.yaml` with `npx bmad-method install` (or `bmad install`)
 - [Agent Customization Guide](./agent-customization-guide.md) - Customize agent behavior and responses
 
+> Note: The legacy `bmad agent-install` command was removed in alpha.14. Use the `custom.yaml` installer flow instead when upgrading from earlier alphas.
+
 ### Installation & Bundling
 
 - [IDE Injections Reference](./installers-bundlers/ide-injections.md) - How agents are installed to IDEs