From a64518f0aae734da4517ddd3763021ab2bfaa15f Mon Sep 17 00:00:00 2001
From: Razvan Bugoi <46108577+RazvanBugoi@users.noreply.github.com>
Date: Sun, 7 Dec 2025 13:29:06 +0000
Subject: [PATCH] Update custom agent installation guidance

---
 docs/index.md | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

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