diff --git a/docs/_basement/explanation/bmm/index.md b/docs/_basement/explanation/bmm.md
similarity index 100%
rename from docs/_basement/explanation/bmm/index.md
rename to docs/_basement/explanation/bmm.md
diff --git a/docs/_basement/how-to/customization/index.md b/docs/_basement/how-to/customization/index.md
deleted file mode 100644
index a792104c..00000000
--- a/docs/_basement/how-to/customization/index.md
+++ /dev/null
@@ -1,23 +0,0 @@
----
-title: "BMad Customization"
----
-
-Personalize agents and workflows to match your needs.
-
-## Guides
-
-| Guide | Description |
-|-------|-------------|
-| **[Agent Customization](/docs/how-to/customization/customize-agents.md)** | Modify agent behavior without editing core files |
-
-## Overview
-
-BMad provides two main customization approaches:
-
-### Agent Customization
-
-Modify any agent's persona, name, capabilities, or menu items using `.customize.yaml` files in `_bmad/_config/agents/`. Your customizations persist through updates.
-
-### Workflow Customization
-
-Replace or extend workflow steps to create tailored processes. (Coming soon)
diff --git a/docs/_basement/how-to/installation/index.md b/docs/_basement/how-to/installation/index.md
deleted file mode 100644
index e3a3e29d..00000000
--- a/docs/_basement/how-to/installation/index.md
+++ /dev/null
@@ -1,12 +0,0 @@
----
-title: "Installation Guides"
-description: How to install and upgrade BMad Method
----
-
-How-to guides for installing and configuring the BMad Method.
-
-| Guide | Description |
-|-------|-------------|
-| [Install BMad](/docs/how-to/installation/install-bmad.md) | Step-by-step installation instructions |
-| [Install Custom Modules](/docs/how-to/installation/install-custom-modules.md) | Add custom agents, workflows, and modules |
-| [Upgrade to v6](/docs/how-to/installation/upgrade-to-v6.md) | Migrate from BMad v4 to v6 |
diff --git a/docs/_basement/reference/agents/index.md b/docs/_basement/reference/agents.md
similarity index 100%
rename from docs/_basement/reference/agents/index.md
rename to docs/_basement/reference/agents.md