From 01457f54355aca0b7f8d8be1dd5cbc2ff750dfee Mon Sep 17 00:00:00 2001
From: johnxie <john@taskade.com>
Date: Mon, 2 Mar 2026 09:00:49 -0800
Subject: [PATCH] refactor: rename tutorials/*/index.md to README.md for GitHub
 auto-rendering
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

GitHub only auto-renders README.md when browsing directories. Previously,
visiting tutorials/langchain-tutorial/ on GitHub showed a file listing —
users had to click index.md manually. Now the tutorial content renders
automatically.

Changes:
- rename 191 tutorials/*/index.md → README.md
- resolve 10 tutorials that had both files (delete old stub README.md,
  keep canonical index.md content, then rename)
- update 1,550 cross-references in chapter files: (index.md) → (README.md)
- update 14 Python scripts to reference README.md instead of index.md
- regenerate all discoverability assets, manifest, snapshots, status docs

Jekyll compatibility: GitHub Pages includes the jekyll-readme-index plugin
by default, which converts README.md to index.html. The has_children: true
frontmatter continues to work as before.

All CI checks validated locally:
- docs_health: 0 broken links, 0 missing indexes
- check_index_format_v2: 130 compliant indexes
- all diff checks (manifest, snapshot, repo status, discoverability): clean

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
---
 CONTENT_GAPS_ANALYSIS.md                      |   2 +-
 TUTORIAL_STRUCTURE.md                         |   2 +-
 discoverability/query-coverage.json           | 102 +--
 discoverability/query-hub.md                  | 102 +--
 discoverability/search-intent-map.md          | 234 +++---
 discoverability/tutorial-directory.md         | 382 ++++-----
 discoverability/tutorial-index.json           | 764 +++++++++---------
 discoverability/tutorial-itemlist.schema.json | 382 ++++-----
 llms-full.txt                                 | 382 ++++-----
 scripts/add_index_navigation_backlinks.py     |   2 +-
 scripts/apply_pocketflow_style_pass.py        |   2 +-
 scripts/check_index_format_v2.py              |   2 +-
 scripts/clean_source_references.py            |   2 +-
 scripts/contextualize_chapter_sections.py     |   4 +-
 scripts/deepen_v2_chapters.py                 |   2 +-
 scripts/docs_health.py                        |   6 +-
 scripts/generate_discoverability_assets.py    |   8 +-
 scripts/generate_tutorial_manifest.py         |   2 +-
 scripts/release_claims_audit.py               |   2 +-
 scripts/staleness_audit.py                    |   2 +-
 scripts/update_repo_status_docs.py            |   6 +-
 scripts/update_tutorials_readme_snapshot.py   |   4 +-
 scripts/verify_tutorial_sources.py            |   4 +-
 tutorials/README.md                           |   8 +-
 .../01-getting-started.md                     |   2 +-
 ...2-system-architecture-app-worker-engine.md |   2 +-
 ...03-flow-design-versioning-and-debugging.md |   2 +-
 .../04-piece-development-framework.md         |   2 +-
 ...tallation-and-environment-configuration.md |   2 +-
 ...dmin-governance-and-ai-provider-control.md |   2 +-
 ...7-api-automation-and-embedding-patterns.md |   2 +-
 ...on-operations-security-and-contribution.md |   2 +-
 .../{index.md => README.md}                   |   0
 .../adk-python-tutorial/01-getting-started.md |   2 +-
 .../02-architecture-and-runner-lifecycle.md   |   2 +-
 ...gent-design-and-multi-agent-composition.md |   2 +-
 .../04-tools-mcp-and-confirmation-flows.md    |   2 +-
 ...-sessions-memory-and-context-management.md |   2 +-
 ...-evaluation-debugging-and-quality-gates.md |   2 +-
 ...07-deployment-and-production-operations.md |   2 +-
 ...ibution-workflow-and-ecosystem-strategy.md |   2 +-
 .../{index.md => README.md}                   |   0
 tutorials/ag2-tutorial/01-getting-started.md  |   2 +-
 tutorials/ag2-tutorial/02-agent-types.md      |   2 +-
 .../ag2-tutorial/03-conversation-patterns.md  |   2 +-
 tutorials/ag2-tutorial/04-code-execution.md   |   2 +-
 tutorials/ag2-tutorial/05-tool-integration.md |   2 +-
 tutorials/ag2-tutorial/06-group-chat.md       |   2 +-
 .../ag2-tutorial/07-advanced-patterns.md      |   2 +-
 tutorials/ag2-tutorial/08-production.md       |   2 +-
 .../ag2-tutorial/09-enterprise-operations.md  |   2 +-
 .../ag2-tutorial/{index.md => README.md}      |   0
 .../agentgpt-tutorial/01-getting-started.md   |   2 +-
 .../02-agent-architecture.md                  |   2 +-
 .../agentgpt-tutorial/03-task-planning.md     |   2 +-
 .../agentgpt-tutorial/04-tool-integration.md  |   2 +-
 .../agentgpt-tutorial/05-memory-management.md |   2 +-
 .../06-safety-reliability.md                  |   2 +-
 .../agentgpt-tutorial/07-advanced-patterns.md |   2 +-
 .../08-production-deployment.md               |   2 +-
 .../agentgpt-tutorial/{index.md => README.md} |   0
 .../01-getting-started.md                     |   2 +-
 .../02-architecture-and-routing-system.md     |   2 +-
 ...installation-runtime-and-provider-setup.md |   2 +-
 .../04-docker-web-mode-and-cli-operations.md  |   2 +-
 ...ser-automation-and-workspace-governance.md |   2 +-
 ...6-model-strategy-and-remote-server-mode.md |   2 +-
 ...roubleshooting-and-reliability-playbook.md |   2 +-
 ...ibution-workflow-and-project-governance.md |   2 +-
 .../{index.md => README.md}                   |   0
 .../agents-md-tutorial/01-getting-started.md  |   2 +-
 ...-section-design-and-instruction-quality.md |   2 +-
 .../03-tool-agnostic-portability-patterns.md  |   2 +-
 ...repository-structure-and-scope-strategy.md |   2 +-
 .../05-testing-linting-and-ci-alignment.md    |   2 +-
 .../06-team-rollout-and-adoption-playbook.md  |   2 +-
 ...governance-versioning-and-drift-control.md |   2 +-
 ...tem-contribution-and-standard-evolution.md |   2 +-
 .../{index.md => README.md}                   |   0
 tutorials/agno-tutorial/01-getting-started.md |   2 +-
 .../02-framework-architecture.md              |   2 +-
 .../03-learning-memory-and-state.md           |   2 +-
 .../04-multi-agent-orchestration.md           |   2 +-
 .../05-knowledge-rag-and-tools.md             |   2 +-
 .../06-agentos-runtime-and-control-plane.md   |   2 +-
 .../07-guardrails-evals-and-observability.md  |   2 +-
 .../agno-tutorial/08-production-deployment.md |   2 +-
 .../agno-tutorial/{index.md => README.md}     |   0
 .../aider-tutorial/01-getting-started.md      |   2 +-
 tutorials/aider-tutorial/02-basic-editing.md  |   2 +-
 tutorials/aider-tutorial/03-multi-file.md     |   2 +-
 tutorials/aider-tutorial/04-git.md            |   2 +-
 tutorials/aider-tutorial/05-prompting.md      |   2 +-
 tutorials/aider-tutorial/06-models.md         |   2 +-
 tutorials/aider-tutorial/07-workflows.md      |   2 +-
 tutorials/aider-tutorial/08-best-practices.md |   2 +-
 .../aider-tutorial/{index.md => README.md}    |   0
 .../01-getting-started.md                     |   2 +-
 .../02-messages-api.md                        |   2 +-
 .../anthropic-code-tutorial/03-tool-use.md    |   2 +-
 .../anthropic-code-tutorial/04-vision.md      |   2 +-
 .../anthropic-code-tutorial/05-streaming.md   |   2 +-
 .../06-advanced-patterns.md                   |   2 +-
 .../anthropic-code-tutorial/07-production.md  |   2 +-
 .../anthropic-code-tutorial/08-enterprise.md  |   2 +-
 .../{index.md => README.md}                   |   0
 .../01-getting-started.md                     |   2 +-
 .../02-skill-categories.md                    |   2 +-
 .../03-advanced-skill-design.md               |   2 +-
 .../04-integration-platforms.md               |   2 +-
 .../05-production-skills.md                   |   2 +-
 .../06-best-practices.md                      |   2 +-
 .../07-publishing-sharing.md                  |   2 +-
 .../08-real-world-examples.md                 |   2 +-
 .../{index.md => README.md}                   |   0
 .../01-getting-started.md                     |   2 +-
 .../anything-llm-tutorial/02-workspaces.md    |   2 +-
 .../anything-llm-tutorial/03-documents.md     |   2 +-
 .../anything-llm-tutorial/04-llm-config.md    |   2 +-
 .../anything-llm-tutorial/05-vector-stores.md |   2 +-
 tutorials/anything-llm-tutorial/06-agents.md  |   2 +-
 tutorials/anything-llm-tutorial/07-api.md     |   2 +-
 .../anything-llm-tutorial/08-production.md    |   2 +-
 .../{index.md => README.md}                   |   0
 .../01-system-overview.md                     |   2 +-
 .../02-datascript-database.md                 |   2 +-
 .../03-schema-design.md                       |   2 +-
 .../04-app-architecture.md                    |   2 +-
 .../05-component-system.md                    |   2 +-
 .../06-event-handling.md                      |   2 +-
 .../07-block-editor.md                        |   2 +-
 .../08-rich-text.md                           |   4 +-
 .../athens-research-knowledge-graph/README.md | 146 +++-
 .../athens-research-knowledge-graph/index.md  | 132 ---
 .../autoagent-tutorial/01-getting-started.md  |   2 +-
 .../02-architecture-and-interaction-modes.md  |   2 +-
 ...-installation-environment-and-api-setup.md |   2 +-
 ...04-agent-and-workflow-creation-patterns.md |   2 +-
 ...ooling-python-api-and-custom-extensions.md |   2 +-
 ...06-cli-operations-and-provider-strategy.md |   2 +-
 ...nchmarking-evaluation-and-quality-gates.md |   2 +-
 ...tion-workflow-and-production-governance.md |   2 +-
 .../{index.md => README.md}                   |   0
 .../autogen-tutorial/01-getting-started.md    |   2 +-
 .../autogen-tutorial/02-agent-architecture.md |   2 +-
 .../03-agent-communication.md                 |   2 +-
 .../autogen-tutorial/04-tool-integration.md   |   2 +-
 .../autogen-tutorial/05-task-decomposition.md |   2 +-
 .../autogen-tutorial/06-custom-agents.md      |   2 +-
 .../07-multi-agent-workflows.md               |   2 +-
 .../08-production-deployment.md               |   2 +-
 .../autogen-tutorial/{index.md => README.md}  |   0
 .../01-getting-started.md                     |   2 +-
 .../02-list-taxonomy-and-navigation.md        |   2 +-
 ...3-resource-quality-evaluation-framework.md |   2 +-
 ...skills-hooks-and-slash-command-patterns.md |   2 +-
 ...ude-md-and-project-scaffolding-patterns.md |   2 +-
 ...tomation-pipeline-and-readme-generation.md |   2 +-
 ...ink-health-validation-and-drift-control.md |   2 +-
 ...08-contribution-workflow-and-governance.md |   2 +-
 .../{index.md => README.md}                   |   0
 .../01-getting-started.md                     |   2 +-
 .../02-catalog-taxonomy-and-navigation.md     |   2 +-
 ...llation-paths-claude-ai-claude-code-api.md |   2 +-
 ...uthoring-template-and-quality-standards.md |   2 +-
 ...app-automation-via-composio-skill-packs.md |   2 +-
 ...tion-workflow-and-repository-governance.md |   2 +-
 ...k-management-and-skill-selection-rubric.md |   2 +-
 ...8-team-adoption-and-ongoing-maintenance.md |   2 +-
 .../{index.md => README.md}                   |   0
 .../01-getting-started.md                     |   2 +-
 .../02-list-taxonomy-and-legend.md            |   2 +-
 .../03-clients-and-runtime-compatibility.md   |   2 +-
 .../04-server-selection-and-quality-rubric.md |   2 +-
 ...installation-and-configuration-patterns.md |   2 +-
 ...-contribution-workflow-and-list-hygiene.md |   2 +-
 ...7-operations-security-and-risk-controls.md |   2 +-
 .../08-team-adoption-and-maintenance.md       |   2 +-
 .../{index.md => README.md}                   |   0
 .../01-getting-started.md                     |   2 +-
 .../02-server-catalog-and-role-composition.md |   2 +-
 ...ansport-and-client-integration-patterns.md |   2 +-
 .../04-infrastructure-and-iac-workflows.md    |   2 +-
 .../05-data-knowledge-and-agent-workflows.md  |   2 +-
 ...-security-credentials-and-risk-controls.md |   2 +-
 ...pment-testing-and-contribution-workflow.md |   2 +-
 ...08-production-operations-and-governance.md |   2 +-
 .../{index.md => README.md}                   |   0
 .../babyagi-tutorial/01-getting-started.md    |   2 +-
 ...-architecture-task-queue-and-agent-loop.md |   2 +-
 ...m-backend-integration-and-configuration.md |   2 +-
 ...task-creation-and-prioritization-engine.md |   2 +-
 ...ry-systems-and-vector-store-integration.md |   2 +-
 ...tending-babyagi-custom-tools-and-skills.md |   2 +-
 ...gi-evolution-2o-and-functionz-framework.md |   2 +-
 ...ction-patterns-and-research-adaptations.md |   2 +-
 .../babyagi-tutorial/{index.md => README.md}  |   0
 .../beads-tutorial/01-getting-started.md      |   2 +-
 .../02-architecture-and-data-model.md         |   2 +-
 .../03-core-workflow-commands.md              |   2 +-
 ...dependency-graph-and-hierarchy-patterns.md |   2 +-
 ...gent-integration-and-agents-md-patterns.md |   2 +-
 ...ranch-collaboration-and-protected-flows.md |   2 +-
 .../07-troubleshooting-and-operations.md      |   2 +-
 ...ution-workflow-and-ecosystem-extensions.md |   2 +-
 .../beads-tutorial/{index.md => README.md}    |   0
 .../bentoml-tutorial/01-getting-started.md    |   2 +-
 .../bentoml-tutorial/02-model-packaging.md    |   2 +-
 .../bentoml-tutorial/03-api-development.md    |   2 +-
 .../04-framework-integration.md               |   2 +-
 .../bentoml-tutorial/05-testing-validation.md |   2 +-
 .../06-deployment-strategies.md               |   2 +-
 .../07-monitoring-observability.md            |   2 +-
 .../bentoml-tutorial/08-production-scaling.md |   2 +-
 .../bentoml-tutorial/{index.md => README.md}  |   0
 .../bolt-diy-tutorial/01-getting-started.md   |   2 +-
 .../02-architecture-overview.md               |   2 +-
 .../03-providers-and-routing.md               |   2 +-
 .../04-prompt-to-app-workflow.md              |   2 +-
 .../05-files-diff-locking.md                  |   2 +-
 .../06-integrations-and-mcp.md                |   2 +-
 .../07-deployment-distribution.md             |   2 +-
 .../08-production-operations.md               |   2 +-
 .../bolt-diy-tutorial/{index.md => README.md} |   0
 .../botpress-tutorial/01-getting-started.md   |   2 +-
 .../02-visual-flow-builder.md                 |   2 +-
 .../03-natural-language-understanding.md      |   2 +-
 .../04-custom-actions-code.md                 |   2 +-
 .../05-channel-integrations.md                |   2 +-
 .../botpress-tutorial/06-advanced-features.md |   2 +-
 .../07-analytics-monitoring.md                |   2 +-
 .../08-production-deployment.md               |   2 +-
 .../botpress-tutorial/{index.md => README.md} |   0
 .../01-getting-started.md                     |   2 +-
 .../02-browser-control.md                     |   2 +-
 .../03-element-selection.md                   |   2 +-
 .../04-form-automation.md                     |   2 +-
 .../05-data-extraction.md                     |   2 +-
 .../browser-use-tutorial/06-multi-tab.md      |   2 +-
 .../browser-use-tutorial/07-custom-actions.md |   2 +-
 .../browser-use-tutorial/08-production.md     |   2 +-
 .../{index.md => README.md}                   |   0
 .../chatbox-tutorial/01-getting-started.md    |   2 +-
 .../chatbox-tutorial/02-ui-architecture.md    |   2 +-
 tutorials/chatbox-tutorial/03-ai-providers.md |   2 +-
 .../04-conversation-management.md             |   2 +-
 .../chatbox-tutorial/05-message-processing.md |   2 +-
 tutorials/chatbox-tutorial/06-theme-system.md |   2 +-
 .../chatbox-tutorial/07-plugin-system.md      |   2 +-
 .../08-production-deployment.md               |   2 +-
 .../chatbox-tutorial/{index.md => README.md}  |   0
 .../01-getting-started.md                     |   2 +-
 .../02-core-architecture-and-product-model.md |   2 +-
 .../03-provider-configuration-and-routing.md  |   2 +-
 ...4-assistants-topics-and-workflow-design.md |   2 +-
 .../05-documents-mcp-and-tool-integrations.md |   2 +-
 ...am-adoption-and-enterprise-capabilities.md |   2 +-
 ...7-development-and-contribution-workflow.md |   2 +-
 ...08-production-operations-and-governance.md |   2 +-
 .../{index.md => README.md}                   |   0
 .../chroma-tutorial/01-getting-started.md     |   2 +-
 .../02-collections-documents.md               |   2 +-
 .../chroma-tutorial/03-embeddings-indexing.md |   2 +-
 .../chroma-tutorial/04-querying-retrieval.md  |   2 +-
 .../chroma-tutorial/05-metadata-filtering.md  |   2 +-
 .../06-integration-patterns.md                |   2 +-
 .../07-production-deployment.md               |   2 +-
 .../08-performance-optimization.md            |   2 +-
 .../chroma-tutorial/{index.md => README.md}   |   0
 .../01-getting-started.md                     |   2 +-
 .../02-architecture-and-design-principles.md  |   2 +-
 ...-client-integrations-and-setup-patterns.md |   2 +-
 ...automation-tooling-input-and-navigation.md |   2 +-
 .../05-performance-and-debugging-workflows.md |   2 +-
 ...oubleshooting-and-reliability-hardening.md |   2 +-
 ...development-evaluation-and-contribution.md |   2 +-
 ...ction-operations-and-privacy-governance.md |   2 +-
 .../{index.md => README.md}                   |   0
 .../cipher-tutorial/01-getting-started.md     |   2 +-
 .../02-core-modes-and-session-workflow.md     |   2 +-
 .../03-memory-architecture-and-data-model.md  |   2 +-
 ...-configuration-providers-and-embeddings.md |   2 +-
 .../05-vector-stores-and-workspace-memory.md  |   2 +-
 .../06-mcp-integration-patterns.md            |   2 +-
 .../07-deployment-and-operations-modes.md     |   2 +-
 .../08-security-and-team-governance.md        |   2 +-
 .../cipher-tutorial/{index.md => README.md}   |   0
 .../01-getting-started.md                     |   2 +-
 .../02-architecture-and-package-topology.md   |   2 +-
 ...-configuration-and-transformer-strategy.md |   2 +-
 ...rules-fallbacks-and-custom-router-logic.md |   2 +-
 ...s-model-preset-and-statusline-workflows.md |   2 +-
 ...6-server-deployment-and-api-integration.md |   2 +-
 ...tions-non-interactive-mode-and-team-ops.md |   2 +-
 ...ting-security-and-contribution-workflow.md |   2 +-
 .../{index.md => README.md}                   |   0
 .../01-getting-started.md                     |   2 +-
 .../claude-code-tutorial/02-basic-commands.md |   2 +-
 .../03-code-understanding.md                  |   2 +-
 .../claude-code-tutorial/04-file-editing.md   |   2 +-
 tutorials/claude-code-tutorial/05-commands.md |   2 +-
 tutorials/claude-code-tutorial/06-git.md      |   2 +-
 tutorials/claude-code-tutorial/07-mcp.md      |   2 +-
 tutorials/claude-code-tutorial/08-advanced.md |   2 +-
 .../{index.md => README.md}                   |   0
 .../01-getting-started.md                     |   2 +-
 .../02-v3-architecture-and-adrs.md            |   2 +-
 ...arm-coordination-and-consensus-patterns.md |   2 +-
 ...emory-learning-and-intelligence-systems.md |   2 +-
 ...5-mcp-server-cli-and-runtime-operations.md |   2 +-
 ...6-plugin-sdk-and-extensibility-patterns.md |   2 +-
 ...-testing-migration-and-upgrade-strategy.md |   2 +-
 ...ion-governance-security-and-performance.md |   2 +-
 .../{index.md => README.md}                   |   0
 .../claude-mem-tutorial/01-getting-started.md |   2 +-
 .../02-architecture-hooks-and-worker-flow.md  |   2 +-
 ...llation-upgrade-and-runtime-environment.md |   2 +-
 ...nfiguration-modes-and-context-injection.md |   2 +-
 ...search-tools-and-progressive-disclosure.md |   2 +-
 ...er-operations-and-maintenance-workflows.md |   2 +-
 ...roubleshooting-recovery-and-reliability.md |   2 +-
 ...08-contribution-workflow-and-governance.md |   2 +-
 .../{index.md => README.md}                   |   0
 .../01-getting-started.md                     |   2 +-
 ...tory-architecture-and-marketplace-model.md |   2 +-
 ...lugin-manifest-and-structural-contracts.md |   2 +-
 ...agents-skills-hooks-and-mcp-composition.md |   2 +-
 .../05-trust-security-and-risk-controls.md    |   2 +-
 ...allation-operations-and-update-strategy.md |   2 +-
 ...07-submission-and-contribution-workflow.md |   2 +-
 ...-enterprise-plugin-portfolio-management.md |   2 +-
 .../{index.md => README.md}                   |   0
 .../01-getting-started.md                     |   2 +-
 .../02-customer-support-agents.md             |   2 +-
 .../03-data-processing-analysis.md            |   2 +-
 .../04-browser-computer-use.md                |   2 +-
 .../05-autonomous-coding-agents.md            |   2 +-
 .../06-production-patterns.md                 |   2 +-
 .../07-evaluation-guardrails.md               |   2 +-
 .../08-enterprise-operations.md               |   2 +-
 .../{index.md => README.md}                   |   0
 .../01-getting-started.md                     |   2 +-
 .../02-tmux-and-worktree-architecture.md      |   2 +-
 ...-session-lifecycle-and-task-parallelism.md |   2 +-
 .../04-multi-agent-program-integration.md     |   2 +-
 .../05-review-checkout-and-push-workflow.md   |   2 +-
 ...oyes-daemon-polling-and-safety-controls.md |   2 +-
 .../07-configuration-and-state-management.md  |   2 +-
 .../08-production-team-operations.md          |   2 +-
 .../{index.md => README.md}                   |   0
 .../01-getting-started.md                     |   2 +-
 .../02-prd-analysis.md                        |   2 +-
 .../03-task-management.md                     |   2 +-
 .../04-multi-model-integration.md             |   2 +-
 .../05-editor-integrations.md                 |   2 +-
 .../06-context-control.md                     |   2 +-
 .../07-automation.md                          |   2 +-
 .../08-production.md                          |   2 +-
 .../{index.md => README.md}                   |   0
 .../clickhouse-tutorial/01-getting-started.md |   2 +-
 .../clickhouse-tutorial/02-data-modeling.md   |   2 +-
 .../clickhouse-tutorial/03-data-ingestion.md  |   2 +-
 .../04-query-optimization.md                  |   2 +-
 .../05-aggregation-analytics.md               |   2 +-
 .../06-distributed-setup.md                   |   2 +-
 .../07-performance-tuning.md                  |   2 +-
 .../08-production-deployment.md               |   2 +-
 .../{index.md => README.md}                   |   0
 .../cline-tutorial/01-getting-started.md      |   2 +-
 tutorials/cline-tutorial/02-agent-workflow.md |   2 +-
 .../03-file-editing-and-diffs.md              |   2 +-
 .../04-terminal-and-runtime-tools.md          |   2 +-
 .../cline-tutorial/05-browser-automation.md   |   2 +-
 .../cline-tutorial/06-mcp-and-custom-tools.md |   2 +-
 .../07-context-and-cost-control.md            |   2 +-
 .../08-team-and-enterprise-operations.md      |   2 +-
 .../cline-tutorial/{index.md => README.md}    |   0
 .../01-getting-started.md                     |   2 +-
 .../02-orchestration-architecture.md          |   2 +-
 .../03-workflow-design-patterns.md            |   2 +-
 .../04-multi-agent-and-parallel-execution.md  |   2 +-
 ...5-context-engineering-and-state-control.md |   2 +-
 .../06-persistence-and-long-running-jobs.md   |   2 +-
 ...7-engine-integrations-and-compatibility.md |   2 +-
 ...production-operations-and-team-adoption.md |   2 +-
 .../{index.md => README.md}                   |   0
 .../01-analysis-engine.md                     |   2 +-
 .../02-ast-processing.md                      |   2 +-
 .../03-symbol-resolution.md                   |   2 +-
 .../04-code-intelligence.md                   |   2 +-
 .../05-lsp-implementation.md                  |   2 +-
 .../06-visualization.md                       |   2 +-
 .../07-automation-pipelines.md                |   2 +-
 .../08-production-rollout.md                  |   2 +-
 tutorials/codex-analysis-platform/README.md   | 133 +--
 tutorials/codex-analysis-platform/index.md    | 102 ---
 .../codex-cli-tutorial/01-getting-started.md  |   2 +-
 ...-architecture-and-local-execution-model.md |   2 +-
 ...-authentication-and-model-configuration.md |   2 +-
 ...4-sandbox-approvals-and-mcp-integration.md |   2 +-
 ...ompts-skills-and-workflow-orchestration.md |   2 +-
 ...ommands-connectors-and-daily-operations.md |   2 +-
 ...anced-configuration-and-policy-controls.md |   2 +-
 ...ibution-workflow-and-ecosystem-strategy.md |   2 +-
 .../{index.md => README.md}                   |   0
 .../comfyui-tutorial/01-getting-started.md    |   2 +-
 .../comfyui-tutorial/02-nodes-workflows.md    |   2 +-
 .../comfyui-tutorial/03-text-to-image.md      |   2 +-
 .../comfyui-tutorial/04-image-to-image.md     |   2 +-
 .../05-controlnet-integration.md              |   2 +-
 .../comfyui-tutorial/06-lora-customization.md |   2 +-
 .../comfyui-tutorial/07-advanced-workflows.md |   2 +-
 .../08-production-optimization.md             |   2 +-
 .../comfyui-tutorial/{index.md => README.md}  |   0
 .../composio-tutorial/01-getting-started.md   |   2 +-
 ...02-sessions-meta-tools-and-user-scoping.md |   2 +-
 ...ider-integrations-and-framework-mapping.md |   2 +-
 ...4-authentication-and-connected-accounts.md |   2 +-
 .../05-tool-execution-modes-and-modifiers.md  |   2 +-
 ...mcp-server-patterns-and-toolkit-control.md |   2 +-
 ...-triggers-webhooks-and-event-automation.md |   2 +-
 ...tion-troubleshooting-and-production-ops.md |   2 +-
 .../composio-tutorial/{index.md => README.md} |   0
 .../01-getting-started.md                     |   2 +-
 ...ngineering-philosophy-and-workflow-loop.md |   2 +-
 ...hitecture-of-agents-commands-and-skills.md |   2 +-
 ...lti-provider-conversion-and-config-sync.md |   2 +-
 ...mcp-integrations-and-browser-automation.md |   2 +-
 .../06-daily-operations-and-quality-gates.md  |   2 +-
 ...troubleshooting-and-runtime-maintenance.md |   2 +-
 ...tion-workflow-and-versioning-discipline.md |   2 +-
 .../{index.md => README.md}                   |   0
 .../context7-tutorial/01-getting-started.md   |   2 +-
 .../02-architecture-and-tooling-model.md      |   2 +-
 ...-client-integrations-and-setup-patterns.md |   2 +-
 .../04-prompting-strategies-and-rules.md      |   2 +-
 .../05-api-workflows-and-sdk-patterns.md      |   2 +-
 ...ry-onboarding-and-documentation-quality.md |   2 +-
 ...7-troubleshooting-and-local-development.md |   2 +-
 ...08-production-operations-and-governance.md |   2 +-
 .../context7-tutorial/{index.md => README.md} |   0
 .../continue-tutorial/01-getting-started.md   |   2 +-
 .../continue-tutorial/02-code-completion.md   |   2 +-
 .../03-refactoring-optimization.md            |   2 +-
 .../04-documentation-comments.md              |   2 +-
 .../continue-tutorial/05-debugging-testing.md |   2 +-
 .../continue-tutorial/06-custom-models.md     |   2 +-
 .../07-team-collaboration.md                  |   2 +-
 .../08-advanced-enterprise.md                 |   2 +-
 .../continue-tutorial/{index.md => README.md} |   0
 .../01-getting-started.md                     |   2 +-
 .../02-authentication-and-access-policies.md  |   2 +-
 ...interactive-workflow-and-approval-model.md |   2 +-
 ...els-experimental-features-and-autopilot.md |   2 +-
 .../05-mcp-and-lsp-extension-points.md        |   2 +-
 .../06-github-native-context-workflows.md     |   2 +-
 .../07-installation-and-update-channels.md    |   2 +-
 ...-production-governance-and-team-rollout.md |   2 +-
 .../{index.md => README.md}                   |   0
 .../copilotkit-tutorial/01-getting-started.md |   2 +-
 .../copilotkit-tutorial/02-app-context.md     |   2 +-
 .../copilotkit-tutorial/03-copilot-actions.md |   2 +-
 .../copilotkit-tutorial/04-chat-components.md |   2 +-
 .../copilotkit-tutorial/05-generative-ui.md   |   2 +-
 tutorials/copilotkit-tutorial/06-coagents.md  |   2 +-
 .../copilotkit-tutorial/07-human-in-loop.md   |   2 +-
 .../copilotkit-tutorial/08-production.md      |   2 +-
 .../{index.md => README.md}                   |   0
 ...etting-started-and-scaffolding-workflow.md |   2 +-
 ...rated-project-structure-and-conventions.md |   2 +-
 ...rchitecture-resources-prompts-and-tools.md |   2 +-
 ...4-runtime-dependencies-and-uv-packaging.md |   2 +-
 ...ntegration-claude-desktop-and-inspector.md |   2 +-
 ...06-customization-and-extension-patterns.md |   2 +-
 ...ity-security-and-contribution-workflows.md |   2 +-
 ...atus-migration-and-long-term-operations.md |   4 +-
 .../{index.md => README.md}                   |   0
 ...01-getting-started-and-scaffolding-flow.md |   2 +-
 ...-generated-structure-and-build-pipeline.md |   2 +-
 ...-mcp-primitives-resources-tools-prompts.md |   2 +-
 ...04-configuration-metadata-and-packaging.md |   2 +-
 ...elopment-workflows-build-watch-and-link.md |   2 +-
 .../06-debugging-and-local-integration.md     |   2 +-
 ...ity-security-and-contribution-practices.md |   2 +-
 ...status-migration-and-long-term-strategy.md |   4 +-
 .../{index.md => README.md}                   |   0
 .../crewai-tutorial/01-getting-started.md     |   2 +-
 tutorials/crewai-tutorial/02-agent-roles.md   |   2 +-
 tutorials/crewai-tutorial/03-task-planning.md |   2 +-
 .../crewai-tutorial/04-tool-integration.md    |   2 +-
 .../crewai-tutorial/05-crew-communication.md  |   2 +-
 .../crewai-tutorial/06-process-management.md  |   2 +-
 .../crewai-tutorial/07-advanced-patterns.md   |   2 +-
 .../08-production-deployment.md               |   2 +-
 .../crewai-tutorial/{index.md => README.md}   |   0
 .../crush-tutorial/01-getting-started.md      |   2 +-
 .../02-architecture-and-session-model.md      |   2 +-
 .../03-providers-and-model-configuration.md   |   2 +-
 .../04-permissions-and-tool-controls.md       |   2 +-
 .../05-lsp-and-mcp-integration.md             |   2 +-
 ...lls-commands-and-workflow-customization.md |   2 +-
 .../07-logs-debugging-and-operations.md       |   2 +-
 .../08-production-governance-and-rollout.md   |   2 +-
 .../crush-tutorial/{index.md => README.md}    |   0
 .../daytona-tutorial/01-getting-started.md    |   2 +-
 ...sandbox-lifecycle-resources-and-regions.md |   2 +-
 .../03-process-and-code-execution-patterns.md |   2 +-
 .../04-file-git-and-preview-workflows.md      |   2 +-
 .../05-mcp-agent-integration-and-tooling.md   |   2 +-
 ...configuration-api-and-deployment-models.md |   2 +-
 ...07-limits-network-controls-and-security.md |   2 +-
 ...-production-operations-and-contribution.md |   2 +-
 .../daytona-tutorial/{index.md => README.md}  |   0
 .../deer-flow-tutorial/01-getting-started.md  |   2 +-
 .../deer-flow-tutorial/02-workflow-basics.md  |   2 +-
 .../deer-flow-tutorial/03-task-management.md  |   2 +-
 .../deer-flow-tutorial/04-dependencies.md     |   2 +-
 .../deer-flow-tutorial/05-error-handling.md   |   2 +-
 tutorials/deer-flow-tutorial/06-scaling.md    |   2 +-
 tutorials/deer-flow-tutorial/07-monitoring.md |   2 +-
 .../08-advanced-patterns.md                   |   2 +-
 .../{index.md => README.md}                   |   0
 .../devika-tutorial/01-getting-started.md     |   2 +-
 .../02-architecture-and-agent-pipeline.md     |   2 +-
 .../03-llm-provider-configuration.md          |   2 +-
 .../04-task-planning-and-code-generation.md   |   2 +-
 ...05-web-research-and-browser-integration.md |   2 +-
 .../06-project-management-and-workspaces.md   |   2 +-
 .../07-debugging-and-troubleshooting.md       |   2 +-
 ...08-production-operations-and-governance.md |   4 +-
 .../devika-tutorial/{index.md => README.md}   |   0
 .../01-system-overview.md                     |   2 +-
 .../02-core-architecture.md                   |   2 +-
 .../03-workflow-engine.md                     |   2 +-
 .../04-rag-implementation.md                  |   2 +-
 .../05-agent-framework.md                     |   2 +-
 .../06-custom-nodes.md                        |   2 +-
 .../07-production-deployment.md               |   2 +-
 .../08-operations-playbook.md                 |   4 +-
 tutorials/dify-platform-deep-dive/README.md   | 157 +++-
 tutorials/dify-platform-deep-dive/index.md    | 143 ----
 tutorials/dspy-tutorial/01-getting-started.md |   2 +-
 tutorials/dspy-tutorial/02-signatures.md      |   2 +-
 tutorials/dspy-tutorial/03-modules.md         |   2 +-
 tutorials/dspy-tutorial/04-rag.md             |   2 +-
 tutorials/dspy-tutorial/05-optimization.md    |   2 +-
 .../dspy-tutorial/06-advanced-patterns.md     |   2 +-
 tutorials/dspy-tutorial/07-evaluation.md      |   2 +-
 tutorials/dspy-tutorial/08-production.md      |   2 +-
 .../dspy-tutorial/{index.md => README.md}     |   0
 tutorials/dyad-tutorial/01-getting-started.md |   2 +-
 .../02-natural-language-building.md           |   2 +-
 .../dyad-tutorial/03-component-integration.md |   2 +-
 tutorials/dyad-tutorial/04-data-management.md |   2 +-
 tutorials/dyad-tutorial/05-api-integration.md |   2 +-
 .../dyad-tutorial/06-customization-styling.md |   2 +-
 .../dyad-tutorial/07-testing-validation.md    |   2 +-
 .../dyad-tutorial/08-deployment-sharing.md    |   2 +-
 .../dyad-tutorial/{index.md => README.md}     |   0
 .../elizaos-tutorial/01-getting-started.md    |   2 +-
 .../elizaos-tutorial/02-agent-runtime.md      |   2 +-
 .../elizaos-tutorial/03-character-system.md   |   2 +-
 .../04-plugin-architecture.md                 |   2 +-
 tutorials/elizaos-tutorial/05-memory-rag.md   |   2 +-
 .../06-platform-connectors.md                 |   2 +-
 tutorials/elizaos-tutorial/07-multi-agent.md  |   2 +-
 .../08-production-deployment.md               |   2 +-
 .../elizaos-tutorial/{index.md => README.md}  |   0
 .../01-getting-started.md                     |   2 +-
 .../02-architecture-and-component-topology.md |   2 +-
 ...3-installation-modes-and-rules-strategy.md |   2 +-
 ...agents-skills-and-command-orchestration.md |   2 +-
 ...hooks-mcp-and-continuous-learning-loops.md |   2 +-
 ...-platform-workflows-cursor-and-opencode.md |   2 +-
 ...esting-verification-and-troubleshooting.md |   2 +-
 ...08-contribution-workflow-and-governance.md |   2 +-
 .../{index.md => README.md}                   |   0
 .../fabric-tutorial/01-getting-started.md     |   2 +-
 .../fabric-tutorial/02-pattern-system.md      |   2 +-
 tutorials/fabric-tutorial/03-basic-usage.md   |   2 +-
 .../fabric-tutorial/04-advanced-patterns.md   |   2 +-
 .../fabric-tutorial/05-stitch-composition.md  |   2 +-
 .../fabric-tutorial/06-custom-patterns.md     |   2 +-
 .../fabric-tutorial/07-integration-api.md     |   2 +-
 .../08-enterprise-deployment.md               |   2 +-
 .../fabric-tutorial/{index.md => README.md}   |   0
 .../fastmcp-tutorial/01-getting-started.md    |   2 +-
 ...actions-components-providers-transforms.md |   2 +-
 .../03-server-runtime-and-transports.md       |   2 +-
 ...ent-architecture-and-transport-patterns.md |   2 +-
 ...grations-claude-code-cursor-and-tooling.md |   2 +-
 .../06-configuration-auth-and-deployment.md   |   2 +-
 ...sting-contributing-and-upgrade-strategy.md |   2 +-
 ...08-production-operations-and-governance.md |   2 +-
 .../fastmcp-tutorial/{index.md => README.md}  |   0
 .../01-getting-started.md                     |   2 +-
 ...02-architecture-and-context-translation.md |   2 +-
 .../03-frame-targeting-and-context-scope.md   |   2 +-
 ...patterns-for-one-shot-ui-implementation.md |   2 +-
 .../05-mcp-client-integrations.md             |   2 +-
 .../06-performance-and-token-optimization.md  |   2 +-
 ...07-team-workflows-and-design-governance.md |   2 +-
 .../08-production-security-and-operations.md  |   2 +-
 .../{index.md => README.md}                   |   0
 .../01-getting-started-and-core-setup.md      |   2 +-
 ...-architecture-transports-and-versioning.md |   2 +-
 ...lection-scrape-map-crawl-search-extract.md |   2 +-
 ...egrations-cursor-claude-windsurf-vscode.md |   2 +-
 ...iguration-retries-and-credit-monitoring.md |   2 +-
 ...rkflows-deep-research-and-api-evolution.md |   2 +-
 ...lity-observability-and-failure-handling.md |   2 +-
 ...ty-governance-and-contribution-workflow.md |   2 +-
 .../{index.md => README.md}                   |   0
 .../firecrawl-tutorial/01-getting-started.md  |   2 +-
 .../firecrawl-tutorial/02-basic-scraping.md   |   2 +-
 .../03-advanced-extraction.md                 |   2 +-
 .../04-javascript-handling.md                 |   2 +-
 .../firecrawl-tutorial/05-content-cleaning.md |   2 +-
 .../firecrawl-tutorial/06-rag-integration.md  |   2 +-
 .../07-scaling-performance.md                 |   2 +-
 .../08-production-deployment.md               |   2 +-
 .../{index.md => README.md}                   |   0
 .../fireproof-tutorial/01-getting-started.md  |   2 +-
 ...2-core-document-api-and-query-lifecycle.md |   2 +-
 .../03-react-hooks-and-live-local-first-ux.md |   2 +-
 .../04-ledger-crdt-and-causal-consistency.md  |   2 +-
 .../05-storage-gateways-and-sync-topology.md  |   2 +-
 ...6-files-attachments-and-rich-data-flows.md |   2 +-
 ...ime-coverage-browser-node-deno-and-edge.md |   2 +-
 ...ction-operations-security-and-debugging.md |   2 +-
 .../{index.md => README.md}                   |   0
 .../01-system-overview.md                     |   2 +-
 .../02-workflow-engine.md                     |   2 +-
 .../03-node-development.md                    |   2 +-
 .../04-advanced-integrations.md               |   2 +-
 .../05-production-deployment.md               |   2 +-
 .../06-security-governance.md                 |   2 +-
 .../07-observability.md                       |   2 +-
 .../08-extension-ecosystem.md                 |   4 +-
 tutorials/flowise-llm-orchestration/README.md | 146 +++-
 tutorials/flowise-llm-orchestration/index.md  | 134 ---
 .../gemini-cli-tutorial/01-getting-started.md |   2 +-
 .../02-architecture-tools-and-agent-loop.md   |   2 +-
 ...uthentication-and-model-access-strategy.md |   2 +-
 ...04-settings-context-and-custom-commands.md |   2 +-
 .../05-mcp-extensions-and-skills.md           |   2 +-
 .../06-headless-mode-and-ci-automation.md     |   2 +-
 ...sandboxing-security-and-troubleshooting.md |   2 +-
 ...tion-workflow-and-enterprise-operations.md |   2 +-
 .../{index.md => README.md}                   |   0
 .../01-getting-started.md                     |   2 +-
 .../02-architecture-and-control-plane.md      |   2 +-
 ...ols-yaml-sources-tools-toolsets-prompts.md |   2 +-
 ...mcp-connectivity-and-client-integration.md |   2 +-
 ...ebuilt-connectors-and-database-patterns.md |   2 +-
 ...6-deployment-and-observability-patterns.md |   2 +-
 ...07-cli-testing-and-development-workflow.md |   2 +-
 ...duction-governance-and-release-strategy.md |   2 +-
 .../{index.md => README.md}                   |   0
 .../01-getting-started.md                     |   2 +-
 .../02-remote-vs-local-architecture.md        |   2 +-
 .../03-authentication-and-token-strategy.md   |   2 +-
 ...04-toolsets-tools-and-dynamic-discovery.md |   2 +-
 .../05-host-integration-patterns.md           |   2 +-
 ...rity-governance-and-enterprise-controls.md |   2 +-
 ...oting-read-only-and-lockdown-operations.md |   2 +-
 .../08-contribution-and-upgrade-workflow.md   |   2 +-
 .../{index.md => README.md}                   |   0
 .../goose-tutorial/01-getting-started.md      |   2 +-
 .../02-architecture-and-agent-loop.md         |   2 +-
 .../03-providers-and-model-routing.md         |   2 +-
 .../04-permissions-and-tool-governance.md     |   2 +-
 .../05-sessions-and-context-management.md     |   2 +-
 .../06-extensions-and-mcp-integration.md      |   2 +-
 .../07-cli-workflows-and-automation.md        |   2 +-
 .../08-production-operations-and-security.md  |   2 +-
 .../goose-tutorial/{index.md => README.md}    |   0
 .../gpt-oss-tutorial/01-getting-started.md    |   2 +-
 .../02-transformer-architecture.md            |   2 +-
 .../03-tokenization-embeddings.md             |   2 +-
 .../gpt-oss-tutorial/04-training-pipeline.md  |   2 +-
 .../05-attention-mechanisms.md                |   2 +-
 .../06-scaling-distributed-training.md        |   2 +-
 .../07-fine-tuning-alignment.md               |   2 +-
 .../08-production-inference.md                |   2 +-
 .../gpt-oss-tutorial/{index.md => README.md}  |   0
 .../gptme-tutorial/01-getting-started.md      |   2 +-
 ...2-core-cli-workflow-and-prompt-patterns.md |   2 +-
 ...-tooling-and-local-execution-boundaries.md |   2 +-
 ...uration-layers-and-environment-strategy.md |   2 +-
 ...ext-lessons-and-conversation-management.md |   2 +-
 .../06-mcp-acp-and-plugin-extensibility.md    |   2 +-
 ...omation-server-mode-and-agent-templates.md |   2 +-
 .../08-production-operations-and-security.md  |   2 +-
 .../gptme-tutorial/{index.md => README.md}    |   0
 tutorials/hapi-tutorial/01-getting-started.md |   2 +-
 .../hapi-tutorial/02-system-architecture.md   |   2 +-
 .../03-session-lifecycle-and-handoff.md       |   2 +-
 .../04-remote-access-and-networking.md        |   2 +-
 .../05-permissions-and-approval-workflow.md   |   2 +-
 .../06-pwa-telegram-and-extensions.md         |   2 +-
 .../07-configuration-and-security.md          |   2 +-
 .../hapi-tutorial/08-production-operations.md |   2 +-
 .../hapi-tutorial/{index.md => README.md}     |   0
 .../haystack-tutorial/01-getting-started.md   |   2 +-
 .../haystack-tutorial/02-document-stores.md   |   2 +-
 .../haystack-tutorial/03-retrievers-search.md |   2 +-
 .../haystack-tutorial/04-generators-llms.md   |   2 +-
 .../05-pipelines-workflows.md                 |   2 +-
 .../06-evaluation-optimization.md             |   2 +-
 .../haystack-tutorial/07-custom-components.md |   2 +-
 .../08-production-deployment.md               |   2 +-
 .../haystack-tutorial/{index.md => README.md} |   0
 .../01-getting-started.md                     |   2 +-
 .../02-text-classification.md                 |   2 +-
 .../03-text-generation.md                     |   2 +-
 .../04-question-answering.md                  |   2 +-
 .../05-named-entity-recognition.md            |   2 +-
 .../06-translation-multilingual.md            |   2 +-
 .../huggingface-tutorial/07-fine-tuning.md    |   2 +-
 .../08-production-deployment.md               |   2 +-
 .../{index.md => README.md}                   |   0
 .../humanlayer-tutorial/01-getting-started.md |   2 +-
 .../02-architecture-and-monorepo-layout.md    |   2 +-
 .../03-context-engineering-workflows.md       |   2 +-
 .../04-parallel-agent-orchestration.md        |   2 +-
 ...-human-approval-and-high-stakes-actions.md |   2 +-
 .../06-ide-and-cli-integration-patterns.md    |   2 +-
 .../07-telemetry-cost-and-team-governance.md  |   2 +-
 .../08-production-rollout-and-adoption.md     |   2 +-
 .../{index.md => README.md}                   |   0
 .../instructor-tutorial/01-getting-started.md |   2 +-
 .../instructor-tutorial/02-pydantic-models.md |   2 +-
 .../instructor-tutorial/03-validation.md      |   2 +-
 tutorials/instructor-tutorial/04-complex.md   |   2 +-
 tutorials/instructor-tutorial/05-streaming.md |   2 +-
 tutorials/instructor-tutorial/06-providers.md |   2 +-
 tutorials/instructor-tutorial/07-advanced.md  |   2 +-
 .../instructor-tutorial/08-production.md      |   2 +-
 .../{index.md => README.md}                   |   0
 tutorials/khoj-tutorial/01-getting-started.md |   2 +-
 .../khoj-tutorial/02-architecture-overview.md |   2 +-
 tutorials/khoj-tutorial/03-data-connectors.md |   2 +-
 .../khoj-tutorial/04-search-and-retrieval.md  |   2 +-
 tutorials/khoj-tutorial/05-chat-interface.md  |   2 +-
 .../khoj-tutorial/06-automation-and-agents.md |   2 +-
 .../07-customization-and-plugins.md           |   2 +-
 .../khoj-tutorial/08-production-deployment.md |   2 +-
 .../khoj-tutorial/{index.md => README.md}     |   0
 .../kilocode-tutorial/01-getting-started.md   |   2 +-
 .../02-agent-loop-and-state-model.md          |   2 +-
 .../03-modes-prompts-and-approval-workflow.md |   2 +-
 .../04-authentication-and-provider-routing.md |   2 +-
 ...session-history-and-context-persistence.md |   2 +-
 .../06-extensions-mcp-and-custom-modes.md     |   2 +-
 ...7-cli-tui-architecture-for-contributors.md |   2 +-
 ...08-production-operations-and-governance.md |   2 +-
 .../kilocode-tutorial/{index.md => README.md} |   0
 .../kimi-cli-tutorial/01-getting-started.md   |   2 +-
 ...02-command-surface-and-session-controls.md |   2 +-
 .../03-agents-subagents-and-skills.md         |   2 +-
 .../04-mcp-tooling-and-security-model.md      |   2 +-
 .../05-acp-and-ide-integrations.md            |   2 +-
 .../06-shell-mode-print-mode-and-wire-mode.md |   2 +-
 .../07-loop-control-retries-and-long-tasks.md |   2 +-
 ...08-production-operations-and-governance.md |   2 +-
 .../kimi-cli-tutorial/{index.md => README.md} |   0
 tutorials/kiro-tutorial/01-getting-started.md |   2 +-
 .../02-spec-driven-development-workflow.md    |   2 +-
 ...-agent-steering-and-rules-configuration.md |   2 +-
 .../kiro-tutorial/04-autonomous-agent-mode.md |   2 +-
 .../05-mcp-integration-and-external-tools.md  |   2 +-
 .../kiro-tutorial/06-hooks-and-automation.md  |   2 +-
 .../07-multi-model-strategy-and-providers.md  |   2 +-
 .../08-team-operations-and-governance.md      |   6 +-
 .../kiro-tutorial/{index.md => README.md}     |   0
 .../01-getting-started.md                     |   2 +-
 .../02-custom-resources.md                    |   2 +-
 .../03-reconciliation-loop.md                 |   2 +-
 .../04-owned-resources.md                     |   2 +-
 .../05-status-conditions.md                   |   2 +-
 .../06-testing.md                             |   2 +-
 .../07-observability.md                       |   2 +-
 .../08-production-deployment.md               |   2 +-
 .../{index.md => README.md}                   |   0
 .../lancedb-tutorial/01-getting-started.md    |   2 +-
 .../lancedb-tutorial/02-data-modeling.md      |   2 +-
 .../lancedb-tutorial/03-vector-operations.md  |   2 +-
 .../lancedb-tutorial/04-hybrid-search.md      |   2 +-
 tutorials/lancedb-tutorial/05-integrations.md |   2 +-
 tutorials/lancedb-tutorial/06-performance.md  |   2 +-
 tutorials/lancedb-tutorial/07-production.md   |   2 +-
 .../lancedb-tutorial/08-advanced-patterns.md  |   2 +-
 .../lancedb-tutorial/{index.md => README.md}  |   0
 .../01-getting-started.md                     |   2 +-
 .../02-runnable-interface.md                  |   2 +-
 .../03-chat-model-architecture.md             |   2 +-
 .../04-chain-composition.md                   |   2 +-
 .../05-document-loading-splitting.md          |   2 +-
 .../06-vector-store-abstraction.md            |   2 +-
 .../07-agent-architecture.md                  |   2 +-
 .../08-production-patterns.md                 |   2 +-
 .../{index.md => README.md}                   |   0
 .../langchain-tutorial/01-getting-started.md  |   2 +-
 .../langchain-tutorial/02-prompt-templates.md |   2 +-
 .../langchain-tutorial/03-memory-systems.md   |   2 +-
 .../04-document-processing.md                 |   2 +-
 .../langchain-tutorial/05-vector-stores.md    |   2 +-
 .../langchain-tutorial/06-agents-tools.md     |   2 +-
 .../langchain-tutorial/07-advanced-chains.md  |   2 +-
 .../08-production-deployment.md               |   2 +-
 .../09-evaluation-monitoring.md               |   2 +-
 .../{index.md => README.md}                   |   0
 .../langflow-tutorial/01-getting-started.md   |   2 +-
 .../02-platform-architecture.md               |   2 +-
 .../03-visual-flow-builder.md                 |   2 +-
 .../04-agent-workflows-and-orchestration.md   |   2 +-
 .../05-api-and-mcp-deployment.md              |   2 +-
 .../06-observability-and-security.md          |   2 +-
 .../07-custom-components-and-extensions.md    |   2 +-
 .../08-production-operations.md               |   2 +-
 .../langflow-tutorial/{index.md => README.md} |   0
 .../langfuse-tutorial/01-getting-started.md   |   4 +-
 tutorials/langfuse-tutorial/02-tracing.md     |   2 +-
 tutorials/langfuse-tutorial/03-prompts.md     |   2 +-
 tutorials/langfuse-tutorial/04-evaluation.md  |   2 +-
 tutorials/langfuse-tutorial/05-analytics.md   |   2 +-
 tutorials/langfuse-tutorial/06-datasets.md    |   2 +-
 .../langfuse-tutorial/07-integrations.md      |   2 +-
 tutorials/langfuse-tutorial/08-production.md  |   2 +-
 .../langfuse-tutorial/{index.md => README.md} |   0
 .../langgraph-tutorial/01-getting-started.md  |   2 +-
 .../langgraph-tutorial/02-state-management.md |   2 +-
 .../langgraph-tutorial/03-nodes-edges.md      |   2 +-
 .../04-conditional-logic.md                   |   2 +-
 .../05-multi-agent-systems.md                 |   2 +-
 .../langgraph-tutorial/06-tool-integration.md |   2 +-
 .../07-persistence-checkpoints.md             |   2 +-
 .../08-production-deployment.md               |   2 +-
 .../{index.md => README.md}                   |   0
 .../letta-tutorial/01-getting-started.md      |   2 +-
 tutorials/letta-tutorial/02-memory.md         |   2 +-
 tutorials/letta-tutorial/03-configuration.md  |   2 +-
 tutorials/letta-tutorial/04-tools.md          |   2 +-
 tutorials/letta-tutorial/05-conversations.md  |   2 +-
 tutorials/letta-tutorial/06-multi-agent.md    |   2 +-
 tutorials/letta-tutorial/07-api.md            |   2 +-
 tutorials/letta-tutorial/08-production.md     |   2 +-
 .../letta-tutorial/{index.md => README.md}    |   0
 .../litellm-tutorial/01-getting-started.md    |   2 +-
 tutorials/litellm-tutorial/02-providers.md    |   2 +-
 tutorials/litellm-tutorial/03-completion.md   |   2 +-
 tutorials/litellm-tutorial/04-streaming.md    |   2 +-
 tutorials/litellm-tutorial/05-fallbacks.md    |   2 +-
 .../litellm-tutorial/06-cost-tracking.md      |   2 +-
 tutorials/litellm-tutorial/07-proxy.md        |   2 +-
 tutorials/litellm-tutorial/08-production.md   |   2 +-
 .../litellm-tutorial/{index.md => README.md}  |   0
 .../liveblocks-tutorial/01-getting-started.md |   2 +-
 .../02-presence-awareness.md                  |   2 +-
 .../03-storage-conflict-resolution.md         |   2 +-
 .../04-comments-threads.md                    |   2 +-
 .../liveblocks-tutorial/05-notifications.md   |   2 +-
 .../06-react-integration.md                   |   2 +-
 .../07-advanced-patterns.md                   |   2 +-
 .../08-production-deployment.md               |   2 +-
 .../{index.md => README.md}                   |   0
 .../llama-cpp-tutorial/01-getting-started.md  |   2 +-
 .../llama-cpp-tutorial/02-model-formats.md    |   2 +-
 tutorials/llama-cpp-tutorial/03-cli-usage.md  |   2 +-
 tutorials/llama-cpp-tutorial/04-server.md     |   2 +-
 tutorials/llama-cpp-tutorial/05-gpu.md        |   2 +-
 .../llama-cpp-tutorial/06-quantization.md     |   2 +-
 tutorials/llama-cpp-tutorial/07-advanced.md   |   2 +-
 .../llama-cpp-tutorial/08-integration.md      |   2 +-
 .../{index.md => README.md}                   |   0
 .../01-getting-started.md                     |   2 +-
 .../02-data-preparation.md                    |   2 +-
 .../03-model-configuration.md                 |   2 +-
 .../04-training-pipeline.md                   |   2 +-
 .../05-model-evaluation.md                    |   2 +-
 .../llama-factory-tutorial/06-deployment.md   |   2 +-
 .../07-advanced-techniques.md                 |   2 +-
 .../08-production-case-studies.md             |   2 +-
 .../{index.md => README.md}                   |   0
 .../llamaindex-tutorial/01-getting-started.md |   2 +-
 .../llamaindex-tutorial/02-data-ingestion.md  |   2 +-
 .../03-indexing-storage.md                    |   2 +-
 .../llamaindex-tutorial/04-query-engines.md   |   2 +-
 .../llamaindex-tutorial/05-advanced-rag.md    |   2 +-
 .../06-custom-components.md                   |   2 +-
 .../07-production-deployment.md               |   2 +-
 .../08-monitoring-optimization.md             |   2 +-
 .../{index.md => README.md}                   |   0
 .../01-system-overview.md                     |   2 +-
 .../lobechat-ai-platform/02-chat-interface.md |   2 +-
 .../03-streaming-architecture.md              |   2 +-
 .../lobechat-ai-platform/04-ai-integration.md |   2 +-
 .../05-production-deployment.md               |   2 +-
 .../06-plugin-development.md                  |   2 +-
 .../07-advanced-customization.md              |   2 +-
 .../08-scaling-performance.md                 |   2 +-
 tutorials/lobechat-ai-platform/README.md      | 165 ++--
 tutorials/lobechat-ai-platform/index.md       | 119 ---
 .../localai-tutorial/01-getting-started.md    |   2 +-
 tutorials/localai-tutorial/02-models.md       |   2 +-
 .../localai-tutorial/03-text-generation.md    |   2 +-
 .../localai-tutorial/04-image-generation.md   |   2 +-
 tutorials/localai-tutorial/05-audio.md        |   2 +-
 tutorials/localai-tutorial/06-embeddings.md   |   2 +-
 .../localai-tutorial/07-configuration.md      |   2 +-
 tutorials/localai-tutorial/08-integration.md  |   2 +-
 .../localai-tutorial/{index.md => README.md}  |   0
 .../01-knowledge-management-principles.md     |   2 +-
 .../02-system-architecture.md                 |   2 +-
 .../03-local-first-data.md                    |   2 +-
 .../04-development-setup.md                   |   2 +-
 .../05-block-data-model.md                    |   2 +-
 .../06-block-editor.md                        |   2 +-
 .../07-bidirectional-links.md                 |   2 +-
 .../08-graph-visualization.md                 |   4 +-
 .../logseq-knowledge-management/README.md     | 148 +++-
 .../logseq-knowledge-management/index.md      | 136 ----
 .../mastra-tutorial/01-getting-started.md     |   2 +-
 .../mastra-tutorial/02-system-architecture.md |   2 +-
 .../mastra-tutorial/03-agents-and-tools.md    |   2 +-
 .../04-workflows-and-control-flow.md          |   2 +-
 .../05-memory-rag-and-context.md              |   2 +-
 .../06-mcp-and-integration-patterns.md        |   2 +-
 .../07-evals-observability-and-quality.md     |   2 +-
 .../08-production-deployment-and-scaling.md   |   2 +-
 .../mastra-tutorial/{index.md => README.md}   |   0
 ...getting-started-and-native-bridge-setup.md |   2 +-
 ...2-architecture-and-component-boundaries.md |   2 +-
 ...surface-browser-network-and-interaction.md |   2 +-
 ...4-semantic-search-and-vector-processing.md |   2 +-
 ...ransport-modes-and-client-configuration.md |   2 +-
 .../06-visual-editor-and-prompt-workflows.md  |   2 +-
 ...roubleshooting-permissions-and-security.md |   2 +-
 ...ribution-release-and-runtime-operations.md |   2 +-
 .../{index.md => README.md}                   |   0
 ...1-getting-started-and-package-selection.md |   2 +-
 ...-client-server-hosting-and-stdio-basics.md |   2 +-
 ...core-http-transport-and-session-routing.md |   2 +-
 ...-prompts-resources-and-filter-pipelines.md |   2 +-
 ...-logging-progress-elicitation-and-tasks.md |   2 +-
 ...oauth-protected-mcp-servers-and-clients.md |   2 +-
 ...rsioning-and-breaking-change-management.md |   2 +-
 ...g-operations-and-contribution-workflows.md |   2 +-
 .../{index.md => README.md}                   |   0
 .../01-getting-started-and-archive-context.md |   2 +-
 ...ory-layout-and-canonical-migration-path.md |   2 +-
 ...quickstart-flows-user-server-and-client.md |   2 +-
 ...ts-architecture-tools-resources-prompts.md |   2 +-
 ...-concepts-transports-sampling-and-roots.md |   2 +-
 ...06-tooling-docs-inspector-and-debugging.md |   2 +-
 ...rial-assets-and-client-ecosystem-matrix.md |   2 +-
 ...governance-and-documentation-operations.md |   4 +-
 .../{index.md => README.md}                   |   0
 ...01-getting-started-and-spec-orientation.md |   2 +-
 .../02-mcp-apps-architecture-and-lifecycle.md |   2 +-
 ...3-app-sdk-ui-resources-and-tool-linkage.md |   2 +-
 .../04-host-bridge-and-context-management.md  |   2 +-
 .../05-patterns-security-and-performance.md   |   2 +-
 ...g-local-hosts-and-integration-workflows.md |   2 +-
 ...-agent-skills-and-openai-apps-migration.md |   2 +-
 ...ease-strategy-and-production-operations.md |   4 +-
 .../{index.md => README.md}                   |   0
 .../01-getting-started-and-sdk-package-map.md |   2 +-
 ...server-lifecycle-and-session-management.md |   2 +-
 ...-stdio-streamable-http-and-custom-flows.md |   2 +-
 ...lding-tools-resources-and-prompts-in-go.md |   2 +-
 ...bilities-roots-sampling-and-elicitation.md |   2 +-
 .../06-auth-security-and-runtime-hardening.md |   2 +-
 ...testing-troubleshooting-and-rough-edges.md |   2 +-
 ...ormance-operations-and-upgrade-strategy.md |   2 +-
 .../{index.md => README.md}                   |   0
 .../01-getting-started.md                     |   2 +-
 ...chitecture-transports-and-session-model.md |   2 +-
 ...gging-workflows-tools-resources-prompts.md |   2 +-
 .../04-cli-mode-automation-and-ci-loops.md    |   2 +-
 .../05-security-auth-and-network-hardening.md |   2 +-
 ...nfiguration-timeouts-and-runtime-tuning.md |   2 +-
 ...spector-in-server-development-lifecycle.md |   2 +-
 ...production-ops-testing-and-contribution.md |   2 +-
 .../{index.md => README.md}                   |   0
 ...01-getting-started-and-module-selection.md |   2 +-
 ...hitecture-reactive-model-and-json-layer.md |   2 +-
 ...ient-transports-and-connection-strategy.md |   2 +-
 ...rver-transports-and-deployment-patterns.md |   2 +-
 ...resources-prompts-and-schema-validation.md |   2 +-
 ...rity-authorization-and-runtime-controls.md |   2 +-
 ...nformance-testing-and-quality-workflows.md |   2 +-
 ...spring-integration-and-upgrade-strategy.md |   2 +-
 .../{index.md => README.md}                   |   0
 ...01-getting-started-and-module-selection.md |   2 +-
 ...-protocol-model-and-module-architecture.md |   2 +-
 ...ient-runtime-and-capability-negotiation.md |   2 +-
 ...ime-primitives-and-feature-registration.md |   2 +-
 ...stdio-streamable-http-sse-and-websocket.md |   2 +-
 ...features-roots-sampling-and-elicitation.md |   2 +-
 ...conformance-and-operational-diagnostics.md |   2 +-
 ...release-strategy-and-production-rollout.md |   4 +-
 .../{index.md => README.md}                   |   0
 ...tting-started-and-experimental-baseline.md |   2 +-
 ...ver-builder-and-capability-registration.md |   2 +-
 ...nts-tools-resources-prompts-and-schemas.md |   2 +-
 ...scovery-manual-registration-and-caching.md |   2 +-
 ...05-transports-stdio-and-streamable-http.md |   2 +-
 ...unication-sampling-logging-and-progress.md |   2 +-
 ...gration-session-stores-and-dependencies.md |   2 +-
 ...lease-strategy-and-production-readiness.md |   4 +-
 .../{index.md => README.md}                   |   0
 .../01-getting-started.md                     |   2 +-
 .../02-core-concepts.md                       |   2 +-
 .../03-server-architecture.md                 |   2 +-
 .../04-advanced-patterns.md                   |   2 +-
 .../05-authentication-security.md             |   2 +-
 .../06-production-deployment.md               |   2 +-
 .../07-client-integration.md                  |   2 +-
 .../08-real-world-examples.md                 |   4 +-
 .../{index.md => README.md}                   |   0
 ...getting-started-and-repository-topology.md |   2 +-
 ...eather-server-patterns-across-languages.md |   2 +-
 ...-mcp-client-patterns-and-llm-chat-loops.md |   2 +-
 ...tocol-flow-and-stdio-transport-behavior.md |   2 +-
 .../05-smoke-tests-and-mock-infrastructure.md |   2 +-
 ...uage-consistency-and-extension-strategy.md |   2 +-
 ...-ci-toolchain-setup-and-troubleshooting.md |   2 +-
 ...m-tutorial-assets-to-production-systems.md |   4 +-
 .../{index.md => README.md}                   |   0
 .../01-getting-started-and-first-publish.md   |   2 +-
 .../02-registry-architecture-and-data-flow.md |   2 +-
 ...er-json-schema-and-package-verification.md |   2 +-
 ...tication-models-and-namespace-ownership.md |   2 +-
 ...ption-subregistries-and-sync-strategies.md |   2 +-
 ...ing-governance-and-moderation-lifecycle.md |   2 +-
 ...operations-deployment-and-observability.md |   2 +-
 ...ion-rollout-automation-and-contribution.md |   2 +-
 .../{index.md => README.md}                   |   0
 .../01-getting-started-and-gem-baseline.md    |   2 +-
 ...architecture-and-capability-negotiation.md |   2 +-
 ...prompts-resources-and-schema-discipline.md |   2 +-
 ...notifications-logging-and-observability.md |   2 +-
 ...stdio-streamable-http-and-session-modes.md |   2 +-
 ...ttp-integration-and-auth-considerations.md |   2 +-
 ...-quality-security-and-release-workflows.md |   2 +-
 ...duction-deployment-and-upgrade-strategy.md |   4 +-
 .../{index.md => README.md}                   |   0
 .../01-getting-started-and-crate-setup.md     |   2 +-
 ...2-service-model-and-macro-based-tooling.md |   2 +-
 ...dio-streamable-http-and-custom-channels.md |   2 +-
 ...nt-patterns-sampling-and-batching-flows.md |   2 +-
 ...terns-tools-resources-prompts-and-tasks.md |   2 +-
 .../06-oauth-security-and-auth-workflows.md   |   2 +-
 ...rmance-changelog-and-release-discipline.md |   2 +-
 ...m-integration-and-production-operations.md |   2 +-
 .../{index.md => README.md}                   |   0
 .../01-getting-started.md                     |   2 +-
 .../02-filesystem-server.md                   |   2 +-
 .../mcp-servers-tutorial/03-git-server.md     |   2 +-
 .../mcp-servers-tutorial/04-memory-server.md  |   2 +-
 .../05-multi-language-servers.md              |   2 +-
 .../06-custom-server-development.md           |   2 +-
 .../07-security-considerations.md             |   2 +-
 .../08-production-adaptation.md               |   2 +-
 .../{index.md => README.md}                   |   0
 ...-getting-started-and-version-navigation.md |   2 +-
 ...architecture-and-capability-negotiation.md |   2 +-
 ...-protocol-messages-and-schema-contracts.md |   2 +-
 ...odel-stdio-streamable-http-and-sessions.md |   2 +-
 ...-primitives-tools-resources-and-prompts.md |   2 +-
 ...es-roots-sampling-elicitation-and-tasks.md |   2 +-
 ...thorization-and-security-best-practices.md |   2 +-
 ...vernance-seps-and-contribution-workflow.md |   2 +-
 .../{index.md => README.md}                   |   0
 ...01-getting-started-and-package-baseline.md |   2 +-
 ...nt-transport-and-capability-negotiation.md |   2 +-
 ...-resources-prompts-and-request-patterns.md |   2 +-
 ...ng-human-in-the-loop-and-error-handling.md |   2 +-
 ...ver-setup-hooks-and-primitive-authoring.md |   2 +-
 ...rts-custom-implementations-and-shutdown.md |   2 +-
 ...ict-mode-batching-logging-and-debugging.md |   2 +-
 ...se-versioning-and-production-guidelines.md |   2 +-
 .../{index.md => README.md}                   |   0
 .../01-getting-started-and-package-model.md   |   2 +-
 ...rver-transports-and-deployment-patterns.md |   2 +-
 ...ports-oauth-and-backwards-compatibility.md |   2 +-
 ...-resource-prompt-design-and-completions.md |   2 +-
 ...ling-elicitation-and-experimental-tasks.md |   2 +-
 ...middleware-security-and-host-validation.md |   2 +-
 .../07-v1-to-v2-migration-strategy.md         |   2 +-
 ...ance-testing-and-contribution-workflows.md |   2 +-
 .../{index.md => README.md}                   |   0
 .../01-getting-started-and-stack-selection.md |   2 +-
 ...guration-sessions-and-transport-choices.md |   2 +-
 ...onfiguration-tool-governance-and-memory.md |   2 +-
 ...escript-server-framework-and-ui-widgets.md |   2 +-
 ...on-server-framework-and-debug-endpoints.md |   2 +-
 ...pector-debugging-and-chat-app-workflows.md |   2 +-
 ...ntime-controls-and-production-hardening.md |   2 +-
 ...ns-observability-and-contribution-model.md |   2 +-
 .../mcp-use-tutorial/{index.md => README.md}  |   0
 ...getting-started-and-bundle-fundamentals.md |   2 +-
 ...nifest-model-metadata-and-compatibility.md |   2 +-
 ...ver-configuration-and-runtime-packaging.md |   2 +-
 ...ls-prompts-user-config-and-localization.md |   2 +-
 ...05-cli-workflows-init-validate-and-pack.md |   2 +-
 ...signing-verification-and-trust-controls.md |   2 +-
 ...age-patterns-and-distribution-readiness.md |   2 +-
 ...ase-governance-and-ecosystem-operations.md |   4 +-
 .../mcpb-tutorial/{index.md => README.md}     |   0
 .../01-getting-started.md                     |   2 +-
 .../02-document-management.md                 |   2 +-
 .../03-search-fundamentals.md                 |   2 +-
 .../04-typo-tolerance-relevance.md            |   2 +-
 .../05-filtering-facets.md                    |   2 +-
 .../06-multi-language-support.md              |   2 +-
 .../07-api-integration.md                     |   2 +-
 .../08-production-deployment.md               |   2 +-
 .../{index.md => README.md}                   |   0
 tutorials/mem0-tutorial/01-getting-started.md |   2 +-
 .../mem0-tutorial/02-memory-architecture.md   |   2 +-
 .../mem0-tutorial/03-memory-operations.md     |   2 +-
 .../mem0-tutorial/04-advanced-features.md     |   2 +-
 tutorials/mem0-tutorial/05-llm-integration.md |   2 +-
 .../mem0-tutorial/06-memory-applications.md   |   2 +-
 .../07-performance-optimization.md            |   2 +-
 .../mem0-tutorial/08-production-deployment.md |   2 +-
 .../mem0-tutorial/{index.md => README.md}     |   0
 .../01-getting-started.md                     |   2 +-
 ...02-core-architecture-and-minimal-design.md |   2 +-
 .../03-cli-batch-and-inspector-workflows.md   |   2 +-
 ...-global-and-yaml-configuration-strategy.md |   2 +-
 ...-environments-sandboxing-and-deployment.md |   2 +-
 ...06-benchmarking-and-swe-bench-practices.md |   2 +-
 ...cookbook-extensions-and-python-bindings.md |   2 +-
 ...08-contribution-workflow-and-governance.md |   2 +-
 .../{index.md => README.md}                   |   0
 .../01-getting-started.md                     |   2 +-
 .../02-agent-profiles-and-trust-model.md      |   2 +-
 .../03-tooling-and-approval-workflow.md       |   2 +-
 .../04-skills-and-slash-command-extensions.md |   2 +-
 .../05-subagents-and-task-delegation.md       |   2 +-
 ...-programmatic-and-non-interactive-modes.md |   2 +-
 .../07-acp-and-editor-integrations.md         |   2 +-
 ...08-production-operations-and-governance.md |   2 +-
 .../{index.md => README.md}                   |   0
 .../n8n-ai-tutorial/01-getting-started.md     |   2 +-
 tutorials/n8n-ai-tutorial/02-ai-nodes.md      |   2 +-
 tutorials/n8n-ai-tutorial/03-document-ai.md   |   2 +-
 tutorials/n8n-ai-tutorial/04-ai-agents.md     |   2 +-
 tutorials/n8n-ai-tutorial/05-rag.md           |   2 +-
 tutorials/n8n-ai-tutorial/06-decisions.md     |   2 +-
 tutorials/n8n-ai-tutorial/07-custom-tools.md  |   2 +-
 tutorials/n8n-ai-tutorial/08-production.md    |   2 +-
 .../n8n-ai-tutorial/{index.md => README.md}   |   0
 tutorials/n8n-mcp-tutorial/README.md          | 356 +++-----
 tutorials/n8n-mcp-tutorial/index.md           | 113 ---
 .../nanocoder-tutorial/01-getting-started.md  |   2 +-
 .../02-architecture-agent-loop.md             |   2 +-
 .../03-tool-system-internals.md               |   2 +-
 .../04-multi-provider-integration.md          |   2 +-
 .../05-context-management.md                  |   2 +-
 .../06-configuration-customization.md         |   2 +-
 .../07-building-your-own-agent.md             |   2 +-
 .../08-production-patterns-security.md        |   2 +-
 .../{index.md => README.md}                   |   0
 .../01-system-overview.md                     |   2 +-
 .../02-database-abstraction.md                |   2 +-
 .../03-schema-management.md                   |   2 +-
 .../04-api-generation.md                      |   2 +-
 .../05-query-builder.md                       |   2 +-
 .../06-auth-system.md                         |   2 +-
 .../07-vue-components.md                      |   2 +-
 .../08-realtime-features.md                   |   4 +-
 tutorials/nocodb-database-platform/README.md  | 150 +++-
 tutorials/nocodb-database-platform/index.md   | 136 ----
 .../01-plugin-architecture.md                 |   2 +-
 .../02-text-editing.md                        |   2 +-
 .../03-tree-structures.md                     |   2 +-
 .../04-advanced-features.md                   |   2 +-
 .../05-keyboard-shortcuts.md                  |   2 +-
 .../06-testing-debugging.md                   |   2 +-
 .../07-plugin-packaging.md                    |   2 +-
 .../08-production-maintenance.md              |   4 +-
 tutorials/obsidian-outliner-plugin/README.md  | 140 +++-
 tutorials/obsidian-outliner-plugin/index.md   | 128 ---
 .../ollama-tutorial/01-getting-started.md     |   2 +-
 tutorials/ollama-tutorial/02-models.md        |   2 +-
 .../ollama-tutorial/03-chat-completions.md    |   2 +-
 .../ollama-tutorial/04-embeddings-rag.md      |   2 +-
 .../ollama-tutorial/05-modelfiles-custom.md   |   4 +-
 tutorials/ollama-tutorial/06-performance.md   |   4 +-
 tutorials/ollama-tutorial/07-integrations.md  |   4 +-
 tutorials/ollama-tutorial/08-production.md    |   4 +-
 .../ollama-tutorial/{index.md => README.md}   |   0
 .../onlook-tutorial/01-getting-started.md     |   2 +-
 ...02-product-and-architecture-foundations.md |   2 +-
 .../03-visual-editing-and-code-mapping.md     |   2 +-
 .../04-ai-chat-branching-and-iteration.md     |   2 +-
 .../05-local-development-and-runtime-setup.md |   2 +-
 .../06-deployment-and-team-collaboration.md   |   2 +-
 .../07-contributing-and-quality-workflow.md   |   2 +-
 ...08-production-operations-and-governance.md |   2 +-
 .../onlook-tutorial/{index.md => README.md}   |   0
 .../opcode-tutorial/01-getting-started.md     |   2 +-
 .../02-architecture-and-platform-stack.md     |   2 +-
 .../03-projects-and-session-management.md     |   2 +-
 .../04-custom-agents-and-background-runs.md   |   2 +-
 .../05-mcp-and-context-management.md          |   2 +-
 .../06-timeline-checkpoints-and-recovery.md   |   2 +-
 ...elopment-workflow-and-build-from-source.md |   2 +-
 .../08-production-operations-and-security.md  |   2 +-
 .../opcode-tutorial/{index.md => README.md}   |   0
 .../01-getting-started-and-project-status.md  |   2 +-
 ...langgraph-architecture-and-agent-graphs.md |   2 +-
 ...elopment-environment-and-monorepo-setup.md |   2 +-
 ...-usage-patterns-ui-and-github-workflows.md |   2 +-
 ...-planning-control-and-human-in-the-loop.md |   2 +-
 ...curity-auth-and-operational-constraints.md |   2 +-
 ...fork-maintenance-and-migration-strategy.md |   2 +-
 ...tribution-legacy-support-and-next-steps.md |   2 +-
 .../open-swe-tutorial/{index.md => README.md} |   0
 .../open-webui-tutorial/01-getting-started.md |   2 +-
 .../02-model-management.md                    |   2 +-
 .../03-interface-customization.md             |   2 +-
 .../04-advanced-chat-features.md              |   2 +-
 .../open-webui-tutorial/05-data-knowledge.md  |   2 +-
 .../open-webui-tutorial/06-user-management.md |   2 +-
 .../open-webui-tutorial/07-integrations.md    |   2 +-
 .../08-production-deployment.md               |   2 +-
 .../{index.md => README.md}                   |   0
 .../01-getting-started.md                     |   2 +-
 .../02-chat-completions.md                    |   2 +-
 .../03-embeddings-search.md                   |   2 +-
 .../04-assistants-api.md                      |   2 +-
 .../05-batch-processing.md                    |   2 +-
 .../06-fine-tuning.md                         |   2 +-
 .../07-advanced-patterns.md                   |   2 +-
 .../08-integration-examples.md                |   2 +-
 .../{index.md => README.md}                   |   0
 .../01-getting-started.md                     |   2 +-
 .../02-realtime-api-fundamentals.md           |   2 +-
 .../03-voice-input-processing.md              |   2 +-
 .../04-conversational-ai.md                   |   2 +-
 .../05-function-calling.md                    |   2 +-
 .../06-voice-output.md                        |   2 +-
 .../07-advanced-patterns.md                   |   2 +-
 .../08-production-deployment.md               |   2 +-
 .../{index.md => README.md}                   |   0
 .../01-getting-started.md                     |   2 +-
 .../02-model-architecture.md                  |   2 +-
 .../03-audio-preprocessing.md                 |   2 +-
 .../04-transcription-translation.md           |   2 +-
 .../openai-whisper-tutorial/05-fine-tuning.md |   2 +-
 .../06-advanced-features.md                   |   2 +-
 .../07-performance-optimization.md            |   2 +-
 .../08-production-deployment.md               |   2 +-
 .../{index.md => README.md}                   |   0
 .../openbb-tutorial/01-getting-started.md     |   2 +-
 tutorials/openbb-tutorial/02-data-access.md   |   2 +-
 .../openbb-tutorial/03-technical-analysis.md  |   2 +-
 .../04-quantitative-analysis.md               |   2 +-
 .../05-portfolio-management.md                |   2 +-
 .../openbb-tutorial/06-research-automation.md |   2 +-
 .../openbb-tutorial/07-custom-extensions.md   |   2 +-
 .../08-enterprise-deployment.md               |   2 +-
 .../openbb-tutorial/{index.md => README.md}   |   0
 .../openclaw-tutorial/01-getting-started.md   |   2 +-
 .../02-gateway-architecture.md                |   2 +-
 .../openclaw-tutorial/03-channel-drivers.md   |   2 +-
 .../openclaw-tutorial/04-agent-runtime.md     |   2 +-
 .../openclaw-tutorial/05-memory-sessions.md   |   2 +-
 .../openclaw-tutorial/06-skills-tools.md      |   2 +-
 .../07-security-networking.md                 |   2 +-
 .../08-production-deployment.md               |   2 +-
 .../openclaw-tutorial/{index.md => README.md} |   0
 .../01-getting-started-and-project-status.md  |   2 +-
 ...2-legacy-architecture-and-feature-model.md |   2 +-
 ...installation-and-configuration-baseline.md |   2 +-
 ...-model-providers-and-runtime-operations.md |   2 +-
 ...teractive-and-non-interactive-workflows.md |   2 +-
 ...ssion-tooling-and-integration-practices.md |   2 +-
 ...ration-to-crush-and-modern-alternatives.md |   2 +-
 ...legacy-governance-and-controlled-sunset.md |   2 +-
 .../{index.md => README.md}                   |   0
 .../opencode-tutorial/01-getting-started.md   |   2 +-
 .../02-architecture-agent-loop.md             |   2 +-
 .../03-model-and-provider-routing.md          |   2 +-
 .../04-tools-permissions-and-execution.md     |   2 +-
 .../05-agents-subagents-and-planning.md       |   2 +-
 .../06-client-server-and-remote-workflows.md  |   2 +-
 .../07-integrations-mcp-lsp-and-extensions.md |   2 +-
 .../08-production-operations-security.md      |   2 +-
 .../opencode-tutorial/{index.md => README.md} |   0
 .../openhands-tutorial/01-getting-started.md  |   2 +-
 .../openhands-tutorial/02-basic-operations.md |   2 +-
 .../openhands-tutorial/03-code-generation.md  |   2 +-
 tutorials/openhands-tutorial/04-bug-fixing.md |   2 +-
 tutorials/openhands-tutorial/05-testing.md    |   2 +-
 .../openhands-tutorial/06-refactoring.md      |   2 +-
 .../openhands-tutorial/07-integration.md      |   2 +-
 .../08-advanced-projects.md                   |   2 +-
 .../{index.md => README.md}                   |   0
 .../openskills-tutorial/01-getting-started.md |   2 +-
 ...02-skill-format-and-loader-architecture.md |   2 +-
 ...03-installation-sources-and-trust-model.md |   2 +-
 .../04-sync-and-agents-md-integration.md      |   2 +-
 ...5-universal-mode-and-multi-agent-setups.md |   2 +-
 .../06-skill-authoring-and-packaging.md       |   2 +-
 .../07-updates-versioning-and-governance.md   |   2 +-
 .../08-production-security-and-operations.md  |   2 +-
 .../{index.md => README.md}                   |   0
 .../01-getting-started-and-opsx-basics.md     |   2 +-
 .../02-artifact-graph-and-change-lifecycle.md |   2 +-
 .../03-command-surface-and-agent-workflows.md |   2 +-
 ...ec-authoring-delta-patterns-and-quality.md |   2 +-
 ...customization-schemas-and-project-rules.md |   2 +-
 ...ntegrations-and-multi-agent-portability.md |   2 +-
 ...validation-automation-and-ci-operations.md |   2 +-
 ...-migration-governance-and-team-adoption.md |   2 +-
 .../openspec-tutorial/{index.md => README.md} |   0
 .../opensrc-tutorial/01-getting-started.md    |   2 +-
 ...2-input-parsing-and-resolution-pipeline.md |   2 +-
 .../03-multi-registry-package-fetching.md     |   2 +-
 .../04-git-repository-source-imports.md       |   2 +-
 ...-agents-md-and-sources-json-integration.md |   2 +-
 .../06-update-remove-and-clean-lifecycle.md   |   2 +-
 ...ility-rate-limits-and-version-fallbacks.md |   2 +-
 .../08-team-operations-and-governance.md      |   2 +-
 .../opensrc-tutorial/{index.md => README.md}  |   0
 .../outlines-tutorial/01-getting-started.md   |   2 +-
 .../outlines-tutorial/02-text-patterns.md     |   2 +-
 tutorials/outlines-tutorial/03-json-schema.md |   2 +-
 tutorials/outlines-tutorial/04-type-safety.md |   2 +-
 .../outlines-tutorial/05-grammar-based.md     |   2 +-
 .../outlines-tutorial/06-advanced-features.md |   2 +-
 tutorials/outlines-tutorial/07-integration.md |   2 +-
 tutorials/outlines-tutorial/08-production.md  |   2 +-
 .../outlines-tutorial/{index.md => README.md} |   0
 .../perplexica-tutorial/01-getting-started.md |   2 +-
 .../02-search-architecture.md                 |   2 +-
 .../perplexica-tutorial/03-ai-integration.md  |   2 +-
 .../perplexica-tutorial/04-web-scraping.md    |   2 +-
 .../05-result-processing.md                   |   2 +-
 .../perplexica-tutorial/06-user-interface.md  |   2 +-
 .../07-advanced-features.md                   |   2 +-
 .../08-production-deployment.md               |   4 +-
 .../{index.md => README.md}                   |   0
 .../phidata-tutorial/01-getting-started.md    |   2 +-
 .../phidata-tutorial/02-agent-architecture.md |   2 +-
 .../phidata-tutorial/03-tools-functions.md    |   2 +-
 .../phidata-tutorial/04-memory-systems.md     |   2 +-
 .../05-multi-agent-systems.md                 |   2 +-
 .../phidata-tutorial/06-advanced-reasoning.md |   2 +-
 tutorials/phidata-tutorial/07-integrations.md |   2 +-
 .../08-production-deployment.md               |   2 +-
 .../phidata-tutorial/{index.md => README.md}  |   0
 .../photoprism-tutorial/01-getting-started.md |   2 +-
 .../02-ai-features-configuration.md           |   2 +-
 .../03-photo-management.md                    |   2 +-
 .../04-search-discovery.md                    |   2 +-
 .../05-facial-recognition.md                  |   2 +-
 .../photoprism-tutorial/06-api-integration.md |   2 +-
 .../07-backup-migration.md                    |   2 +-
 .../08-production-deployment.md               |   2 +-
 .../{index.md => README.md}                   |   0
 .../plandex-tutorial/01-getting-started.md    |   2 +-
 .../02-architecture-and-workflow.md           |   2 +-
 .../03-context-management-at-scale.md         |   2 +-
 .../04-planning-execution-and-diff-sandbox.md |   2 +-
 .../05-model-packs-and-provider-strategy.md   |   2 +-
 .../06-autonomy-control-and-debugging.md      |   2 +-
 .../07-git-branching-and-review-workflows.md  |   2 +-
 ...-self-hosting-and-production-operations.md |   2 +-
 .../plandex-tutorial/{index.md => README.md}  |   0
 .../01-getting-started.md                     |   2 +-
 ...-core-philosophy-and-the-3-file-pattern.md |   2 +-
 ...stallation-paths-across-ides-and-agents.md |   2 +-
 ...mmands-hooks-and-workflow-orchestration.md |   2 +-
 ...-templates-scripts-and-session-recovery.md |   2 +-
 ...adaptation-codex-gemini-opencode-cursor.md |   2 +-
 ...hooting-anti-patterns-and-safety-checks.md |   2 +-
 ...contribution-workflow-and-team-adoption.md |   2 +-
 .../{index.md => README.md}                   |   0
 .../01-getting-started.md                     |   2 +-
 ...operating-model-accessibility-snapshots.md |   2 +-
 .../03-installation-across-host-clients.md    |   2 +-
 ...guration-capabilities-and-runtime-modes.md |   2 +-
 ...ofile-state-extension-and-auth-sessions.md |   2 +-
 .../06-standalone-and-docker-deployment.md    |   2 +-
 ...tooling-surface-and-automation-patterns.md |   2 +-
 ...oubleshooting-security-and-contribution.md |   2 +-
 .../{index.md => README.md}                   |   0
 .../pocketflow-tutorial/01-getting-started.md |   2 +-
 .../02-core-graph-abstraction.md              |   2 +-
 .../03-agent-and-workflow-patterns.md         |   2 +-
 .../04-rag-and-knowledge-patterns.md          |   2 +-
 .../05-multi-agent-and-supervision.md         |   2 +-
 .../06-streaming-hitl-and-interrupts.md       |   2 +-
 .../07-multi-language-ecosystem.md            |   2 +-
 .../08-production-usage-and-scaling.md        |   2 +-
 .../{index.md => README.md}                   |   0
 .../01-fundamentals.md                        |   2 +-
 .../postgresql-query-planner/02-statistics.md |   2 +-
 .../03-scan-operations.md                     |   2 +-
 .../04-join-strategies.md                     |   2 +-
 .../05-index-strategies.md                    |   2 +-
 .../06-advanced-optimization.md               |   2 +-
 .../07-performance-tuning.md                  |   2 +-
 .../08-real-world-patterns.md                 |   2 +-
 .../{index.md => README.md}                   |   0
 .../posthog-tutorial/01-getting-started.md    |   2 +-
 .../posthog-tutorial/02-event-tracking.md     |   2 +-
 .../posthog-tutorial/03-user-analytics.md     |   2 +-
 .../posthog-tutorial/04-session-recordings.md |   2 +-
 .../posthog-tutorial/05-feature-flags.md      |   2 +-
 .../06-dashboards-insights.md                 |   2 +-
 .../posthog-tutorial/07-advanced-analytics.md |   2 +-
 .../08-production-deployment.md               |   2 +-
 .../posthog-tutorial/{index.md => README.md}  |   0
 .../01-getting-started.md                     |   2 +-
 .../02-model-configuration.md                 |   2 +-
 .../03-structured-outputs.md                  |   2 +-
 .../04-dependencies-tools.md                  |   2 +-
 .../05-streaming-async.md                     |   2 +-
 .../pydantic-ai-tutorial/06-error-handling.md |   2 +-
 .../07-advanced-patterns.md                   |   2 +-
 .../pydantic-ai-tutorial/08-production.md     |   2 +-
 .../{index.md => README.md}                   |   0
 .../quivr-tutorial/01-getting-started.md      |   2 +-
 .../quivr-tutorial/02-document-processing.md  |   2 +-
 .../quivr-tutorial/03-vector-embeddings.md    |   2 +-
 .../quivr-tutorial/04-query-processing.md     |   2 +-
 .../quivr-tutorial/05-knowledge-bases.md      |   2 +-
 .../quivr-tutorial/06-integration-apis.md     |   2 +-
 tutorials/quivr-tutorial/07-customization.md  |   2 +-
 .../08-production-deployment.md               |   2 +-
 .../quivr-tutorial/{index.md => README.md}    |   0
 .../qwen-agent-tutorial/01-getting-started.md |   2 +-
 ...framework-architecture-and-core-modules.md |   2 +-
 .../03-model-service-and-runtime-strategy.md  |   2 +-
 .../04-tool-calling-and-mcp-integration.md    |   2 +-
 ...5-memory-rag-and-long-context-workflows.md |   2 +-
 ...lication-patterns-and-safety-boundaries.md |   2 +-
 ...enchmarking-and-deepplanning-evaluation.md |   2 +-
 ...tion-workflow-and-production-governance.md |   2 +-
 .../{index.md => README.md}                   |   0
 .../ragflow-tutorial/01-getting-started.md    |   2 +-
 .../02-document-processing.md                 |   2 +-
 .../03-knowledge-base-setup.md                |   2 +-
 .../ragflow-tutorial/04-retrieval-system.md   |   2 +-
 .../ragflow-tutorial/05-llm-integration.md    |   2 +-
 .../06-chatbot-development.md                 |   2 +-
 .../ragflow-tutorial/07-advanced-features.md  |   2 +-
 .../08-production-deployment.md               |   2 +-
 .../ragflow-tutorial/{index.md => README.md}  |   0
 .../react-fiber-internals/01-introduction.md  |   2 +-
 .../02-fiber-structure.md                     |   2 +-
 .../react-fiber-internals/03-render-phase.md  |   2 +-
 .../react-fiber-internals/04-commit-phase.md  |   2 +-
 .../react-fiber-internals/05-scheduling.md    |   2 +-
 tutorials/react-fiber-internals/06-hooks.md   |   2 +-
 .../react-fiber-internals/07-concurrent.md    |   2 +-
 .../react-fiber-internals/08-debugging.md     |   2 +-
 .../{index.md => README.md}                   |   0
 .../refly-tutorial/01-getting-started.md      |   2 +-
 .../02-architecture-and-component-topology.md |   2 +-
 ...-construction-and-deterministic-runtime.md |   2 +-
 .../04-api-and-webhook-integrations.md        |   2 +-
 ...-refly-cli-and-claude-code-skill-export.md |   2 +-
 ...observability-deployment-and-operations.md |   2 +-
 ...roubleshooting-safety-and-cost-controls.md |   2 +-
 ...08-contribution-workflow-and-governance.md |   2 +-
 .../refly-tutorial/{index.md => README.md}    |   0
 .../roo-code-tutorial/01-getting-started.md   |   2 +-
 .../02-modes-and-task-design.md               |   2 +-
 .../03-file-and-command-operations.md         |   2 +-
 .../04-context-and-indexing.md                |   2 +-
 .../05-checkpoints-and-recovery.md            |   2 +-
 .../06-mcp-and-tool-extensions.md             |   2 +-
 .../07-profiles-and-team-standards.md         |   2 +-
 .../08-enterprise-operations.md               |   2 +-
 .../roo-code-tutorial/{index.md => README.md} |   0
 .../01-getting-started.md                     |   2 +-
 .../semantic-kernel-tutorial/02-plugins.md    |   2 +-
 .../semantic-kernel-tutorial/03-prompts.md    |   2 +-
 .../semantic-kernel-tutorial/04-services.md   |   2 +-
 .../semantic-kernel-tutorial/05-memory.md     |   2 +-
 .../semantic-kernel-tutorial/06-planners.md   |   2 +-
 .../semantic-kernel-tutorial/07-agents.md     |   2 +-
 .../semantic-kernel-tutorial/08-production.md |   2 +-
 .../{index.md => README.md}                   |   0
 .../serena-tutorial/01-getting-started.md     |   2 +-
 .../02-semantic-toolkit-and-agent-loop.md     |   2 +-
 .../03-mcp-client-integrations.md             |   2 +-
 ...language-backends-and-analysis-strategy.md |   2 +-
 ...-project-workflow-and-context-practices.md |   2 +-
 ...-configuration-and-operational-controls.md |   2 +-
 ...ing-serena-and-custom-agent-integration.md |   2 +-
 ...08-production-operations-and-governance.md |   2 +-
 .../serena-tutorial/{index.md => README.md}   |   0
 .../shotgun-tutorial/01-getting-started.md    |   2 +-
 ...router-architecture-and-agent-lifecycle.md |   2 +-
 ...03-planning-vs-drafting-execution-modes.md |   2 +-
 ...codebase-indexing-and-context-retrieval.md |   2 +-
 .../05-cli-automation-and-scripting.md        |   2 +-
 .../06-context7-mcp-and-local-models.md       |   2 +-
 ...pec-sharing-and-collaboration-workflows.md |   2 +-
 ...n-operations-observability-and-security.md |   2 +-
 .../shotgun-tutorial/{index.md => README.md}  |   0
 .../01-getting-started.md                     |   2 +-
 .../02-character-creation.md                  |   2 +-
 .../03-chat-management.md                     |   2 +-
 .../04-prompt-engineering.md                  |   2 +-
 .../05-extensions-ecosystem.md                |   2 +-
 .../06-multi-model-setup.md                   |   2 +-
 .../07-advanced-features.md                   |   2 +-
 .../08-custom-development.md                  |   2 +-
 .../{index.md => README.md}                   |   0
 .../siyuan-tutorial/01-getting-started.md     |   2 +-
 .../siyuan-tutorial/02-block-architecture.md  |   2 +-
 tutorials/siyuan-tutorial/03-data-storage.md  |   2 +-
 tutorials/siyuan-tutorial/04-query-system.md  |   2 +-
 .../siyuan-tutorial/05-plugin-architecture.md |   2 +-
 .../siyuan-tutorial/06-synchronization.md     |   2 +-
 .../siyuan-tutorial/07-advanced-features.md   |   2 +-
 .../08-production-deployment.md               |   2 +-
 .../siyuan-tutorial/{index.md => README.md}   |   0
 .../smolagents-tutorial/01-getting-started.md |   2 +-
 .../02-understanding-agents.md                |   2 +-
 tutorials/smolagents-tutorial/03-tools.md     |   2 +-
 .../smolagents-tutorial/04-code-execution.md  |   2 +-
 .../smolagents-tutorial/05-multi-step.md      |   2 +-
 tutorials/smolagents-tutorial/06-memory.md    |   2 +-
 tutorials/smolagents-tutorial/07-advanced.md  |   2 +-
 .../smolagents-tutorial/08-production.md      |   2 +-
 .../{index.md => README.md}                   |   0
 .../01-getting-started-and-cli-bootstrap.md   |   2 +-
 .../02-proxy-and-toolbar-architecture.md      |   2 +-
 ...ridge-mode-and-multi-agent-integrations.md |   2 +-
 .../04-configuration-and-plugin-loading.md    |   2 +-
 .../05-building-plugins-with-plugin-sdk.md    |   2 +-
 ...agent-integrations-with-agent-interface.md |   2 +-
 ...troubleshooting-security-and-operations.md |   2 +-
 ...bution-workflow-and-ecosystem-evolution.md |   2 +-
 .../{index.md => README.md}                   |   0
 .../01-getting-started.md                     |   2 +-
 ...gent-loop-and-model-driven-architecture.md |   2 +-
 .../03-tools-and-mcp-integration.md           |   2 +-
 ...04-model-providers-and-runtime-strategy.md |   2 +-
 ...05-hooks-state-and-reliability-controls.md |   2 +-
 .../06-multi-agent-and-advanced-patterns.md   |   2 +-
 ...07-deployment-and-production-operations.md |   2 +-
 ...ution-workflow-and-ecosystem-extensions.md |   2 +-
 .../{index.md => README.md}                   |   0
 .../supabase-tutorial/01-getting-started.md   |   2 +-
 .../supabase-tutorial/02-database-design.md   |   2 +-
 .../supabase-tutorial/03-authentication.md    |   2 +-
 .../supabase-tutorial/04-realtime-features.md |   2 +-
 .../05-storage-management.md                  |   2 +-
 .../supabase-tutorial/06-edge-functions.md    |   2 +-
 .../supabase-tutorial/07-advanced-queries.md  |   2 +-
 .../08-production-deployment.md               |   2 +-
 .../supabase-tutorial/{index.md => README.md} |   0
 .../superagi-tutorial/01-getting-started.md   |   2 +-
 .../02-agent-architecture.md                  |   2 +-
 .../superagi-tutorial/03-tool-integration.md  |   2 +-
 .../superagi-tutorial/04-memory-learning.md   |   2 +-
 .../superagi-tutorial/05-task-planning.md     |   2 +-
 .../06-multi-agent-systems.md                 |   2 +-
 .../07-deployment-scaling.md                  |   2 +-
 .../superagi-tutorial/08-advanced-features.md |   2 +-
 .../superagi-tutorial/{index.md => README.md} |   0
 .../01-getting-started.md                     |   2 +-
 ...-worktree-isolation-and-workspace-model.md |   2 +-
 .../03-workspace-orchestration-lifecycle.md   |   2 +-
 .../04-multi-agent-program-compatibility.md   |   2 +-
 .../05-monitoring-diff-and-review-workflow.md |   2 +-
 ...6-setup-teardown-presets-and-automation.md |   2 +-
 .../07-runtime-and-package-architecture.md    |   2 +-
 .../08-production-team-operations.md          |   2 +-
 .../{index.md => README.md}                   |   0
 .../swarm-tutorial/01-getting-started.md      |   2 +-
 tutorials/swarm-tutorial/02-agent-design.md   |   2 +-
 .../swarm-tutorial/03-function-calling.md     |   2 +-
 tutorials/swarm-tutorial/04-routines.md       |   2 +-
 tutorials/swarm-tutorial/05-handoffs.md       |   2 +-
 .../swarm-tutorial/06-context-variables.md    |   2 +-
 .../swarm-tutorial/07-multi-agent-patterns.md |   2 +-
 tutorials/swarm-tutorial/08-production.md     |   2 +-
 .../swarm-tutorial/{index.md => README.md}    |   0
 .../swe-agent-tutorial/01-getting-started.md  |   2 +-
 ...ore-architecture-and-yaml-configuration.md |   2 +-
 .../03-cli-workflows-and-usage-modes.md       |   2 +-
 ...tooling-environments-and-model-strategy.md |   2 +-
 ...5-benchmarking-and-evaluation-practices.md |   2 +-
 ...security-mode-and-specialized-workloads.md |   2 +-
 ...7-development-and-contribution-workflow.md |   2 +-
 ...08-production-operations-and-governance.md |   2 +-
 .../{index.md => README.md}                   |   0
 ...ing-started-and-current-product-posture.md |   2 +-
 .../02-issue-to-pr-workflow-architecture.md   |   2 +-
 ...repository-configuration-and-governance.md |   2 +-
 ...ack-loops-review-comments-and-ci-repair.md |   2 +-
 .../05-cli-and-self-hosted-deployment.md      |   2 +-
 ...-search-planning-and-execution-patterns.md |   2 +-
 ...imitations-risk-controls-and-safe-scope.md |   2 +-
 ...ation-strategy-and-long-term-operations.md |   2 +-
 .../sweep-tutorial/{index.md => README.md}    |   0
 .../01-getting-started-and-first-server.md    |   2 +-
 .../02-architecture-and-runtime-components.md |   2 +-
 ...3-model-serving-and-completion-pipeline.md |   2 +-
 .../04-answer-engine-and-context-indexing.md  |   2 +-
 ...5-editor-agents-and-client-integrations.md |   2 +-
 ...ration-security-and-enterprise-controls.md |   2 +-
 ...7-operations-upgrades-and-observability.md |   2 +-
 ...-contribution-roadmap-and-team-adoption.md |   2 +-
 .../tabby-tutorial/{index.md => README.md}    |   0
 ...01-getting-started-and-list-orientation.md |   2 +-
 ...2-information-architecture-and-taxonomy.md |   2 +-
 ...sis-positioning-and-comparison-patterns.md |   2 +-
 ...tool-categories-and-selection-framework.md |   2 +-
 .../05-mcp-and-agent-ecosystem-coverage.md    |   2 +-
 ...-practical-workflows-and-learning-paths.md |   2 +-
 ...on-governance-and-list-quality-controls.md |   2 +-
 ...rket-monitoring-and-operations-playbook.md |   2 +-
 .../{index.md => README.md}                   |   0
 ...1-getting-started-and-docs-entry-points.md |   2 +-
 ...navigation-and-information-architecture.md |   2 +-
 ...kspace-dna-and-living-systems-doc-model.md |   2 +-
 ...mentation-surface-and-endpoint-coverage.md |   2 +-
 ...s-and-automation-documentation-patterns.md |   2 +-
 ...notes-changelog-and-timeline-operations.md |   2 +-
 ...doc-quality-governance-and-link-hygiene.md |   2 +-
 ...n-workflow-and-docs-operations-playbook.md |   2 +-
 .../{index.md => README.md}                   |   0
 ...ing-started-and-first-client-connection.md |   2 +-
 ...ository-architecture-and-package-layout.md |   2 +-
 ...3-mcp-server-tools-auth-and-api-surface.md |   2 +-
 .../04-openapi-to-mcp-codegen-pipeline.md     |   2 +-
 ...n-across-claude-cursor-windsurf-and-n8n.md |   2 +-
 ...deployment-configuration-and-operations.md |   2 +-
 .../07-security-guardrails-and-governance.md  |   2 +-
 ...ribution-testing-and-release-operations.md |   2 +-
 .../{index.md => README.md}                   |   0
 .../taskade-tutorial/01-getting-started.md    |   2 +-
 .../02-living-dna-architecture.md             |   2 +-
 .../03-ai-agents-intelligence.md              |   2 +-
 .../taskade-tutorial/04-smart-automations.md  |   2 +-
 .../05-genesis-app-builder.md                 |   2 +-
 .../06-multi-agent-collaboration.md           |   2 +-
 .../07-enterprise-features.md                 |   2 +-
 .../08-production-deployment.md               |   2 +-
 .../taskade-tutorial/{index.md => README.md}  |   0
 .../01-system-overview.md                     |   2 +-
 .../02-database-architecture.md               |   2 +-
 .../03-setup-environment.md                   |   2 +-
 .../04-api-development.md                     |   2 +-
 .../05-realtime-collaboration.md              |   2 +-
 .../06-query-system.md                        |   2 +-
 .../07-frontend-architecture.md               |   2 +-
 .../08-production-deployment.md               |   4 +-
 tutorials/teable-database-platform/README.md  | 148 +++-
 tutorials/teable-database-platform/index.md   | 136 ----
 .../tiktoken-tutorial/01-getting-started.md   |   2 +-
 .../02-tokenization-mechanics.md              |   2 +-
 .../03-practical-applications.md              |   2 +-
 .../04-educational-module.md                  |   2 +-
 .../05-optimization-strategies.md             |   2 +-
 .../06-chatml-and-tool-calls.md               |   2 +-
 .../07-multilingual-tokenization.md           |   2 +-
 .../tiktoken-tutorial/08-cost-governance.md   |   2 +-
 .../tiktoken-tutorial/{index.md => README.md} |   0
 .../turborepo-tutorial/01-getting-started.md  |   2 +-
 .../02-workspace-configuration.md             |   2 +-
 .../turborepo-tutorial/03-task-pipelines.md   |   2 +-
 .../04-caching-strategies.md                  |   2 +-
 .../turborepo-tutorial/05-remote-caching.md   |   2 +-
 .../06-dependency-management.md               |   2 +-
 .../turborepo-tutorial/07-cicd-integration.md |   2 +-
 .../08-performance-optimization.md            |   2 +-
 .../{index.md => README.md}                   |   0
 ...01-getting-started-and-archived-context.md |   2 +-
 ...k-architecture-and-connection-lifecycle.md |   2 +-
 ...thentication-oauth-callback-and-storage.md |   2 +-
 ...resources-prompts-and-client-operations.md |   2 +-
 ...-transport-retry-and-reconnect-strategy.md |   2 +-
 ...egration-patterns-chat-ui-and-inspector.md |   2 +-
 ...sting-debugging-and-integration-servers.md |   2 +-
 ...-risk-migration-and-production-guidance.md |   4 +-
 .../use-mcp-tutorial/{index.md => README.md}  |   0
 .../vercel-ai-tutorial/01-getting-started.md  |   2 +-
 .../vercel-ai-tutorial/02-text-generation.md  |   2 +-
 .../03-streaming-responses.md                 |   2 +-
 .../vercel-ai-tutorial/04-function-calling.md |   2 +-
 .../05-structured-outputs.md                  |   2 +-
 .../06-react-integration.md                   |   2 +-
 .../07-nextjs-applications.md                 |   2 +-
 .../08-production-deployment.md               |   2 +-
 .../{index.md => README.md}                   |   0
 .../01-getting-started.md                     |   2 +-
 .../02-orchestration-architecture.md          |   2 +-
 .../03-multi-agent-execution-strategies.md    |   2 +-
 .../04-mcp-and-configuration-control.md       |   2 +-
 .../05-review-and-quality-gates.md            |   2 +-
 .../06-remote-access-and-self-hosting.md      |   2 +-
 ...7-development-and-source-build-workflow.md |   2 +-
 ...08-production-operations-and-governance.md |   2 +-
 .../{index.md => README.md}                   |   0
 ...01-getting-started-and-deployment-paths.md |   2 +-
 .../02-system-architecture.md                 |   2 +-
 .../03-ai-pipeline-and-phase-engine.md        |   2 +-
 .../04-sandbox-and-preview-runtime.md         |   2 +-
 .../05-data-layer-and-persistence.md          |   2 +-
 .../06-api-sdk-and-integrations.md            |   2 +-
 .../07-security-auth-and-governance.md        |   2 +-
 .../08-production-operations-and-scaling.md   |   4 +-
 .../vibesdk-tutorial/{index.md => README.md}  |   0
 tutorials/vllm-tutorial/01-getting-started.md |   2 +-
 tutorials/vllm-tutorial/02-model-loading.md   |   2 +-
 tutorials/vllm-tutorial/03-basic-inference.md |   2 +-
 .../vllm-tutorial/04-advanced-features.md     |   2 +-
 .../05-performance-optimization.md            |   2 +-
 .../vllm-tutorial/06-distributed-inference.md |   2 +-
 .../vllm-tutorial/07-production-deployment.md |   2 +-
 .../vllm-tutorial/08-monitoring-scaling.md    |   2 +-
 .../vllm-tutorial/{index.md => README.md}     |   0
 .../01-getting-started.md                     |   2 +-
 .../02-audio-processing.md                    |   2 +-
 .../03-model-architecture.md                  |   2 +-
 tutorials/whisper-cpp-tutorial/04-core-api.md |   2 +-
 .../05-real-time-streaming.md                 |   2 +-
 .../06-language-translation.md                |   2 +-
 .../07-platform-integration.md                |   2 +-
 .../08-deployment-production.md               |   2 +-
 .../{index.md => README.md}                   |   0
 .../01-getting-started.md                     |   2 +-
 ...place-architecture-and-plugin-structure.md |   2 +-
 ...tallation-and-plugin-selection-strategy.md |   2 +-
 ...ral-language-and-workflow-orchestration.md |   2 +-
 ...5-agents-skills-and-model-tier-strategy.md |   2 +-
 ...-team-patterns-and-production-workflows.md |   2 +-
 ...e-safety-and-operational-best-practices.md |   2 +-
 ...-workflow-and-plugin-authoring-patterns.md |   2 +-
 .../{index.md => README.md}                   |   0
 1747 files changed, 3895 insertions(+), 4581 deletions(-)
 rename tutorials/activepieces-tutorial/{index.md => README.md} (100%)
 rename tutorials/adk-python-tutorial/{index.md => README.md} (100%)
 rename tutorials/ag2-tutorial/{index.md => README.md} (100%)
 rename tutorials/agentgpt-tutorial/{index.md => README.md} (100%)
 rename tutorials/agenticseek-tutorial/{index.md => README.md} (100%)
 rename tutorials/agents-md-tutorial/{index.md => README.md} (100%)
 rename tutorials/agno-tutorial/{index.md => README.md} (100%)
 rename tutorials/aider-tutorial/{index.md => README.md} (100%)
 rename tutorials/anthropic-code-tutorial/{index.md => README.md} (100%)
 rename tutorials/anthropic-skills-tutorial/{index.md => README.md} (100%)
 rename tutorials/anything-llm-tutorial/{index.md => README.md} (100%)
 delete mode 100644 tutorials/athens-research-knowledge-graph/index.md
 rename tutorials/autoagent-tutorial/{index.md => README.md} (100%)
 rename tutorials/autogen-tutorial/{index.md => README.md} (100%)
 rename tutorials/awesome-claude-code-tutorial/{index.md => README.md} (100%)
 rename tutorials/awesome-claude-skills-tutorial/{index.md => README.md} (100%)
 rename tutorials/awesome-mcp-servers-tutorial/{index.md => README.md} (100%)
 rename tutorials/awslabs-mcp-tutorial/{index.md => README.md} (100%)
 rename tutorials/babyagi-tutorial/{index.md => README.md} (100%)
 rename tutorials/beads-tutorial/{index.md => README.md} (100%)
 rename tutorials/bentoml-tutorial/{index.md => README.md} (100%)
 rename tutorials/bolt-diy-tutorial/{index.md => README.md} (100%)
 rename tutorials/botpress-tutorial/{index.md => README.md} (100%)
 rename tutorials/browser-use-tutorial/{index.md => README.md} (100%)
 rename tutorials/chatbox-tutorial/{index.md => README.md} (100%)
 rename tutorials/cherry-studio-tutorial/{index.md => README.md} (100%)
 rename tutorials/chroma-tutorial/{index.md => README.md} (100%)
 rename tutorials/chrome-devtools-mcp-tutorial/{index.md => README.md} (100%)
 rename tutorials/cipher-tutorial/{index.md => README.md} (100%)
 rename tutorials/claude-code-router-tutorial/{index.md => README.md} (100%)
 rename tutorials/claude-code-tutorial/{index.md => README.md} (100%)
 rename tutorials/claude-flow-tutorial/{index.md => README.md} (100%)
 rename tutorials/claude-mem-tutorial/{index.md => README.md} (100%)
 rename tutorials/claude-plugins-official-tutorial/{index.md => README.md} (100%)
 rename tutorials/claude-quickstarts-tutorial/{index.md => README.md} (100%)
 rename tutorials/claude-squad-tutorial/{index.md => README.md} (100%)
 rename tutorials/claude-task-master-tutorial/{index.md => README.md} (100%)
 rename tutorials/clickhouse-tutorial/{index.md => README.md} (100%)
 rename tutorials/cline-tutorial/{index.md => README.md} (100%)
 rename tutorials/codemachine-cli-tutorial/{index.md => README.md} (100%)
 delete mode 100644 tutorials/codex-analysis-platform/index.md
 rename tutorials/codex-cli-tutorial/{index.md => README.md} (100%)
 rename tutorials/comfyui-tutorial/{index.md => README.md} (100%)
 rename tutorials/composio-tutorial/{index.md => README.md} (100%)
 rename tutorials/compound-engineering-plugin-tutorial/{index.md => README.md} (100%)
 rename tutorials/context7-tutorial/{index.md => README.md} (100%)
 rename tutorials/continue-tutorial/{index.md => README.md} (100%)
 rename tutorials/copilot-cli-tutorial/{index.md => README.md} (100%)
 rename tutorials/copilotkit-tutorial/{index.md => README.md} (100%)
 rename tutorials/create-python-server-tutorial/{index.md => README.md} (100%)
 rename tutorials/create-typescript-server-tutorial/{index.md => README.md} (100%)
 rename tutorials/crewai-tutorial/{index.md => README.md} (100%)
 rename tutorials/crush-tutorial/{index.md => README.md} (100%)
 rename tutorials/daytona-tutorial/{index.md => README.md} (100%)
 rename tutorials/deer-flow-tutorial/{index.md => README.md} (100%)
 rename tutorials/devika-tutorial/{index.md => README.md} (100%)
 delete mode 100644 tutorials/dify-platform-deep-dive/index.md
 rename tutorials/dspy-tutorial/{index.md => README.md} (100%)
 rename tutorials/dyad-tutorial/{index.md => README.md} (100%)
 rename tutorials/elizaos-tutorial/{index.md => README.md} (100%)
 rename tutorials/everything-claude-code-tutorial/{index.md => README.md} (100%)
 rename tutorials/fabric-tutorial/{index.md => README.md} (100%)
 rename tutorials/fastmcp-tutorial/{index.md => README.md} (100%)
 rename tutorials/figma-context-mcp-tutorial/{index.md => README.md} (100%)
 rename tutorials/firecrawl-mcp-server-tutorial/{index.md => README.md} (100%)
 rename tutorials/firecrawl-tutorial/{index.md => README.md} (100%)
 rename tutorials/fireproof-tutorial/{index.md => README.md} (100%)
 delete mode 100644 tutorials/flowise-llm-orchestration/index.md
 rename tutorials/gemini-cli-tutorial/{index.md => README.md} (100%)
 rename tutorials/genai-toolbox-tutorial/{index.md => README.md} (100%)
 rename tutorials/github-mcp-server-tutorial/{index.md => README.md} (100%)
 rename tutorials/goose-tutorial/{index.md => README.md} (100%)
 rename tutorials/gpt-oss-tutorial/{index.md => README.md} (100%)
 rename tutorials/gptme-tutorial/{index.md => README.md} (100%)
 rename tutorials/hapi-tutorial/{index.md => README.md} (100%)
 rename tutorials/haystack-tutorial/{index.md => README.md} (100%)
 rename tutorials/huggingface-tutorial/{index.md => README.md} (100%)
 rename tutorials/humanlayer-tutorial/{index.md => README.md} (100%)
 rename tutorials/instructor-tutorial/{index.md => README.md} (100%)
 rename tutorials/khoj-tutorial/{index.md => README.md} (100%)
 rename tutorials/kilocode-tutorial/{index.md => README.md} (100%)
 rename tutorials/kimi-cli-tutorial/{index.md => README.md} (100%)
 rename tutorials/kiro-tutorial/{index.md => README.md} (100%)
 rename tutorials/kubernetes-operator-patterns/{index.md => README.md} (100%)
 rename tutorials/lancedb-tutorial/{index.md => README.md} (100%)
 rename tutorials/langchain-architecture-guide/{index.md => README.md} (100%)
 rename tutorials/langchain-tutorial/{index.md => README.md} (100%)
 rename tutorials/langflow-tutorial/{index.md => README.md} (100%)
 rename tutorials/langfuse-tutorial/{index.md => README.md} (100%)
 rename tutorials/langgraph-tutorial/{index.md => README.md} (100%)
 rename tutorials/letta-tutorial/{index.md => README.md} (100%)
 rename tutorials/litellm-tutorial/{index.md => README.md} (100%)
 rename tutorials/liveblocks-tutorial/{index.md => README.md} (100%)
 rename tutorials/llama-cpp-tutorial/{index.md => README.md} (100%)
 rename tutorials/llama-factory-tutorial/{index.md => README.md} (100%)
 rename tutorials/llamaindex-tutorial/{index.md => README.md} (100%)
 delete mode 100644 tutorials/lobechat-ai-platform/index.md
 rename tutorials/localai-tutorial/{index.md => README.md} (100%)
 delete mode 100644 tutorials/logseq-knowledge-management/index.md
 rename tutorials/mastra-tutorial/{index.md => README.md} (100%)
 rename tutorials/mcp-chrome-tutorial/{index.md => README.md} (100%)
 rename tutorials/mcp-csharp-sdk-tutorial/{index.md => README.md} (100%)
 rename tutorials/mcp-docs-repo-tutorial/{index.md => README.md} (100%)
 rename tutorials/mcp-ext-apps-tutorial/{index.md => README.md} (100%)
 rename tutorials/mcp-go-sdk-tutorial/{index.md => README.md} (100%)
 rename tutorials/mcp-inspector-tutorial/{index.md => README.md} (100%)
 rename tutorials/mcp-java-sdk-tutorial/{index.md => README.md} (100%)
 rename tutorials/mcp-kotlin-sdk-tutorial/{index.md => README.md} (100%)
 rename tutorials/mcp-php-sdk-tutorial/{index.md => README.md} (100%)
 rename tutorials/mcp-python-sdk-tutorial/{index.md => README.md} (100%)
 rename tutorials/mcp-quickstart-resources-tutorial/{index.md => README.md} (100%)
 rename tutorials/mcp-registry-tutorial/{index.md => README.md} (100%)
 rename tutorials/mcp-ruby-sdk-tutorial/{index.md => README.md} (100%)
 rename tutorials/mcp-rust-sdk-tutorial/{index.md => README.md} (100%)
 rename tutorials/mcp-servers-tutorial/{index.md => README.md} (100%)
 rename tutorials/mcp-specification-tutorial/{index.md => README.md} (100%)
 rename tutorials/mcp-swift-sdk-tutorial/{index.md => README.md} (100%)
 rename tutorials/mcp-typescript-sdk-tutorial/{index.md => README.md} (100%)
 rename tutorials/mcp-use-tutorial/{index.md => README.md} (100%)
 rename tutorials/mcpb-tutorial/{index.md => README.md} (100%)
 rename tutorials/meilisearch-tutorial/{index.md => README.md} (100%)
 rename tutorials/mem0-tutorial/{index.md => README.md} (100%)
 rename tutorials/mini-swe-agent-tutorial/{index.md => README.md} (100%)
 rename tutorials/mistral-vibe-tutorial/{index.md => README.md} (100%)
 rename tutorials/n8n-ai-tutorial/{index.md => README.md} (100%)
 delete mode 100644 tutorials/n8n-mcp-tutorial/index.md
 rename tutorials/nanocoder-tutorial/{index.md => README.md} (100%)
 delete mode 100644 tutorials/nocodb-database-platform/index.md
 delete mode 100644 tutorials/obsidian-outliner-plugin/index.md
 rename tutorials/ollama-tutorial/{index.md => README.md} (100%)
 rename tutorials/onlook-tutorial/{index.md => README.md} (100%)
 rename tutorials/opcode-tutorial/{index.md => README.md} (100%)
 rename tutorials/open-swe-tutorial/{index.md => README.md} (100%)
 rename tutorials/open-webui-tutorial/{index.md => README.md} (100%)
 rename tutorials/openai-python-sdk-tutorial/{index.md => README.md} (100%)
 rename tutorials/openai-realtime-agents-tutorial/{index.md => README.md} (100%)
 rename tutorials/openai-whisper-tutorial/{index.md => README.md} (100%)
 rename tutorials/openbb-tutorial/{index.md => README.md} (100%)
 rename tutorials/openclaw-tutorial/{index.md => README.md} (100%)
 rename tutorials/opencode-ai-legacy-tutorial/{index.md => README.md} (100%)
 rename tutorials/opencode-tutorial/{index.md => README.md} (100%)
 rename tutorials/openhands-tutorial/{index.md => README.md} (100%)
 rename tutorials/openskills-tutorial/{index.md => README.md} (100%)
 rename tutorials/openspec-tutorial/{index.md => README.md} (100%)
 rename tutorials/opensrc-tutorial/{index.md => README.md} (100%)
 rename tutorials/outlines-tutorial/{index.md => README.md} (100%)
 rename tutorials/perplexica-tutorial/{index.md => README.md} (100%)
 rename tutorials/phidata-tutorial/{index.md => README.md} (100%)
 rename tutorials/photoprism-tutorial/{index.md => README.md} (100%)
 rename tutorials/plandex-tutorial/{index.md => README.md} (100%)
 rename tutorials/planning-with-files-tutorial/{index.md => README.md} (100%)
 rename tutorials/playwright-mcp-tutorial/{index.md => README.md} (100%)
 rename tutorials/pocketflow-tutorial/{index.md => README.md} (100%)
 rename tutorials/postgresql-query-planner/{index.md => README.md} (100%)
 rename tutorials/posthog-tutorial/{index.md => README.md} (100%)
 rename tutorials/pydantic-ai-tutorial/{index.md => README.md} (100%)
 rename tutorials/quivr-tutorial/{index.md => README.md} (100%)
 rename tutorials/qwen-agent-tutorial/{index.md => README.md} (100%)
 rename tutorials/ragflow-tutorial/{index.md => README.md} (100%)
 rename tutorials/react-fiber-internals/{index.md => README.md} (100%)
 rename tutorials/refly-tutorial/{index.md => README.md} (100%)
 rename tutorials/roo-code-tutorial/{index.md => README.md} (100%)
 rename tutorials/semantic-kernel-tutorial/{index.md => README.md} (100%)
 rename tutorials/serena-tutorial/{index.md => README.md} (100%)
 rename tutorials/shotgun-tutorial/{index.md => README.md} (100%)
 rename tutorials/sillytavern-tutorial/{index.md => README.md} (100%)
 rename tutorials/siyuan-tutorial/{index.md => README.md} (100%)
 rename tutorials/smolagents-tutorial/{index.md => README.md} (100%)
 rename tutorials/stagewise-tutorial/{index.md => README.md} (100%)
 rename tutorials/strands-agents-tutorial/{index.md => README.md} (100%)
 rename tutorials/supabase-tutorial/{index.md => README.md} (100%)
 rename tutorials/superagi-tutorial/{index.md => README.md} (100%)
 rename tutorials/superset-terminal-tutorial/{index.md => README.md} (100%)
 rename tutorials/swarm-tutorial/{index.md => README.md} (100%)
 rename tutorials/swe-agent-tutorial/{index.md => README.md} (100%)
 rename tutorials/sweep-tutorial/{index.md => README.md} (100%)
 rename tutorials/tabby-tutorial/{index.md => README.md} (100%)
 rename tutorials/taskade-awesome-vibe-coding-tutorial/{index.md => README.md} (100%)
 rename tutorials/taskade-docs-tutorial/{index.md => README.md} (100%)
 rename tutorials/taskade-mcp-tutorial/{index.md => README.md} (100%)
 rename tutorials/taskade-tutorial/{index.md => README.md} (100%)
 delete mode 100644 tutorials/teable-database-platform/index.md
 rename tutorials/tiktoken-tutorial/{index.md => README.md} (100%)
 rename tutorials/turborepo-tutorial/{index.md => README.md} (100%)
 rename tutorials/use-mcp-tutorial/{index.md => README.md} (100%)
 rename tutorials/vercel-ai-tutorial/{index.md => README.md} (100%)
 rename tutorials/vibe-kanban-tutorial/{index.md => README.md} (100%)
 rename tutorials/vibesdk-tutorial/{index.md => README.md} (100%)
 rename tutorials/vllm-tutorial/{index.md => README.md} (100%)
 rename tutorials/whisper-cpp-tutorial/{index.md => README.md} (100%)
 rename tutorials/wshobson-agents-tutorial/{index.md => README.md} (100%)

diff --git a/CONTENT_GAPS_ANALYSIS.md b/CONTENT_GAPS_ANALYSIS.md
index 57b98796..2dde7139 100644
--- a/CONTENT_GAPS_ANALYSIS.md
+++ b/CONTENT_GAPS_ANALYSIS.md
@@ -60,7 +60,7 @@ High-impact surfaces requiring continuous maintenance:
 
 A tutorial track is considered production-ready when:
 
-- it has `index.md` with valid local links
+- it has `README.md` with valid local links
 - it has a coherent numbered chapter sequence
 - its summary and snapshot language are not stale or placeholder quality
 - it passes repository docs health checks
diff --git a/TUTORIAL_STRUCTURE.md b/TUTORIAL_STRUCTURE.md
index de76880a..f6f88e66 100644
--- a/TUTORIAL_STRUCTURE.md
+++ b/TUTORIAL_STRUCTURE.md
@@ -6,7 +6,7 @@ This file defines the canonical tutorial layout and current structure status.
 
 ```text
 tutorials/<tutorial-name>/
-  index.md
+  README.md
   01-*.md
   02-*.md
   ...
diff --git a/discoverability/query-coverage.json b/discoverability/query-coverage.json
index cda94ae8..02d91185 100644
--- a/discoverability/query-coverage.json
+++ b/discoverability/query-coverage.json
@@ -12,7 +12,7 @@
       "title": "Open-Source Coding Agents",
       "tutorials": [
         {
-          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/cline-tutorial/index.md",
+          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/cline-tutorial/README.md",
           "intent_signals": [
             "agentic-coding"
           ],
@@ -20,7 +20,7 @@
           "title": "Cline Tutorial: Agentic Coding with Human Control"
         },
         {
-          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/roo-code-tutorial/index.md",
+          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/roo-code-tutorial/README.md",
           "intent_signals": [
             "production-operations",
             "architecture-deep-dive",
@@ -30,7 +30,7 @@
           "title": "Roo Code Tutorial: Run an AI Dev Team in Your Editor"
         },
         {
-          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/opencode-tutorial/index.md",
+          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/opencode-tutorial/README.md",
           "intent_signals": [
             "production-operations",
             "agentic-coding"
@@ -39,7 +39,7 @@
           "title": "OpenCode Tutorial: Open-Source Terminal Coding Agent at Scale"
         },
         {
-          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/codex-cli-tutorial/index.md",
+          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/codex-cli-tutorial/README.md",
           "intent_signals": [
             "agentic-coding"
           ],
@@ -47,7 +47,7 @@
           "title": "Codex CLI Tutorial: Local Terminal Agent Workflows with OpenAI Codex"
         },
         {
-          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/continue-tutorial/index.md",
+          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/continue-tutorial/README.md",
           "intent_signals": [
             "production-operations",
             "agentic-coding"
@@ -56,7 +56,7 @@
           "title": "Continue Tutorial: Open-Source AI Coding Agents for IDE and CLI"
         },
         {
-          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/openhands-tutorial/index.md",
+          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/openhands-tutorial/README.md",
           "intent_signals": [
             "production-operations",
             "agentic-coding"
@@ -65,7 +65,7 @@
           "title": "OpenHands Tutorial: Autonomous Software Engineering Workflows"
         },
         {
-          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/sweep-tutorial/index.md",
+          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/sweep-tutorial/README.md",
           "intent_signals": [
             "agentic-coding"
           ],
@@ -73,7 +73,7 @@
           "title": "Sweep Tutorial: Issue-to-PR AI Coding Workflows on GitHub"
         },
         {
-          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/tabby-tutorial/index.md",
+          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/tabby-tutorial/README.md",
           "intent_signals": [
             "production-operations",
             "architecture-deep-dive",
@@ -83,7 +83,7 @@
           "title": "Tabby Tutorial: Self-Hosted AI Coding Assistant Architecture and Operations"
         },
         {
-          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/stagewise-tutorial/index.md",
+          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/stagewise-tutorial/README.md",
           "intent_signals": [
             "agentic-coding"
           ],
@@ -91,7 +91,7 @@
           "title": "Stagewise Tutorial: Frontend Coding Agent Workflows in Real Browser Context"
         },
         {
-          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/daytona-tutorial/index.md",
+          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/daytona-tutorial/README.md",
           "intent_signals": [
             "agentic-coding"
           ],
@@ -99,7 +99,7 @@
           "title": "Daytona Tutorial: Secure Sandbox Infrastructure for AI-Generated Code"
         },
         {
-          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/adk-python-tutorial/index.md",
+          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/adk-python-tutorial/README.md",
           "intent_signals": [
             "production-operations",
             "agentic-coding"
@@ -108,7 +108,7 @@
           "title": "ADK Python Tutorial: Production-Grade Agent Engineering with Google's ADK"
         },
         {
-          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/agenticseek-tutorial/index.md",
+          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/agenticseek-tutorial/README.md",
           "intent_signals": [
             "beginner-onboarding",
             "production-operations",
@@ -130,7 +130,7 @@
       "title": "MCP Servers and SDKs",
       "tutorials": [
         {
-          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-python-sdk-tutorial/index.md",
+          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-python-sdk-tutorial/README.md",
           "intent_signals": [
             "mcp-integration"
           ],
@@ -138,7 +138,7 @@
           "title": "MCP Python SDK Tutorial: Building AI Tool Servers"
         },
         {
-          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/fastmcp-tutorial/index.md",
+          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/fastmcp-tutorial/README.md",
           "intent_signals": [
             "production-operations",
             "architecture-deep-dive",
@@ -148,7 +148,7 @@
           "title": "FastMCP Tutorial: Building and Operating MCP Servers with Pythonic Control"
         },
         {
-          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-servers-tutorial/index.md",
+          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-servers-tutorial/README.md",
           "intent_signals": [
             "production-operations",
             "mcp-integration"
@@ -157,7 +157,7 @@
           "title": "MCP Servers Tutorial: Reference Implementations and Patterns"
         },
         {
-          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-typescript-sdk-tutorial/index.md",
+          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-typescript-sdk-tutorial/README.md",
           "intent_signals": [
             "production-operations",
             "mcp-integration"
@@ -166,7 +166,7 @@
           "title": "MCP TypeScript SDK Tutorial: Building and Migrating MCP Clients and Servers in TypeScript"
         },
         {
-          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-go-sdk-tutorial/index.md",
+          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-go-sdk-tutorial/README.md",
           "intent_signals": [
             "production-operations",
             "mcp-integration"
@@ -175,7 +175,7 @@
           "title": "MCP Go SDK Tutorial: Building Robust MCP Clients and Servers in Go"
         },
         {
-          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-rust-sdk-tutorial/index.md",
+          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-rust-sdk-tutorial/README.md",
           "intent_signals": [
             "production-operations",
             "mcp-integration"
@@ -184,7 +184,7 @@
           "title": "MCP Rust SDK Tutorial: Building High-Performance MCP Services with RMCP"
         },
         {
-          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-java-sdk-tutorial/index.md",
+          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-java-sdk-tutorial/README.md",
           "intent_signals": [
             "production-operations",
             "mcp-integration"
@@ -193,7 +193,7 @@
           "title": "MCP Java SDK Tutorial: Building MCP Clients and Servers with Reactor, Servlet, and Spring"
         },
         {
-          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-csharp-sdk-tutorial/index.md",
+          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-csharp-sdk-tutorial/README.md",
           "intent_signals": [
             "production-operations",
             "mcp-integration"
@@ -202,7 +202,7 @@
           "title": "MCP C# SDK Tutorial: Production MCP in .NET with Hosting, ASP.NET Core, and Task Workflows"
         },
         {
-          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-registry-tutorial/index.md",
+          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-registry-tutorial/README.md",
           "intent_signals": [
             "production-operations",
             "mcp-integration"
@@ -211,7 +211,7 @@
           "title": "MCP Registry Tutorial: Publishing, Discovery, and Governance for MCP Servers"
         },
         {
-          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-inspector-tutorial/index.md",
+          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-inspector-tutorial/README.md",
           "intent_signals": [
             "mcp-integration"
           ],
@@ -219,7 +219,7 @@
           "title": "MCP Inspector Tutorial: Debugging and Validating MCP Servers"
         },
         {
-          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/awslabs-mcp-tutorial/index.md",
+          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/awslabs-mcp-tutorial/README.md",
           "intent_signals": [
             "production-operations",
             "mcp-integration"
@@ -228,7 +228,7 @@
           "title": "awslabs/mcp Tutorial: Operating a Large-Scale MCP Server Ecosystem for AWS Workloads"
         },
         {
-          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/bolt-diy-tutorial/index.md",
+          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/bolt-diy-tutorial/README.md",
           "intent_signals": [
             "production-operations",
             "architecture-deep-dive",
@@ -250,7 +250,7 @@
       "title": "RAG and Retrieval Systems",
       "tutorials": [
         {
-          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/llamaindex-tutorial/index.md",
+          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/llamaindex-tutorial/README.md",
           "intent_signals": [
             "rag-implementation"
           ],
@@ -258,7 +258,7 @@
           "title": "LlamaIndex Tutorial: Building Advanced RAG Systems and Data Frameworks"
         },
         {
-          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/haystack-tutorial/index.md",
+          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/haystack-tutorial/README.md",
           "intent_signals": [
             "production-operations",
             "architecture-deep-dive",
@@ -268,7 +268,7 @@
           "title": "Haystack: Deep Dive Tutorial"
         },
         {
-          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/ragflow-tutorial/index.md",
+          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/ragflow-tutorial/README.md",
           "intent_signals": [
             "rag-implementation"
           ],
@@ -276,7 +276,7 @@
           "title": "RAGFlow Tutorial: Complete Guide to Open-Source RAG Engine"
         },
         {
-          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/chroma-tutorial/index.md",
+          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/chroma-tutorial/README.md",
           "intent_signals": [
             "rag-implementation"
           ],
@@ -284,7 +284,7 @@
           "title": "ChromaDB Tutorial: Building AI-Native Vector Databases"
         },
         {
-          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/lancedb-tutorial/index.md",
+          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/lancedb-tutorial/README.md",
           "intent_signals": [
             "architecture-deep-dive",
             "rag-implementation"
@@ -293,7 +293,7 @@
           "title": "LanceDB Tutorial: Serverless Vector Database for AI"
         },
         {
-          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/quivr-tutorial/index.md",
+          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/quivr-tutorial/README.md",
           "intent_signals": [
             "rag-implementation"
           ],
@@ -301,7 +301,7 @@
           "title": "Quivr Tutorial: Open-Source RAG Framework for Document Ingestion"
         },
         {
-          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/ollama-tutorial/index.md",
+          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/ollama-tutorial/README.md",
           "intent_signals": [
             "production-operations",
             "rag-implementation"
@@ -322,7 +322,7 @@
       "title": "LLM Infrastructure and Serving",
       "tutorials": [
         {
-          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/vllm-tutorial/index.md",
+          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/vllm-tutorial/README.md",
           "intent_signals": [
             "general-learning"
           ],
@@ -330,7 +330,7 @@
           "title": "vLLM Tutorial: High-Performance LLM Inference"
         },
         {
-          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/litellm-tutorial/index.md",
+          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/litellm-tutorial/README.md",
           "intent_signals": [
             "production-operations"
           ],
@@ -338,7 +338,7 @@
           "title": "LiteLLM Tutorial: Unified LLM Gateway and Routing Layer"
         },
         {
-          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/llama-cpp-tutorial/index.md",
+          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/llama-cpp-tutorial/README.md",
           "intent_signals": [
             "general-learning"
           ],
@@ -346,7 +346,7 @@
           "title": "llama.cpp Tutorial: Local LLM Inference"
         },
         {
-          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/localai-tutorial/index.md",
+          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/localai-tutorial/README.md",
           "intent_signals": [
             "general-learning"
           ],
@@ -366,7 +366,7 @@
       "title": "AI App Frameworks and Product Stacks",
       "tutorials": [
         {
-          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/vercel-ai-tutorial/index.md",
+          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/vercel-ai-tutorial/README.md",
           "intent_signals": [
             "production-operations"
           ],
@@ -374,7 +374,7 @@
           "title": "Vercel AI SDK Tutorial: Production TypeScript AI Apps and Agents"
         },
         {
-          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/copilotkit-tutorial/index.md",
+          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/copilotkit-tutorial/README.md",
           "intent_signals": [
             "general-learning"
           ],
@@ -382,7 +382,7 @@
           "title": "CopilotKit Tutorial: Building AI Copilots for React Applications"
         },
         {
-          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/lobechat-ai-platform/index.md",
+          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/lobechat-ai-platform/README.md",
           "intent_signals": [
             "architecture-deep-dive"
           ],
@@ -390,7 +390,7 @@
           "title": "LobeChat AI Platform: Deep Dive Tutorial"
         },
         {
-          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/flowise-llm-orchestration/index.md",
+          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/flowise-llm-orchestration/README.md",
           "intent_signals": [
             "architecture-deep-dive"
           ],
@@ -398,7 +398,7 @@
           "title": "Flowise LLM Orchestration: Deep Dive Tutorial"
         },
         {
-          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/dify-platform-deep-dive/index.md",
+          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/dify-platform-deep-dive/README.md",
           "intent_signals": [
             "architecture-deep-dive"
           ],
@@ -406,7 +406,7 @@
           "title": "Dify Platform: Deep Dive Tutorial"
         },
         {
-          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/open-webui-tutorial/index.md",
+          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/open-webui-tutorial/README.md",
           "intent_signals": [
             "production-operations"
           ],
@@ -414,7 +414,7 @@
           "title": "Open WebUI Tutorial: Self-Hosted AI Workspace and Chat Interface"
         },
         {
-          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/chatbox-tutorial/index.md",
+          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/chatbox-tutorial/README.md",
           "intent_signals": [
             "general-learning"
           ],
@@ -422,7 +422,7 @@
           "title": "Chatbox Tutorial: Building Modern AI Chat Interfaces"
         },
         {
-          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/dyad-tutorial/index.md",
+          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/dyad-tutorial/README.md",
           "intent_signals": [
             "beginner-onboarding",
             "production-operations"
@@ -431,7 +431,7 @@
           "title": "Dyad Tutorial: Local-First AI App Building"
         },
         {
-          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/onlook-tutorial/index.md",
+          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/onlook-tutorial/README.md",
           "intent_signals": [
             "beginner-onboarding",
             "production-operations",
@@ -441,7 +441,7 @@
           "title": "Onlook Tutorial: Visual-First AI Coding for Next.js and Tailwind"
         },
         {
-          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/activepieces-tutorial/index.md",
+          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/activepieces-tutorial/README.md",
           "intent_signals": [
             "production-operations"
           ],
@@ -449,7 +449,7 @@
           "title": "Activepieces Tutorial: Open-Source Automation, Pieces, and AI-Ready Workflow Operations"
         },
         {
-          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/fireproof-tutorial/index.md",
+          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/fireproof-tutorial/README.md",
           "intent_signals": [
             "beginner-onboarding"
           ],
@@ -457,7 +457,7 @@
           "title": "Fireproof Tutorial: Local-First Document Database for AI-Native Apps"
         },
         {
-          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/botpress-tutorial/index.md",
+          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/botpress-tutorial/README.md",
           "intent_signals": [
             "general-learning"
           ],
@@ -482,7 +482,7 @@
       "title": "Taskade AI, Genesis, and MCP Workflows",
       "tutorials": [
         {
-          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/taskade-tutorial/index.md",
+          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/taskade-tutorial/README.md",
           "intent_signals": [
             "production-operations"
           ],
@@ -490,7 +490,7 @@
           "title": "Taskade Tutorial: AI-Native Workspace, Genesis, and Agentic Operations"
         },
         {
-          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/taskade-docs-tutorial/index.md",
+          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/taskade-docs-tutorial/README.md",
           "intent_signals": [
             "general-learning"
           ],
@@ -498,7 +498,7 @@
           "title": "Taskade Docs Tutorial: Operating the Living-DNA Documentation Stack"
         },
         {
-          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/taskade-mcp-tutorial/index.md",
+          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/taskade-mcp-tutorial/README.md",
           "intent_signals": [
             "general-learning"
           ],
@@ -506,7 +506,7 @@
           "title": "Taskade MCP Tutorial: OpenAPI-Driven MCP Server for Taskade Workflows"
         },
         {
-          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/taskade-awesome-vibe-coding-tutorial/index.md",
+          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/taskade-awesome-vibe-coding-tutorial/README.md",
           "intent_signals": [
             "tool-selection"
           ],
diff --git a/discoverability/query-hub.md b/discoverability/query-hub.md
index 625650a3..18a03cc8 100644
--- a/discoverability/query-hub.md
+++ b/discoverability/query-hub.md
@@ -17,29 +17,29 @@ Primary search intents:
 - `terminal coding agent workflow`
 
 Recommended tutorials:
-- [Cline Tutorial: Agentic Coding with Human Control](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/cline-tutorial/index.md)
+- [Cline Tutorial: Agentic Coding with Human Control](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/cline-tutorial/README.md)
   - A practical engineering guide to cline/cline: install, operate, and govern Cline across local development and team environments.
-- [Roo Code Tutorial: Run an AI Dev Team in Your Editor](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/roo-code-tutorial/index.md)
+- [Roo Code Tutorial: Run an AI Dev Team in Your Editor](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/roo-code-tutorial/README.md)
   - A production-focused guide to RooCodeInc/Roo-Code: mode design, task execution, checkpoints, MCP, team profiles, and enterprise operations.
-- [OpenCode Tutorial: Open-Source Terminal Coding Agent at Scale](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/opencode-tutorial/index.md)
+- [OpenCode Tutorial: Open-Source Terminal Coding Agent at Scale](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/opencode-tutorial/README.md)
   - Learn how to use anomalyco/opencode to run terminal-native coding agents with provider flexibility, strong tool control, and production-grade workflows.
-- [Codex CLI Tutorial: Local Terminal Agent Workflows with OpenAI Codex](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/codex-cli-tutorial/index.md)
+- [Codex CLI Tutorial: Local Terminal Agent Workflows with OpenAI Codex](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/codex-cli-tutorial/README.md)
   - Learn how to use openai/codex to run a lightweight coding agent locally, with strong controls for auth, configuration, MCP integration, and sandboxed execution.
-- [Continue Tutorial: Open-Source AI Coding Agents for IDE and CLI](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/continue-tutorial/index.md)
+- [Continue Tutorial: Open-Source AI Coding Agents for IDE and CLI](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/continue-tutorial/README.md)
   - A practical guide to continuedev/continue, covering IDE usage, headless/CLI workflows, model configuration, team collaboration, and enterprise operations.
-- [OpenHands Tutorial: Autonomous Software Engineering Workflows](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/openhands-tutorial/index.md)
+- [OpenHands Tutorial: Autonomous Software Engineering Workflows](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/openhands-tutorial/README.md)
   - Learn how to operate OpenHands/OpenHands across local GUI, CLI, and SDK workflows with production-minded safety, validation, and integration patterns.
-- [Sweep Tutorial: Issue-to-PR AI Coding Workflows on GitHub](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/sweep-tutorial/index.md)
+- [Sweep Tutorial: Issue-to-PR AI Coding Workflows on GitHub](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/sweep-tutorial/README.md)
   - Learn how to use sweepai/sweep to turn GitHub issues into pull requests, operate feedback loops, and run self-hosted or CLI workflows with clear guardrails.
-- [Tabby Tutorial: Self-Hosted AI Coding Assistant Architecture and Operations](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/tabby-tutorial/index.md)
+- [Tabby Tutorial: Self-Hosted AI Coding Assistant Architecture and Operations](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/tabby-tutorial/README.md)
   - Learn how to run and extend TabbyML/tabby for production code completion and team knowledge workflows.
-- [Stagewise Tutorial: Frontend Coding Agent Workflows in Real Browser Context](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/stagewise-tutorial/index.md)
+- [Stagewise Tutorial: Frontend Coding Agent Workflows in Real Browser Context](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/stagewise-tutorial/README.md)
   - Learn how to use stagewise-io/stagewise to connect browser-selected UI context with coding agents, plugin extensions, and multi-agent bridge workflows.
-- [Daytona Tutorial: Secure Sandbox Infrastructure for AI-Generated Code](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/daytona-tutorial/index.md)
+- [Daytona Tutorial: Secure Sandbox Infrastructure for AI-Generated Code](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/daytona-tutorial/README.md)
   - Learn how to use daytonaio/daytona to run AI-generated code in isolated sandboxes, integrate coding agents through MCP, and operate sandbox infrastructure with stronger security and resource controls.
-- [ADK Python Tutorial: Production-Grade Agent Engineering with Google's ADK](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/adk-python-tutorial/index.md)
+- [ADK Python Tutorial: Production-Grade Agent Engineering with Google's ADK](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/adk-python-tutorial/README.md)
   - Learn how to use google/adk-python to build, evaluate, and deploy modular AI agent systems with strong tooling, session controls, and production rollouts.
-- [AgenticSeek Tutorial: Local-First Autonomous Agent Operations](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/agenticseek-tutorial/index.md)
+- [AgenticSeek Tutorial: Local-First Autonomous Agent Operations](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/agenticseek-tutorial/README.md)
   - Learn how to use Fosowl/agenticSeek to run multi-agent planning, browsing, and coding workflows with local model support, Docker-first runtime defaults, and practical operator guardrails.
 
 ## MCP Servers and SDKs
@@ -53,29 +53,29 @@ Primary search intents:
 - `model context protocol sdk tutorial`
 
 Recommended tutorials:
-- [MCP Python SDK Tutorial: Building AI Tool Servers](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-python-sdk-tutorial/index.md)
+- [MCP Python SDK Tutorial: Building AI Tool Servers](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-python-sdk-tutorial/README.md)
   - Master the Model Context Protocol Python SDK to build custom tool servers that extend Claude and other LLMs with powerful capabilities.
-- [FastMCP Tutorial: Building and Operating MCP Servers with Pythonic Control](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/fastmcp-tutorial/index.md)
+- [FastMCP Tutorial: Building and Operating MCP Servers with Pythonic Control](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/fastmcp-tutorial/README.md)
   - Learn how to use jlowin/fastmcp to design, run, test, and deploy MCP servers and clients with practical transport, integration, auth, and operations patterns.
-- [MCP Servers Tutorial: Reference Implementations and Patterns](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-servers-tutorial/index.md)
+- [MCP Servers Tutorial: Reference Implementations and Patterns](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-servers-tutorial/README.md)
   - Learn how to use the official MCP reference servers as implementation blueprints, not drop-in production services.
-- [MCP TypeScript SDK Tutorial: Building and Migrating MCP Clients and Servers in TypeScript](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-typescript-sdk-tutorial/index.md)
+- [MCP TypeScript SDK Tutorial: Building and Migrating MCP Clients and Servers in TypeScript](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-typescript-sdk-tutorial/README.md)
   - Learn how to use modelcontextprotocol/typescript-sdk to build production MCP clients and servers, migrate from v1 to v2 safely, and validate behavior with conformance workflows.
-- [MCP Go SDK Tutorial: Building Robust MCP Clients and Servers in Go](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-go-sdk-tutorial/index.md)
+- [MCP Go SDK Tutorial: Building Robust MCP Clients and Servers in Go](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-go-sdk-tutorial/README.md)
   - Learn how to use modelcontextprotocol/go-sdk for production MCP workloads across stdio and streamable HTTP, including auth middleware, conformance, and upgrade planning.
-- [MCP Rust SDK Tutorial: Building High-Performance MCP Services with RMCP](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-rust-sdk-tutorial/index.md)
+- [MCP Rust SDK Tutorial: Building High-Performance MCP Services with RMCP](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-rust-sdk-tutorial/README.md)
   - Learn how to use modelcontextprotocol/rust-sdk (rmcp) for production MCP clients and servers with strong transport control, macro-driven tooling, OAuth, and async task workflows.
-- [MCP Java SDK Tutorial: Building MCP Clients and Servers with Reactor, Servlet, and Spring](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-java-sdk-tutorial/index.md)
+- [MCP Java SDK Tutorial: Building MCP Clients and Servers with Reactor, Servlet, and Spring](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-java-sdk-tutorial/README.md)
   - Learn how to use modelcontextprotocol/java-sdk across core Java and Spring stacks, from transport setup to conformance and production hardening.
-- [MCP C# SDK Tutorial: Production MCP in .NET with Hosting, ASP.NET Core, and Task Workflows](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-csharp-sdk-tutorial/index.md)
+- [MCP C# SDK Tutorial: Production MCP in .NET with Hosting, ASP.NET Core, and Task Workflows](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-csharp-sdk-tutorial/README.md)
   - Learn how to build and operate MCP clients and servers with modelcontextprotocol/csharp-sdk, including package choices, auth patterns, tasks, diagnostics, and versioning strategy.
-- [MCP Registry Tutorial: Publishing, Discovery, and Governance for MCP Servers](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-registry-tutorial/index.md)
+- [MCP Registry Tutorial: Publishing, Discovery, and Governance for MCP Servers](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-registry-tutorial/README.md)
   - Learn how modelcontextprotocol/registry works end to end: publishing authenticated server metadata, consuming the API as an aggregator, and operating registry infrastructure safely.
-- [MCP Inspector Tutorial: Debugging and Validating MCP Servers](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-inspector-tutorial/index.md)
+- [MCP Inspector Tutorial: Debugging and Validating MCP Servers](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-inspector-tutorial/README.md)
   - Learn how to use modelcontextprotocol/inspector to test MCP servers across stdio, SSE, and streamable HTTP, with safer auth defaults and repeatable CLI automation.
-- [awslabs/mcp Tutorial: Operating a Large-Scale MCP Server Ecosystem for AWS Workloads](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/awslabs-mcp-tutorial/index.md)
+- [awslabs/mcp Tutorial: Operating a Large-Scale MCP Server Ecosystem for AWS Workloads](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/awslabs-mcp-tutorial/README.md)
   - Learn how to use awslabs/mcp to compose, run, and govern AWS-focused MCP servers across development, infrastructure, data, and operations workflows.
-- [bolt.diy Tutorial: Build and Operate an Open Source AI App Builder](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/bolt-diy-tutorial/index.md)
+- [bolt.diy Tutorial: Build and Operate an Open Source AI App Builder](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/bolt-diy-tutorial/README.md)
   - A production-focused deep dive into stackblitz-labs/bolt.diy: architecture, provider routing, safe edit loops, MCP integrations, deployment choices, and operational governance.
 
 ## RAG and Retrieval Systems
@@ -89,19 +89,19 @@ Primary search intents:
 - `vector database tutorial for ai`
 
 Recommended tutorials:
-- [LlamaIndex Tutorial: Building Advanced RAG Systems and Data Frameworks](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/llamaindex-tutorial/index.md)
+- [LlamaIndex Tutorial: Building Advanced RAG Systems and Data Frameworks](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/llamaindex-tutorial/README.md)
   - A deep technical walkthrough of LlamaIndex covering Building Advanced RAG Systems and Data Frameworks.
-- [Haystack: Deep Dive Tutorial](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/haystack-tutorial/index.md)
+- [Haystack: Deep Dive Tutorial](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/haystack-tutorial/README.md)
   - Haystack — An open-source framework for building production-ready LLM applications, RAG pipelines, and intelligent search systems.
-- [RAGFlow Tutorial: Complete Guide to Open-Source RAG Engine](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/ragflow-tutorial/index.md)
+- [RAGFlow Tutorial: Complete Guide to Open-Source RAG Engine](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/ragflow-tutorial/README.md)
   - Transform documents into intelligent Q&A systems with RAGFlow's comprehensive RAG (Retrieval-Augmented Generation) platform.
-- [ChromaDB Tutorial: Building AI-Native Vector Databases](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/chroma-tutorial/index.md)
+- [ChromaDB Tutorial: Building AI-Native Vector Databases](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/chroma-tutorial/README.md)
   - A deep technical walkthrough of ChromaDB covering Building AI-Native Vector Databases.
-- [LanceDB Tutorial: Serverless Vector Database for AI](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/lancedb-tutorial/index.md)
+- [LanceDB Tutorial: Serverless Vector Database for AI](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/lancedb-tutorial/README.md)
   - Master LanceDB, the open-source serverless vector database designed for AI applications, RAG systems, and semantic search.
-- [Quivr Tutorial: Open-Source RAG Framework for Document Ingestion](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/quivr-tutorial/index.md)
+- [Quivr Tutorial: Open-Source RAG Framework for Document Ingestion](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/quivr-tutorial/README.md)
   - Deep technical walkthrough of Quivr Tutorial: Open-Source RAG Framework for Document Ingestion.
-- [Ollama Tutorial: Running and Serving LLMs Locally](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/ollama-tutorial/index.md)
+- [Ollama Tutorial: Running and Serving LLMs Locally](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/ollama-tutorial/README.md)
   - Learn how to use ollama/ollama for local model execution, customization, embeddings/RAG, integration, and production deployment.
 
 ## LLM Infrastructure and Serving
@@ -115,13 +115,13 @@ Primary search intents:
 - `self-hosted llm infrastructure`
 
 Recommended tutorials:
-- [vLLM Tutorial: High-Performance LLM Inference](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/vllm-tutorial/index.md)
+- [vLLM Tutorial: High-Performance LLM Inference](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/vllm-tutorial/README.md)
   - Master vLLM for blazing-fast, cost-effective large language model inference with advanced optimization techniques.
-- [LiteLLM Tutorial: Unified LLM Gateway and Routing Layer](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/litellm-tutorial/index.md)
+- [LiteLLM Tutorial: Unified LLM Gateway and Routing Layer](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/litellm-tutorial/README.md)
   - Build provider-agnostic LLM applications with BerriAI/litellm, including routing, fallbacks, proxy deployment, and cost-aware operations.
-- [llama.cpp Tutorial: Local LLM Inference](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/llama-cpp-tutorial/index.md)
+- [llama.cpp Tutorial: Local LLM Inference](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/llama-cpp-tutorial/README.md)
   - Run large language models efficiently on your local machine with pure C/C++.
-- [LocalAI Tutorial: Self-Hosted OpenAI Alternative](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/localai-tutorial/index.md)
+- [LocalAI Tutorial: Self-Hosted OpenAI Alternative](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/localai-tutorial/README.md)
   - Run LLMs, image generation, and audio models locally with an OpenAI-compatible API.
 
 ## AI App Frameworks and Product Stacks
@@ -135,29 +135,29 @@ Primary search intents:
 - `ai workflow builder tutorial`
 
 Recommended tutorials:
-- [Vercel AI SDK Tutorial: Production TypeScript AI Apps and Agents](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/vercel-ai-tutorial/index.md)
+- [Vercel AI SDK Tutorial: Production TypeScript AI Apps and Agents](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/vercel-ai-tutorial/README.md)
   - Build robust AI product features with vercel/ai, including streaming, structured outputs, tool loops, framework integration, and production deployment patterns.
-- [CopilotKit Tutorial: Building AI Copilots for React Applications](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/copilotkit-tutorial/index.md)
+- [CopilotKit Tutorial: Building AI Copilots for React Applications](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/copilotkit-tutorial/README.md)
   - Create in-app AI assistants, chatbots, and agentic UIs with the open-source CopilotKit framework.
-- [LobeChat AI Platform: Deep Dive Tutorial](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/lobechat-ai-platform/index.md)
+- [LobeChat AI Platform: Deep Dive Tutorial](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/lobechat-ai-platform/README.md)
   - LobeChat — An open-source, modern-design AI chat framework for building private LLM applications.
-- [Flowise LLM Orchestration: Deep Dive Tutorial](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/flowise-llm-orchestration/index.md)
+- [Flowise LLM Orchestration: Deep Dive Tutorial](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/flowise-llm-orchestration/README.md)
   - Flowise — An open-source visual tool for building LLM workflows with a drag-and-drop interface.
-- [Dify Platform: Deep Dive Tutorial](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/dify-platform-deep-dive/index.md)
+- [Dify Platform: Deep Dive Tutorial](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/dify-platform-deep-dive/README.md)
   - Dify — An open-source LLM application development platform for building workflows, RAG pipelines, and AI agents with a visual interface.
-- [Open WebUI Tutorial: Self-Hosted AI Workspace and Chat Interface](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/open-webui-tutorial/index.md)
+- [Open WebUI Tutorial: Self-Hosted AI Workspace and Chat Interface](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/open-webui-tutorial/README.md)
   - Learn how to run and operate open-webui/open-webui as a self-hosted AI interface with model routing, RAG workflows, multi-user controls, and production deployment patterns.
-- [Chatbox Tutorial: Building Modern AI Chat Interfaces](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/chatbox-tutorial/index.md)
+- [Chatbox Tutorial: Building Modern AI Chat Interfaces](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/chatbox-tutorial/README.md)
   - A deep technical walkthrough of Chatbox covering Building Modern AI Chat Interfaces.
-- [Dyad Tutorial: Local-First AI App Building](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/dyad-tutorial/index.md)
+- [Dyad Tutorial: Local-First AI App Building](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/dyad-tutorial/README.md)
   - A practical guide to dyad-sh/dyad, focused on local-first app generation, integration patterns, validation loops, and deployment readiness.
-- [Onlook Tutorial: Visual-First AI Coding for Next.js and Tailwind](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/onlook-tutorial/index.md)
+- [Onlook Tutorial: Visual-First AI Coding for Next.js and Tailwind](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/onlook-tutorial/README.md)
   - Learn how to use onlook-dev/onlook to design and edit production-grade React apps visually while keeping generated code in your repository.
-- [Activepieces Tutorial: Open-Source Automation, Pieces, and AI-Ready Workflow Operations](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/activepieces-tutorial/index.md)
+- [Activepieces Tutorial: Open-Source Automation, Pieces, and AI-Ready Workflow Operations](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/activepieces-tutorial/README.md)
   - Learn how to use activepieces/activepieces to build, run, and govern production automation workflows with open-source extensibility, piece development, API control, and self-hosted operations.
-- [Fireproof Tutorial: Local-First Document Database for AI-Native Apps](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/fireproof-tutorial/index.md)
+- [Fireproof Tutorial: Local-First Document Database for AI-Native Apps](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/fireproof-tutorial/README.md)
   - Learn how to use fireproof-storage/fireproof to build local-first, encrypted, sync-capable applications with a unified browser/Node/Deno API and React hooks.
-- [Botpress Tutorial: Open Source Conversational AI Platform](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/botpress-tutorial/index.md)
+- [Botpress Tutorial: Open Source Conversational AI Platform](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/botpress-tutorial/README.md)
   - This comprehensive tutorial will guide you through Botpress, a powerful open source platform for building conversational AI applications
 
 ## Taskade AI, Genesis, and MCP Workflows
@@ -176,11 +176,11 @@ Primary search intents:
 - `taskade automation agents`
 
 Recommended tutorials:
-- [Taskade Tutorial: AI-Native Workspace, Genesis, and Agentic Operations](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/taskade-tutorial/index.md)
+- [Taskade Tutorial: AI-Native Workspace, Genesis, and Agentic Operations](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/taskade-tutorial/README.md)
   - Learn how to operate Taskade as an AI-native workspace system: Genesis app generation, AI agents, automations, enterprise controls, and production rollout patterns.
-- [Taskade Docs Tutorial: Operating the Living-DNA Documentation Stack](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/taskade-docs-tutorial/index.md)
+- [Taskade Docs Tutorial: Operating the Living-DNA Documentation Stack](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/taskade-docs-tutorial/README.md)
   - Learn how taskade/docs structures product documentation across Genesis, API references, automations, help-center workflows, and release timelines.
-- [Taskade MCP Tutorial: OpenAPI-Driven MCP Server for Taskade Workflows](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/taskade-mcp-tutorial/index.md)
+- [Taskade MCP Tutorial: OpenAPI-Driven MCP Server for Taskade Workflows](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/taskade-mcp-tutorial/README.md)
   - Learn how to run, extend, and operate taskade/mcp to connect Taskade workspaces, tasks, projects, and AI agents into MCP-compatible clients.
-- [Taskade Awesome Vibe Coding Tutorial: Curating the 2026 AI-Building Landscape](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/taskade-awesome-vibe-coding-tutorial/index.md)
+- [Taskade Awesome Vibe Coding Tutorial: Curating the 2026 AI-Building Landscape](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/taskade-awesome-vibe-coding-tutorial/README.md)
   - Learn how to use and maintain taskade/awesome-vibe-coding as a decision system for AI app builders, coding agents, MCP tooling, and Genesis-centered workflows.
diff --git a/discoverability/search-intent-map.md b/discoverability/search-intent-map.md
index 6f8f06bb..87f42f9d 100644
--- a/discoverability/search-intent-map.md
+++ b/discoverability/search-intent-map.md
@@ -10,55 +10,55 @@ Auto-generated topical clusters to strengthen internal linking and query-to-tuto
 
 - tutorial_count: **27**
 
-- [Activepieces Tutorial: Open-Source Automation, Pieces, and AI-Ready Workflow Operations](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/activepieces-tutorial/index.md)
+- [Activepieces Tutorial: Open-Source Automation, Pieces, and AI-Ready Workflow Operations](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/activepieces-tutorial/README.md)
   - intents: production-operations
-- [BentoML Tutorial: Building Production-Ready ML Services](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/bentoml-tutorial/index.md)
+- [BentoML Tutorial: Building Production-Ready ML Services](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/bentoml-tutorial/README.md)
   - intents: production-operations
-- [Botpress Tutorial: Open Source Conversational AI Platform](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/botpress-tutorial/index.md)
+- [Botpress Tutorial: Open Source Conversational AI Platform](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/botpress-tutorial/README.md)
   - intents: general-learning
-- [Chatbox Tutorial: Building Modern AI Chat Interfaces](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/chatbox-tutorial/index.md)
+- [Chatbox Tutorial: Building Modern AI Chat Interfaces](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/chatbox-tutorial/README.md)
   - intents: general-learning
-- [ComfyUI Tutorial: Mastering AI Image Generation Workflows](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/comfyui-tutorial/index.md)
+- [ComfyUI Tutorial: Mastering AI Image Generation Workflows](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/comfyui-tutorial/README.md)
   - intents: general-learning
-- [CopilotKit Tutorial: Building AI Copilots for React Applications](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/copilotkit-tutorial/index.md)
+- [CopilotKit Tutorial: Building AI Copilots for React Applications](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/copilotkit-tutorial/README.md)
   - intents: general-learning
-- [Dify Platform: Deep Dive Tutorial](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/dify-platform-deep-dive/index.md)
+- [Dify Platform: Deep Dive Tutorial](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/dify-platform-deep-dive/README.md)
   - intents: architecture-deep-dive
-- [Dyad Tutorial: Local-First AI App Building](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/dyad-tutorial/index.md)
+- [Dyad Tutorial: Local-First AI App Building](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/dyad-tutorial/README.md)
   - intents: beginner-onboarding, production-operations
-- [Firecrawl Tutorial: Building LLM-Ready Web Scraping and Data Extraction Systems](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/firecrawl-tutorial/index.md)
+- [Firecrawl Tutorial: Building LLM-Ready Web Scraping and Data Extraction Systems](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/firecrawl-tutorial/README.md)
   - intents: general-learning
-- [Fireproof Tutorial: Local-First Document Database for AI-Native Apps](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/fireproof-tutorial/index.md)
+- [Fireproof Tutorial: Local-First Document Database for AI-Native Apps](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/fireproof-tutorial/README.md)
   - intents: beginner-onboarding
-- [Flowise LLM Orchestration: Deep Dive Tutorial](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/flowise-llm-orchestration/index.md)
+- [Flowise LLM Orchestration: Deep Dive Tutorial](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/flowise-llm-orchestration/README.md)
   - intents: architecture-deep-dive
-- [GPT Open Source: Deep Dive Tutorial](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/gpt-oss-tutorial/index.md)
+- [GPT Open Source: Deep Dive Tutorial](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/gpt-oss-tutorial/README.md)
   - intents: production-operations, architecture-deep-dive
-- [HuggingFace Transformers Tutorial: Building State-of-the-Art AI Models](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/huggingface-tutorial/index.md)
+- [HuggingFace Transformers Tutorial: Building State-of-the-Art AI Models](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/huggingface-tutorial/README.md)
   - intents: general-learning
-- [LangChain Architecture: Internal Design Deep Dive](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/langchain-architecture-guide/index.md)
+- [LangChain Architecture: Internal Design Deep Dive](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/langchain-architecture-guide/README.md)
   - intents: architecture-deep-dive
-- [LangChain Tutorial: Building AI Applications with Large Language Models](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/langchain-tutorial/index.md)
+- [LangChain Tutorial: Building AI Applications with Large Language Models](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/langchain-tutorial/README.md)
   - intents: general-learning
-- [LangGraph Tutorial: Building Stateful Multi-Actor Applications](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/langgraph-tutorial/index.md)
+- [LangGraph Tutorial: Building Stateful Multi-Actor Applications](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/langgraph-tutorial/README.md)
   - intents: general-learning
-- [LobeChat AI Platform: Deep Dive Tutorial](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/lobechat-ai-platform/index.md)
+- [LobeChat AI Platform: Deep Dive Tutorial](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/lobechat-ai-platform/README.md)
   - intents: architecture-deep-dive
-- [Onlook Tutorial: Visual-First AI Coding for Next.js and Tailwind](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/onlook-tutorial/index.md)
+- [Onlook Tutorial: Visual-First AI Coding for Next.js and Tailwind](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/onlook-tutorial/README.md)
   - intents: beginner-onboarding, production-operations, architecture-deep-dive
-- [Open WebUI Tutorial: Self-Hosted AI Workspace and Chat Interface](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/open-webui-tutorial/index.md)
+- [Open WebUI Tutorial: Self-Hosted AI Workspace and Chat Interface](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/open-webui-tutorial/README.md)
   - intents: production-operations
-- [OpenAI Python SDK Tutorial: Production API Patterns](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/openai-python-sdk-tutorial/index.md)
+- [OpenAI Python SDK Tutorial: Production API Patterns](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/openai-python-sdk-tutorial/README.md)
   - intents: beginner-onboarding, production-operations, architecture-deep-dive
-- [OpenAI Whisper Tutorial: Speech Recognition and Translation](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/openai-whisper-tutorial/index.md)
+- [OpenAI Whisper Tutorial: Speech Recognition and Translation](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/openai-whisper-tutorial/README.md)
   - intents: production-operations
-- [OpenBB Tutorial: Complete Guide to Investment Research Platform](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/openbb-tutorial/index.md)
+- [OpenBB Tutorial: Complete Guide to Investment Research Platform](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/openbb-tutorial/README.md)
   - intents: general-learning
-- [Semantic Kernel Tutorial: Microsoft's AI Orchestration](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/semantic-kernel-tutorial/index.md)
+- [Semantic Kernel Tutorial: Microsoft's AI Orchestration](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/semantic-kernel-tutorial/README.md)
   - intents: general-learning
-- [Supabase Tutorial: Building Modern Backend Applications](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/supabase-tutorial/index.md)
+- [Supabase Tutorial: Building Modern Backend Applications](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/supabase-tutorial/README.md)
   - intents: general-learning
-- [Turborepo Tutorial: High-Performance Monorepo Build System](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/turborepo-tutorial/index.md)
+- [Turborepo Tutorial: High-Performance Monorepo Build System](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/turborepo-tutorial/README.md)
   - intents: general-learning
 - ... plus 2 more tutorials in this cluster
 
@@ -66,55 +66,55 @@ Auto-generated topical clusters to strengthen internal linking and query-to-tuto
 
 - tutorial_count: **85**
 
-- [ADK Python Tutorial: Production-Grade Agent Engineering with Google's ADK](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/adk-python-tutorial/index.md)
+- [ADK Python Tutorial: Production-Grade Agent Engineering with Google's ADK](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/adk-python-tutorial/README.md)
   - intents: production-operations, agentic-coding
-- [AG2 Tutorial: Next-Generation Multi-Agent Framework](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/ag2-tutorial/index.md)
+- [AG2 Tutorial: Next-Generation Multi-Agent Framework](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/ag2-tutorial/README.md)
   - intents: agentic-coding
-- [AGENTS.md Tutorial: Open Standard for Coding-Agent Guidance in Repositories](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/agents-md-tutorial/index.md)
+- [AGENTS.md Tutorial: Open Standard for Coding-Agent Guidance in Repositories](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/agents-md-tutorial/README.md)
   - intents: agentic-coding
-- [AgentGPT Tutorial: Building Autonomous AI Agents](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/agentgpt-tutorial/index.md)
+- [AgentGPT Tutorial: Building Autonomous AI Agents](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/agentgpt-tutorial/README.md)
   - intents: agentic-coding
-- [AgenticSeek Tutorial: Local-First Autonomous Agent Operations](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/agenticseek-tutorial/index.md)
+- [AgenticSeek Tutorial: Local-First Autonomous Agent Operations](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/agenticseek-tutorial/README.md)
   - intents: beginner-onboarding, production-operations, agentic-coding
-- [Agno Tutorial: Multi-Agent Systems That Learn Over Time](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/agno-tutorial/index.md)
+- [Agno Tutorial: Multi-Agent Systems That Learn Over Time](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/agno-tutorial/README.md)
   - intents: production-operations, agentic-coding
-- [Aider Tutorial: AI Pair Programming in Your Terminal](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/aider-tutorial/index.md)
+- [Aider Tutorial: AI Pair Programming in Your Terminal](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/aider-tutorial/README.md)
   - intents: agentic-coding
-- [Anthropic Skills Tutorial: Reusable AI Agent Capabilities](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/anthropic-skills-tutorial/index.md)
+- [Anthropic Skills Tutorial: Reusable AI Agent Capabilities](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/anthropic-skills-tutorial/README.md)
   - intents: production-operations, agentic-coding
-- [AnythingLLM Tutorial: Self-Hosted RAG and Agents Platform](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/anything-llm-tutorial/index.md)
+- [AnythingLLM Tutorial: Self-Hosted RAG and Agents Platform](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/anything-llm-tutorial/README.md)
   - intents: production-operations, agentic-coding
-- [AutoAgent Tutorial: Zero-Code Agent Creation and Automated Workflow Orchestration](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/autoagent-tutorial/index.md)
+- [AutoAgent Tutorial: Zero-Code Agent Creation and Automated Workflow Orchestration](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/autoagent-tutorial/README.md)
   - intents: production-operations, agentic-coding
-- [Awesome Claude Code Tutorial: Curated Claude Code Resource Discovery and Evaluation](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/awesome-claude-code-tutorial/index.md)
+- [Awesome Claude Code Tutorial: Curated Claude Code Resource Discovery and Evaluation](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/awesome-claude-code-tutorial/README.md)
   - intents: tool-selection, agentic-coding
-- [Awesome Claude Skills Tutorial: High-Signal Skill Discovery and Reuse for Claude Workflows](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/awesome-claude-skills-tutorial/index.md)
+- [Awesome Claude Skills Tutorial: High-Signal Skill Discovery and Reuse for Claude Workflows](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/awesome-claude-skills-tutorial/README.md)
   - intents: tool-selection, agentic-coding
-- [BabyAGI Tutorial: The Original Autonomous AI Task Agent Framework](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/babyagi-tutorial/index.md)
+- [BabyAGI Tutorial: The Original Autonomous AI Task Agent Framework](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/babyagi-tutorial/README.md)
   - intents: agentic-coding
-- [Beads Tutorial: Git-Backed Task Graph Memory for Coding Agents](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/beads-tutorial/index.md)
+- [Beads Tutorial: Git-Backed Task Graph Memory for Coding Agents](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/beads-tutorial/README.md)
   - intents: agentic-coding
-- [Browser Use Tutorial: AI-Powered Web Automation Agents](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/browser-use-tutorial/index.md)
+- [Browser Use Tutorial: AI-Powered Web Automation Agents](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/browser-use-tutorial/README.md)
   - intents: production-operations, agentic-coding
-- [Chrome DevTools MCP Tutorial: Browser Automation and Debugging for Coding Agents](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/chrome-devtools-mcp-tutorial/index.md)
+- [Chrome DevTools MCP Tutorial: Browser Automation and Debugging for Coding Agents](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/chrome-devtools-mcp-tutorial/README.md)
   - intents: agentic-coding
-- [Cipher Tutorial: Shared Memory Layer for Coding Agents](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/cipher-tutorial/index.md)
+- [Cipher Tutorial: Shared Memory Layer for Coding Agents](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/cipher-tutorial/README.md)
   - intents: agentic-coding
-- [Claude Code Router Tutorial: Multi-Provider Routing and Control Plane for Claude Code](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/claude-code-router-tutorial/index.md)
+- [Claude Code Router Tutorial: Multi-Provider Routing and Control Plane for Claude Code](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/claude-code-router-tutorial/README.md)
   - intents: agentic-coding
-- [Claude Code Tutorial: Agentic Coding from Your Terminal](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/claude-code-tutorial/index.md)
+- [Claude Code Tutorial: Agentic Coding from Your Terminal](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/claude-code-tutorial/README.md)
   - intents: agentic-coding
-- [Claude Plugins Official Tutorial: Anthropic's Managed Plugin Directory](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/claude-plugins-official-tutorial/index.md)
+- [Claude Plugins Official Tutorial: Anthropic's Managed Plugin Directory](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/claude-plugins-official-tutorial/README.md)
   - intents: agentic-coding
-- [Claude Quickstarts Tutorial: Production Integration Patterns](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/claude-quickstarts-tutorial/index.md)
+- [Claude Quickstarts Tutorial: Production Integration Patterns](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/claude-quickstarts-tutorial/README.md)
   - intents: production-operations, agentic-coding
-- [Claude Squad Tutorial: Multi-Agent Terminal Session Orchestration](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/claude-squad-tutorial/index.md)
+- [Claude Squad Tutorial: Multi-Agent Terminal Session Orchestration](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/claude-squad-tutorial/README.md)
   - intents: agentic-coding
-- [Claude-Mem Tutorial: Persistent Memory Compression for Claude Code](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/claude-mem-tutorial/index.md)
+- [Claude-Mem Tutorial: Persistent Memory Compression for Claude Code](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/claude-mem-tutorial/README.md)
   - intents: agentic-coding
-- [Cline Tutorial: Agentic Coding with Human Control](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/cline-tutorial/index.md)
+- [Cline Tutorial: Agentic Coding with Human Control](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/cline-tutorial/README.md)
   - intents: agentic-coding
-- [CodeMachine CLI Tutorial: Orchestrating Long-Running Coding Agent Workflows](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/codemachine-cli-tutorial/index.md)
+- [CodeMachine CLI Tutorial: Orchestrating Long-Running Coding Agent Workflows](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/codemachine-cli-tutorial/README.md)
   - intents: agentic-coding
 - ... plus 60 more tutorials in this cluster
 
@@ -122,126 +122,126 @@ Auto-generated topical clusters to strengthen internal linking and query-to-tuto
 
 - tutorial_count: **8**
 
-- [Athens Research: Deep Dive Tutorial](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/athens-research-knowledge-graph/index.md)
+- [Athens Research: Deep Dive Tutorial](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/athens-research-knowledge-graph/README.md)
   - intents: architecture-deep-dive
-- [ClickHouse Tutorial: High-Performance Analytical Database](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/clickhouse-tutorial/index.md)
+- [ClickHouse Tutorial: High-Performance Analytical Database](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/clickhouse-tutorial/README.md)
   - intents: general-learning
-- [Logseq: Deep Dive Tutorial](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/logseq-knowledge-management/index.md)
+- [Logseq: Deep Dive Tutorial](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/logseq-knowledge-management/README.md)
   - intents: beginner-onboarding, architecture-deep-dive
-- [MeiliSearch Tutorial: Lightning Fast Search Engine](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/meilisearch-tutorial/index.md)
+- [MeiliSearch Tutorial: Lightning Fast Search Engine](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/meilisearch-tutorial/README.md)
   - intents: general-learning
-- [NocoDB: Deep Dive Tutorial](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/nocodb-database-platform/index.md)
+- [NocoDB: Deep Dive Tutorial](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/nocodb-database-platform/README.md)
   - intents: architecture-deep-dive
-- [PostgreSQL Query Planner Deep Dive](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/postgresql-query-planner/index.md)
+- [PostgreSQL Query Planner Deep Dive](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/postgresql-query-planner/README.md)
   - intents: architecture-deep-dive
-- [SiYuan Tutorial: Privacy-First Knowledge Management](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/siyuan-tutorial/index.md)
+- [SiYuan Tutorial: Privacy-First Knowledge Management](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/siyuan-tutorial/README.md)
   - intents: beginner-onboarding
-- [Teable: Deep Dive Tutorial](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/teable-database-platform/index.md)
+- [Teable: Deep Dive Tutorial](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/teable-database-platform/README.md)
   - intents: architecture-deep-dive
 
 ## general-software
 
 - tutorial_count: **16**
 
-- [Claude Task Master Tutorial: AI-Powered Task Management for Developers](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/claude-task-master-tutorial/index.md)
+- [Claude Task Master Tutorial: AI-Powered Task Management for Developers](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/claude-task-master-tutorial/README.md)
   - intents: general-learning
-- [DSPy Tutorial: Programming Language Models](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/dspy-tutorial/index.md)
+- [DSPy Tutorial: Programming Language Models](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/dspy-tutorial/README.md)
   - intents: general-learning
-- [Deer Flow Tutorial: Distributed Workflow Orchestration Platform](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/deer-flow-tutorial/index.md)
+- [Deer Flow Tutorial: Distributed Workflow Orchestration Platform](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/deer-flow-tutorial/README.md)
   - intents: general-learning
-- [Fabric Tutorial: Open-Source Framework for Augmenting Humans with AI](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/fabric-tutorial/index.md)
+- [Fabric Tutorial: Open-Source Framework for Augmenting Humans with AI](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/fabric-tutorial/README.md)
   - intents: general-learning
-- [Instructor Tutorial: Structured LLM Outputs](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/instructor-tutorial/index.md)
+- [Instructor Tutorial: Structured LLM Outputs](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/instructor-tutorial/README.md)
   - intents: general-learning
-- [Khoj AI: Deep Dive Tutorial](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/khoj-tutorial/index.md)
+- [Khoj AI: Deep Dive Tutorial](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/khoj-tutorial/README.md)
   - intents: architecture-deep-dive
-- [LLaMA-Factory Tutorial: Unified Framework for LLM Training and Fine-tuning](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/llama-factory-tutorial/index.md)
+- [LLaMA-Factory Tutorial: Unified Framework for LLM Training and Fine-tuning](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/llama-factory-tutorial/README.md)
   - intents: general-learning
-- [Langfuse Tutorial: LLM Observability, Evaluation, and Prompt Operations](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/langfuse-tutorial/index.md)
+- [Langfuse Tutorial: LLM Observability, Evaluation, and Prompt Operations](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/langfuse-tutorial/README.md)
   - intents: production-operations
-- [Liveblocks - Real-Time Collaboration Deep Dive](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/liveblocks-tutorial/index.md)
+- [Liveblocks - Real-Time Collaboration Deep Dive](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/liveblocks-tutorial/README.md)
   - intents: architecture-deep-dive
-- [OpenClaw: Deep Dive Tutorial](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/openclaw-tutorial/index.md)
+- [OpenClaw: Deep Dive Tutorial](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/openclaw-tutorial/README.md)
   - intents: architecture-deep-dive
-- [Outlines Tutorial: Structured Text Generation with LLMs](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/outlines-tutorial/index.md)
+- [Outlines Tutorial: Structured Text Generation with LLMs](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/outlines-tutorial/README.md)
   - intents: general-learning
-- [Perplexica Tutorial: AI-Powered Search Engine](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/perplexica-tutorial/index.md)
+- [Perplexica Tutorial: AI-Powered Search Engine](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/perplexica-tutorial/README.md)
   - intents: general-learning
-- [PhotoPrism Tutorial: AI-Powered Photos App](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/photoprism-tutorial/index.md)
+- [PhotoPrism Tutorial: AI-Powered Photos App](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/photoprism-tutorial/README.md)
   - intents: general-learning
-- [PostHog Tutorial: Open Source Product Analytics Platform](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/posthog-tutorial/index.md)
+- [PostHog Tutorial: Open Source Product Analytics Platform](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/posthog-tutorial/README.md)
   - intents: general-learning
-- [SillyTavern Tutorial: Advanced LLM Frontend for Power Users](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/sillytavern-tutorial/index.md)
+- [SillyTavern Tutorial: Advanced LLM Frontend for Power Users](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/sillytavern-tutorial/README.md)
   - intents: general-learning
-- [Whisper.cpp Tutorial: High-Performance Speech Recognition in C/C++](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/whisper-cpp-tutorial/index.md)
+- [Whisper.cpp Tutorial: High-Performance Speech Recognition in C/C++](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/whisper-cpp-tutorial/README.md)
   - intents: general-learning
 
 ## llm-infra-serving
 
 - tutorial_count: **4**
 
-- [LiteLLM Tutorial: Unified LLM Gateway and Routing Layer](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/litellm-tutorial/index.md)
+- [LiteLLM Tutorial: Unified LLM Gateway and Routing Layer](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/litellm-tutorial/README.md)
   - intents: production-operations
-- [LocalAI Tutorial: Self-Hosted OpenAI Alternative](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/localai-tutorial/index.md)
+- [LocalAI Tutorial: Self-Hosted OpenAI Alternative](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/localai-tutorial/README.md)
   - intents: general-learning
-- [llama.cpp Tutorial: Local LLM Inference](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/llama-cpp-tutorial/index.md)
+- [llama.cpp Tutorial: Local LLM Inference](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/llama-cpp-tutorial/README.md)
   - intents: general-learning
-- [vLLM Tutorial: High-Performance LLM Inference](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/vllm-tutorial/index.md)
+- [vLLM Tutorial: High-Performance LLM Inference](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/vllm-tutorial/README.md)
   - intents: general-learning
 
 ## mcp-ecosystem
 
 - tutorial_count: **37**
 
-- [Anthropic API Tutorial: Build Production Apps with Claude](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/anthropic-code-tutorial/index.md)
+- [Anthropic API Tutorial: Build Production Apps with Claude](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/anthropic-code-tutorial/README.md)
   - intents: production-operations, mcp-integration
-- [Awesome MCP Servers Tutorial: Curating and Operating High-Signal MCP Integrations](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/awesome-mcp-servers-tutorial/index.md)
+- [Awesome MCP Servers Tutorial: Curating and Operating High-Signal MCP Integrations](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/awesome-mcp-servers-tutorial/README.md)
   - intents: tool-selection, mcp-integration
-- [Cherry Studio Tutorial: Multi-Provider AI Desktop Workspace for Teams](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/cherry-studio-tutorial/index.md)
+- [Cherry Studio Tutorial: Multi-Provider AI Desktop Workspace for Teams](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/cherry-studio-tutorial/README.md)
   - intents: beginner-onboarding, mcp-integration
-- [Claude Flow Tutorial: Multi-Agent Orchestration, MCP Tooling, and V3 Module Architecture](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/claude-flow-tutorial/index.md)
+- [Claude Flow Tutorial: Multi-Agent Orchestration, MCP Tooling, and V3 Module Architecture](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/claude-flow-tutorial/README.md)
   - intents: architecture-deep-dive, mcp-integration
-- [Composio Tutorial: Production Tool and Authentication Infrastructure for AI Agents](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/composio-tutorial/index.md)
+- [Composio Tutorial: Production Tool and Authentication Infrastructure for AI Agents](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/composio-tutorial/README.md)
   - intents: production-operations, mcp-integration
-- [Create Python Server Tutorial: Scaffold and Ship MCP Servers with uvx](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/create-python-server-tutorial/index.md)
+- [Create Python Server Tutorial: Scaffold and Ship MCP Servers with uvx](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/create-python-server-tutorial/README.md)
   - intents: mcp-integration
-- [Create TypeScript Server Tutorial: Scaffold MCP Servers with TypeScript Templates](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/create-typescript-server-tutorial/index.md)
+- [Create TypeScript Server Tutorial: Scaffold MCP Servers with TypeScript Templates](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/create-typescript-server-tutorial/README.md)
   - intents: mcp-integration
-- [FastMCP Tutorial: Building and Operating MCP Servers with Pythonic Control](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/fastmcp-tutorial/index.md)
+- [FastMCP Tutorial: Building and Operating MCP Servers with Pythonic Control](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/fastmcp-tutorial/README.md)
   - intents: production-operations, architecture-deep-dive, mcp-integration
-- [Firecrawl MCP Server Tutorial: Web Scraping and Search Tools for MCP Clients](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/firecrawl-mcp-server-tutorial/index.md)
+- [Firecrawl MCP Server Tutorial: Web Scraping and Search Tools for MCP Clients](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/firecrawl-mcp-server-tutorial/README.md)
   - intents: mcp-integration
-- [GenAI Toolbox Tutorial: MCP-First Database Tooling with Config-Driven Control Planes](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/genai-toolbox-tutorial/index.md)
+- [GenAI Toolbox Tutorial: MCP-First Database Tooling with Config-Driven Control Planes](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/genai-toolbox-tutorial/README.md)
   - intents: beginner-onboarding, production-operations, mcp-integration
-- [MCP C# SDK Tutorial: Production MCP in .NET with Hosting, ASP.NET Core, and Task Workflows](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-csharp-sdk-tutorial/index.md)
+- [MCP C# SDK Tutorial: Production MCP in .NET with Hosting, ASP.NET Core, and Task Workflows](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-csharp-sdk-tutorial/README.md)
   - intents: production-operations, mcp-integration
-- [MCP Chrome Tutorial: Control Your Real Chrome Browser Through MCP](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-chrome-tutorial/index.md)
+- [MCP Chrome Tutorial: Control Your Real Chrome Browser Through MCP](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-chrome-tutorial/README.md)
   - intents: mcp-integration
-- [MCP Docs Repo Tutorial: Navigating the Archived MCP Documentation Repository](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-docs-repo-tutorial/index.md)
+- [MCP Docs Repo Tutorial: Navigating the Archived MCP Documentation Repository](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-docs-repo-tutorial/README.md)
   - intents: mcp-integration
-- [MCP Ext Apps Tutorial: Building Interactive MCP Apps and Hosts](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-ext-apps-tutorial/index.md)
+- [MCP Ext Apps Tutorial: Building Interactive MCP Apps and Hosts](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-ext-apps-tutorial/README.md)
   - intents: mcp-integration
-- [MCP Go SDK Tutorial: Building Robust MCP Clients and Servers in Go](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-go-sdk-tutorial/index.md)
+- [MCP Go SDK Tutorial: Building Robust MCP Clients and Servers in Go](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-go-sdk-tutorial/README.md)
   - intents: production-operations, mcp-integration
-- [MCP Inspector Tutorial: Debugging and Validating MCP Servers](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-inspector-tutorial/index.md)
+- [MCP Inspector Tutorial: Debugging and Validating MCP Servers](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-inspector-tutorial/README.md)
   - intents: mcp-integration
-- [MCP Java SDK Tutorial: Building MCP Clients and Servers with Reactor, Servlet, and Spring](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-java-sdk-tutorial/index.md)
+- [MCP Java SDK Tutorial: Building MCP Clients and Servers with Reactor, Servlet, and Spring](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-java-sdk-tutorial/README.md)
   - intents: production-operations, mcp-integration
-- [MCP Kotlin SDK Tutorial: Building Multiplatform MCP Clients and Servers](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-kotlin-sdk-tutorial/index.md)
+- [MCP Kotlin SDK Tutorial: Building Multiplatform MCP Clients and Servers](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-kotlin-sdk-tutorial/README.md)
   - intents: production-operations, mcp-integration
-- [MCP PHP SDK Tutorial: Building MCP Servers in PHP with Discovery and Transport Flexibility](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-php-sdk-tutorial/index.md)
+- [MCP PHP SDK Tutorial: Building MCP Servers in PHP with Discovery and Transport Flexibility](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-php-sdk-tutorial/README.md)
   - intents: mcp-integration
-- [MCP Python SDK Tutorial: Building AI Tool Servers](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-python-sdk-tutorial/index.md)
+- [MCP Python SDK Tutorial: Building AI Tool Servers](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-python-sdk-tutorial/README.md)
   - intents: mcp-integration
-- [MCP Quickstart Resources Tutorial: Cross-Language MCP Servers and Clients by Example](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-quickstart-resources-tutorial/index.md)
+- [MCP Quickstart Resources Tutorial: Cross-Language MCP Servers and Clients by Example](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-quickstart-resources-tutorial/README.md)
   - intents: mcp-integration
-- [MCP Registry Tutorial: Publishing, Discovery, and Governance for MCP Servers](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-registry-tutorial/index.md)
+- [MCP Registry Tutorial: Publishing, Discovery, and Governance for MCP Servers](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-registry-tutorial/README.md)
   - intents: production-operations, mcp-integration
-- [MCP Ruby SDK Tutorial: Building MCP Servers and Clients in Ruby](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-ruby-sdk-tutorial/index.md)
+- [MCP Ruby SDK Tutorial: Building MCP Servers and Clients in Ruby](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-ruby-sdk-tutorial/README.md)
   - intents: production-operations, mcp-integration
-- [MCP Rust SDK Tutorial: Building High-Performance MCP Services with RMCP](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-rust-sdk-tutorial/index.md)
+- [MCP Rust SDK Tutorial: Building High-Performance MCP Services with RMCP](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-rust-sdk-tutorial/README.md)
   - intents: production-operations, mcp-integration
-- [MCP Servers Tutorial: Reference Implementations and Patterns](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-servers-tutorial/index.md)
+- [MCP Servers Tutorial: Reference Implementations and Patterns](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-servers-tutorial/README.md)
   - intents: production-operations, mcp-integration
 - ... plus 12 more tutorials in this cluster
 
@@ -249,41 +249,41 @@ Auto-generated topical clusters to strengthen internal linking and query-to-tuto
 
 - tutorial_count: **7**
 
-- [ChromaDB Tutorial: Building AI-Native Vector Databases](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/chroma-tutorial/index.md)
+- [ChromaDB Tutorial: Building AI-Native Vector Databases](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/chroma-tutorial/README.md)
   - intents: rag-implementation
-- [Haystack: Deep Dive Tutorial](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/haystack-tutorial/index.md)
+- [Haystack: Deep Dive Tutorial](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/haystack-tutorial/README.md)
   - intents: production-operations, architecture-deep-dive, rag-implementation
-- [LanceDB Tutorial: Serverless Vector Database for AI](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/lancedb-tutorial/index.md)
+- [LanceDB Tutorial: Serverless Vector Database for AI](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/lancedb-tutorial/README.md)
   - intents: architecture-deep-dive, rag-implementation
-- [LlamaIndex Tutorial: Building Advanced RAG Systems and Data Frameworks](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/llamaindex-tutorial/index.md)
+- [LlamaIndex Tutorial: Building Advanced RAG Systems and Data Frameworks](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/llamaindex-tutorial/README.md)
   - intents: rag-implementation
-- [Ollama Tutorial: Running and Serving LLMs Locally](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/ollama-tutorial/index.md)
+- [Ollama Tutorial: Running and Serving LLMs Locally](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/ollama-tutorial/README.md)
   - intents: production-operations, rag-implementation
-- [Quivr Tutorial: Open-Source RAG Framework for Document Ingestion](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/quivr-tutorial/index.md)
+- [Quivr Tutorial: Open-Source RAG Framework for Document Ingestion](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/quivr-tutorial/README.md)
   - intents: rag-implementation
-- [RAGFlow Tutorial: Complete Guide to Open-Source RAG Engine](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/ragflow-tutorial/index.md)
+- [RAGFlow Tutorial: Complete Guide to Open-Source RAG Engine](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/ragflow-tutorial/README.md)
   - intents: rag-implementation
 
 ## systems-and-internals
 
 - tutorial_count: **3**
 
-- [Kubernetes Operator Patterns: Building Production-Grade Controllers](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/kubernetes-operator-patterns/index.md)
+- [Kubernetes Operator Patterns: Building Production-Grade Controllers](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/kubernetes-operator-patterns/README.md)
   - intents: production-operations
-- [Obsidian Outliner Plugin: Deep Dive Tutorial](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/obsidian-outliner-plugin/index.md)
+- [Obsidian Outliner Plugin: Deep Dive Tutorial](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/obsidian-outliner-plugin/README.md)
   - intents: architecture-deep-dive
-- [React Fiber Internals](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/react-fiber-internals/index.md)
+- [React Fiber Internals](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/react-fiber-internals/README.md)
   - intents: architecture-deep-dive
 
 ## taskade-ecosystem
 
 - tutorial_count: **4**
 
-- [Taskade Awesome Vibe Coding Tutorial: Curating the 2026 AI-Building Landscape](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/taskade-awesome-vibe-coding-tutorial/index.md)
+- [Taskade Awesome Vibe Coding Tutorial: Curating the 2026 AI-Building Landscape](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/taskade-awesome-vibe-coding-tutorial/README.md)
   - intents: tool-selection
-- [Taskade Docs Tutorial: Operating the Living-DNA Documentation Stack](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/taskade-docs-tutorial/index.md)
+- [Taskade Docs Tutorial: Operating the Living-DNA Documentation Stack](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/taskade-docs-tutorial/README.md)
   - intents: general-learning
-- [Taskade MCP Tutorial: OpenAPI-Driven MCP Server for Taskade Workflows](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/taskade-mcp-tutorial/index.md)
+- [Taskade MCP Tutorial: OpenAPI-Driven MCP Server for Taskade Workflows](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/taskade-mcp-tutorial/README.md)
   - intents: general-learning
-- [Taskade Tutorial: AI-Native Workspace, Genesis, and Agentic Operations](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/taskade-tutorial/index.md)
+- [Taskade Tutorial: AI-Native Workspace, Genesis, and Agentic Operations](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/taskade-tutorial/README.md)
   - intents: production-operations
diff --git a/discoverability/tutorial-directory.md b/discoverability/tutorial-directory.md
index b647984b..defff988 100644
--- a/discoverability/tutorial-directory.md
+++ b/discoverability/tutorial-directory.md
@@ -7,448 +7,448 @@ This page is auto-generated from the tutorial index and is intended as a fast br
 
 ## A
 
-- [Activepieces Tutorial: Open-Source Automation, Pieces, and AI-Ready Workflow Operations](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/activepieces-tutorial/index.md)
+- [Activepieces Tutorial: Open-Source Automation, Pieces, and AI-Ready Workflow Operations](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/activepieces-tutorial/README.md)
   - Learn how to use activepieces/activepieces to build, run, and govern production automation workflows with open-source extensibility, piece development, API control, and self-hosted operations.
-- [ADK Python Tutorial: Production-Grade Agent Engineering with Google's ADK](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/adk-python-tutorial/index.md)
+- [ADK Python Tutorial: Production-Grade Agent Engineering with Google's ADK](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/adk-python-tutorial/README.md)
   - Learn how to use google/adk-python to build, evaluate, and deploy modular AI agent systems with strong tooling, session controls, and production rollouts.
-- [AG2 Tutorial: Next-Generation Multi-Agent Framework](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/ag2-tutorial/index.md)
+- [AG2 Tutorial: Next-Generation Multi-Agent Framework](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/ag2-tutorial/README.md)
   - Build collaborative AI agent systems with AG2, the community-driven successor to AutoGen.
-- [AgentGPT Tutorial: Building Autonomous AI Agents](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/agentgpt-tutorial/index.md)
+- [AgentGPT Tutorial: Building Autonomous AI Agents](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/agentgpt-tutorial/README.md)
   - A deep technical walkthrough of AgentGPT covering Building Autonomous AI Agents.
-- [AgenticSeek Tutorial: Local-First Autonomous Agent Operations](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/agenticseek-tutorial/index.md)
+- [AgenticSeek Tutorial: Local-First Autonomous Agent Operations](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/agenticseek-tutorial/README.md)
   - Learn how to use Fosowl/agenticSeek to run multi-agent planning, browsing, and coding workflows with local model support, Docker-first runtime defaults, and practical operator guardrails.
-- [AGENTS.md Tutorial: Open Standard for Coding-Agent Guidance in Repositories](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/agents-md-tutorial/index.md)
+- [AGENTS.md Tutorial: Open Standard for Coding-Agent Guidance in Repositories](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/agents-md-tutorial/README.md)
   - Learn how to use agentsmd/agents.md to define a clear, portable instruction contract for coding agents across projects and tools.
-- [Agno Tutorial: Multi-Agent Systems That Learn Over Time](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/agno-tutorial/index.md)
+- [Agno Tutorial: Multi-Agent Systems That Learn Over Time](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/agno-tutorial/README.md)
   - Learn how to build and operate learning multi-agent systems with agno-agi/agno, including memory, orchestration, AgentOS runtime, and production guardrails.
-- [Aider Tutorial: AI Pair Programming in Your Terminal](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/aider-tutorial/index.md)
+- [Aider Tutorial: AI Pair Programming in Your Terminal](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/aider-tutorial/README.md)
   - Learn to use Aider-AI/aider for real file edits, git-native workflows, model routing, and reliable day-to-day coding loops.
-- [Anthropic API Tutorial: Build Production Apps with Claude](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/anthropic-code-tutorial/index.md)
+- [Anthropic API Tutorial: Build Production Apps with Claude](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/anthropic-code-tutorial/README.md)
   - A practical guide to building with Anthropic's API and official SDKs, including messages, tools, vision, streaming, and production operations.
-- [Anthropic Skills Tutorial: Reusable AI Agent Capabilities](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/anthropic-skills-tutorial/index.md)
+- [Anthropic Skills Tutorial: Reusable AI Agent Capabilities](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/anthropic-skills-tutorial/README.md)
   - Build and operate production-quality skills for Claude Code, Claude.ai, and the Claude API.
-- [AnythingLLM Tutorial: Self-Hosted RAG and Agents Platform](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/anything-llm-tutorial/index.md)
+- [AnythingLLM Tutorial: Self-Hosted RAG and Agents Platform](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/anything-llm-tutorial/README.md)
   - Learn how to deploy and operate Mintplex-Labs/anything-llm for document-grounded chat, workspace management, agent workflows, and production use.
-- [Athens Research: Deep Dive Tutorial](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/athens-research-knowledge-graph/index.md)
+- [Athens Research: Deep Dive Tutorial](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/athens-research-knowledge-graph/README.md)
   - Athens Research — An open-source, Roam-like knowledge management system built with ClojureScript and graph databases.
-- [AutoAgent Tutorial: Zero-Code Agent Creation and Automated Workflow Orchestration](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/autoagent-tutorial/index.md)
+- [AutoAgent Tutorial: Zero-Code Agent Creation and Automated Workflow Orchestration](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/autoagent-tutorial/README.md)
   - Learn how to use HKUDS/AutoAgent to create and orchestrate LLM agents through natural-language workflows, with support for CLI operations, tool creation, and benchmark-oriented evaluation.
-- [Awesome Claude Code Tutorial: Curated Claude Code Resource Discovery and Evaluation](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/awesome-claude-code-tutorial/index.md)
+- [Awesome Claude Code Tutorial: Curated Claude Code Resource Discovery and Evaluation](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/awesome-claude-code-tutorial/README.md)
   - Learn how to use hesreallyhim/awesome-claude-code as a high-signal discovery and decision system for skills, commands, hooks, tooling, and CLAUDE.md patterns.
-- [Awesome Claude Skills Tutorial: High-Signal Skill Discovery and Reuse for Claude Workflows](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/awesome-claude-skills-tutorial/index.md)
+- [Awesome Claude Skills Tutorial: High-Signal Skill Discovery and Reuse for Claude Workflows](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/awesome-claude-skills-tutorial/README.md)
   - Learn how to use ComposioHQ/awesome-claude-skills to discover, evaluate, install, and contribute Claude skills for coding, automation, writing, and cross-app workflows.
-- [Awesome MCP Servers Tutorial: Curating and Operating High-Signal MCP Integrations](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/awesome-mcp-servers-tutorial/index.md)
+- [Awesome MCP Servers Tutorial: Curating and Operating High-Signal MCP Integrations](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/awesome-mcp-servers-tutorial/README.md)
   - Learn how to use punkpeye/awesome-mcp-servers as a practical control surface for discovering, vetting, and operating Model Context Protocol servers across coding, data, browser automation, and enterprise workflows.
-- [awslabs/mcp Tutorial: Operating a Large-Scale MCP Server Ecosystem for AWS Workloads](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/awslabs-mcp-tutorial/index.md)
+- [awslabs/mcp Tutorial: Operating a Large-Scale MCP Server Ecosystem for AWS Workloads](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/awslabs-mcp-tutorial/README.md)
   - Learn how to use awslabs/mcp to compose, run, and govern AWS-focused MCP servers across development, infrastructure, data, and operations workflows.
 
 ## B
 
-- [BabyAGI Tutorial: The Original Autonomous AI Task Agent Framework](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/babyagi-tutorial/index.md)
+- [BabyAGI Tutorial: The Original Autonomous AI Task Agent Framework](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/babyagi-tutorial/README.md)
   - Learn how to use yoheinakajima/babyagi for autonomous task generation, execution, and prioritization—the foundational agent loop that started the autonomous AI agent wave.
-- [Beads Tutorial: Git-Backed Task Graph Memory for Coding Agents](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/beads-tutorial/index.md)
+- [Beads Tutorial: Git-Backed Task Graph Memory for Coding Agents](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/beads-tutorial/README.md)
   - Learn how to use steveyegge/beads to give coding agents durable, dependency-aware task memory with structured issue graphs instead of ad-hoc markdown plans.
-- [BentoML Tutorial: Building Production-Ready ML Services](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/bentoml-tutorial/index.md)
+- [BentoML Tutorial: Building Production-Ready ML Services](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/bentoml-tutorial/README.md)
   - A deep technical walkthrough of BentoML covering Building Production-Ready ML Services.
-- [bolt.diy Tutorial: Build and Operate an Open Source AI App Builder](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/bolt-diy-tutorial/index.md)
+- [bolt.diy Tutorial: Build and Operate an Open Source AI App Builder](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/bolt-diy-tutorial/README.md)
   - A production-focused deep dive into stackblitz-labs/bolt.diy: architecture, provider routing, safe edit loops, MCP integrations, deployment choices, and operational governance.
-- [Botpress Tutorial: Open Source Conversational AI Platform](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/botpress-tutorial/index.md)
+- [Botpress Tutorial: Open Source Conversational AI Platform](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/botpress-tutorial/README.md)
   - This comprehensive tutorial will guide you through Botpress, a powerful open source platform for building conversational AI applications
-- [Browser Use Tutorial: AI-Powered Web Automation Agents](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/browser-use-tutorial/index.md)
+- [Browser Use Tutorial: AI-Powered Web Automation Agents](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/browser-use-tutorial/README.md)
   - Learn how to use browser-use/browser-use to build agents that can navigate websites, execute workflows, and run reliable browser automation in production.
 
 ## C
 
-- [Chatbox Tutorial: Building Modern AI Chat Interfaces](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/chatbox-tutorial/index.md)
+- [Chatbox Tutorial: Building Modern AI Chat Interfaces](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/chatbox-tutorial/README.md)
   - A deep technical walkthrough of Chatbox covering Building Modern AI Chat Interfaces.
-- [Cherry Studio Tutorial: Multi-Provider AI Desktop Workspace for Teams](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/cherry-studio-tutorial/index.md)
+- [Cherry Studio Tutorial: Multi-Provider AI Desktop Workspace for Teams](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/cherry-studio-tutorial/README.md)
   - Learn how to use CherryHQ/cherry-studio to run multi-provider AI workflows, manage assistants, and integrate MCP tools in a desktop-first productivity environment.
-- [ChromaDB Tutorial: Building AI-Native Vector Databases](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/chroma-tutorial/index.md)
+- [ChromaDB Tutorial: Building AI-Native Vector Databases](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/chroma-tutorial/README.md)
   - A deep technical walkthrough of ChromaDB covering Building AI-Native Vector Databases.
-- [Chrome DevTools MCP Tutorial: Browser Automation and Debugging for Coding Agents](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/chrome-devtools-mcp-tutorial/index.md)
+- [Chrome DevTools MCP Tutorial: Browser Automation and Debugging for Coding Agents](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/chrome-devtools-mcp-tutorial/README.md)
   - Learn how to use ChromeDevTools/chrome-devtools-mcp to give coding agents reliable browser control, performance tracing, and deep debugging capabilities.
-- [Cipher Tutorial: Shared Memory Layer for Coding Agents](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/cipher-tutorial/index.md)
+- [Cipher Tutorial: Shared Memory Layer for Coding Agents](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/cipher-tutorial/README.md)
   - Learn how to use campfirein/cipher as a memory-centric MCP-enabled layer that preserves and shares coding context across IDEs, agents, and teams.
-- [Claude Code Router Tutorial: Multi-Provider Routing and Control Plane for Claude Code](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/claude-code-router-tutorial/index.md)
+- [Claude Code Router Tutorial: Multi-Provider Routing and Control Plane for Claude Code](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/claude-code-router-tutorial/README.md)
   - Learn how to use musistudio/claude-code-router to route Claude Code workloads across multiple model providers with configurable routing rules, transformers, presets, and operational controls.
-- [Claude Code Tutorial: Agentic Coding from Your Terminal](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/claude-code-tutorial/index.md)
+- [Claude Code Tutorial: Agentic Coding from Your Terminal](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/claude-code-tutorial/README.md)
   - Learn how to use anthropics/claude-code for codebase understanding, multi-file edits, command execution, git workflows, and MCP-based extension.
-- [Claude Flow Tutorial: Multi-Agent Orchestration, MCP Tooling, and V3 Module Architecture](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/claude-flow-tutorial/index.md)
+- [Claude Flow Tutorial: Multi-Agent Orchestration, MCP Tooling, and V3 Module Architecture](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/claude-flow-tutorial/README.md)
   - Learn how to use ruvnet/claude-flow to orchestrate multi-agent workflows, operate MCP/CLI surfaces, and reason about V2-to-V3 architecture and migration tradeoffs.
-- [Claude-Mem Tutorial: Persistent Memory Compression for Claude Code](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/claude-mem-tutorial/index.md)
+- [Claude-Mem Tutorial: Persistent Memory Compression for Claude Code](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/claude-mem-tutorial/README.md)
   - Learn how to use thedotmack/claude-mem to capture, compress, and retrieve coding-session memory with hook-driven automation, searchable context layers, and operator controls.
-- [Claude Plugins Official Tutorial: Anthropic's Managed Plugin Directory](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/claude-plugins-official-tutorial/index.md)
+- [Claude Plugins Official Tutorial: Anthropic's Managed Plugin Directory](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/claude-plugins-official-tutorial/README.md)
   - Learn how to use anthropics/claude-plugins-official to discover, evaluate, install, and contribute Claude Code plugins with clear directory standards and plugin safety practices.
-- [Claude Quickstarts Tutorial: Production Integration Patterns](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/claude-quickstarts-tutorial/index.md)
+- [Claude Quickstarts Tutorial: Production Integration Patterns](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/claude-quickstarts-tutorial/README.md)
   - Learn from Anthropic's official quickstart projects to build deployable applications with Claude API, including customer support, data analysis, browser automation, and autonomous coding.
-- [Claude Squad Tutorial: Multi-Agent Terminal Session Orchestration](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/claude-squad-tutorial/index.md)
+- [Claude Squad Tutorial: Multi-Agent Terminal Session Orchestration](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/claude-squad-tutorial/README.md)
   - Learn how to use smtg-ai/claude-squad to run and manage multiple coding-agent sessions across isolated workspaces with tmux and git worktrees.
-- [Claude Task Master Tutorial: AI-Powered Task Management for Developers](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/claude-task-master-tutorial/index.md)
+- [Claude Task Master Tutorial: AI-Powered Task Management for Developers](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/claude-task-master-tutorial/README.md)
   - A deep technical walkthrough of Claude Task Master covering AI-Powered Task Management for Developers.
-- [ClickHouse Tutorial: High-Performance Analytical Database](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/clickhouse-tutorial/index.md)
+- [ClickHouse Tutorial: High-Performance Analytical Database](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/clickhouse-tutorial/README.md)
   - A deep technical walkthrough of ClickHouse covering High-Performance Analytical Database.
-- [Cline Tutorial: Agentic Coding with Human Control](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/cline-tutorial/index.md)
+- [Cline Tutorial: Agentic Coding with Human Control](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/cline-tutorial/README.md)
   - A practical engineering guide to cline/cline: install, operate, and govern Cline across local development and team environments.
-- [CodeMachine CLI Tutorial: Orchestrating Long-Running Coding Agent Workflows](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/codemachine-cli-tutorial/index.md)
+- [CodeMachine CLI Tutorial: Orchestrating Long-Running Coding Agent Workflows](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/codemachine-cli-tutorial/README.md)
   - Learn how to use moazbuilds/CodeMachine-CLI to orchestrate repeatable coding-agent workflows with multi-agent coordination, context control, and long-running execution.
-- [Codex Analysis Platform Tutorial: Build Code Intelligence Systems](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/codex-analysis-platform/index.md)
+- [Codex Analysis Platform Tutorial: Build Code Intelligence Systems](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/codex-analysis-platform/README.md)
   - Design and operate a production-grade code analysis platform with parsing, symbol resolution, code intelligence features, LSP integration, and rollout governance.
-- [Codex CLI Tutorial: Local Terminal Agent Workflows with OpenAI Codex](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/codex-cli-tutorial/index.md)
+- [Codex CLI Tutorial: Local Terminal Agent Workflows with OpenAI Codex](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/codex-cli-tutorial/README.md)
   - Learn how to use openai/codex to run a lightweight coding agent locally, with strong controls for auth, configuration, MCP integration, and sandboxed execution.
-- [ComfyUI Tutorial: Mastering AI Image Generation Workflows](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/comfyui-tutorial/index.md)
+- [ComfyUI Tutorial: Mastering AI Image Generation Workflows](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/comfyui-tutorial/README.md)
   - A deep technical walkthrough of ComfyUI covering Mastering AI Image Generation Workflows.
-- [Composio Tutorial: Production Tool and Authentication Infrastructure for AI Agents](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/composio-tutorial/index.md)
+- [Composio Tutorial: Production Tool and Authentication Infrastructure for AI Agents](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/composio-tutorial/README.md)
   - Learn how to use ComposioHQ/composio to connect agents to 800+ toolkits with session-aware discovery, robust authentication flows, provider integrations, MCP support, and event-trigger automation.
-- [Compound Engineering Plugin Tutorial: Compounding Agent Workflows Across Toolchains](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/compound-engineering-plugin-tutorial/index.md)
+- [Compound Engineering Plugin Tutorial: Compounding Agent Workflows Across Toolchains](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/compound-engineering-plugin-tutorial/README.md)
   - Learn how to use EveryInc/compound-engineering-plugin to run compound engineering workflows in Claude Code and convert plugin assets for other coding-agent ecosystems.
-- [Context7 Tutorial: Live Documentation Context for Coding Agents](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/context7-tutorial/index.md)
+- [Context7 Tutorial: Live Documentation Context for Coding Agents](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/context7-tutorial/README.md)
   - Learn how to use upstash/context7 to inject up-to-date, version-aware library docs into Claude Code, Cursor, and other MCP-capable coding agents.
-- [Continue Tutorial: Open-Source AI Coding Agents for IDE and CLI](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/continue-tutorial/index.md)
+- [Continue Tutorial: Open-Source AI Coding Agents for IDE and CLI](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/continue-tutorial/README.md)
   - A practical guide to continuedev/continue, covering IDE usage, headless/CLI workflows, model configuration, team collaboration, and enterprise operations.
-- [CopilotKit Tutorial: Building AI Copilots for React Applications](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/copilotkit-tutorial/index.md)
+- [CopilotKit Tutorial: Building AI Copilots for React Applications](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/copilotkit-tutorial/README.md)
   - Create in-app AI assistants, chatbots, and agentic UIs with the open-source CopilotKit framework.
-- [Create Python Server Tutorial: Scaffold and Ship MCP Servers with uvx](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/create-python-server-tutorial/index.md)
+- [Create Python Server Tutorial: Scaffold and Ship MCP Servers with uvx](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/create-python-server-tutorial/README.md)
   - Learn how to use modelcontextprotocol/create-python-server to scaffold Python MCP servers with minimal setup, template-driven primitives, and publish-ready packaging workflows.
-- [Create TypeScript Server Tutorial: Scaffold MCP Servers with TypeScript Templates](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/create-typescript-server-tutorial/index.md)
+- [Create TypeScript Server Tutorial: Scaffold MCP Servers with TypeScript Templates](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/create-typescript-server-tutorial/README.md)
   - Learn how to use modelcontextprotocol/create-typescript-server to scaffold MCP server projects quickly, understand generated template structure, and operate build/debug workflows safely in archived-tooling environments.
-- [CrewAI Tutorial: Building Collaborative AI Agent Teams](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/crewai-tutorial/index.md)
+- [CrewAI Tutorial: Building Collaborative AI Agent Teams](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/crewai-tutorial/README.md)
   - CrewAI View Repo is a framework for orchestrating role-based AI agent teams that collaborate to accomplish complex tasks. It provides a structured approach to creating AI crews with specialized agents, tools, and processes, enabling sophisticated multi-agent workflows and collaborative problem-solving.
-- [Crush Tutorial: Multi-Model Terminal Coding Agent with Strong Extensibility](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/crush-tutorial/index.md)
+- [Crush Tutorial: Multi-Model Terminal Coding Agent with Strong Extensibility](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/crush-tutorial/README.md)
   - Learn how to use charmbracelet/crush for terminal-native coding workflows with flexible model providers, LSP/MCP integrations, and production-grade controls.
 
 ## D
 
-- [Daytona Tutorial: Secure Sandbox Infrastructure for AI-Generated Code](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/daytona-tutorial/index.md)
+- [Daytona Tutorial: Secure Sandbox Infrastructure for AI-Generated Code](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/daytona-tutorial/README.md)
   - Learn how to use daytonaio/daytona to run AI-generated code in isolated sandboxes, integrate coding agents through MCP, and operate sandbox infrastructure with stronger security and resource controls.
-- [Deer Flow Tutorial: Distributed Workflow Orchestration Platform](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/deer-flow-tutorial/index.md)
+- [Deer Flow Tutorial: Distributed Workflow Orchestration Platform](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/deer-flow-tutorial/README.md)
   - Orchestrate complex distributed workflows with Deer Flow's powerful task coordination and execution platform.
-- [Devika Tutorial: Open-Source Autonomous AI Software Engineer](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/devika-tutorial/index.md)
+- [Devika Tutorial: Open-Source Autonomous AI Software Engineer](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/devika-tutorial/README.md)
   - Learn how to deploy and operate stitionai/devika — a multi-agent autonomous coding system that plans, researches, writes, and debugs code end-to-end.
-- [Dify Platform: Deep Dive Tutorial](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/dify-platform-deep-dive/index.md)
+- [Dify Platform: Deep Dive Tutorial](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/dify-platform-deep-dive/README.md)
   - Dify — An open-source LLM application development platform for building workflows, RAG pipelines, and AI agents with a visual interface.
-- [DSPy Tutorial: Programming Language Models](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/dspy-tutorial/index.md)
+- [DSPy Tutorial: Programming Language Models](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/dspy-tutorial/README.md)
   - Learn to program language models declaratively with DSPy, the Stanford NLP framework for systematic prompt optimization and modular LLM pipelines.
-- [Dyad Tutorial: Local-First AI App Building](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/dyad-tutorial/index.md)
+- [Dyad Tutorial: Local-First AI App Building](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/dyad-tutorial/README.md)
   - A practical guide to dyad-sh/dyad, focused on local-first app generation, integration patterns, validation loops, and deployment readiness.
 
 ## E
 
-- [ElizaOS: Deep Dive Tutorial](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/elizaos-tutorial/index.md)
+- [ElizaOS: Deep Dive Tutorial](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/elizaos-tutorial/README.md)
   - ElizaOS — Autonomous agents for everyone.
-- [Everything Claude Code Tutorial: Production Configuration Patterns for Claude Code](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/everything-claude-code-tutorial/index.md)
+- [Everything Claude Code Tutorial: Production Configuration Patterns for Claude Code](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/everything-claude-code-tutorial/README.md)
   - Learn how to use affaan-m/everything-claude-code to adopt battle-tested Claude Code agents, skills, hooks, commands, rules, and MCP workflows in a structured, production-oriented way.
 
 ## F
 
-- [Fabric Tutorial: Open-Source Framework for Augmenting Humans with AI](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/fabric-tutorial/index.md)
+- [Fabric Tutorial: Open-Source Framework for Augmenting Humans with AI](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/fabric-tutorial/README.md)
   - Enhance human capabilities with Fabric's modular framework for AI-powered cognitive assistance and task automation.
-- [FastMCP Tutorial: Building and Operating MCP Servers with Pythonic Control](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/fastmcp-tutorial/index.md)
+- [FastMCP Tutorial: Building and Operating MCP Servers with Pythonic Control](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/fastmcp-tutorial/README.md)
   - Learn how to use jlowin/fastmcp to design, run, test, and deploy MCP servers and clients with practical transport, integration, auth, and operations patterns.
-- [Figma Context MCP Tutorial: Design-to-Code Workflows for Coding Agents](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/figma-context-mcp-tutorial/index.md)
+- [Figma Context MCP Tutorial: Design-to-Code Workflows for Coding Agents](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/figma-context-mcp-tutorial/README.md)
   - Learn how to use GLips/Figma-Context-MCP (Framelink MCP for Figma) to give coding agents structured design context for higher-fidelity implementation.
-- [Firecrawl MCP Server Tutorial: Web Scraping and Search Tools for MCP Clients](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/firecrawl-mcp-server-tutorial/index.md)
+- [Firecrawl MCP Server Tutorial: Web Scraping and Search Tools for MCP Clients](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/firecrawl-mcp-server-tutorial/README.md)
   - Learn how to use firecrawl/firecrawl-mcp-server to add robust web scraping, crawling, search, and extraction capabilities to MCP-enabled coding and research agents.
-- [Firecrawl Tutorial: Building LLM-Ready Web Scraping and Data Extraction Systems](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/firecrawl-tutorial/index.md)
+- [Firecrawl Tutorial: Building LLM-Ready Web Scraping and Data Extraction Systems](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/firecrawl-tutorial/README.md)
   - Deep technical walkthrough of Firecrawl Tutorial: Building LLM-Ready Web Scraping and Data Extraction Systems.
-- [Fireproof Tutorial: Local-First Document Database for AI-Native Apps](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/fireproof-tutorial/index.md)
+- [Fireproof Tutorial: Local-First Document Database for AI-Native Apps](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/fireproof-tutorial/README.md)
   - Learn how to use fireproof-storage/fireproof to build local-first, encrypted, sync-capable applications with a unified browser/Node/Deno API and React hooks.
-- [Flowise LLM Orchestration: Deep Dive Tutorial](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/flowise-llm-orchestration/index.md)
+- [Flowise LLM Orchestration: Deep Dive Tutorial](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/flowise-llm-orchestration/README.md)
   - Flowise — An open-source visual tool for building LLM workflows with a drag-and-drop interface.
 
 ## G
 
-- [GitHub Copilot CLI Tutorial: Copilot Agent Workflows in the Terminal](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/copilot-cli-tutorial/index.md)
+- [GitHub Copilot CLI Tutorial: Copilot Agent Workflows in the Terminal](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/copilot-cli-tutorial/README.md)
   - Learn how to use github/copilot-cli to run Copilot's coding agent directly from the terminal with GitHub-native context, approval controls, and extensibility through MCP and LSP.
-- [Gemini CLI Tutorial: Terminal-First Agent Workflows with Google Gemini](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/gemini-cli-tutorial/index.md)
+- [Gemini CLI Tutorial: Terminal-First Agent Workflows with Google Gemini](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/gemini-cli-tutorial/README.md)
   - Learn how to use google-gemini/gemini-cli to run coding and operations workflows in terminal-first loops with strong tooling, MCP extensibility, headless automation, and safety controls.
-- [GenAI Toolbox Tutorial: MCP-First Database Tooling with Config-Driven Control Planes](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/genai-toolbox-tutorial/index.md)
+- [GenAI Toolbox Tutorial: MCP-First Database Tooling with Config-Driven Control Planes](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/genai-toolbox-tutorial/README.md)
   - Learn how to use googleapis/genai-toolbox to expose database tools through MCP and native SDK paths, with stronger configuration discipline, deployment options, and observability controls.
-- [GitHub MCP Server Tutorial: Production GitHub Operations Through MCP](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/github-mcp-server-tutorial/index.md)
+- [GitHub MCP Server Tutorial: Production GitHub Operations Through MCP](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/github-mcp-server-tutorial/README.md)
   - Learn how to use github/github-mcp-server to connect coding agents directly to repositories, issues, pull requests, actions, and code security workflows with stronger control.
-- [Goose Tutorial: Extensible Open-Source AI Agent for Real Engineering Work](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/goose-tutorial/index.md)
+- [Goose Tutorial: Extensible Open-Source AI Agent for Real Engineering Work](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/goose-tutorial/README.md)
   - Learn how to use block/goose to automate coding workflows with controlled tool execution, strong provider flexibility, and production-ready operations.
-- [GPT Open Source: Deep Dive Tutorial](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/gpt-oss-tutorial/index.md)
+- [GPT Open Source: Deep Dive Tutorial](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/gpt-oss-tutorial/README.md)
   - A comprehensive guide to understanding, building, and deploying open-source GPT implementations -- from nanoGPT to GPT-NeoX and beyond.
-- [gptme Tutorial: Open-Source Terminal Agent for Local Tool-Driven Work](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/gptme-tutorial/index.md)
+- [gptme Tutorial: Open-Source Terminal Agent for Local Tool-Driven Work](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/gptme-tutorial/README.md)
   - Learn how to use gptme/gptme to run a local-first coding and knowledge-work agent with strong CLI ergonomics, extensible tools, and automation-friendly modes.
 
 ## H
 
-- [HAPI Tutorial: Remote Control for Local AI Coding Sessions](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/hapi-tutorial/index.md)
+- [HAPI Tutorial: Remote Control for Local AI Coding Sessions](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/hapi-tutorial/README.md)
   - Learn tiann/hapi, a local-first hub that lets you run Claude Code/Codex/Gemini/OpenCode sessions locally while controlling and approving them remotely.
-- [Haystack: Deep Dive Tutorial](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/haystack-tutorial/index.md)
+- [Haystack: Deep Dive Tutorial](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/haystack-tutorial/README.md)
   - Haystack — An open-source framework for building production-ready LLM applications, RAG pipelines, and intelligent search systems.
-- [HuggingFace Transformers Tutorial: Building State-of-the-Art AI Models](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/huggingface-tutorial/index.md)
+- [HuggingFace Transformers Tutorial: Building State-of-the-Art AI Models](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/huggingface-tutorial/README.md)
   - A deep technical walkthrough of HuggingFace Transformers covering Building State-of-the-Art AI Models.
-- [HumanLayer Tutorial: Context Engineering and Human-Governed Coding Agents](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/humanlayer-tutorial/index.md)
+- [HumanLayer Tutorial: Context Engineering and Human-Governed Coding Agents](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/humanlayer-tutorial/README.md)
   - Learn how to use humanlayer/humanlayer patterns to orchestrate coding agents with stronger context control, human oversight, and team-scale workflows.
 
 ## I
 
-- [Instructor Tutorial: Structured LLM Outputs](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/instructor-tutorial/index.md)
+- [Instructor Tutorial: Structured LLM Outputs](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/instructor-tutorial/README.md)
   - Get reliable, typed responses from LLMs with Pydantic validation.
 
 ## K
 
-- [Khoj AI: Deep Dive Tutorial](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/khoj-tutorial/index.md)
+- [Khoj AI: Deep Dive Tutorial](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/khoj-tutorial/README.md)
   - Khoj — An open-source, self-hostable AI personal assistant that connects to your notes, documents, and online data.
-- [Kilo Code Tutorial: Agentic Engineering from IDE and CLI Surfaces](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/kilocode-tutorial/index.md)
+- [Kilo Code Tutorial: Agentic Engineering from IDE and CLI Surfaces](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/kilocode-tutorial/README.md)
   - Learn how to use Kilo-Org/kilocode for high-throughput coding workflows with multi-mode operation, agent-loop controls, and extensible CLI/IDE integration.
-- [Kimi CLI Tutorial: Multi-Mode Terminal Agent with MCP and ACP](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/kimi-cli-tutorial/index.md)
+- [Kimi CLI Tutorial: Multi-Mode Terminal Agent with MCP and ACP](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/kimi-cli-tutorial/README.md)
   - Learn how to use MoonshotAI/kimi-cli to run an interactive terminal coding agent with configurable modes, MCP integrations, and ACP-based IDE connectivity.
-- [Kiro Tutorial: Spec-Driven Agentic IDE from AWS](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/kiro-tutorial/index.md)
+- [Kiro Tutorial: Spec-Driven Agentic IDE from AWS](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/kiro-tutorial/README.md)
   - Learn how to use kirodotdev/Kiro for structured AI-powered development with spec-driven workflows, agent steering, event-driven automation, and AWS-native integrations.
-- [Kubernetes Operator Patterns: Building Production-Grade Controllers](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/kubernetes-operator-patterns/index.md)
+- [Kubernetes Operator Patterns: Building Production-Grade Controllers](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/kubernetes-operator-patterns/README.md)
   - Master Kubernetes Operators with hands-on Go implementation using the Operator SDK and controller-runtime library for enterprise application management.
 
 ## L
 
-- [LanceDB Tutorial: Serverless Vector Database for AI](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/lancedb-tutorial/index.md)
+- [LanceDB Tutorial: Serverless Vector Database for AI](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/lancedb-tutorial/README.md)
   - Master LanceDB, the open-source serverless vector database designed for AI applications, RAG systems, and semantic search.
-- [LangChain Architecture: Internal Design Deep Dive](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/langchain-architecture-guide/index.md)
+- [LangChain Architecture: Internal Design Deep Dive](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/langchain-architecture-guide/README.md)
   - Deep technical walkthrough of LangChain Architecture: Internal Design Deep Dive.
-- [LangChain Tutorial: Building AI Applications with Large Language Models](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/langchain-tutorial/index.md)
+- [LangChain Tutorial: Building AI Applications with Large Language Models](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/langchain-tutorial/README.md)
   - Pydantic 2 Required: LangChain v0.3 fully migrated to Pydantic 2. Code using langchain_core.pydantic_v1 should be updated to native Pydantic 2 syntax.
-- [Langflow Tutorial: Visual AI Agent and Workflow Platform](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/langflow-tutorial/index.md)
+- [Langflow Tutorial: Visual AI Agent and Workflow Platform](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/langflow-tutorial/README.md)
   - Learn how to build, deploy, and operate agent workflows with langflow-ai/langflow, including visual flow composition, API/MCP deployment, and production reliability controls.
-- [Langfuse Tutorial: LLM Observability, Evaluation, and Prompt Operations](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/langfuse-tutorial/index.md)
+- [Langfuse Tutorial: LLM Observability, Evaluation, and Prompt Operations](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/langfuse-tutorial/README.md)
   - Learn how to use langfuse/langfuse to trace, evaluate, and improve production LLM systems with structured observability workflows.
-- [LangGraph Tutorial: Building Stateful Multi-Actor Applications](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/langgraph-tutorial/index.md)
+- [LangGraph Tutorial: Building Stateful Multi-Actor Applications](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/langgraph-tutorial/README.md)
   - A deep technical walkthrough of LangGraph covering Building Stateful Multi-Actor Applications.
-- [Letta Tutorial: Stateful LLM Agents](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/letta-tutorial/index.md)
+- [Letta Tutorial: Stateful LLM Agents](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/letta-tutorial/README.md)
   - Build AI agents with persistent memory using the framework formerly known as MemGPT.
-- [LiteLLM Tutorial: Unified LLM Gateway and Routing Layer](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/litellm-tutorial/index.md)
+- [LiteLLM Tutorial: Unified LLM Gateway and Routing Layer](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/litellm-tutorial/README.md)
   - Build provider-agnostic LLM applications with BerriAI/litellm, including routing, fallbacks, proxy deployment, and cost-aware operations.
-- [Liveblocks - Real-Time Collaboration Deep Dive](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/liveblocks-tutorial/index.md)
+- [Liveblocks - Real-Time Collaboration Deep Dive](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/liveblocks-tutorial/README.md)
   - Deep technical walkthrough of Liveblocks - Real-Time Collaboration Deep Dive.
-- [llama.cpp Tutorial: Local LLM Inference](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/llama-cpp-tutorial/index.md)
+- [llama.cpp Tutorial: Local LLM Inference](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/llama-cpp-tutorial/README.md)
   - Run large language models efficiently on your local machine with pure C/C++.
-- [LLaMA-Factory Tutorial: Unified Framework for LLM Training and Fine-tuning](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/llama-factory-tutorial/index.md)
+- [LLaMA-Factory Tutorial: Unified Framework for LLM Training and Fine-tuning](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/llama-factory-tutorial/README.md)
   - A deep technical walkthrough of LLaMA-Factory covering Unified Framework for LLM Training and Fine-tuning.
-- [LlamaIndex Tutorial: Building Advanced RAG Systems and Data Frameworks](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/llamaindex-tutorial/index.md)
+- [LlamaIndex Tutorial: Building Advanced RAG Systems and Data Frameworks](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/llamaindex-tutorial/README.md)
   - A deep technical walkthrough of LlamaIndex covering Building Advanced RAG Systems and Data Frameworks.
-- [LobeChat AI Platform: Deep Dive Tutorial](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/lobechat-ai-platform/index.md)
+- [LobeChat AI Platform: Deep Dive Tutorial](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/lobechat-ai-platform/README.md)
   - LobeChat — An open-source, modern-design AI chat framework for building private LLM applications.
-- [LocalAI Tutorial: Self-Hosted OpenAI Alternative](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/localai-tutorial/index.md)
+- [LocalAI Tutorial: Self-Hosted OpenAI Alternative](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/localai-tutorial/README.md)
   - Run LLMs, image generation, and audio models locally with an OpenAI-compatible API.
-- [Logseq: Deep Dive Tutorial](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/logseq-knowledge-management/index.md)
+- [Logseq: Deep Dive Tutorial](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/logseq-knowledge-management/README.md)
   - Logseq — A privacy-first, local-first knowledge management platform with block-based editing and graph visualization.
 
 ## M
 
-- [Microsoft AutoGen Tutorial: Building Multi-Agent AI Systems](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/autogen-tutorial/index.md)
+- [Microsoft AutoGen Tutorial: Building Multi-Agent AI Systems](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/autogen-tutorial/README.md)
   - A deep technical walkthrough of Microsoft AutoGen covering Building Multi-Agent AI Systems.
-- [Mastra Tutorial: TypeScript Framework for AI Agents and Workflows](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mastra-tutorial/index.md)
+- [Mastra Tutorial: TypeScript Framework for AI Agents and Workflows](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mastra-tutorial/README.md)
   - Learn how to build production AI applications with mastra-ai/mastra, including agents, workflows, memory, MCP tooling, and reliability operations.
-- [MCP Chrome Tutorial: Control Your Real Chrome Browser Through MCP](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-chrome-tutorial/index.md)
+- [MCP Chrome Tutorial: Control Your Real Chrome Browser Through MCP](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-chrome-tutorial/README.md)
   - Learn how to use hangwin/mcp-chrome to expose browser automation, content analysis, and semantic tab search tools to MCP clients.
-- [MCP C# SDK Tutorial: Production MCP in .NET with Hosting, ASP.NET Core, and Task Workflows](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-csharp-sdk-tutorial/index.md)
+- [MCP C# SDK Tutorial: Production MCP in .NET with Hosting, ASP.NET Core, and Task Workflows](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-csharp-sdk-tutorial/README.md)
   - Learn how to build and operate MCP clients and servers with modelcontextprotocol/csharp-sdk, including package choices, auth patterns, tasks, diagnostics, and versioning strategy.
-- [MCP Docs Repo Tutorial: Navigating the Archived MCP Documentation Repository](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-docs-repo-tutorial/index.md)
+- [MCP Docs Repo Tutorial: Navigating the Archived MCP Documentation Repository](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-docs-repo-tutorial/README.md)
   - Learn how to use modelcontextprotocol/docs as an archived reference, map its conceptual guides, and migrate documentation workflows to the canonical modelcontextprotocol/modelcontextprotocol docs location.
-- [MCP Ext Apps Tutorial: Building Interactive MCP Apps and Hosts](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-ext-apps-tutorial/index.md)
+- [MCP Ext Apps Tutorial: Building Interactive MCP Apps and Hosts](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-ext-apps-tutorial/README.md)
   - Learn how to use modelcontextprotocol/ext-apps to build interactive MCP Apps, wire host bridges, secure UI resources, and run reliable testing and migration workflows.
-- [MCP Go SDK Tutorial: Building Robust MCP Clients and Servers in Go](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-go-sdk-tutorial/index.md)
+- [MCP Go SDK Tutorial: Building Robust MCP Clients and Servers in Go](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-go-sdk-tutorial/README.md)
   - Learn how to use modelcontextprotocol/go-sdk for production MCP workloads across stdio and streamable HTTP, including auth middleware, conformance, and upgrade planning.
-- [MCP Inspector Tutorial: Debugging and Validating MCP Servers](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-inspector-tutorial/index.md)
+- [MCP Inspector Tutorial: Debugging and Validating MCP Servers](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-inspector-tutorial/README.md)
   - Learn how to use modelcontextprotocol/inspector to test MCP servers across stdio, SSE, and streamable HTTP, with safer auth defaults and repeatable CLI automation.
-- [MCP Java SDK Tutorial: Building MCP Clients and Servers with Reactor, Servlet, and Spring](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-java-sdk-tutorial/index.md)
+- [MCP Java SDK Tutorial: Building MCP Clients and Servers with Reactor, Servlet, and Spring](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-java-sdk-tutorial/README.md)
   - Learn how to use modelcontextprotocol/java-sdk across core Java and Spring stacks, from transport setup to conformance and production hardening.
-- [MCP Kotlin SDK Tutorial: Building Multiplatform MCP Clients and Servers](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-kotlin-sdk-tutorial/index.md)
+- [MCP Kotlin SDK Tutorial: Building Multiplatform MCP Clients and Servers](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-kotlin-sdk-tutorial/README.md)
   - Learn how to implement MCP client/server workflows with modelcontextprotocol/kotlin-sdk, including module boundaries, transport choices, capability negotiation, and production lifecycle controls.
-- [MCP PHP SDK Tutorial: Building MCP Servers in PHP with Discovery and Transport Flexibility](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-php-sdk-tutorial/index.md)
+- [MCP PHP SDK Tutorial: Building MCP Servers in PHP with Discovery and Transport Flexibility](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-php-sdk-tutorial/README.md)
   - Learn how to implement MCP server workflows with modelcontextprotocol/php-sdk, including attribute discovery, manual capability registration, transport strategy, session storage, and framework integration patterns.
-- [MCP Python SDK Tutorial: Building AI Tool Servers](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-python-sdk-tutorial/index.md)
+- [MCP Python SDK Tutorial: Building AI Tool Servers](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-python-sdk-tutorial/README.md)
   - Master the Model Context Protocol Python SDK to build custom tool servers that extend Claude and other LLMs with powerful capabilities.
-- [MCP Quickstart Resources Tutorial: Cross-Language MCP Servers and Clients by Example](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-quickstart-resources-tutorial/index.md)
+- [MCP Quickstart Resources Tutorial: Cross-Language MCP Servers and Clients by Example](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-quickstart-resources-tutorial/README.md)
   - Learn how to use modelcontextprotocol/quickstart-resources as a practical reference for multi-language MCP server/client implementations, protocol smoke testing, and onboarding workflows.
-- [MCP Registry Tutorial: Publishing, Discovery, and Governance for MCP Servers](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-registry-tutorial/index.md)
+- [MCP Registry Tutorial: Publishing, Discovery, and Governance for MCP Servers](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-registry-tutorial/README.md)
   - Learn how modelcontextprotocol/registry works end to end: publishing authenticated server metadata, consuming the API as an aggregator, and operating registry infrastructure safely.
-- [MCP Ruby SDK Tutorial: Building MCP Servers and Clients in Ruby](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-ruby-sdk-tutorial/index.md)
+- [MCP Ruby SDK Tutorial: Building MCP Servers and Clients in Ruby](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-ruby-sdk-tutorial/README.md)
   - Learn how to implement MCP server/client workflows with modelcontextprotocol/ruby-sdk, including tool/prompt/resource registration, streamable HTTP sessions, structured logging, and release operations.
-- [MCP Rust SDK Tutorial: Building High-Performance MCP Services with RMCP](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-rust-sdk-tutorial/index.md)
+- [MCP Rust SDK Tutorial: Building High-Performance MCP Services with RMCP](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-rust-sdk-tutorial/README.md)
   - Learn how to use modelcontextprotocol/rust-sdk (rmcp) for production MCP clients and servers with strong transport control, macro-driven tooling, OAuth, and async task workflows.
-- [MCP Servers Tutorial: Reference Implementations and Patterns](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-servers-tutorial/index.md)
+- [MCP Servers Tutorial: Reference Implementations and Patterns](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-servers-tutorial/README.md)
   - Learn how to use the official MCP reference servers as implementation blueprints, not drop-in production services.
-- [MCP Specification Tutorial: Designing Production-Grade MCP Clients and Servers From the Source of Truth](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-specification-tutorial/index.md)
+- [MCP Specification Tutorial: Designing Production-Grade MCP Clients and Servers From the Source of Truth](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-specification-tutorial/README.md)
   - Learn the current Model Context Protocol directly from modelcontextprotocol/modelcontextprotocol, including lifecycle, transports, security, authorization, and governance workflows.
-- [MCP Swift SDK Tutorial: Building MCP Clients and Servers in Swift](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-swift-sdk-tutorial/index.md)
+- [MCP Swift SDK Tutorial: Building MCP Clients and Servers in Swift](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-swift-sdk-tutorial/README.md)
   - Learn how to implement MCP client and server workflows with modelcontextprotocol/swift-sdk, including transport options, sampling, batching, and graceful service lifecycle control.
-- [MCP TypeScript SDK Tutorial: Building and Migrating MCP Clients and Servers in TypeScript](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-typescript-sdk-tutorial/index.md)
+- [MCP TypeScript SDK Tutorial: Building and Migrating MCP Clients and Servers in TypeScript](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-typescript-sdk-tutorial/README.md)
   - Learn how to use modelcontextprotocol/typescript-sdk to build production MCP clients and servers, migrate from v1 to v2 safely, and validate behavior with conformance workflows.
-- [MCP Use Tutorial: Full-Stack MCP Development Across Agents, Clients, Servers, and Inspector](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-use-tutorial/index.md)
+- [MCP Use Tutorial: Full-Stack MCP Development Across Agents, Clients, Servers, and Inspector](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-use-tutorial/README.md)
   - Learn how mcp-use/mcp-use composes agent, client, server, and inspector workflows across Python and TypeScript with practical security and operations patterns.
-- [MCPB Tutorial: Packaging and Distributing Local MCP Servers as Bundles](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcpb-tutorial/index.md)
+- [MCPB Tutorial: Packaging and Distributing Local MCP Servers as Bundles](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcpb-tutorial/README.md)
   - Learn how to use modelcontextprotocol/mcpb to package local MCP servers into signed .mcpb bundles with manifest metadata, CLI workflows, and distribution-ready operational controls.
-- [MeiliSearch Tutorial: Lightning Fast Search Engine](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/meilisearch-tutorial/index.md)
+- [MeiliSearch Tutorial: Lightning Fast Search Engine](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/meilisearch-tutorial/README.md)
   - A deep technical walkthrough of MeiliSearch covering Lightning Fast Search Engine.
-- [Mem0 Tutorial: Building Production-Ready AI Agents with Scalable Long-Term Memory](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mem0-tutorial/index.md)
+- [Mem0 Tutorial: Building Production-Ready AI Agents with Scalable Long-Term Memory](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mem0-tutorial/README.md)
   - A deep technical walkthrough of Mem0 covering Building Production-Ready AI Agents with Scalable Long-Term Memory.
-- [Mini-SWE-Agent Tutorial: Minimal Autonomous Code Agent Design at Benchmark Scale](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mini-swe-agent-tutorial/index.md)
+- [Mini-SWE-Agent Tutorial: Minimal Autonomous Code Agent Design at Benchmark Scale](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mini-swe-agent-tutorial/README.md)
   - Learn how to use SWE-agent/mini-swe-agent to run compact, high-performing software-engineering agent workflows with minimal scaffolding and strong reproducibility.
-- [Mistral Vibe Tutorial: Minimal CLI Coding Agent by Mistral](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mistral-vibe-tutorial/index.md)
+- [Mistral Vibe Tutorial: Minimal CLI Coding Agent by Mistral](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mistral-vibe-tutorial/README.md)
   - Learn how to use mistralai/mistral-vibe for terminal-native coding workflows with configurable agent profiles, skills, subagents, and ACP integrations.
 
 ## N
 
-- [n8n AI Tutorial: Workflow Automation with AI](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/n8n-ai-tutorial/index.md)
+- [n8n AI Tutorial: Workflow Automation with AI](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/n8n-ai-tutorial/README.md)
   - Build powerful AI-powered automations with n8n's visual workflow builder.
-- [n8n Model Context Protocol: Deep Dive Tutorial](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/n8n-mcp-tutorial/index.md)
+- [n8n Model Context Protocol: Deep Dive Tutorial](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/n8n-mcp-tutorial/README.md)
   - n8n — Visual workflow automation with Model Context Protocol (MCP) integration for AI-powered tool use.
-- [Nanocoder Tutorial: Building and Understanding AI Coding Agents](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/nanocoder-tutorial/index.md)
+- [Nanocoder Tutorial: Building and Understanding AI Coding Agents](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/nanocoder-tutorial/README.md)
   - Learn how Nano-Collective/nanocoder implements local-first coding-agent workflows, tool execution loops, and multi-provider model integration.
-- [NocoDB: Deep Dive Tutorial](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/nocodb-database-platform/index.md)
+- [NocoDB: Deep Dive Tutorial](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/nocodb-database-platform/README.md)
   - NocoDB — An open-source Airtable alternative that turns any database into a smart spreadsheet.
 
 ## O
 
-- [Obsidian Outliner Plugin: Deep Dive Tutorial](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/obsidian-outliner-plugin/index.md)
+- [Obsidian Outliner Plugin: Deep Dive Tutorial](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/obsidian-outliner-plugin/README.md)
   - Obsidian Outliner — A plugin that adds outliner-style editing behaviors to Obsidian, demonstrating advanced plugin architecture patterns.
-- [Ollama Tutorial: Running and Serving LLMs Locally](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/ollama-tutorial/index.md)
+- [Ollama Tutorial: Running and Serving LLMs Locally](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/ollama-tutorial/README.md)
   - Learn how to use ollama/ollama for local model execution, customization, embeddings/RAG, integration, and production deployment.
-- [Onlook Tutorial: Visual-First AI Coding for Next.js and Tailwind](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/onlook-tutorial/index.md)
+- [Onlook Tutorial: Visual-First AI Coding for Next.js and Tailwind](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/onlook-tutorial/README.md)
   - Learn how to use onlook-dev/onlook to design and edit production-grade React apps visually while keeping generated code in your repository.
-- [Opcode Tutorial: GUI Command Center for Claude Code Workflows](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/opcode-tutorial/index.md)
+- [Opcode Tutorial: GUI Command Center for Claude Code Workflows](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/opcode-tutorial/README.md)
   - Learn how to use winfunc/opcode to manage Claude Code projects, sessions, agents, MCP servers, and checkpoints from a desktop-first operating interface.
-- [Open SWE Tutorial: Asynchronous Cloud Coding Agent Architecture and Migration Playbook](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/open-swe-tutorial/index.md)
+- [Open SWE Tutorial: Asynchronous Cloud Coding Agent Architecture and Migration Playbook](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/open-swe-tutorial/README.md)
   - Learn from langchain-ai/open-swe architecture, workflows, and operational patterns, including how to maintain or migrate from a deprecated codebase.
-- [Open WebUI Tutorial: Self-Hosted AI Workspace and Chat Interface](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/open-webui-tutorial/index.md)
+- [Open WebUI Tutorial: Self-Hosted AI Workspace and Chat Interface](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/open-webui-tutorial/README.md)
   - Learn how to run and operate open-webui/open-webui as a self-hosted AI interface with model routing, RAG workflows, multi-user controls, and production deployment patterns.
-- [OpenAI Python SDK Tutorial: Production API Patterns](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/openai-python-sdk-tutorial/index.md)
+- [OpenAI Python SDK Tutorial: Production API Patterns](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/openai-python-sdk-tutorial/README.md)
   - Learn how to build reliable Python integrations with openai/openai-python using Responses-first architecture, migration-safe patterns, and production operations.
-- [OpenAI Realtime Agents Tutorial: Voice-First AI Systems](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/openai-realtime-agents-tutorial/index.md)
+- [OpenAI Realtime Agents Tutorial: Voice-First AI Systems](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/openai-realtime-agents-tutorial/README.md)
   - Learn how to build low-latency voice agents with openai/openai-realtime-agents, including realtime session design, tool orchestration, and production rollout patterns.
-- [OpenAI Whisper Tutorial: Speech Recognition and Translation](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/openai-whisper-tutorial/index.md)
+- [OpenAI Whisper Tutorial: Speech Recognition and Translation](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/openai-whisper-tutorial/README.md)
   - Build robust transcription pipelines with Whisper, from local experiments to production deployment.
-- [OpenBB Tutorial: Complete Guide to Investment Research Platform](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/openbb-tutorial/index.md)
+- [OpenBB Tutorial: Complete Guide to Investment Research Platform](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/openbb-tutorial/README.md)
   - Democratize investment research with OpenBB's comprehensive financial data and analysis platform.
-- [OpenClaw: Deep Dive Tutorial](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/openclaw-tutorial/index.md)
+- [OpenClaw: Deep Dive Tutorial](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/openclaw-tutorial/README.md)
   - OpenClaw — Your own personal AI assistant. Any OS. Any Platform.
-- [OpenCode AI Legacy Tutorial: Archived Terminal Agent Workflows and Migration to Crush](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/opencode-ai-legacy-tutorial/index.md)
+- [OpenCode AI Legacy Tutorial: Archived Terminal Agent Workflows and Migration to Crush](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/opencode-ai-legacy-tutorial/README.md)
   - Learn from opencode-ai/opencode architecture and workflows, and migrate safely to actively maintained successors.
-- [OpenCode Tutorial: Open-Source Terminal Coding Agent at Scale](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/opencode-tutorial/index.md)
+- [OpenCode Tutorial: Open-Source Terminal Coding Agent at Scale](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/opencode-tutorial/README.md)
   - Learn how to use anomalyco/opencode to run terminal-native coding agents with provider flexibility, strong tool control, and production-grade workflows.
-- [OpenHands Tutorial: Autonomous Software Engineering Workflows](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/openhands-tutorial/index.md)
+- [OpenHands Tutorial: Autonomous Software Engineering Workflows](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/openhands-tutorial/README.md)
   - Learn how to operate OpenHands/OpenHands across local GUI, CLI, and SDK workflows with production-minded safety, validation, and integration patterns.
-- [OpenSkills Tutorial: Universal Skill Loading for Coding Agents](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/openskills-tutorial/index.md)
+- [OpenSkills Tutorial: Universal Skill Loading for Coding Agents](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/openskills-tutorial/README.md)
   - Learn how to use numman-ali/openskills to install, synchronize, and operate reusable SKILL.md packs across Claude Code, Cursor, Codex, Aider, and other agent environments.
-- [OpenSpec Tutorial: Spec-Driven Workflows for AI Coding Agents](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/openspec-tutorial/index.md)
+- [OpenSpec Tutorial: Spec-Driven Workflows for AI Coding Agents](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/openspec-tutorial/README.md)
   - Learn how to use Fission-AI/OpenSpec to make AI-assisted software delivery more predictable with artifact-driven planning, implementation, and archival workflows.
-- [OpenSrc Tutorial: Deep Source Context for Coding Agents](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/opensrc-tutorial/index.md)
+- [OpenSrc Tutorial: Deep Source Context for Coding Agents](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/opensrc-tutorial/README.md)
   - Learn how to use vercel-labs/opensrc to fetch package and repository source code so coding agents can reason about implementation details, not only public types and docs.
-- [Outlines Tutorial: Structured Text Generation with LLMs](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/outlines-tutorial/index.md)
+- [Outlines Tutorial: Structured Text Generation with LLMs](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/outlines-tutorial/README.md)
   - A deep technical walkthrough of Outlines covering Structured Text Generation with LLMs.
-- [OpenAI Swarm Tutorial: Lightweight Multi-Agent Orchestration](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/swarm-tutorial/index.md)
+- [OpenAI Swarm Tutorial: Lightweight Multi-Agent Orchestration](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/swarm-tutorial/README.md)
   - Deep technical walkthrough of OpenAI Swarm Tutorial: Lightweight Multi-Agent Orchestration.
 
 ## P
 
-- [Perplexica Tutorial: AI-Powered Search Engine](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/perplexica-tutorial/index.md)
+- [Perplexica Tutorial: AI-Powered Search Engine](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/perplexica-tutorial/README.md)
   - A deep technical walkthrough of Perplexica covering AI-Powered Search Engine.
-- [Phidata Tutorial: Building Autonomous AI Agents](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/phidata-tutorial/index.md)
+- [Phidata Tutorial: Building Autonomous AI Agents](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/phidata-tutorial/README.md)
   - A deep technical walkthrough of Phidata covering Building Autonomous AI Agents.
-- [PhotoPrism Tutorial: AI-Powered Photos App](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/photoprism-tutorial/index.md)
+- [PhotoPrism Tutorial: AI-Powered Photos App](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/photoprism-tutorial/README.md)
   - AI Photo Management Revolution: Enhanced facial recognition, LLM integrations, and advanced organization features mark PhotoPrism's evolution.
-- [Plandex Tutorial: Large-Task AI Coding Agent Workflows](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/plandex-tutorial/index.md)
+- [Plandex Tutorial: Large-Task AI Coding Agent Workflows](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/plandex-tutorial/README.md)
   - Learn how to use plandex-ai/plandex for large codebase tasks with strong context management, cumulative diff review, model packs, and self-hosted operations.
-- [Planning with Files Tutorial: Persistent Markdown Workflow Memory for AI Coding Agents](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/planning-with-files-tutorial/index.md)
+- [Planning with Files Tutorial: Persistent Markdown Workflow Memory for AI Coding Agents](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/planning-with-files-tutorial/README.md)
   - Learn how to use OthmanAdi/planning-with-files to run Manus-style file-based planning workflows across Claude Code and other AI coding environments.
-- [Playwright MCP Tutorial: Browser Automation for Coding Agents Through MCP](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/playwright-mcp-tutorial/index.md)
+- [Playwright MCP Tutorial: Browser Automation for Coding Agents Through MCP](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/playwright-mcp-tutorial/README.md)
   - Learn how to use microsoft/playwright-mcp to give AI coding agents structured browser automation with accessibility snapshots, deterministic actions, and portable MCP host integrations.
-- [PocketFlow Tutorial: Minimal LLM Framework with Graph-Based Power](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/pocketflow-tutorial/index.md)
+- [PocketFlow Tutorial: Minimal LLM Framework with Graph-Based Power](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/pocketflow-tutorial/README.md)
   - Learn how to build agentic applications with The-Pocket/PocketFlow, a minimalist graph framework that still supports workflows, multi-agent patterns, RAG, and human-in-the-loop flows.
-- [PostgreSQL Query Planner Deep Dive](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/postgresql-query-planner/index.md)
+- [PostgreSQL Query Planner Deep Dive](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/postgresql-query-planner/README.md)
   - Master PostgreSQL's query execution engine, understand EXPLAIN output, and optimize complex queries for maximum performance.
-- [PostHog Tutorial: Open Source Product Analytics Platform](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/posthog-tutorial/index.md)
+- [PostHog Tutorial: Open Source Product Analytics Platform](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/posthog-tutorial/README.md)
   - Deep technical walkthrough of PostHog Tutorial: Open Source Product Analytics Platform.
-- [Pydantic AI Tutorial: Type-Safe AI Agent Development](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/pydantic-ai-tutorial/index.md)
+- [Pydantic AI Tutorial: Type-Safe AI Agent Development](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/pydantic-ai-tutorial/README.md)
   - A deep technical walkthrough of Pydantic AI covering Type-Safe AI Agent Development.
 
 ## Q
 
-- [Quivr Tutorial: Open-Source RAG Framework for Document Ingestion](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/quivr-tutorial/index.md)
+- [Quivr Tutorial: Open-Source RAG Framework for Document Ingestion](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/quivr-tutorial/README.md)
   - Deep technical walkthrough of Quivr Tutorial: Open-Source RAG Framework for Document Ingestion.
-- [Qwen-Agent Tutorial: Tool-Enabled Agent Framework with MCP, RAG, and Multi-Modal Workflows](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/qwen-agent-tutorial/index.md)
+- [Qwen-Agent Tutorial: Tool-Enabled Agent Framework with MCP, RAG, and Multi-Modal Workflows](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/qwen-agent-tutorial/README.md)
   - Learn how to use QwenLM/Qwen-Agent to build production-capable agents with function calling, MCP integration, memory/RAG patterns, and benchmark-aware planning workflows.
 
 ## R
 
-- [RAGFlow Tutorial: Complete Guide to Open-Source RAG Engine](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/ragflow-tutorial/index.md)
+- [RAGFlow Tutorial: Complete Guide to Open-Source RAG Engine](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/ragflow-tutorial/README.md)
   - Transform documents into intelligent Q&A systems with RAGFlow's comprehensive RAG (Retrieval-Augmented Generation) platform.
-- [React Fiber Internals](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/react-fiber-internals/index.md)
+- [React Fiber Internals](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/react-fiber-internals/README.md)
   - Deep dive into React's reconciliation algorithm, the Fiber architecture that powers modern React applications.
-- [Refly Tutorial: Build Deterministic Agent Skills and Ship Them Across APIs and Claude Code](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/refly-tutorial/index.md)
+- [Refly Tutorial: Build Deterministic Agent Skills and Ship Them Across APIs and Claude Code](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/refly-tutorial/README.md)
   - Learn how to use refly-ai/refly to turn vibe workflows into reusable, versioned agent skills that can run via API, webhook, and CLI integrations.
-- [Roo Code Tutorial: Run an AI Dev Team in Your Editor](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/roo-code-tutorial/index.md)
+- [Roo Code Tutorial: Run an AI Dev Team in Your Editor](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/roo-code-tutorial/README.md)
   - A production-focused guide to RooCodeInc/Roo-Code: mode design, task execution, checkpoints, MCP, team profiles, and enterprise operations.
 
 ## S
 
-- [Semantic Kernel Tutorial: Microsoft's AI Orchestration](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/semantic-kernel-tutorial/index.md)
+- [Semantic Kernel Tutorial: Microsoft's AI Orchestration](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/semantic-kernel-tutorial/README.md)
   - Build enterprise AI applications with Microsoft's SDK for integrating LLMs.
-- [Serena Tutorial: Semantic Code Retrieval Toolkit for Coding Agents](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/serena-tutorial/index.md)
+- [Serena Tutorial: Semantic Code Retrieval Toolkit for Coding Agents](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/serena-tutorial/README.md)
   - Learn how to use oraios/serena to give coding agents IDE-grade semantic retrieval and editing tools across large codebases.
-- [Shotgun Tutorial: Spec-Driven Development for Coding Agents](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/shotgun-tutorial/index.md)
+- [Shotgun Tutorial: Spec-Driven Development for Coding Agents](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/shotgun-tutorial/README.md)
   - Learn how to use shotgun-sh/shotgun to plan, specify, and execute large code changes with structured agent workflows and stronger delivery control.
-- [SillyTavern Tutorial: Advanced LLM Frontend for Power Users](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/sillytavern-tutorial/index.md)
+- [SillyTavern Tutorial: Advanced LLM Frontend for Power Users](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/sillytavern-tutorial/README.md)
   - Unlock the full potential of large language models with SillyTavern's comprehensive interface for role-playing, creative writing, and AI experimentation.
-- [SiYuan Tutorial: Privacy-First Knowledge Management](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/siyuan-tutorial/index.md)
+- [SiYuan Tutorial: Privacy-First Knowledge Management](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/siyuan-tutorial/README.md)
   - A deep technical walkthrough of SiYuan covering Privacy-First Knowledge Management.
-- [Smolagents Tutorial: Hugging Face's Lightweight Agent Framework](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/smolagents-tutorial/index.md)
+- [Smolagents Tutorial: Hugging Face's Lightweight Agent Framework](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/smolagents-tutorial/README.md)
   - Build efficient AI agents with minimal code using Hugging Face's smolagents library.
-- [Stagewise Tutorial: Frontend Coding Agent Workflows in Real Browser Context](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/stagewise-tutorial/index.md)
+- [Stagewise Tutorial: Frontend Coding Agent Workflows in Real Browser Context](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/stagewise-tutorial/README.md)
   - Learn how to use stagewise-io/stagewise to connect browser-selected UI context with coding agents, plugin extensions, and multi-agent bridge workflows.
-- [Strands Agents Tutorial: Model-Driven Agent Systems with Native MCP Support](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/strands-agents-tutorial/index.md)
+- [Strands Agents Tutorial: Model-Driven Agent Systems with Native MCP Support](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/strands-agents-tutorial/README.md)
   - Learn how to use strands-agents/sdk-python to build lightweight, model-driven agents with strong tool abstractions, hooks, and production deployment patterns.
-- [Supabase Tutorial: Building Modern Backend Applications](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/supabase-tutorial/index.md)
+- [Supabase Tutorial: Building Modern Backend Applications](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/supabase-tutorial/README.md)
   - Deep technical walkthrough of Supabase Tutorial: Building Modern Backend Applications.
-- [SuperAGI Tutorial: Production-Ready Autonomous AI Agents](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/superagi-tutorial/index.md)
+- [SuperAGI Tutorial: Production-Ready Autonomous AI Agents](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/superagi-tutorial/README.md)
   - A deep technical walkthrough of SuperAGI covering Production-Ready Autonomous AI Agents.
-- [Superset Terminal Tutorial: Command Center for Parallel Coding Agents](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/superset-terminal-tutorial/index.md)
+- [Superset Terminal Tutorial: Command Center for Parallel Coding Agents](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/superset-terminal-tutorial/README.md)
   - Learn how to use superset-sh/superset to orchestrate many coding agents in parallel with worktree isolation, centralized monitoring, and fast review loops.
-- [SWE-agent Tutorial: Autonomous Repository Repair and Benchmark-Driven Engineering](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/swe-agent-tutorial/index.md)
+- [SWE-agent Tutorial: Autonomous Repository Repair and Benchmark-Driven Engineering](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/swe-agent-tutorial/README.md)
   - Learn how to use SWE-agent/SWE-agent for autonomous software engineering workflows, from single-issue runs to benchmark and research-grade evaluation.
-- [Sweep Tutorial: Issue-to-PR AI Coding Workflows on GitHub](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/sweep-tutorial/index.md)
+- [Sweep Tutorial: Issue-to-PR AI Coding Workflows on GitHub](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/sweep-tutorial/README.md)
   - Learn how to use sweepai/sweep to turn GitHub issues into pull requests, operate feedback loops, and run self-hosted or CLI workflows with clear guardrails.
 
 ## T
 
-- [Tabby Tutorial: Self-Hosted AI Coding Assistant Architecture and Operations](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/tabby-tutorial/index.md)
+- [Tabby Tutorial: Self-Hosted AI Coding Assistant Architecture and Operations](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/tabby-tutorial/README.md)
   - Learn how to run and extend TabbyML/tabby for production code completion and team knowledge workflows.
-- [Taskade Awesome Vibe Coding Tutorial: Curating the 2026 AI-Building Landscape](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/taskade-awesome-vibe-coding-tutorial/index.md)
+- [Taskade Awesome Vibe Coding Tutorial: Curating the 2026 AI-Building Landscape](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/taskade-awesome-vibe-coding-tutorial/README.md)
   - Learn how to use and maintain taskade/awesome-vibe-coding as a decision system for AI app builders, coding agents, MCP tooling, and Genesis-centered workflows.
-- [Taskade Docs Tutorial: Operating the Living-DNA Documentation Stack](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/taskade-docs-tutorial/index.md)
+- [Taskade Docs Tutorial: Operating the Living-DNA Documentation Stack](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/taskade-docs-tutorial/README.md)
   - Learn how taskade/docs structures product documentation across Genesis, API references, automations, help-center workflows, and release timelines.
-- [Taskade MCP Tutorial: OpenAPI-Driven MCP Server for Taskade Workflows](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/taskade-mcp-tutorial/index.md)
+- [Taskade MCP Tutorial: OpenAPI-Driven MCP Server for Taskade Workflows](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/taskade-mcp-tutorial/README.md)
   - Learn how to run, extend, and operate taskade/mcp to connect Taskade workspaces, tasks, projects, and AI agents into MCP-compatible clients.
-- [Taskade Tutorial: AI-Native Workspace, Genesis, and Agentic Operations](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/taskade-tutorial/index.md)
+- [Taskade Tutorial: AI-Native Workspace, Genesis, and Agentic Operations](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/taskade-tutorial/README.md)
   - Learn how to operate Taskade as an AI-native workspace system: Genesis app generation, AI agents, automations, enterprise controls, and production rollout patterns.
-- [Teable: Deep Dive Tutorial](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/teable-database-platform/index.md)
+- [Teable: Deep Dive Tutorial](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/teable-database-platform/README.md)
   - Teable — A high-performance, multi-dimensional database platform built on PostgreSQL with real-time collaboration.
-- [tiktoken Tutorial: OpenAI Token Encoding & Optimization](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/tiktoken-tutorial/index.md)
+- [tiktoken Tutorial: OpenAI Token Encoding & Optimization](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/tiktoken-tutorial/README.md)
   - Master tiktoken, OpenAI's fast BPE tokenizer, to accurately count tokens, optimize prompts, and reduce API costs.
-- [Turborepo Tutorial: High-Performance Monorepo Build System](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/turborepo-tutorial/index.md)
+- [Turborepo Tutorial: High-Performance Monorepo Build System](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/turborepo-tutorial/README.md)
   - A deep technical walkthrough of Turborepo covering High-Performance Monorepo Build System.
 
 ## U
 
-- [use-mcp Tutorial: React Hook Patterns for MCP Client Integration](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/use-mcp-tutorial/index.md)
+- [use-mcp Tutorial: React Hook Patterns for MCP Client Integration](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/use-mcp-tutorial/README.md)
   - Learn how to use modelcontextprotocol/use-mcp to connect React apps to MCP servers with OAuth-aware flows, tool/resource/prompt access, and resilient transport lifecycle handling.
 
 ## V
 
-- [Vercel AI SDK Tutorial: Production TypeScript AI Apps and Agents](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/vercel-ai-tutorial/index.md)
+- [Vercel AI SDK Tutorial: Production TypeScript AI Apps and Agents](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/vercel-ai-tutorial/README.md)
   - Build robust AI product features with vercel/ai, including streaming, structured outputs, tool loops, framework integration, and production deployment patterns.
-- [Vibe Kanban Tutorial: Multi-Agent Orchestration Board for Coding Workflows](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/vibe-kanban-tutorial/index.md)
+- [Vibe Kanban Tutorial: Multi-Agent Orchestration Board for Coding Workflows](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/vibe-kanban-tutorial/README.md)
   - Learn how to use BloopAI/vibe-kanban to coordinate Claude Code, Codex, Gemini CLI, and other coding agents through a unified orchestration workspace.
-- [VibeSDK Tutorial: Build a Vibe-Coding Platform on Cloudflare](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/vibesdk-tutorial/index.md)
+- [VibeSDK Tutorial: Build a Vibe-Coding Platform on Cloudflare](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/vibesdk-tutorial/README.md)
   - Learn how to use cloudflare/vibesdk to run a prompt-to-app platform with agent orchestration, preview sandboxes, and production deployment on Cloudflare.
-- [vLLM Tutorial: High-Performance LLM Inference](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/vllm-tutorial/index.md)
+- [vLLM Tutorial: High-Performance LLM Inference](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/vllm-tutorial/README.md)
   - Master vLLM for blazing-fast, cost-effective large language model inference with advanced optimization techniques.
 
 ## W
 
-- [Whisper.cpp Tutorial: High-Performance Speech Recognition in C/C++](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/whisper-cpp-tutorial/index.md)
+- [Whisper.cpp Tutorial: High-Performance Speech Recognition in C/C++](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/whisper-cpp-tutorial/README.md)
   - A deep technical walkthrough of Whisper.cpp covering High-Performance Speech Recognition in C/C++.
-- [Wshobson Agents Tutorial: Pluginized Multi-Agent Workflows for Claude Code](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/wshobson-agents-tutorial/index.md)
+- [Wshobson Agents Tutorial: Pluginized Multi-Agent Workflows for Claude Code](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/wshobson-agents-tutorial/README.md)
   - Learn how to use wshobson/agents to install focused Claude Code plugins, coordinate specialist agents, and run scalable multi-agent workflows with clear model and skill boundaries.
diff --git a/discoverability/tutorial-index.json b/discoverability/tutorial-index.json
index d105a5c0..569018ec 100644
--- a/discoverability/tutorial-index.json
+++ b/discoverability/tutorial-index.json
@@ -4,8 +4,8 @@
   "tutorials": [
     {
       "cluster": "ai-app-frameworks",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/activepieces-tutorial/index.md",
-      "index_path": "tutorials/activepieces-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/activepieces-tutorial/README.md",
+      "index_path": "tutorials/activepieces-tutorial/README.md",
       "intent_signals": [
         "production-operations"
       ],
@@ -37,8 +37,8 @@
     },
     {
       "cluster": "ai-coding-agents",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/adk-python-tutorial/index.md",
-      "index_path": "tutorials/adk-python-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/adk-python-tutorial/README.md",
+      "index_path": "tutorials/adk-python-tutorial/README.md",
       "intent_signals": [
         "production-operations",
         "agentic-coding"
@@ -67,8 +67,8 @@
     },
     {
       "cluster": "ai-coding-agents",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/ag2-tutorial/index.md",
-      "index_path": "tutorials/ag2-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/ag2-tutorial/README.md",
+      "index_path": "tutorials/ag2-tutorial/README.md",
       "intent_signals": [
         "agentic-coding"
       ],
@@ -93,8 +93,8 @@
     },
     {
       "cluster": "ai-coding-agents",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/agentgpt-tutorial/index.md",
-      "index_path": "tutorials/agentgpt-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/agentgpt-tutorial/README.md",
+      "index_path": "tutorials/agentgpt-tutorial/README.md",
       "intent_signals": [
         "agentic-coding"
       ],
@@ -114,8 +114,8 @@
     },
     {
       "cluster": "ai-coding-agents",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/agenticseek-tutorial/index.md",
-      "index_path": "tutorials/agenticseek-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/agenticseek-tutorial/README.md",
+      "index_path": "tutorials/agenticseek-tutorial/README.md",
       "intent_signals": [
         "beginner-onboarding",
         "production-operations",
@@ -149,8 +149,8 @@
     },
     {
       "cluster": "ai-coding-agents",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/agents-md-tutorial/index.md",
-      "index_path": "tutorials/agents-md-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/agents-md-tutorial/README.md",
+      "index_path": "tutorials/agents-md-tutorial/README.md",
       "intent_signals": [
         "agentic-coding"
       ],
@@ -179,8 +179,8 @@
     },
     {
       "cluster": "ai-coding-agents",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/agno-tutorial/index.md",
-      "index_path": "tutorials/agno-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/agno-tutorial/README.md",
+      "index_path": "tutorials/agno-tutorial/README.md",
       "intent_signals": [
         "production-operations",
         "agentic-coding"
@@ -208,8 +208,8 @@
     },
     {
       "cluster": "ai-coding-agents",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/aider-tutorial/index.md",
-      "index_path": "tutorials/aider-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/aider-tutorial/README.md",
+      "index_path": "tutorials/aider-tutorial/README.md",
       "intent_signals": [
         "agentic-coding"
       ],
@@ -239,8 +239,8 @@
     },
     {
       "cluster": "mcp-ecosystem",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/anthropic-code-tutorial/index.md",
-      "index_path": "tutorials/anthropic-code-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/anthropic-code-tutorial/README.md",
+      "index_path": "tutorials/anthropic-code-tutorial/README.md",
       "intent_signals": [
         "production-operations",
         "mcp-integration"
@@ -268,8 +268,8 @@
     },
     {
       "cluster": "ai-coding-agents",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/anthropic-skills-tutorial/index.md",
-      "index_path": "tutorials/anthropic-skills-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/anthropic-skills-tutorial/README.md",
+      "index_path": "tutorials/anthropic-skills-tutorial/README.md",
       "intent_signals": [
         "production-operations",
         "agentic-coding"
@@ -294,8 +294,8 @@
     },
     {
       "cluster": "ai-coding-agents",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/anything-llm-tutorial/index.md",
-      "index_path": "tutorials/anything-llm-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/anything-llm-tutorial/README.md",
+      "index_path": "tutorials/anything-llm-tutorial/README.md",
       "intent_signals": [
         "production-operations",
         "agentic-coding"
@@ -328,8 +328,8 @@
     },
     {
       "cluster": "data-and-storage",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/athens-research-knowledge-graph/index.md",
-      "index_path": "tutorials/athens-research-knowledge-graph/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/athens-research-knowledge-graph/README.md",
+      "index_path": "tutorials/athens-research-knowledge-graph/README.md",
       "intent_signals": [
         "architecture-deep-dive"
       ],
@@ -355,8 +355,8 @@
     },
     {
       "cluster": "ai-coding-agents",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/autoagent-tutorial/index.md",
-      "index_path": "tutorials/autoagent-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/autoagent-tutorial/README.md",
+      "index_path": "tutorials/autoagent-tutorial/README.md",
       "intent_signals": [
         "production-operations",
         "agentic-coding"
@@ -389,8 +389,8 @@
     },
     {
       "cluster": "ai-coding-agents",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/autogen-tutorial/index.md",
-      "index_path": "tutorials/autogen-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/autogen-tutorial/README.md",
+      "index_path": "tutorials/autogen-tutorial/README.md",
       "intent_signals": [
         "agentic-coding"
       ],
@@ -411,8 +411,8 @@
     },
     {
       "cluster": "ai-coding-agents",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/awesome-claude-code-tutorial/index.md",
-      "index_path": "tutorials/awesome-claude-code-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/awesome-claude-code-tutorial/README.md",
+      "index_path": "tutorials/awesome-claude-code-tutorial/README.md",
       "intent_signals": [
         "tool-selection",
         "agentic-coding"
@@ -443,8 +443,8 @@
     },
     {
       "cluster": "ai-coding-agents",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/awesome-claude-skills-tutorial/index.md",
-      "index_path": "tutorials/awesome-claude-skills-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/awesome-claude-skills-tutorial/README.md",
+      "index_path": "tutorials/awesome-claude-skills-tutorial/README.md",
       "intent_signals": [
         "tool-selection",
         "agentic-coding"
@@ -477,8 +477,8 @@
     },
     {
       "cluster": "mcp-ecosystem",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/awesome-mcp-servers-tutorial/index.md",
-      "index_path": "tutorials/awesome-mcp-servers-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/awesome-mcp-servers-tutorial/README.md",
+      "index_path": "tutorials/awesome-mcp-servers-tutorial/README.md",
       "intent_signals": [
         "tool-selection",
         "mcp-integration"
@@ -511,8 +511,8 @@
     },
     {
       "cluster": "mcp-ecosystem",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/awslabs-mcp-tutorial/index.md",
-      "index_path": "tutorials/awslabs-mcp-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/awslabs-mcp-tutorial/README.md",
+      "index_path": "tutorials/awslabs-mcp-tutorial/README.md",
       "intent_signals": [
         "production-operations",
         "mcp-integration"
@@ -545,8 +545,8 @@
     },
     {
       "cluster": "ai-coding-agents",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/babyagi-tutorial/index.md",
-      "index_path": "tutorials/babyagi-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/babyagi-tutorial/README.md",
+      "index_path": "tutorials/babyagi-tutorial/README.md",
       "intent_signals": [
         "agentic-coding"
       ],
@@ -574,8 +574,8 @@
     },
     {
       "cluster": "ai-coding-agents",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/beads-tutorial/index.md",
-      "index_path": "tutorials/beads-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/beads-tutorial/README.md",
+      "index_path": "tutorials/beads-tutorial/README.md",
       "intent_signals": [
         "agentic-coding"
       ],
@@ -607,8 +607,8 @@
     },
     {
       "cluster": "ai-app-frameworks",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/bentoml-tutorial/index.md",
-      "index_path": "tutorials/bentoml-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/bentoml-tutorial/README.md",
+      "index_path": "tutorials/bentoml-tutorial/README.md",
       "intent_signals": [
         "production-operations"
       ],
@@ -628,8 +628,8 @@
     },
     {
       "cluster": "mcp-ecosystem",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/bolt-diy-tutorial/index.md",
-      "index_path": "tutorials/bolt-diy-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/bolt-diy-tutorial/README.md",
+      "index_path": "tutorials/bolt-diy-tutorial/README.md",
       "intent_signals": [
         "production-operations",
         "architecture-deep-dive",
@@ -663,8 +663,8 @@
     },
     {
       "cluster": "ai-app-frameworks",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/botpress-tutorial/index.md",
-      "index_path": "tutorials/botpress-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/botpress-tutorial/README.md",
+      "index_path": "tutorials/botpress-tutorial/README.md",
       "intent_signals": [
         "general-learning"
       ],
@@ -687,8 +687,8 @@
     },
     {
       "cluster": "ai-coding-agents",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/browser-use-tutorial/index.md",
-      "index_path": "tutorials/browser-use-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/browser-use-tutorial/README.md",
+      "index_path": "tutorials/browser-use-tutorial/README.md",
       "intent_signals": [
         "production-operations",
         "agentic-coding"
@@ -715,8 +715,8 @@
     },
     {
       "cluster": "ai-app-frameworks",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/chatbox-tutorial/index.md",
-      "index_path": "tutorials/chatbox-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/chatbox-tutorial/README.md",
+      "index_path": "tutorials/chatbox-tutorial/README.md",
       "intent_signals": [
         "general-learning"
       ],
@@ -737,8 +737,8 @@
     },
     {
       "cluster": "mcp-ecosystem",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/cherry-studio-tutorial/index.md",
-      "index_path": "tutorials/cherry-studio-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/cherry-studio-tutorial/README.md",
+      "index_path": "tutorials/cherry-studio-tutorial/README.md",
       "intent_signals": [
         "beginner-onboarding",
         "mcp-integration"
@@ -771,8 +771,8 @@
     },
     {
       "cluster": "rag-and-retrieval",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/chroma-tutorial/index.md",
-      "index_path": "tutorials/chroma-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/chroma-tutorial/README.md",
+      "index_path": "tutorials/chroma-tutorial/README.md",
       "intent_signals": [
         "rag-implementation"
       ],
@@ -794,8 +794,8 @@
     },
     {
       "cluster": "ai-coding-agents",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/chrome-devtools-mcp-tutorial/index.md",
-      "index_path": "tutorials/chrome-devtools-mcp-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/chrome-devtools-mcp-tutorial/README.md",
+      "index_path": "tutorials/chrome-devtools-mcp-tutorial/README.md",
       "intent_signals": [
         "agentic-coding"
       ],
@@ -824,8 +824,8 @@
     },
     {
       "cluster": "ai-coding-agents",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/cipher-tutorial/index.md",
-      "index_path": "tutorials/cipher-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/cipher-tutorial/README.md",
+      "index_path": "tutorials/cipher-tutorial/README.md",
       "intent_signals": [
         "agentic-coding"
       ],
@@ -854,8 +854,8 @@
     },
     {
       "cluster": "ai-coding-agents",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/claude-code-router-tutorial/index.md",
-      "index_path": "tutorials/claude-code-router-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/claude-code-router-tutorial/README.md",
+      "index_path": "tutorials/claude-code-router-tutorial/README.md",
       "intent_signals": [
         "agentic-coding"
       ],
@@ -887,8 +887,8 @@
     },
     {
       "cluster": "ai-coding-agents",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/claude-code-tutorial/index.md",
-      "index_path": "tutorials/claude-code-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/claude-code-tutorial/README.md",
+      "index_path": "tutorials/claude-code-tutorial/README.md",
       "intent_signals": [
         "agentic-coding"
       ],
@@ -920,8 +920,8 @@
     },
     {
       "cluster": "mcp-ecosystem",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/claude-flow-tutorial/index.md",
-      "index_path": "tutorials/claude-flow-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/claude-flow-tutorial/README.md",
+      "index_path": "tutorials/claude-flow-tutorial/README.md",
       "intent_signals": [
         "architecture-deep-dive",
         "mcp-integration"
@@ -954,8 +954,8 @@
     },
     {
       "cluster": "ai-coding-agents",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/claude-mem-tutorial/index.md",
-      "index_path": "tutorials/claude-mem-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/claude-mem-tutorial/README.md",
+      "index_path": "tutorials/claude-mem-tutorial/README.md",
       "intent_signals": [
         "agentic-coding"
       ],
@@ -987,8 +987,8 @@
     },
     {
       "cluster": "ai-coding-agents",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/claude-plugins-official-tutorial/index.md",
-      "index_path": "tutorials/claude-plugins-official-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/claude-plugins-official-tutorial/README.md",
+      "index_path": "tutorials/claude-plugins-official-tutorial/README.md",
       "intent_signals": [
         "agentic-coding"
       ],
@@ -1019,8 +1019,8 @@
     },
     {
       "cluster": "ai-coding-agents",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/claude-quickstarts-tutorial/index.md",
-      "index_path": "tutorials/claude-quickstarts-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/claude-quickstarts-tutorial/README.md",
+      "index_path": "tutorials/claude-quickstarts-tutorial/README.md",
       "intent_signals": [
         "production-operations",
         "agentic-coding"
@@ -1053,8 +1053,8 @@
     },
     {
       "cluster": "ai-coding-agents",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/claude-squad-tutorial/index.md",
-      "index_path": "tutorials/claude-squad-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/claude-squad-tutorial/README.md",
+      "index_path": "tutorials/claude-squad-tutorial/README.md",
       "intent_signals": [
         "agentic-coding"
       ],
@@ -1086,8 +1086,8 @@
     },
     {
       "cluster": "general-software",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/claude-task-master-tutorial/index.md",
-      "index_path": "tutorials/claude-task-master-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/claude-task-master-tutorial/README.md",
+      "index_path": "tutorials/claude-task-master-tutorial/README.md",
       "intent_signals": [
         "general-learning"
       ],
@@ -1109,8 +1109,8 @@
     },
     {
       "cluster": "data-and-storage",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/clickhouse-tutorial/index.md",
-      "index_path": "tutorials/clickhouse-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/clickhouse-tutorial/README.md",
+      "index_path": "tutorials/clickhouse-tutorial/README.md",
       "intent_signals": [
         "general-learning"
       ],
@@ -1131,8 +1131,8 @@
     },
     {
       "cluster": "ai-coding-agents",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/cline-tutorial/index.md",
-      "index_path": "tutorials/cline-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/cline-tutorial/README.md",
+      "index_path": "tutorials/cline-tutorial/README.md",
       "intent_signals": [
         "agentic-coding"
       ],
@@ -1159,8 +1159,8 @@
     },
     {
       "cluster": "ai-coding-agents",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/codemachine-cli-tutorial/index.md",
-      "index_path": "tutorials/codemachine-cli-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/codemachine-cli-tutorial/README.md",
+      "index_path": "tutorials/codemachine-cli-tutorial/README.md",
       "intent_signals": [
         "agentic-coding"
       ],
@@ -1190,8 +1190,8 @@
     },
     {
       "cluster": "ai-coding-agents",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/codex-analysis-platform/index.md",
-      "index_path": "tutorials/codex-analysis-platform/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/codex-analysis-platform/README.md",
+      "index_path": "tutorials/codex-analysis-platform/README.md",
       "intent_signals": [
         "production-operations",
         "architecture-deep-dive",
@@ -1222,8 +1222,8 @@
     },
     {
       "cluster": "ai-coding-agents",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/codex-cli-tutorial/index.md",
-      "index_path": "tutorials/codex-cli-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/codex-cli-tutorial/README.md",
+      "index_path": "tutorials/codex-cli-tutorial/README.md",
       "intent_signals": [
         "agentic-coding"
       ],
@@ -1255,8 +1255,8 @@
     },
     {
       "cluster": "ai-app-frameworks",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/comfyui-tutorial/index.md",
-      "index_path": "tutorials/comfyui-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/comfyui-tutorial/README.md",
+      "index_path": "tutorials/comfyui-tutorial/README.md",
       "intent_signals": [
         "general-learning"
       ],
@@ -1277,8 +1277,8 @@
     },
     {
       "cluster": "mcp-ecosystem",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/composio-tutorial/index.md",
-      "index_path": "tutorials/composio-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/composio-tutorial/README.md",
+      "index_path": "tutorials/composio-tutorial/README.md",
       "intent_signals": [
         "production-operations",
         "mcp-integration"
@@ -1311,8 +1311,8 @@
     },
     {
       "cluster": "ai-coding-agents",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/compound-engineering-plugin-tutorial/index.md",
-      "index_path": "tutorials/compound-engineering-plugin-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/compound-engineering-plugin-tutorial/README.md",
+      "index_path": "tutorials/compound-engineering-plugin-tutorial/README.md",
       "intent_signals": [
         "agentic-coding"
       ],
@@ -1342,8 +1342,8 @@
     },
     {
       "cluster": "ai-coding-agents",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/context7-tutorial/index.md",
-      "index_path": "tutorials/context7-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/context7-tutorial/README.md",
+      "index_path": "tutorials/context7-tutorial/README.md",
       "intent_signals": [
         "agentic-coding"
       ],
@@ -1375,8 +1375,8 @@
     },
     {
       "cluster": "ai-coding-agents",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/continue-tutorial/index.md",
-      "index_path": "tutorials/continue-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/continue-tutorial/README.md",
+      "index_path": "tutorials/continue-tutorial/README.md",
       "intent_signals": [
         "production-operations",
         "agentic-coding"
@@ -1408,8 +1408,8 @@
     },
     {
       "cluster": "ai-coding-agents",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/copilot-cli-tutorial/index.md",
-      "index_path": "tutorials/copilot-cli-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/copilot-cli-tutorial/README.md",
+      "index_path": "tutorials/copilot-cli-tutorial/README.md",
       "intent_signals": [
         "agentic-coding"
       ],
@@ -1438,8 +1438,8 @@
     },
     {
       "cluster": "ai-app-frameworks",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/copilotkit-tutorial/index.md",
-      "index_path": "tutorials/copilotkit-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/copilotkit-tutorial/README.md",
+      "index_path": "tutorials/copilotkit-tutorial/README.md",
       "intent_signals": [
         "general-learning"
       ],
@@ -1467,8 +1467,8 @@
     },
     {
       "cluster": "mcp-ecosystem",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/create-python-server-tutorial/index.md",
-      "index_path": "tutorials/create-python-server-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/create-python-server-tutorial/README.md",
+      "index_path": "tutorials/create-python-server-tutorial/README.md",
       "intent_signals": [
         "mcp-integration"
       ],
@@ -1500,8 +1500,8 @@
     },
     {
       "cluster": "mcp-ecosystem",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/create-typescript-server-tutorial/index.md",
-      "index_path": "tutorials/create-typescript-server-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/create-typescript-server-tutorial/README.md",
+      "index_path": "tutorials/create-typescript-server-tutorial/README.md",
       "intent_signals": [
         "mcp-integration"
       ],
@@ -1533,8 +1533,8 @@
     },
     {
       "cluster": "ai-coding-agents",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/crewai-tutorial/index.md",
-      "index_path": "tutorials/crewai-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/crewai-tutorial/README.md",
+      "index_path": "tutorials/crewai-tutorial/README.md",
       "intent_signals": [
         "agentic-coding"
       ],
@@ -1566,8 +1566,8 @@
     },
     {
       "cluster": "ai-coding-agents",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/crush-tutorial/index.md",
-      "index_path": "tutorials/crush-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/crush-tutorial/README.md",
+      "index_path": "tutorials/crush-tutorial/README.md",
       "intent_signals": [
         "production-operations",
         "agentic-coding"
@@ -1600,8 +1600,8 @@
     },
     {
       "cluster": "ai-coding-agents",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/daytona-tutorial/index.md",
-      "index_path": "tutorials/daytona-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/daytona-tutorial/README.md",
+      "index_path": "tutorials/daytona-tutorial/README.md",
       "intent_signals": [
         "agentic-coding"
       ],
@@ -1633,8 +1633,8 @@
     },
     {
       "cluster": "general-software",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/deer-flow-tutorial/index.md",
-      "index_path": "tutorials/deer-flow-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/deer-flow-tutorial/README.md",
+      "index_path": "tutorials/deer-flow-tutorial/README.md",
       "intent_signals": [
         "general-learning"
       ],
@@ -1660,8 +1660,8 @@
     },
     {
       "cluster": "ai-coding-agents",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/devika-tutorial/index.md",
-      "index_path": "tutorials/devika-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/devika-tutorial/README.md",
+      "index_path": "tutorials/devika-tutorial/README.md",
       "intent_signals": [
         "production-operations",
         "agentic-coding"
@@ -1694,8 +1694,8 @@
     },
     {
       "cluster": "ai-app-frameworks",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/dify-platform-deep-dive/index.md",
-      "index_path": "tutorials/dify-platform-deep-dive/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/dify-platform-deep-dive/README.md",
+      "index_path": "tutorials/dify-platform-deep-dive/README.md",
       "intent_signals": [
         "architecture-deep-dive"
       ],
@@ -1722,8 +1722,8 @@
     },
     {
       "cluster": "general-software",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/dspy-tutorial/index.md",
-      "index_path": "tutorials/dspy-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/dspy-tutorial/README.md",
+      "index_path": "tutorials/dspy-tutorial/README.md",
       "intent_signals": [
         "general-learning"
       ],
@@ -1752,8 +1752,8 @@
     },
     {
       "cluster": "ai-app-frameworks",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/dyad-tutorial/index.md",
-      "index_path": "tutorials/dyad-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/dyad-tutorial/README.md",
+      "index_path": "tutorials/dyad-tutorial/README.md",
       "intent_signals": [
         "beginner-onboarding",
         "production-operations"
@@ -1781,8 +1781,8 @@
     },
     {
       "cluster": "ai-coding-agents",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/elizaos-tutorial/index.md",
-      "index_path": "tutorials/elizaos-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/elizaos-tutorial/README.md",
+      "index_path": "tutorials/elizaos-tutorial/README.md",
       "intent_signals": [
         "architecture-deep-dive",
         "agentic-coding"
@@ -1801,8 +1801,8 @@
     },
     {
       "cluster": "ai-coding-agents",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/everything-claude-code-tutorial/index.md",
-      "index_path": "tutorials/everything-claude-code-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/everything-claude-code-tutorial/README.md",
+      "index_path": "tutorials/everything-claude-code-tutorial/README.md",
       "intent_signals": [
         "production-operations",
         "agentic-coding"
@@ -1835,8 +1835,8 @@
     },
     {
       "cluster": "general-software",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/fabric-tutorial/index.md",
-      "index_path": "tutorials/fabric-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/fabric-tutorial/README.md",
+      "index_path": "tutorials/fabric-tutorial/README.md",
       "intent_signals": [
         "general-learning"
       ],
@@ -1865,8 +1865,8 @@
     },
     {
       "cluster": "mcp-ecosystem",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/fastmcp-tutorial/index.md",
-      "index_path": "tutorials/fastmcp-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/fastmcp-tutorial/README.md",
+      "index_path": "tutorials/fastmcp-tutorial/README.md",
       "intent_signals": [
         "production-operations",
         "architecture-deep-dive",
@@ -1900,8 +1900,8 @@
     },
     {
       "cluster": "ai-coding-agents",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/figma-context-mcp-tutorial/index.md",
-      "index_path": "tutorials/figma-context-mcp-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/figma-context-mcp-tutorial/README.md",
+      "index_path": "tutorials/figma-context-mcp-tutorial/README.md",
       "intent_signals": [
         "architecture-deep-dive",
         "agentic-coding"
@@ -1931,8 +1931,8 @@
     },
     {
       "cluster": "mcp-ecosystem",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/firecrawl-mcp-server-tutorial/index.md",
-      "index_path": "tutorials/firecrawl-mcp-server-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/firecrawl-mcp-server-tutorial/README.md",
+      "index_path": "tutorials/firecrawl-mcp-server-tutorial/README.md",
       "intent_signals": [
         "mcp-integration"
       ],
@@ -1963,8 +1963,8 @@
     },
     {
       "cluster": "ai-app-frameworks",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/firecrawl-tutorial/index.md",
-      "index_path": "tutorials/firecrawl-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/firecrawl-tutorial/README.md",
+      "index_path": "tutorials/firecrawl-tutorial/README.md",
       "intent_signals": [
         "general-learning"
       ],
@@ -1988,8 +1988,8 @@
     },
     {
       "cluster": "ai-app-frameworks",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/fireproof-tutorial/index.md",
-      "index_path": "tutorials/fireproof-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/fireproof-tutorial/README.md",
+      "index_path": "tutorials/fireproof-tutorial/README.md",
       "intent_signals": [
         "beginner-onboarding"
       ],
@@ -2021,8 +2021,8 @@
     },
     {
       "cluster": "ai-app-frameworks",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/flowise-llm-orchestration/index.md",
-      "index_path": "tutorials/flowise-llm-orchestration/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/flowise-llm-orchestration/README.md",
+      "index_path": "tutorials/flowise-llm-orchestration/README.md",
       "intent_signals": [
         "architecture-deep-dive"
       ],
@@ -2048,8 +2048,8 @@
     },
     {
       "cluster": "ai-coding-agents",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/gemini-cli-tutorial/index.md",
-      "index_path": "tutorials/gemini-cli-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/gemini-cli-tutorial/README.md",
+      "index_path": "tutorials/gemini-cli-tutorial/README.md",
       "intent_signals": [
         "beginner-onboarding",
         "production-operations",
@@ -2083,8 +2083,8 @@
     },
     {
       "cluster": "mcp-ecosystem",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/genai-toolbox-tutorial/index.md",
-      "index_path": "tutorials/genai-toolbox-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/genai-toolbox-tutorial/README.md",
+      "index_path": "tutorials/genai-toolbox-tutorial/README.md",
       "intent_signals": [
         "beginner-onboarding",
         "production-operations",
@@ -2118,8 +2118,8 @@
     },
     {
       "cluster": "ai-coding-agents",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/github-mcp-server-tutorial/index.md",
-      "index_path": "tutorials/github-mcp-server-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/github-mcp-server-tutorial/README.md",
+      "index_path": "tutorials/github-mcp-server-tutorial/README.md",
       "intent_signals": [
         "production-operations",
         "agentic-coding"
@@ -2151,8 +2151,8 @@
     },
     {
       "cluster": "ai-coding-agents",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/goose-tutorial/index.md",
-      "index_path": "tutorials/goose-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/goose-tutorial/README.md",
+      "index_path": "tutorials/goose-tutorial/README.md",
       "intent_signals": [
         "production-operations",
         "agentic-coding"
@@ -2185,8 +2185,8 @@
     },
     {
       "cluster": "ai-app-frameworks",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/gpt-oss-tutorial/index.md",
-      "index_path": "tutorials/gpt-oss-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/gpt-oss-tutorial/README.md",
+      "index_path": "tutorials/gpt-oss-tutorial/README.md",
       "intent_signals": [
         "production-operations",
         "architecture-deep-dive"
@@ -2213,8 +2213,8 @@
     },
     {
       "cluster": "ai-coding-agents",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/gptme-tutorial/index.md",
-      "index_path": "tutorials/gptme-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/gptme-tutorial/README.md",
+      "index_path": "tutorials/gptme-tutorial/README.md",
       "intent_signals": [
         "beginner-onboarding",
         "agentic-coding"
@@ -2247,8 +2247,8 @@
     },
     {
       "cluster": "ai-coding-agents",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/hapi-tutorial/index.md",
-      "index_path": "tutorials/hapi-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/hapi-tutorial/README.md",
+      "index_path": "tutorials/hapi-tutorial/README.md",
       "intent_signals": [
         "beginner-onboarding",
         "agentic-coding"
@@ -2281,8 +2281,8 @@
     },
     {
       "cluster": "rag-and-retrieval",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/haystack-tutorial/index.md",
-      "index_path": "tutorials/haystack-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/haystack-tutorial/README.md",
+      "index_path": "tutorials/haystack-tutorial/README.md",
       "intent_signals": [
         "production-operations",
         "architecture-deep-dive",
@@ -2310,8 +2310,8 @@
     },
     {
       "cluster": "ai-app-frameworks",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/huggingface-tutorial/index.md",
-      "index_path": "tutorials/huggingface-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/huggingface-tutorial/README.md",
+      "index_path": "tutorials/huggingface-tutorial/README.md",
       "intent_signals": [
         "general-learning"
       ],
@@ -2333,8 +2333,8 @@
     },
     {
       "cluster": "ai-coding-agents",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/humanlayer-tutorial/index.md",
-      "index_path": "tutorials/humanlayer-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/humanlayer-tutorial/README.md",
+      "index_path": "tutorials/humanlayer-tutorial/README.md",
       "intent_signals": [
         "agentic-coding"
       ],
@@ -2363,8 +2363,8 @@
     },
     {
       "cluster": "general-software",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/instructor-tutorial/index.md",
-      "index_path": "tutorials/instructor-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/instructor-tutorial/README.md",
+      "index_path": "tutorials/instructor-tutorial/README.md",
       "intent_signals": [
         "general-learning"
       ],
@@ -2389,8 +2389,8 @@
     },
     {
       "cluster": "general-software",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/khoj-tutorial/index.md",
-      "index_path": "tutorials/khoj-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/khoj-tutorial/README.md",
+      "index_path": "tutorials/khoj-tutorial/README.md",
       "intent_signals": [
         "architecture-deep-dive"
       ],
@@ -2416,8 +2416,8 @@
     },
     {
       "cluster": "ai-coding-agents",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/kilocode-tutorial/index.md",
-      "index_path": "tutorials/kilocode-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/kilocode-tutorial/README.md",
+      "index_path": "tutorials/kilocode-tutorial/README.md",
       "intent_signals": [
         "agentic-coding"
       ],
@@ -2449,8 +2449,8 @@
     },
     {
       "cluster": "ai-coding-agents",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/kimi-cli-tutorial/index.md",
-      "index_path": "tutorials/kimi-cli-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/kimi-cli-tutorial/README.md",
+      "index_path": "tutorials/kimi-cli-tutorial/README.md",
       "intent_signals": [
         "agentic-coding"
       ],
@@ -2482,8 +2482,8 @@
     },
     {
       "cluster": "ai-coding-agents",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/kiro-tutorial/index.md",
-      "index_path": "tutorials/kiro-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/kiro-tutorial/README.md",
+      "index_path": "tutorials/kiro-tutorial/README.md",
       "intent_signals": [
         "agentic-coding"
       ],
@@ -2514,8 +2514,8 @@
     },
     {
       "cluster": "systems-and-internals",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/kubernetes-operator-patterns/index.md",
-      "index_path": "tutorials/kubernetes-operator-patterns/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/kubernetes-operator-patterns/README.md",
+      "index_path": "tutorials/kubernetes-operator-patterns/README.md",
       "intent_signals": [
         "production-operations"
       ],
@@ -2546,8 +2546,8 @@
     },
     {
       "cluster": "rag-and-retrieval",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/lancedb-tutorial/index.md",
-      "index_path": "tutorials/lancedb-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/lancedb-tutorial/README.md",
+      "index_path": "tutorials/lancedb-tutorial/README.md",
       "intent_signals": [
         "architecture-deep-dive",
         "rag-implementation"
@@ -2574,8 +2574,8 @@
     },
     {
       "cluster": "ai-app-frameworks",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/langchain-architecture-guide/index.md",
-      "index_path": "tutorials/langchain-architecture-guide/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/langchain-architecture-guide/README.md",
+      "index_path": "tutorials/langchain-architecture-guide/README.md",
       "intent_signals": [
         "architecture-deep-dive"
       ],
@@ -2595,8 +2595,8 @@
     },
     {
       "cluster": "ai-app-frameworks",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/langchain-tutorial/index.md",
-      "index_path": "tutorials/langchain-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/langchain-tutorial/README.md",
+      "index_path": "tutorials/langchain-tutorial/README.md",
       "intent_signals": [
         "general-learning"
       ],
@@ -2626,8 +2626,8 @@
     },
     {
       "cluster": "ai-coding-agents",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/langflow-tutorial/index.md",
-      "index_path": "tutorials/langflow-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/langflow-tutorial/README.md",
+      "index_path": "tutorials/langflow-tutorial/README.md",
       "intent_signals": [
         "production-operations",
         "agentic-coding"
@@ -2656,8 +2656,8 @@
     },
     {
       "cluster": "general-software",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/langfuse-tutorial/index.md",
-      "index_path": "tutorials/langfuse-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/langfuse-tutorial/README.md",
+      "index_path": "tutorials/langfuse-tutorial/README.md",
       "intent_signals": [
         "production-operations"
       ],
@@ -2682,8 +2682,8 @@
     },
     {
       "cluster": "ai-app-frameworks",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/langgraph-tutorial/index.md",
-      "index_path": "tutorials/langgraph-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/langgraph-tutorial/README.md",
+      "index_path": "tutorials/langgraph-tutorial/README.md",
       "intent_signals": [
         "general-learning"
       ],
@@ -2705,8 +2705,8 @@
     },
     {
       "cluster": "ai-coding-agents",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/letta-tutorial/index.md",
-      "index_path": "tutorials/letta-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/letta-tutorial/README.md",
+      "index_path": "tutorials/letta-tutorial/README.md",
       "intent_signals": [
         "agentic-coding"
       ],
@@ -2730,8 +2730,8 @@
     },
     {
       "cluster": "llm-infra-serving",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/litellm-tutorial/index.md",
-      "index_path": "tutorials/litellm-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/litellm-tutorial/README.md",
+      "index_path": "tutorials/litellm-tutorial/README.md",
       "intent_signals": [
         "production-operations"
       ],
@@ -2761,8 +2761,8 @@
     },
     {
       "cluster": "general-software",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/liveblocks-tutorial/index.md",
-      "index_path": "tutorials/liveblocks-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/liveblocks-tutorial/README.md",
+      "index_path": "tutorials/liveblocks-tutorial/README.md",
       "intent_signals": [
         "architecture-deep-dive"
       ],
@@ -2782,8 +2782,8 @@
     },
     {
       "cluster": "llm-infra-serving",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/llama-cpp-tutorial/index.md",
-      "index_path": "tutorials/llama-cpp-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/llama-cpp-tutorial/README.md",
+      "index_path": "tutorials/llama-cpp-tutorial/README.md",
       "intent_signals": [
         "general-learning"
       ],
@@ -2809,8 +2809,8 @@
     },
     {
       "cluster": "general-software",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/llama-factory-tutorial/index.md",
-      "index_path": "tutorials/llama-factory-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/llama-factory-tutorial/README.md",
+      "index_path": "tutorials/llama-factory-tutorial/README.md",
       "intent_signals": [
         "general-learning"
       ],
@@ -2834,8 +2834,8 @@
     },
     {
       "cluster": "rag-and-retrieval",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/llamaindex-tutorial/index.md",
-      "index_path": "tutorials/llamaindex-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/llamaindex-tutorial/README.md",
+      "index_path": "tutorials/llamaindex-tutorial/README.md",
       "intent_signals": [
         "rag-implementation"
       ],
@@ -2857,8 +2857,8 @@
     },
     {
       "cluster": "ai-app-frameworks",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/lobechat-ai-platform/index.md",
-      "index_path": "tutorials/lobechat-ai-platform/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/lobechat-ai-platform/README.md",
+      "index_path": "tutorials/lobechat-ai-platform/README.md",
       "intent_signals": [
         "architecture-deep-dive"
       ],
@@ -2883,8 +2883,8 @@
     },
     {
       "cluster": "llm-infra-serving",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/localai-tutorial/index.md",
-      "index_path": "tutorials/localai-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/localai-tutorial/README.md",
+      "index_path": "tutorials/localai-tutorial/README.md",
       "intent_signals": [
         "general-learning"
       ],
@@ -2912,8 +2912,8 @@
     },
     {
       "cluster": "data-and-storage",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/logseq-knowledge-management/index.md",
-      "index_path": "tutorials/logseq-knowledge-management/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/logseq-knowledge-management/README.md",
+      "index_path": "tutorials/logseq-knowledge-management/README.md",
       "intent_signals": [
         "beginner-onboarding",
         "architecture-deep-dive"
@@ -2939,8 +2939,8 @@
     },
     {
       "cluster": "mcp-ecosystem",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mastra-tutorial/index.md",
-      "index_path": "tutorials/mastra-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mastra-tutorial/README.md",
+      "index_path": "tutorials/mastra-tutorial/README.md",
       "intent_signals": [
         "production-operations",
         "mcp-integration"
@@ -2966,8 +2966,8 @@
     },
     {
       "cluster": "mcp-ecosystem",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-chrome-tutorial/index.md",
-      "index_path": "tutorials/mcp-chrome-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-chrome-tutorial/README.md",
+      "index_path": "tutorials/mcp-chrome-tutorial/README.md",
       "intent_signals": [
         "mcp-integration"
       ],
@@ -2996,8 +2996,8 @@
     },
     {
       "cluster": "mcp-ecosystem",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-csharp-sdk-tutorial/index.md",
-      "index_path": "tutorials/mcp-csharp-sdk-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-csharp-sdk-tutorial/README.md",
+      "index_path": "tutorials/mcp-csharp-sdk-tutorial/README.md",
       "intent_signals": [
         "production-operations",
         "mcp-integration"
@@ -3030,8 +3030,8 @@
     },
     {
       "cluster": "mcp-ecosystem",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-docs-repo-tutorial/index.md",
-      "index_path": "tutorials/mcp-docs-repo-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-docs-repo-tutorial/README.md",
+      "index_path": "tutorials/mcp-docs-repo-tutorial/README.md",
       "intent_signals": [
         "mcp-integration"
       ],
@@ -3059,8 +3059,8 @@
     },
     {
       "cluster": "mcp-ecosystem",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-ext-apps-tutorial/index.md",
-      "index_path": "tutorials/mcp-ext-apps-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-ext-apps-tutorial/README.md",
+      "index_path": "tutorials/mcp-ext-apps-tutorial/README.md",
       "intent_signals": [
         "mcp-integration"
       ],
@@ -3091,8 +3091,8 @@
     },
     {
       "cluster": "mcp-ecosystem",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-go-sdk-tutorial/index.md",
-      "index_path": "tutorials/mcp-go-sdk-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-go-sdk-tutorial/README.md",
+      "index_path": "tutorials/mcp-go-sdk-tutorial/README.md",
       "intent_signals": [
         "production-operations",
         "mcp-integration"
@@ -3122,8 +3122,8 @@
     },
     {
       "cluster": "mcp-ecosystem",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-inspector-tutorial/index.md",
-      "index_path": "tutorials/mcp-inspector-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-inspector-tutorial/README.md",
+      "index_path": "tutorials/mcp-inspector-tutorial/README.md",
       "intent_signals": [
         "mcp-integration"
       ],
@@ -3153,8 +3153,8 @@
     },
     {
       "cluster": "mcp-ecosystem",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-java-sdk-tutorial/index.md",
-      "index_path": "tutorials/mcp-java-sdk-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-java-sdk-tutorial/README.md",
+      "index_path": "tutorials/mcp-java-sdk-tutorial/README.md",
       "intent_signals": [
         "production-operations",
         "mcp-integration"
@@ -3185,8 +3185,8 @@
     },
     {
       "cluster": "mcp-ecosystem",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-kotlin-sdk-tutorial/index.md",
-      "index_path": "tutorials/mcp-kotlin-sdk-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-kotlin-sdk-tutorial/README.md",
+      "index_path": "tutorials/mcp-kotlin-sdk-tutorial/README.md",
       "intent_signals": [
         "production-operations",
         "mcp-integration"
@@ -3219,8 +3219,8 @@
     },
     {
       "cluster": "mcp-ecosystem",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-php-sdk-tutorial/index.md",
-      "index_path": "tutorials/mcp-php-sdk-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-php-sdk-tutorial/README.md",
+      "index_path": "tutorials/mcp-php-sdk-tutorial/README.md",
       "intent_signals": [
         "mcp-integration"
       ],
@@ -3252,8 +3252,8 @@
     },
     {
       "cluster": "mcp-ecosystem",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-python-sdk-tutorial/index.md",
-      "index_path": "tutorials/mcp-python-sdk-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-python-sdk-tutorial/README.md",
+      "index_path": "tutorials/mcp-python-sdk-tutorial/README.md",
       "intent_signals": [
         "mcp-integration"
       ],
@@ -3284,8 +3284,8 @@
     },
     {
       "cluster": "mcp-ecosystem",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-quickstart-resources-tutorial/index.md",
-      "index_path": "tutorials/mcp-quickstart-resources-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-quickstart-resources-tutorial/README.md",
+      "index_path": "tutorials/mcp-quickstart-resources-tutorial/README.md",
       "intent_signals": [
         "mcp-integration"
       ],
@@ -3317,8 +3317,8 @@
     },
     {
       "cluster": "mcp-ecosystem",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-registry-tutorial/index.md",
-      "index_path": "tutorials/mcp-registry-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-registry-tutorial/README.md",
+      "index_path": "tutorials/mcp-registry-tutorial/README.md",
       "intent_signals": [
         "production-operations",
         "mcp-integration"
@@ -3351,8 +3351,8 @@
     },
     {
       "cluster": "mcp-ecosystem",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-ruby-sdk-tutorial/index.md",
-      "index_path": "tutorials/mcp-ruby-sdk-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-ruby-sdk-tutorial/README.md",
+      "index_path": "tutorials/mcp-ruby-sdk-tutorial/README.md",
       "intent_signals": [
         "production-operations",
         "mcp-integration"
@@ -3385,8 +3385,8 @@
     },
     {
       "cluster": "mcp-ecosystem",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-rust-sdk-tutorial/index.md",
-      "index_path": "tutorials/mcp-rust-sdk-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-rust-sdk-tutorial/README.md",
+      "index_path": "tutorials/mcp-rust-sdk-tutorial/README.md",
       "intent_signals": [
         "production-operations",
         "mcp-integration"
@@ -3419,8 +3419,8 @@
     },
     {
       "cluster": "mcp-ecosystem",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-servers-tutorial/index.md",
-      "index_path": "tutorials/mcp-servers-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-servers-tutorial/README.md",
+      "index_path": "tutorials/mcp-servers-tutorial/README.md",
       "intent_signals": [
         "production-operations",
         "mcp-integration"
@@ -3446,8 +3446,8 @@
     },
     {
       "cluster": "mcp-ecosystem",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-specification-tutorial/index.md",
-      "index_path": "tutorials/mcp-specification-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-specification-tutorial/README.md",
+      "index_path": "tutorials/mcp-specification-tutorial/README.md",
       "intent_signals": [
         "production-operations",
         "architecture-deep-dive",
@@ -3481,8 +3481,8 @@
     },
     {
       "cluster": "mcp-ecosystem",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-swift-sdk-tutorial/index.md",
-      "index_path": "tutorials/mcp-swift-sdk-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-swift-sdk-tutorial/README.md",
+      "index_path": "tutorials/mcp-swift-sdk-tutorial/README.md",
       "intent_signals": [
         "mcp-integration"
       ],
@@ -3514,8 +3514,8 @@
     },
     {
       "cluster": "mcp-ecosystem",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-typescript-sdk-tutorial/index.md",
-      "index_path": "tutorials/mcp-typescript-sdk-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-typescript-sdk-tutorial/README.md",
+      "index_path": "tutorials/mcp-typescript-sdk-tutorial/README.md",
       "intent_signals": [
         "production-operations",
         "mcp-integration"
@@ -3544,8 +3544,8 @@
     },
     {
       "cluster": "mcp-ecosystem",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-use-tutorial/index.md",
-      "index_path": "tutorials/mcp-use-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-use-tutorial/README.md",
+      "index_path": "tutorials/mcp-use-tutorial/README.md",
       "intent_signals": [
         "production-operations",
         "mcp-integration"
@@ -3578,8 +3578,8 @@
     },
     {
       "cluster": "mcp-ecosystem",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcpb-tutorial/index.md",
-      "index_path": "tutorials/mcpb-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcpb-tutorial/README.md",
+      "index_path": "tutorials/mcpb-tutorial/README.md",
       "intent_signals": [
         "mcp-integration"
       ],
@@ -3611,8 +3611,8 @@
     },
     {
       "cluster": "data-and-storage",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/meilisearch-tutorial/index.md",
-      "index_path": "tutorials/meilisearch-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/meilisearch-tutorial/README.md",
+      "index_path": "tutorials/meilisearch-tutorial/README.md",
       "intent_signals": [
         "general-learning"
       ],
@@ -3633,8 +3633,8 @@
     },
     {
       "cluster": "ai-coding-agents",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mem0-tutorial/index.md",
-      "index_path": "tutorials/mem0-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mem0-tutorial/README.md",
+      "index_path": "tutorials/mem0-tutorial/README.md",
       "intent_signals": [
         "production-operations",
         "agentic-coding"
@@ -3659,8 +3659,8 @@
     },
     {
       "cluster": "ai-coding-agents",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mini-swe-agent-tutorial/index.md",
-      "index_path": "tutorials/mini-swe-agent-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mini-swe-agent-tutorial/README.md",
+      "index_path": "tutorials/mini-swe-agent-tutorial/README.md",
       "intent_signals": [
         "architecture-deep-dive",
         "agentic-coding"
@@ -3693,8 +3693,8 @@
     },
     {
       "cluster": "ai-coding-agents",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mistral-vibe-tutorial/index.md",
-      "index_path": "tutorials/mistral-vibe-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mistral-vibe-tutorial/README.md",
+      "index_path": "tutorials/mistral-vibe-tutorial/README.md",
       "intent_signals": [
         "agentic-coding"
       ],
@@ -3724,8 +3724,8 @@
     },
     {
       "cluster": "ai-app-frameworks",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/n8n-ai-tutorial/index.md",
-      "index_path": "tutorials/n8n-ai-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/n8n-ai-tutorial/README.md",
+      "index_path": "tutorials/n8n-ai-tutorial/README.md",
       "intent_signals": [
         "general-learning"
       ],
@@ -3747,8 +3747,8 @@
     },
     {
       "cluster": "mcp-ecosystem",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/n8n-mcp-tutorial/index.md",
-      "index_path": "tutorials/n8n-mcp-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/n8n-mcp-tutorial/README.md",
+      "index_path": "tutorials/n8n-mcp-tutorial/README.md",
       "intent_signals": [
         "architecture-deep-dive",
         "mcp-integration"
@@ -3774,8 +3774,8 @@
     },
     {
       "cluster": "ai-coding-agents",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/nanocoder-tutorial/index.md",
-      "index_path": "tutorials/nanocoder-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/nanocoder-tutorial/README.md",
+      "index_path": "tutorials/nanocoder-tutorial/README.md",
       "intent_signals": [
         "beginner-onboarding",
         "agentic-coding"
@@ -3808,8 +3808,8 @@
     },
     {
       "cluster": "data-and-storage",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/nocodb-database-platform/index.md",
-      "index_path": "tutorials/nocodb-database-platform/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/nocodb-database-platform/README.md",
+      "index_path": "tutorials/nocodb-database-platform/README.md",
       "intent_signals": [
         "architecture-deep-dive"
       ],
@@ -3833,8 +3833,8 @@
     },
     {
       "cluster": "systems-and-internals",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/obsidian-outliner-plugin/index.md",
-      "index_path": "tutorials/obsidian-outliner-plugin/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/obsidian-outliner-plugin/README.md",
+      "index_path": "tutorials/obsidian-outliner-plugin/README.md",
       "intent_signals": [
         "architecture-deep-dive"
       ],
@@ -3859,8 +3859,8 @@
     },
     {
       "cluster": "rag-and-retrieval",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/ollama-tutorial/index.md",
-      "index_path": "tutorials/ollama-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/ollama-tutorial/README.md",
+      "index_path": "tutorials/ollama-tutorial/README.md",
       "intent_signals": [
         "production-operations",
         "rag-implementation"
@@ -3888,8 +3888,8 @@
     },
     {
       "cluster": "ai-app-frameworks",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/onlook-tutorial/index.md",
-      "index_path": "tutorials/onlook-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/onlook-tutorial/README.md",
+      "index_path": "tutorials/onlook-tutorial/README.md",
       "intent_signals": [
         "beginner-onboarding",
         "production-operations",
@@ -3923,8 +3923,8 @@
     },
     {
       "cluster": "ai-coding-agents",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/opcode-tutorial/index.md",
-      "index_path": "tutorials/opcode-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/opcode-tutorial/README.md",
+      "index_path": "tutorials/opcode-tutorial/README.md",
       "intent_signals": [
         "beginner-onboarding",
         "agentic-coding"
@@ -3957,8 +3957,8 @@
     },
     {
       "cluster": "ai-coding-agents",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/open-swe-tutorial/index.md",
-      "index_path": "tutorials/open-swe-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/open-swe-tutorial/README.md",
+      "index_path": "tutorials/open-swe-tutorial/README.md",
       "intent_signals": [
         "architecture-deep-dive",
         "agentic-coding"
@@ -3990,8 +3990,8 @@
     },
     {
       "cluster": "ai-app-frameworks",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/open-webui-tutorial/index.md",
-      "index_path": "tutorials/open-webui-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/open-webui-tutorial/README.md",
+      "index_path": "tutorials/open-webui-tutorial/README.md",
       "intent_signals": [
         "production-operations"
       ],
@@ -4023,8 +4023,8 @@
     },
     {
       "cluster": "ai-app-frameworks",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/openai-python-sdk-tutorial/index.md",
-      "index_path": "tutorials/openai-python-sdk-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/openai-python-sdk-tutorial/README.md",
+      "index_path": "tutorials/openai-python-sdk-tutorial/README.md",
       "intent_signals": [
         "beginner-onboarding",
         "production-operations",
@@ -4053,8 +4053,8 @@
     },
     {
       "cluster": "ai-coding-agents",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/openai-realtime-agents-tutorial/index.md",
-      "index_path": "tutorials/openai-realtime-agents-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/openai-realtime-agents-tutorial/README.md",
+      "index_path": "tutorials/openai-realtime-agents-tutorial/README.md",
       "intent_signals": [
         "beginner-onboarding",
         "production-operations",
@@ -4084,8 +4084,8 @@
     },
     {
       "cluster": "ai-app-frameworks",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/openai-whisper-tutorial/index.md",
-      "index_path": "tutorials/openai-whisper-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/openai-whisper-tutorial/README.md",
+      "index_path": "tutorials/openai-whisper-tutorial/README.md",
       "intent_signals": [
         "production-operations"
       ],
@@ -4110,8 +4110,8 @@
     },
     {
       "cluster": "ai-app-frameworks",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/openbb-tutorial/index.md",
-      "index_path": "tutorials/openbb-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/openbb-tutorial/README.md",
+      "index_path": "tutorials/openbb-tutorial/README.md",
       "intent_signals": [
         "general-learning"
       ],
@@ -4134,8 +4134,8 @@
     },
     {
       "cluster": "general-software",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/openclaw-tutorial/index.md",
-      "index_path": "tutorials/openclaw-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/openclaw-tutorial/README.md",
+      "index_path": "tutorials/openclaw-tutorial/README.md",
       "intent_signals": [
         "architecture-deep-dive"
       ],
@@ -4154,8 +4154,8 @@
     },
     {
       "cluster": "ai-coding-agents",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/opencode-ai-legacy-tutorial/index.md",
-      "index_path": "tutorials/opencode-ai-legacy-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/opencode-ai-legacy-tutorial/README.md",
+      "index_path": "tutorials/opencode-ai-legacy-tutorial/README.md",
       "intent_signals": [
         "architecture-deep-dive",
         "agentic-coding"
@@ -4184,8 +4184,8 @@
     },
     {
       "cluster": "ai-coding-agents",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/opencode-tutorial/index.md",
-      "index_path": "tutorials/opencode-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/opencode-tutorial/README.md",
+      "index_path": "tutorials/opencode-tutorial/README.md",
       "intent_signals": [
         "production-operations",
         "agentic-coding"
@@ -4218,8 +4218,8 @@
     },
     {
       "cluster": "ai-coding-agents",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/openhands-tutorial/index.md",
-      "index_path": "tutorials/openhands-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/openhands-tutorial/README.md",
+      "index_path": "tutorials/openhands-tutorial/README.md",
       "intent_signals": [
         "production-operations",
         "agentic-coding"
@@ -4249,8 +4249,8 @@
     },
     {
       "cluster": "ai-coding-agents",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/openskills-tutorial/index.md",
-      "index_path": "tutorials/openskills-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/openskills-tutorial/README.md",
+      "index_path": "tutorials/openskills-tutorial/README.md",
       "intent_signals": [
         "agentic-coding"
       ],
@@ -4282,8 +4282,8 @@
     },
     {
       "cluster": "ai-coding-agents",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/openspec-tutorial/index.md",
-      "index_path": "tutorials/openspec-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/openspec-tutorial/README.md",
+      "index_path": "tutorials/openspec-tutorial/README.md",
       "intent_signals": [
         "agentic-coding"
       ],
@@ -4314,8 +4314,8 @@
     },
     {
       "cluster": "ai-coding-agents",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/opensrc-tutorial/index.md",
-      "index_path": "tutorials/opensrc-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/opensrc-tutorial/README.md",
+      "index_path": "tutorials/opensrc-tutorial/README.md",
       "intent_signals": [
         "agentic-coding"
       ],
@@ -4347,8 +4347,8 @@
     },
     {
       "cluster": "general-software",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/outlines-tutorial/index.md",
-      "index_path": "tutorials/outlines-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/outlines-tutorial/README.md",
+      "index_path": "tutorials/outlines-tutorial/README.md",
       "intent_signals": [
         "general-learning"
       ],
@@ -4369,8 +4369,8 @@
     },
     {
       "cluster": "general-software",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/perplexica-tutorial/index.md",
-      "index_path": "tutorials/perplexica-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/perplexica-tutorial/README.md",
+      "index_path": "tutorials/perplexica-tutorial/README.md",
       "intent_signals": [
         "general-learning"
       ],
@@ -4390,8 +4390,8 @@
     },
     {
       "cluster": "ai-coding-agents",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/phidata-tutorial/index.md",
-      "index_path": "tutorials/phidata-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/phidata-tutorial/README.md",
+      "index_path": "tutorials/phidata-tutorial/README.md",
       "intent_signals": [
         "agentic-coding"
       ],
@@ -4411,8 +4411,8 @@
     },
     {
       "cluster": "general-software",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/photoprism-tutorial/index.md",
-      "index_path": "tutorials/photoprism-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/photoprism-tutorial/README.md",
+      "index_path": "tutorials/photoprism-tutorial/README.md",
       "intent_signals": [
         "general-learning"
       ],
@@ -4443,8 +4443,8 @@
     },
     {
       "cluster": "ai-coding-agents",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/plandex-tutorial/index.md",
-      "index_path": "tutorials/plandex-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/plandex-tutorial/README.md",
+      "index_path": "tutorials/plandex-tutorial/README.md",
       "intent_signals": [
         "production-operations",
         "agentic-coding"
@@ -4477,8 +4477,8 @@
     },
     {
       "cluster": "ai-coding-agents",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/planning-with-files-tutorial/index.md",
-      "index_path": "tutorials/planning-with-files-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/planning-with-files-tutorial/README.md",
+      "index_path": "tutorials/planning-with-files-tutorial/README.md",
       "intent_signals": [
         "agentic-coding"
       ],
@@ -4510,8 +4510,8 @@
     },
     {
       "cluster": "ai-coding-agents",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/playwright-mcp-tutorial/index.md",
-      "index_path": "tutorials/playwright-mcp-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/playwright-mcp-tutorial/README.md",
+      "index_path": "tutorials/playwright-mcp-tutorial/README.md",
       "intent_signals": [
         "agentic-coding"
       ],
@@ -4541,8 +4541,8 @@
     },
     {
       "cluster": "ai-coding-agents",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/pocketflow-tutorial/index.md",
-      "index_path": "tutorials/pocketflow-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/pocketflow-tutorial/README.md",
+      "index_path": "tutorials/pocketflow-tutorial/README.md",
       "intent_signals": [
         "agentic-coding"
       ],
@@ -4574,8 +4574,8 @@
     },
     {
       "cluster": "data-and-storage",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/postgresql-query-planner/index.md",
-      "index_path": "tutorials/postgresql-query-planner/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/postgresql-query-planner/README.md",
+      "index_path": "tutorials/postgresql-query-planner/README.md",
       "intent_signals": [
         "architecture-deep-dive"
       ],
@@ -4603,8 +4603,8 @@
     },
     {
       "cluster": "general-software",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/posthog-tutorial/index.md",
-      "index_path": "tutorials/posthog-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/posthog-tutorial/README.md",
+      "index_path": "tutorials/posthog-tutorial/README.md",
       "intent_signals": [
         "general-learning"
       ],
@@ -4625,8 +4625,8 @@
     },
     {
       "cluster": "ai-coding-agents",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/pydantic-ai-tutorial/index.md",
-      "index_path": "tutorials/pydantic-ai-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/pydantic-ai-tutorial/README.md",
+      "index_path": "tutorials/pydantic-ai-tutorial/README.md",
       "intent_signals": [
         "agentic-coding"
       ],
@@ -4647,8 +4647,8 @@
     },
     {
       "cluster": "rag-and-retrieval",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/quivr-tutorial/index.md",
-      "index_path": "tutorials/quivr-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/quivr-tutorial/README.md",
+      "index_path": "tutorials/quivr-tutorial/README.md",
       "intent_signals": [
         "rag-implementation"
       ],
@@ -4671,8 +4671,8 @@
     },
     {
       "cluster": "mcp-ecosystem",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/qwen-agent-tutorial/index.md",
-      "index_path": "tutorials/qwen-agent-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/qwen-agent-tutorial/README.md",
+      "index_path": "tutorials/qwen-agent-tutorial/README.md",
       "intent_signals": [
         "production-operations",
         "mcp-integration"
@@ -4705,8 +4705,8 @@
     },
     {
       "cluster": "rag-and-retrieval",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/ragflow-tutorial/index.md",
-      "index_path": "tutorials/ragflow-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/ragflow-tutorial/README.md",
+      "index_path": "tutorials/ragflow-tutorial/README.md",
       "intent_signals": [
         "rag-implementation"
       ],
@@ -4733,8 +4733,8 @@
     },
     {
       "cluster": "systems-and-internals",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/react-fiber-internals/index.md",
-      "index_path": "tutorials/react-fiber-internals/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/react-fiber-internals/README.md",
+      "index_path": "tutorials/react-fiber-internals/README.md",
       "intent_signals": [
         "architecture-deep-dive"
       ],
@@ -4757,8 +4757,8 @@
     },
     {
       "cluster": "ai-coding-agents",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/refly-tutorial/index.md",
-      "index_path": "tutorials/refly-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/refly-tutorial/README.md",
+      "index_path": "tutorials/refly-tutorial/README.md",
       "intent_signals": [
         "agentic-coding"
       ],
@@ -4790,8 +4790,8 @@
     },
     {
       "cluster": "ai-coding-agents",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/roo-code-tutorial/index.md",
-      "index_path": "tutorials/roo-code-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/roo-code-tutorial/README.md",
+      "index_path": "tutorials/roo-code-tutorial/README.md",
       "intent_signals": [
         "production-operations",
         "architecture-deep-dive",
@@ -4824,8 +4824,8 @@
     },
     {
       "cluster": "ai-app-frameworks",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/semantic-kernel-tutorial/index.md",
-      "index_path": "tutorials/semantic-kernel-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/semantic-kernel-tutorial/README.md",
+      "index_path": "tutorials/semantic-kernel-tutorial/README.md",
       "intent_signals": [
         "general-learning"
       ],
@@ -4848,8 +4848,8 @@
     },
     {
       "cluster": "ai-coding-agents",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/serena-tutorial/index.md",
-      "index_path": "tutorials/serena-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/serena-tutorial/README.md",
+      "index_path": "tutorials/serena-tutorial/README.md",
       "intent_signals": [
         "agentic-coding"
       ],
@@ -4878,8 +4878,8 @@
     },
     {
       "cluster": "ai-coding-agents",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/shotgun-tutorial/index.md",
-      "index_path": "tutorials/shotgun-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/shotgun-tutorial/README.md",
+      "index_path": "tutorials/shotgun-tutorial/README.md",
       "intent_signals": [
         "agentic-coding"
       ],
@@ -4911,8 +4911,8 @@
     },
     {
       "cluster": "general-software",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/sillytavern-tutorial/index.md",
-      "index_path": "tutorials/sillytavern-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/sillytavern-tutorial/README.md",
+      "index_path": "tutorials/sillytavern-tutorial/README.md",
       "intent_signals": [
         "general-learning"
       ],
@@ -4944,8 +4944,8 @@
     },
     {
       "cluster": "data-and-storage",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/siyuan-tutorial/index.md",
-      "index_path": "tutorials/siyuan-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/siyuan-tutorial/README.md",
+      "index_path": "tutorials/siyuan-tutorial/README.md",
       "intent_signals": [
         "beginner-onboarding"
       ],
@@ -4966,8 +4966,8 @@
     },
     {
       "cluster": "ai-coding-agents",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/smolagents-tutorial/index.md",
-      "index_path": "tutorials/smolagents-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/smolagents-tutorial/README.md",
+      "index_path": "tutorials/smolagents-tutorial/README.md",
       "intent_signals": [
         "agentic-coding"
       ],
@@ -4992,8 +4992,8 @@
     },
     {
       "cluster": "ai-coding-agents",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/stagewise-tutorial/index.md",
-      "index_path": "tutorials/stagewise-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/stagewise-tutorial/README.md",
+      "index_path": "tutorials/stagewise-tutorial/README.md",
       "intent_signals": [
         "agentic-coding"
       ],
@@ -5022,8 +5022,8 @@
     },
     {
       "cluster": "mcp-ecosystem",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/strands-agents-tutorial/index.md",
-      "index_path": "tutorials/strands-agents-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/strands-agents-tutorial/README.md",
+      "index_path": "tutorials/strands-agents-tutorial/README.md",
       "intent_signals": [
         "production-operations",
         "mcp-integration"
@@ -5055,8 +5055,8 @@
     },
     {
       "cluster": "ai-app-frameworks",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/supabase-tutorial/index.md",
-      "index_path": "tutorials/supabase-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/supabase-tutorial/README.md",
+      "index_path": "tutorials/supabase-tutorial/README.md",
       "intent_signals": [
         "general-learning"
       ],
@@ -5077,8 +5077,8 @@
     },
     {
       "cluster": "ai-coding-agents",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/superagi-tutorial/index.md",
-      "index_path": "tutorials/superagi-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/superagi-tutorial/README.md",
+      "index_path": "tutorials/superagi-tutorial/README.md",
       "intent_signals": [
         "production-operations",
         "agentic-coding"
@@ -5099,8 +5099,8 @@
     },
     {
       "cluster": "ai-coding-agents",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/superset-terminal-tutorial/index.md",
-      "index_path": "tutorials/superset-terminal-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/superset-terminal-tutorial/README.md",
+      "index_path": "tutorials/superset-terminal-tutorial/README.md",
       "intent_signals": [
         "agentic-coding"
       ],
@@ -5130,8 +5130,8 @@
     },
     {
       "cluster": "ai-coding-agents",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/swarm-tutorial/index.md",
-      "index_path": "tutorials/swarm-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/swarm-tutorial/README.md",
+      "index_path": "tutorials/swarm-tutorial/README.md",
       "intent_signals": [
         "agentic-coding"
       ],
@@ -5153,8 +5153,8 @@
     },
     {
       "cluster": "ai-coding-agents",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/swe-agent-tutorial/index.md",
-      "index_path": "tutorials/swe-agent-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/swe-agent-tutorial/README.md",
+      "index_path": "tutorials/swe-agent-tutorial/README.md",
       "intent_signals": [
         "agentic-coding"
       ],
@@ -5184,8 +5184,8 @@
     },
     {
       "cluster": "ai-coding-agents",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/sweep-tutorial/index.md",
-      "index_path": "tutorials/sweep-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/sweep-tutorial/README.md",
+      "index_path": "tutorials/sweep-tutorial/README.md",
       "intent_signals": [
         "agentic-coding"
       ],
@@ -5217,8 +5217,8 @@
     },
     {
       "cluster": "ai-coding-agents",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/tabby-tutorial/index.md",
-      "index_path": "tutorials/tabby-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/tabby-tutorial/README.md",
+      "index_path": "tutorials/tabby-tutorial/README.md",
       "intent_signals": [
         "production-operations",
         "architecture-deep-dive",
@@ -5249,8 +5249,8 @@
     },
     {
       "cluster": "taskade-ecosystem",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/taskade-awesome-vibe-coding-tutorial/index.md",
-      "index_path": "tutorials/taskade-awesome-vibe-coding-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/taskade-awesome-vibe-coding-tutorial/README.md",
+      "index_path": "tutorials/taskade-awesome-vibe-coding-tutorial/README.md",
       "intent_signals": [
         "tool-selection"
       ],
@@ -5281,8 +5281,8 @@
     },
     {
       "cluster": "taskade-ecosystem",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/taskade-docs-tutorial/index.md",
-      "index_path": "tutorials/taskade-docs-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/taskade-docs-tutorial/README.md",
+      "index_path": "tutorials/taskade-docs-tutorial/README.md",
       "intent_signals": [
         "general-learning"
       ],
@@ -5313,8 +5313,8 @@
     },
     {
       "cluster": "taskade-ecosystem",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/taskade-mcp-tutorial/index.md",
-      "index_path": "tutorials/taskade-mcp-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/taskade-mcp-tutorial/README.md",
+      "index_path": "tutorials/taskade-mcp-tutorial/README.md",
       "intent_signals": [
         "general-learning"
       ],
@@ -5344,8 +5344,8 @@
     },
     {
       "cluster": "taskade-ecosystem",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/taskade-tutorial/index.md",
-      "index_path": "tutorials/taskade-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/taskade-tutorial/README.md",
+      "index_path": "tutorials/taskade-tutorial/README.md",
       "intent_signals": [
         "production-operations"
       ],
@@ -5374,8 +5374,8 @@
     },
     {
       "cluster": "data-and-storage",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/teable-database-platform/index.md",
-      "index_path": "tutorials/teable-database-platform/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/teable-database-platform/README.md",
+      "index_path": "tutorials/teable-database-platform/README.md",
       "intent_signals": [
         "architecture-deep-dive"
       ],
@@ -5400,8 +5400,8 @@
     },
     {
       "cluster": "ai-coding-agents",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/tiktoken-tutorial/index.md",
-      "index_path": "tutorials/tiktoken-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/tiktoken-tutorial/README.md",
+      "index_path": "tutorials/tiktoken-tutorial/README.md",
       "intent_signals": [
         "agentic-coding"
       ],
@@ -5432,8 +5432,8 @@
     },
     {
       "cluster": "ai-app-frameworks",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/turborepo-tutorial/index.md",
-      "index_path": "tutorials/turborepo-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/turborepo-tutorial/README.md",
+      "index_path": "tutorials/turborepo-tutorial/README.md",
       "intent_signals": [
         "general-learning"
       ],
@@ -5453,8 +5453,8 @@
     },
     {
       "cluster": "mcp-ecosystem",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/use-mcp-tutorial/index.md",
-      "index_path": "tutorials/use-mcp-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/use-mcp-tutorial/README.md",
+      "index_path": "tutorials/use-mcp-tutorial/README.md",
       "intent_signals": [
         "mcp-integration"
       ],
@@ -5486,8 +5486,8 @@
     },
     {
       "cluster": "ai-app-frameworks",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/vercel-ai-tutorial/index.md",
-      "index_path": "tutorials/vercel-ai-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/vercel-ai-tutorial/README.md",
+      "index_path": "tutorials/vercel-ai-tutorial/README.md",
       "intent_signals": [
         "production-operations"
       ],
@@ -5518,8 +5518,8 @@
     },
     {
       "cluster": "ai-coding-agents",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/vibe-kanban-tutorial/index.md",
-      "index_path": "tutorials/vibe-kanban-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/vibe-kanban-tutorial/README.md",
+      "index_path": "tutorials/vibe-kanban-tutorial/README.md",
       "intent_signals": [
         "agentic-coding"
       ],
@@ -5551,8 +5551,8 @@
     },
     {
       "cluster": "ai-coding-agents",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/vibesdk-tutorial/index.md",
-      "index_path": "tutorials/vibesdk-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/vibesdk-tutorial/README.md",
+      "index_path": "tutorials/vibesdk-tutorial/README.md",
       "intent_signals": [
         "production-operations",
         "agentic-coding"
@@ -5579,8 +5579,8 @@
     },
     {
       "cluster": "llm-infra-serving",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/vllm-tutorial/index.md",
-      "index_path": "tutorials/vllm-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/vllm-tutorial/README.md",
+      "index_path": "tutorials/vllm-tutorial/README.md",
       "intent_signals": [
         "general-learning"
       ],
@@ -5610,8 +5610,8 @@
     },
     {
       "cluster": "general-software",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/whisper-cpp-tutorial/index.md",
-      "index_path": "tutorials/whisper-cpp-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/whisper-cpp-tutorial/README.md",
+      "index_path": "tutorials/whisper-cpp-tutorial/README.md",
       "intent_signals": [
         "general-learning"
       ],
@@ -5633,8 +5633,8 @@
     },
     {
       "cluster": "ai-coding-agents",
-      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/wshobson-agents-tutorial/index.md",
-      "index_path": "tutorials/wshobson-agents-tutorial/index.md",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/wshobson-agents-tutorial/README.md",
+      "index_path": "tutorials/wshobson-agents-tutorial/README.md",
       "intent_signals": [
         "agentic-coding"
       ],
diff --git a/discoverability/tutorial-itemlist.schema.json b/discoverability/tutorial-itemlist.schema.json
index 633830b6..1de5b4d5 100644
--- a/discoverability/tutorial-itemlist.schema.json
+++ b/discoverability/tutorial-itemlist.schema.json
@@ -7,1337 +7,1337 @@
       "description": "Learn how to use activepieces/activepieces to build, run, and govern production automation workflows with open-source extensibility, piece development, API control, and self-hosted operations.",
       "name": "Activepieces Tutorial: Open-Source Automation, Pieces, and AI-Ready Workflow Operations",
       "position": 1,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/activepieces-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/activepieces-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn how to use google/adk-python to build, evaluate, and deploy modular AI agent systems with strong tooling, session controls, and production rollouts.",
       "name": "ADK Python Tutorial: Production-Grade Agent Engineering with Google's ADK",
       "position": 2,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/adk-python-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/adk-python-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Build collaborative AI agent systems with AG2, the community-driven successor to AutoGen.",
       "name": "AG2 Tutorial: Next-Generation Multi-Agent Framework",
       "position": 3,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/ag2-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/ag2-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "A deep technical walkthrough of AgentGPT covering Building Autonomous AI Agents.",
       "name": "AgentGPT Tutorial: Building Autonomous AI Agents",
       "position": 4,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/agentgpt-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/agentgpt-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn how to use Fosowl/agenticSeek to run multi-agent planning, browsing, and coding workflows with local model support, Docker-first runtime defaults, and practical operator guardrails.",
       "name": "AgenticSeek Tutorial: Local-First Autonomous Agent Operations",
       "position": 5,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/agenticseek-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/agenticseek-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn how to use agentsmd/agents.md to define a clear, portable instruction contract for coding agents across projects and tools.",
       "name": "AGENTS.md Tutorial: Open Standard for Coding-Agent Guidance in Repositories",
       "position": 6,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/agents-md-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/agents-md-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn how to build and operate learning multi-agent systems with agno-agi/agno, including memory, orchestration, AgentOS runtime, and production guardrails.",
       "name": "Agno Tutorial: Multi-Agent Systems That Learn Over Time",
       "position": 7,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/agno-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/agno-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn to use Aider-AI/aider for real file edits, git-native workflows, model routing, and reliable day-to-day coding loops.",
       "name": "Aider Tutorial: AI Pair Programming in Your Terminal",
       "position": 8,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/aider-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/aider-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "A practical guide to building with Anthropic's API and official SDKs, including messages, tools, vision, streaming, and production operations.",
       "name": "Anthropic API Tutorial: Build Production Apps with Claude",
       "position": 9,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/anthropic-code-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/anthropic-code-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Build and operate production-quality skills for Claude Code, Claude.ai, and the Claude API.",
       "name": "Anthropic Skills Tutorial: Reusable AI Agent Capabilities",
       "position": 10,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/anthropic-skills-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/anthropic-skills-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn how to deploy and operate Mintplex-Labs/anything-llm for document-grounded chat, workspace management, agent workflows, and production use.",
       "name": "AnythingLLM Tutorial: Self-Hosted RAG and Agents Platform",
       "position": 11,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/anything-llm-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/anything-llm-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Athens Research \u2014 An open-source, Roam-like knowledge management system built with ClojureScript and graph databases.",
       "name": "Athens Research: Deep Dive Tutorial",
       "position": 12,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/athens-research-knowledge-graph/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/athens-research-knowledge-graph/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn how to use HKUDS/AutoAgent to create and orchestrate LLM agents through natural-language workflows, with support for CLI operations, tool creation, and benchmark-oriented evaluation.",
       "name": "AutoAgent Tutorial: Zero-Code Agent Creation and Automated Workflow Orchestration",
       "position": 13,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/autoagent-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/autoagent-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "A deep technical walkthrough of Microsoft AutoGen covering Building Multi-Agent AI Systems.",
       "name": "Microsoft AutoGen Tutorial: Building Multi-Agent AI Systems",
       "position": 14,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/autogen-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/autogen-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn how to use hesreallyhim/awesome-claude-code as a high-signal discovery and decision system for skills, commands, hooks, tooling, and CLAUDE.md patterns.",
       "name": "Awesome Claude Code Tutorial: Curated Claude Code Resource Discovery and Evaluation",
       "position": 15,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/awesome-claude-code-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/awesome-claude-code-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn how to use ComposioHQ/awesome-claude-skills to discover, evaluate, install, and contribute Claude skills for coding, automation, writing, and cross-app workflows.",
       "name": "Awesome Claude Skills Tutorial: High-Signal Skill Discovery and Reuse for Claude Workflows",
       "position": 16,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/awesome-claude-skills-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/awesome-claude-skills-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn how to use punkpeye/awesome-mcp-servers as a practical control surface for discovering, vetting, and operating Model Context Protocol servers across coding, data, browser automation, and enterprise workflows.",
       "name": "Awesome MCP Servers Tutorial: Curating and Operating High-Signal MCP Integrations",
       "position": 17,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/awesome-mcp-servers-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/awesome-mcp-servers-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn how to use awslabs/mcp to compose, run, and govern AWS-focused MCP servers across development, infrastructure, data, and operations workflows.",
       "name": "awslabs/mcp Tutorial: Operating a Large-Scale MCP Server Ecosystem for AWS Workloads",
       "position": 18,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/awslabs-mcp-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/awslabs-mcp-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn how to use yoheinakajima/babyagi for autonomous task generation, execution, and prioritization\u2014the foundational agent loop that started the autonomous AI agent wave.",
       "name": "BabyAGI Tutorial: The Original Autonomous AI Task Agent Framework",
       "position": 19,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/babyagi-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/babyagi-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn how to use steveyegge/beads to give coding agents durable, dependency-aware task memory with structured issue graphs instead of ad-hoc markdown plans.",
       "name": "Beads Tutorial: Git-Backed Task Graph Memory for Coding Agents",
       "position": 20,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/beads-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/beads-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "A deep technical walkthrough of BentoML covering Building Production-Ready ML Services.",
       "name": "BentoML Tutorial: Building Production-Ready ML Services",
       "position": 21,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/bentoml-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/bentoml-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "A production-focused deep dive into stackblitz-labs/bolt.diy: architecture, provider routing, safe edit loops, MCP integrations, deployment choices, and operational governance.",
       "name": "bolt.diy Tutorial: Build and Operate an Open Source AI App Builder",
       "position": 22,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/bolt-diy-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/bolt-diy-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "This comprehensive tutorial will guide you through Botpress, a powerful open source platform for building conversational AI applications",
       "name": "Botpress Tutorial: Open Source Conversational AI Platform",
       "position": 23,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/botpress-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/botpress-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn how to use browser-use/browser-use to build agents that can navigate websites, execute workflows, and run reliable browser automation in production.",
       "name": "Browser Use Tutorial: AI-Powered Web Automation Agents",
       "position": 24,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/browser-use-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/browser-use-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "A deep technical walkthrough of Chatbox covering Building Modern AI Chat Interfaces.",
       "name": "Chatbox Tutorial: Building Modern AI Chat Interfaces",
       "position": 25,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/chatbox-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/chatbox-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn how to use CherryHQ/cherry-studio to run multi-provider AI workflows, manage assistants, and integrate MCP tools in a desktop-first productivity environment.",
       "name": "Cherry Studio Tutorial: Multi-Provider AI Desktop Workspace for Teams",
       "position": 26,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/cherry-studio-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/cherry-studio-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "A deep technical walkthrough of ChromaDB covering Building AI-Native Vector Databases.",
       "name": "ChromaDB Tutorial: Building AI-Native Vector Databases",
       "position": 27,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/chroma-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/chroma-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn how to use ChromeDevTools/chrome-devtools-mcp to give coding agents reliable browser control, performance tracing, and deep debugging capabilities.",
       "name": "Chrome DevTools MCP Tutorial: Browser Automation and Debugging for Coding Agents",
       "position": 28,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/chrome-devtools-mcp-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/chrome-devtools-mcp-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn how to use campfirein/cipher as a memory-centric MCP-enabled layer that preserves and shares coding context across IDEs, agents, and teams.",
       "name": "Cipher Tutorial: Shared Memory Layer for Coding Agents",
       "position": 29,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/cipher-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/cipher-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn how to use musistudio/claude-code-router to route Claude Code workloads across multiple model providers with configurable routing rules, transformers, presets, and operational controls.",
       "name": "Claude Code Router Tutorial: Multi-Provider Routing and Control Plane for Claude Code",
       "position": 30,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/claude-code-router-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/claude-code-router-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn how to use anthropics/claude-code for codebase understanding, multi-file edits, command execution, git workflows, and MCP-based extension.",
       "name": "Claude Code Tutorial: Agentic Coding from Your Terminal",
       "position": 31,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/claude-code-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/claude-code-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn how to use ruvnet/claude-flow to orchestrate multi-agent workflows, operate MCP/CLI surfaces, and reason about V2-to-V3 architecture and migration tradeoffs.",
       "name": "Claude Flow Tutorial: Multi-Agent Orchestration, MCP Tooling, and V3 Module Architecture",
       "position": 32,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/claude-flow-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/claude-flow-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn how to use thedotmack/claude-mem to capture, compress, and retrieve coding-session memory with hook-driven automation, searchable context layers, and operator controls.",
       "name": "Claude-Mem Tutorial: Persistent Memory Compression for Claude Code",
       "position": 33,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/claude-mem-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/claude-mem-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn how to use anthropics/claude-plugins-official to discover, evaluate, install, and contribute Claude Code plugins with clear directory standards and plugin safety practices.",
       "name": "Claude Plugins Official Tutorial: Anthropic's Managed Plugin Directory",
       "position": 34,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/claude-plugins-official-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/claude-plugins-official-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn from Anthropic's official quickstart projects to build deployable applications with Claude API, including customer support, data analysis, browser automation, and autonomous coding.",
       "name": "Claude Quickstarts Tutorial: Production Integration Patterns",
       "position": 35,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/claude-quickstarts-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/claude-quickstarts-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn how to use smtg-ai/claude-squad to run and manage multiple coding-agent sessions across isolated workspaces with tmux and git worktrees.",
       "name": "Claude Squad Tutorial: Multi-Agent Terminal Session Orchestration",
       "position": 36,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/claude-squad-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/claude-squad-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "A deep technical walkthrough of Claude Task Master covering AI-Powered Task Management for Developers.",
       "name": "Claude Task Master Tutorial: AI-Powered Task Management for Developers",
       "position": 37,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/claude-task-master-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/claude-task-master-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "A deep technical walkthrough of ClickHouse covering High-Performance Analytical Database.",
       "name": "ClickHouse Tutorial: High-Performance Analytical Database",
       "position": 38,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/clickhouse-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/clickhouse-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "A practical engineering guide to cline/cline: install, operate, and govern Cline across local development and team environments.",
       "name": "Cline Tutorial: Agentic Coding with Human Control",
       "position": 39,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/cline-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/cline-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn how to use moazbuilds/CodeMachine-CLI to orchestrate repeatable coding-agent workflows with multi-agent coordination, context control, and long-running execution.",
       "name": "CodeMachine CLI Tutorial: Orchestrating Long-Running Coding Agent Workflows",
       "position": 40,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/codemachine-cli-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/codemachine-cli-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Design and operate a production-grade code analysis platform with parsing, symbol resolution, code intelligence features, LSP integration, and rollout governance.",
       "name": "Codex Analysis Platform Tutorial: Build Code Intelligence Systems",
       "position": 41,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/codex-analysis-platform/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/codex-analysis-platform/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn how to use openai/codex to run a lightweight coding agent locally, with strong controls for auth, configuration, MCP integration, and sandboxed execution.",
       "name": "Codex CLI Tutorial: Local Terminal Agent Workflows with OpenAI Codex",
       "position": 42,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/codex-cli-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/codex-cli-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "A deep technical walkthrough of ComfyUI covering Mastering AI Image Generation Workflows.",
       "name": "ComfyUI Tutorial: Mastering AI Image Generation Workflows",
       "position": 43,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/comfyui-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/comfyui-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn how to use ComposioHQ/composio to connect agents to 800+ toolkits with session-aware discovery, robust authentication flows, provider integrations, MCP support, and event-trigger automation.",
       "name": "Composio Tutorial: Production Tool and Authentication Infrastructure for AI Agents",
       "position": 44,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/composio-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/composio-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn how to use EveryInc/compound-engineering-plugin to run compound engineering workflows in Claude Code and convert plugin assets for other coding-agent ecosystems.",
       "name": "Compound Engineering Plugin Tutorial: Compounding Agent Workflows Across Toolchains",
       "position": 45,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/compound-engineering-plugin-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/compound-engineering-plugin-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn how to use upstash/context7 to inject up-to-date, version-aware library docs into Claude Code, Cursor, and other MCP-capable coding agents.",
       "name": "Context7 Tutorial: Live Documentation Context for Coding Agents",
       "position": 46,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/context7-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/context7-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "A practical guide to continuedev/continue, covering IDE usage, headless/CLI workflows, model configuration, team collaboration, and enterprise operations.",
       "name": "Continue Tutorial: Open-Source AI Coding Agents for IDE and CLI",
       "position": 47,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/continue-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/continue-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn how to use github/copilot-cli to run Copilot's coding agent directly from the terminal with GitHub-native context, approval controls, and extensibility through MCP and LSP.",
       "name": "GitHub Copilot CLI Tutorial: Copilot Agent Workflows in the Terminal",
       "position": 48,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/copilot-cli-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/copilot-cli-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Create in-app AI assistants, chatbots, and agentic UIs with the open-source CopilotKit framework.",
       "name": "CopilotKit Tutorial: Building AI Copilots for React Applications",
       "position": 49,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/copilotkit-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/copilotkit-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn how to use modelcontextprotocol/create-python-server to scaffold Python MCP servers with minimal setup, template-driven primitives, and publish-ready packaging workflows.",
       "name": "Create Python Server Tutorial: Scaffold and Ship MCP Servers with uvx",
       "position": 50,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/create-python-server-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/create-python-server-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn how to use modelcontextprotocol/create-typescript-server to scaffold MCP server projects quickly, understand generated template structure, and operate build/debug workflows safely in archived-tooling environments.",
       "name": "Create TypeScript Server Tutorial: Scaffold MCP Servers with TypeScript Templates",
       "position": 51,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/create-typescript-server-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/create-typescript-server-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "CrewAI View Repo is a framework for orchestrating role-based AI agent teams that collaborate to accomplish complex tasks. It provides a structured approach to creating AI crews with specialized agents, tools, and processes, enabling sophisticated multi-agent workflows and collaborative problem-solving.",
       "name": "CrewAI Tutorial: Building Collaborative AI Agent Teams",
       "position": 52,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/crewai-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/crewai-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn how to use charmbracelet/crush for terminal-native coding workflows with flexible model providers, LSP/MCP integrations, and production-grade controls.",
       "name": "Crush Tutorial: Multi-Model Terminal Coding Agent with Strong Extensibility",
       "position": 53,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/crush-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/crush-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn how to use daytonaio/daytona to run AI-generated code in isolated sandboxes, integrate coding agents through MCP, and operate sandbox infrastructure with stronger security and resource controls.",
       "name": "Daytona Tutorial: Secure Sandbox Infrastructure for AI-Generated Code",
       "position": 54,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/daytona-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/daytona-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Orchestrate complex distributed workflows with Deer Flow's powerful task coordination and execution platform.",
       "name": "Deer Flow Tutorial: Distributed Workflow Orchestration Platform",
       "position": 55,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/deer-flow-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/deer-flow-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn how to deploy and operate stitionai/devika \u2014 a multi-agent autonomous coding system that plans, researches, writes, and debugs code end-to-end.",
       "name": "Devika Tutorial: Open-Source Autonomous AI Software Engineer",
       "position": 56,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/devika-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/devika-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Dify \u2014 An open-source LLM application development platform for building workflows, RAG pipelines, and AI agents with a visual interface.",
       "name": "Dify Platform: Deep Dive Tutorial",
       "position": 57,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/dify-platform-deep-dive/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/dify-platform-deep-dive/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn to program language models declaratively with DSPy, the Stanford NLP framework for systematic prompt optimization and modular LLM pipelines.",
       "name": "DSPy Tutorial: Programming Language Models",
       "position": 58,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/dspy-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/dspy-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "A practical guide to dyad-sh/dyad, focused on local-first app generation, integration patterns, validation loops, and deployment readiness.",
       "name": "Dyad Tutorial: Local-First AI App Building",
       "position": 59,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/dyad-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/dyad-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "ElizaOS \u2014 Autonomous agents for everyone.",
       "name": "ElizaOS: Deep Dive Tutorial",
       "position": 60,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/elizaos-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/elizaos-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn how to use affaan-m/everything-claude-code to adopt battle-tested Claude Code agents, skills, hooks, commands, rules, and MCP workflows in a structured, production-oriented way.",
       "name": "Everything Claude Code Tutorial: Production Configuration Patterns for Claude Code",
       "position": 61,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/everything-claude-code-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/everything-claude-code-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Enhance human capabilities with Fabric's modular framework for AI-powered cognitive assistance and task automation.",
       "name": "Fabric Tutorial: Open-Source Framework for Augmenting Humans with AI",
       "position": 62,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/fabric-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/fabric-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn how to use jlowin/fastmcp to design, run, test, and deploy MCP servers and clients with practical transport, integration, auth, and operations patterns.",
       "name": "FastMCP Tutorial: Building and Operating MCP Servers with Pythonic Control",
       "position": 63,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/fastmcp-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/fastmcp-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn how to use GLips/Figma-Context-MCP (Framelink MCP for Figma) to give coding agents structured design context for higher-fidelity implementation.",
       "name": "Figma Context MCP Tutorial: Design-to-Code Workflows for Coding Agents",
       "position": 64,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/figma-context-mcp-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/figma-context-mcp-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn how to use firecrawl/firecrawl-mcp-server to add robust web scraping, crawling, search, and extraction capabilities to MCP-enabled coding and research agents.",
       "name": "Firecrawl MCP Server Tutorial: Web Scraping and Search Tools for MCP Clients",
       "position": 65,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/firecrawl-mcp-server-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/firecrawl-mcp-server-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Deep technical walkthrough of Firecrawl Tutorial: Building LLM-Ready Web Scraping and Data Extraction Systems.",
       "name": "Firecrawl Tutorial: Building LLM-Ready Web Scraping and Data Extraction Systems",
       "position": 66,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/firecrawl-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/firecrawl-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn how to use fireproof-storage/fireproof to build local-first, encrypted, sync-capable applications with a unified browser/Node/Deno API and React hooks.",
       "name": "Fireproof Tutorial: Local-First Document Database for AI-Native Apps",
       "position": 67,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/fireproof-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/fireproof-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Flowise \u2014 An open-source visual tool for building LLM workflows with a drag-and-drop interface.",
       "name": "Flowise LLM Orchestration: Deep Dive Tutorial",
       "position": 68,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/flowise-llm-orchestration/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/flowise-llm-orchestration/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn how to use google-gemini/gemini-cli to run coding and operations workflows in terminal-first loops with strong tooling, MCP extensibility, headless automation, and safety controls.",
       "name": "Gemini CLI Tutorial: Terminal-First Agent Workflows with Google Gemini",
       "position": 69,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/gemini-cli-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/gemini-cli-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn how to use googleapis/genai-toolbox to expose database tools through MCP and native SDK paths, with stronger configuration discipline, deployment options, and observability controls.",
       "name": "GenAI Toolbox Tutorial: MCP-First Database Tooling with Config-Driven Control Planes",
       "position": 70,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/genai-toolbox-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/genai-toolbox-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn how to use github/github-mcp-server to connect coding agents directly to repositories, issues, pull requests, actions, and code security workflows with stronger control.",
       "name": "GitHub MCP Server Tutorial: Production GitHub Operations Through MCP",
       "position": 71,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/github-mcp-server-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/github-mcp-server-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn how to use block/goose to automate coding workflows with controlled tool execution, strong provider flexibility, and production-ready operations.",
       "name": "Goose Tutorial: Extensible Open-Source AI Agent for Real Engineering Work",
       "position": 72,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/goose-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/goose-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "A comprehensive guide to understanding, building, and deploying open-source GPT implementations -- from nanoGPT to GPT-NeoX and beyond.",
       "name": "GPT Open Source: Deep Dive Tutorial",
       "position": 73,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/gpt-oss-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/gpt-oss-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn how to use gptme/gptme to run a local-first coding and knowledge-work agent with strong CLI ergonomics, extensible tools, and automation-friendly modes.",
       "name": "gptme Tutorial: Open-Source Terminal Agent for Local Tool-Driven Work",
       "position": 74,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/gptme-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/gptme-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn tiann/hapi, a local-first hub that lets you run Claude Code/Codex/Gemini/OpenCode sessions locally while controlling and approving them remotely.",
       "name": "HAPI Tutorial: Remote Control for Local AI Coding Sessions",
       "position": 75,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/hapi-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/hapi-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Haystack \u2014 An open-source framework for building production-ready LLM applications, RAG pipelines, and intelligent search systems.",
       "name": "Haystack: Deep Dive Tutorial",
       "position": 76,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/haystack-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/haystack-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "A deep technical walkthrough of HuggingFace Transformers covering Building State-of-the-Art AI Models.",
       "name": "HuggingFace Transformers Tutorial: Building State-of-the-Art AI Models",
       "position": 77,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/huggingface-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/huggingface-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn how to use humanlayer/humanlayer patterns to orchestrate coding agents with stronger context control, human oversight, and team-scale workflows.",
       "name": "HumanLayer Tutorial: Context Engineering and Human-Governed Coding Agents",
       "position": 78,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/humanlayer-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/humanlayer-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Get reliable, typed responses from LLMs with Pydantic validation.",
       "name": "Instructor Tutorial: Structured LLM Outputs",
       "position": 79,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/instructor-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/instructor-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Khoj \u2014 An open-source, self-hostable AI personal assistant that connects to your notes, documents, and online data.",
       "name": "Khoj AI: Deep Dive Tutorial",
       "position": 80,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/khoj-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/khoj-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn how to use Kilo-Org/kilocode for high-throughput coding workflows with multi-mode operation, agent-loop controls, and extensible CLI/IDE integration.",
       "name": "Kilo Code Tutorial: Agentic Engineering from IDE and CLI Surfaces",
       "position": 81,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/kilocode-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/kilocode-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn how to use MoonshotAI/kimi-cli to run an interactive terminal coding agent with configurable modes, MCP integrations, and ACP-based IDE connectivity.",
       "name": "Kimi CLI Tutorial: Multi-Mode Terminal Agent with MCP and ACP",
       "position": 82,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/kimi-cli-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/kimi-cli-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn how to use kirodotdev/Kiro for structured AI-powered development with spec-driven workflows, agent steering, event-driven automation, and AWS-native integrations.",
       "name": "Kiro Tutorial: Spec-Driven Agentic IDE from AWS",
       "position": 83,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/kiro-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/kiro-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Master Kubernetes Operators with hands-on Go implementation using the Operator SDK and controller-runtime library for enterprise application management.",
       "name": "Kubernetes Operator Patterns: Building Production-Grade Controllers",
       "position": 84,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/kubernetes-operator-patterns/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/kubernetes-operator-patterns/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Master LanceDB, the open-source serverless vector database designed for AI applications, RAG systems, and semantic search.",
       "name": "LanceDB Tutorial: Serverless Vector Database for AI",
       "position": 85,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/lancedb-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/lancedb-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Deep technical walkthrough of LangChain Architecture: Internal Design Deep Dive.",
       "name": "LangChain Architecture: Internal Design Deep Dive",
       "position": 86,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/langchain-architecture-guide/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/langchain-architecture-guide/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Pydantic 2 Required: LangChain v0.3 fully migrated to Pydantic 2. Code using langchain_core.pydantic_v1 should be updated to native Pydantic 2 syntax.",
       "name": "LangChain Tutorial: Building AI Applications with Large Language Models",
       "position": 87,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/langchain-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/langchain-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn how to build, deploy, and operate agent workflows with langflow-ai/langflow, including visual flow composition, API/MCP deployment, and production reliability controls.",
       "name": "Langflow Tutorial: Visual AI Agent and Workflow Platform",
       "position": 88,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/langflow-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/langflow-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn how to use langfuse/langfuse to trace, evaluate, and improve production LLM systems with structured observability workflows.",
       "name": "Langfuse Tutorial: LLM Observability, Evaluation, and Prompt Operations",
       "position": 89,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/langfuse-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/langfuse-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "A deep technical walkthrough of LangGraph covering Building Stateful Multi-Actor Applications.",
       "name": "LangGraph Tutorial: Building Stateful Multi-Actor Applications",
       "position": 90,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/langgraph-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/langgraph-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Build AI agents with persistent memory using the framework formerly known as MemGPT.",
       "name": "Letta Tutorial: Stateful LLM Agents",
       "position": 91,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/letta-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/letta-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Build provider-agnostic LLM applications with BerriAI/litellm, including routing, fallbacks, proxy deployment, and cost-aware operations.",
       "name": "LiteLLM Tutorial: Unified LLM Gateway and Routing Layer",
       "position": 92,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/litellm-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/litellm-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Deep technical walkthrough of Liveblocks - Real-Time Collaboration Deep Dive.",
       "name": "Liveblocks - Real-Time Collaboration Deep Dive",
       "position": 93,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/liveblocks-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/liveblocks-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Run large language models efficiently on your local machine with pure C/C++.",
       "name": "llama.cpp Tutorial: Local LLM Inference",
       "position": 94,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/llama-cpp-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/llama-cpp-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "A deep technical walkthrough of LLaMA-Factory covering Unified Framework for LLM Training and Fine-tuning.",
       "name": "LLaMA-Factory Tutorial: Unified Framework for LLM Training and Fine-tuning",
       "position": 95,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/llama-factory-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/llama-factory-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "A deep technical walkthrough of LlamaIndex covering Building Advanced RAG Systems and Data Frameworks.",
       "name": "LlamaIndex Tutorial: Building Advanced RAG Systems and Data Frameworks",
       "position": 96,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/llamaindex-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/llamaindex-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "LobeChat \u2014 An open-source, modern-design AI chat framework for building private LLM applications.",
       "name": "LobeChat AI Platform: Deep Dive Tutorial",
       "position": 97,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/lobechat-ai-platform/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/lobechat-ai-platform/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Run LLMs, image generation, and audio models locally with an OpenAI-compatible API.",
       "name": "LocalAI Tutorial: Self-Hosted OpenAI Alternative",
       "position": 98,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/localai-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/localai-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Logseq \u2014 A privacy-first, local-first knowledge management platform with block-based editing and graph visualization.",
       "name": "Logseq: Deep Dive Tutorial",
       "position": 99,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/logseq-knowledge-management/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/logseq-knowledge-management/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn how to build production AI applications with mastra-ai/mastra, including agents, workflows, memory, MCP tooling, and reliability operations.",
       "name": "Mastra Tutorial: TypeScript Framework for AI Agents and Workflows",
       "position": 100,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mastra-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mastra-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn how to use hangwin/mcp-chrome to expose browser automation, content analysis, and semantic tab search tools to MCP clients.",
       "name": "MCP Chrome Tutorial: Control Your Real Chrome Browser Through MCP",
       "position": 101,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-chrome-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-chrome-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn how to build and operate MCP clients and servers with modelcontextprotocol/csharp-sdk, including package choices, auth patterns, tasks, diagnostics, and versioning strategy.",
       "name": "MCP C# SDK Tutorial: Production MCP in .NET with Hosting, ASP.NET Core, and Task Workflows",
       "position": 102,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-csharp-sdk-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-csharp-sdk-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn how to use modelcontextprotocol/docs as an archived reference, map its conceptual guides, and migrate documentation workflows to the canonical modelcontextprotocol/modelcontextprotocol docs location.",
       "name": "MCP Docs Repo Tutorial: Navigating the Archived MCP Documentation Repository",
       "position": 103,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-docs-repo-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-docs-repo-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn how to use modelcontextprotocol/ext-apps to build interactive MCP Apps, wire host bridges, secure UI resources, and run reliable testing and migration workflows.",
       "name": "MCP Ext Apps Tutorial: Building Interactive MCP Apps and Hosts",
       "position": 104,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-ext-apps-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-ext-apps-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn how to use modelcontextprotocol/go-sdk for production MCP workloads across stdio and streamable HTTP, including auth middleware, conformance, and upgrade planning.",
       "name": "MCP Go SDK Tutorial: Building Robust MCP Clients and Servers in Go",
       "position": 105,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-go-sdk-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-go-sdk-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn how to use modelcontextprotocol/inspector to test MCP servers across stdio, SSE, and streamable HTTP, with safer auth defaults and repeatable CLI automation.",
       "name": "MCP Inspector Tutorial: Debugging and Validating MCP Servers",
       "position": 106,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-inspector-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-inspector-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn how to use modelcontextprotocol/java-sdk across core Java and Spring stacks, from transport setup to conformance and production hardening.",
       "name": "MCP Java SDK Tutorial: Building MCP Clients and Servers with Reactor, Servlet, and Spring",
       "position": 107,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-java-sdk-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-java-sdk-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn how to implement MCP client/server workflows with modelcontextprotocol/kotlin-sdk, including module boundaries, transport choices, capability negotiation, and production lifecycle controls.",
       "name": "MCP Kotlin SDK Tutorial: Building Multiplatform MCP Clients and Servers",
       "position": 108,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-kotlin-sdk-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-kotlin-sdk-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn how to implement MCP server workflows with modelcontextprotocol/php-sdk, including attribute discovery, manual capability registration, transport strategy, session storage, and framework integration patterns.",
       "name": "MCP PHP SDK Tutorial: Building MCP Servers in PHP with Discovery and Transport Flexibility",
       "position": 109,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-php-sdk-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-php-sdk-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Master the Model Context Protocol Python SDK to build custom tool servers that extend Claude and other LLMs with powerful capabilities.",
       "name": "MCP Python SDK Tutorial: Building AI Tool Servers",
       "position": 110,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-python-sdk-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-python-sdk-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn how to use modelcontextprotocol/quickstart-resources as a practical reference for multi-language MCP server/client implementations, protocol smoke testing, and onboarding workflows.",
       "name": "MCP Quickstart Resources Tutorial: Cross-Language MCP Servers and Clients by Example",
       "position": 111,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-quickstart-resources-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-quickstart-resources-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn how modelcontextprotocol/registry works end to end: publishing authenticated server metadata, consuming the API as an aggregator, and operating registry infrastructure safely.",
       "name": "MCP Registry Tutorial: Publishing, Discovery, and Governance for MCP Servers",
       "position": 112,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-registry-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-registry-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn how to implement MCP server/client workflows with modelcontextprotocol/ruby-sdk, including tool/prompt/resource registration, streamable HTTP sessions, structured logging, and release operations.",
       "name": "MCP Ruby SDK Tutorial: Building MCP Servers and Clients in Ruby",
       "position": 113,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-ruby-sdk-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-ruby-sdk-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn how to use modelcontextprotocol/rust-sdk (rmcp) for production MCP clients and servers with strong transport control, macro-driven tooling, OAuth, and async task workflows.",
       "name": "MCP Rust SDK Tutorial: Building High-Performance MCP Services with RMCP",
       "position": 114,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-rust-sdk-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-rust-sdk-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn how to use the official MCP reference servers as implementation blueprints, not drop-in production services.",
       "name": "MCP Servers Tutorial: Reference Implementations and Patterns",
       "position": 115,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-servers-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-servers-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn the current Model Context Protocol directly from modelcontextprotocol/modelcontextprotocol, including lifecycle, transports, security, authorization, and governance workflows.",
       "name": "MCP Specification Tutorial: Designing Production-Grade MCP Clients and Servers From the Source of Truth",
       "position": 116,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-specification-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-specification-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn how to implement MCP client and server workflows with modelcontextprotocol/swift-sdk, including transport options, sampling, batching, and graceful service lifecycle control.",
       "name": "MCP Swift SDK Tutorial: Building MCP Clients and Servers in Swift",
       "position": 117,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-swift-sdk-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-swift-sdk-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn how to use modelcontextprotocol/typescript-sdk to build production MCP clients and servers, migrate from v1 to v2 safely, and validate behavior with conformance workflows.",
       "name": "MCP TypeScript SDK Tutorial: Building and Migrating MCP Clients and Servers in TypeScript",
       "position": 118,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-typescript-sdk-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-typescript-sdk-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn how mcp-use/mcp-use composes agent, client, server, and inspector workflows across Python and TypeScript with practical security and operations patterns.",
       "name": "MCP Use Tutorial: Full-Stack MCP Development Across Agents, Clients, Servers, and Inspector",
       "position": 119,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-use-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-use-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn how to use modelcontextprotocol/mcpb to package local MCP servers into signed .mcpb bundles with manifest metadata, CLI workflows, and distribution-ready operational controls.",
       "name": "MCPB Tutorial: Packaging and Distributing Local MCP Servers as Bundles",
       "position": 120,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcpb-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcpb-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "A deep technical walkthrough of MeiliSearch covering Lightning Fast Search Engine.",
       "name": "MeiliSearch Tutorial: Lightning Fast Search Engine",
       "position": 121,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/meilisearch-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/meilisearch-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "A deep technical walkthrough of Mem0 covering Building Production-Ready AI Agents with Scalable Long-Term Memory.",
       "name": "Mem0 Tutorial: Building Production-Ready AI Agents with Scalable Long-Term Memory",
       "position": 122,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mem0-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mem0-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn how to use SWE-agent/mini-swe-agent to run compact, high-performing software-engineering agent workflows with minimal scaffolding and strong reproducibility.",
       "name": "Mini-SWE-Agent Tutorial: Minimal Autonomous Code Agent Design at Benchmark Scale",
       "position": 123,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mini-swe-agent-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mini-swe-agent-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn how to use mistralai/mistral-vibe for terminal-native coding workflows with configurable agent profiles, skills, subagents, and ACP integrations.",
       "name": "Mistral Vibe Tutorial: Minimal CLI Coding Agent by Mistral",
       "position": 124,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mistral-vibe-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mistral-vibe-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Build powerful AI-powered automations with n8n's visual workflow builder.",
       "name": "n8n AI Tutorial: Workflow Automation with AI",
       "position": 125,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/n8n-ai-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/n8n-ai-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "n8n \u2014 Visual workflow automation with Model Context Protocol (MCP) integration for AI-powered tool use.",
       "name": "n8n Model Context Protocol: Deep Dive Tutorial",
       "position": 126,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/n8n-mcp-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/n8n-mcp-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn how Nano-Collective/nanocoder implements local-first coding-agent workflows, tool execution loops, and multi-provider model integration.",
       "name": "Nanocoder Tutorial: Building and Understanding AI Coding Agents",
       "position": 127,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/nanocoder-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/nanocoder-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "NocoDB \u2014 An open-source Airtable alternative that turns any database into a smart spreadsheet.",
       "name": "NocoDB: Deep Dive Tutorial",
       "position": 128,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/nocodb-database-platform/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/nocodb-database-platform/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Obsidian Outliner \u2014 A plugin that adds outliner-style editing behaviors to Obsidian, demonstrating advanced plugin architecture patterns.",
       "name": "Obsidian Outliner Plugin: Deep Dive Tutorial",
       "position": 129,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/obsidian-outliner-plugin/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/obsidian-outliner-plugin/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn how to use ollama/ollama for local model execution, customization, embeddings/RAG, integration, and production deployment.",
       "name": "Ollama Tutorial: Running and Serving LLMs Locally",
       "position": 130,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/ollama-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/ollama-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn how to use onlook-dev/onlook to design and edit production-grade React apps visually while keeping generated code in your repository.",
       "name": "Onlook Tutorial: Visual-First AI Coding for Next.js and Tailwind",
       "position": 131,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/onlook-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/onlook-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn how to use winfunc/opcode to manage Claude Code projects, sessions, agents, MCP servers, and checkpoints from a desktop-first operating interface.",
       "name": "Opcode Tutorial: GUI Command Center for Claude Code Workflows",
       "position": 132,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/opcode-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/opcode-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn from langchain-ai/open-swe architecture, workflows, and operational patterns, including how to maintain or migrate from a deprecated codebase.",
       "name": "Open SWE Tutorial: Asynchronous Cloud Coding Agent Architecture and Migration Playbook",
       "position": 133,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/open-swe-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/open-swe-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn how to run and operate open-webui/open-webui as a self-hosted AI interface with model routing, RAG workflows, multi-user controls, and production deployment patterns.",
       "name": "Open WebUI Tutorial: Self-Hosted AI Workspace and Chat Interface",
       "position": 134,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/open-webui-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/open-webui-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn how to build reliable Python integrations with openai/openai-python using Responses-first architecture, migration-safe patterns, and production operations.",
       "name": "OpenAI Python SDK Tutorial: Production API Patterns",
       "position": 135,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/openai-python-sdk-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/openai-python-sdk-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn how to build low-latency voice agents with openai/openai-realtime-agents, including realtime session design, tool orchestration, and production rollout patterns.",
       "name": "OpenAI Realtime Agents Tutorial: Voice-First AI Systems",
       "position": 136,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/openai-realtime-agents-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/openai-realtime-agents-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Build robust transcription pipelines with Whisper, from local experiments to production deployment.",
       "name": "OpenAI Whisper Tutorial: Speech Recognition and Translation",
       "position": 137,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/openai-whisper-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/openai-whisper-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Democratize investment research with OpenBB's comprehensive financial data and analysis platform.",
       "name": "OpenBB Tutorial: Complete Guide to Investment Research Platform",
       "position": 138,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/openbb-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/openbb-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "OpenClaw \u2014 Your own personal AI assistant. Any OS. Any Platform.",
       "name": "OpenClaw: Deep Dive Tutorial",
       "position": 139,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/openclaw-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/openclaw-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn from opencode-ai/opencode architecture and workflows, and migrate safely to actively maintained successors.",
       "name": "OpenCode AI Legacy Tutorial: Archived Terminal Agent Workflows and Migration to Crush",
       "position": 140,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/opencode-ai-legacy-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/opencode-ai-legacy-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn how to use anomalyco/opencode to run terminal-native coding agents with provider flexibility, strong tool control, and production-grade workflows.",
       "name": "OpenCode Tutorial: Open-Source Terminal Coding Agent at Scale",
       "position": 141,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/opencode-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/opencode-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn how to operate OpenHands/OpenHands across local GUI, CLI, and SDK workflows with production-minded safety, validation, and integration patterns.",
       "name": "OpenHands Tutorial: Autonomous Software Engineering Workflows",
       "position": 142,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/openhands-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/openhands-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn how to use numman-ali/openskills to install, synchronize, and operate reusable SKILL.md packs across Claude Code, Cursor, Codex, Aider, and other agent environments.",
       "name": "OpenSkills Tutorial: Universal Skill Loading for Coding Agents",
       "position": 143,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/openskills-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/openskills-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn how to use Fission-AI/OpenSpec to make AI-assisted software delivery more predictable with artifact-driven planning, implementation, and archival workflows.",
       "name": "OpenSpec Tutorial: Spec-Driven Workflows for AI Coding Agents",
       "position": 144,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/openspec-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/openspec-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn how to use vercel-labs/opensrc to fetch package and repository source code so coding agents can reason about implementation details, not only public types and docs.",
       "name": "OpenSrc Tutorial: Deep Source Context for Coding Agents",
       "position": 145,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/opensrc-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/opensrc-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "A deep technical walkthrough of Outlines covering Structured Text Generation with LLMs.",
       "name": "Outlines Tutorial: Structured Text Generation with LLMs",
       "position": 146,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/outlines-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/outlines-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "A deep technical walkthrough of Perplexica covering AI-Powered Search Engine.",
       "name": "Perplexica Tutorial: AI-Powered Search Engine",
       "position": 147,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/perplexica-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/perplexica-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "A deep technical walkthrough of Phidata covering Building Autonomous AI Agents.",
       "name": "Phidata Tutorial: Building Autonomous AI Agents",
       "position": 148,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/phidata-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/phidata-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "AI Photo Management Revolution: Enhanced facial recognition, LLM integrations, and advanced organization features mark PhotoPrism's evolution.",
       "name": "PhotoPrism Tutorial: AI-Powered Photos App",
       "position": 149,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/photoprism-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/photoprism-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn how to use plandex-ai/plandex for large codebase tasks with strong context management, cumulative diff review, model packs, and self-hosted operations.",
       "name": "Plandex Tutorial: Large-Task AI Coding Agent Workflows",
       "position": 150,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/plandex-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/plandex-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn how to use OthmanAdi/planning-with-files to run Manus-style file-based planning workflows across Claude Code and other AI coding environments.",
       "name": "Planning with Files Tutorial: Persistent Markdown Workflow Memory for AI Coding Agents",
       "position": 151,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/planning-with-files-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/planning-with-files-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn how to use microsoft/playwright-mcp to give AI coding agents structured browser automation with accessibility snapshots, deterministic actions, and portable MCP host integrations.",
       "name": "Playwright MCP Tutorial: Browser Automation for Coding Agents Through MCP",
       "position": 152,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/playwright-mcp-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/playwright-mcp-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn how to build agentic applications with The-Pocket/PocketFlow, a minimalist graph framework that still supports workflows, multi-agent patterns, RAG, and human-in-the-loop flows.",
       "name": "PocketFlow Tutorial: Minimal LLM Framework with Graph-Based Power",
       "position": 153,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/pocketflow-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/pocketflow-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Master PostgreSQL's query execution engine, understand EXPLAIN output, and optimize complex queries for maximum performance.",
       "name": "PostgreSQL Query Planner Deep Dive",
       "position": 154,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/postgresql-query-planner/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/postgresql-query-planner/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Deep technical walkthrough of PostHog Tutorial: Open Source Product Analytics Platform.",
       "name": "PostHog Tutorial: Open Source Product Analytics Platform",
       "position": 155,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/posthog-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/posthog-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "A deep technical walkthrough of Pydantic AI covering Type-Safe AI Agent Development.",
       "name": "Pydantic AI Tutorial: Type-Safe AI Agent Development",
       "position": 156,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/pydantic-ai-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/pydantic-ai-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Deep technical walkthrough of Quivr Tutorial: Open-Source RAG Framework for Document Ingestion.",
       "name": "Quivr Tutorial: Open-Source RAG Framework for Document Ingestion",
       "position": 157,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/quivr-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/quivr-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn how to use QwenLM/Qwen-Agent to build production-capable agents with function calling, MCP integration, memory/RAG patterns, and benchmark-aware planning workflows.",
       "name": "Qwen-Agent Tutorial: Tool-Enabled Agent Framework with MCP, RAG, and Multi-Modal Workflows",
       "position": 158,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/qwen-agent-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/qwen-agent-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Transform documents into intelligent Q&A systems with RAGFlow's comprehensive RAG (Retrieval-Augmented Generation) platform.",
       "name": "RAGFlow Tutorial: Complete Guide to Open-Source RAG Engine",
       "position": 159,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/ragflow-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/ragflow-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Deep dive into React's reconciliation algorithm, the Fiber architecture that powers modern React applications.",
       "name": "React Fiber Internals",
       "position": 160,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/react-fiber-internals/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/react-fiber-internals/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn how to use refly-ai/refly to turn vibe workflows into reusable, versioned agent skills that can run via API, webhook, and CLI integrations.",
       "name": "Refly Tutorial: Build Deterministic Agent Skills and Ship Them Across APIs and Claude Code",
       "position": 161,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/refly-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/refly-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "A production-focused guide to RooCodeInc/Roo-Code: mode design, task execution, checkpoints, MCP, team profiles, and enterprise operations.",
       "name": "Roo Code Tutorial: Run an AI Dev Team in Your Editor",
       "position": 162,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/roo-code-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/roo-code-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Build enterprise AI applications with Microsoft's SDK for integrating LLMs.",
       "name": "Semantic Kernel Tutorial: Microsoft's AI Orchestration",
       "position": 163,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/semantic-kernel-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/semantic-kernel-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn how to use oraios/serena to give coding agents IDE-grade semantic retrieval and editing tools across large codebases.",
       "name": "Serena Tutorial: Semantic Code Retrieval Toolkit for Coding Agents",
       "position": 164,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/serena-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/serena-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn how to use shotgun-sh/shotgun to plan, specify, and execute large code changes with structured agent workflows and stronger delivery control.",
       "name": "Shotgun Tutorial: Spec-Driven Development for Coding Agents",
       "position": 165,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/shotgun-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/shotgun-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Unlock the full potential of large language models with SillyTavern's comprehensive interface for role-playing, creative writing, and AI experimentation.",
       "name": "SillyTavern Tutorial: Advanced LLM Frontend for Power Users",
       "position": 166,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/sillytavern-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/sillytavern-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "A deep technical walkthrough of SiYuan covering Privacy-First Knowledge Management.",
       "name": "SiYuan Tutorial: Privacy-First Knowledge Management",
       "position": 167,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/siyuan-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/siyuan-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Build efficient AI agents with minimal code using Hugging Face's smolagents library.",
       "name": "Smolagents Tutorial: Hugging Face's Lightweight Agent Framework",
       "position": 168,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/smolagents-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/smolagents-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn how to use stagewise-io/stagewise to connect browser-selected UI context with coding agents, plugin extensions, and multi-agent bridge workflows.",
       "name": "Stagewise Tutorial: Frontend Coding Agent Workflows in Real Browser Context",
       "position": 169,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/stagewise-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/stagewise-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn how to use strands-agents/sdk-python to build lightweight, model-driven agents with strong tool abstractions, hooks, and production deployment patterns.",
       "name": "Strands Agents Tutorial: Model-Driven Agent Systems with Native MCP Support",
       "position": 170,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/strands-agents-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/strands-agents-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Deep technical walkthrough of Supabase Tutorial: Building Modern Backend Applications.",
       "name": "Supabase Tutorial: Building Modern Backend Applications",
       "position": 171,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/supabase-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/supabase-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "A deep technical walkthrough of SuperAGI covering Production-Ready Autonomous AI Agents.",
       "name": "SuperAGI Tutorial: Production-Ready Autonomous AI Agents",
       "position": 172,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/superagi-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/superagi-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn how to use superset-sh/superset to orchestrate many coding agents in parallel with worktree isolation, centralized monitoring, and fast review loops.",
       "name": "Superset Terminal Tutorial: Command Center for Parallel Coding Agents",
       "position": 173,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/superset-terminal-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/superset-terminal-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Deep technical walkthrough of OpenAI Swarm Tutorial: Lightweight Multi-Agent Orchestration.",
       "name": "OpenAI Swarm Tutorial: Lightweight Multi-Agent Orchestration",
       "position": 174,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/swarm-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/swarm-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn how to use SWE-agent/SWE-agent for autonomous software engineering workflows, from single-issue runs to benchmark and research-grade evaluation.",
       "name": "SWE-agent Tutorial: Autonomous Repository Repair and Benchmark-Driven Engineering",
       "position": 175,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/swe-agent-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/swe-agent-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn how to use sweepai/sweep to turn GitHub issues into pull requests, operate feedback loops, and run self-hosted or CLI workflows with clear guardrails.",
       "name": "Sweep Tutorial: Issue-to-PR AI Coding Workflows on GitHub",
       "position": 176,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/sweep-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/sweep-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn how to run and extend TabbyML/tabby for production code completion and team knowledge workflows.",
       "name": "Tabby Tutorial: Self-Hosted AI Coding Assistant Architecture and Operations",
       "position": 177,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/tabby-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/tabby-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn how to use and maintain taskade/awesome-vibe-coding as a decision system for AI app builders, coding agents, MCP tooling, and Genesis-centered workflows.",
       "name": "Taskade Awesome Vibe Coding Tutorial: Curating the 2026 AI-Building Landscape",
       "position": 178,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/taskade-awesome-vibe-coding-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/taskade-awesome-vibe-coding-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn how taskade/docs structures product documentation across Genesis, API references, automations, help-center workflows, and release timelines.",
       "name": "Taskade Docs Tutorial: Operating the Living-DNA Documentation Stack",
       "position": 179,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/taskade-docs-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/taskade-docs-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn how to run, extend, and operate taskade/mcp to connect Taskade workspaces, tasks, projects, and AI agents into MCP-compatible clients.",
       "name": "Taskade MCP Tutorial: OpenAPI-Driven MCP Server for Taskade Workflows",
       "position": 180,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/taskade-mcp-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/taskade-mcp-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn how to operate Taskade as an AI-native workspace system: Genesis app generation, AI agents, automations, enterprise controls, and production rollout patterns.",
       "name": "Taskade Tutorial: AI-Native Workspace, Genesis, and Agentic Operations",
       "position": 181,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/taskade-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/taskade-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Teable \u2014 A high-performance, multi-dimensional database platform built on PostgreSQL with real-time collaboration.",
       "name": "Teable: Deep Dive Tutorial",
       "position": 182,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/teable-database-platform/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/teable-database-platform/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Master tiktoken, OpenAI's fast BPE tokenizer, to accurately count tokens, optimize prompts, and reduce API costs.",
       "name": "tiktoken Tutorial: OpenAI Token Encoding & Optimization",
       "position": 183,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/tiktoken-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/tiktoken-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "A deep technical walkthrough of Turborepo covering High-Performance Monorepo Build System.",
       "name": "Turborepo Tutorial: High-Performance Monorepo Build System",
       "position": 184,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/turborepo-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/turborepo-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn how to use modelcontextprotocol/use-mcp to connect React apps to MCP servers with OAuth-aware flows, tool/resource/prompt access, and resilient transport lifecycle handling.",
       "name": "use-mcp Tutorial: React Hook Patterns for MCP Client Integration",
       "position": 185,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/use-mcp-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/use-mcp-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Build robust AI product features with vercel/ai, including streaming, structured outputs, tool loops, framework integration, and production deployment patterns.",
       "name": "Vercel AI SDK Tutorial: Production TypeScript AI Apps and Agents",
       "position": 186,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/vercel-ai-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/vercel-ai-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn how to use BloopAI/vibe-kanban to coordinate Claude Code, Codex, Gemini CLI, and other coding agents through a unified orchestration workspace.",
       "name": "Vibe Kanban Tutorial: Multi-Agent Orchestration Board for Coding Workflows",
       "position": 187,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/vibe-kanban-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/vibe-kanban-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn how to use cloudflare/vibesdk to run a prompt-to-app platform with agent orchestration, preview sandboxes, and production deployment on Cloudflare.",
       "name": "VibeSDK Tutorial: Build a Vibe-Coding Platform on Cloudflare",
       "position": 188,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/vibesdk-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/vibesdk-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Master vLLM for blazing-fast, cost-effective large language model inference with advanced optimization techniques.",
       "name": "vLLM Tutorial: High-Performance LLM Inference",
       "position": 189,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/vllm-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/vllm-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "A deep technical walkthrough of Whisper.cpp covering High-Performance Speech Recognition in C/C++.",
       "name": "Whisper.cpp Tutorial: High-Performance Speech Recognition in C/C++",
       "position": 190,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/whisper-cpp-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/whisper-cpp-tutorial/README.md"
     },
     {
       "@type": "ListItem",
       "description": "Learn how to use wshobson/agents to install focused Claude Code plugins, coordinate specialist agents, and run scalable multi-agent workflows with clear model and skill boundaries.",
       "name": "Wshobson Agents Tutorial: Pluginized Multi-Agent Workflows for Claude Code",
       "position": 191,
-      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/wshobson-agents-tutorial/index.md"
+      "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/wshobson-agents-tutorial/README.md"
     }
   ],
   "name": "Awesome Code Docs Tutorial Catalog",
diff --git a/llms-full.txt b/llms-full.txt
index 241879f3..ab23e83c 100644
--- a/llms-full.txt
+++ b/llms-full.txt
@@ -5,1146 +5,1146 @@ Main repository:
 
 ## Activepieces Tutorial: Open-Source Automation, Pieces, and AI-Ready Workflow Operations
 - Path: tutorials/activepieces-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/activepieces-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/activepieces-tutorial/README.md
 - Summary: Learn how to use activepieces/activepieces to build, run, and govern production automation workflows with open-source extensibility, piece development, API control, and self-hosted operations.
 - Keywords: activepieces, open, source, automation, pieces, ready, workflow, operations, run, govern, workflows, extensibility, piece, development, api, control, self, hosted
 
 ## ADK Python Tutorial: Production-Grade Agent Engineering with Google's ADK
 - Path: tutorials/adk-python-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/adk-python-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/adk-python-tutorial/README.md
 - Summary: Learn how to use google/adk-python to build, evaluate, and deploy modular AI agent systems with strong tooling, session controls, and production rollouts.
 - Keywords: adk, python, grade, agent, engineering, google, evaluate, deploy, modular, strong, tooling, session, controls, rollouts
 
 ## AG2 Tutorial: Next-Generation Multi-Agent Framework
 - Path: tutorials/ag2-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/ag2-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/ag2-tutorial/README.md
 - Summary: Build collaborative AI agent systems with AG2, the community-driven successor to AutoGen.
 - Keywords: ag2, next, generation, multi, agent, framework, collaborative, community, driven, successor, autogen
 
 ## AgentGPT Tutorial: Building Autonomous AI Agents
 - Path: tutorials/agentgpt-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/agentgpt-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/agentgpt-tutorial/README.md
 - Summary: A deep technical walkthrough of AgentGPT covering Building Autonomous AI Agents.
 - Keywords: agentgpt, building, autonomous, agents, technical, walkthrough
 
 ## AgenticSeek Tutorial: Local-First Autonomous Agent Operations
 - Path: tutorials/agenticseek-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/agenticseek-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/agenticseek-tutorial/README.md
 - Summary: Learn how to use Fosowl/agenticSeek to run multi-agent planning, browsing, and coding workflows with local model support, Docker-first runtime defaults, and practical operator guardrails.
 - Keywords: agenticseek, local, first, autonomous, agent, operations, fosowl, run, multi, planning, browsing, coding, workflows, model, support, docker, runtime, defaults
 
 ## AGENTS.md Tutorial: Open Standard for Coding-Agent Guidance in Repositories
 - Path: tutorials/agents-md-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/agents-md-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/agents-md-tutorial/README.md
 - Summary: Learn how to use agentsmd/agents.md to define a clear, portable instruction contract for coding agents across projects and tools.
 - Keywords: agents, open, standard, coding, agent, guidance, repositories, agentsmd, define, clear, portable, instruction, contract, projects, tools
 
 ## Agno Tutorial: Multi-Agent Systems That Learn Over Time
 - Path: tutorials/agno-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/agno-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/agno-tutorial/README.md
 - Summary: Learn how to build and operate learning multi-agent systems with agno-agi/agno, including memory, orchestration, AgentOS runtime, and production guardrails.
 - Keywords: agno, multi, agent, over, time, operate, learning, agi, memory, orchestration, agentos, runtime, guardrails
 
 ## Aider Tutorial: AI Pair Programming in Your Terminal
 - Path: tutorials/aider-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/aider-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/aider-tutorial/README.md
 - Summary: Learn to use Aider-AI/aider for real file edits, git-native workflows, model routing, and reliable day-to-day coding loops.
 - Keywords: aider, pair, programming, terminal, real, file, edits, git, native, workflows, model, routing, reliable, day, coding, loops
 
 ## Anthropic API Tutorial: Build Production Apps with Claude
 - Path: tutorials/anthropic-code-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/anthropic-code-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/anthropic-code-tutorial/README.md
 - Summary: A practical guide to building with Anthropic's API and official SDKs, including messages, tools, vision, streaming, and production operations.
 - Keywords: anthropic, code, api, apps, claude, building, official, sdks, messages, tools, vision, streaming, operations
 
 ## Anthropic Skills Tutorial: Reusable AI Agent Capabilities
 - Path: tutorials/anthropic-skills-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/anthropic-skills-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/anthropic-skills-tutorial/README.md
 - Summary: Build and operate production-quality skills for Claude Code, Claude.ai, and the Claude API.
 - Keywords: anthropic, skills, reusable, agent, capabilities, operate, quality, claude, code, api
 
 ## AnythingLLM Tutorial: Self-Hosted RAG and Agents Platform
 - Path: tutorials/anything-llm-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/anything-llm-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/anything-llm-tutorial/README.md
 - Summary: Learn how to deploy and operate Mintplex-Labs/anything-llm for document-grounded chat, workspace management, agent workflows, and production use.
 - Keywords: anything, llm, anythingllm, self, hosted, rag, agents, deploy, operate, mintplex, labs, document, grounded, chat, workspace, management, agent, workflows
 
 ## Athens Research: Deep Dive Tutorial
 - Path: tutorials/athens-research-knowledge-graph
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/athens-research-knowledge-graph/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/athens-research-knowledge-graph/README.md
 - Summary: Athens Research — An open-source, Roam-like knowledge management system built with ClojureScript and graph databases.
 - Keywords: athens, research, knowledge, graph, open, source, roam, like, management, built, clojurescript, databases
 
 ## AutoAgent Tutorial: Zero-Code Agent Creation and Automated Workflow Orchestration
 - Path: tutorials/autoagent-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/autoagent-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/autoagent-tutorial/README.md
 - Summary: Learn how to use HKUDS/AutoAgent to create and orchestrate LLM agents through natural-language workflows, with support for CLI operations, tool creation, and benchmark-oriented evaluation.
 - Keywords: autoagent, zero, code, agent, creation, automated, workflow, orchestration, hkuds, create, orchestrate, llm, agents, natural, language, workflows, support, cli
 
 ## Microsoft AutoGen Tutorial: Building Multi-Agent AI Systems
 - Path: tutorials/autogen-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/autogen-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/autogen-tutorial/README.md
 - Summary: A deep technical walkthrough of Microsoft AutoGen covering Building Multi-Agent AI Systems.
 - Keywords: autogen, microsoft, building, multi, agent, technical, walkthrough
 
 ## Awesome Claude Code Tutorial: Curated Claude Code Resource Discovery and Evaluation
 - Path: tutorials/awesome-claude-code-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/awesome-claude-code-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/awesome-claude-code-tutorial/README.md
 - Summary: Learn how to use hesreallyhim/awesome-claude-code as a high-signal discovery and decision system for skills, commands, hooks, tooling, and CLAUDE.md patterns.
 - Keywords: awesome, claude, code, curated, resource, discovery, evaluation, hesreallyhim, high, signal, decision, skills, commands, hooks, tooling, patterns
 
 ## Awesome Claude Skills Tutorial: High-Signal Skill Discovery and Reuse for Claude Workflows
 - Path: tutorials/awesome-claude-skills-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/awesome-claude-skills-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/awesome-claude-skills-tutorial/README.md
 - Summary: Learn how to use ComposioHQ/awesome-claude-skills to discover, evaluate, install, and contribute Claude skills for coding, automation, writing, and cross-app workflows.
 - Keywords: awesome, claude, skills, high, signal, skill, discovery, reuse, workflows, composiohq, discover, evaluate, install, contribute, coding, automation, writing, cross
 
 ## Awesome MCP Servers Tutorial: Curating and Operating High-Signal MCP Integrations
 - Path: tutorials/awesome-mcp-servers-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/awesome-mcp-servers-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/awesome-mcp-servers-tutorial/README.md
 - Summary: Learn how to use punkpeye/awesome-mcp-servers as a practical control surface for discovering, vetting, and operating Model Context Protocol servers across coding, data, browser automation, and enterprise workflows.
 - Keywords: awesome, mcp, servers, curating, operating, high, signal, integrations, punkpeye, control, surface, discovering, vetting, model, context, protocol, coding, data
 
 ## awslabs/mcp Tutorial: Operating a Large-Scale MCP Server Ecosystem for AWS Workloads
 - Path: tutorials/awslabs-mcp-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/awslabs-mcp-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/awslabs-mcp-tutorial/README.md
 - Summary: Learn how to use awslabs/mcp to compose, run, and govern AWS-focused MCP servers across development, infrastructure, data, and operations workflows.
 - Keywords: awslabs, mcp, operating, large, scale, server, ecosystem, aws, workloads, compose, run, govern, focused, servers, development, infrastructure, data, operations
 
 ## BabyAGI Tutorial: The Original Autonomous AI Task Agent Framework
 - Path: tutorials/babyagi-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/babyagi-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/babyagi-tutorial/README.md
 - Summary: Learn how to use yoheinakajima/babyagi for autonomous task generation, execution, and prioritization—the foundational agent loop that started the autonomous AI agent wave.
 - Keywords: babyagi, original, autonomous, task, agent, framework, yoheinakajima, generation, execution, prioritization, foundational, loop, started, wave
 
 ## Beads Tutorial: Git-Backed Task Graph Memory for Coding Agents
 - Path: tutorials/beads-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/beads-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/beads-tutorial/README.md
 - Summary: Learn how to use steveyegge/beads to give coding agents durable, dependency-aware task memory with structured issue graphs instead of ad-hoc markdown plans.
 - Keywords: beads, git, backed, task, graph, memory, coding, agents, steveyegge, give, durable, dependency, aware, structured, issue, graphs, instead, hoc
 
 ## BentoML Tutorial: Building Production-Ready ML Services
 - Path: tutorials/bentoml-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/bentoml-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/bentoml-tutorial/README.md
 - Summary: A deep technical walkthrough of BentoML covering Building Production-Ready ML Services.
 - Keywords: bentoml, building, ready, services, technical, walkthrough
 
 ## bolt.diy Tutorial: Build and Operate an Open Source AI App Builder
 - Path: tutorials/bolt-diy-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/bolt-diy-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/bolt-diy-tutorial/README.md
 - Summary: A production-focused deep dive into stackblitz-labs/bolt.diy: architecture, provider routing, safe edit loops, MCP integrations, deployment choices, and operational governance.
 - Keywords: bolt, diy, operate, open, source, app, builder, focused, stackblitz, labs, architecture, provider, routing, safe, edit, loops, mcp, integrations
 
 ## Botpress Tutorial: Open Source Conversational AI Platform
 - Path: tutorials/botpress-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/botpress-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/botpress-tutorial/README.md
 - Summary: This comprehensive tutorial will guide you through Botpress, a powerful open source platform for building conversational AI applications
 - Keywords: botpress, open, source, conversational, comprehensive, will, powerful, building, applications
 
 ## Browser Use Tutorial: AI-Powered Web Automation Agents
 - Path: tutorials/browser-use-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/browser-use-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/browser-use-tutorial/README.md
 - Summary: Learn how to use browser-use/browser-use to build agents that can navigate websites, execute workflows, and run reliable browser automation in production.
 - Keywords: browser, powered, web, automation, agents, can, navigate, websites, execute, workflows, run, reliable
 
 ## Chatbox Tutorial: Building Modern AI Chat Interfaces
 - Path: tutorials/chatbox-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/chatbox-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/chatbox-tutorial/README.md
 - Summary: A deep technical walkthrough of Chatbox covering Building Modern AI Chat Interfaces.
 - Keywords: chatbox, building, modern, chat, interfaces, technical, walkthrough
 
 ## Cherry Studio Tutorial: Multi-Provider AI Desktop Workspace for Teams
 - Path: tutorials/cherry-studio-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/cherry-studio-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/cherry-studio-tutorial/README.md
 - Summary: Learn how to use CherryHQ/cherry-studio to run multi-provider AI workflows, manage assistants, and integrate MCP tools in a desktop-first productivity environment.
 - Keywords: cherry, studio, multi, provider, desktop, workspace, teams, cherryhq, run, workflows, manage, assistants, integrate, mcp, tools, first, productivity, environment
 
 ## ChromaDB Tutorial: Building AI-Native Vector Databases
 - Path: tutorials/chroma-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/chroma-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/chroma-tutorial/README.md
 - Summary: A deep technical walkthrough of ChromaDB covering Building AI-Native Vector Databases.
 - Keywords: chroma, chromadb, building, native, vector, databases, technical, walkthrough
 
 ## Chrome DevTools MCP Tutorial: Browser Automation and Debugging for Coding Agents
 - Path: tutorials/chrome-devtools-mcp-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/chrome-devtools-mcp-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/chrome-devtools-mcp-tutorial/README.md
 - Summary: Learn how to use ChromeDevTools/chrome-devtools-mcp to give coding agents reliable browser control, performance tracing, and deep debugging capabilities.
 - Keywords: chrome, devtools, mcp, browser, automation, debugging, coding, agents, chromedevtools, give, reliable, control, performance, tracing, capabilities
 
 ## Cipher Tutorial: Shared Memory Layer for Coding Agents
 - Path: tutorials/cipher-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/cipher-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/cipher-tutorial/README.md
 - Summary: Learn how to use campfirein/cipher as a memory-centric MCP-enabled layer that preserves and shares coding context across IDEs, agents, and teams.
 - Keywords: cipher, shared, memory, layer, coding, agents, campfirein, centric, mcp, enabled, preserves, shares, context, ides, teams
 
 ## Claude Code Router Tutorial: Multi-Provider Routing and Control Plane for Claude Code
 - Path: tutorials/claude-code-router-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/claude-code-router-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/claude-code-router-tutorial/README.md
 - Summary: Learn how to use musistudio/claude-code-router to route Claude Code workloads across multiple model providers with configurable routing rules, transformers, presets, and operational controls.
 - Keywords: claude, code, router, multi, provider, routing, control, plane, musistudio, route, workloads, multiple, model, providers, configurable, rules, transformers, presets
 
 ## Claude Code Tutorial: Agentic Coding from Your Terminal
 - Path: tutorials/claude-code-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/claude-code-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/claude-code-tutorial/README.md
 - Summary: Learn how to use anthropics/claude-code for codebase understanding, multi-file edits, command execution, git workflows, and MCP-based extension.
 - Keywords: claude, code, agentic, coding, terminal, anthropics, codebase, understanding, multi, file, edits, command, execution, git, workflows, mcp, based, extension
 
 ## Claude Flow Tutorial: Multi-Agent Orchestration, MCP Tooling, and V3 Module Architecture
 - Path: tutorials/claude-flow-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/claude-flow-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/claude-flow-tutorial/README.md
 - Summary: Learn how to use ruvnet/claude-flow to orchestrate multi-agent workflows, operate MCP/CLI surfaces, and reason about V2-to-V3 architecture and migration tradeoffs.
 - Keywords: claude, flow, multi, agent, orchestration, mcp, tooling, module, architecture, ruvnet, orchestrate, workflows, operate, cli, surfaces, reason, migration, tradeoffs
 
 ## Claude-Mem Tutorial: Persistent Memory Compression for Claude Code
 - Path: tutorials/claude-mem-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/claude-mem-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/claude-mem-tutorial/README.md
 - Summary: Learn how to use thedotmack/claude-mem to capture, compress, and retrieve coding-session memory with hook-driven automation, searchable context layers, and operator controls.
 - Keywords: claude, mem, persistent, memory, compression, code, thedotmack, capture, compress, retrieve, coding, session, hook, driven, automation, searchable, context, layers
 
 ## Claude Plugins Official Tutorial: Anthropic's Managed Plugin Directory
 - Path: tutorials/claude-plugins-official-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/claude-plugins-official-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/claude-plugins-official-tutorial/README.md
 - Summary: Learn how to use anthropics/claude-plugins-official to discover, evaluate, install, and contribute Claude Code plugins with clear directory standards and plugin safety practices.
 - Keywords: claude, plugins, official, anthropic, managed, plugin, directory, anthropics, discover, evaluate, install, contribute, code, clear, standards, safety, practices
 
 ## Claude Quickstarts Tutorial: Production Integration Patterns
 - Path: tutorials/claude-quickstarts-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/claude-quickstarts-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/claude-quickstarts-tutorial/README.md
 - Summary: Learn from Anthropic's official quickstart projects to build deployable applications with Claude API, including customer support, data analysis, browser automation, and autonomous coding.
 - Keywords: claude, quickstarts, integration, patterns, anthropic, official, quickstart, projects, deployable, applications, api, customer, support, data, analysis, browser, automation, autonomous
 
 ## Claude Squad Tutorial: Multi-Agent Terminal Session Orchestration
 - Path: tutorials/claude-squad-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/claude-squad-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/claude-squad-tutorial/README.md
 - Summary: Learn how to use smtg-ai/claude-squad to run and manage multiple coding-agent sessions across isolated workspaces with tmux and git worktrees.
 - Keywords: claude, squad, multi, agent, terminal, session, orchestration, smtg, run, manage, multiple, coding, sessions, isolated, workspaces, tmux, git, worktrees
 
 ## Claude Task Master Tutorial: AI-Powered Task Management for Developers
 - Path: tutorials/claude-task-master-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/claude-task-master-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/claude-task-master-tutorial/README.md
 - Summary: A deep technical walkthrough of Claude Task Master covering AI-Powered Task Management for Developers.
 - Keywords: claude, task, master, powered, management, developers, technical, walkthrough
 
 ## ClickHouse Tutorial: High-Performance Analytical Database
 - Path: tutorials/clickhouse-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/clickhouse-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/clickhouse-tutorial/README.md
 - Summary: A deep technical walkthrough of ClickHouse covering High-Performance Analytical Database.
 - Keywords: clickhouse, high, performance, analytical, database, technical, walkthrough
 
 ## Cline Tutorial: Agentic Coding with Human Control
 - Path: tutorials/cline-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/cline-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/cline-tutorial/README.md
 - Summary: A practical engineering guide to cline/cline: install, operate, and govern Cline across local development and team environments.
 - Keywords: cline, agentic, coding, human, control, engineering, install, operate, govern, local, development, team, environments
 
 ## CodeMachine CLI Tutorial: Orchestrating Long-Running Coding Agent Workflows
 - Path: tutorials/codemachine-cli-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/codemachine-cli-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/codemachine-cli-tutorial/README.md
 - Summary: Learn how to use moazbuilds/CodeMachine-CLI to orchestrate repeatable coding-agent workflows with multi-agent coordination, context control, and long-running execution.
 - Keywords: codemachine, cli, orchestrating, long, running, coding, agent, workflows, moazbuilds, orchestrate, repeatable, multi, coordination, context, control, execution
 
 ## Codex Analysis Platform Tutorial: Build Code Intelligence Systems
 - Path: tutorials/codex-analysis-platform
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/codex-analysis-platform/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/codex-analysis-platform/README.md
 - Summary: Design and operate a production-grade code analysis platform with parsing, symbol resolution, code intelligence features, LSP integration, and rollout governance.
 - Keywords: codex, analysis, code, intelligence, design, operate, grade, parsing, symbol, resolution, features, lsp, integration, rollout, governance
 
 ## Codex CLI Tutorial: Local Terminal Agent Workflows with OpenAI Codex
 - Path: tutorials/codex-cli-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/codex-cli-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/codex-cli-tutorial/README.md
 - Summary: Learn how to use openai/codex to run a lightweight coding agent locally, with strong controls for auth, configuration, MCP integration, and sandboxed execution.
 - Keywords: codex, cli, local, terminal, agent, workflows, openai, run, lightweight, coding, locally, strong, controls, auth, configuration, mcp, integration, sandboxed
 
 ## ComfyUI Tutorial: Mastering AI Image Generation Workflows
 - Path: tutorials/comfyui-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/comfyui-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/comfyui-tutorial/README.md
 - Summary: A deep technical walkthrough of ComfyUI covering Mastering AI Image Generation Workflows.
 - Keywords: comfyui, mastering, image, generation, workflows, technical, walkthrough
 
 ## Composio Tutorial: Production Tool and Authentication Infrastructure for AI Agents
 - Path: tutorials/composio-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/composio-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/composio-tutorial/README.md
 - Summary: Learn how to use ComposioHQ/composio to connect agents to 800+ toolkits with session-aware discovery, robust authentication flows, provider integrations, MCP support, and event-trigger automation.
 - Keywords: composio, tool, authentication, infrastructure, agents, composiohq, connect, toolkits, session, aware, discovery, robust, flows, provider, integrations, mcp, support, event
 
 ## Compound Engineering Plugin Tutorial: Compounding Agent Workflows Across Toolchains
 - Path: tutorials/compound-engineering-plugin-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/compound-engineering-plugin-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/compound-engineering-plugin-tutorial/README.md
 - Summary: Learn how to use EveryInc/compound-engineering-plugin to run compound engineering workflows in Claude Code and convert plugin assets for other coding-agent ecosystems.
 - Keywords: compound, engineering, plugin, compounding, agent, workflows, toolchains, everyinc, run, claude, code, convert, assets, other, coding, ecosystems
 
 ## Context7 Tutorial: Live Documentation Context for Coding Agents
 - Path: tutorials/context7-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/context7-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/context7-tutorial/README.md
 - Summary: Learn how to use upstash/context7 to inject up-to-date, version-aware library docs into Claude Code, Cursor, and other MCP-capable coding agents.
 - Keywords: context7, live, documentation, context, coding, agents, upstash, inject, date, version, aware, library, claude, code, cursor, other, mcp, capable
 
 ## Continue Tutorial: Open-Source AI Coding Agents for IDE and CLI
 - Path: tutorials/continue-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/continue-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/continue-tutorial/README.md
 - Summary: A practical guide to continuedev/continue, covering IDE usage, headless/CLI workflows, model configuration, team collaboration, and enterprise operations.
 - Keywords: continue, open, source, coding, agents, ide, cli, continuedev, usage, headless, workflows, model, configuration, team, collaboration, enterprise, operations
 
 ## GitHub Copilot CLI Tutorial: Copilot Agent Workflows in the Terminal
 - Path: tutorials/copilot-cli-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/copilot-cli-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/copilot-cli-tutorial/README.md
 - Summary: Learn how to use github/copilot-cli to run Copilot's coding agent directly from the terminal with GitHub-native context, approval controls, and extensibility through MCP and LSP.
 - Keywords: copilot, cli, agent, workflows, terminal, run, coding, directly, native, context, approval, controls, extensibility, mcp, lsp
 
 ## CopilotKit Tutorial: Building AI Copilots for React Applications
 - Path: tutorials/copilotkit-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/copilotkit-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/copilotkit-tutorial/README.md
 - Summary: Create in-app AI assistants, chatbots, and agentic UIs with the open-source CopilotKit framework.
 - Keywords: copilotkit, building, copilots, react, applications, create, app, assistants, chatbots, agentic, uis, open, source, framework
 
 ## Create Python Server Tutorial: Scaffold and Ship MCP Servers with uvx
 - Path: tutorials/create-python-server-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/create-python-server-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/create-python-server-tutorial/README.md
 - Summary: Learn how to use modelcontextprotocol/create-python-server to scaffold Python MCP servers with minimal setup, template-driven primitives, and publish-ready packaging workflows.
 - Keywords: create, python, server, scaffold, ship, mcp, servers, uvx, modelcontextprotocol, minimal, setup, template, driven, primitives, publish, ready, packaging, workflows
 
 ## Create TypeScript Server Tutorial: Scaffold MCP Servers with TypeScript Templates
 - Path: tutorials/create-typescript-server-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/create-typescript-server-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/create-typescript-server-tutorial/README.md
 - Summary: Learn how to use modelcontextprotocol/create-typescript-server to scaffold MCP server projects quickly, understand generated template structure, and operate build/debug workflows safely in archived-tooling environments.
 - Keywords: create, typescript, server, scaffold, mcp, servers, templates, modelcontextprotocol, projects, quickly, understand, generated, template, structure, operate, debug, workflows, safely
 
 ## CrewAI Tutorial: Building Collaborative AI Agent Teams
 - Path: tutorials/crewai-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/crewai-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/crewai-tutorial/README.md
 - Summary: CrewAI View Repo is a framework for orchestrating role-based AI agent teams that collaborate to accomplish complex tasks. It provides a structured approach to creating AI crews with specialized agents, tools, and processes, enabling sophisticated multi-agent workflows and collaborative problem-solving.
 - Keywords: crewai, building, collaborative, agent, teams, view, framework, orchestrating, role, based, collaborate, accomplish, complex, tasks, provides, structured, approach, creating
 
 ## Crush Tutorial: Multi-Model Terminal Coding Agent with Strong Extensibility
 - Path: tutorials/crush-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/crush-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/crush-tutorial/README.md
 - Summary: Learn how to use charmbracelet/crush for terminal-native coding workflows with flexible model providers, LSP/MCP integrations, and production-grade controls.
 - Keywords: crush, multi, model, terminal, coding, agent, strong, extensibility, charmbracelet, native, workflows, flexible, providers, lsp, mcp, integrations, grade, controls
 
 ## Daytona Tutorial: Secure Sandbox Infrastructure for AI-Generated Code
 - Path: tutorials/daytona-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/daytona-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/daytona-tutorial/README.md
 - Summary: Learn how to use daytonaio/daytona to run AI-generated code in isolated sandboxes, integrate coding agents through MCP, and operate sandbox infrastructure with stronger security and resource controls.
 - Keywords: daytona, secure, sandbox, infrastructure, generated, code, daytonaio, run, isolated, sandboxes, integrate, coding, agents, mcp, operate, stronger, security, resource
 
 ## Deer Flow Tutorial: Distributed Workflow Orchestration Platform
 - Path: tutorials/deer-flow-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/deer-flow-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/deer-flow-tutorial/README.md
 - Summary: Orchestrate complex distributed workflows with Deer Flow's powerful task coordination and execution platform.
 - Keywords: deer, flow, distributed, workflow, orchestration, orchestrate, complex, workflows, powerful, task, coordination, execution
 
 ## Devika Tutorial: Open-Source Autonomous AI Software Engineer
 - Path: tutorials/devika-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/devika-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/devika-tutorial/README.md
 - Summary: Learn how to deploy and operate stitionai/devika — a multi-agent autonomous coding system that plans, researches, writes, and debugs code end-to-end.
 - Keywords: devika, open, source, autonomous, software, engineer, deploy, operate, stitionai, multi, agent, coding, plans, researches, writes, debugs, code, end
 
 ## Dify Platform: Deep Dive Tutorial
 - Path: tutorials/dify-platform-deep-dive
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/dify-platform-deep-dive/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/dify-platform-deep-dive/README.md
 - Summary: Dify — An open-source LLM application development platform for building workflows, RAG pipelines, and AI agents with a visual interface.
 - Keywords: dify, open, source, llm, application, development, building, workflows, rag, pipelines, agents, visual, interface
 
 ## DSPy Tutorial: Programming Language Models
 - Path: tutorials/dspy-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/dspy-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/dspy-tutorial/README.md
 - Summary: Learn to program language models declaratively with DSPy, the Stanford NLP framework for systematic prompt optimization and modular LLM pipelines.
 - Keywords: dspy, programming, language, models, program, declaratively, stanford, nlp, framework, systematic, prompt, optimization, modular, llm, pipelines
 
 ## Dyad Tutorial: Local-First AI App Building
 - Path: tutorials/dyad-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/dyad-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/dyad-tutorial/README.md
 - Summary: A practical guide to dyad-sh/dyad, focused on local-first app generation, integration patterns, validation loops, and deployment readiness.
 - Keywords: dyad, local, first, app, building, focused, generation, integration, patterns, validation, loops, deployment, readiness
 
 ## ElizaOS: Deep Dive Tutorial
 - Path: tutorials/elizaos-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/elizaos-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/elizaos-tutorial/README.md
 - Summary: ElizaOS — Autonomous agents for everyone.
 - Keywords: elizaos, autonomous, agents, everyone
 
 ## Everything Claude Code Tutorial: Production Configuration Patterns for Claude Code
 - Path: tutorials/everything-claude-code-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/everything-claude-code-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/everything-claude-code-tutorial/README.md
 - Summary: Learn how to use affaan-m/everything-claude-code to adopt battle-tested Claude Code agents, skills, hooks, commands, rules, and MCP workflows in a structured, production-oriented way.
 - Keywords: everything, claude, code, configuration, patterns, affaan, adopt, battle, tested, agents, skills, hooks, commands, rules, mcp, workflows, structured, oriented
 
 ## Fabric Tutorial: Open-Source Framework for Augmenting Humans with AI
 - Path: tutorials/fabric-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/fabric-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/fabric-tutorial/README.md
 - Summary: Enhance human capabilities with Fabric's modular framework for AI-powered cognitive assistance and task automation.
 - Keywords: fabric, open, source, framework, augmenting, humans, enhance, human, capabilities, modular, powered, cognitive, assistance, task, automation
 
 ## FastMCP Tutorial: Building and Operating MCP Servers with Pythonic Control
 - Path: tutorials/fastmcp-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/fastmcp-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/fastmcp-tutorial/README.md
 - Summary: Learn how to use jlowin/fastmcp to design, run, test, and deploy MCP servers and clients with practical transport, integration, auth, and operations patterns.
 - Keywords: fastmcp, building, operating, mcp, servers, pythonic, control, jlowin, design, run, test, deploy, clients, transport, integration, auth, operations, patterns
 
 ## Figma Context MCP Tutorial: Design-to-Code Workflows for Coding Agents
 - Path: tutorials/figma-context-mcp-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/figma-context-mcp-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/figma-context-mcp-tutorial/README.md
 - Summary: Learn how to use GLips/Figma-Context-MCP (Framelink MCP for Figma) to give coding agents structured design context for higher-fidelity implementation.
 - Keywords: figma, context, mcp, design, code, workflows, coding, agents, glips, framelink, give, structured, higher, fidelity, implementation
 
 ## Firecrawl MCP Server Tutorial: Web Scraping and Search Tools for MCP Clients
 - Path: tutorials/firecrawl-mcp-server-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/firecrawl-mcp-server-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/firecrawl-mcp-server-tutorial/README.md
 - Summary: Learn how to use firecrawl/firecrawl-mcp-server to add robust web scraping, crawling, search, and extraction capabilities to MCP-enabled coding and research agents.
 - Keywords: firecrawl, mcp, server, web, scraping, search, tools, clients, add, robust, crawling, extraction, capabilities, enabled, coding, research, agents
 
 ## Firecrawl Tutorial: Building LLM-Ready Web Scraping and Data Extraction Systems
 - Path: tutorials/firecrawl-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/firecrawl-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/firecrawl-tutorial/README.md
 - Summary: Deep technical walkthrough of Firecrawl Tutorial: Building LLM-Ready Web Scraping and Data Extraction Systems.
 - Keywords: firecrawl, building, llm, ready, web, scraping, data, extraction, technical, walkthrough
 
 ## Fireproof Tutorial: Local-First Document Database for AI-Native Apps
 - Path: tutorials/fireproof-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/fireproof-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/fireproof-tutorial/README.md
 - Summary: Learn how to use fireproof-storage/fireproof to build local-first, encrypted, sync-capable applications with a unified browser/Node/Deno API and React hooks.
 - Keywords: fireproof, local, first, document, database, native, apps, storage, encrypted, sync, capable, applications, unified, browser, node, deno, api, react
 
 ## Flowise LLM Orchestration: Deep Dive Tutorial
 - Path: tutorials/flowise-llm-orchestration
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/flowise-llm-orchestration/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/flowise-llm-orchestration/README.md
 - Summary: Flowise — An open-source visual tool for building LLM workflows with a drag-and-drop interface.
 - Keywords: flowise, llm, orchestration, open, source, visual, tool, building, workflows, drag, drop, interface
 
 ## Gemini CLI Tutorial: Terminal-First Agent Workflows with Google Gemini
 - Path: tutorials/gemini-cli-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/gemini-cli-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/gemini-cli-tutorial/README.md
 - Summary: Learn how to use google-gemini/gemini-cli to run coding and operations workflows in terminal-first loops with strong tooling, MCP extensibility, headless automation, and safety controls.
 - Keywords: gemini, cli, terminal, first, agent, workflows, google, run, coding, operations, loops, strong, tooling, mcp, extensibility, headless, automation, safety
 
 ## GenAI Toolbox Tutorial: MCP-First Database Tooling with Config-Driven Control Planes
 - Path: tutorials/genai-toolbox-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/genai-toolbox-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/genai-toolbox-tutorial/README.md
 - Summary: Learn how to use googleapis/genai-toolbox to expose database tools through MCP and native SDK paths, with stronger configuration discipline, deployment options, and observability controls.
 - Keywords: genai, toolbox, mcp, first, database, tooling, config, driven, control, planes, googleapis, expose, tools, native, sdk, paths, stronger, configuration
 
 ## GitHub MCP Server Tutorial: Production GitHub Operations Through MCP
 - Path: tutorials/github-mcp-server-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/github-mcp-server-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/github-mcp-server-tutorial/README.md
 - Summary: Learn how to use github/github-mcp-server to connect coding agents directly to repositories, issues, pull requests, actions, and code security workflows with stronger control.
 - Keywords: mcp, server, operations, connect, coding, agents, directly, repositories, issues, pull, requests, actions, code, security, workflows, stronger, control
 
 ## Goose Tutorial: Extensible Open-Source AI Agent for Real Engineering Work
 - Path: tutorials/goose-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/goose-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/goose-tutorial/README.md
 - Summary: Learn how to use block/goose to automate coding workflows with controlled tool execution, strong provider flexibility, and production-ready operations.
 - Keywords: goose, extensible, open, source, agent, real, engineering, work, block, automate, coding, workflows, controlled, tool, execution, strong, provider, flexibility
 
 ## GPT Open Source: Deep Dive Tutorial
 - Path: tutorials/gpt-oss-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/gpt-oss-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/gpt-oss-tutorial/README.md
 - Summary: A comprehensive guide to understanding, building, and deploying open-source GPT implementations -- from nanoGPT to GPT-NeoX and beyond.
 - Keywords: gpt, oss, open, source, comprehensive, understanding, building, deploying, implementations, nanogpt, neox, beyond
 
 ## gptme Tutorial: Open-Source Terminal Agent for Local Tool-Driven Work
 - Path: tutorials/gptme-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/gptme-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/gptme-tutorial/README.md
 - Summary: Learn how to use gptme/gptme to run a local-first coding and knowledge-work agent with strong CLI ergonomics, extensible tools, and automation-friendly modes.
 - Keywords: gptme, open, source, terminal, agent, local, tool, driven, work, run, first, coding, knowledge, strong, cli, ergonomics, extensible, tools
 
 ## HAPI Tutorial: Remote Control for Local AI Coding Sessions
 - Path: tutorials/hapi-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/hapi-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/hapi-tutorial/README.md
 - Summary: Learn tiann/hapi, a local-first hub that lets you run Claude Code/Codex/Gemini/OpenCode sessions locally while controlling and approving them remotely.
 - Keywords: hapi, remote, control, local, coding, sessions, tiann, first, hub, lets, run, claude, code, codex, gemini, opencode, locally, while
 
 ## Haystack: Deep Dive Tutorial
 - Path: tutorials/haystack-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/haystack-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/haystack-tutorial/README.md
 - Summary: Haystack — An open-source framework for building production-ready LLM applications, RAG pipelines, and intelligent search systems.
 - Keywords: haystack, open, source, framework, building, ready, llm, applications, rag, pipelines, intelligent, search
 
 ## HuggingFace Transformers Tutorial: Building State-of-the-Art AI Models
 - Path: tutorials/huggingface-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/huggingface-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/huggingface-tutorial/README.md
 - Summary: A deep technical walkthrough of HuggingFace Transformers covering Building State-of-the-Art AI Models.
 - Keywords: huggingface, transformers, building, state, art, models, technical, walkthrough
 
 ## HumanLayer Tutorial: Context Engineering and Human-Governed Coding Agents
 - Path: tutorials/humanlayer-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/humanlayer-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/humanlayer-tutorial/README.md
 - Summary: Learn how to use humanlayer/humanlayer patterns to orchestrate coding agents with stronger context control, human oversight, and team-scale workflows.
 - Keywords: humanlayer, context, engineering, human, governed, coding, agents, patterns, orchestrate, stronger, control, oversight, team, scale, workflows
 
 ## Instructor Tutorial: Structured LLM Outputs
 - Path: tutorials/instructor-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/instructor-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/instructor-tutorial/README.md
 - Summary: Get reliable, typed responses from LLMs with Pydantic validation.
 - Keywords: instructor, structured, llm, outputs, get, reliable, typed, responses, llms, pydantic, validation
 
 ## Khoj AI: Deep Dive Tutorial
 - Path: tutorials/khoj-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/khoj-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/khoj-tutorial/README.md
 - Summary: Khoj — An open-source, self-hostable AI personal assistant that connects to your notes, documents, and online data.
 - Keywords: khoj, open, source, self, hostable, personal, assistant, connects, notes, documents, online, data
 
 ## Kilo Code Tutorial: Agentic Engineering from IDE and CLI Surfaces
 - Path: tutorials/kilocode-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/kilocode-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/kilocode-tutorial/README.md
 - Summary: Learn how to use Kilo-Org/kilocode for high-throughput coding workflows with multi-mode operation, agent-loop controls, and extensible CLI/IDE integration.
 - Keywords: kilocode, kilo, code, agentic, engineering, ide, cli, surfaces, org, high, throughput, coding, workflows, multi, mode, operation, agent, loop
 
 ## Kimi CLI Tutorial: Multi-Mode Terminal Agent with MCP and ACP
 - Path: tutorials/kimi-cli-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/kimi-cli-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/kimi-cli-tutorial/README.md
 - Summary: Learn how to use MoonshotAI/kimi-cli to run an interactive terminal coding agent with configurable modes, MCP integrations, and ACP-based IDE connectivity.
 - Keywords: kimi, cli, multi, mode, terminal, agent, mcp, acp, moonshotai, run, interactive, coding, configurable, modes, integrations, based, ide, connectivity
 
 ## Kiro Tutorial: Spec-Driven Agentic IDE from AWS
 - Path: tutorials/kiro-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/kiro-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/kiro-tutorial/README.md
 - Summary: Learn how to use kirodotdev/Kiro for structured AI-powered development with spec-driven workflows, agent steering, event-driven automation, and AWS-native integrations.
 - Keywords: kiro, spec, driven, agentic, ide, aws, kirodotdev, structured, powered, development, workflows, agent, steering, event, automation, native, integrations
 
 ## Kubernetes Operator Patterns: Building Production-Grade Controllers
 - Path: tutorials/kubernetes-operator-patterns
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/kubernetes-operator-patterns/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/kubernetes-operator-patterns/README.md
 - Summary: Master Kubernetes Operators with hands-on Go implementation using the Operator SDK and controller-runtime library for enterprise application management.
 - Keywords: kubernetes, operator, patterns, building, grade, controllers, master, operators, hands, implementation, sdk, controller, runtime, library, enterprise, application, management
 
 ## LanceDB Tutorial: Serverless Vector Database for AI
 - Path: tutorials/lancedb-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/lancedb-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/lancedb-tutorial/README.md
 - Summary: Master LanceDB, the open-source serverless vector database designed for AI applications, RAG systems, and semantic search.
 - Keywords: lancedb, serverless, vector, database, master, open, source, designed, applications, rag, semantic, search
 
 ## LangChain Architecture: Internal Design Deep Dive
 - Path: tutorials/langchain-architecture-guide
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/langchain-architecture-guide/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/langchain-architecture-guide/README.md
 - Summary: Deep technical walkthrough of LangChain Architecture: Internal Design Deep Dive.
 - Keywords: langchain, architecture, internal, design, technical, walkthrough
 
 ## LangChain Tutorial: Building AI Applications with Large Language Models
 - Path: tutorials/langchain-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/langchain-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/langchain-tutorial/README.md
 - Summary: Pydantic 2 Required: LangChain v0.3 fully migrated to Pydantic 2. Code using langchain_core.pydantic_v1 should be updated to native Pydantic 2 syntax.
 - Keywords: langchain, building, applications, large, language, models, pydantic, required, fully, migrated, code, core, should, updated, native, syntax
 
 ## Langflow Tutorial: Visual AI Agent and Workflow Platform
 - Path: tutorials/langflow-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/langflow-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/langflow-tutorial/README.md
 - Summary: Learn how to build, deploy, and operate agent workflows with langflow-ai/langflow, including visual flow composition, API/MCP deployment, and production reliability controls.
 - Keywords: langflow, visual, agent, workflow, deploy, operate, workflows, flow, composition, api, mcp, deployment, reliability, controls
 
 ## Langfuse Tutorial: LLM Observability, Evaluation, and Prompt Operations
 - Path: tutorials/langfuse-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/langfuse-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/langfuse-tutorial/README.md
 - Summary: Learn how to use langfuse/langfuse to trace, evaluate, and improve production LLM systems with structured observability workflows.
 - Keywords: langfuse, llm, observability, evaluation, prompt, operations, trace, evaluate, improve, structured, workflows
 
 ## LangGraph Tutorial: Building Stateful Multi-Actor Applications
 - Path: tutorials/langgraph-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/langgraph-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/langgraph-tutorial/README.md
 - Summary: A deep technical walkthrough of LangGraph covering Building Stateful Multi-Actor Applications.
 - Keywords: langgraph, building, stateful, multi, actor, applications, technical, walkthrough
 
 ## Letta Tutorial: Stateful LLM Agents
 - Path: tutorials/letta-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/letta-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/letta-tutorial/README.md
 - Summary: Build AI agents with persistent memory using the framework formerly known as MemGPT.
 - Keywords: letta, stateful, llm, agents, persistent, memory, framework, formerly, known, memgpt
 
 ## LiteLLM Tutorial: Unified LLM Gateway and Routing Layer
 - Path: tutorials/litellm-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/litellm-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/litellm-tutorial/README.md
 - Summary: Build provider-agnostic LLM applications with BerriAI/litellm, including routing, fallbacks, proxy deployment, and cost-aware operations.
 - Keywords: litellm, unified, llm, gateway, routing, layer, provider, agnostic, applications, berriai, fallbacks, proxy, deployment, cost, aware, operations
 
 ## Liveblocks - Real-Time Collaboration Deep Dive
 - Path: tutorials/liveblocks-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/liveblocks-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/liveblocks-tutorial/README.md
 - Summary: Deep technical walkthrough of Liveblocks - Real-Time Collaboration Deep Dive.
 - Keywords: liveblocks, real, time, collaboration, technical, walkthrough
 
 ## llama.cpp Tutorial: Local LLM Inference
 - Path: tutorials/llama-cpp-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/llama-cpp-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/llama-cpp-tutorial/README.md
 - Summary: Run large language models efficiently on your local machine with pure C/C++.
 - Keywords: llama, cpp, local, llm, inference, run, large, language, models, efficiently, machine, pure
 
 ## LLaMA-Factory Tutorial: Unified Framework for LLM Training and Fine-tuning
 - Path: tutorials/llama-factory-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/llama-factory-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/llama-factory-tutorial/README.md
 - Summary: A deep technical walkthrough of LLaMA-Factory covering Unified Framework for LLM Training and Fine-tuning.
 - Keywords: llama, factory, unified, framework, llm, training, fine, tuning, technical, walkthrough
 
 ## LlamaIndex Tutorial: Building Advanced RAG Systems and Data Frameworks
 - Path: tutorials/llamaindex-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/llamaindex-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/llamaindex-tutorial/README.md
 - Summary: A deep technical walkthrough of LlamaIndex covering Building Advanced RAG Systems and Data Frameworks.
 - Keywords: llamaindex, building, advanced, rag, data, frameworks, technical, walkthrough
 
 ## LobeChat AI Platform: Deep Dive Tutorial
 - Path: tutorials/lobechat-ai-platform
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/lobechat-ai-platform/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/lobechat-ai-platform/README.md
 - Summary: LobeChat — An open-source, modern-design AI chat framework for building private LLM applications.
 - Keywords: lobechat, open, source, modern, design, chat, framework, building, private, llm, applications
 
 ## LocalAI Tutorial: Self-Hosted OpenAI Alternative
 - Path: tutorials/localai-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/localai-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/localai-tutorial/README.md
 - Summary: Run LLMs, image generation, and audio models locally with an OpenAI-compatible API.
 - Keywords: localai, self, hosted, openai, alternative, run, llms, image, generation, audio, models, locally, compatible, api
 
 ## Logseq: Deep Dive Tutorial
 - Path: tutorials/logseq-knowledge-management
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/logseq-knowledge-management/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/logseq-knowledge-management/README.md
 - Summary: Logseq — A privacy-first, local-first knowledge management platform with block-based editing and graph visualization.
 - Keywords: logseq, knowledge, management, privacy, first, local, block, based, editing, graph, visualization
 
 ## Mastra Tutorial: TypeScript Framework for AI Agents and Workflows
 - Path: tutorials/mastra-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mastra-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mastra-tutorial/README.md
 - Summary: Learn how to build production AI applications with mastra-ai/mastra, including agents, workflows, memory, MCP tooling, and reliability operations.
 - Keywords: mastra, typescript, framework, agents, workflows, applications, memory, mcp, tooling, reliability, operations
 
 ## MCP Chrome Tutorial: Control Your Real Chrome Browser Through MCP
 - Path: tutorials/mcp-chrome-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-chrome-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-chrome-tutorial/README.md
 - Summary: Learn how to use hangwin/mcp-chrome to expose browser automation, content analysis, and semantic tab search tools to MCP clients.
 - Keywords: mcp, chrome, control, real, browser, hangwin, expose, automation, content, analysis, semantic, tab, search, tools, clients
 
 ## MCP C# SDK Tutorial: Production MCP in .NET with Hosting, ASP.NET Core, and Task Workflows
 - Path: tutorials/mcp-csharp-sdk-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-csharp-sdk-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-csharp-sdk-tutorial/README.md
 - Summary: Learn how to build and operate MCP clients and servers with modelcontextprotocol/csharp-sdk, including package choices, auth patterns, tasks, diagnostics, and versioning strategy.
 - Keywords: mcp, csharp, sdk, net, hosting, asp, core, task, workflows, operate, clients, servers, modelcontextprotocol, package, choices, auth, patterns, tasks
 
 ## MCP Docs Repo Tutorial: Navigating the Archived MCP Documentation Repository
 - Path: tutorials/mcp-docs-repo-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-docs-repo-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-docs-repo-tutorial/README.md
 - Summary: Learn how to use modelcontextprotocol/docs as an archived reference, map its conceptual guides, and migrate documentation workflows to the canonical modelcontextprotocol/modelcontextprotocol docs location.
 - Keywords: mcp, navigating, archived, documentation, repository, modelcontextprotocol, reference, map, conceptual, guides, migrate, workflows, canonical, location
 
 ## MCP Ext Apps Tutorial: Building Interactive MCP Apps and Hosts
 - Path: tutorials/mcp-ext-apps-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-ext-apps-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-ext-apps-tutorial/README.md
 - Summary: Learn how to use modelcontextprotocol/ext-apps to build interactive MCP Apps, wire host bridges, secure UI resources, and run reliable testing and migration workflows.
 - Keywords: mcp, ext, apps, building, interactive, hosts, modelcontextprotocol, wire, host, bridges, secure, resources, run, reliable, testing, migration, workflows
 
 ## MCP Go SDK Tutorial: Building Robust MCP Clients and Servers in Go
 - Path: tutorials/mcp-go-sdk-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-go-sdk-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-go-sdk-tutorial/README.md
 - Summary: Learn how to use modelcontextprotocol/go-sdk for production MCP workloads across stdio and streamable HTTP, including auth middleware, conformance, and upgrade planning.
 - Keywords: mcp, sdk, building, robust, clients, servers, modelcontextprotocol, workloads, stdio, streamable, auth, middleware, conformance, upgrade, planning
 
 ## MCP Inspector Tutorial: Debugging and Validating MCP Servers
 - Path: tutorials/mcp-inspector-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-inspector-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-inspector-tutorial/README.md
 - Summary: Learn how to use modelcontextprotocol/inspector to test MCP servers across stdio, SSE, and streamable HTTP, with safer auth defaults and repeatable CLI automation.
 - Keywords: mcp, inspector, debugging, validating, servers, modelcontextprotocol, test, stdio, sse, streamable, safer, auth, defaults, repeatable, cli, automation
 
 ## MCP Java SDK Tutorial: Building MCP Clients and Servers with Reactor, Servlet, and Spring
 - Path: tutorials/mcp-java-sdk-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-java-sdk-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-java-sdk-tutorial/README.md
 - Summary: Learn how to use modelcontextprotocol/java-sdk across core Java and Spring stacks, from transport setup to conformance and production hardening.
 - Keywords: mcp, java, sdk, building, clients, servers, reactor, servlet, spring, modelcontextprotocol, core, stacks, transport, setup, conformance, hardening
 
 ## MCP Kotlin SDK Tutorial: Building Multiplatform MCP Clients and Servers
 - Path: tutorials/mcp-kotlin-sdk-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-kotlin-sdk-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-kotlin-sdk-tutorial/README.md
 - Summary: Learn how to implement MCP client/server workflows with modelcontextprotocol/kotlin-sdk, including module boundaries, transport choices, capability negotiation, and production lifecycle controls.
 - Keywords: mcp, kotlin, sdk, building, multiplatform, clients, servers, implement, client, server, workflows, modelcontextprotocol, module, boundaries, transport, choices, capability, negotiation
 
 ## MCP PHP SDK Tutorial: Building MCP Servers in PHP with Discovery and Transport Flexibility
 - Path: tutorials/mcp-php-sdk-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-php-sdk-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-php-sdk-tutorial/README.md
 - Summary: Learn how to implement MCP server workflows with modelcontextprotocol/php-sdk, including attribute discovery, manual capability registration, transport strategy, session storage, and framework integration patterns.
 - Keywords: mcp, php, sdk, building, servers, discovery, transport, flexibility, implement, server, workflows, modelcontextprotocol, attribute, manual, capability, registration, strategy, session
 
 ## MCP Python SDK Tutorial: Building AI Tool Servers
 - Path: tutorials/mcp-python-sdk-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-python-sdk-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-python-sdk-tutorial/README.md
 - Summary: Master the Model Context Protocol Python SDK to build custom tool servers that extend Claude and other LLMs with powerful capabilities.
 - Keywords: mcp, python, sdk, building, tool, servers, master, model, context, protocol, custom, extend, claude, other, llms, powerful, capabilities
 
 ## MCP Quickstart Resources Tutorial: Cross-Language MCP Servers and Clients by Example
 - Path: tutorials/mcp-quickstart-resources-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-quickstart-resources-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-quickstart-resources-tutorial/README.md
 - Summary: Learn how to use modelcontextprotocol/quickstart-resources as a practical reference for multi-language MCP server/client implementations, protocol smoke testing, and onboarding workflows.
 - Keywords: mcp, quickstart, resources, cross, language, servers, clients, example, modelcontextprotocol, reference, multi, server, client, implementations, protocol, smoke, testing, onboarding
 
 ## MCP Registry Tutorial: Publishing, Discovery, and Governance for MCP Servers
 - Path: tutorials/mcp-registry-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-registry-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-registry-tutorial/README.md
 - Summary: Learn how modelcontextprotocol/registry works end to end: publishing authenticated server metadata, consuming the API as an aggregator, and operating registry infrastructure safely.
 - Keywords: mcp, registry, publishing, discovery, governance, servers, modelcontextprotocol, works, end, authenticated, server, metadata, consuming, api, aggregator, operating, infrastructure, safely
 
 ## MCP Ruby SDK Tutorial: Building MCP Servers and Clients in Ruby
 - Path: tutorials/mcp-ruby-sdk-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-ruby-sdk-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-ruby-sdk-tutorial/README.md
 - Summary: Learn how to implement MCP server/client workflows with modelcontextprotocol/ruby-sdk, including tool/prompt/resource registration, streamable HTTP sessions, structured logging, and release operations.
 - Keywords: mcp, ruby, sdk, building, servers, clients, implement, server, client, workflows, modelcontextprotocol, tool, prompt, resource, registration, streamable, sessions, structured
 
 ## MCP Rust SDK Tutorial: Building High-Performance MCP Services with RMCP
 - Path: tutorials/mcp-rust-sdk-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-rust-sdk-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-rust-sdk-tutorial/README.md
 - Summary: Learn how to use modelcontextprotocol/rust-sdk (rmcp) for production MCP clients and servers with strong transport control, macro-driven tooling, OAuth, and async task workflows.
 - Keywords: mcp, rust, sdk, building, high, performance, services, rmcp, modelcontextprotocol, clients, servers, strong, transport, control, macro, driven, tooling, oauth
 
 ## MCP Servers Tutorial: Reference Implementations and Patterns
 - Path: tutorials/mcp-servers-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-servers-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-servers-tutorial/README.md
 - Summary: Learn how to use the official MCP reference servers as implementation blueprints, not drop-in production services.
 - Keywords: mcp, servers, reference, implementations, patterns, official, implementation, blueprints, not, drop, services
 
 ## MCP Specification Tutorial: Designing Production-Grade MCP Clients and Servers From the Source of Truth
 - Path: tutorials/mcp-specification-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-specification-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-specification-tutorial/README.md
 - Summary: Learn the current Model Context Protocol directly from modelcontextprotocol/modelcontextprotocol, including lifecycle, transports, security, authorization, and governance workflows.
 - Keywords: mcp, specification, designing, grade, clients, servers, source, truth, current, model, context, protocol, directly, modelcontextprotocol, lifecycle, transports, security, authorization
 
 ## MCP Swift SDK Tutorial: Building MCP Clients and Servers in Swift
 - Path: tutorials/mcp-swift-sdk-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-swift-sdk-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-swift-sdk-tutorial/README.md
 - Summary: Learn how to implement MCP client and server workflows with modelcontextprotocol/swift-sdk, including transport options, sampling, batching, and graceful service lifecycle control.
 - Keywords: mcp, swift, sdk, building, clients, servers, implement, client, server, workflows, modelcontextprotocol, transport, options, sampling, batching, graceful, service, lifecycle
 
 ## MCP TypeScript SDK Tutorial: Building and Migrating MCP Clients and Servers in TypeScript
 - Path: tutorials/mcp-typescript-sdk-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-typescript-sdk-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-typescript-sdk-tutorial/README.md
 - Summary: Learn how to use modelcontextprotocol/typescript-sdk to build production MCP clients and servers, migrate from v1 to v2 safely, and validate behavior with conformance workflows.
 - Keywords: mcp, typescript, sdk, building, migrating, clients, servers, modelcontextprotocol, migrate, safely, validate, behavior, conformance, workflows
 
 ## MCP Use Tutorial: Full-Stack MCP Development Across Agents, Clients, Servers, and Inspector
 - Path: tutorials/mcp-use-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-use-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-use-tutorial/README.md
 - Summary: Learn how mcp-use/mcp-use composes agent, client, server, and inspector workflows across Python and TypeScript with practical security and operations patterns.
 - Keywords: mcp, full, stack, development, agents, clients, servers, inspector, composes, agent, client, server, workflows, python, typescript, security, operations, patterns
 
 ## MCPB Tutorial: Packaging and Distributing Local MCP Servers as Bundles
 - Path: tutorials/mcpb-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcpb-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcpb-tutorial/README.md
 - Summary: Learn how to use modelcontextprotocol/mcpb to package local MCP servers into signed .mcpb bundles with manifest metadata, CLI workflows, and distribution-ready operational controls.
 - Keywords: mcpb, packaging, distributing, local, mcp, servers, bundles, modelcontextprotocol, package, signed, manifest, metadata, cli, workflows, distribution, ready, operational, controls
 
 ## MeiliSearch Tutorial: Lightning Fast Search Engine
 - Path: tutorials/meilisearch-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/meilisearch-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/meilisearch-tutorial/README.md
 - Summary: A deep technical walkthrough of MeiliSearch covering Lightning Fast Search Engine.
 - Keywords: meilisearch, lightning, fast, search, engine, technical, walkthrough
 
 ## Mem0 Tutorial: Building Production-Ready AI Agents with Scalable Long-Term Memory
 - Path: tutorials/mem0-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mem0-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mem0-tutorial/README.md
 - Summary: A deep technical walkthrough of Mem0 covering Building Production-Ready AI Agents with Scalable Long-Term Memory.
 - Keywords: mem0, building, ready, agents, scalable, long, term, memory, technical, walkthrough
 
 ## Mini-SWE-Agent Tutorial: Minimal Autonomous Code Agent Design at Benchmark Scale
 - Path: tutorials/mini-swe-agent-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mini-swe-agent-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mini-swe-agent-tutorial/README.md
 - Summary: Learn how to use SWE-agent/mini-swe-agent to run compact, high-performing software-engineering agent workflows with minimal scaffolding and strong reproducibility.
 - Keywords: mini, swe, agent, minimal, autonomous, code, design, benchmark, scale, run, compact, high, performing, software, engineering, workflows, scaffolding, strong
 
 ## Mistral Vibe Tutorial: Minimal CLI Coding Agent by Mistral
 - Path: tutorials/mistral-vibe-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mistral-vibe-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mistral-vibe-tutorial/README.md
 - Summary: Learn how to use mistralai/mistral-vibe for terminal-native coding workflows with configurable agent profiles, skills, subagents, and ACP integrations.
 - Keywords: mistral, vibe, minimal, cli, coding, agent, mistralai, terminal, native, workflows, configurable, profiles, skills, subagents, acp, integrations
 
 ## n8n AI Tutorial: Workflow Automation with AI
 - Path: tutorials/n8n-ai-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/n8n-ai-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/n8n-ai-tutorial/README.md
 - Summary: Build powerful AI-powered automations with n8n's visual workflow builder.
 - Keywords: n8n, workflow, automation, powerful, powered, automations, visual, builder
 
 ## n8n Model Context Protocol: Deep Dive Tutorial
 - Path: tutorials/n8n-mcp-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/n8n-mcp-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/n8n-mcp-tutorial/README.md
 - Summary: n8n — Visual workflow automation with Model Context Protocol (MCP) integration for AI-powered tool use.
 - Keywords: n8n, mcp, model, context, protocol, visual, workflow, automation, integration, powered, tool
 
 ## Nanocoder Tutorial: Building and Understanding AI Coding Agents
 - Path: tutorials/nanocoder-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/nanocoder-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/nanocoder-tutorial/README.md
 - Summary: Learn how Nano-Collective/nanocoder implements local-first coding-agent workflows, tool execution loops, and multi-provider model integration.
 - Keywords: nanocoder, building, understanding, coding, agents, nano, collective, implements, local, first, agent, workflows, tool, execution, loops, multi, provider, model
 
 ## NocoDB: Deep Dive Tutorial
 - Path: tutorials/nocodb-database-platform
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/nocodb-database-platform/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/nocodb-database-platform/README.md
 - Summary: NocoDB — An open-source Airtable alternative that turns any database into a smart spreadsheet.
 - Keywords: nocodb, database, open, source, airtable, alternative, turns, any, smart, spreadsheet
 
 ## Obsidian Outliner Plugin: Deep Dive Tutorial
 - Path: tutorials/obsidian-outliner-plugin
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/obsidian-outliner-plugin/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/obsidian-outliner-plugin/README.md
 - Summary: Obsidian Outliner — A plugin that adds outliner-style editing behaviors to Obsidian, demonstrating advanced plugin architecture patterns.
 - Keywords: obsidian, outliner, plugin, adds, style, editing, behaviors, demonstrating, advanced, architecture, patterns
 
 ## Ollama Tutorial: Running and Serving LLMs Locally
 - Path: tutorials/ollama-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/ollama-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/ollama-tutorial/README.md
 - Summary: Learn how to use ollama/ollama for local model execution, customization, embeddings/RAG, integration, and production deployment.
 - Keywords: ollama, running, serving, llms, locally, local, model, execution, customization, embeddings, rag, integration, deployment
 
 ## Onlook Tutorial: Visual-First AI Coding for Next.js and Tailwind
 - Path: tutorials/onlook-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/onlook-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/onlook-tutorial/README.md
 - Summary: Learn how to use onlook-dev/onlook to design and edit production-grade React apps visually while keeping generated code in your repository.
 - Keywords: onlook, visual, first, coding, next, tailwind, dev, design, edit, grade, react, apps, visually, while, keeping, generated, code, repository
 
 ## Opcode Tutorial: GUI Command Center for Claude Code Workflows
 - Path: tutorials/opcode-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/opcode-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/opcode-tutorial/README.md
 - Summary: Learn how to use winfunc/opcode to manage Claude Code projects, sessions, agents, MCP servers, and checkpoints from a desktop-first operating interface.
 - Keywords: opcode, gui, command, center, claude, code, workflows, winfunc, manage, projects, sessions, agents, mcp, servers, checkpoints, desktop, first, operating
 
 ## Open SWE Tutorial: Asynchronous Cloud Coding Agent Architecture and Migration Playbook
 - Path: tutorials/open-swe-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/open-swe-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/open-swe-tutorial/README.md
 - Summary: Learn from langchain-ai/open-swe architecture, workflows, and operational patterns, including how to maintain or migrate from a deprecated codebase.
 - Keywords: open, swe, asynchronous, cloud, coding, agent, architecture, migration, playbook, langchain, workflows, operational, patterns, maintain, migrate, deprecated, codebase
 
 ## Open WebUI Tutorial: Self-Hosted AI Workspace and Chat Interface
 - Path: tutorials/open-webui-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/open-webui-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/open-webui-tutorial/README.md
 - Summary: Learn how to run and operate open-webui/open-webui as a self-hosted AI interface with model routing, RAG workflows, multi-user controls, and production deployment patterns.
 - Keywords: open, webui, self, hosted, workspace, chat, interface, run, operate, model, routing, rag, workflows, multi, user, controls, deployment, patterns
 
 ## OpenAI Python SDK Tutorial: Production API Patterns
 - Path: tutorials/openai-python-sdk-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/openai-python-sdk-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/openai-python-sdk-tutorial/README.md
 - Summary: Learn how to build reliable Python integrations with openai/openai-python using Responses-first architecture, migration-safe patterns, and production operations.
 - Keywords: openai, python, sdk, api, patterns, reliable, integrations, responses, first, architecture, migration, safe, operations
 
 ## OpenAI Realtime Agents Tutorial: Voice-First AI Systems
 - Path: tutorials/openai-realtime-agents-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/openai-realtime-agents-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/openai-realtime-agents-tutorial/README.md
 - Summary: Learn how to build low-latency voice agents with openai/openai-realtime-agents, including realtime session design, tool orchestration, and production rollout patterns.
 - Keywords: openai, realtime, agents, voice, first, low, latency, session, design, tool, orchestration, rollout, patterns
 
 ## OpenAI Whisper Tutorial: Speech Recognition and Translation
 - Path: tutorials/openai-whisper-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/openai-whisper-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/openai-whisper-tutorial/README.md
 - Summary: Build robust transcription pipelines with Whisper, from local experiments to production deployment.
 - Keywords: openai, whisper, speech, recognition, translation, robust, transcription, pipelines, local, experiments, deployment
 
 ## OpenBB Tutorial: Complete Guide to Investment Research Platform
 - Path: tutorials/openbb-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/openbb-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/openbb-tutorial/README.md
 - Summary: Democratize investment research with OpenBB's comprehensive financial data and analysis platform.
 - Keywords: openbb, complete, investment, research, democratize, comprehensive, financial, data, analysis
 
 ## OpenClaw: Deep Dive Tutorial
 - Path: tutorials/openclaw-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/openclaw-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/openclaw-tutorial/README.md
 - Summary: OpenClaw — Your own personal AI assistant. Any OS. Any Platform.
 - Keywords: openclaw, own, personal, assistant, any
 
 ## OpenCode AI Legacy Tutorial: Archived Terminal Agent Workflows and Migration to Crush
 - Path: tutorials/opencode-ai-legacy-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/opencode-ai-legacy-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/opencode-ai-legacy-tutorial/README.md
 - Summary: Learn from opencode-ai/opencode architecture and workflows, and migrate safely to actively maintained successors.
 - Keywords: opencode, legacy, archived, terminal, agent, workflows, migration, crush, architecture, migrate, safely, actively, maintained, successors
 
 ## OpenCode Tutorial: Open-Source Terminal Coding Agent at Scale
 - Path: tutorials/opencode-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/opencode-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/opencode-tutorial/README.md
 - Summary: Learn how to use anomalyco/opencode to run terminal-native coding agents with provider flexibility, strong tool control, and production-grade workflows.
 - Keywords: opencode, open, source, terminal, coding, agent, scale, anomalyco, run, native, agents, provider, flexibility, strong, tool, control, grade, workflows
 
 ## OpenHands Tutorial: Autonomous Software Engineering Workflows
 - Path: tutorials/openhands-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/openhands-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/openhands-tutorial/README.md
 - Summary: Learn how to operate OpenHands/OpenHands across local GUI, CLI, and SDK workflows with production-minded safety, validation, and integration patterns.
 - Keywords: openhands, autonomous, software, engineering, workflows, operate, local, gui, cli, sdk, minded, safety, validation, integration, patterns
 
 ## OpenSkills Tutorial: Universal Skill Loading for Coding Agents
 - Path: tutorials/openskills-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/openskills-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/openskills-tutorial/README.md
 - Summary: Learn how to use numman-ali/openskills to install, synchronize, and operate reusable SKILL.md packs across Claude Code, Cursor, Codex, Aider, and other agent environments.
 - Keywords: openskills, universal, skill, loading, coding, agents, numman, ali, install, synchronize, operate, reusable, packs, claude, code, cursor, codex, aider
 
 ## OpenSpec Tutorial: Spec-Driven Workflows for AI Coding Agents
 - Path: tutorials/openspec-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/openspec-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/openspec-tutorial/README.md
 - Summary: Learn how to use Fission-AI/OpenSpec to make AI-assisted software delivery more predictable with artifact-driven planning, implementation, and archival workflows.
 - Keywords: openspec, spec, driven, workflows, coding, agents, fission, make, assisted, software, delivery, more, predictable, artifact, planning, implementation, archival
 
 ## OpenSrc Tutorial: Deep Source Context for Coding Agents
 - Path: tutorials/opensrc-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/opensrc-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/opensrc-tutorial/README.md
 - Summary: Learn how to use vercel-labs/opensrc to fetch package and repository source code so coding agents can reason about implementation details, not only public types and docs.
 - Keywords: opensrc, source, context, coding, agents, vercel, labs, fetch, package, repository, code, can, reason, implementation, details, not, only, public
 
 ## Outlines Tutorial: Structured Text Generation with LLMs
 - Path: tutorials/outlines-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/outlines-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/outlines-tutorial/README.md
 - Summary: A deep technical walkthrough of Outlines covering Structured Text Generation with LLMs.
 - Keywords: outlines, structured, text, generation, llms, technical, walkthrough
 
 ## Perplexica Tutorial: AI-Powered Search Engine
 - Path: tutorials/perplexica-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/perplexica-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/perplexica-tutorial/README.md
 - Summary: A deep technical walkthrough of Perplexica covering AI-Powered Search Engine.
 - Keywords: perplexica, powered, search, engine, technical, walkthrough
 
 ## Phidata Tutorial: Building Autonomous AI Agents
 - Path: tutorials/phidata-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/phidata-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/phidata-tutorial/README.md
 - Summary: A deep technical walkthrough of Phidata covering Building Autonomous AI Agents.
 - Keywords: phidata, building, autonomous, agents, technical, walkthrough
 
 ## PhotoPrism Tutorial: AI-Powered Photos App
 - Path: tutorials/photoprism-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/photoprism-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/photoprism-tutorial/README.md
 - Summary: AI Photo Management Revolution: Enhanced facial recognition, LLM integrations, and advanced organization features mark PhotoPrism's evolution.
 - Keywords: photoprism, powered, photos, app, photo, management, revolution, enhanced, facial, recognition, llm, integrations, advanced, organization, features, mark, evolution
 
 ## Plandex Tutorial: Large-Task AI Coding Agent Workflows
 - Path: tutorials/plandex-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/plandex-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/plandex-tutorial/README.md
 - Summary: Learn how to use plandex-ai/plandex for large codebase tasks with strong context management, cumulative diff review, model packs, and self-hosted operations.
 - Keywords: plandex, large, task, coding, agent, workflows, codebase, tasks, strong, context, management, cumulative, diff, review, model, packs, self, hosted
 
 ## Planning with Files Tutorial: Persistent Markdown Workflow Memory for AI Coding Agents
 - Path: tutorials/planning-with-files-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/planning-with-files-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/planning-with-files-tutorial/README.md
 - Summary: Learn how to use OthmanAdi/planning-with-files to run Manus-style file-based planning workflows across Claude Code and other AI coding environments.
 - Keywords: planning, files, persistent, markdown, workflow, memory, coding, agents, othmanadi, run, manus, style, file, based, workflows, claude, code, other
 
 ## Playwright MCP Tutorial: Browser Automation for Coding Agents Through MCP
 - Path: tutorials/playwright-mcp-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/playwright-mcp-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/playwright-mcp-tutorial/README.md
 - Summary: Learn how to use microsoft/playwright-mcp to give AI coding agents structured browser automation with accessibility snapshots, deterministic actions, and portable MCP host integrations.
 - Keywords: playwright, mcp, browser, automation, coding, agents, microsoft, give, structured, accessibility, snapshots, deterministic, actions, portable, host, integrations
 
 ## PocketFlow Tutorial: Minimal LLM Framework with Graph-Based Power
 - Path: tutorials/pocketflow-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/pocketflow-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/pocketflow-tutorial/README.md
 - Summary: Learn how to build agentic applications with The-Pocket/PocketFlow, a minimalist graph framework that still supports workflows, multi-agent patterns, RAG, and human-in-the-loop flows.
 - Keywords: pocketflow, minimal, llm, framework, graph, based, power, agentic, applications, pocket, minimalist, still, supports, workflows, multi, agent, patterns, rag
 
 ## PostgreSQL Query Planner Deep Dive
 - Path: tutorials/postgresql-query-planner
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/postgresql-query-planner/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/postgresql-query-planner/README.md
 - Summary: Master PostgreSQL's query execution engine, understand EXPLAIN output, and optimize complex queries for maximum performance.
 - Keywords: postgresql, query, planner, master, execution, engine, understand, explain, output, optimize, complex, queries, maximum, performance
 
 ## PostHog Tutorial: Open Source Product Analytics Platform
 - Path: tutorials/posthog-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/posthog-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/posthog-tutorial/README.md
 - Summary: Deep technical walkthrough of PostHog Tutorial: Open Source Product Analytics Platform.
 - Keywords: posthog, open, source, product, analytics, technical, walkthrough
 
 ## Pydantic AI Tutorial: Type-Safe AI Agent Development
 - Path: tutorials/pydantic-ai-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/pydantic-ai-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/pydantic-ai-tutorial/README.md
 - Summary: A deep technical walkthrough of Pydantic AI covering Type-Safe AI Agent Development.
 - Keywords: pydantic, type, safe, agent, development, technical, walkthrough
 
 ## Quivr Tutorial: Open-Source RAG Framework for Document Ingestion
 - Path: tutorials/quivr-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/quivr-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/quivr-tutorial/README.md
 - Summary: Deep technical walkthrough of Quivr Tutorial: Open-Source RAG Framework for Document Ingestion.
 - Keywords: quivr, open, source, rag, framework, document, ingestion, technical, walkthrough
 
 ## Qwen-Agent Tutorial: Tool-Enabled Agent Framework with MCP, RAG, and Multi-Modal Workflows
 - Path: tutorials/qwen-agent-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/qwen-agent-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/qwen-agent-tutorial/README.md
 - Summary: Learn how to use QwenLM/Qwen-Agent to build production-capable agents with function calling, MCP integration, memory/RAG patterns, and benchmark-aware planning workflows.
 - Keywords: qwen, agent, tool, enabled, framework, mcp, rag, multi, modal, workflows, qwenlm, capable, agents, function, calling, integration, memory, patterns
 
 ## RAGFlow Tutorial: Complete Guide to Open-Source RAG Engine
 - Path: tutorials/ragflow-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/ragflow-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/ragflow-tutorial/README.md
 - Summary: Transform documents into intelligent Q&A systems with RAGFlow's comprehensive RAG (Retrieval-Augmented Generation) platform.
 - Keywords: ragflow, complete, open, source, rag, engine, transform, documents, intelligent, comprehensive, retrieval, augmented, generation
 
 ## React Fiber Internals
 - Path: tutorials/react-fiber-internals
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/react-fiber-internals/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/react-fiber-internals/README.md
 - Summary: Deep dive into React's reconciliation algorithm, the Fiber architecture that powers modern React applications.
 - Keywords: react, fiber, internals, reconciliation, algorithm, architecture, powers, modern, applications
 
 ## Refly Tutorial: Build Deterministic Agent Skills and Ship Them Across APIs and Claude Code
 - Path: tutorials/refly-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/refly-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/refly-tutorial/README.md
 - Summary: Learn how to use refly-ai/refly to turn vibe workflows into reusable, versioned agent skills that can run via API, webhook, and CLI integrations.
 - Keywords: refly, deterministic, agent, skills, ship, them, apis, claude, code, turn, vibe, workflows, reusable, versioned, can, run, via, api
 
 ## Roo Code Tutorial: Run an AI Dev Team in Your Editor
 - Path: tutorials/roo-code-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/roo-code-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/roo-code-tutorial/README.md
 - Summary: A production-focused guide to RooCodeInc/Roo-Code: mode design, task execution, checkpoints, MCP, team profiles, and enterprise operations.
 - Keywords: roo, code, run, dev, team, editor, focused, roocodeinc, mode, design, task, execution, checkpoints, mcp, profiles, enterprise, operations
 
 ## Semantic Kernel Tutorial: Microsoft's AI Orchestration
 - Path: tutorials/semantic-kernel-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/semantic-kernel-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/semantic-kernel-tutorial/README.md
 - Summary: Build enterprise AI applications with Microsoft's SDK for integrating LLMs.
 - Keywords: semantic, kernel, microsoft, orchestration, enterprise, applications, sdk, integrating, llms
 
 ## Serena Tutorial: Semantic Code Retrieval Toolkit for Coding Agents
 - Path: tutorials/serena-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/serena-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/serena-tutorial/README.md
 - Summary: Learn how to use oraios/serena to give coding agents IDE-grade semantic retrieval and editing tools across large codebases.
 - Keywords: serena, semantic, code, retrieval, toolkit, coding, agents, oraios, give, ide, grade, editing, tools, large, codebases
 
 ## Shotgun Tutorial: Spec-Driven Development for Coding Agents
 - Path: tutorials/shotgun-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/shotgun-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/shotgun-tutorial/README.md
 - Summary: Learn how to use shotgun-sh/shotgun to plan, specify, and execute large code changes with structured agent workflows and stronger delivery control.
 - Keywords: shotgun, spec, driven, development, coding, agents, plan, specify, execute, large, code, changes, structured, agent, workflows, stronger, delivery, control
 
 ## SillyTavern Tutorial: Advanced LLM Frontend for Power Users
 - Path: tutorials/sillytavern-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/sillytavern-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/sillytavern-tutorial/README.md
 - Summary: Unlock the full potential of large language models with SillyTavern's comprehensive interface for role-playing, creative writing, and AI experimentation.
 - Keywords: sillytavern, advanced, llm, frontend, power, users, unlock, full, potential, large, language, models, comprehensive, interface, role, playing, creative, writing
 
 ## SiYuan Tutorial: Privacy-First Knowledge Management
 - Path: tutorials/siyuan-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/siyuan-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/siyuan-tutorial/README.md
 - Summary: A deep technical walkthrough of SiYuan covering Privacy-First Knowledge Management.
 - Keywords: siyuan, privacy, first, knowledge, management, technical, walkthrough
 
 ## Smolagents Tutorial: Hugging Face's Lightweight Agent Framework
 - Path: tutorials/smolagents-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/smolagents-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/smolagents-tutorial/README.md
 - Summary: Build efficient AI agents with minimal code using Hugging Face's smolagents library.
 - Keywords: smolagents, hugging, face, lightweight, agent, framework, efficient, agents, minimal, code, library
 
 ## Stagewise Tutorial: Frontend Coding Agent Workflows in Real Browser Context
 - Path: tutorials/stagewise-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/stagewise-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/stagewise-tutorial/README.md
 - Summary: Learn how to use stagewise-io/stagewise to connect browser-selected UI context with coding agents, plugin extensions, and multi-agent bridge workflows.
 - Keywords: stagewise, frontend, coding, agent, workflows, real, browser, context, connect, selected, agents, plugin, extensions, multi, bridge
 
 ## Strands Agents Tutorial: Model-Driven Agent Systems with Native MCP Support
 - Path: tutorials/strands-agents-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/strands-agents-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/strands-agents-tutorial/README.md
 - Summary: Learn how to use strands-agents/sdk-python to build lightweight, model-driven agents with strong tool abstractions, hooks, and production deployment patterns.
 - Keywords: strands, agents, model, driven, agent, native, mcp, support, sdk, python, lightweight, strong, tool, abstractions, hooks, deployment, patterns
 
 ## Supabase Tutorial: Building Modern Backend Applications
 - Path: tutorials/supabase-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/supabase-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/supabase-tutorial/README.md
 - Summary: Deep technical walkthrough of Supabase Tutorial: Building Modern Backend Applications.
 - Keywords: supabase, building, modern, backend, applications, technical, walkthrough
 
 ## SuperAGI Tutorial: Production-Ready Autonomous AI Agents
 - Path: tutorials/superagi-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/superagi-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/superagi-tutorial/README.md
 - Summary: A deep technical walkthrough of SuperAGI covering Production-Ready Autonomous AI Agents.
 - Keywords: superagi, ready, autonomous, agents, technical, walkthrough
 
 ## Superset Terminal Tutorial: Command Center for Parallel Coding Agents
 - Path: tutorials/superset-terminal-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/superset-terminal-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/superset-terminal-tutorial/README.md
 - Summary: Learn how to use superset-sh/superset to orchestrate many coding agents in parallel with worktree isolation, centralized monitoring, and fast review loops.
 - Keywords: superset, terminal, command, center, parallel, coding, agents, orchestrate, many, worktree, isolation, centralized, monitoring, fast, review, loops
 
 ## OpenAI Swarm Tutorial: Lightweight Multi-Agent Orchestration
 - Path: tutorials/swarm-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/swarm-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/swarm-tutorial/README.md
 - Summary: Deep technical walkthrough of OpenAI Swarm Tutorial: Lightweight Multi-Agent Orchestration.
 - Keywords: swarm, openai, lightweight, multi, agent, orchestration, technical, walkthrough
 
 ## SWE-agent Tutorial: Autonomous Repository Repair and Benchmark-Driven Engineering
 - Path: tutorials/swe-agent-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/swe-agent-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/swe-agent-tutorial/README.md
 - Summary: Learn how to use SWE-agent/SWE-agent for autonomous software engineering workflows, from single-issue runs to benchmark and research-grade evaluation.
 - Keywords: swe, agent, autonomous, repository, repair, benchmark, driven, engineering, software, workflows, single, issue, runs, research, grade, evaluation
 
 ## Sweep Tutorial: Issue-to-PR AI Coding Workflows on GitHub
 - Path: tutorials/sweep-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/sweep-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/sweep-tutorial/README.md
 - Summary: Learn how to use sweepai/sweep to turn GitHub issues into pull requests, operate feedback loops, and run self-hosted or CLI workflows with clear guardrails.
 - Keywords: sweep, issue, coding, workflows, sweepai, turn, issues, pull, requests, operate, feedback, loops, run, self, hosted, cli, clear, guardrails
 
 ## Tabby Tutorial: Self-Hosted AI Coding Assistant Architecture and Operations
 - Path: tutorials/tabby-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/tabby-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/tabby-tutorial/README.md
 - Summary: Learn how to run and extend TabbyML/tabby for production code completion and team knowledge workflows.
 - Keywords: tabby, self, hosted, coding, assistant, architecture, operations, run, extend, tabbyml, code, completion, team, knowledge, workflows
 
 ## Taskade Awesome Vibe Coding Tutorial: Curating the 2026 AI-Building Landscape
 - Path: tutorials/taskade-awesome-vibe-coding-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/taskade-awesome-vibe-coding-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/taskade-awesome-vibe-coding-tutorial/README.md
 - Summary: Learn how to use and maintain taskade/awesome-vibe-coding as a decision system for AI app builders, coding agents, MCP tooling, and Genesis-centered workflows.
 - Keywords: taskade, awesome, vibe, coding, curating, building, landscape, maintain, decision, app, builders, agents, mcp, tooling, genesis, centered, workflows
 
 ## Taskade Docs Tutorial: Operating the Living-DNA Documentation Stack
 - Path: tutorials/taskade-docs-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/taskade-docs-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/taskade-docs-tutorial/README.md
 - Summary: Learn how taskade/docs structures product documentation across Genesis, API references, automations, help-center workflows, and release timelines.
 - Keywords: taskade, operating, living, dna, documentation, stack, structures, product, genesis, api, references, automations, help, center, workflows, release, timelines
 
 ## Taskade MCP Tutorial: OpenAPI-Driven MCP Server for Taskade Workflows
 - Path: tutorials/taskade-mcp-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/taskade-mcp-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/taskade-mcp-tutorial/README.md
 - Summary: Learn how to run, extend, and operate taskade/mcp to connect Taskade workspaces, tasks, projects, and AI agents into MCP-compatible clients.
 - Keywords: taskade, mcp, openapi, driven, server, workflows, run, extend, operate, connect, workspaces, tasks, projects, agents, compatible, clients
 
 ## Taskade Tutorial: AI-Native Workspace, Genesis, and Agentic Operations
 - Path: tutorials/taskade-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/taskade-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/taskade-tutorial/README.md
 - Summary: Learn how to operate Taskade as an AI-native workspace system: Genesis app generation, AI agents, automations, enterprise controls, and production rollout patterns.
 - Keywords: taskade, native, workspace, genesis, agentic, operations, operate, app, generation, agents, automations, enterprise, controls, rollout, patterns
 
 ## Teable: Deep Dive Tutorial
 - Path: tutorials/teable-database-platform
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/teable-database-platform/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/teable-database-platform/README.md
 - Summary: Teable — A high-performance, multi-dimensional database platform built on PostgreSQL with real-time collaboration.
 - Keywords: teable, database, high, performance, multi, dimensional, built, postgresql, real, time, collaboration
 
 ## tiktoken Tutorial: OpenAI Token Encoding & Optimization
 - Path: tutorials/tiktoken-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/tiktoken-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/tiktoken-tutorial/README.md
 - Summary: Master tiktoken, OpenAI's fast BPE tokenizer, to accurately count tokens, optimize prompts, and reduce API costs.
 - Keywords: tiktoken, openai, token, encoding, optimization, master, fast, bpe, tokenizer, accurately, count, tokens, optimize, prompts, reduce, api, costs
 
 ## Turborepo Tutorial: High-Performance Monorepo Build System
 - Path: tutorials/turborepo-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/turborepo-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/turborepo-tutorial/README.md
 - Summary: A deep technical walkthrough of Turborepo covering High-Performance Monorepo Build System.
 - Keywords: turborepo, high, performance, monorepo, technical, walkthrough
 
 ## use-mcp Tutorial: React Hook Patterns for MCP Client Integration
 - Path: tutorials/use-mcp-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/use-mcp-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/use-mcp-tutorial/README.md
 - Summary: Learn how to use modelcontextprotocol/use-mcp to connect React apps to MCP servers with OAuth-aware flows, tool/resource/prompt access, and resilient transport lifecycle handling.
 - Keywords: mcp, react, hook, patterns, client, integration, modelcontextprotocol, connect, apps, servers, oauth, aware, flows, tool, resource, prompt, access, resilient
 
 ## Vercel AI SDK Tutorial: Production TypeScript AI Apps and Agents
 - Path: tutorials/vercel-ai-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/vercel-ai-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/vercel-ai-tutorial/README.md
 - Summary: Build robust AI product features with vercel/ai, including streaming, structured outputs, tool loops, framework integration, and production deployment patterns.
 - Keywords: vercel, sdk, typescript, apps, agents, robust, product, features, streaming, structured, outputs, tool, loops, framework, integration, deployment, patterns
 
 ## Vibe Kanban Tutorial: Multi-Agent Orchestration Board for Coding Workflows
 - Path: tutorials/vibe-kanban-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/vibe-kanban-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/vibe-kanban-tutorial/README.md
 - Summary: Learn how to use BloopAI/vibe-kanban to coordinate Claude Code, Codex, Gemini CLI, and other coding agents through a unified orchestration workspace.
 - Keywords: vibe, kanban, multi, agent, orchestration, board, coding, workflows, bloopai, coordinate, claude, code, codex, gemini, cli, other, agents, unified
 
 ## VibeSDK Tutorial: Build a Vibe-Coding Platform on Cloudflare
 - Path: tutorials/vibesdk-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/vibesdk-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/vibesdk-tutorial/README.md
 - Summary: Learn how to use cloudflare/vibesdk to run a prompt-to-app platform with agent orchestration, preview sandboxes, and production deployment on Cloudflare.
 - Keywords: vibesdk, vibe, coding, cloudflare, run, prompt, app, agent, orchestration, preview, sandboxes, deployment
 
 ## vLLM Tutorial: High-Performance LLM Inference
 - Path: tutorials/vllm-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/vllm-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/vllm-tutorial/README.md
 - Summary: Master vLLM for blazing-fast, cost-effective large language model inference with advanced optimization techniques.
 - Keywords: vllm, high, performance, llm, inference, master, blazing, fast, cost, effective, large, language, model, advanced, optimization, techniques
 
 ## Whisper.cpp Tutorial: High-Performance Speech Recognition in C/C++
 - Path: tutorials/whisper-cpp-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/whisper-cpp-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/whisper-cpp-tutorial/README.md
 - Summary: A deep technical walkthrough of Whisper.cpp covering High-Performance Speech Recognition in C/C++.
 - Keywords: whisper, cpp, high, performance, speech, recognition, technical, walkthrough
 
 ## Wshobson Agents Tutorial: Pluginized Multi-Agent Workflows for Claude Code
 - Path: tutorials/wshobson-agents-tutorial
-- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/wshobson-agents-tutorial/index.md
+- Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/wshobson-agents-tutorial/README.md
 - Summary: Learn how to use wshobson/agents to install focused Claude Code plugins, coordinate specialist agents, and run scalable multi-agent workflows with clear model and skill boundaries.
 - Keywords: wshobson, agents, pluginized, multi, agent, workflows, claude, code, install, focused, plugins, coordinate, specialist, run, scalable, clear, model, skill
diff --git a/scripts/add_index_navigation_backlinks.py b/scripts/add_index_navigation_backlinks.py
index f7793ad6..075a40a1 100644
--- a/scripts/add_index_navigation_backlinks.py
+++ b/scripts/add_index_navigation_backlinks.py
@@ -7,7 +7,7 @@
 import re
 from pathlib import Path
 
-INDEX_NAME = "index.md"
+INDEX_NAME = "README.md"
 NAV_HEADING = "## Navigation & Backlinks"
 GENERATED_MARKER = "*Generated by [AI Codebase Knowledge Builder]"
 NUMBERED_FILE_RE = re.compile(r"^([0-9]{2,})[-_].+\.md$")
diff --git a/scripts/apply_pocketflow_style_pass.py b/scripts/apply_pocketflow_style_pass.py
index 79bb4617..7b3908e8 100644
--- a/scripts/apply_pocketflow_style_pass.py
+++ b/scripts/apply_pocketflow_style_pass.py
@@ -16,7 +16,7 @@
 import re
 from pathlib import Path
 
-INDEX_NAME = "index.md"
+INDEX_NAME = "README.md"
 NUMBERED_FILE_RE = re.compile(r"^([0-9]{2,})[-_].+\.md$")
 LINK_RE = re.compile(r"\[([^\]]+)\]\(([^)]+)\)")
 GEN_FOOTER = (
diff --git a/scripts/check_index_format_v2.py b/scripts/check_index_format_v2.py
index 6e4f4d63..7c909639 100755
--- a/scripts/check_index_format_v2.py
+++ b/scripts/check_index_format_v2.py
@@ -78,7 +78,7 @@ def main() -> int:
     args = parser.parse_args()
 
     root = Path(args.root).resolve()
-    index_paths = sorted((root / "tutorials").glob("*/index.md"))
+    index_paths = sorted((root / "tutorials").glob("*/README.md"))
 
     opted_in: list[Path] = []
     failures: list[tuple[Path, list[str]]] = []
diff --git a/scripts/clean_source_references.py b/scripts/clean_source_references.py
index ecee1d9b..b357902c 100644
--- a/scripts/clean_source_references.py
+++ b/scripts/clean_source_references.py
@@ -79,7 +79,7 @@ def main() -> int:
 
     changed_files = 0
     for tutorial_dir in sorted(p for p in tutorials.iterdir() if p.is_dir()):
-        idx = tutorial_dir / "index.md"
+        idx = tutorial_dir / "README.md"
         if not idx.is_file():
             continue
         text = read(idx)
diff --git a/scripts/contextualize_chapter_sections.py b/scripts/contextualize_chapter_sections.py
index 1b462882..f7fb0483 100644
--- a/scripts/contextualize_chapter_sections.py
+++ b/scripts/contextualize_chapter_sections.py
@@ -80,7 +80,7 @@ def slug_phrase(text: str) -> str:
 def chapter_files(tutorial_dir: Path) -> list[Path]:
     out: list[tuple[int, str, Path]] = []
     for path in tutorial_dir.glob("*.md"):
-        if path.name == "index.md":
+        if path.name == "README.md":
             continue
         match = NUMBERED_FILE_RE.match(path.name)
         if not match:
@@ -296,7 +296,7 @@ def main() -> int:
     chapter_changed = 0
 
     for tutorial_dir in sorted(p for p in tutorials_root.iterdir() if p.is_dir()):
-        index_path = tutorial_dir / "index.md"
+        index_path = tutorial_dir / "README.md"
         if not index_path.is_file():
             continue
         index_text = read_text(index_path)
diff --git a/scripts/deepen_v2_chapters.py b/scripts/deepen_v2_chapters.py
index 8b5fd978..0d777b40 100644
--- a/scripts/deepen_v2_chapters.py
+++ b/scripts/deepen_v2_chapters.py
@@ -18,7 +18,7 @@
 import re
 from pathlib import Path
 
-INDEX_FILE = "index.md"
+INDEX_FILE = "README.md"
 DEPTH_MARKER = "<!-- depth-expansion-v2 -->"
 NUMBERED_FILE_RE = re.compile(r"^([0-9]{2,})[-_].+\.md$")
 LINK_RE = re.compile(r"\[([^\]]+)\]\(([^)]+)\)")
diff --git a/scripts/docs_health.py b/scripts/docs_health.py
index 6e20c31f..34801885 100755
--- a/scripts/docs_health.py
+++ b/scripts/docs_health.py
@@ -126,7 +126,7 @@ def classify_tutorial_structure(root: Path) -> dict:
     missing_index: list[str] = []
 
     for tutorial_dir in sorted([p for p in tutorials_dir.iterdir() if p.is_dir()]):
-        has_index = (tutorial_dir / "index.md").is_file()
+        has_index = (tutorial_dir / "README.md").is_file()
         top_level_count = len(list(tutorial_dir.glob(NUMBERED_MD_PATTERN)))
         docs_count = 0
         docs_dir = tutorial_dir / "docs"
@@ -157,7 +157,7 @@ def classify_tutorial_structure(root: Path) -> dict:
 def collect_placeholder_summaries(root: Path) -> list[str]:
     tutorials_dir = root / "tutorials"
     matches: list[str] = []
-    for index_file in sorted(tutorials_dir.glob("*/index.md")):
+    for index_file in sorted(tutorials_dir.glob("*/README.md")):
         text = index_file.read_text(encoding="utf-8", errors="ignore")
         if PLACEHOLDER_SUMMARY in text:
             matches.append(index_file.relative_to(root).as_posix())
@@ -211,7 +211,7 @@ def main() -> int:
             print(link.as_tsv())
 
     if structure_report["missing_index"]:
-        print("\nTutorial directories missing index.md:")
+        print("\nTutorial directories missing README.md:")
         for item in structure_report["missing_index"]:
             print(item)
 
diff --git a/scripts/generate_discoverability_assets.py b/scripts/generate_discoverability_assets.py
index 63603eb4..b6024466 100755
--- a/scripts/generate_discoverability_assets.py
+++ b/scripts/generate_discoverability_assets.py
@@ -470,7 +470,7 @@ def infer_intent_signals(title: str, summary: str, cluster: str) -> list[str]:
 def tutorial_dirs(root: Path) -> Iterable[Path]:
     tutorials_root = root / TUTORIALS_DIR
     for path in sorted([p for p in tutorials_root.iterdir() if p.is_dir()], key=lambda p: p.name):
-        if (path / "index.md").is_file():
+        if (path / "README.md").is_file():
             yield path
 
 
@@ -478,7 +478,7 @@ def build_records(root: Path) -> list[dict]:
     records: list[dict] = []
 
     for tdir in tutorial_dirs(root):
-        index_path = tdir / "index.md"
+        index_path = tdir / "README.md"
         raw = index_path.read_text(encoding="utf-8", errors="ignore")
         body = strip_frontmatter(raw)
 
@@ -497,9 +497,9 @@ def build_records(root: Path) -> list[dict]:
                 "title": title,
                 "summary": summary,
                 "path": rel_dir,
-                "index_path": f"{rel_dir}/index.md",
+                "index_path": f"{rel_dir}/README.md",
                 "repo_url": f"https://github.com/johnxie/awesome-code-docs/tree/main/{rel_dir}",
-                "file_url": f"https://github.com/johnxie/awesome-code-docs/blob/main/{rel_dir}/index.md",
+                "file_url": f"https://github.com/johnxie/awesome-code-docs/blob/main/{rel_dir}/README.md",
                 "keywords": keywords,
                 "cluster": cluster,
                 "intent_signals": intent_signals,
diff --git a/scripts/generate_tutorial_manifest.py b/scripts/generate_tutorial_manifest.py
index acb0d18b..0617a63b 100755
--- a/scripts/generate_tutorial_manifest.py
+++ b/scripts/generate_tutorial_manifest.py
@@ -11,7 +11,7 @@
 
 
 def tutorial_record(root: Path, tutorial_dir: Path) -> dict:
-    has_index = (tutorial_dir / "index.md").is_file()
+    has_index = (tutorial_dir / "README.md").is_file()
     top_level_files = sorted(tutorial_dir.glob(NUMBERED_MD_PATTERN))
     docs_dir = tutorial_dir / "docs"
     docs_files = sorted(docs_dir.glob(NUMBERED_MD_PATTERN)) if docs_dir.exists() else []
diff --git a/scripts/release_claims_audit.py b/scripts/release_claims_audit.py
index da98c085..a45a008d 100755
--- a/scripts/release_claims_audit.py
+++ b/scripts/release_claims_audit.py
@@ -109,7 +109,7 @@ def main() -> int:
     parser.add_argument(
         "--targets",
         nargs="*",
-        default=["tutorials/*/index.md"],
+        default=["tutorials/*/README.md"],
         help="Glob patterns (relative to repo root) to scan",
     )
     parser.add_argument("--json-output", help="Optional JSON output path")
diff --git a/scripts/staleness_audit.py b/scripts/staleness_audit.py
index 0f1dcf9b..8d885646 100755
--- a/scripts/staleness_audit.py
+++ b/scripts/staleness_audit.py
@@ -28,7 +28,7 @@
 DEFAULT_TARGET_GLOBS = (
     "README.md",
     "tutorials/README.md",
-    "tutorials/*/index.md",
+    "tutorials/*/README.md",
     "categories/*.md",
     "discoverability/*.md",
     "CONTENT_GAPS_ANALYSIS.md",
diff --git a/scripts/update_repo_status_docs.py b/scripts/update_repo_status_docs.py
index bbdc5c09..06ae342c 100755
--- a/scripts/update_repo_status_docs.py
+++ b/scripts/update_repo_status_docs.py
@@ -11,7 +11,7 @@
 
 def collect_tutorial_dirs(root: Path) -> list[Path]:
     tutorials_root = root / "tutorials"
-    return sorted([p for p in tutorials_root.iterdir() if p.is_dir() and (p / "index.md").is_file()])
+    return sorted([p for p in tutorials_root.iterdir() if p.is_dir() and (p / "README.md").is_file()])
 
 
 def chapter_count(tutorial_dir: Path) -> int:
@@ -45,7 +45,7 @@ def generate_tutorial_structure_md(root: Path) -> str:
 
 ```text
 tutorials/<tutorial-name>/
-  index.md
+  README.md
   01-*.md
   02-*.md
   ...
@@ -148,7 +148,7 @@ def generate_content_gaps_md(root: Path) -> str:
 
 A tutorial track is considered production-ready when:
 
-- it has `index.md` with valid local links
+- it has `README.md` with valid local links
 - it has a coherent numbered chapter sequence
 - its summary and snapshot language are not stale or placeholder quality
 - it passes repository docs health checks
diff --git a/scripts/update_tutorials_readme_snapshot.py b/scripts/update_tutorials_readme_snapshot.py
index 6d380112..b1b254ee 100755
--- a/scripts/update_tutorials_readme_snapshot.py
+++ b/scripts/update_tutorials_readme_snapshot.py
@@ -13,7 +13,7 @@
 
 def compute_metrics(root: Path) -> dict:
     tutorials_root = root / "tutorials"
-    tutorial_dirs = sorted([p for p in tutorials_root.iterdir() if p.is_dir() and (p / "index.md").is_file()])
+    tutorial_dirs = sorted([p for p in tutorials_root.iterdir() if p.is_dir() and (p / "README.md").is_file()])
 
     md_files = [f for d in tutorial_dirs for f in d.glob("*.md")]
     md_lines = 0
@@ -63,7 +63,7 @@ def update_readme_content(content: str, metrics: dict) -> str:
         r"\| Tutorial directories \| .* \|": f"| Tutorial directories | {metrics['tutorial_directories']} |",
         r"\| Tutorial markdown files \| .* \|": f"| Tutorial markdown files | {metrics['tutorial_markdown_files']} |",
         r"\| Tutorial markdown lines \| .* \|": f"| Tutorial markdown lines | {metrics['tutorial_markdown_lines']:,} |",
-        r"\| Root chapter files \| .* \|": f"| Root chapter files | {metrics['structure_counts']['root_only']} | `index.md` + top-level `01-...md` to `08-...md` |",
+        r"\| Root chapter files \| .* \|": f"| Root chapter files | {metrics['structure_counts']['root_only']} | `README.md` + top-level `01-...md` to `08-...md` |",
         r"\| `docs/` chapter files \| .* \|": f"| `docs/` chapter files | {metrics['structure_counts']['docs_only']} | Deprecated and fully migrated |",
         r"\| Index-only roadmap \| .* \|": f"| Index-only roadmap | {metrics['structure_counts']['index_only']} | All catalog entries publish full chapter sets |",
         r"\| Mixed root \+ `docs/` \| .* \|": f"| Mixed root + `docs/` | {metrics['structure_counts']['mixed']} | Legacy hybrid layout removed |",
diff --git a/scripts/verify_tutorial_sources.py b/scripts/verify_tutorial_sources.py
index 2df9317c..0afdc5b4 100644
--- a/scripts/verify_tutorial_sources.py
+++ b/scripts/verify_tutorial_sources.py
@@ -59,7 +59,7 @@ def collect_tutorial_records(root: Path) -> list[TutorialSourceRecord]:
     records: list[TutorialSourceRecord] = []
 
     for tutorial_dir in sorted(p for p in tutorials_root.iterdir() if p.is_dir()):
-        index_path = tutorial_dir / "index.md"
+        index_path = tutorial_dir / "README.md"
         if not index_path.is_file():
             continue
         text = index_path.read_text(encoding="utf-8", errors="ignore")
@@ -248,7 +248,7 @@ def render_markdown(report: dict[str, Any]) -> str:
     lines = [
         "# Tutorial Source Verification Report",
         "",
-        "Automated verification of GitHub source repositories referenced by `tutorials/*/index.md`.",
+        "Automated verification of GitHub source repositories referenced by `tutorials/*/README.md`.",
         "",
         f"- generated_on: **{report['generated_on']}**",
         f"- tutorials scanned: **{summary['tutorial_count']}**",
diff --git a/tutorials/README.md b/tutorials/README.md
index 620dda93..0a7689d5 100644
--- a/tutorials/README.md
+++ b/tutorials/README.md
@@ -15,8 +15,8 @@ Use this guide to navigate all tutorial tracks, understand structure rules, and
 | Metric | Value |
 |:-------|:------|
 | Tutorial directories | 191 |
-| Tutorial markdown files | 1732 |
-| Tutorial markdown lines | 1,048,772 |
+| Tutorial markdown files | 1722 |
+| Tutorial markdown lines | 1,048,086 |
 
 ## Source Verification Snapshot
 
@@ -37,7 +37,7 @@ Repository-source verification run against tutorial index references (GitHub API
 
 | Pattern | Count | Description |
 |:--------|:------|:------------|
-| Root chapter files | 191 | `index.md` + top-level `01-...md` to `08-...md` |
+| Root chapter files | 191 | `README.md` + top-level `01-...md` to `08-...md` |
 | `docs/` chapter files | 0 | Deprecated and fully migrated |
 | Index-only roadmap | 0 | All catalog entries publish full chapter sets |
 | Mixed root + `docs/` | 0 | Legacy hybrid layout removed |
@@ -55,7 +55,7 @@ Each tutorial index should provide:
 
 Each tutorial directory should contain:
 
-- `index.md`
+- `README.md`
 - `01-...md` through `08-...md` at the tutorial root (not under `docs/`)
 
 ## Maintainer Commands
diff --git a/tutorials/activepieces-tutorial/01-getting-started.md b/tutorials/activepieces-tutorial/01-getting-started.md
index 06a93b1d..472441d4 100644
--- a/tutorials/activepieces-tutorial/01-getting-started.md
+++ b/tutorials/activepieces-tutorial/01-getting-started.md
@@ -636,7 +636,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: System Architecture: App, Worker, Engine](02-system-architecture-app-worker-engine.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/activepieces-tutorial/02-system-architecture-app-worker-engine.md b/tutorials/activepieces-tutorial/02-system-architecture-app-worker-engine.md
index dda73ca8..06c21cee 100644
--- a/tutorials/activepieces-tutorial/02-system-architecture-app-worker-engine.md
+++ b/tutorials/activepieces-tutorial/02-system-architecture-app-worker-engine.md
@@ -640,7 +640,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started](01-getting-started.md)
 - [Next Chapter: Chapter 3: Flow Design, Versioning, and Debugging](03-flow-design-versioning-and-debugging.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/activepieces-tutorial/03-flow-design-versioning-and-debugging.md b/tutorials/activepieces-tutorial/03-flow-design-versioning-and-debugging.md
index 491267cf..c45ad4b3 100644
--- a/tutorials/activepieces-tutorial/03-flow-design-versioning-and-debugging.md
+++ b/tutorials/activepieces-tutorial/03-flow-design-versioning-and-debugging.md
@@ -638,7 +638,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: System Architecture: App, Worker, Engine](02-system-architecture-app-worker-engine.md)
 - [Next Chapter: Chapter 4: Piece Development Framework](04-piece-development-framework.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/activepieces-tutorial/04-piece-development-framework.md b/tutorials/activepieces-tutorial/04-piece-development-framework.md
index 16eb6986..abfe79af 100644
--- a/tutorials/activepieces-tutorial/04-piece-development-framework.md
+++ b/tutorials/activepieces-tutorial/04-piece-development-framework.md
@@ -638,7 +638,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Flow Design, Versioning, and Debugging](03-flow-design-versioning-and-debugging.md)
 - [Next Chapter: Chapter 5: Installation and Environment Configuration](05-installation-and-environment-configuration.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/activepieces-tutorial/05-installation-and-environment-configuration.md b/tutorials/activepieces-tutorial/05-installation-and-environment-configuration.md
index 671daec5..d8e17fe7 100644
--- a/tutorials/activepieces-tutorial/05-installation-and-environment-configuration.md
+++ b/tutorials/activepieces-tutorial/05-installation-and-environment-configuration.md
@@ -637,7 +637,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Piece Development Framework](04-piece-development-framework.md)
 - [Next Chapter: Chapter 6: Admin Governance and AI Provider Control](06-admin-governance-and-ai-provider-control.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/activepieces-tutorial/06-admin-governance-and-ai-provider-control.md b/tutorials/activepieces-tutorial/06-admin-governance-and-ai-provider-control.md
index 56edb0e2..f9966132 100644
--- a/tutorials/activepieces-tutorial/06-admin-governance-and-ai-provider-control.md
+++ b/tutorials/activepieces-tutorial/06-admin-governance-and-ai-provider-control.md
@@ -635,7 +635,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Installation and Environment Configuration](05-installation-and-environment-configuration.md)
 - [Next Chapter: Chapter 7: API Automation and Embedding Patterns](07-api-automation-and-embedding-patterns.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/activepieces-tutorial/07-api-automation-and-embedding-patterns.md b/tutorials/activepieces-tutorial/07-api-automation-and-embedding-patterns.md
index 57154fb5..a2f236ce 100644
--- a/tutorials/activepieces-tutorial/07-api-automation-and-embedding-patterns.md
+++ b/tutorials/activepieces-tutorial/07-api-automation-and-embedding-patterns.md
@@ -638,7 +638,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Admin Governance and AI Provider Control](06-admin-governance-and-ai-provider-control.md)
 - [Next Chapter: Chapter 8: Production Operations, Security, and Contribution](08-production-operations-security-and-contribution.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/activepieces-tutorial/08-production-operations-security-and-contribution.md b/tutorials/activepieces-tutorial/08-production-operations-security-and-contribution.md
index 41873d8f..808448c1 100644
--- a/tutorials/activepieces-tutorial/08-production-operations-security-and-contribution.md
+++ b/tutorials/activepieces-tutorial/08-production-operations-security-and-contribution.md
@@ -635,7 +635,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: API Automation and Embedding Patterns](07-api-automation-and-embedding-patterns.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/activepieces-tutorial/index.md b/tutorials/activepieces-tutorial/README.md
similarity index 100%
rename from tutorials/activepieces-tutorial/index.md
rename to tutorials/activepieces-tutorial/README.md
diff --git a/tutorials/adk-python-tutorial/01-getting-started.md b/tutorials/adk-python-tutorial/01-getting-started.md
index 157c1a39..fd74e24a 100644
--- a/tutorials/adk-python-tutorial/01-getting-started.md
+++ b/tutorials/adk-python-tutorial/01-getting-started.md
@@ -636,7 +636,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Architecture and Runner Lifecycle](02-architecture-and-runner-lifecycle.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/adk-python-tutorial/02-architecture-and-runner-lifecycle.md b/tutorials/adk-python-tutorial/02-architecture-and-runner-lifecycle.md
index 97783703..310f8c3e 100644
--- a/tutorials/adk-python-tutorial/02-architecture-and-runner-lifecycle.md
+++ b/tutorials/adk-python-tutorial/02-architecture-and-runner-lifecycle.md
@@ -637,7 +637,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started](01-getting-started.md)
 - [Next Chapter: Chapter 3: Agent Design and Multi-Agent Composition](03-agent-design-and-multi-agent-composition.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/adk-python-tutorial/03-agent-design-and-multi-agent-composition.md b/tutorials/adk-python-tutorial/03-agent-design-and-multi-agent-composition.md
index 9da788e9..8712f0a5 100644
--- a/tutorials/adk-python-tutorial/03-agent-design-and-multi-agent-composition.md
+++ b/tutorials/adk-python-tutorial/03-agent-design-and-multi-agent-composition.md
@@ -636,7 +636,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Architecture and Runner Lifecycle](02-architecture-and-runner-lifecycle.md)
 - [Next Chapter: Chapter 4: Tools, MCP, and Confirmation Flows](04-tools-mcp-and-confirmation-flows.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/adk-python-tutorial/04-tools-mcp-and-confirmation-flows.md b/tutorials/adk-python-tutorial/04-tools-mcp-and-confirmation-flows.md
index dff17cba..a174d36a 100644
--- a/tutorials/adk-python-tutorial/04-tools-mcp-and-confirmation-flows.md
+++ b/tutorials/adk-python-tutorial/04-tools-mcp-and-confirmation-flows.md
@@ -634,7 +634,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Agent Design and Multi-Agent Composition](03-agent-design-and-multi-agent-composition.md)
 - [Next Chapter: Chapter 5: Sessions, Memory, and Context Management](05-sessions-memory-and-context-management.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/adk-python-tutorial/05-sessions-memory-and-context-management.md b/tutorials/adk-python-tutorial/05-sessions-memory-and-context-management.md
index 1e8f4163..1e2de2e6 100644
--- a/tutorials/adk-python-tutorial/05-sessions-memory-and-context-management.md
+++ b/tutorials/adk-python-tutorial/05-sessions-memory-and-context-management.md
@@ -630,7 +630,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Tools, MCP, and Confirmation Flows](04-tools-mcp-and-confirmation-flows.md)
 - [Next Chapter: Chapter 6: Evaluation, Debugging, and Quality Gates](06-evaluation-debugging-and-quality-gates.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/adk-python-tutorial/06-evaluation-debugging-and-quality-gates.md b/tutorials/adk-python-tutorial/06-evaluation-debugging-and-quality-gates.md
index 557d7d0b..53d8b743 100644
--- a/tutorials/adk-python-tutorial/06-evaluation-debugging-and-quality-gates.md
+++ b/tutorials/adk-python-tutorial/06-evaluation-debugging-and-quality-gates.md
@@ -630,7 +630,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Sessions, Memory, and Context Management](05-sessions-memory-and-context-management.md)
 - [Next Chapter: Chapter 7: Deployment and Production Operations](07-deployment-and-production-operations.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/adk-python-tutorial/07-deployment-and-production-operations.md b/tutorials/adk-python-tutorial/07-deployment-and-production-operations.md
index 735b5ea8..c2689b89 100644
--- a/tutorials/adk-python-tutorial/07-deployment-and-production-operations.md
+++ b/tutorials/adk-python-tutorial/07-deployment-and-production-operations.md
@@ -636,7 +636,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Evaluation, Debugging, and Quality Gates](06-evaluation-debugging-and-quality-gates.md)
 - [Next Chapter: Chapter 8: Contribution Workflow and Ecosystem Strategy](08-contribution-workflow-and-ecosystem-strategy.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/adk-python-tutorial/08-contribution-workflow-and-ecosystem-strategy.md b/tutorials/adk-python-tutorial/08-contribution-workflow-and-ecosystem-strategy.md
index 6f9ab8b5..a30d03a2 100644
--- a/tutorials/adk-python-tutorial/08-contribution-workflow-and-ecosystem-strategy.md
+++ b/tutorials/adk-python-tutorial/08-contribution-workflow-and-ecosystem-strategy.md
@@ -637,7 +637,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Deployment and Production Operations](07-deployment-and-production-operations.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/adk-python-tutorial/index.md b/tutorials/adk-python-tutorial/README.md
similarity index 100%
rename from tutorials/adk-python-tutorial/index.md
rename to tutorials/adk-python-tutorial/README.md
diff --git a/tutorials/ag2-tutorial/01-getting-started.md b/tutorials/ag2-tutorial/01-getting-started.md
index 36cdb77c..34529f14 100644
--- a/tutorials/ag2-tutorial/01-getting-started.md
+++ b/tutorials/ag2-tutorial/01-getting-started.md
@@ -677,7 +677,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Agent Types & Configuration](02-agent-types.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/ag2-tutorial/02-agent-types.md b/tutorials/ag2-tutorial/02-agent-types.md
index 2cd6cb9a..a5440c93 100644
--- a/tutorials/ag2-tutorial/02-agent-types.md
+++ b/tutorials/ag2-tutorial/02-agent-types.md
@@ -483,7 +483,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started with AG2](01-getting-started.md)
 - [Next Chapter: Chapter 3: Conversation Patterns](03-conversation-patterns.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/ag2-tutorial/03-conversation-patterns.md b/tutorials/ag2-tutorial/03-conversation-patterns.md
index f8cab5e7..76fa4b26 100644
--- a/tutorials/ag2-tutorial/03-conversation-patterns.md
+++ b/tutorials/ag2-tutorial/03-conversation-patterns.md
@@ -611,7 +611,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Agent Types & Configuration](02-agent-types.md)
 - [Next Chapter: Chapter 4: Code Execution & Security](04-code-execution.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/ag2-tutorial/04-code-execution.md b/tutorials/ag2-tutorial/04-code-execution.md
index e58800c3..e59a8d4d 100644
--- a/tutorials/ag2-tutorial/04-code-execution.md
+++ b/tutorials/ag2-tutorial/04-code-execution.md
@@ -619,7 +619,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Conversation Patterns](03-conversation-patterns.md)
 - [Next Chapter: Chapter 5: Tool Integration & Function Calling](05-tool-integration.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/ag2-tutorial/05-tool-integration.md b/tutorials/ag2-tutorial/05-tool-integration.md
index 5922cadc..4e2acfab 100644
--- a/tutorials/ag2-tutorial/05-tool-integration.md
+++ b/tutorials/ag2-tutorial/05-tool-integration.md
@@ -766,7 +766,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Code Execution & Security](04-code-execution.md)
 - [Next Chapter: Chapter 6: Group Chat & Multi-Agent Collaboration](06-group-chat.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/ag2-tutorial/06-group-chat.md b/tutorials/ag2-tutorial/06-group-chat.md
index efcb9126..99635eae 100644
--- a/tutorials/ag2-tutorial/06-group-chat.md
+++ b/tutorials/ag2-tutorial/06-group-chat.md
@@ -639,7 +639,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Tool Integration & Function Calling](05-tool-integration.md)
 - [Next Chapter: Chapter 7: Advanced Patterns & Optimization](07-advanced-patterns.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/ag2-tutorial/07-advanced-patterns.md b/tutorials/ag2-tutorial/07-advanced-patterns.md
index b437b3a1..b27cbfbb 100644
--- a/tutorials/ag2-tutorial/07-advanced-patterns.md
+++ b/tutorials/ag2-tutorial/07-advanced-patterns.md
@@ -1002,7 +1002,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Group Chat & Multi-Agent Collaboration](06-group-chat.md)
 - [Next Chapter: Chapter 8: Production Deployment & Scaling](08-production.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/ag2-tutorial/08-production.md b/tutorials/ag2-tutorial/08-production.md
index 89392198..e51d25a1 100644
--- a/tutorials/ag2-tutorial/08-production.md
+++ b/tutorials/ag2-tutorial/08-production.md
@@ -1255,7 +1255,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Advanced Patterns & Optimization](07-advanced-patterns.md)
 - [Next Chapter: Chapter 9: Enterprise Operations & Advanced Patterns](09-enterprise-operations.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/ag2-tutorial/09-enterprise-operations.md b/tutorials/ag2-tutorial/09-enterprise-operations.md
index b0e61c71..6585b0d9 100644
--- a/tutorials/ag2-tutorial/09-enterprise-operations.md
+++ b/tutorials/ag2-tutorial/09-enterprise-operations.md
@@ -1690,7 +1690,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 8: Production Deployment & Scaling](08-production.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/ag2-tutorial/index.md b/tutorials/ag2-tutorial/README.md
similarity index 100%
rename from tutorials/ag2-tutorial/index.md
rename to tutorials/ag2-tutorial/README.md
diff --git a/tutorials/agentgpt-tutorial/01-getting-started.md b/tutorials/agentgpt-tutorial/01-getting-started.md
index 397fe1aa..f5ce30e6 100644
--- a/tutorials/agentgpt-tutorial/01-getting-started.md
+++ b/tutorials/agentgpt-tutorial/01-getting-started.md
@@ -563,7 +563,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Agent Architecture & Design](02-agent-architecture.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/agentgpt-tutorial/02-agent-architecture.md b/tutorials/agentgpt-tutorial/02-agent-architecture.md
index 4c7dd26f..3110c049 100644
--- a/tutorials/agentgpt-tutorial/02-agent-architecture.md
+++ b/tutorials/agentgpt-tutorial/02-agent-architecture.md
@@ -490,7 +490,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started with AgentGPT](01-getting-started.md)
 - [Next Chapter: Chapter 3: Task Planning & Goal Setting](03-task-planning.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/agentgpt-tutorial/03-task-planning.md b/tutorials/agentgpt-tutorial/03-task-planning.md
index 6f21fd07..f287bdae 100644
--- a/tutorials/agentgpt-tutorial/03-task-planning.md
+++ b/tutorials/agentgpt-tutorial/03-task-planning.md
@@ -506,7 +506,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Agent Architecture & Design](02-agent-architecture.md)
 - [Next Chapter: Chapter 4: Tool Integration & APIs](04-tool-integration.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/agentgpt-tutorial/04-tool-integration.md b/tutorials/agentgpt-tutorial/04-tool-integration.md
index bf6c2180..427a74c9 100644
--- a/tutorials/agentgpt-tutorial/04-tool-integration.md
+++ b/tutorials/agentgpt-tutorial/04-tool-integration.md
@@ -587,7 +587,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Task Planning & Goal Setting](03-task-planning.md)
 - [Next Chapter: Chapter 5: Memory & Context Management](05-memory-management.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/agentgpt-tutorial/05-memory-management.md b/tutorials/agentgpt-tutorial/05-memory-management.md
index 0874182e..81ca7c09 100644
--- a/tutorials/agentgpt-tutorial/05-memory-management.md
+++ b/tutorials/agentgpt-tutorial/05-memory-management.md
@@ -593,7 +593,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Tool Integration & APIs](04-tool-integration.md)
 - [Next Chapter: Chapter 6: Safety & Reliability](06-safety-reliability.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/agentgpt-tutorial/06-safety-reliability.md b/tutorials/agentgpt-tutorial/06-safety-reliability.md
index 5c94c501..6627af85 100644
--- a/tutorials/agentgpt-tutorial/06-safety-reliability.md
+++ b/tutorials/agentgpt-tutorial/06-safety-reliability.md
@@ -673,7 +673,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Memory & Context Management](05-memory-management.md)
 - [Next Chapter: Chapter 7: Advanced Agent Patterns](07-advanced-patterns.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/agentgpt-tutorial/07-advanced-patterns.md b/tutorials/agentgpt-tutorial/07-advanced-patterns.md
index ed54b0ae..ed530a1a 100644
--- a/tutorials/agentgpt-tutorial/07-advanced-patterns.md
+++ b/tutorials/agentgpt-tutorial/07-advanced-patterns.md
@@ -742,7 +742,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Safety & Reliability](06-safety-reliability.md)
 - [Next Chapter: Chapter 8: Production Deployment](08-production-deployment.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/agentgpt-tutorial/08-production-deployment.md b/tutorials/agentgpt-tutorial/08-production-deployment.md
index a7b18f88..296e52a1 100644
--- a/tutorials/agentgpt-tutorial/08-production-deployment.md
+++ b/tutorials/agentgpt-tutorial/08-production-deployment.md
@@ -835,7 +835,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Advanced Agent Patterns](07-advanced-patterns.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/agentgpt-tutorial/index.md b/tutorials/agentgpt-tutorial/README.md
similarity index 100%
rename from tutorials/agentgpt-tutorial/index.md
rename to tutorials/agentgpt-tutorial/README.md
diff --git a/tutorials/agenticseek-tutorial/01-getting-started.md b/tutorials/agenticseek-tutorial/01-getting-started.md
index cd55fad4..c4363e05 100644
--- a/tutorials/agenticseek-tutorial/01-getting-started.md
+++ b/tutorials/agenticseek-tutorial/01-getting-started.md
@@ -640,7 +640,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Architecture and Routing System](02-architecture-and-routing-system.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/agenticseek-tutorial/02-architecture-and-routing-system.md b/tutorials/agenticseek-tutorial/02-architecture-and-routing-system.md
index 09f16117..caf241b3 100644
--- a/tutorials/agenticseek-tutorial/02-architecture-and-routing-system.md
+++ b/tutorials/agenticseek-tutorial/02-architecture-and-routing-system.md
@@ -635,7 +635,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started](01-getting-started.md)
 - [Next Chapter: Chapter 3: Installation, Runtime, and Provider Setup](03-installation-runtime-and-provider-setup.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/agenticseek-tutorial/03-installation-runtime-and-provider-setup.md b/tutorials/agenticseek-tutorial/03-installation-runtime-and-provider-setup.md
index 9fdb275d..60c53484 100644
--- a/tutorials/agenticseek-tutorial/03-installation-runtime-and-provider-setup.md
+++ b/tutorials/agenticseek-tutorial/03-installation-runtime-and-provider-setup.md
@@ -635,7 +635,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Architecture and Routing System](02-architecture-and-routing-system.md)
 - [Next Chapter: Chapter 4: Docker Web Mode and CLI Operations](04-docker-web-mode-and-cli-operations.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/agenticseek-tutorial/04-docker-web-mode-and-cli-operations.md b/tutorials/agenticseek-tutorial/04-docker-web-mode-and-cli-operations.md
index 4928eaf8..e002cafd 100644
--- a/tutorials/agenticseek-tutorial/04-docker-web-mode-and-cli-operations.md
+++ b/tutorials/agenticseek-tutorial/04-docker-web-mode-and-cli-operations.md
@@ -635,7 +635,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Installation, Runtime, and Provider Setup](03-installation-runtime-and-provider-setup.md)
 - [Next Chapter: Chapter 5: Tools, Browser Automation, and Workspace Governance](05-tools-browser-automation-and-workspace-governance.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/agenticseek-tutorial/05-tools-browser-automation-and-workspace-governance.md b/tutorials/agenticseek-tutorial/05-tools-browser-automation-and-workspace-governance.md
index 8108e947..bbd2eb22 100644
--- a/tutorials/agenticseek-tutorial/05-tools-browser-automation-and-workspace-governance.md
+++ b/tutorials/agenticseek-tutorial/05-tools-browser-automation-and-workspace-governance.md
@@ -636,7 +636,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Docker Web Mode and CLI Operations](04-docker-web-mode-and-cli-operations.md)
 - [Next Chapter: Chapter 6: Model Strategy and Remote Server Mode](06-model-strategy-and-remote-server-mode.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/agenticseek-tutorial/06-model-strategy-and-remote-server-mode.md b/tutorials/agenticseek-tutorial/06-model-strategy-and-remote-server-mode.md
index 0d207712..af56be7b 100644
--- a/tutorials/agenticseek-tutorial/06-model-strategy-and-remote-server-mode.md
+++ b/tutorials/agenticseek-tutorial/06-model-strategy-and-remote-server-mode.md
@@ -640,7 +640,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Tools, Browser Automation, and Workspace Governance](05-tools-browser-automation-and-workspace-governance.md)
 - [Next Chapter: Chapter 7: Troubleshooting and Reliability Playbook](07-troubleshooting-and-reliability-playbook.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/agenticseek-tutorial/07-troubleshooting-and-reliability-playbook.md b/tutorials/agenticseek-tutorial/07-troubleshooting-and-reliability-playbook.md
index ef790ef5..473c320b 100644
--- a/tutorials/agenticseek-tutorial/07-troubleshooting-and-reliability-playbook.md
+++ b/tutorials/agenticseek-tutorial/07-troubleshooting-and-reliability-playbook.md
@@ -629,7 +629,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Model Strategy and Remote Server Mode](06-model-strategy-and-remote-server-mode.md)
 - [Next Chapter: Chapter 8: Contribution Workflow and Project Governance](08-contribution-workflow-and-project-governance.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/agenticseek-tutorial/08-contribution-workflow-and-project-governance.md b/tutorials/agenticseek-tutorial/08-contribution-workflow-and-project-governance.md
index 0fc587df..bc37157e 100644
--- a/tutorials/agenticseek-tutorial/08-contribution-workflow-and-project-governance.md
+++ b/tutorials/agenticseek-tutorial/08-contribution-workflow-and-project-governance.md
@@ -635,7 +635,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Troubleshooting and Reliability Playbook](07-troubleshooting-and-reliability-playbook.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/agenticseek-tutorial/index.md b/tutorials/agenticseek-tutorial/README.md
similarity index 100%
rename from tutorials/agenticseek-tutorial/index.md
rename to tutorials/agenticseek-tutorial/README.md
diff --git a/tutorials/agents-md-tutorial/01-getting-started.md b/tutorials/agents-md-tutorial/01-getting-started.md
index d0744b95..a3b186c9 100644
--- a/tutorials/agents-md-tutorial/01-getting-started.md
+++ b/tutorials/agents-md-tutorial/01-getting-started.md
@@ -634,7 +634,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Section Design and Instruction Quality](02-section-design-and-instruction-quality.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/agents-md-tutorial/02-section-design-and-instruction-quality.md b/tutorials/agents-md-tutorial/02-section-design-and-instruction-quality.md
index d6ace82f..8582af18 100644
--- a/tutorials/agents-md-tutorial/02-section-design-and-instruction-quality.md
+++ b/tutorials/agents-md-tutorial/02-section-design-and-instruction-quality.md
@@ -635,7 +635,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started](01-getting-started.md)
 - [Next Chapter: Chapter 3: Tool-Agnostic Portability Patterns](03-tool-agnostic-portability-patterns.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/agents-md-tutorial/03-tool-agnostic-portability-patterns.md b/tutorials/agents-md-tutorial/03-tool-agnostic-portability-patterns.md
index aa4cd243..b58eb8e8 100644
--- a/tutorials/agents-md-tutorial/03-tool-agnostic-portability-patterns.md
+++ b/tutorials/agents-md-tutorial/03-tool-agnostic-portability-patterns.md
@@ -634,7 +634,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Section Design and Instruction Quality](02-section-design-and-instruction-quality.md)
 - [Next Chapter: Chapter 4: Repository Structure and Scope Strategy](04-repository-structure-and-scope-strategy.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/agents-md-tutorial/04-repository-structure-and-scope-strategy.md b/tutorials/agents-md-tutorial/04-repository-structure-and-scope-strategy.md
index 257abd6d..acf4ca64 100644
--- a/tutorials/agents-md-tutorial/04-repository-structure-and-scope-strategy.md
+++ b/tutorials/agents-md-tutorial/04-repository-structure-and-scope-strategy.md
@@ -634,7 +634,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Tool-Agnostic Portability Patterns](03-tool-agnostic-portability-patterns.md)
 - [Next Chapter: Chapter 5: Testing, Linting, and CI Alignment](05-testing-linting-and-ci-alignment.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/agents-md-tutorial/05-testing-linting-and-ci-alignment.md b/tutorials/agents-md-tutorial/05-testing-linting-and-ci-alignment.md
index 42391894..b8b200a5 100644
--- a/tutorials/agents-md-tutorial/05-testing-linting-and-ci-alignment.md
+++ b/tutorials/agents-md-tutorial/05-testing-linting-and-ci-alignment.md
@@ -634,7 +634,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Repository Structure and Scope Strategy](04-repository-structure-and-scope-strategy.md)
 - [Next Chapter: Chapter 6: Team Rollout and Adoption Playbook](06-team-rollout-and-adoption-playbook.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/agents-md-tutorial/06-team-rollout-and-adoption-playbook.md b/tutorials/agents-md-tutorial/06-team-rollout-and-adoption-playbook.md
index b63ca836..a8b1702d 100644
--- a/tutorials/agents-md-tutorial/06-team-rollout-and-adoption-playbook.md
+++ b/tutorials/agents-md-tutorial/06-team-rollout-and-adoption-playbook.md
@@ -635,7 +635,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Testing, Linting, and CI Alignment](05-testing-linting-and-ci-alignment.md)
 - [Next Chapter: Chapter 7: Governance, Versioning, and Drift Control](07-governance-versioning-and-drift-control.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/agents-md-tutorial/07-governance-versioning-and-drift-control.md b/tutorials/agents-md-tutorial/07-governance-versioning-and-drift-control.md
index 38a08f62..aead06cc 100644
--- a/tutorials/agents-md-tutorial/07-governance-versioning-and-drift-control.md
+++ b/tutorials/agents-md-tutorial/07-governance-versioning-and-drift-control.md
@@ -634,7 +634,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Team Rollout and Adoption Playbook](06-team-rollout-and-adoption-playbook.md)
 - [Next Chapter: Chapter 8: Ecosystem Contribution and Standard Evolution](08-ecosystem-contribution-and-standard-evolution.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/agents-md-tutorial/08-ecosystem-contribution-and-standard-evolution.md b/tutorials/agents-md-tutorial/08-ecosystem-contribution-and-standard-evolution.md
index 2f4b8119..59646650 100644
--- a/tutorials/agents-md-tutorial/08-ecosystem-contribution-and-standard-evolution.md
+++ b/tutorials/agents-md-tutorial/08-ecosystem-contribution-and-standard-evolution.md
@@ -635,7 +635,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Governance, Versioning, and Drift Control](07-governance-versioning-and-drift-control.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/agents-md-tutorial/index.md b/tutorials/agents-md-tutorial/README.md
similarity index 100%
rename from tutorials/agents-md-tutorial/index.md
rename to tutorials/agents-md-tutorial/README.md
diff --git a/tutorials/agno-tutorial/01-getting-started.md b/tutorials/agno-tutorial/01-getting-started.md
index ff166bc5..5ccc50eb 100644
--- a/tutorials/agno-tutorial/01-getting-started.md
+++ b/tutorials/agno-tutorial/01-getting-started.md
@@ -629,7 +629,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Framework Architecture](02-framework-architecture.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/agno-tutorial/02-framework-architecture.md b/tutorials/agno-tutorial/02-framework-architecture.md
index cfe44890..358d3acf 100644
--- a/tutorials/agno-tutorial/02-framework-architecture.md
+++ b/tutorials/agno-tutorial/02-framework-architecture.md
@@ -631,7 +631,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started](01-getting-started.md)
 - [Next Chapter: Chapter 3: Learning, Memory, and State](03-learning-memory-and-state.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/agno-tutorial/03-learning-memory-and-state.md b/tutorials/agno-tutorial/03-learning-memory-and-state.md
index 0d83c024..76e2f3b4 100644
--- a/tutorials/agno-tutorial/03-learning-memory-and-state.md
+++ b/tutorials/agno-tutorial/03-learning-memory-and-state.md
@@ -635,7 +635,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Framework Architecture](02-framework-architecture.md)
 - [Next Chapter: Chapter 4: Multi-Agent Orchestration](04-multi-agent-orchestration.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/agno-tutorial/04-multi-agent-orchestration.md b/tutorials/agno-tutorial/04-multi-agent-orchestration.md
index dde3f4d9..8127ea0d 100644
--- a/tutorials/agno-tutorial/04-multi-agent-orchestration.md
+++ b/tutorials/agno-tutorial/04-multi-agent-orchestration.md
@@ -635,7 +635,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Learning, Memory, and State](03-learning-memory-and-state.md)
 - [Next Chapter: Chapter 5: Knowledge, RAG, and Tools](05-knowledge-rag-and-tools.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/agno-tutorial/05-knowledge-rag-and-tools.md b/tutorials/agno-tutorial/05-knowledge-rag-and-tools.md
index adb8c357..7577343c 100644
--- a/tutorials/agno-tutorial/05-knowledge-rag-and-tools.md
+++ b/tutorials/agno-tutorial/05-knowledge-rag-and-tools.md
@@ -635,7 +635,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Multi-Agent Orchestration](04-multi-agent-orchestration.md)
 - [Next Chapter: Chapter 6: AgentOS Runtime and Control Plane](06-agentos-runtime-and-control-plane.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/agno-tutorial/06-agentos-runtime-and-control-plane.md b/tutorials/agno-tutorial/06-agentos-runtime-and-control-plane.md
index 0b13fea0..998eb29e 100644
--- a/tutorials/agno-tutorial/06-agentos-runtime-and-control-plane.md
+++ b/tutorials/agno-tutorial/06-agentos-runtime-and-control-plane.md
@@ -635,7 +635,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Knowledge, RAG, and Tools](05-knowledge-rag-and-tools.md)
 - [Next Chapter: Chapter 7: Guardrails, Evals, and Observability](07-guardrails-evals-and-observability.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/agno-tutorial/07-guardrails-evals-and-observability.md b/tutorials/agno-tutorial/07-guardrails-evals-and-observability.md
index 993c8ce8..fb403cd0 100644
--- a/tutorials/agno-tutorial/07-guardrails-evals-and-observability.md
+++ b/tutorials/agno-tutorial/07-guardrails-evals-and-observability.md
@@ -624,7 +624,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: AgentOS Runtime and Control Plane](06-agentos-runtime-and-control-plane.md)
 - [Next Chapter: Chapter 8: Production Deployment](08-production-deployment.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/agno-tutorial/08-production-deployment.md b/tutorials/agno-tutorial/08-production-deployment.md
index 4ea565be..a3167bcf 100644
--- a/tutorials/agno-tutorial/08-production-deployment.md
+++ b/tutorials/agno-tutorial/08-production-deployment.md
@@ -635,7 +635,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Guardrails, Evals, and Observability](07-guardrails-evals-and-observability.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/agno-tutorial/index.md b/tutorials/agno-tutorial/README.md
similarity index 100%
rename from tutorials/agno-tutorial/index.md
rename to tutorials/agno-tutorial/README.md
diff --git a/tutorials/aider-tutorial/01-getting-started.md b/tutorials/aider-tutorial/01-getting-started.md
index f0194f67..014da5b7 100644
--- a/tutorials/aider-tutorial/01-getting-started.md
+++ b/tutorials/aider-tutorial/01-getting-started.md
@@ -704,7 +704,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Basic Editing Operations](02-basic-editing.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/aider-tutorial/02-basic-editing.md b/tutorials/aider-tutorial/02-basic-editing.md
index aef5862a..bdefe57f 100644
--- a/tutorials/aider-tutorial/02-basic-editing.md
+++ b/tutorials/aider-tutorial/02-basic-editing.md
@@ -665,7 +665,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started with Aider](01-getting-started.md)
 - [Next Chapter: Chapter 3: Multi-File Projects](03-multi-file.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/aider-tutorial/03-multi-file.md b/tutorials/aider-tutorial/03-multi-file.md
index c1713841..10ac8e1e 100644
--- a/tutorials/aider-tutorial/03-multi-file.md
+++ b/tutorials/aider-tutorial/03-multi-file.md
@@ -719,7 +719,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Basic Editing Operations](02-basic-editing.md)
 - [Next Chapter: Chapter 4: Git Integration](04-git.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/aider-tutorial/04-git.md b/tutorials/aider-tutorial/04-git.md
index bec2bdca..7f7caedd 100644
--- a/tutorials/aider-tutorial/04-git.md
+++ b/tutorials/aider-tutorial/04-git.md
@@ -636,7 +636,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Multi-File Projects](03-multi-file.md)
 - [Next Chapter: Chapter 5: Advanced Prompting](05-prompting.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/aider-tutorial/05-prompting.md b/tutorials/aider-tutorial/05-prompting.md
index cdbad97b..35c49c54 100644
--- a/tutorials/aider-tutorial/05-prompting.md
+++ b/tutorials/aider-tutorial/05-prompting.md
@@ -626,7 +626,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Git Integration](04-git.md)
 - [Next Chapter: Chapter 6: Model Configuration](06-models.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/aider-tutorial/06-models.md b/tutorials/aider-tutorial/06-models.md
index f995c424..8862f15e 100644
--- a/tutorials/aider-tutorial/06-models.md
+++ b/tutorials/aider-tutorial/06-models.md
@@ -627,7 +627,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Advanced Prompting](05-prompting.md)
 - [Next Chapter: Chapter 7: Voice & Workflows](07-workflows.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/aider-tutorial/07-workflows.md b/tutorials/aider-tutorial/07-workflows.md
index 4bad7a87..48969bd6 100644
--- a/tutorials/aider-tutorial/07-workflows.md
+++ b/tutorials/aider-tutorial/07-workflows.md
@@ -631,7 +631,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Model Configuration](06-models.md)
 - [Next Chapter: Chapter 8: Best Practices](08-best-practices.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/aider-tutorial/08-best-practices.md b/tutorials/aider-tutorial/08-best-practices.md
index 1c7c5a57..19c9580d 100644
--- a/tutorials/aider-tutorial/08-best-practices.md
+++ b/tutorials/aider-tutorial/08-best-practices.md
@@ -660,7 +660,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Voice & Workflows](07-workflows.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/aider-tutorial/index.md b/tutorials/aider-tutorial/README.md
similarity index 100%
rename from tutorials/aider-tutorial/index.md
rename to tutorials/aider-tutorial/README.md
diff --git a/tutorials/anthropic-code-tutorial/01-getting-started.md b/tutorials/anthropic-code-tutorial/01-getting-started.md
index 2ed35265..b820487b 100644
--- a/tutorials/anthropic-code-tutorial/01-getting-started.md
+++ b/tutorials/anthropic-code-tutorial/01-getting-started.md
@@ -697,7 +697,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Messages API](02-messages-api.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/anthropic-code-tutorial/02-messages-api.md b/tutorials/anthropic-code-tutorial/02-messages-api.md
index bc9856bf..a051349c 100644
--- a/tutorials/anthropic-code-tutorial/02-messages-api.md
+++ b/tutorials/anthropic-code-tutorial/02-messages-api.md
@@ -778,7 +778,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started with the Anthropic API](01-getting-started.md)
 - [Next Chapter: Chapter 3: Tool Use](03-tool-use.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/anthropic-code-tutorial/03-tool-use.md b/tutorials/anthropic-code-tutorial/03-tool-use.md
index e09a692a..01100194 100644
--- a/tutorials/anthropic-code-tutorial/03-tool-use.md
+++ b/tutorials/anthropic-code-tutorial/03-tool-use.md
@@ -904,7 +904,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Messages API](02-messages-api.md)
 - [Next Chapter: Chapter 4: Vision](04-vision.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/anthropic-code-tutorial/04-vision.md b/tutorials/anthropic-code-tutorial/04-vision.md
index 888ac0a9..beb12d1e 100644
--- a/tutorials/anthropic-code-tutorial/04-vision.md
+++ b/tutorials/anthropic-code-tutorial/04-vision.md
@@ -881,7 +881,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Tool Use](03-tool-use.md)
 - [Next Chapter: Chapter 5: Streaming](05-streaming.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/anthropic-code-tutorial/05-streaming.md b/tutorials/anthropic-code-tutorial/05-streaming.md
index 1a2a94ae..696051ee 100644
--- a/tutorials/anthropic-code-tutorial/05-streaming.md
+++ b/tutorials/anthropic-code-tutorial/05-streaming.md
@@ -888,7 +888,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Vision](04-vision.md)
 - [Next Chapter: Chapter 6: Advanced Patterns](06-advanced-patterns.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/anthropic-code-tutorial/06-advanced-patterns.md b/tutorials/anthropic-code-tutorial/06-advanced-patterns.md
index 23c9a213..6db01746 100644
--- a/tutorials/anthropic-code-tutorial/06-advanced-patterns.md
+++ b/tutorials/anthropic-code-tutorial/06-advanced-patterns.md
@@ -896,7 +896,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Streaming](05-streaming.md)
 - [Next Chapter: Chapter 7: Production Best Practices](07-production.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/anthropic-code-tutorial/07-production.md b/tutorials/anthropic-code-tutorial/07-production.md
index e4b2cf95..d50c0727 100644
--- a/tutorials/anthropic-code-tutorial/07-production.md
+++ b/tutorials/anthropic-code-tutorial/07-production.md
@@ -1022,7 +1022,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Advanced Patterns](06-advanced-patterns.md)
 - [Next Chapter: Chapter 8: Enterprise Integration](08-enterprise.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/anthropic-code-tutorial/08-enterprise.md b/tutorials/anthropic-code-tutorial/08-enterprise.md
index b63224bb..6ef8c95e 100644
--- a/tutorials/anthropic-code-tutorial/08-enterprise.md
+++ b/tutorials/anthropic-code-tutorial/08-enterprise.md
@@ -947,7 +947,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Production Best Practices](07-production.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/anthropic-code-tutorial/index.md b/tutorials/anthropic-code-tutorial/README.md
similarity index 100%
rename from tutorials/anthropic-code-tutorial/index.md
rename to tutorials/anthropic-code-tutorial/README.md
diff --git a/tutorials/anthropic-skills-tutorial/01-getting-started.md b/tutorials/anthropic-skills-tutorial/01-getting-started.md
index 98ef442a..de8e6ab6 100644
--- a/tutorials/anthropic-skills-tutorial/01-getting-started.md
+++ b/tutorials/anthropic-skills-tutorial/01-getting-started.md
@@ -138,7 +138,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Skill Categories](02-skill-categories.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/anthropic-skills-tutorial/02-skill-categories.md b/tutorials/anthropic-skills-tutorial/02-skill-categories.md
index 51c039a3..880d67a2 100644
--- a/tutorials/anthropic-skills-tutorial/02-skill-categories.md
+++ b/tutorials/anthropic-skills-tutorial/02-skill-categories.md
@@ -104,7 +104,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started](01-getting-started.md)
 - [Next Chapter: Chapter 3: Advanced Skill Design](03-advanced-skill-design.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/anthropic-skills-tutorial/03-advanced-skill-design.md b/tutorials/anthropic-skills-tutorial/03-advanced-skill-design.md
index 68593420..559bbe84 100644
--- a/tutorials/anthropic-skills-tutorial/03-advanced-skill-design.md
+++ b/tutorials/anthropic-skills-tutorial/03-advanced-skill-design.md
@@ -129,7 +129,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Skill Categories](02-skill-categories.md)
 - [Next Chapter: Chapter 4: Integration Platforms](04-integration-platforms.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/anthropic-skills-tutorial/04-integration-platforms.md b/tutorials/anthropic-skills-tutorial/04-integration-platforms.md
index a51ee0b1..0501fe72 100644
--- a/tutorials/anthropic-skills-tutorial/04-integration-platforms.md
+++ b/tutorials/anthropic-skills-tutorial/04-integration-platforms.md
@@ -119,7 +119,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Advanced Skill Design](03-advanced-skill-design.md)
 - [Next Chapter: Chapter 5: Production Skills](05-production-skills.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/anthropic-skills-tutorial/05-production-skills.md b/tutorials/anthropic-skills-tutorial/05-production-skills.md
index e6f13b3a..f8332402 100644
--- a/tutorials/anthropic-skills-tutorial/05-production-skills.md
+++ b/tutorials/anthropic-skills-tutorial/05-production-skills.md
@@ -119,7 +119,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Integration Platforms](04-integration-platforms.md)
 - [Next Chapter: Chapter 6: Best Practices](06-best-practices.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/anthropic-skills-tutorial/06-best-practices.md b/tutorials/anthropic-skills-tutorial/06-best-practices.md
index dcbde1b4..93958b45 100644
--- a/tutorials/anthropic-skills-tutorial/06-best-practices.md
+++ b/tutorials/anthropic-skills-tutorial/06-best-practices.md
@@ -104,7 +104,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Production Skills](05-production-skills.md)
 - [Next Chapter: Chapter 7: Publishing and Sharing](07-publishing-sharing.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/anthropic-skills-tutorial/07-publishing-sharing.md b/tutorials/anthropic-skills-tutorial/07-publishing-sharing.md
index 8943b236..abcdb564 100644
--- a/tutorials/anthropic-skills-tutorial/07-publishing-sharing.md
+++ b/tutorials/anthropic-skills-tutorial/07-publishing-sharing.md
@@ -104,7 +104,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Best Practices](06-best-practices.md)
 - [Next Chapter: Chapter 8: Real-World Examples](08-real-world-examples.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/anthropic-skills-tutorial/08-real-world-examples.md b/tutorials/anthropic-skills-tutorial/08-real-world-examples.md
index 072b419d..ac2abeff 100644
--- a/tutorials/anthropic-skills-tutorial/08-real-world-examples.md
+++ b/tutorials/anthropic-skills-tutorial/08-real-world-examples.md
@@ -131,7 +131,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Publishing and Sharing](07-publishing-sharing.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/anthropic-skills-tutorial/index.md b/tutorials/anthropic-skills-tutorial/README.md
similarity index 100%
rename from tutorials/anthropic-skills-tutorial/index.md
rename to tutorials/anthropic-skills-tutorial/README.md
diff --git a/tutorials/anything-llm-tutorial/01-getting-started.md b/tutorials/anything-llm-tutorial/01-getting-started.md
index a1815b27..808ab484 100644
--- a/tutorials/anything-llm-tutorial/01-getting-started.md
+++ b/tutorials/anything-llm-tutorial/01-getting-started.md
@@ -638,7 +638,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Workspaces - Organizing Your Knowledge](02-workspaces.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/anything-llm-tutorial/02-workspaces.md b/tutorials/anything-llm-tutorial/02-workspaces.md
index dd88deff..e411213a 100644
--- a/tutorials/anything-llm-tutorial/02-workspaces.md
+++ b/tutorials/anything-llm-tutorial/02-workspaces.md
@@ -643,7 +643,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started with AnythingLLM](01-getting-started.md)
 - [Next Chapter: Chapter 3: Document Upload and Processing](03-documents.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/anything-llm-tutorial/03-documents.md b/tutorials/anything-llm-tutorial/03-documents.md
index 7c00e7f2..adc943b9 100644
--- a/tutorials/anything-llm-tutorial/03-documents.md
+++ b/tutorials/anything-llm-tutorial/03-documents.md
@@ -695,7 +695,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Workspaces - Organizing Your Knowledge](02-workspaces.md)
 - [Next Chapter: Chapter 4: LLM Configuration - Connecting Language Models](04-llm-config.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/anything-llm-tutorial/04-llm-config.md b/tutorials/anything-llm-tutorial/04-llm-config.md
index 48fed701..d9c20d5d 100644
--- a/tutorials/anything-llm-tutorial/04-llm-config.md
+++ b/tutorials/anything-llm-tutorial/04-llm-config.md
@@ -644,7 +644,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Document Upload and Processing](03-documents.md)
 - [Next Chapter: Chapter 5: Vector Stores - Choosing and Configuring Storage Backends](05-vector-stores.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/anything-llm-tutorial/05-vector-stores.md b/tutorials/anything-llm-tutorial/05-vector-stores.md
index 40ef78cd..c27e488b 100644
--- a/tutorials/anything-llm-tutorial/05-vector-stores.md
+++ b/tutorials/anything-llm-tutorial/05-vector-stores.md
@@ -716,7 +716,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: LLM Configuration - Connecting Language Models](04-llm-config.md)
 - [Next Chapter: Chapter 6: Agents - Intelligent Capabilities and Automation](06-agents.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/anything-llm-tutorial/06-agents.md b/tutorials/anything-llm-tutorial/06-agents.md
index 030b88f5..2d0d2cce 100644
--- a/tutorials/anything-llm-tutorial/06-agents.md
+++ b/tutorials/anything-llm-tutorial/06-agents.md
@@ -779,7 +779,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Vector Stores - Choosing and Configuring Storage Backends](05-vector-stores.md)
 - [Next Chapter: Chapter 7: API & Integration - Programmatic Access and System Integration](07-api.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/anything-llm-tutorial/07-api.md b/tutorials/anything-llm-tutorial/07-api.md
index c126a8a4..d06e03ac 100644
--- a/tutorials/anything-llm-tutorial/07-api.md
+++ b/tutorials/anything-llm-tutorial/07-api.md
@@ -831,7 +831,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Agents - Intelligent Capabilities and Automation](06-agents.md)
 - [Next Chapter: Chapter 8: Production Deployment - Docker, Security, and Scaling](08-production.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/anything-llm-tutorial/08-production.md b/tutorials/anything-llm-tutorial/08-production.md
index a5e10d3f..e5878947 100644
--- a/tutorials/anything-llm-tutorial/08-production.md
+++ b/tutorials/anything-llm-tutorial/08-production.md
@@ -991,7 +991,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: API & Integration - Programmatic Access and System Integration](07-api.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/anything-llm-tutorial/index.md b/tutorials/anything-llm-tutorial/README.md
similarity index 100%
rename from tutorials/anything-llm-tutorial/index.md
rename to tutorials/anything-llm-tutorial/README.md
diff --git a/tutorials/athens-research-knowledge-graph/01-system-overview.md b/tutorials/athens-research-knowledge-graph/01-system-overview.md
index 5ba10692..2aeb3d0c 100644
--- a/tutorials/athens-research-knowledge-graph/01-system-overview.md
+++ b/tutorials/athens-research-knowledge-graph/01-system-overview.md
@@ -489,7 +489,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Datascript Deep Dive](02-datascript-database.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/athens-research-knowledge-graph/02-datascript-database.md b/tutorials/athens-research-knowledge-graph/02-datascript-database.md
index 52f3e3ac..cf439046 100644
--- a/tutorials/athens-research-knowledge-graph/02-datascript-database.md
+++ b/tutorials/athens-research-knowledge-graph/02-datascript-database.md
@@ -603,7 +603,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: System Overview](01-system-overview.md)
 - [Next Chapter: Chapter 3: Schema Design](03-schema-design.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/athens-research-knowledge-graph/03-schema-design.md b/tutorials/athens-research-knowledge-graph/03-schema-design.md
index 9b6c661c..cfff355b 100644
--- a/tutorials/athens-research-knowledge-graph/03-schema-design.md
+++ b/tutorials/athens-research-knowledge-graph/03-schema-design.md
@@ -643,7 +643,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Datascript Deep Dive](02-datascript-database.md)
 - [Next Chapter: Chapter 4: Application Architecture](04-app-architecture.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/athens-research-knowledge-graph/04-app-architecture.md b/tutorials/athens-research-knowledge-graph/04-app-architecture.md
index 4676dc58..5ee1b889 100644
--- a/tutorials/athens-research-knowledge-graph/04-app-architecture.md
+++ b/tutorials/athens-research-knowledge-graph/04-app-architecture.md
@@ -96,7 +96,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Schema Design](03-schema-design.md)
 - [Next Chapter: Chapter 5: Component System](05-component-system.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/athens-research-knowledge-graph/05-component-system.md b/tutorials/athens-research-knowledge-graph/05-component-system.md
index 22ddf576..91def0fd 100644
--- a/tutorials/athens-research-knowledge-graph/05-component-system.md
+++ b/tutorials/athens-research-knowledge-graph/05-component-system.md
@@ -89,7 +89,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Application Architecture](04-app-architecture.md)
 - [Next Chapter: Chapter 6: Event Handling](06-event-handling.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/athens-research-knowledge-graph/06-event-handling.md b/tutorials/athens-research-knowledge-graph/06-event-handling.md
index 692b3c89..dfe338db 100644
--- a/tutorials/athens-research-knowledge-graph/06-event-handling.md
+++ b/tutorials/athens-research-knowledge-graph/06-event-handling.md
@@ -81,7 +81,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Component System](05-component-system.md)
 - [Next Chapter: Chapter 7: Block Editor](07-block-editor.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/athens-research-knowledge-graph/07-block-editor.md b/tutorials/athens-research-knowledge-graph/07-block-editor.md
index 251c3f41..9dbbbe64 100644
--- a/tutorials/athens-research-knowledge-graph/07-block-editor.md
+++ b/tutorials/athens-research-knowledge-graph/07-block-editor.md
@@ -86,7 +86,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Event Handling](06-event-handling.md)
 - [Next Chapter: Chapter 8: Rich Text](08-rich-text.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/athens-research-knowledge-graph/08-rich-text.md b/tutorials/athens-research-knowledge-graph/08-rich-text.md
index 0be9f446..56d00a54 100644
--- a/tutorials/athens-research-knowledge-graph/08-rich-text.md
+++ b/tutorials/athens-research-knowledge-graph/08-rich-text.md
@@ -37,7 +37,7 @@ This chapter covers rich-text parsing and rendering tradeoffs in a block-based g
 You now have complete Athens core coverage from architecture through editor and rich text internals.
 
 Related:
-- [Athens Index](index.md)
+- [Athens Index](README.md)
 - [Setup Guide](docs/setup.md)
 
 ## What Problem Does This Solve?
@@ -80,7 +80,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Block Editor](07-block-editor.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/athens-research-knowledge-graph/README.md b/tutorials/athens-research-knowledge-graph/README.md
index c4525dec..22970940 100644
--- a/tutorials/athens-research-knowledge-graph/README.md
+++ b/tutorials/athens-research-knowledge-graph/README.md
@@ -1,40 +1,132 @@
-# Athens Research Knowledge Graph Deep Dive
+---
+layout: default
+title: "Athens Research Knowledge Graph"
+nav_order: 39
+has_children: true
+format_version: v2
+---
+
+# Athens Research: Deep Dive Tutorial
+
+> **Project**: [Athens Research](https://github.com/athensresearch/athens) — An open-source, Roam-like knowledge management system built with ClojureScript and graph databases.
+
+[![Stars](https://img.shields.io/github/stars/athensresearch/athens?style=social)](https://github.com/athensresearch/athens)
+[![License: EPL 1.0](https://img.shields.io/badge/License-EPL_1.0-blue.svg)](https://www.eclipse.org/legal/epl-v10.html)
+[![ClojureScript](https://img.shields.io/badge/ClojureScript-Reagent-purple)](https://github.com/athensresearch/athens)
+
+## Why This Track Matters
+
+Athens Research demonstrates how a graph-first, local-first knowledge system can be built with ClojureScript and Datascript, offering a fully self-hosted alternative to cloud knowledge tools.
+
+This track focuses on:
+- understanding block-based editing with bi-directional link management
+- working with Datascript in-memory graph databases for knowledge relationships
+- building ClojureScript frontends with Re-frame state management
+- operating a local-first system with optional real-time collaboration
+
+## What Is Athens Research?
+
+Athens is an open-source knowledge management system inspired by Roam Research. It uses Datascript (an in-memory graph database) with ClojureScript to provide block-based editing, bi-directional linking, and knowledge graph visualization — all running locally for full data ownership.
+
+| Feature | Description |
+|---------|-------------|
+| **Block-Based Editor** | Flexible, composable content editing with outliner UX |
+| **Bi-Directional Links** | Automatic backlinks between pages and blocks |
+| **Graph Database** | Datascript in-memory graph for knowledge relationships |
+| **Knowledge Graph** | Interactive visualization of connections between notes |
+| **Local-First** | All data stored locally, no cloud dependency |
+| **Real-Time Collab** | Multi-user editing with conflict resolution |
+
+## Mental Model
 
-A focused architecture walkthrough of Athens Research and its graph-based knowledge model.
+```mermaid
+graph TB
+    subgraph Frontend["ClojureScript Frontend"]
+        EDITOR[Block Editor]
+        GRAPH[Graph Visualization]
+        SEARCH[Search Interface]
+    end
 
-## Current Status
+    subgraph State["State Management"]
+        REFRAME[Re-frame Events]
+        SUBS[Subscriptions]
+    end
 
-Core chapter set is now published.
+    subgraph Data["Data Layer"]
+        DS[(Datascript DB)]
+        FS[File System]
+        SYNC[Sync Engine]
+    end
 
-| Item | Status |
-|:-----|:-------|
-| Published chapter docs | 8 + setup guide |
-| Canonical entry point | [index.md](index.md) |
+    Frontend --> State
+    State --> Data
+```
 
-## Published Chapters
+## Chapter Guide
 
-| Chapter | File | Focus |
-|:--------|:-----|:------|
-| 1 | [01-system-overview.md](01-system-overview.md) | System overview and architecture |
-| 2 | [02-datascript-database.md](02-datascript-database.md) | Datascript data model and query basics |
-| 3 | [03-schema-design.md](03-schema-design.md) | Schema patterns for blocks and relationships |
-| 4 | [04-app-architecture.md](04-app-architecture.md) | Re-frame app architecture and event flow |
-| 5 | [05-component-system.md](05-component-system.md) | Reagent component system and rendering strategy |
-| 6 | [06-event-handling.md](06-event-handling.md) | Editing, navigation, and sync event handling |
-| 7 | [07-block-editor.md](07-block-editor.md) | Block editor command and hierarchy model |
-| 8 | [08-rich-text.md](08-rich-text.md) | Rich text tokenization and rendering pipeline |
-| Setup | [docs/setup.md](docs/setup.md) | Environment setup for code exploration |
+| Chapter | Topic | What You'll Learn |
+|---------|-------|-------------------|
+| [1. System Overview](01-system-overview.md) | Architecture | Athens's approach to knowledge management |
+| [2. Datascript Database](02-datascript-database.md) | Data Layer | In-memory graph database, queries, transactions |
+| [3. Schema Design](03-schema-design.md) | Data Model | Blocks, pages, and relationship modeling |
+| [4. Application Architecture](04-app-architecture.md) | App Flow | Re-frame event flow and state boundaries |
+| [5. Component System](05-component-system.md) | UI Layer | Reagent composition and recursive block rendering |
+| [6. Event Handling](06-event-handling.md) | State Changes | Editing, navigation, and sync event orchestration |
+| [7. Block Editor](07-block-editor.md) | Editor Core | Outliner commands, hierarchy edits, and UX behavior |
+| [8. Rich Text](08-rich-text.md) | Rendering | Rich-text tokenization, AST rendering, and safeguards |
 
-## Suggested Reading Order
+## Tech Stack
 
-1. Start with [index.md](index.md).
-2. Read chapters [1](01-system-overview.md) through [8](08-rich-text.md) in order.
-3. Use [docs/setup.md](docs/setup.md) for local exploration.
+| Component | Technology |
+|-----------|-----------|
+| **Language** | ClojureScript |
+| **UI Framework** | Reagent (React wrapper) |
+| **State** | Re-frame |
+| **Database** | Datascript (in-memory graph) |
+| **Desktop** | Electron |
 
-## Upstream Project
+---
 
-- Athens Research repository: <https://github.com/athensresearch/athens>
+Ready to begin? Start with [Chapter 1: System Overview](01-system-overview.md).
 
 ---
 
-Part of [Awesome Code Docs](../../README.md)
+*Built with insights from the [Athens Research repository](https://github.com/athensresearch/athens) and community documentation.*
+
+## Navigation & Backlinks
+
+- [Start Here: Chapter 1: System Overview](01-system-overview.md)
+- [Back to Main Catalog](../../README.md#-tutorial-catalog)
+- [Browse A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
+- [Search by Intent](../../discoverability/query-hub.md)
+- [Explore Category Hubs](../../README.md#category-hubs)
+
+## Full Chapter Map
+
+1. [Chapter 1: System Overview](01-system-overview.md)
+2. [Chapter 2: Datascript Deep Dive](02-datascript-database.md)
+3. [Chapter 3: Schema Design](03-schema-design.md)
+4. [Chapter 4: Application Architecture](04-app-architecture.md)
+5. [Chapter 5: Component System](05-component-system.md)
+6. [Chapter 6: Event Handling](06-event-handling.md)
+7. [Chapter 7: Block Editor](07-block-editor.md)
+8. [Chapter 8: Rich Text](08-rich-text.md)
+
+## Current Snapshot (auto-updated)
+
+- repository: [athensresearch/athens](https://github.com/athensresearch/athens)
+- stars: about **9.5K**
+- project positioning: open-source Roam Research alternative with graph database architecture
+
+## What You Will Learn
+
+- how Athens uses Datascript as an in-memory graph database for knowledge storage
+- how bi-directional links and backlinks are managed across pages and blocks
+- how Re-frame events and subscriptions drive the ClojureScript application state
+- how the block editor handles recursive rendering and outliner-style editing
+
+## Source References
+
+- [Athens Research](https://github.com/athensresearch/athens)
+
+*Generated by [AI Codebase Knowledge Builder](https://github.com/The-Pocket/Tutorial-Codebase-Knowledge)*
diff --git a/tutorials/athens-research-knowledge-graph/index.md b/tutorials/athens-research-knowledge-graph/index.md
deleted file mode 100644
index 22970940..00000000
--- a/tutorials/athens-research-knowledge-graph/index.md
+++ /dev/null
@@ -1,132 +0,0 @@
----
-layout: default
-title: "Athens Research Knowledge Graph"
-nav_order: 39
-has_children: true
-format_version: v2
----
-
-# Athens Research: Deep Dive Tutorial
-
-> **Project**: [Athens Research](https://github.com/athensresearch/athens) — An open-source, Roam-like knowledge management system built with ClojureScript and graph databases.
-
-[![Stars](https://img.shields.io/github/stars/athensresearch/athens?style=social)](https://github.com/athensresearch/athens)
-[![License: EPL 1.0](https://img.shields.io/badge/License-EPL_1.0-blue.svg)](https://www.eclipse.org/legal/epl-v10.html)
-[![ClojureScript](https://img.shields.io/badge/ClojureScript-Reagent-purple)](https://github.com/athensresearch/athens)
-
-## Why This Track Matters
-
-Athens Research demonstrates how a graph-first, local-first knowledge system can be built with ClojureScript and Datascript, offering a fully self-hosted alternative to cloud knowledge tools.
-
-This track focuses on:
-- understanding block-based editing with bi-directional link management
-- working with Datascript in-memory graph databases for knowledge relationships
-- building ClojureScript frontends with Re-frame state management
-- operating a local-first system with optional real-time collaboration
-
-## What Is Athens Research?
-
-Athens is an open-source knowledge management system inspired by Roam Research. It uses Datascript (an in-memory graph database) with ClojureScript to provide block-based editing, bi-directional linking, and knowledge graph visualization — all running locally for full data ownership.
-
-| Feature | Description |
-|---------|-------------|
-| **Block-Based Editor** | Flexible, composable content editing with outliner UX |
-| **Bi-Directional Links** | Automatic backlinks between pages and blocks |
-| **Graph Database** | Datascript in-memory graph for knowledge relationships |
-| **Knowledge Graph** | Interactive visualization of connections between notes |
-| **Local-First** | All data stored locally, no cloud dependency |
-| **Real-Time Collab** | Multi-user editing with conflict resolution |
-
-## Mental Model
-
-```mermaid
-graph TB
-    subgraph Frontend["ClojureScript Frontend"]
-        EDITOR[Block Editor]
-        GRAPH[Graph Visualization]
-        SEARCH[Search Interface]
-    end
-
-    subgraph State["State Management"]
-        REFRAME[Re-frame Events]
-        SUBS[Subscriptions]
-    end
-
-    subgraph Data["Data Layer"]
-        DS[(Datascript DB)]
-        FS[File System]
-        SYNC[Sync Engine]
-    end
-
-    Frontend --> State
-    State --> Data
-```
-
-## Chapter Guide
-
-| Chapter | Topic | What You'll Learn |
-|---------|-------|-------------------|
-| [1. System Overview](01-system-overview.md) | Architecture | Athens's approach to knowledge management |
-| [2. Datascript Database](02-datascript-database.md) | Data Layer | In-memory graph database, queries, transactions |
-| [3. Schema Design](03-schema-design.md) | Data Model | Blocks, pages, and relationship modeling |
-| [4. Application Architecture](04-app-architecture.md) | App Flow | Re-frame event flow and state boundaries |
-| [5. Component System](05-component-system.md) | UI Layer | Reagent composition and recursive block rendering |
-| [6. Event Handling](06-event-handling.md) | State Changes | Editing, navigation, and sync event orchestration |
-| [7. Block Editor](07-block-editor.md) | Editor Core | Outliner commands, hierarchy edits, and UX behavior |
-| [8. Rich Text](08-rich-text.md) | Rendering | Rich-text tokenization, AST rendering, and safeguards |
-
-## Tech Stack
-
-| Component | Technology |
-|-----------|-----------|
-| **Language** | ClojureScript |
-| **UI Framework** | Reagent (React wrapper) |
-| **State** | Re-frame |
-| **Database** | Datascript (in-memory graph) |
-| **Desktop** | Electron |
-
----
-
-Ready to begin? Start with [Chapter 1: System Overview](01-system-overview.md).
-
----
-
-*Built with insights from the [Athens Research repository](https://github.com/athensresearch/athens) and community documentation.*
-
-## Navigation & Backlinks
-
-- [Start Here: Chapter 1: System Overview](01-system-overview.md)
-- [Back to Main Catalog](../../README.md#-tutorial-catalog)
-- [Browse A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
-- [Search by Intent](../../discoverability/query-hub.md)
-- [Explore Category Hubs](../../README.md#category-hubs)
-
-## Full Chapter Map
-
-1. [Chapter 1: System Overview](01-system-overview.md)
-2. [Chapter 2: Datascript Deep Dive](02-datascript-database.md)
-3. [Chapter 3: Schema Design](03-schema-design.md)
-4. [Chapter 4: Application Architecture](04-app-architecture.md)
-5. [Chapter 5: Component System](05-component-system.md)
-6. [Chapter 6: Event Handling](06-event-handling.md)
-7. [Chapter 7: Block Editor](07-block-editor.md)
-8. [Chapter 8: Rich Text](08-rich-text.md)
-
-## Current Snapshot (auto-updated)
-
-- repository: [athensresearch/athens](https://github.com/athensresearch/athens)
-- stars: about **9.5K**
-- project positioning: open-source Roam Research alternative with graph database architecture
-
-## What You Will Learn
-
-- how Athens uses Datascript as an in-memory graph database for knowledge storage
-- how bi-directional links and backlinks are managed across pages and blocks
-- how Re-frame events and subscriptions drive the ClojureScript application state
-- how the block editor handles recursive rendering and outliner-style editing
-
-## Source References
-
-- [Athens Research](https://github.com/athensresearch/athens)
-
-*Generated by [AI Codebase Knowledge Builder](https://github.com/The-Pocket/Tutorial-Codebase-Knowledge)*
diff --git a/tutorials/autoagent-tutorial/01-getting-started.md b/tutorials/autoagent-tutorial/01-getting-started.md
index 01d5516b..c2d457e5 100644
--- a/tutorials/autoagent-tutorial/01-getting-started.md
+++ b/tutorials/autoagent-tutorial/01-getting-started.md
@@ -632,7 +632,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Architecture and Interaction Modes](02-architecture-and-interaction-modes.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/autoagent-tutorial/02-architecture-and-interaction-modes.md b/tutorials/autoagent-tutorial/02-architecture-and-interaction-modes.md
index 0cdbfbf9..becf43a2 100644
--- a/tutorials/autoagent-tutorial/02-architecture-and-interaction-modes.md
+++ b/tutorials/autoagent-tutorial/02-architecture-and-interaction-modes.md
@@ -637,7 +637,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started](01-getting-started.md)
 - [Next Chapter: Chapter 3: Installation, Environment, and API Setup](03-installation-environment-and-api-setup.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/autoagent-tutorial/03-installation-environment-and-api-setup.md b/tutorials/autoagent-tutorial/03-installation-environment-and-api-setup.md
index d779b20f..3024711a 100644
--- a/tutorials/autoagent-tutorial/03-installation-environment-and-api-setup.md
+++ b/tutorials/autoagent-tutorial/03-installation-environment-and-api-setup.md
@@ -637,7 +637,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Architecture and Interaction Modes](02-architecture-and-interaction-modes.md)
 - [Next Chapter: Chapter 4: Agent and Workflow Creation Patterns](04-agent-and-workflow-creation-patterns.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/autoagent-tutorial/04-agent-and-workflow-creation-patterns.md b/tutorials/autoagent-tutorial/04-agent-and-workflow-creation-patterns.md
index f36ade3d..b2068706 100644
--- a/tutorials/autoagent-tutorial/04-agent-and-workflow-creation-patterns.md
+++ b/tutorials/autoagent-tutorial/04-agent-and-workflow-creation-patterns.md
@@ -637,7 +637,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Installation, Environment, and API Setup](03-installation-environment-and-api-setup.md)
 - [Next Chapter: Chapter 5: Tooling, Python API, and Custom Extensions](05-tooling-python-api-and-custom-extensions.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/autoagent-tutorial/05-tooling-python-api-and-custom-extensions.md b/tutorials/autoagent-tutorial/05-tooling-python-api-and-custom-extensions.md
index 4054b9c8..87f759bb 100644
--- a/tutorials/autoagent-tutorial/05-tooling-python-api-and-custom-extensions.md
+++ b/tutorials/autoagent-tutorial/05-tooling-python-api-and-custom-extensions.md
@@ -626,7 +626,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Agent and Workflow Creation Patterns](04-agent-and-workflow-creation-patterns.md)
 - [Next Chapter: Chapter 6: CLI Operations and Provider Strategy](06-cli-operations-and-provider-strategy.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/autoagent-tutorial/06-cli-operations-and-provider-strategy.md b/tutorials/autoagent-tutorial/06-cli-operations-and-provider-strategy.md
index 62df793f..1e98c6f1 100644
--- a/tutorials/autoagent-tutorial/06-cli-operations-and-provider-strategy.md
+++ b/tutorials/autoagent-tutorial/06-cli-operations-and-provider-strategy.md
@@ -637,7 +637,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Tooling, Python API, and Custom Extensions](05-tooling-python-api-and-custom-extensions.md)
 - [Next Chapter: Chapter 7: Benchmarking, Evaluation, and Quality Gates](07-benchmarking-evaluation-and-quality-gates.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/autoagent-tutorial/07-benchmarking-evaluation-and-quality-gates.md b/tutorials/autoagent-tutorial/07-benchmarking-evaluation-and-quality-gates.md
index 7597835e..606244fe 100644
--- a/tutorials/autoagent-tutorial/07-benchmarking-evaluation-and-quality-gates.md
+++ b/tutorials/autoagent-tutorial/07-benchmarking-evaluation-and-quality-gates.md
@@ -626,7 +626,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: CLI Operations and Provider Strategy](06-cli-operations-and-provider-strategy.md)
 - [Next Chapter: Chapter 8: Contribution Workflow and Production Governance](08-contribution-workflow-and-production-governance.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/autoagent-tutorial/08-contribution-workflow-and-production-governance.md b/tutorials/autoagent-tutorial/08-contribution-workflow-and-production-governance.md
index 16aceaf7..d57237b4 100644
--- a/tutorials/autoagent-tutorial/08-contribution-workflow-and-production-governance.md
+++ b/tutorials/autoagent-tutorial/08-contribution-workflow-and-production-governance.md
@@ -626,7 +626,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Benchmarking, Evaluation, and Quality Gates](07-benchmarking-evaluation-and-quality-gates.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/autoagent-tutorial/index.md b/tutorials/autoagent-tutorial/README.md
similarity index 100%
rename from tutorials/autoagent-tutorial/index.md
rename to tutorials/autoagent-tutorial/README.md
diff --git a/tutorials/autogen-tutorial/01-getting-started.md b/tutorials/autogen-tutorial/01-getting-started.md
index 5ef82361..8dfe6453 100644
--- a/tutorials/autogen-tutorial/01-getting-started.md
+++ b/tutorials/autogen-tutorial/01-getting-started.md
@@ -582,7 +582,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Agent Architecture & Roles](02-agent-architecture.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/autogen-tutorial/02-agent-architecture.md b/tutorials/autogen-tutorial/02-agent-architecture.md
index 0b2254e5..93eadc67 100644
--- a/tutorials/autogen-tutorial/02-agent-architecture.md
+++ b/tutorials/autogen-tutorial/02-agent-architecture.md
@@ -673,7 +673,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started with Microsoft AutoGen](01-getting-started.md)
 - [Next Chapter: Chapter 3: Agent Communication](03-agent-communication.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/autogen-tutorial/03-agent-communication.md b/tutorials/autogen-tutorial/03-agent-communication.md
index 3b2edcc7..b811d09b 100644
--- a/tutorials/autogen-tutorial/03-agent-communication.md
+++ b/tutorials/autogen-tutorial/03-agent-communication.md
@@ -795,7 +795,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Agent Architecture & Roles](02-agent-architecture.md)
 - [Next Chapter: Chapter 4: Tool Integration](04-tool-integration.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/autogen-tutorial/04-tool-integration.md b/tutorials/autogen-tutorial/04-tool-integration.md
index 981835a2..5810775a 100644
--- a/tutorials/autogen-tutorial/04-tool-integration.md
+++ b/tutorials/autogen-tutorial/04-tool-integration.md
@@ -997,7 +997,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Agent Communication](03-agent-communication.md)
 - [Next Chapter: Chapter 5: Task Decomposition](05-task-decomposition.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/autogen-tutorial/05-task-decomposition.md b/tutorials/autogen-tutorial/05-task-decomposition.md
index 557bf624..1baecc33 100644
--- a/tutorials/autogen-tutorial/05-task-decomposition.md
+++ b/tutorials/autogen-tutorial/05-task-decomposition.md
@@ -787,7 +787,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Tool Integration](04-tool-integration.md)
 - [Next Chapter: Chapter 6: Custom Agent Development](06-custom-agents.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/autogen-tutorial/06-custom-agents.md b/tutorials/autogen-tutorial/06-custom-agents.md
index c2623797..6d1f2f0f 100644
--- a/tutorials/autogen-tutorial/06-custom-agents.md
+++ b/tutorials/autogen-tutorial/06-custom-agents.md
@@ -791,7 +791,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Task Decomposition](05-task-decomposition.md)
 - [Next Chapter: Chapter 7: Multi-Agent Workflows](07-multi-agent-workflows.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/autogen-tutorial/07-multi-agent-workflows.md b/tutorials/autogen-tutorial/07-multi-agent-workflows.md
index 13bf283d..d11419e2 100644
--- a/tutorials/autogen-tutorial/07-multi-agent-workflows.md
+++ b/tutorials/autogen-tutorial/07-multi-agent-workflows.md
@@ -952,7 +952,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Custom Agent Development](06-custom-agents.md)
 - [Next Chapter: Chapter 8: Production Deployment](08-production-deployment.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/autogen-tutorial/08-production-deployment.md b/tutorials/autogen-tutorial/08-production-deployment.md
index bf549009..eff3472c 100644
--- a/tutorials/autogen-tutorial/08-production-deployment.md
+++ b/tutorials/autogen-tutorial/08-production-deployment.md
@@ -1119,7 +1119,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Multi-Agent Workflows](07-multi-agent-workflows.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/autogen-tutorial/index.md b/tutorials/autogen-tutorial/README.md
similarity index 100%
rename from tutorials/autogen-tutorial/index.md
rename to tutorials/autogen-tutorial/README.md
diff --git a/tutorials/awesome-claude-code-tutorial/01-getting-started.md b/tutorials/awesome-claude-code-tutorial/01-getting-started.md
index 9fb57319..18a14487 100644
--- a/tutorials/awesome-claude-code-tutorial/01-getting-started.md
+++ b/tutorials/awesome-claude-code-tutorial/01-getting-started.md
@@ -636,7 +636,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: List Taxonomy and Navigation](02-list-taxonomy-and-navigation.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/awesome-claude-code-tutorial/02-list-taxonomy-and-navigation.md b/tutorials/awesome-claude-code-tutorial/02-list-taxonomy-and-navigation.md
index a1765462..82159d04 100644
--- a/tutorials/awesome-claude-code-tutorial/02-list-taxonomy-and-navigation.md
+++ b/tutorials/awesome-claude-code-tutorial/02-list-taxonomy-and-navigation.md
@@ -628,7 +628,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started](01-getting-started.md)
 - [Next Chapter: Chapter 3: Resource Quality Evaluation Framework](03-resource-quality-evaluation-framework.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/awesome-claude-code-tutorial/03-resource-quality-evaluation-framework.md b/tutorials/awesome-claude-code-tutorial/03-resource-quality-evaluation-framework.md
index 1bf728a6..fad80d70 100644
--- a/tutorials/awesome-claude-code-tutorial/03-resource-quality-evaluation-framework.md
+++ b/tutorials/awesome-claude-code-tutorial/03-resource-quality-evaluation-framework.md
@@ -636,7 +636,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: List Taxonomy and Navigation](02-list-taxonomy-and-navigation.md)
 - [Next Chapter: Chapter 4: Skills, Hooks, and Slash Command Patterns](04-skills-hooks-and-slash-command-patterns.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/awesome-claude-code-tutorial/04-skills-hooks-and-slash-command-patterns.md b/tutorials/awesome-claude-code-tutorial/04-skills-hooks-and-slash-command-patterns.md
index b16ab0ca..ef6a29b2 100644
--- a/tutorials/awesome-claude-code-tutorial/04-skills-hooks-and-slash-command-patterns.md
+++ b/tutorials/awesome-claude-code-tutorial/04-skills-hooks-and-slash-command-patterns.md
@@ -635,7 +635,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Resource Quality Evaluation Framework](03-resource-quality-evaluation-framework.md)
 - [Next Chapter: Chapter 5: `CLAUDE.md` and Project Scaffolding Patterns](05-claude-md-and-project-scaffolding-patterns.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/awesome-claude-code-tutorial/05-claude-md-and-project-scaffolding-patterns.md b/tutorials/awesome-claude-code-tutorial/05-claude-md-and-project-scaffolding-patterns.md
index 2b46ad71..ff2c6c89 100644
--- a/tutorials/awesome-claude-code-tutorial/05-claude-md-and-project-scaffolding-patterns.md
+++ b/tutorials/awesome-claude-code-tutorial/05-claude-md-and-project-scaffolding-patterns.md
@@ -628,7 +628,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Skills, Hooks, and Slash Command Patterns](04-skills-hooks-and-slash-command-patterns.md)
 - [Next Chapter: Chapter 6: Automation Pipeline and README Generation](06-automation-pipeline-and-readme-generation.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/awesome-claude-code-tutorial/06-automation-pipeline-and-readme-generation.md b/tutorials/awesome-claude-code-tutorial/06-automation-pipeline-and-readme-generation.md
index 6dd5e890..ae88e205 100644
--- a/tutorials/awesome-claude-code-tutorial/06-automation-pipeline-and-readme-generation.md
+++ b/tutorials/awesome-claude-code-tutorial/06-automation-pipeline-and-readme-generation.md
@@ -630,7 +630,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: `CLAUDE.md` and Project Scaffolding Patterns](05-claude-md-and-project-scaffolding-patterns.md)
 - [Next Chapter: Chapter 7: Link Health, Validation, and Drift Control](07-link-health-validation-and-drift-control.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/awesome-claude-code-tutorial/07-link-health-validation-and-drift-control.md b/tutorials/awesome-claude-code-tutorial/07-link-health-validation-and-drift-control.md
index 05d18fd7..020e91ec 100644
--- a/tutorials/awesome-claude-code-tutorial/07-link-health-validation-and-drift-control.md
+++ b/tutorials/awesome-claude-code-tutorial/07-link-health-validation-and-drift-control.md
@@ -629,7 +629,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Automation Pipeline and README Generation](06-automation-pipeline-and-readme-generation.md)
 - [Next Chapter: Chapter 8: Contribution Workflow and Governance](08-contribution-workflow-and-governance.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/awesome-claude-code-tutorial/08-contribution-workflow-and-governance.md b/tutorials/awesome-claude-code-tutorial/08-contribution-workflow-and-governance.md
index ab861b01..59ad73d7 100644
--- a/tutorials/awesome-claude-code-tutorial/08-contribution-workflow-and-governance.md
+++ b/tutorials/awesome-claude-code-tutorial/08-contribution-workflow-and-governance.md
@@ -626,7 +626,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Link Health, Validation, and Drift Control](07-link-health-validation-and-drift-control.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/awesome-claude-code-tutorial/index.md b/tutorials/awesome-claude-code-tutorial/README.md
similarity index 100%
rename from tutorials/awesome-claude-code-tutorial/index.md
rename to tutorials/awesome-claude-code-tutorial/README.md
diff --git a/tutorials/awesome-claude-skills-tutorial/01-getting-started.md b/tutorials/awesome-claude-skills-tutorial/01-getting-started.md
index a63524cd..08e83e3d 100644
--- a/tutorials/awesome-claude-skills-tutorial/01-getting-started.md
+++ b/tutorials/awesome-claude-skills-tutorial/01-getting-started.md
@@ -626,7 +626,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Catalog Taxonomy and Navigation](02-catalog-taxonomy-and-navigation.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/awesome-claude-skills-tutorial/02-catalog-taxonomy-and-navigation.md b/tutorials/awesome-claude-skills-tutorial/02-catalog-taxonomy-and-navigation.md
index 252e3890..39c766f9 100644
--- a/tutorials/awesome-claude-skills-tutorial/02-catalog-taxonomy-and-navigation.md
+++ b/tutorials/awesome-claude-skills-tutorial/02-catalog-taxonomy-and-navigation.md
@@ -628,7 +628,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started](01-getting-started.md)
 - [Next Chapter: Chapter 3: Installation Paths: Claude.ai, Claude Code, API](03-installation-paths-claude-ai-claude-code-api.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/awesome-claude-skills-tutorial/03-installation-paths-claude-ai-claude-code-api.md b/tutorials/awesome-claude-skills-tutorial/03-installation-paths-claude-ai-claude-code-api.md
index fbfa4146..50d05bdf 100644
--- a/tutorials/awesome-claude-skills-tutorial/03-installation-paths-claude-ai-claude-code-api.md
+++ b/tutorials/awesome-claude-skills-tutorial/03-installation-paths-claude-ai-claude-code-api.md
@@ -627,7 +627,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Catalog Taxonomy and Navigation](02-catalog-taxonomy-and-navigation.md)
 - [Next Chapter: Chapter 4: Skill Authoring Template and Quality Standards](04-skill-authoring-template-and-quality-standards.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/awesome-claude-skills-tutorial/04-skill-authoring-template-and-quality-standards.md b/tutorials/awesome-claude-skills-tutorial/04-skill-authoring-template-and-quality-standards.md
index b312b291..8ad6a9d4 100644
--- a/tutorials/awesome-claude-skills-tutorial/04-skill-authoring-template-and-quality-standards.md
+++ b/tutorials/awesome-claude-skills-tutorial/04-skill-authoring-template-and-quality-standards.md
@@ -628,7 +628,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Installation Paths: Claude.ai, Claude Code, API](03-installation-paths-claude-ai-claude-code-api.md)
 - [Next Chapter: Chapter 5: App Automation via Composio Skill Packs](05-app-automation-via-composio-skill-packs.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/awesome-claude-skills-tutorial/05-app-automation-via-composio-skill-packs.md b/tutorials/awesome-claude-skills-tutorial/05-app-automation-via-composio-skill-packs.md
index 2d6c581e..9c6ce4f4 100644
--- a/tutorials/awesome-claude-skills-tutorial/05-app-automation-via-composio-skill-packs.md
+++ b/tutorials/awesome-claude-skills-tutorial/05-app-automation-via-composio-skill-packs.md
@@ -627,7 +627,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Skill Authoring Template and Quality Standards](04-skill-authoring-template-and-quality-standards.md)
 - [Next Chapter: Chapter 6: Contribution Workflow and Repository Governance](06-contribution-workflow-and-repository-governance.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/awesome-claude-skills-tutorial/06-contribution-workflow-and-repository-governance.md b/tutorials/awesome-claude-skills-tutorial/06-contribution-workflow-and-repository-governance.md
index 2c5ec659..ff597a12 100644
--- a/tutorials/awesome-claude-skills-tutorial/06-contribution-workflow-and-repository-governance.md
+++ b/tutorials/awesome-claude-skills-tutorial/06-contribution-workflow-and-repository-governance.md
@@ -626,7 +626,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: App Automation via Composio Skill Packs](05-app-automation-via-composio-skill-packs.md)
 - [Next Chapter: Chapter 7: Risk Management and Skill Selection Rubric](07-risk-management-and-skill-selection-rubric.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/awesome-claude-skills-tutorial/07-risk-management-and-skill-selection-rubric.md b/tutorials/awesome-claude-skills-tutorial/07-risk-management-and-skill-selection-rubric.md
index 55b73181..caf663ee 100644
--- a/tutorials/awesome-claude-skills-tutorial/07-risk-management-and-skill-selection-rubric.md
+++ b/tutorials/awesome-claude-skills-tutorial/07-risk-management-and-skill-selection-rubric.md
@@ -628,7 +628,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Contribution Workflow and Repository Governance](06-contribution-workflow-and-repository-governance.md)
 - [Next Chapter: Chapter 8: Team Adoption and Ongoing Maintenance](08-team-adoption-and-ongoing-maintenance.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/awesome-claude-skills-tutorial/08-team-adoption-and-ongoing-maintenance.md b/tutorials/awesome-claude-skills-tutorial/08-team-adoption-and-ongoing-maintenance.md
index f8e4db73..42ed7f42 100644
--- a/tutorials/awesome-claude-skills-tutorial/08-team-adoption-and-ongoing-maintenance.md
+++ b/tutorials/awesome-claude-skills-tutorial/08-team-adoption-and-ongoing-maintenance.md
@@ -630,7 +630,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Risk Management and Skill Selection Rubric](07-risk-management-and-skill-selection-rubric.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/awesome-claude-skills-tutorial/index.md b/tutorials/awesome-claude-skills-tutorial/README.md
similarity index 100%
rename from tutorials/awesome-claude-skills-tutorial/index.md
rename to tutorials/awesome-claude-skills-tutorial/README.md
diff --git a/tutorials/awesome-mcp-servers-tutorial/01-getting-started.md b/tutorials/awesome-mcp-servers-tutorial/01-getting-started.md
index 8baf76c5..74b04206 100644
--- a/tutorials/awesome-mcp-servers-tutorial/01-getting-started.md
+++ b/tutorials/awesome-mcp-servers-tutorial/01-getting-started.md
@@ -635,7 +635,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: List Taxonomy and Legend](02-list-taxonomy-and-legend.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/awesome-mcp-servers-tutorial/02-list-taxonomy-and-legend.md b/tutorials/awesome-mcp-servers-tutorial/02-list-taxonomy-and-legend.md
index 2213a270..8671789a 100644
--- a/tutorials/awesome-mcp-servers-tutorial/02-list-taxonomy-and-legend.md
+++ b/tutorials/awesome-mcp-servers-tutorial/02-list-taxonomy-and-legend.md
@@ -635,7 +635,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started](01-getting-started.md)
 - [Next Chapter: Chapter 3: Clients and Runtime Compatibility](03-clients-and-runtime-compatibility.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/awesome-mcp-servers-tutorial/03-clients-and-runtime-compatibility.md b/tutorials/awesome-mcp-servers-tutorial/03-clients-and-runtime-compatibility.md
index 50d8f6bd..a20a20d0 100644
--- a/tutorials/awesome-mcp-servers-tutorial/03-clients-and-runtime-compatibility.md
+++ b/tutorials/awesome-mcp-servers-tutorial/03-clients-and-runtime-compatibility.md
@@ -635,7 +635,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: List Taxonomy and Legend](02-list-taxonomy-and-legend.md)
 - [Next Chapter: Chapter 4: Server Selection and Quality Rubric](04-server-selection-and-quality-rubric.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/awesome-mcp-servers-tutorial/04-server-selection-and-quality-rubric.md b/tutorials/awesome-mcp-servers-tutorial/04-server-selection-and-quality-rubric.md
index 07cd6086..9db3cdc5 100644
--- a/tutorials/awesome-mcp-servers-tutorial/04-server-selection-and-quality-rubric.md
+++ b/tutorials/awesome-mcp-servers-tutorial/04-server-selection-and-quality-rubric.md
@@ -635,7 +635,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Clients and Runtime Compatibility](03-clients-and-runtime-compatibility.md)
 - [Next Chapter: Chapter 5: Installation and Configuration Patterns](05-installation-and-configuration-patterns.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/awesome-mcp-servers-tutorial/05-installation-and-configuration-patterns.md b/tutorials/awesome-mcp-servers-tutorial/05-installation-and-configuration-patterns.md
index f7db7759..70e749fa 100644
--- a/tutorials/awesome-mcp-servers-tutorial/05-installation-and-configuration-patterns.md
+++ b/tutorials/awesome-mcp-servers-tutorial/05-installation-and-configuration-patterns.md
@@ -635,7 +635,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Server Selection and Quality Rubric](04-server-selection-and-quality-rubric.md)
 - [Next Chapter: Chapter 6: Contribution Workflow and List Hygiene](06-contribution-workflow-and-list-hygiene.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/awesome-mcp-servers-tutorial/06-contribution-workflow-and-list-hygiene.md b/tutorials/awesome-mcp-servers-tutorial/06-contribution-workflow-and-list-hygiene.md
index 79a76dea..954e188d 100644
--- a/tutorials/awesome-mcp-servers-tutorial/06-contribution-workflow-and-list-hygiene.md
+++ b/tutorials/awesome-mcp-servers-tutorial/06-contribution-workflow-and-list-hygiene.md
@@ -634,7 +634,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Installation and Configuration Patterns](05-installation-and-configuration-patterns.md)
 - [Next Chapter: Chapter 7: Operations, Security, and Risk Controls](07-operations-security-and-risk-controls.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/awesome-mcp-servers-tutorial/07-operations-security-and-risk-controls.md b/tutorials/awesome-mcp-servers-tutorial/07-operations-security-and-risk-controls.md
index c3b638ac..860f1b32 100644
--- a/tutorials/awesome-mcp-servers-tutorial/07-operations-security-and-risk-controls.md
+++ b/tutorials/awesome-mcp-servers-tutorial/07-operations-security-and-risk-controls.md
@@ -634,7 +634,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Contribution Workflow and List Hygiene](06-contribution-workflow-and-list-hygiene.md)
 - [Next Chapter: Chapter 8: Team Adoption and Maintenance](08-team-adoption-and-maintenance.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/awesome-mcp-servers-tutorial/08-team-adoption-and-maintenance.md b/tutorials/awesome-mcp-servers-tutorial/08-team-adoption-and-maintenance.md
index a5b86cfe..f29388d3 100644
--- a/tutorials/awesome-mcp-servers-tutorial/08-team-adoption-and-maintenance.md
+++ b/tutorials/awesome-mcp-servers-tutorial/08-team-adoption-and-maintenance.md
@@ -633,7 +633,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Operations, Security, and Risk Controls](07-operations-security-and-risk-controls.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/awesome-mcp-servers-tutorial/index.md b/tutorials/awesome-mcp-servers-tutorial/README.md
similarity index 100%
rename from tutorials/awesome-mcp-servers-tutorial/index.md
rename to tutorials/awesome-mcp-servers-tutorial/README.md
diff --git a/tutorials/awslabs-mcp-tutorial/01-getting-started.md b/tutorials/awslabs-mcp-tutorial/01-getting-started.md
index d573b9fb..4be3c300 100644
--- a/tutorials/awslabs-mcp-tutorial/01-getting-started.md
+++ b/tutorials/awslabs-mcp-tutorial/01-getting-started.md
@@ -637,7 +637,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Server Catalog and Role Composition](02-server-catalog-and-role-composition.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/awslabs-mcp-tutorial/02-server-catalog-and-role-composition.md b/tutorials/awslabs-mcp-tutorial/02-server-catalog-and-role-composition.md
index 9ff22dfc..23f937e9 100644
--- a/tutorials/awslabs-mcp-tutorial/02-server-catalog-and-role-composition.md
+++ b/tutorials/awslabs-mcp-tutorial/02-server-catalog-and-role-composition.md
@@ -633,7 +633,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started](01-getting-started.md)
 - [Next Chapter: Chapter 3: Transport and Client Integration Patterns](03-transport-and-client-integration-patterns.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/awslabs-mcp-tutorial/03-transport-and-client-integration-patterns.md b/tutorials/awslabs-mcp-tutorial/03-transport-and-client-integration-patterns.md
index c50d35ba..63e723c4 100644
--- a/tutorials/awslabs-mcp-tutorial/03-transport-and-client-integration-patterns.md
+++ b/tutorials/awslabs-mcp-tutorial/03-transport-and-client-integration-patterns.md
@@ -633,7 +633,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Server Catalog and Role Composition](02-server-catalog-and-role-composition.md)
 - [Next Chapter: Chapter 4: Infrastructure and IaC Workflows](04-infrastructure-and-iac-workflows.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/awslabs-mcp-tutorial/04-infrastructure-and-iac-workflows.md b/tutorials/awslabs-mcp-tutorial/04-infrastructure-and-iac-workflows.md
index a8b7979f..6f2ee5ac 100644
--- a/tutorials/awslabs-mcp-tutorial/04-infrastructure-and-iac-workflows.md
+++ b/tutorials/awslabs-mcp-tutorial/04-infrastructure-and-iac-workflows.md
@@ -633,7 +633,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Transport and Client Integration Patterns](03-transport-and-client-integration-patterns.md)
 - [Next Chapter: Chapter 5: Data, Knowledge, and Agent Workflows](05-data-knowledge-and-agent-workflows.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/awslabs-mcp-tutorial/05-data-knowledge-and-agent-workflows.md b/tutorials/awslabs-mcp-tutorial/05-data-knowledge-and-agent-workflows.md
index 2b95292c..1fc94ffe 100644
--- a/tutorials/awslabs-mcp-tutorial/05-data-knowledge-and-agent-workflows.md
+++ b/tutorials/awslabs-mcp-tutorial/05-data-knowledge-and-agent-workflows.md
@@ -633,7 +633,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Infrastructure and IaC Workflows](04-infrastructure-and-iac-workflows.md)
 - [Next Chapter: Chapter 6: Security, Credentials, and Risk Controls](06-security-credentials-and-risk-controls.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/awslabs-mcp-tutorial/06-security-credentials-and-risk-controls.md b/tutorials/awslabs-mcp-tutorial/06-security-credentials-and-risk-controls.md
index 5feec332..10848797 100644
--- a/tutorials/awslabs-mcp-tutorial/06-security-credentials-and-risk-controls.md
+++ b/tutorials/awslabs-mcp-tutorial/06-security-credentials-and-risk-controls.md
@@ -633,7 +633,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Data, Knowledge, and Agent Workflows](05-data-knowledge-and-agent-workflows.md)
 - [Next Chapter: Chapter 7: Development, Testing, and Contribution Workflow](07-development-testing-and-contribution-workflow.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/awslabs-mcp-tutorial/07-development-testing-and-contribution-workflow.md b/tutorials/awslabs-mcp-tutorial/07-development-testing-and-contribution-workflow.md
index 28a68e9e..21ab2ba5 100644
--- a/tutorials/awslabs-mcp-tutorial/07-development-testing-and-contribution-workflow.md
+++ b/tutorials/awslabs-mcp-tutorial/07-development-testing-and-contribution-workflow.md
@@ -633,7 +633,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Security, Credentials, and Risk Controls](06-security-credentials-and-risk-controls.md)
 - [Next Chapter: Chapter 8: Production Operations and Governance](08-production-operations-and-governance.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/awslabs-mcp-tutorial/08-production-operations-and-governance.md b/tutorials/awslabs-mcp-tutorial/08-production-operations-and-governance.md
index 1676f2df..c0f72330 100644
--- a/tutorials/awslabs-mcp-tutorial/08-production-operations-and-governance.md
+++ b/tutorials/awslabs-mcp-tutorial/08-production-operations-and-governance.md
@@ -635,7 +635,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Development, Testing, and Contribution Workflow](07-development-testing-and-contribution-workflow.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/awslabs-mcp-tutorial/index.md b/tutorials/awslabs-mcp-tutorial/README.md
similarity index 100%
rename from tutorials/awslabs-mcp-tutorial/index.md
rename to tutorials/awslabs-mcp-tutorial/README.md
diff --git a/tutorials/babyagi-tutorial/01-getting-started.md b/tutorials/babyagi-tutorial/01-getting-started.md
index 3ea80814..40ebda0e 100644
--- a/tutorials/babyagi-tutorial/01-getting-started.md
+++ b/tutorials/babyagi-tutorial/01-getting-started.md
@@ -276,7 +276,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Core Architecture: Task Queue and Agent Loop](02-core-architecture-task-queue-and-agent-loop.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/babyagi-tutorial/02-core-architecture-task-queue-and-agent-loop.md b/tutorials/babyagi-tutorial/02-core-architecture-task-queue-and-agent-loop.md
index f8ff12a0..95ac1a50 100644
--- a/tutorials/babyagi-tutorial/02-core-architecture-task-queue-and-agent-loop.md
+++ b/tutorials/babyagi-tutorial/02-core-architecture-task-queue-and-agent-loop.md
@@ -291,7 +291,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started](01-getting-started.md)
 - [Next Chapter: Chapter 3: LLM Backend Integration and Configuration](03-llm-backend-integration-and-configuration.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/babyagi-tutorial/03-llm-backend-integration-and-configuration.md b/tutorials/babyagi-tutorial/03-llm-backend-integration-and-configuration.md
index ab0483b7..7a6c1a29 100644
--- a/tutorials/babyagi-tutorial/03-llm-backend-integration-and-configuration.md
+++ b/tutorials/babyagi-tutorial/03-llm-backend-integration-and-configuration.md
@@ -302,7 +302,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Core Architecture: Task Queue and Agent Loop](02-core-architecture-task-queue-and-agent-loop.md)
 - [Next Chapter: Chapter 4: Task Creation and Prioritization Engine](04-task-creation-and-prioritization-engine.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/babyagi-tutorial/04-task-creation-and-prioritization-engine.md b/tutorials/babyagi-tutorial/04-task-creation-and-prioritization-engine.md
index 55e5993c..d4e9ec2b 100644
--- a/tutorials/babyagi-tutorial/04-task-creation-and-prioritization-engine.md
+++ b/tutorials/babyagi-tutorial/04-task-creation-and-prioritization-engine.md
@@ -308,7 +308,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: LLM Backend Integration and Configuration](03-llm-backend-integration-and-configuration.md)
 - [Next Chapter: Chapter 5: Memory Systems and Vector Store Integration](05-memory-systems-and-vector-store-integration.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/babyagi-tutorial/05-memory-systems-and-vector-store-integration.md b/tutorials/babyagi-tutorial/05-memory-systems-and-vector-store-integration.md
index f03b694d..24d654fa 100644
--- a/tutorials/babyagi-tutorial/05-memory-systems-and-vector-store-integration.md
+++ b/tutorials/babyagi-tutorial/05-memory-systems-and-vector-store-integration.md
@@ -306,7 +306,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Task Creation and Prioritization Engine](04-task-creation-and-prioritization-engine.md)
 - [Next Chapter: Chapter 6: Extending BabyAGI: Custom Tools and Skills](06-extending-babyagi-custom-tools-and-skills.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/babyagi-tutorial/06-extending-babyagi-custom-tools-and-skills.md b/tutorials/babyagi-tutorial/06-extending-babyagi-custom-tools-and-skills.md
index 6988c0e4..691b31e0 100644
--- a/tutorials/babyagi-tutorial/06-extending-babyagi-custom-tools-and-skills.md
+++ b/tutorials/babyagi-tutorial/06-extending-babyagi-custom-tools-and-skills.md
@@ -321,7 +321,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Memory Systems and Vector Store Integration](05-memory-systems-and-vector-store-integration.md)
 - [Next Chapter: Chapter 7: BabyAGI Evolution: 2o and Functionz Framework](07-babyagi-evolution-2o-and-functionz-framework.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/babyagi-tutorial/07-babyagi-evolution-2o-and-functionz-framework.md b/tutorials/babyagi-tutorial/07-babyagi-evolution-2o-and-functionz-framework.md
index 6d19d3e4..5d4e5639 100644
--- a/tutorials/babyagi-tutorial/07-babyagi-evolution-2o-and-functionz-framework.md
+++ b/tutorials/babyagi-tutorial/07-babyagi-evolution-2o-and-functionz-framework.md
@@ -322,7 +322,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Extending BabyAGI: Custom Tools and Skills](06-extending-babyagi-custom-tools-and-skills.md)
 - [Next Chapter: Chapter 8: Production Patterns and Research Adaptations](08-production-patterns-and-research-adaptations.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/babyagi-tutorial/08-production-patterns-and-research-adaptations.md b/tutorials/babyagi-tutorial/08-production-patterns-and-research-adaptations.md
index fd54ad47..e834c837 100644
--- a/tutorials/babyagi-tutorial/08-production-patterns-and-research-adaptations.md
+++ b/tutorials/babyagi-tutorial/08-production-patterns-and-research-adaptations.md
@@ -348,7 +348,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: BabyAGI Evolution: 2o and Functionz Framework](07-babyagi-evolution-2o-and-functionz-framework.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/babyagi-tutorial/index.md b/tutorials/babyagi-tutorial/README.md
similarity index 100%
rename from tutorials/babyagi-tutorial/index.md
rename to tutorials/babyagi-tutorial/README.md
diff --git a/tutorials/beads-tutorial/01-getting-started.md b/tutorials/beads-tutorial/01-getting-started.md
index 4d215fac..41df46fc 100644
--- a/tutorials/beads-tutorial/01-getting-started.md
+++ b/tutorials/beads-tutorial/01-getting-started.md
@@ -631,7 +631,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Architecture and Data Model](02-architecture-and-data-model.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/beads-tutorial/02-architecture-and-data-model.md b/tutorials/beads-tutorial/02-architecture-and-data-model.md
index de1a7a89..c2938f5f 100644
--- a/tutorials/beads-tutorial/02-architecture-and-data-model.md
+++ b/tutorials/beads-tutorial/02-architecture-and-data-model.md
@@ -637,7 +637,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started](01-getting-started.md)
 - [Next Chapter: Chapter 3: Core Workflow Commands](03-core-workflow-commands.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/beads-tutorial/03-core-workflow-commands.md b/tutorials/beads-tutorial/03-core-workflow-commands.md
index d93943d1..b3b4f4f1 100644
--- a/tutorials/beads-tutorial/03-core-workflow-commands.md
+++ b/tutorials/beads-tutorial/03-core-workflow-commands.md
@@ -637,7 +637,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Architecture and Data Model](02-architecture-and-data-model.md)
 - [Next Chapter: Chapter 4: Dependency Graph and Hierarchy Patterns](04-dependency-graph-and-hierarchy-patterns.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/beads-tutorial/04-dependency-graph-and-hierarchy-patterns.md b/tutorials/beads-tutorial/04-dependency-graph-and-hierarchy-patterns.md
index 91b3b98c..8fa47106 100644
--- a/tutorials/beads-tutorial/04-dependency-graph-and-hierarchy-patterns.md
+++ b/tutorials/beads-tutorial/04-dependency-graph-and-hierarchy-patterns.md
@@ -637,7 +637,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Core Workflow Commands](03-core-workflow-commands.md)
 - [Next Chapter: Chapter 5: Agent Integration and AGENTS.md Patterns](05-agent-integration-and-agents-md-patterns.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/beads-tutorial/05-agent-integration-and-agents-md-patterns.md b/tutorials/beads-tutorial/05-agent-integration-and-agents-md-patterns.md
index a27b4b71..edd158d7 100644
--- a/tutorials/beads-tutorial/05-agent-integration-and-agents-md-patterns.md
+++ b/tutorials/beads-tutorial/05-agent-integration-and-agents-md-patterns.md
@@ -637,7 +637,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Dependency Graph and Hierarchy Patterns](04-dependency-graph-and-hierarchy-patterns.md)
 - [Next Chapter: Chapter 6: Multi-Branch Collaboration and Protected Flows](06-multi-branch-collaboration-and-protected-flows.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/beads-tutorial/06-multi-branch-collaboration-and-protected-flows.md b/tutorials/beads-tutorial/06-multi-branch-collaboration-and-protected-flows.md
index 298e1a13..6d439a6b 100644
--- a/tutorials/beads-tutorial/06-multi-branch-collaboration-and-protected-flows.md
+++ b/tutorials/beads-tutorial/06-multi-branch-collaboration-and-protected-flows.md
@@ -637,7 +637,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Agent Integration and AGENTS.md Patterns](05-agent-integration-and-agents-md-patterns.md)
 - [Next Chapter: Chapter 7: Troubleshooting and Operations](07-troubleshooting-and-operations.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/beads-tutorial/07-troubleshooting-and-operations.md b/tutorials/beads-tutorial/07-troubleshooting-and-operations.md
index 72e95a53..5b3c1614 100644
--- a/tutorials/beads-tutorial/07-troubleshooting-and-operations.md
+++ b/tutorials/beads-tutorial/07-troubleshooting-and-operations.md
@@ -637,7 +637,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Multi-Branch Collaboration and Protected Flows](06-multi-branch-collaboration-and-protected-flows.md)
 - [Next Chapter: Chapter 8: Contribution Workflow and Ecosystem Extensions](08-contribution-workflow-and-ecosystem-extensions.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/beads-tutorial/08-contribution-workflow-and-ecosystem-extensions.md b/tutorials/beads-tutorial/08-contribution-workflow-and-ecosystem-extensions.md
index 9ba7a896..596b809d 100644
--- a/tutorials/beads-tutorial/08-contribution-workflow-and-ecosystem-extensions.md
+++ b/tutorials/beads-tutorial/08-contribution-workflow-and-ecosystem-extensions.md
@@ -626,7 +626,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Troubleshooting and Operations](07-troubleshooting-and-operations.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/beads-tutorial/index.md b/tutorials/beads-tutorial/README.md
similarity index 100%
rename from tutorials/beads-tutorial/index.md
rename to tutorials/beads-tutorial/README.md
diff --git a/tutorials/bentoml-tutorial/01-getting-started.md b/tutorials/bentoml-tutorial/01-getting-started.md
index 5409bf1a..73da4242 100644
--- a/tutorials/bentoml-tutorial/01-getting-started.md
+++ b/tutorials/bentoml-tutorial/01-getting-started.md
@@ -531,7 +531,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Model Packaging & Services](02-model-packaging.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/bentoml-tutorial/02-model-packaging.md b/tutorials/bentoml-tutorial/02-model-packaging.md
index 7840c10f..f3dc02ac 100644
--- a/tutorials/bentoml-tutorial/02-model-packaging.md
+++ b/tutorials/bentoml-tutorial/02-model-packaging.md
@@ -588,7 +588,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started with BentoML](01-getting-started.md)
 - [Next Chapter: Chapter 3: API Development](03-api-development.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/bentoml-tutorial/03-api-development.md b/tutorials/bentoml-tutorial/03-api-development.md
index cab32ef1..b4c61308 100644
--- a/tutorials/bentoml-tutorial/03-api-development.md
+++ b/tutorials/bentoml-tutorial/03-api-development.md
@@ -626,7 +626,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Model Packaging & Services](02-model-packaging.md)
 - [Next Chapter: Chapter 4: Framework Integration](04-framework-integration.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/bentoml-tutorial/04-framework-integration.md b/tutorials/bentoml-tutorial/04-framework-integration.md
index 396bc3e6..a1fe519f 100644
--- a/tutorials/bentoml-tutorial/04-framework-integration.md
+++ b/tutorials/bentoml-tutorial/04-framework-integration.md
@@ -485,7 +485,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: API Development](03-api-development.md)
 - [Next Chapter: Chapter 5: Testing & Validation](05-testing-validation.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/bentoml-tutorial/05-testing-validation.md b/tutorials/bentoml-tutorial/05-testing-validation.md
index e8b60bde..663e082d 100644
--- a/tutorials/bentoml-tutorial/05-testing-validation.md
+++ b/tutorials/bentoml-tutorial/05-testing-validation.md
@@ -503,7 +503,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Framework Integration](04-framework-integration.md)
 - [Next Chapter: Chapter 6: Deployment Strategies](06-deployment-strategies.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/bentoml-tutorial/06-deployment-strategies.md b/tutorials/bentoml-tutorial/06-deployment-strategies.md
index 0ace7053..f15e2bb9 100644
--- a/tutorials/bentoml-tutorial/06-deployment-strategies.md
+++ b/tutorials/bentoml-tutorial/06-deployment-strategies.md
@@ -651,7 +651,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Testing & Validation](05-testing-validation.md)
 - [Next Chapter: Chapter 7: Monitoring & Observability](07-monitoring-observability.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/bentoml-tutorial/07-monitoring-observability.md b/tutorials/bentoml-tutorial/07-monitoring-observability.md
index ffd7eed0..08e13e5c 100644
--- a/tutorials/bentoml-tutorial/07-monitoring-observability.md
+++ b/tutorials/bentoml-tutorial/07-monitoring-observability.md
@@ -688,7 +688,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Deployment Strategies](06-deployment-strategies.md)
 - [Next Chapter: Chapter 8: Production Scaling](08-production-scaling.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/bentoml-tutorial/08-production-scaling.md b/tutorials/bentoml-tutorial/08-production-scaling.md
index 1b1f6cf3..784fa848 100644
--- a/tutorials/bentoml-tutorial/08-production-scaling.md
+++ b/tutorials/bentoml-tutorial/08-production-scaling.md
@@ -1020,7 +1020,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Monitoring & Observability](07-monitoring-observability.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/bentoml-tutorial/index.md b/tutorials/bentoml-tutorial/README.md
similarity index 100%
rename from tutorials/bentoml-tutorial/index.md
rename to tutorials/bentoml-tutorial/README.md
diff --git a/tutorials/bolt-diy-tutorial/01-getting-started.md b/tutorials/bolt-diy-tutorial/01-getting-started.md
index a005c70e..5b6607f6 100644
--- a/tutorials/bolt-diy-tutorial/01-getting-started.md
+++ b/tutorials/bolt-diy-tutorial/01-getting-started.md
@@ -629,7 +629,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Architecture Overview](02-architecture-overview.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/bolt-diy-tutorial/02-architecture-overview.md b/tutorials/bolt-diy-tutorial/02-architecture-overview.md
index bd286130..a1272cb1 100644
--- a/tutorials/bolt-diy-tutorial/02-architecture-overview.md
+++ b/tutorials/bolt-diy-tutorial/02-architecture-overview.md
@@ -628,7 +628,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started](01-getting-started.md)
 - [Next Chapter: Chapter 3: Providers and Model Routing](03-providers-and-routing.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/bolt-diy-tutorial/03-providers-and-routing.md b/tutorials/bolt-diy-tutorial/03-providers-and-routing.md
index 998d2996..4034a247 100644
--- a/tutorials/bolt-diy-tutorial/03-providers-and-routing.md
+++ b/tutorials/bolt-diy-tutorial/03-providers-and-routing.md
@@ -626,7 +626,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Architecture Overview](02-architecture-overview.md)
 - [Next Chapter: Chapter 4: Prompt-to-App Workflow](04-prompt-to-app-workflow.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/bolt-diy-tutorial/04-prompt-to-app-workflow.md b/tutorials/bolt-diy-tutorial/04-prompt-to-app-workflow.md
index fd1e225c..69255f44 100644
--- a/tutorials/bolt-diy-tutorial/04-prompt-to-app-workflow.md
+++ b/tutorials/bolt-diy-tutorial/04-prompt-to-app-workflow.md
@@ -626,7 +626,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Providers and Model Routing](03-providers-and-routing.md)
 - [Next Chapter: Chapter 5: Files, Diff, and Locking](05-files-diff-locking.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/bolt-diy-tutorial/05-files-diff-locking.md b/tutorials/bolt-diy-tutorial/05-files-diff-locking.md
index d4d59f36..2aea7e1f 100644
--- a/tutorials/bolt-diy-tutorial/05-files-diff-locking.md
+++ b/tutorials/bolt-diy-tutorial/05-files-diff-locking.md
@@ -627,7 +627,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Prompt-to-App Workflow](04-prompt-to-app-workflow.md)
 - [Next Chapter: Chapter 6: Integrations and MCP](06-integrations-and-mcp.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/bolt-diy-tutorial/06-integrations-and-mcp.md b/tutorials/bolt-diy-tutorial/06-integrations-and-mcp.md
index c3194609..5c1a00ac 100644
--- a/tutorials/bolt-diy-tutorial/06-integrations-and-mcp.md
+++ b/tutorials/bolt-diy-tutorial/06-integrations-and-mcp.md
@@ -629,7 +629,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Files, Diff, and Locking](05-files-diff-locking.md)
 - [Next Chapter: Chapter 7: Deployment and Distribution](07-deployment-distribution.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/bolt-diy-tutorial/07-deployment-distribution.md b/tutorials/bolt-diy-tutorial/07-deployment-distribution.md
index 725b874f..9d2458dd 100644
--- a/tutorials/bolt-diy-tutorial/07-deployment-distribution.md
+++ b/tutorials/bolt-diy-tutorial/07-deployment-distribution.md
@@ -631,7 +631,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Integrations and MCP](06-integrations-and-mcp.md)
 - [Next Chapter: Chapter 8: Production Operations](08-production-operations.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/bolt-diy-tutorial/08-production-operations.md b/tutorials/bolt-diy-tutorial/08-production-operations.md
index d96ae7a5..d040a0c0 100644
--- a/tutorials/bolt-diy-tutorial/08-production-operations.md
+++ b/tutorials/bolt-diy-tutorial/08-production-operations.md
@@ -636,7 +636,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Deployment and Distribution](07-deployment-distribution.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/bolt-diy-tutorial/index.md b/tutorials/bolt-diy-tutorial/README.md
similarity index 100%
rename from tutorials/bolt-diy-tutorial/index.md
rename to tutorials/bolt-diy-tutorial/README.md
diff --git a/tutorials/botpress-tutorial/01-getting-started.md b/tutorials/botpress-tutorial/01-getting-started.md
index c9fa7ba8..95eb2206 100644
--- a/tutorials/botpress-tutorial/01-getting-started.md
+++ b/tutorials/botpress-tutorial/01-getting-started.md
@@ -375,7 +375,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Visual Flow Builder](02-visual-flow-builder.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/botpress-tutorial/02-visual-flow-builder.md b/tutorials/botpress-tutorial/02-visual-flow-builder.md
index 77395e6d..898fcb4b 100644
--- a/tutorials/botpress-tutorial/02-visual-flow-builder.md
+++ b/tutorials/botpress-tutorial/02-visual-flow-builder.md
@@ -526,7 +526,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started with Botpress](01-getting-started.md)
 - [Next Chapter: Chapter 3: Natural Language Understanding](03-natural-language-understanding.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/botpress-tutorial/03-natural-language-understanding.md b/tutorials/botpress-tutorial/03-natural-language-understanding.md
index 431a6486..4fa8d4b1 100644
--- a/tutorials/botpress-tutorial/03-natural-language-understanding.md
+++ b/tutorials/botpress-tutorial/03-natural-language-understanding.md
@@ -562,7 +562,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Visual Flow Builder](02-visual-flow-builder.md)
 - [Next Chapter: Chapter 4: Custom Actions & Code](04-custom-actions-code.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/botpress-tutorial/04-custom-actions-code.md b/tutorials/botpress-tutorial/04-custom-actions-code.md
index f3090352..ef59ac89 100644
--- a/tutorials/botpress-tutorial/04-custom-actions-code.md
+++ b/tutorials/botpress-tutorial/04-custom-actions-code.md
@@ -635,7 +635,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Natural Language Understanding](03-natural-language-understanding.md)
 - [Next Chapter: Chapter 5: Channel Integrations](05-channel-integrations.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/botpress-tutorial/05-channel-integrations.md b/tutorials/botpress-tutorial/05-channel-integrations.md
index ed01a5dd..932fc6fb 100644
--- a/tutorials/botpress-tutorial/05-channel-integrations.md
+++ b/tutorials/botpress-tutorial/05-channel-integrations.md
@@ -467,7 +467,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Custom Actions & Code](04-custom-actions-code.md)
 - [Next Chapter: Chapter 6: Advanced Features](06-advanced-features.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/botpress-tutorial/06-advanced-features.md b/tutorials/botpress-tutorial/06-advanced-features.md
index 9bcc7d4b..167026de 100644
--- a/tutorials/botpress-tutorial/06-advanced-features.md
+++ b/tutorials/botpress-tutorial/06-advanced-features.md
@@ -507,7 +507,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Channel Integrations](05-channel-integrations.md)
 - [Next Chapter: Chapter 7: Analytics & Monitoring](07-analytics-monitoring.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/botpress-tutorial/07-analytics-monitoring.md b/tutorials/botpress-tutorial/07-analytics-monitoring.md
index 7bfdb5d2..d1793f4e 100644
--- a/tutorials/botpress-tutorial/07-analytics-monitoring.md
+++ b/tutorials/botpress-tutorial/07-analytics-monitoring.md
@@ -556,7 +556,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Advanced Features](06-advanced-features.md)
 - [Next Chapter: Chapter 8: Production Deployment](08-production-deployment.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/botpress-tutorial/08-production-deployment.md b/tutorials/botpress-tutorial/08-production-deployment.md
index 5f4c6030..116e044a 100644
--- a/tutorials/botpress-tutorial/08-production-deployment.md
+++ b/tutorials/botpress-tutorial/08-production-deployment.md
@@ -660,7 +660,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Analytics & Monitoring](07-analytics-monitoring.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/botpress-tutorial/index.md b/tutorials/botpress-tutorial/README.md
similarity index 100%
rename from tutorials/botpress-tutorial/index.md
rename to tutorials/botpress-tutorial/README.md
diff --git a/tutorials/browser-use-tutorial/01-getting-started.md b/tutorials/browser-use-tutorial/01-getting-started.md
index 843c4dcb..78ee708e 100644
--- a/tutorials/browser-use-tutorial/01-getting-started.md
+++ b/tutorials/browser-use-tutorial/01-getting-started.md
@@ -655,7 +655,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Browser Control Basics](02-browser-control.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/browser-use-tutorial/02-browser-control.md b/tutorials/browser-use-tutorial/02-browser-control.md
index d953a90d..25af5f4a 100644
--- a/tutorials/browser-use-tutorial/02-browser-control.md
+++ b/tutorials/browser-use-tutorial/02-browser-control.md
@@ -690,7 +690,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started with Browser Use](01-getting-started.md)
 - [Next Chapter: Chapter 3: Element Selection - Finding and Interacting with Web Elements](03-element-selection.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/browser-use-tutorial/03-element-selection.md b/tutorials/browser-use-tutorial/03-element-selection.md
index e8f56851..343f1072 100644
--- a/tutorials/browser-use-tutorial/03-element-selection.md
+++ b/tutorials/browser-use-tutorial/03-element-selection.md
@@ -644,7 +644,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Browser Control Basics](02-browser-control.md)
 - [Next Chapter: Chapter 4: Form Automation - Intelligent Form Filling and Submission](04-form-automation.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/browser-use-tutorial/04-form-automation.md b/tutorials/browser-use-tutorial/04-form-automation.md
index 9eb22db9..9283933c 100644
--- a/tutorials/browser-use-tutorial/04-form-automation.md
+++ b/tutorials/browser-use-tutorial/04-form-automation.md
@@ -717,7 +717,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Element Selection - Finding and Interacting with Web Elements](03-element-selection.md)
 - [Next Chapter: Chapter 5: Data Extraction - Scraping and Extracting Structured Data](05-data-extraction.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/browser-use-tutorial/05-data-extraction.md b/tutorials/browser-use-tutorial/05-data-extraction.md
index 564ba5a8..b9386f28 100644
--- a/tutorials/browser-use-tutorial/05-data-extraction.md
+++ b/tutorials/browser-use-tutorial/05-data-extraction.md
@@ -705,7 +705,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Form Automation - Intelligent Form Filling and Submission](04-form-automation.md)
 - [Next Chapter: Chapter 6: Multi-Tab Workflows - Managing Complex Multi-Tab Operations](06-multi-tab.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/browser-use-tutorial/06-multi-tab.md b/tutorials/browser-use-tutorial/06-multi-tab.md
index 75432a2e..e11ea941 100644
--- a/tutorials/browser-use-tutorial/06-multi-tab.md
+++ b/tutorials/browser-use-tutorial/06-multi-tab.md
@@ -638,7 +638,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Data Extraction - Scraping and Extracting Structured Data](05-data-extraction.md)
 - [Next Chapter: Chapter 7: Custom Actions - Building Domain-Specific Browser Actions](07-custom-actions.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/browser-use-tutorial/07-custom-actions.md b/tutorials/browser-use-tutorial/07-custom-actions.md
index 7b824aaa..45014cd0 100644
--- a/tutorials/browser-use-tutorial/07-custom-actions.md
+++ b/tutorials/browser-use-tutorial/07-custom-actions.md
@@ -948,7 +948,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Multi-Tab Workflows - Managing Complex Multi-Tab Operations](06-multi-tab.md)
 - [Next Chapter: Chapter 8: Production Deployment - Scaling, Reliability, and Best Practices](08-production.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/browser-use-tutorial/08-production.md b/tutorials/browser-use-tutorial/08-production.md
index fc397db1..3c00b0ac 100644
--- a/tutorials/browser-use-tutorial/08-production.md
+++ b/tutorials/browser-use-tutorial/08-production.md
@@ -1058,7 +1058,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Custom Actions - Building Domain-Specific Browser Actions](07-custom-actions.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/browser-use-tutorial/index.md b/tutorials/browser-use-tutorial/README.md
similarity index 100%
rename from tutorials/browser-use-tutorial/index.md
rename to tutorials/browser-use-tutorial/README.md
diff --git a/tutorials/chatbox-tutorial/01-getting-started.md b/tutorials/chatbox-tutorial/01-getting-started.md
index 279f3da0..38cccc64 100644
--- a/tutorials/chatbox-tutorial/01-getting-started.md
+++ b/tutorials/chatbox-tutorial/01-getting-started.md
@@ -539,7 +539,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: UI Architecture & Components](02-ui-architecture.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/chatbox-tutorial/02-ui-architecture.md b/tutorials/chatbox-tutorial/02-ui-architecture.md
index cd01df62..25f3994d 100644
--- a/tutorials/chatbox-tutorial/02-ui-architecture.md
+++ b/tutorials/chatbox-tutorial/02-ui-architecture.md
@@ -754,7 +754,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started with Chatbox](01-getting-started.md)
 - [Next Chapter: Chapter 3: AI Provider Integration](03-ai-providers.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/chatbox-tutorial/03-ai-providers.md b/tutorials/chatbox-tutorial/03-ai-providers.md
index db531978..1aa25a25 100644
--- a/tutorials/chatbox-tutorial/03-ai-providers.md
+++ b/tutorials/chatbox-tutorial/03-ai-providers.md
@@ -584,7 +584,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: UI Architecture & Components](02-ui-architecture.md)
 - [Next Chapter: Chapter 4: Conversation Management](04-conversation-management.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/chatbox-tutorial/04-conversation-management.md b/tutorials/chatbox-tutorial/04-conversation-management.md
index 4c11dbb5..8a9e76eb 100644
--- a/tutorials/chatbox-tutorial/04-conversation-management.md
+++ b/tutorials/chatbox-tutorial/04-conversation-management.md
@@ -650,7 +650,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: AI Provider Integration](03-ai-providers.md)
 - [Next Chapter: Chapter 5: Message Processing Pipeline](05-message-processing.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/chatbox-tutorial/05-message-processing.md b/tutorials/chatbox-tutorial/05-message-processing.md
index 268e635d..7479e67c 100644
--- a/tutorials/chatbox-tutorial/05-message-processing.md
+++ b/tutorials/chatbox-tutorial/05-message-processing.md
@@ -631,7 +631,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Conversation Management](04-conversation-management.md)
 - [Next Chapter: Chapter 6: Theme & Customization System](06-theme-system.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/chatbox-tutorial/06-theme-system.md b/tutorials/chatbox-tutorial/06-theme-system.md
index 827e3a7e..999ade3a 100644
--- a/tutorials/chatbox-tutorial/06-theme-system.md
+++ b/tutorials/chatbox-tutorial/06-theme-system.md
@@ -668,7 +668,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Message Processing Pipeline](05-message-processing.md)
 - [Next Chapter: Chapter 7: Plugin Architecture](07-plugin-system.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/chatbox-tutorial/07-plugin-system.md b/tutorials/chatbox-tutorial/07-plugin-system.md
index e7b8c606..b1e18ae2 100644
--- a/tutorials/chatbox-tutorial/07-plugin-system.md
+++ b/tutorials/chatbox-tutorial/07-plugin-system.md
@@ -663,7 +663,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Theme & Customization System](06-theme-system.md)
 - [Next Chapter: Chapter 8: Production Deployment](08-production-deployment.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/chatbox-tutorial/08-production-deployment.md b/tutorials/chatbox-tutorial/08-production-deployment.md
index d277da2d..e941a663 100644
--- a/tutorials/chatbox-tutorial/08-production-deployment.md
+++ b/tutorials/chatbox-tutorial/08-production-deployment.md
@@ -830,7 +830,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Plugin Architecture](07-plugin-system.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/chatbox-tutorial/index.md b/tutorials/chatbox-tutorial/README.md
similarity index 100%
rename from tutorials/chatbox-tutorial/index.md
rename to tutorials/chatbox-tutorial/README.md
diff --git a/tutorials/cherry-studio-tutorial/01-getting-started.md b/tutorials/cherry-studio-tutorial/01-getting-started.md
index 702c2525..122c3a15 100644
--- a/tutorials/cherry-studio-tutorial/01-getting-started.md
+++ b/tutorials/cherry-studio-tutorial/01-getting-started.md
@@ -635,7 +635,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Core Architecture and Product Model](02-core-architecture-and-product-model.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/cherry-studio-tutorial/02-core-architecture-and-product-model.md b/tutorials/cherry-studio-tutorial/02-core-architecture-and-product-model.md
index 918df8a9..87e983c7 100644
--- a/tutorials/cherry-studio-tutorial/02-core-architecture-and-product-model.md
+++ b/tutorials/cherry-studio-tutorial/02-core-architecture-and-product-model.md
@@ -626,7 +626,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started](01-getting-started.md)
 - [Next Chapter: Chapter 3: Provider Configuration and Routing](03-provider-configuration-and-routing.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/cherry-studio-tutorial/03-provider-configuration-and-routing.md b/tutorials/cherry-studio-tutorial/03-provider-configuration-and-routing.md
index c7361661..29572f11 100644
--- a/tutorials/cherry-studio-tutorial/03-provider-configuration-and-routing.md
+++ b/tutorials/cherry-studio-tutorial/03-provider-configuration-and-routing.md
@@ -630,7 +630,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Core Architecture and Product Model](02-core-architecture-and-product-model.md)
 - [Next Chapter: Chapter 4: Assistants, Topics, and Workflow Design](04-assistants-topics-and-workflow-design.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/cherry-studio-tutorial/04-assistants-topics-and-workflow-design.md b/tutorials/cherry-studio-tutorial/04-assistants-topics-and-workflow-design.md
index c1094c78..66ab3be8 100644
--- a/tutorials/cherry-studio-tutorial/04-assistants-topics-and-workflow-design.md
+++ b/tutorials/cherry-studio-tutorial/04-assistants-topics-and-workflow-design.md
@@ -635,7 +635,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Provider Configuration and Routing](03-provider-configuration-and-routing.md)
 - [Next Chapter: Chapter 5: Documents, MCP, and Tool Integrations](05-documents-mcp-and-tool-integrations.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/cherry-studio-tutorial/05-documents-mcp-and-tool-integrations.md b/tutorials/cherry-studio-tutorial/05-documents-mcp-and-tool-integrations.md
index 3f8b6131..2cef8df3 100644
--- a/tutorials/cherry-studio-tutorial/05-documents-mcp-and-tool-integrations.md
+++ b/tutorials/cherry-studio-tutorial/05-documents-mcp-and-tool-integrations.md
@@ -624,7 +624,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Assistants, Topics, and Workflow Design](04-assistants-topics-and-workflow-design.md)
 - [Next Chapter: Chapter 6: Team Adoption and Enterprise Capabilities](06-team-adoption-and-enterprise-capabilities.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/cherry-studio-tutorial/06-team-adoption-and-enterprise-capabilities.md b/tutorials/cherry-studio-tutorial/06-team-adoption-and-enterprise-capabilities.md
index c68a65a5..00d8c73d 100644
--- a/tutorials/cherry-studio-tutorial/06-team-adoption-and-enterprise-capabilities.md
+++ b/tutorials/cherry-studio-tutorial/06-team-adoption-and-enterprise-capabilities.md
@@ -625,7 +625,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Documents, MCP, and Tool Integrations](05-documents-mcp-and-tool-integrations.md)
 - [Next Chapter: Chapter 7: Development and Contribution Workflow](07-development-and-contribution-workflow.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/cherry-studio-tutorial/07-development-and-contribution-workflow.md b/tutorials/cherry-studio-tutorial/07-development-and-contribution-workflow.md
index 384a29cd..440dea56 100644
--- a/tutorials/cherry-studio-tutorial/07-development-and-contribution-workflow.md
+++ b/tutorials/cherry-studio-tutorial/07-development-and-contribution-workflow.md
@@ -638,7 +638,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Team Adoption and Enterprise Capabilities](06-team-adoption-and-enterprise-capabilities.md)
 - [Next Chapter: Chapter 8: Production Operations and Governance](08-production-operations-and-governance.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/cherry-studio-tutorial/08-production-operations-and-governance.md b/tutorials/cherry-studio-tutorial/08-production-operations-and-governance.md
index 37c0e0c5..053fd3dc 100644
--- a/tutorials/cherry-studio-tutorial/08-production-operations-and-governance.md
+++ b/tutorials/cherry-studio-tutorial/08-production-operations-and-governance.md
@@ -626,7 +626,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Development and Contribution Workflow](07-development-and-contribution-workflow.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/cherry-studio-tutorial/index.md b/tutorials/cherry-studio-tutorial/README.md
similarity index 100%
rename from tutorials/cherry-studio-tutorial/index.md
rename to tutorials/cherry-studio-tutorial/README.md
diff --git a/tutorials/chroma-tutorial/01-getting-started.md b/tutorials/chroma-tutorial/01-getting-started.md
index 123b1ac1..2bcfd227 100644
--- a/tutorials/chroma-tutorial/01-getting-started.md
+++ b/tutorials/chroma-tutorial/01-getting-started.md
@@ -424,7 +424,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Collections & Documents](02-collections-documents.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/chroma-tutorial/02-collections-documents.md b/tutorials/chroma-tutorial/02-collections-documents.md
index 03bbbdfb..4dc38c98 100644
--- a/tutorials/chroma-tutorial/02-collections-documents.md
+++ b/tutorials/chroma-tutorial/02-collections-documents.md
@@ -570,7 +570,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started with Chroma](01-getting-started.md)
 - [Next Chapter: Chapter 3: Embeddings & Indexing](03-embeddings-indexing.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/chroma-tutorial/03-embeddings-indexing.md b/tutorials/chroma-tutorial/03-embeddings-indexing.md
index feec6550..e7cd3fb0 100644
--- a/tutorials/chroma-tutorial/03-embeddings-indexing.md
+++ b/tutorials/chroma-tutorial/03-embeddings-indexing.md
@@ -464,7 +464,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Collections & Documents](02-collections-documents.md)
 - [Next Chapter: Chapter 4: Querying & Retrieval](04-querying-retrieval.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/chroma-tutorial/04-querying-retrieval.md b/tutorials/chroma-tutorial/04-querying-retrieval.md
index af45acf0..983c2cb1 100644
--- a/tutorials/chroma-tutorial/04-querying-retrieval.md
+++ b/tutorials/chroma-tutorial/04-querying-retrieval.md
@@ -227,7 +227,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Embeddings & Indexing](03-embeddings-indexing.md)
 - [Next Chapter: Chapter 5: Metadata & Filtering](05-metadata-filtering.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/chroma-tutorial/05-metadata-filtering.md b/tutorials/chroma-tutorial/05-metadata-filtering.md
index ec572fa0..b1643d3c 100644
--- a/tutorials/chroma-tutorial/05-metadata-filtering.md
+++ b/tutorials/chroma-tutorial/05-metadata-filtering.md
@@ -237,7 +237,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Querying & Retrieval](04-querying-retrieval.md)
 - [Next Chapter: Chapter 6: Integration Patterns](06-integration-patterns.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/chroma-tutorial/06-integration-patterns.md b/tutorials/chroma-tutorial/06-integration-patterns.md
index bd727aab..2cd47920 100644
--- a/tutorials/chroma-tutorial/06-integration-patterns.md
+++ b/tutorials/chroma-tutorial/06-integration-patterns.md
@@ -1033,7 +1033,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Metadata & Filtering](05-metadata-filtering.md)
 - [Next Chapter: Chapter 7: Production Deployment](07-production-deployment.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/chroma-tutorial/07-production-deployment.md b/tutorials/chroma-tutorial/07-production-deployment.md
index 66501e3a..17e8ef71 100644
--- a/tutorials/chroma-tutorial/07-production-deployment.md
+++ b/tutorials/chroma-tutorial/07-production-deployment.md
@@ -327,7 +327,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Integration Patterns](06-integration-patterns.md)
 - [Next Chapter: Chapter 8: Performance Optimization](08-performance-optimization.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/chroma-tutorial/08-performance-optimization.md b/tutorials/chroma-tutorial/08-performance-optimization.md
index e682b23e..b932245c 100644
--- a/tutorials/chroma-tutorial/08-performance-optimization.md
+++ b/tutorials/chroma-tutorial/08-performance-optimization.md
@@ -517,7 +517,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Production Deployment](07-production-deployment.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/chroma-tutorial/index.md b/tutorials/chroma-tutorial/README.md
similarity index 100%
rename from tutorials/chroma-tutorial/index.md
rename to tutorials/chroma-tutorial/README.md
diff --git a/tutorials/chrome-devtools-mcp-tutorial/01-getting-started.md b/tutorials/chrome-devtools-mcp-tutorial/01-getting-started.md
index c30b33fd..3b50188e 100644
--- a/tutorials/chrome-devtools-mcp-tutorial/01-getting-started.md
+++ b/tutorials/chrome-devtools-mcp-tutorial/01-getting-started.md
@@ -636,7 +636,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Architecture and Design Principles](02-architecture-and-design-principles.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/chrome-devtools-mcp-tutorial/02-architecture-and-design-principles.md b/tutorials/chrome-devtools-mcp-tutorial/02-architecture-and-design-principles.md
index 7b5ecbf1..3ef42be7 100644
--- a/tutorials/chrome-devtools-mcp-tutorial/02-architecture-and-design-principles.md
+++ b/tutorials/chrome-devtools-mcp-tutorial/02-architecture-and-design-principles.md
@@ -626,7 +626,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started](01-getting-started.md)
 - [Next Chapter: Chapter 3: Client Integrations and Setup Patterns](03-client-integrations-and-setup-patterns.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/chrome-devtools-mcp-tutorial/03-client-integrations-and-setup-patterns.md b/tutorials/chrome-devtools-mcp-tutorial/03-client-integrations-and-setup-patterns.md
index 83bdf933..94c0f93e 100644
--- a/tutorials/chrome-devtools-mcp-tutorial/03-client-integrations-and-setup-patterns.md
+++ b/tutorials/chrome-devtools-mcp-tutorial/03-client-integrations-and-setup-patterns.md
@@ -626,7 +626,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Architecture and Design Principles](02-architecture-and-design-principles.md)
 - [Next Chapter: Chapter 4: Automation Tooling: Input and Navigation](04-automation-tooling-input-and-navigation.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/chrome-devtools-mcp-tutorial/04-automation-tooling-input-and-navigation.md b/tutorials/chrome-devtools-mcp-tutorial/04-automation-tooling-input-and-navigation.md
index e9b2fcd5..3adb5fba 100644
--- a/tutorials/chrome-devtools-mcp-tutorial/04-automation-tooling-input-and-navigation.md
+++ b/tutorials/chrome-devtools-mcp-tutorial/04-automation-tooling-input-and-navigation.md
@@ -637,7 +637,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Client Integrations and Setup Patterns](03-client-integrations-and-setup-patterns.md)
 - [Next Chapter: Chapter 5: Performance and Debugging Workflows](05-performance-and-debugging-workflows.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/chrome-devtools-mcp-tutorial/05-performance-and-debugging-workflows.md b/tutorials/chrome-devtools-mcp-tutorial/05-performance-and-debugging-workflows.md
index 04416582..7e27883d 100644
--- a/tutorials/chrome-devtools-mcp-tutorial/05-performance-and-debugging-workflows.md
+++ b/tutorials/chrome-devtools-mcp-tutorial/05-performance-and-debugging-workflows.md
@@ -627,7 +627,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Automation Tooling: Input and Navigation](04-automation-tooling-input-and-navigation.md)
 - [Next Chapter: Chapter 6: Troubleshooting and Reliability Hardening](06-troubleshooting-and-reliability-hardening.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/chrome-devtools-mcp-tutorial/06-troubleshooting-and-reliability-hardening.md b/tutorials/chrome-devtools-mcp-tutorial/06-troubleshooting-and-reliability-hardening.md
index c2ac116b..724eafd0 100644
--- a/tutorials/chrome-devtools-mcp-tutorial/06-troubleshooting-and-reliability-hardening.md
+++ b/tutorials/chrome-devtools-mcp-tutorial/06-troubleshooting-and-reliability-hardening.md
@@ -626,7 +626,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Performance and Debugging Workflows](05-performance-and-debugging-workflows.md)
 - [Next Chapter: Chapter 7: Development, Evaluation, and Contribution](07-development-evaluation-and-contribution.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/chrome-devtools-mcp-tutorial/07-development-evaluation-and-contribution.md b/tutorials/chrome-devtools-mcp-tutorial/07-development-evaluation-and-contribution.md
index 03e08cfa..89f8d0f2 100644
--- a/tutorials/chrome-devtools-mcp-tutorial/07-development-evaluation-and-contribution.md
+++ b/tutorials/chrome-devtools-mcp-tutorial/07-development-evaluation-and-contribution.md
@@ -627,7 +627,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Troubleshooting and Reliability Hardening](06-troubleshooting-and-reliability-hardening.md)
 - [Next Chapter: Chapter 8: Production Operations and Privacy Governance](08-production-operations-and-privacy-governance.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/chrome-devtools-mcp-tutorial/08-production-operations-and-privacy-governance.md b/tutorials/chrome-devtools-mcp-tutorial/08-production-operations-and-privacy-governance.md
index 231493fd..9147a149 100644
--- a/tutorials/chrome-devtools-mcp-tutorial/08-production-operations-and-privacy-governance.md
+++ b/tutorials/chrome-devtools-mcp-tutorial/08-production-operations-and-privacy-governance.md
@@ -627,7 +627,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Development, Evaluation, and Contribution](07-development-evaluation-and-contribution.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/chrome-devtools-mcp-tutorial/index.md b/tutorials/chrome-devtools-mcp-tutorial/README.md
similarity index 100%
rename from tutorials/chrome-devtools-mcp-tutorial/index.md
rename to tutorials/chrome-devtools-mcp-tutorial/README.md
diff --git a/tutorials/cipher-tutorial/01-getting-started.md b/tutorials/cipher-tutorial/01-getting-started.md
index 4bc8b0ad..2d5dbd39 100644
--- a/tutorials/cipher-tutorial/01-getting-started.md
+++ b/tutorials/cipher-tutorial/01-getting-started.md
@@ -633,7 +633,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Core Modes and Session Workflow](02-core-modes-and-session-workflow.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/cipher-tutorial/02-core-modes-and-session-workflow.md b/tutorials/cipher-tutorial/02-core-modes-and-session-workflow.md
index 48538846..f22397c1 100644
--- a/tutorials/cipher-tutorial/02-core-modes-and-session-workflow.md
+++ b/tutorials/cipher-tutorial/02-core-modes-and-session-workflow.md
@@ -632,7 +632,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started](01-getting-started.md)
 - [Next Chapter: Chapter 3: Memory Architecture and Data Model](03-memory-architecture-and-data-model.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/cipher-tutorial/03-memory-architecture-and-data-model.md b/tutorials/cipher-tutorial/03-memory-architecture-and-data-model.md
index 76cfec85..a9ae56b4 100644
--- a/tutorials/cipher-tutorial/03-memory-architecture-and-data-model.md
+++ b/tutorials/cipher-tutorial/03-memory-architecture-and-data-model.md
@@ -632,7 +632,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Core Modes and Session Workflow](02-core-modes-and-session-workflow.md)
 - [Next Chapter: Chapter 4: Configuration, Providers, and Embeddings](04-configuration-providers-and-embeddings.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/cipher-tutorial/04-configuration-providers-and-embeddings.md b/tutorials/cipher-tutorial/04-configuration-providers-and-embeddings.md
index 37cfcec4..ecb29384 100644
--- a/tutorials/cipher-tutorial/04-configuration-providers-and-embeddings.md
+++ b/tutorials/cipher-tutorial/04-configuration-providers-and-embeddings.md
@@ -632,7 +632,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Memory Architecture and Data Model](03-memory-architecture-and-data-model.md)
 - [Next Chapter: Chapter 5: Vector Stores and Workspace Memory](05-vector-stores-and-workspace-memory.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/cipher-tutorial/05-vector-stores-and-workspace-memory.md b/tutorials/cipher-tutorial/05-vector-stores-and-workspace-memory.md
index c070fbdb..9239c518 100644
--- a/tutorials/cipher-tutorial/05-vector-stores-and-workspace-memory.md
+++ b/tutorials/cipher-tutorial/05-vector-stores-and-workspace-memory.md
@@ -633,7 +633,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Configuration, Providers, and Embeddings](04-configuration-providers-and-embeddings.md)
 - [Next Chapter: Chapter 6: MCP Integration Patterns](06-mcp-integration-patterns.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/cipher-tutorial/06-mcp-integration-patterns.md b/tutorials/cipher-tutorial/06-mcp-integration-patterns.md
index 89f3aad1..fa2fc3e3 100644
--- a/tutorials/cipher-tutorial/06-mcp-integration-patterns.md
+++ b/tutorials/cipher-tutorial/06-mcp-integration-patterns.md
@@ -630,7 +630,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Vector Stores and Workspace Memory](05-vector-stores-and-workspace-memory.md)
 - [Next Chapter: Chapter 7: Deployment and Operations Modes](07-deployment-and-operations-modes.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/cipher-tutorial/07-deployment-and-operations-modes.md b/tutorials/cipher-tutorial/07-deployment-and-operations-modes.md
index 180fbfc9..994e7851 100644
--- a/tutorials/cipher-tutorial/07-deployment-and-operations-modes.md
+++ b/tutorials/cipher-tutorial/07-deployment-and-operations-modes.md
@@ -636,7 +636,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: MCP Integration Patterns](06-mcp-integration-patterns.md)
 - [Next Chapter: Chapter 8: Security and Team Governance](08-security-and-team-governance.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/cipher-tutorial/08-security-and-team-governance.md b/tutorials/cipher-tutorial/08-security-and-team-governance.md
index a18f1924..ea710347 100644
--- a/tutorials/cipher-tutorial/08-security-and-team-governance.md
+++ b/tutorials/cipher-tutorial/08-security-and-team-governance.md
@@ -630,7 +630,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Deployment and Operations Modes](07-deployment-and-operations-modes.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/cipher-tutorial/index.md b/tutorials/cipher-tutorial/README.md
similarity index 100%
rename from tutorials/cipher-tutorial/index.md
rename to tutorials/cipher-tutorial/README.md
diff --git a/tutorials/claude-code-router-tutorial/01-getting-started.md b/tutorials/claude-code-router-tutorial/01-getting-started.md
index decff94d..be7e1b58 100644
--- a/tutorials/claude-code-router-tutorial/01-getting-started.md
+++ b/tutorials/claude-code-router-tutorial/01-getting-started.md
@@ -638,7 +638,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Architecture and Package Topology](02-architecture-and-package-topology.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/claude-code-router-tutorial/02-architecture-and-package-topology.md b/tutorials/claude-code-router-tutorial/02-architecture-and-package-topology.md
index b5cf8b07..5161c4af 100644
--- a/tutorials/claude-code-router-tutorial/02-architecture-and-package-topology.md
+++ b/tutorials/claude-code-router-tutorial/02-architecture-and-package-topology.md
@@ -628,7 +628,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started](01-getting-started.md)
 - [Next Chapter: Chapter 3: Provider Configuration and Transformer Strategy](03-provider-configuration-and-transformer-strategy.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/claude-code-router-tutorial/03-provider-configuration-and-transformer-strategy.md b/tutorials/claude-code-router-tutorial/03-provider-configuration-and-transformer-strategy.md
index 61a3f0ca..5d19c248 100644
--- a/tutorials/claude-code-router-tutorial/03-provider-configuration-and-transformer-strategy.md
+++ b/tutorials/claude-code-router-tutorial/03-provider-configuration-and-transformer-strategy.md
@@ -630,7 +630,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Architecture and Package Topology](02-architecture-and-package-topology.md)
 - [Next Chapter: Chapter 4: Routing Rules, Fallbacks, and Custom Router Logic](04-routing-rules-fallbacks-and-custom-router-logic.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/claude-code-router-tutorial/04-routing-rules-fallbacks-and-custom-router-logic.md b/tutorials/claude-code-router-tutorial/04-routing-rules-fallbacks-and-custom-router-logic.md
index 7a32ad70..0a5a1f2a 100644
--- a/tutorials/claude-code-router-tutorial/04-routing-rules-fallbacks-and-custom-router-logic.md
+++ b/tutorials/claude-code-router-tutorial/04-routing-rules-fallbacks-and-custom-router-logic.md
@@ -628,7 +628,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Provider Configuration and Transformer Strategy](03-provider-configuration-and-transformer-strategy.md)
 - [Next Chapter: Chapter 5: CLI Operations: Model, Preset, and Statusline Workflows](05-cli-operations-model-preset-and-statusline-workflows.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/claude-code-router-tutorial/05-cli-operations-model-preset-and-statusline-workflows.md b/tutorials/claude-code-router-tutorial/05-cli-operations-model-preset-and-statusline-workflows.md
index e0bf1d82..f7207dd4 100644
--- a/tutorials/claude-code-router-tutorial/05-cli-operations-model-preset-and-statusline-workflows.md
+++ b/tutorials/claude-code-router-tutorial/05-cli-operations-model-preset-and-statusline-workflows.md
@@ -634,7 +634,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Routing Rules, Fallbacks, and Custom Router Logic](04-routing-rules-fallbacks-and-custom-router-logic.md)
 - [Next Chapter: Chapter 6: Server Deployment and API Integration](06-server-deployment-and-api-integration.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/claude-code-router-tutorial/06-server-deployment-and-api-integration.md b/tutorials/claude-code-router-tutorial/06-server-deployment-and-api-integration.md
index 47f770e9..b31df2c2 100644
--- a/tutorials/claude-code-router-tutorial/06-server-deployment-and-api-integration.md
+++ b/tutorials/claude-code-router-tutorial/06-server-deployment-and-api-integration.md
@@ -629,7 +629,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: CLI Operations: Model, Preset, and Statusline Workflows](05-cli-operations-model-preset-and-statusline-workflows.md)
 - [Next Chapter: Chapter 7: GitHub Actions, Non-Interactive Mode, and Team Ops](07-github-actions-non-interactive-mode-and-team-ops.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/claude-code-router-tutorial/07-github-actions-non-interactive-mode-and-team-ops.md b/tutorials/claude-code-router-tutorial/07-github-actions-non-interactive-mode-and-team-ops.md
index 9d91309e..6f5eb66c 100644
--- a/tutorials/claude-code-router-tutorial/07-github-actions-non-interactive-mode-and-team-ops.md
+++ b/tutorials/claude-code-router-tutorial/07-github-actions-non-interactive-mode-and-team-ops.md
@@ -627,7 +627,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Server Deployment and API Integration](06-server-deployment-and-api-integration.md)
 - [Next Chapter: Chapter 8: Troubleshooting, Security, and Contribution Workflow](08-troubleshooting-security-and-contribution-workflow.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/claude-code-router-tutorial/08-troubleshooting-security-and-contribution-workflow.md b/tutorials/claude-code-router-tutorial/08-troubleshooting-security-and-contribution-workflow.md
index 6536193c..ddeccf61 100644
--- a/tutorials/claude-code-router-tutorial/08-troubleshooting-security-and-contribution-workflow.md
+++ b/tutorials/claude-code-router-tutorial/08-troubleshooting-security-and-contribution-workflow.md
@@ -632,7 +632,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: GitHub Actions, Non-Interactive Mode, and Team Ops](07-github-actions-non-interactive-mode-and-team-ops.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/claude-code-router-tutorial/index.md b/tutorials/claude-code-router-tutorial/README.md
similarity index 100%
rename from tutorials/claude-code-router-tutorial/index.md
rename to tutorials/claude-code-router-tutorial/README.md
diff --git a/tutorials/claude-code-tutorial/01-getting-started.md b/tutorials/claude-code-tutorial/01-getting-started.md
index 29e1a2c1..7c2d6450 100644
--- a/tutorials/claude-code-tutorial/01-getting-started.md
+++ b/tutorials/claude-code-tutorial/01-getting-started.md
@@ -693,7 +693,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Basic Commands - Essential Claude Code Operations](02-basic-commands.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/claude-code-tutorial/02-basic-commands.md b/tutorials/claude-code-tutorial/02-basic-commands.md
index 67577a1c..44f2c084 100644
--- a/tutorials/claude-code-tutorial/02-basic-commands.md
+++ b/tutorials/claude-code-tutorial/02-basic-commands.md
@@ -690,7 +690,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started with Claude Code](01-getting-started.md)
 - [Next Chapter: Chapter 3: Code Understanding - How Claude Analyzes Your Codebase](03-code-understanding.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/claude-code-tutorial/03-code-understanding.md b/tutorials/claude-code-tutorial/03-code-understanding.md
index c59409fd..bd03b2d3 100644
--- a/tutorials/claude-code-tutorial/03-code-understanding.md
+++ b/tutorials/claude-code-tutorial/03-code-understanding.md
@@ -689,7 +689,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Basic Commands - Essential Claude Code Operations](02-basic-commands.md)
 - [Next Chapter: Chapter 4: File Editing - Making Changes Across Your Project](04-file-editing.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/claude-code-tutorial/04-file-editing.md b/tutorials/claude-code-tutorial/04-file-editing.md
index 17a8ebe3..7ca487d5 100644
--- a/tutorials/claude-code-tutorial/04-file-editing.md
+++ b/tutorials/claude-code-tutorial/04-file-editing.md
@@ -669,7 +669,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Code Understanding - How Claude Analyzes Your Codebase](03-code-understanding.md)
 - [Next Chapter: Chapter 5: Command Execution - Running Tests, Builds, and Scripts](05-commands.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/claude-code-tutorial/05-commands.md b/tutorials/claude-code-tutorial/05-commands.md
index 72615b96..8cd62ce7 100644
--- a/tutorials/claude-code-tutorial/05-commands.md
+++ b/tutorials/claude-code-tutorial/05-commands.md
@@ -648,7 +648,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: File Editing - Making Changes Across Your Project](04-file-editing.md)
 - [Next Chapter: Chapter 6: Git Workflows - Commits, Branches, and Version Control](06-git.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/claude-code-tutorial/06-git.md b/tutorials/claude-code-tutorial/06-git.md
index 0621b7f0..1d32845c 100644
--- a/tutorials/claude-code-tutorial/06-git.md
+++ b/tutorials/claude-code-tutorial/06-git.md
@@ -704,7 +704,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Command Execution - Running Tests, Builds, and Scripts](05-commands.md)
 - [Next Chapter: Chapter 7: MCP Integration - Extending Claude Code with Custom Tools](07-mcp.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/claude-code-tutorial/07-mcp.md b/tutorials/claude-code-tutorial/07-mcp.md
index 7775b5eb..b5d9f3c4 100644
--- a/tutorials/claude-code-tutorial/07-mcp.md
+++ b/tutorials/claude-code-tutorial/07-mcp.md
@@ -1138,7 +1138,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Git Workflows - Commits, Branches, and Version Control](06-git.md)
 - [Next Chapter: Chapter 8: Advanced Workflows - Complex Development Patterns and Automation](08-advanced.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/claude-code-tutorial/08-advanced.md b/tutorials/claude-code-tutorial/08-advanced.md
index dee0d680..f357c19b 100644
--- a/tutorials/claude-code-tutorial/08-advanced.md
+++ b/tutorials/claude-code-tutorial/08-advanced.md
@@ -739,7 +739,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: MCP Integration - Extending Claude Code with Custom Tools](07-mcp.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/claude-code-tutorial/index.md b/tutorials/claude-code-tutorial/README.md
similarity index 100%
rename from tutorials/claude-code-tutorial/index.md
rename to tutorials/claude-code-tutorial/README.md
diff --git a/tutorials/claude-flow-tutorial/01-getting-started.md b/tutorials/claude-flow-tutorial/01-getting-started.md
index f5d72d8d..7f0aa0f8 100644
--- a/tutorials/claude-flow-tutorial/01-getting-started.md
+++ b/tutorials/claude-flow-tutorial/01-getting-started.md
@@ -637,7 +637,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: V3 Architecture and ADRs](02-v3-architecture-and-adrs.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/claude-flow-tutorial/02-v3-architecture-and-adrs.md b/tutorials/claude-flow-tutorial/02-v3-architecture-and-adrs.md
index 9c6ddb35..b4aef7b4 100644
--- a/tutorials/claude-flow-tutorial/02-v3-architecture-and-adrs.md
+++ b/tutorials/claude-flow-tutorial/02-v3-architecture-and-adrs.md
@@ -633,7 +633,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started](01-getting-started.md)
 - [Next Chapter: Chapter 3: Swarm Coordination and Consensus Patterns](03-swarm-coordination-and-consensus-patterns.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/claude-flow-tutorial/03-swarm-coordination-and-consensus-patterns.md b/tutorials/claude-flow-tutorial/03-swarm-coordination-and-consensus-patterns.md
index 0bd8f3c8..421b8b03 100644
--- a/tutorials/claude-flow-tutorial/03-swarm-coordination-and-consensus-patterns.md
+++ b/tutorials/claude-flow-tutorial/03-swarm-coordination-and-consensus-patterns.md
@@ -633,7 +633,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: V3 Architecture and ADRs](02-v3-architecture-and-adrs.md)
 - [Next Chapter: Chapter 4: Memory, Learning, and Intelligence Systems](04-memory-learning-and-intelligence-systems.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/claude-flow-tutorial/04-memory-learning-and-intelligence-systems.md b/tutorials/claude-flow-tutorial/04-memory-learning-and-intelligence-systems.md
index a38c6aa6..a9acad15 100644
--- a/tutorials/claude-flow-tutorial/04-memory-learning-and-intelligence-systems.md
+++ b/tutorials/claude-flow-tutorial/04-memory-learning-and-intelligence-systems.md
@@ -633,7 +633,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Swarm Coordination and Consensus Patterns](03-swarm-coordination-and-consensus-patterns.md)
 - [Next Chapter: Chapter 5: MCP Server, CLI, and Runtime Operations](05-mcp-server-cli-and-runtime-operations.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/claude-flow-tutorial/05-mcp-server-cli-and-runtime-operations.md b/tutorials/claude-flow-tutorial/05-mcp-server-cli-and-runtime-operations.md
index aaf3e9c5..ee630ac5 100644
--- a/tutorials/claude-flow-tutorial/05-mcp-server-cli-and-runtime-operations.md
+++ b/tutorials/claude-flow-tutorial/05-mcp-server-cli-and-runtime-operations.md
@@ -633,7 +633,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Memory, Learning, and Intelligence Systems](04-memory-learning-and-intelligence-systems.md)
 - [Next Chapter: Chapter 6: Plugin SDK and Extensibility Patterns](06-plugin-sdk-and-extensibility-patterns.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/claude-flow-tutorial/06-plugin-sdk-and-extensibility-patterns.md b/tutorials/claude-flow-tutorial/06-plugin-sdk-and-extensibility-patterns.md
index 804d2e30..7f203200 100644
--- a/tutorials/claude-flow-tutorial/06-plugin-sdk-and-extensibility-patterns.md
+++ b/tutorials/claude-flow-tutorial/06-plugin-sdk-and-extensibility-patterns.md
@@ -633,7 +633,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: MCP Server, CLI, and Runtime Operations](05-mcp-server-cli-and-runtime-operations.md)
 - [Next Chapter: Chapter 7: Testing, Migration, and Upgrade Strategy](07-testing-migration-and-upgrade-strategy.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/claude-flow-tutorial/07-testing-migration-and-upgrade-strategy.md b/tutorials/claude-flow-tutorial/07-testing-migration-and-upgrade-strategy.md
index 4f2cf74f..f7792f88 100644
--- a/tutorials/claude-flow-tutorial/07-testing-migration-and-upgrade-strategy.md
+++ b/tutorials/claude-flow-tutorial/07-testing-migration-and-upgrade-strategy.md
@@ -633,7 +633,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Plugin SDK and Extensibility Patterns](06-plugin-sdk-and-extensibility-patterns.md)
 - [Next Chapter: Chapter 8: Production Governance, Security, and Performance](08-production-governance-security-and-performance.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/claude-flow-tutorial/08-production-governance-security-and-performance.md b/tutorials/claude-flow-tutorial/08-production-governance-security-and-performance.md
index 1e07f4f0..d24c07c8 100644
--- a/tutorials/claude-flow-tutorial/08-production-governance-security-and-performance.md
+++ b/tutorials/claude-flow-tutorial/08-production-governance-security-and-performance.md
@@ -635,7 +635,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Testing, Migration, and Upgrade Strategy](07-testing-migration-and-upgrade-strategy.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/claude-flow-tutorial/index.md b/tutorials/claude-flow-tutorial/README.md
similarity index 100%
rename from tutorials/claude-flow-tutorial/index.md
rename to tutorials/claude-flow-tutorial/README.md
diff --git a/tutorials/claude-mem-tutorial/01-getting-started.md b/tutorials/claude-mem-tutorial/01-getting-started.md
index 340fc6d7..3dcdda09 100644
--- a/tutorials/claude-mem-tutorial/01-getting-started.md
+++ b/tutorials/claude-mem-tutorial/01-getting-started.md
@@ -636,7 +636,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Architecture, Hooks, and Worker Flow](02-architecture-hooks-and-worker-flow.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/claude-mem-tutorial/02-architecture-hooks-and-worker-flow.md b/tutorials/claude-mem-tutorial/02-architecture-hooks-and-worker-flow.md
index ac5476d6..639ff32f 100644
--- a/tutorials/claude-mem-tutorial/02-architecture-hooks-and-worker-flow.md
+++ b/tutorials/claude-mem-tutorial/02-architecture-hooks-and-worker-flow.md
@@ -637,7 +637,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started](01-getting-started.md)
 - [Next Chapter: Chapter 3: Installation, Upgrade, and Runtime Environment](03-installation-upgrade-and-runtime-environment.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/claude-mem-tutorial/03-installation-upgrade-and-runtime-environment.md b/tutorials/claude-mem-tutorial/03-installation-upgrade-and-runtime-environment.md
index 8f0f4b7f..0ace1fd4 100644
--- a/tutorials/claude-mem-tutorial/03-installation-upgrade-and-runtime-environment.md
+++ b/tutorials/claude-mem-tutorial/03-installation-upgrade-and-runtime-environment.md
@@ -630,7 +630,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Architecture, Hooks, and Worker Flow](02-architecture-hooks-and-worker-flow.md)
 - [Next Chapter: Chapter 4: Configuration, Modes, and Context Injection](04-configuration-modes-and-context-injection.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/claude-mem-tutorial/04-configuration-modes-and-context-injection.md b/tutorials/claude-mem-tutorial/04-configuration-modes-and-context-injection.md
index 0327aa8a..5b684465 100644
--- a/tutorials/claude-mem-tutorial/04-configuration-modes-and-context-injection.md
+++ b/tutorials/claude-mem-tutorial/04-configuration-modes-and-context-injection.md
@@ -633,7 +633,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Installation, Upgrade, and Runtime Environment](03-installation-upgrade-and-runtime-environment.md)
 - [Next Chapter: Chapter 5: Search Tools and Progressive Disclosure](05-search-tools-and-progressive-disclosure.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/claude-mem-tutorial/05-search-tools-and-progressive-disclosure.md b/tutorials/claude-mem-tutorial/05-search-tools-and-progressive-disclosure.md
index f76804b1..db63ac19 100644
--- a/tutorials/claude-mem-tutorial/05-search-tools-and-progressive-disclosure.md
+++ b/tutorials/claude-mem-tutorial/05-search-tools-and-progressive-disclosure.md
@@ -634,7 +634,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Configuration, Modes, and Context Injection](04-configuration-modes-and-context-injection.md)
 - [Next Chapter: Chapter 6: Viewer Operations and Maintenance Workflows](06-viewer-operations-and-maintenance-workflows.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/claude-mem-tutorial/06-viewer-operations-and-maintenance-workflows.md b/tutorials/claude-mem-tutorial/06-viewer-operations-and-maintenance-workflows.md
index d48cc365..26562fe4 100644
--- a/tutorials/claude-mem-tutorial/06-viewer-operations-and-maintenance-workflows.md
+++ b/tutorials/claude-mem-tutorial/06-viewer-operations-and-maintenance-workflows.md
@@ -634,7 +634,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Search Tools and Progressive Disclosure](05-search-tools-and-progressive-disclosure.md)
 - [Next Chapter: Chapter 7: Troubleshooting, Recovery, and Reliability](07-troubleshooting-recovery-and-reliability.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/claude-mem-tutorial/07-troubleshooting-recovery-and-reliability.md b/tutorials/claude-mem-tutorial/07-troubleshooting-recovery-and-reliability.md
index 40bc53cd..5819ea2e 100644
--- a/tutorials/claude-mem-tutorial/07-troubleshooting-recovery-and-reliability.md
+++ b/tutorials/claude-mem-tutorial/07-troubleshooting-recovery-and-reliability.md
@@ -634,7 +634,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Viewer Operations and Maintenance Workflows](06-viewer-operations-and-maintenance-workflows.md)
 - [Next Chapter: Chapter 8: Contribution Workflow and Governance](08-contribution-workflow-and-governance.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/claude-mem-tutorial/08-contribution-workflow-and-governance.md b/tutorials/claude-mem-tutorial/08-contribution-workflow-and-governance.md
index df619c76..4561b274 100644
--- a/tutorials/claude-mem-tutorial/08-contribution-workflow-and-governance.md
+++ b/tutorials/claude-mem-tutorial/08-contribution-workflow-and-governance.md
@@ -627,7 +627,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Troubleshooting, Recovery, and Reliability](07-troubleshooting-recovery-and-reliability.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/claude-mem-tutorial/index.md b/tutorials/claude-mem-tutorial/README.md
similarity index 100%
rename from tutorials/claude-mem-tutorial/index.md
rename to tutorials/claude-mem-tutorial/README.md
diff --git a/tutorials/claude-plugins-official-tutorial/01-getting-started.md b/tutorials/claude-plugins-official-tutorial/01-getting-started.md
index 6cb41314..1891c90b 100644
--- a/tutorials/claude-plugins-official-tutorial/01-getting-started.md
+++ b/tutorials/claude-plugins-official-tutorial/01-getting-started.md
@@ -633,7 +633,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Directory Architecture and Marketplace Model](02-directory-architecture-and-marketplace-model.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/claude-plugins-official-tutorial/02-directory-architecture-and-marketplace-model.md b/tutorials/claude-plugins-official-tutorial/02-directory-architecture-and-marketplace-model.md
index a94763a4..30f59490 100644
--- a/tutorials/claude-plugins-official-tutorial/02-directory-architecture-and-marketplace-model.md
+++ b/tutorials/claude-plugins-official-tutorial/02-directory-architecture-and-marketplace-model.md
@@ -633,7 +633,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started](01-getting-started.md)
 - [Next Chapter: Chapter 3: Plugin Manifest and Structural Contracts](03-plugin-manifest-and-structural-contracts.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/claude-plugins-official-tutorial/03-plugin-manifest-and-structural-contracts.md b/tutorials/claude-plugins-official-tutorial/03-plugin-manifest-and-structural-contracts.md
index 5d45caea..8e82bb5c 100644
--- a/tutorials/claude-plugins-official-tutorial/03-plugin-manifest-and-structural-contracts.md
+++ b/tutorials/claude-plugins-official-tutorial/03-plugin-manifest-and-structural-contracts.md
@@ -626,7 +626,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Directory Architecture and Marketplace Model](02-directory-architecture-and-marketplace-model.md)
 - [Next Chapter: Chapter 4: Commands, Agents, Skills, Hooks, and MCP Composition](04-commands-agents-skills-hooks-and-mcp-composition.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/claude-plugins-official-tutorial/04-commands-agents-skills-hooks-and-mcp-composition.md b/tutorials/claude-plugins-official-tutorial/04-commands-agents-skills-hooks-and-mcp-composition.md
index 880f7726..5340b071 100644
--- a/tutorials/claude-plugins-official-tutorial/04-commands-agents-skills-hooks-and-mcp-composition.md
+++ b/tutorials/claude-plugins-official-tutorial/04-commands-agents-skills-hooks-and-mcp-composition.md
@@ -635,7 +635,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Plugin Manifest and Structural Contracts](03-plugin-manifest-and-structural-contracts.md)
 - [Next Chapter: Chapter 5: Trust, Security, and Risk Controls](05-trust-security-and-risk-controls.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/claude-plugins-official-tutorial/05-trust-security-and-risk-controls.md b/tutorials/claude-plugins-official-tutorial/05-trust-security-and-risk-controls.md
index a2a323a2..a2006997 100644
--- a/tutorials/claude-plugins-official-tutorial/05-trust-security-and-risk-controls.md
+++ b/tutorials/claude-plugins-official-tutorial/05-trust-security-and-risk-controls.md
@@ -633,7 +633,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Commands, Agents, Skills, Hooks, and MCP Composition](04-commands-agents-skills-hooks-and-mcp-composition.md)
 - [Next Chapter: Chapter 6: Installation, Operations, and Update Strategy](06-installation-operations-and-update-strategy.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/claude-plugins-official-tutorial/06-installation-operations-and-update-strategy.md b/tutorials/claude-plugins-official-tutorial/06-installation-operations-and-update-strategy.md
index dc96372c..0ab7f784 100644
--- a/tutorials/claude-plugins-official-tutorial/06-installation-operations-and-update-strategy.md
+++ b/tutorials/claude-plugins-official-tutorial/06-installation-operations-and-update-strategy.md
@@ -633,7 +633,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Trust, Security, and Risk Controls](05-trust-security-and-risk-controls.md)
 - [Next Chapter: Chapter 7: Submission and Contribution Workflow](07-submission-and-contribution-workflow.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/claude-plugins-official-tutorial/07-submission-and-contribution-workflow.md b/tutorials/claude-plugins-official-tutorial/07-submission-and-contribution-workflow.md
index 8cd8517e..5ff1bf8e 100644
--- a/tutorials/claude-plugins-official-tutorial/07-submission-and-contribution-workflow.md
+++ b/tutorials/claude-plugins-official-tutorial/07-submission-and-contribution-workflow.md
@@ -632,7 +632,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Installation, Operations, and Update Strategy](06-installation-operations-and-update-strategy.md)
 - [Next Chapter: Chapter 8: Governance and Enterprise Plugin Portfolio Management](08-governance-and-enterprise-plugin-portfolio-management.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/claude-plugins-official-tutorial/08-governance-and-enterprise-plugin-portfolio-management.md b/tutorials/claude-plugins-official-tutorial/08-governance-and-enterprise-plugin-portfolio-management.md
index a2aee57a..a6567312 100644
--- a/tutorials/claude-plugins-official-tutorial/08-governance-and-enterprise-plugin-portfolio-management.md
+++ b/tutorials/claude-plugins-official-tutorial/08-governance-and-enterprise-plugin-portfolio-management.md
@@ -637,7 +637,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Submission and Contribution Workflow](07-submission-and-contribution-workflow.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/claude-plugins-official-tutorial/index.md b/tutorials/claude-plugins-official-tutorial/README.md
similarity index 100%
rename from tutorials/claude-plugins-official-tutorial/index.md
rename to tutorials/claude-plugins-official-tutorial/README.md
diff --git a/tutorials/claude-quickstarts-tutorial/01-getting-started.md b/tutorials/claude-quickstarts-tutorial/01-getting-started.md
index 715e91ff..1df3345d 100644
--- a/tutorials/claude-quickstarts-tutorial/01-getting-started.md
+++ b/tutorials/claude-quickstarts-tutorial/01-getting-started.md
@@ -85,7 +85,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Customer Support Agents](02-customer-support-agents.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/claude-quickstarts-tutorial/02-customer-support-agents.md b/tutorials/claude-quickstarts-tutorial/02-customer-support-agents.md
index b9227432..cad525c6 100644
--- a/tutorials/claude-quickstarts-tutorial/02-customer-support-agents.md
+++ b/tutorials/claude-quickstarts-tutorial/02-customer-support-agents.md
@@ -84,7 +84,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started](01-getting-started.md)
 - [Next Chapter: Chapter 3: Data Processing and Analysis](03-data-processing-analysis.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/claude-quickstarts-tutorial/03-data-processing-analysis.md b/tutorials/claude-quickstarts-tutorial/03-data-processing-analysis.md
index 188116b8..b26c1076 100644
--- a/tutorials/claude-quickstarts-tutorial/03-data-processing-analysis.md
+++ b/tutorials/claude-quickstarts-tutorial/03-data-processing-analysis.md
@@ -81,7 +81,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Customer Support Agents](02-customer-support-agents.md)
 - [Next Chapter: Chapter 4: Browser and Computer Use](04-browser-computer-use.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/claude-quickstarts-tutorial/04-browser-computer-use.md b/tutorials/claude-quickstarts-tutorial/04-browser-computer-use.md
index 712d1d8f..5a0dd584 100644
--- a/tutorials/claude-quickstarts-tutorial/04-browser-computer-use.md
+++ b/tutorials/claude-quickstarts-tutorial/04-browser-computer-use.md
@@ -106,7 +106,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Data Processing and Analysis](03-data-processing-analysis.md)
 - [Next Chapter: Chapter 5: Autonomous Coding Agents](05-autonomous-coding-agents.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/claude-quickstarts-tutorial/05-autonomous-coding-agents.md b/tutorials/claude-quickstarts-tutorial/05-autonomous-coding-agents.md
index 238d7b12..a025accd 100644
--- a/tutorials/claude-quickstarts-tutorial/05-autonomous-coding-agents.md
+++ b/tutorials/claude-quickstarts-tutorial/05-autonomous-coding-agents.md
@@ -104,7 +104,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Browser and Computer Use](04-browser-computer-use.md)
 - [Next Chapter: Chapter 6: Production Patterns](06-production-patterns.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/claude-quickstarts-tutorial/06-production-patterns.md b/tutorials/claude-quickstarts-tutorial/06-production-patterns.md
index a5b780f8..c0570f1b 100644
--- a/tutorials/claude-quickstarts-tutorial/06-production-patterns.md
+++ b/tutorials/claude-quickstarts-tutorial/06-production-patterns.md
@@ -80,7 +80,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Autonomous Coding Agents](05-autonomous-coding-agents.md)
 - [Next Chapter: Chapter 7: Evaluation and Guardrails](07-evaluation-guardrails.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/claude-quickstarts-tutorial/07-evaluation-guardrails.md b/tutorials/claude-quickstarts-tutorial/07-evaluation-guardrails.md
index ec002b86..13b2c9b9 100644
--- a/tutorials/claude-quickstarts-tutorial/07-evaluation-guardrails.md
+++ b/tutorials/claude-quickstarts-tutorial/07-evaluation-guardrails.md
@@ -76,7 +76,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Production Patterns](06-production-patterns.md)
 - [Next Chapter: Chapter 8: Enterprise Operations](08-enterprise-operations.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/claude-quickstarts-tutorial/08-enterprise-operations.md b/tutorials/claude-quickstarts-tutorial/08-enterprise-operations.md
index 51e9e02f..575ad390 100644
--- a/tutorials/claude-quickstarts-tutorial/08-enterprise-operations.md
+++ b/tutorials/claude-quickstarts-tutorial/08-enterprise-operations.md
@@ -102,7 +102,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Evaluation and Guardrails](07-evaluation-guardrails.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/claude-quickstarts-tutorial/index.md b/tutorials/claude-quickstarts-tutorial/README.md
similarity index 100%
rename from tutorials/claude-quickstarts-tutorial/index.md
rename to tutorials/claude-quickstarts-tutorial/README.md
diff --git a/tutorials/claude-squad-tutorial/01-getting-started.md b/tutorials/claude-squad-tutorial/01-getting-started.md
index 4b03e5d8..f4610a91 100644
--- a/tutorials/claude-squad-tutorial/01-getting-started.md
+++ b/tutorials/claude-squad-tutorial/01-getting-started.md
@@ -639,7 +639,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: tmux and Worktree Architecture](02-tmux-and-worktree-architecture.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/claude-squad-tutorial/02-tmux-and-worktree-architecture.md b/tutorials/claude-squad-tutorial/02-tmux-and-worktree-architecture.md
index 9f73b4eb..1ab61f39 100644
--- a/tutorials/claude-squad-tutorial/02-tmux-and-worktree-architecture.md
+++ b/tutorials/claude-squad-tutorial/02-tmux-and-worktree-architecture.md
@@ -626,7 +626,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started](01-getting-started.md)
 - [Next Chapter: Chapter 3: Session Lifecycle and Task Parallelism](03-session-lifecycle-and-task-parallelism.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/claude-squad-tutorial/03-session-lifecycle-and-task-parallelism.md b/tutorials/claude-squad-tutorial/03-session-lifecycle-and-task-parallelism.md
index a8d89aa3..ec67d036 100644
--- a/tutorials/claude-squad-tutorial/03-session-lifecycle-and-task-parallelism.md
+++ b/tutorials/claude-squad-tutorial/03-session-lifecycle-and-task-parallelism.md
@@ -634,7 +634,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: tmux and Worktree Architecture](02-tmux-and-worktree-architecture.md)
 - [Next Chapter: Chapter 4: Multi-Agent Program Integration](04-multi-agent-program-integration.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/claude-squad-tutorial/04-multi-agent-program-integration.md b/tutorials/claude-squad-tutorial/04-multi-agent-program-integration.md
index 737fcb43..1991c234 100644
--- a/tutorials/claude-squad-tutorial/04-multi-agent-program-integration.md
+++ b/tutorials/claude-squad-tutorial/04-multi-agent-program-integration.md
@@ -626,7 +626,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Session Lifecycle and Task Parallelism](03-session-lifecycle-and-task-parallelism.md)
 - [Next Chapter: Chapter 5: Review, Checkout, and Push Workflow](05-review-checkout-and-push-workflow.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/claude-squad-tutorial/05-review-checkout-and-push-workflow.md b/tutorials/claude-squad-tutorial/05-review-checkout-and-push-workflow.md
index 168d8e7c..332e4404 100644
--- a/tutorials/claude-squad-tutorial/05-review-checkout-and-push-workflow.md
+++ b/tutorials/claude-squad-tutorial/05-review-checkout-and-push-workflow.md
@@ -636,7 +636,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Multi-Agent Program Integration](04-multi-agent-program-integration.md)
 - [Next Chapter: Chapter 6: AutoYes, Daemon Polling, and Safety Controls](06-autoyes-daemon-polling-and-safety-controls.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/claude-squad-tutorial/06-autoyes-daemon-polling-and-safety-controls.md b/tutorials/claude-squad-tutorial/06-autoyes-daemon-polling-and-safety-controls.md
index 9fad1b69..57536f4a 100644
--- a/tutorials/claude-squad-tutorial/06-autoyes-daemon-polling-and-safety-controls.md
+++ b/tutorials/claude-squad-tutorial/06-autoyes-daemon-polling-and-safety-controls.md
@@ -630,7 +630,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Review, Checkout, and Push Workflow](05-review-checkout-and-push-workflow.md)
 - [Next Chapter: Chapter 7: Configuration and State Management](07-configuration-and-state-management.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/claude-squad-tutorial/07-configuration-and-state-management.md b/tutorials/claude-squad-tutorial/07-configuration-and-state-management.md
index 9f2deeba..1ee39f67 100644
--- a/tutorials/claude-squad-tutorial/07-configuration-and-state-management.md
+++ b/tutorials/claude-squad-tutorial/07-configuration-and-state-management.md
@@ -636,7 +636,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: AutoYes, Daemon Polling, and Safety Controls](06-autoyes-daemon-polling-and-safety-controls.md)
 - [Next Chapter: Chapter 8: Production Team Operations](08-production-team-operations.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/claude-squad-tutorial/08-production-team-operations.md b/tutorials/claude-squad-tutorial/08-production-team-operations.md
index 8a35f110..2861c3c9 100644
--- a/tutorials/claude-squad-tutorial/08-production-team-operations.md
+++ b/tutorials/claude-squad-tutorial/08-production-team-operations.md
@@ -630,7 +630,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Configuration and State Management](07-configuration-and-state-management.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/claude-squad-tutorial/index.md b/tutorials/claude-squad-tutorial/README.md
similarity index 100%
rename from tutorials/claude-squad-tutorial/index.md
rename to tutorials/claude-squad-tutorial/README.md
diff --git a/tutorials/claude-task-master-tutorial/01-getting-started.md b/tutorials/claude-task-master-tutorial/01-getting-started.md
index 06dc6b79..de0864c3 100644
--- a/tutorials/claude-task-master-tutorial/01-getting-started.md
+++ b/tutorials/claude-task-master-tutorial/01-getting-started.md
@@ -548,7 +548,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: PRD Analysis & Task Generation](02-prd-analysis.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/claude-task-master-tutorial/02-prd-analysis.md b/tutorials/claude-task-master-tutorial/02-prd-analysis.md
index 655cb0d0..ee699f18 100644
--- a/tutorials/claude-task-master-tutorial/02-prd-analysis.md
+++ b/tutorials/claude-task-master-tutorial/02-prd-analysis.md
@@ -613,7 +613,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started with Claude Task Master](01-getting-started.md)
 - [Next Chapter: Chapter 3: Task Management & Execution](03-task-management.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/claude-task-master-tutorial/03-task-management.md b/tutorials/claude-task-master-tutorial/03-task-management.md
index c017d16c..771bde1a 100644
--- a/tutorials/claude-task-master-tutorial/03-task-management.md
+++ b/tutorials/claude-task-master-tutorial/03-task-management.md
@@ -510,7 +510,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: PRD Analysis & Task Generation](02-prd-analysis.md)
 - [Next Chapter: Chapter 4: Multi-Model Integration](04-multi-model-integration.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/claude-task-master-tutorial/04-multi-model-integration.md b/tutorials/claude-task-master-tutorial/04-multi-model-integration.md
index 952635a4..2ee60800 100644
--- a/tutorials/claude-task-master-tutorial/04-multi-model-integration.md
+++ b/tutorials/claude-task-master-tutorial/04-multi-model-integration.md
@@ -535,7 +535,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Task Management & Execution](03-task-management.md)
 - [Next Chapter: Chapter 5: Editor Integrations](05-editor-integrations.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/claude-task-master-tutorial/05-editor-integrations.md b/tutorials/claude-task-master-tutorial/05-editor-integrations.md
index b4556a5f..411bd069 100644
--- a/tutorials/claude-task-master-tutorial/05-editor-integrations.md
+++ b/tutorials/claude-task-master-tutorial/05-editor-integrations.md
@@ -523,7 +523,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Multi-Model Integration](04-multi-model-integration.md)
 - [Next Chapter: Chapter 6: Context Management & Grounding](06-context-control.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/claude-task-master-tutorial/06-context-control.md b/tutorials/claude-task-master-tutorial/06-context-control.md
index ef7bc45a..0c8baebe 100644
--- a/tutorials/claude-task-master-tutorial/06-context-control.md
+++ b/tutorials/claude-task-master-tutorial/06-context-control.md
@@ -488,7 +488,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Editor Integrations](05-editor-integrations.md)
 - [Next Chapter: Chapter 7: Automation, CI/CD, and Guardrails](07-automation.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/claude-task-master-tutorial/07-automation.md b/tutorials/claude-task-master-tutorial/07-automation.md
index 67c9efa9..17459a66 100644
--- a/tutorials/claude-task-master-tutorial/07-automation.md
+++ b/tutorials/claude-task-master-tutorial/07-automation.md
@@ -587,7 +587,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Context Management & Grounding](06-context-control.md)
 - [Next Chapter: Chapter 8: Production Hardening, Cost, and Reliability](08-production.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/claude-task-master-tutorial/08-production.md b/tutorials/claude-task-master-tutorial/08-production.md
index 94b3f61e..5d74de4d 100644
--- a/tutorials/claude-task-master-tutorial/08-production.md
+++ b/tutorials/claude-task-master-tutorial/08-production.md
@@ -696,7 +696,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Automation, CI/CD, and Guardrails](07-automation.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/claude-task-master-tutorial/index.md b/tutorials/claude-task-master-tutorial/README.md
similarity index 100%
rename from tutorials/claude-task-master-tutorial/index.md
rename to tutorials/claude-task-master-tutorial/README.md
diff --git a/tutorials/clickhouse-tutorial/01-getting-started.md b/tutorials/clickhouse-tutorial/01-getting-started.md
index 56df4c45..b44770cd 100644
--- a/tutorials/clickhouse-tutorial/01-getting-started.md
+++ b/tutorials/clickhouse-tutorial/01-getting-started.md
@@ -549,7 +549,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Data Modeling & Schemas](02-data-modeling.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/clickhouse-tutorial/02-data-modeling.md b/tutorials/clickhouse-tutorial/02-data-modeling.md
index d4fa286b..c901dbe3 100644
--- a/tutorials/clickhouse-tutorial/02-data-modeling.md
+++ b/tutorials/clickhouse-tutorial/02-data-modeling.md
@@ -520,7 +520,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started with ClickHouse](01-getting-started.md)
 - [Next Chapter: Chapter 3: Data Ingestion & ETL](03-data-ingestion.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/clickhouse-tutorial/03-data-ingestion.md b/tutorials/clickhouse-tutorial/03-data-ingestion.md
index c6f9d47b..f1b8b2b8 100644
--- a/tutorials/clickhouse-tutorial/03-data-ingestion.md
+++ b/tutorials/clickhouse-tutorial/03-data-ingestion.md
@@ -541,7 +541,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Data Modeling & Schemas](02-data-modeling.md)
 - [Next Chapter: Chapter 4: Query Optimization](04-query-optimization.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/clickhouse-tutorial/04-query-optimization.md b/tutorials/clickhouse-tutorial/04-query-optimization.md
index 508bf95d..e7673592 100644
--- a/tutorials/clickhouse-tutorial/04-query-optimization.md
+++ b/tutorials/clickhouse-tutorial/04-query-optimization.md
@@ -516,7 +516,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Data Ingestion & ETL](03-data-ingestion.md)
 - [Next Chapter: Chapter 5: Aggregation & Analytics](05-aggregation-analytics.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/clickhouse-tutorial/05-aggregation-analytics.md b/tutorials/clickhouse-tutorial/05-aggregation-analytics.md
index 928c0f67..8d10c695 100644
--- a/tutorials/clickhouse-tutorial/05-aggregation-analytics.md
+++ b/tutorials/clickhouse-tutorial/05-aggregation-analytics.md
@@ -544,7 +544,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Query Optimization](04-query-optimization.md)
 - [Next Chapter: Chapter 6: Distributed ClickHouse](06-distributed-setup.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/clickhouse-tutorial/06-distributed-setup.md b/tutorials/clickhouse-tutorial/06-distributed-setup.md
index 99e63472..3525a91d 100644
--- a/tutorials/clickhouse-tutorial/06-distributed-setup.md
+++ b/tutorials/clickhouse-tutorial/06-distributed-setup.md
@@ -643,7 +643,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Aggregation & Analytics](05-aggregation-analytics.md)
 - [Next Chapter: Chapter 7: Performance Tuning](07-performance-tuning.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/clickhouse-tutorial/07-performance-tuning.md b/tutorials/clickhouse-tutorial/07-performance-tuning.md
index eeeea500..3e7a6059 100644
--- a/tutorials/clickhouse-tutorial/07-performance-tuning.md
+++ b/tutorials/clickhouse-tutorial/07-performance-tuning.md
@@ -657,7 +657,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Distributed ClickHouse](06-distributed-setup.md)
 - [Next Chapter: Chapter 8: Production Deployment](08-production-deployment.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/clickhouse-tutorial/08-production-deployment.md b/tutorials/clickhouse-tutorial/08-production-deployment.md
index f73a518f..a78c8ac0 100644
--- a/tutorials/clickhouse-tutorial/08-production-deployment.md
+++ b/tutorials/clickhouse-tutorial/08-production-deployment.md
@@ -841,7 +841,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Performance Tuning](07-performance-tuning.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/clickhouse-tutorial/index.md b/tutorials/clickhouse-tutorial/README.md
similarity index 100%
rename from tutorials/clickhouse-tutorial/index.md
rename to tutorials/clickhouse-tutorial/README.md
diff --git a/tutorials/cline-tutorial/01-getting-started.md b/tutorials/cline-tutorial/01-getting-started.md
index c21b5fa5..73446103 100644
--- a/tutorials/cline-tutorial/01-getting-started.md
+++ b/tutorials/cline-tutorial/01-getting-started.md
@@ -639,7 +639,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Agent Workflow](02-agent-workflow.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/cline-tutorial/02-agent-workflow.md b/tutorials/cline-tutorial/02-agent-workflow.md
index 0e8dd1d0..df4d012b 100644
--- a/tutorials/cline-tutorial/02-agent-workflow.md
+++ b/tutorials/cline-tutorial/02-agent-workflow.md
@@ -633,7 +633,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started](01-getting-started.md)
 - [Next Chapter: Chapter 3: File Editing and Diffs](03-file-editing-and-diffs.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/cline-tutorial/03-file-editing-and-diffs.md b/tutorials/cline-tutorial/03-file-editing-and-diffs.md
index cf5cc511..203ed418 100644
--- a/tutorials/cline-tutorial/03-file-editing-and-diffs.md
+++ b/tutorials/cline-tutorial/03-file-editing-and-diffs.md
@@ -630,7 +630,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Agent Workflow](02-agent-workflow.md)
 - [Next Chapter: Chapter 4: Terminal and Runtime Tools](04-terminal-and-runtime-tools.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/cline-tutorial/04-terminal-and-runtime-tools.md b/tutorials/cline-tutorial/04-terminal-and-runtime-tools.md
index c2aaba1b..60596bc6 100644
--- a/tutorials/cline-tutorial/04-terminal-and-runtime-tools.md
+++ b/tutorials/cline-tutorial/04-terminal-and-runtime-tools.md
@@ -637,7 +637,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: File Editing and Diffs](03-file-editing-and-diffs.md)
 - [Next Chapter: Chapter 5: Browser Automation](05-browser-automation.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/cline-tutorial/05-browser-automation.md b/tutorials/cline-tutorial/05-browser-automation.md
index e710cb65..0644130a 100644
--- a/tutorials/cline-tutorial/05-browser-automation.md
+++ b/tutorials/cline-tutorial/05-browser-automation.md
@@ -634,7 +634,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Terminal and Runtime Tools](04-terminal-and-runtime-tools.md)
 - [Next Chapter: Chapter 6: MCP and Custom Tools](06-mcp-and-custom-tools.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/cline-tutorial/06-mcp-and-custom-tools.md b/tutorials/cline-tutorial/06-mcp-and-custom-tools.md
index 1d1a3198..3ed3d494 100644
--- a/tutorials/cline-tutorial/06-mcp-and-custom-tools.md
+++ b/tutorials/cline-tutorial/06-mcp-and-custom-tools.md
@@ -630,7 +630,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Browser Automation](05-browser-automation.md)
 - [Next Chapter: Chapter 7: Context and Cost Control](07-context-and-cost-control.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/cline-tutorial/07-context-and-cost-control.md b/tutorials/cline-tutorial/07-context-and-cost-control.md
index 0cdcc401..bf2cb698 100644
--- a/tutorials/cline-tutorial/07-context-and-cost-control.md
+++ b/tutorials/cline-tutorial/07-context-and-cost-control.md
@@ -632,7 +632,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: MCP and Custom Tools](06-mcp-and-custom-tools.md)
 - [Next Chapter: Chapter 8: Team and Enterprise Operations](08-team-and-enterprise-operations.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/cline-tutorial/08-team-and-enterprise-operations.md b/tutorials/cline-tutorial/08-team-and-enterprise-operations.md
index 2ffea665..f74f0178 100644
--- a/tutorials/cline-tutorial/08-team-and-enterprise-operations.md
+++ b/tutorials/cline-tutorial/08-team-and-enterprise-operations.md
@@ -630,7 +630,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Context and Cost Control](07-context-and-cost-control.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/cline-tutorial/index.md b/tutorials/cline-tutorial/README.md
similarity index 100%
rename from tutorials/cline-tutorial/index.md
rename to tutorials/cline-tutorial/README.md
diff --git a/tutorials/codemachine-cli-tutorial/01-getting-started.md b/tutorials/codemachine-cli-tutorial/01-getting-started.md
index 790a70da..96678525 100644
--- a/tutorials/codemachine-cli-tutorial/01-getting-started.md
+++ b/tutorials/codemachine-cli-tutorial/01-getting-started.md
@@ -634,7 +634,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Orchestration Architecture](02-orchestration-architecture.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/codemachine-cli-tutorial/02-orchestration-architecture.md b/tutorials/codemachine-cli-tutorial/02-orchestration-architecture.md
index 9a457721..f9e7c9b6 100644
--- a/tutorials/codemachine-cli-tutorial/02-orchestration-architecture.md
+++ b/tutorials/codemachine-cli-tutorial/02-orchestration-architecture.md
@@ -622,7 +622,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started](01-getting-started.md)
 - [Next Chapter: Chapter 3: Workflow Design Patterns](03-workflow-design-patterns.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/codemachine-cli-tutorial/03-workflow-design-patterns.md b/tutorials/codemachine-cli-tutorial/03-workflow-design-patterns.md
index 1fbbd101..b165a870 100644
--- a/tutorials/codemachine-cli-tutorial/03-workflow-design-patterns.md
+++ b/tutorials/codemachine-cli-tutorial/03-workflow-design-patterns.md
@@ -633,7 +633,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Orchestration Architecture](02-orchestration-architecture.md)
 - [Next Chapter: Chapter 4: Multi-Agent and Parallel Execution](04-multi-agent-and-parallel-execution.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/codemachine-cli-tutorial/04-multi-agent-and-parallel-execution.md b/tutorials/codemachine-cli-tutorial/04-multi-agent-and-parallel-execution.md
index 44a0b46c..81301edb 100644
--- a/tutorials/codemachine-cli-tutorial/04-multi-agent-and-parallel-execution.md
+++ b/tutorials/codemachine-cli-tutorial/04-multi-agent-and-parallel-execution.md
@@ -631,7 +631,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Workflow Design Patterns](03-workflow-design-patterns.md)
 - [Next Chapter: Chapter 5: Context Engineering and State Control](05-context-engineering-and-state-control.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/codemachine-cli-tutorial/05-context-engineering-and-state-control.md b/tutorials/codemachine-cli-tutorial/05-context-engineering-and-state-control.md
index 9e69f1c2..e22124a7 100644
--- a/tutorials/codemachine-cli-tutorial/05-context-engineering-and-state-control.md
+++ b/tutorials/codemachine-cli-tutorial/05-context-engineering-and-state-control.md
@@ -633,7 +633,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Multi-Agent and Parallel Execution](04-multi-agent-and-parallel-execution.md)
 - [Next Chapter: Chapter 6: Persistence and Long-Running Jobs](06-persistence-and-long-running-jobs.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/codemachine-cli-tutorial/06-persistence-and-long-running-jobs.md b/tutorials/codemachine-cli-tutorial/06-persistence-and-long-running-jobs.md
index c395ab5c..5e769ac7 100644
--- a/tutorials/codemachine-cli-tutorial/06-persistence-and-long-running-jobs.md
+++ b/tutorials/codemachine-cli-tutorial/06-persistence-and-long-running-jobs.md
@@ -631,7 +631,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Context Engineering and State Control](05-context-engineering-and-state-control.md)
 - [Next Chapter: Chapter 7: Engine Integrations and Compatibility](07-engine-integrations-and-compatibility.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/codemachine-cli-tutorial/07-engine-integrations-and-compatibility.md b/tutorials/codemachine-cli-tutorial/07-engine-integrations-and-compatibility.md
index e5c4923a..f0cc5458 100644
--- a/tutorials/codemachine-cli-tutorial/07-engine-integrations-and-compatibility.md
+++ b/tutorials/codemachine-cli-tutorial/07-engine-integrations-and-compatibility.md
@@ -631,7 +631,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Persistence and Long-Running Jobs](06-persistence-and-long-running-jobs.md)
 - [Next Chapter: Chapter 8: Production Operations and Team Adoption](08-production-operations-and-team-adoption.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/codemachine-cli-tutorial/08-production-operations-and-team-adoption.md b/tutorials/codemachine-cli-tutorial/08-production-operations-and-team-adoption.md
index 14099134..6e045819 100644
--- a/tutorials/codemachine-cli-tutorial/08-production-operations-and-team-adoption.md
+++ b/tutorials/codemachine-cli-tutorial/08-production-operations-and-team-adoption.md
@@ -629,7 +629,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Engine Integrations and Compatibility](07-engine-integrations-and-compatibility.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/codemachine-cli-tutorial/index.md b/tutorials/codemachine-cli-tutorial/README.md
similarity index 100%
rename from tutorials/codemachine-cli-tutorial/index.md
rename to tutorials/codemachine-cli-tutorial/README.md
diff --git a/tutorials/codex-analysis-platform/01-analysis-engine.md b/tutorials/codex-analysis-platform/01-analysis-engine.md
index 435fc965..86c1175a 100644
--- a/tutorials/codex-analysis-platform/01-analysis-engine.md
+++ b/tutorials/codex-analysis-platform/01-analysis-engine.md
@@ -752,7 +752,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: AST Processing](02-ast-processing.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/codex-analysis-platform/02-ast-processing.md b/tutorials/codex-analysis-platform/02-ast-processing.md
index 9cbcf069..d0f9dc93 100644
--- a/tutorials/codex-analysis-platform/02-ast-processing.md
+++ b/tutorials/codex-analysis-platform/02-ast-processing.md
@@ -718,7 +718,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Building the Analysis Engine](01-analysis-engine.md)
 - [Next Chapter: Chapter 3: Symbol Resolution](03-symbol-resolution.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/codex-analysis-platform/03-symbol-resolution.md b/tutorials/codex-analysis-platform/03-symbol-resolution.md
index 39d39376..b037c00b 100644
--- a/tutorials/codex-analysis-platform/03-symbol-resolution.md
+++ b/tutorials/codex-analysis-platform/03-symbol-resolution.md
@@ -789,7 +789,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: AST Processing](02-ast-processing.md)
 - [Next Chapter: Chapter 4: Code Intelligence](04-code-intelligence.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/codex-analysis-platform/04-code-intelligence.md b/tutorials/codex-analysis-platform/04-code-intelligence.md
index 54720111..9e402d95 100644
--- a/tutorials/codex-analysis-platform/04-code-intelligence.md
+++ b/tutorials/codex-analysis-platform/04-code-intelligence.md
@@ -728,7 +728,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Symbol Resolution](03-symbol-resolution.md)
 - [Next Chapter: Chapter 5: LSP Implementation](05-lsp-implementation.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/codex-analysis-platform/05-lsp-implementation.md b/tutorials/codex-analysis-platform/05-lsp-implementation.md
index 20c6c893..9808e303 100644
--- a/tutorials/codex-analysis-platform/05-lsp-implementation.md
+++ b/tutorials/codex-analysis-platform/05-lsp-implementation.md
@@ -745,7 +745,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Code Intelligence](04-code-intelligence.md)
 - [Next Chapter: Chapter 6: Visualization](06-visualization.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/codex-analysis-platform/06-visualization.md b/tutorials/codex-analysis-platform/06-visualization.md
index 18cc1951..276c0611 100644
--- a/tutorials/codex-analysis-platform/06-visualization.md
+++ b/tutorials/codex-analysis-platform/06-visualization.md
@@ -699,7 +699,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: LSP Implementation](05-lsp-implementation.md)
 - [Next Chapter: Chapter 7: Automation Pipelines](07-automation-pipelines.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/codex-analysis-platform/07-automation-pipelines.md b/tutorials/codex-analysis-platform/07-automation-pipelines.md
index 578d7dfe..ba425225 100644
--- a/tutorials/codex-analysis-platform/07-automation-pipelines.md
+++ b/tutorials/codex-analysis-platform/07-automation-pipelines.md
@@ -633,7 +633,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Visualization](06-visualization.md)
 - [Next Chapter: Chapter 8: Production Rollout](08-production-rollout.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/codex-analysis-platform/08-production-rollout.md b/tutorials/codex-analysis-platform/08-production-rollout.md
index 55849bd5..5d967a08 100644
--- a/tutorials/codex-analysis-platform/08-production-rollout.md
+++ b/tutorials/codex-analysis-platform/08-production-rollout.md
@@ -633,7 +633,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Automation Pipelines](07-automation-pipelines.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/codex-analysis-platform/README.md b/tutorials/codex-analysis-platform/README.md
index ad6fad71..09f5fcbf 100644
--- a/tutorials/codex-analysis-platform/README.md
+++ b/tutorials/codex-analysis-platform/README.md
@@ -1,69 +1,102 @@
-# Codex Code Analysis Platform Deep Dive
-
-> Master building sophisticated code analysis platforms - static analysis, AST manipulation, and developer tooling with modern web technologies
+---
+layout: default
+title: "Codex Analysis Platform"
+nav_order: 40
+has_children: true
+format_version: v2
+---
 
-## 🎯 Learning Objectives
+# Codex Analysis Platform Tutorial: Build Code Intelligence Systems
 
-- **Static Code Analysis** - Building comprehensive code analysis engines
-- **AST Processing** - Abstract syntax tree manipulation and transformation
-- **Language Server Protocol** - Implementing LSP for editor integrations
-- **Code Intelligence** - Semantic analysis, symbol resolution, and cross-references
-- **Visualization Systems** - Creating interactive code exploration interfaces
-- **Performance Optimization** - Handling large codebases efficiently
-- **Plugin Architecture** - Extensible analysis framework design
+> Design and operate a production-grade code analysis platform with parsing, symbol resolution, code intelligence features, LSP integration, and rollout governance.
 
-## 📋 Prerequisites
+[![Category](https://img.shields.io/badge/category-code%20intelligence-blue)](../README.md)
+[![Focus](https://img.shields.io/badge/focus-static%20analysis%20%2B%20developer%20tooling-green)](01-analysis-engine.md)
 
-- **Compiler Theory**: Understanding of lexers, parsers, and ASTs
-- **TypeScript/JavaScript**: Advanced knowledge for tooling development
-- **Language Processing**: Familiarity with multiple programming languages
-- **Web Technologies**: React, Node.js, and modern web development
-- **Developer Tools**: Experience with IDE/editor extension development
+## Why This Track Matters
 
-## ⏱️ Time Investment
+Most engineering teams rely on code intelligence features but do not understand how they are built or operated.
 
-**Total: 12-15 hours**
-- Analysis engine architecture: 3 hours
-- AST processing and manipulation: 3 hours
-- Language server implementation: 2.5 hours
-- Visualization and UI: 2.5 hours
-- Advanced features and optimization: 3 hours
+This track focuses on:
 
-## 🔧 Quick Setup
+- architecture of multi-language analysis systems
+- AST and symbol pipelines that power developer tooling
+- practical LSP implementation patterns
+- production rollout, governance, and CI automation
 
-```bash
-# Clone or create analysis platform
-mkdir codex-analysis
-cd codex-analysis
+## Current Snapshot (auto-updated)
 
-# Initialize project
-npm init -y
-npm install typescript @types/node
+- tutorial scope: design and implementation patterns for code analysis platforms
+- primary references: TypeScript Compiler API, Babel parser/traverse, Tree-sitter, and LSP specification
+- chapter set includes architecture -> implementation -> operations
+- structure and links validated by repository docs-health checks
 
-# Install analysis dependencies
-npm install @babel/parser @babel/traverse
-npm install tree-sitter tree-sitter-javascript
+## Mental Model
 
-# Start development
-npm run dev
+```mermaid
+flowchart LR
+    A[Source Code Inputs] --> B[Parsing and AST Generation]
+    B --> C[Semantic Analysis]
+    C --> D[Intelligence Features]
+    D --> E[LSP and API Delivery]
+    E --> F[Automation and Production Ops]
 ```
 
-## 💡 Key Architecture Insights
+## Chapter Guide
+
+| Chapter | Key Question | Outcome |
+|:--------|:-------------|:--------|
+| [01 - Analysis Engine](01-analysis-engine.md) | How should the core analysis runtime be structured? | Engine architecture baseline |
+| [02 - AST Processing](02-ast-processing.md) | How do we parse and transform code safely? | Robust AST workflow |
+| [03 - Symbol Resolution](03-symbol-resolution.md) | How do we map identifiers to meaning? | Semantic foundation |
+| [04 - Code Intelligence](04-code-intelligence.md) | How do we expose search/navigation features? | Developer-facing intelligence layer |
+| [05 - LSP Implementation](05-lsp-implementation.md) | How do we integrate with editors? | LSP-compatible service |
+| [06 - Visualization](06-visualization.md) | How do we make insights explorable? | Interactive analysis views |
+| [07 - Automation Pipelines](07-automation-pipelines.md) | How do we operationalize analysis in CI/CD? | Reliable automation patterns |
+| [08 - Production Rollout](08-production-rollout.md) | How do we govern and scale the platform? | Rollout and operations playbook |
+
+## What You Will Learn
+
+- how to design static analysis architecture for real repositories
+- how to build symbol/type/code-intelligence features incrementally
+- how to integrate analysis output into editor and CI workflows
+- how to operate analysis infrastructure with governance and reliability
 
-- **Multi-Language Analysis** - Unified analysis across different programming languages
-- **Incremental Processing** - Efficient analysis of code changes
-- **Symbol Resolution** - Advanced semantic understanding of code structures
-- **Cross-Reference Systems** - Finding usage patterns and dependencies
-- **Performance Patterns** - Handling enterprise-scale codebases
+## Source References
 
-## 🎯 What You'll Build
+- [TypeScript Compiler API](https://github.com/microsoft/TypeScript/wiki/Using-the-Compiler-API)
+- [Babel Parser](https://babeljs.io/docs/babel-parser)
+- [Tree-sitter](https://tree-sitter.github.io/tree-sitter/)
+- [Language Server Protocol](https://microsoft.github.io/language-server-protocol/)
 
-1. **Code Analysis Engine** - Multi-language static analysis system
-2. **AST Manipulation Tools** - Code transformation and refactoring utilities
-3. **Language Server** - LSP implementation for editor integration
-4. **Visualization Interface** - Interactive code exploration dashboard
-5. **Plugin System** - Extensible framework for custom analysis rules
+## Related Tutorials
+
+- [Aider Tutorial](../aider-tutorial/)
+- [Cline Tutorial](../cline-tutorial/)
+- [Roo Code Tutorial](../roo-code-tutorial/)
+- [LangGraph Tutorial](../langgraph-tutorial/)
 
 ---
 
-*Part of the [Awesome Code Docs](../../README.md) collection*
+Start with [Chapter 1: Building the Analysis Engine](01-analysis-engine.md).
+
+## Navigation & Backlinks
+
+- [Start Here: Chapter 1: Building the Analysis Engine](01-analysis-engine.md)
+- [Back to Main Catalog](../../README.md#-tutorial-catalog)
+- [Browse A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
+- [Search by Intent](../../discoverability/query-hub.md)
+- [Explore Category Hubs](../../README.md#category-hubs)
+
+## Full Chapter Map
+
+1. [Chapter 1: Building the Analysis Engine](01-analysis-engine.md)
+2. [Chapter 2: AST Processing](02-ast-processing.md)
+3. [Chapter 3: Symbol Resolution](03-symbol-resolution.md)
+4. [Chapter 4: Code Intelligence](04-code-intelligence.md)
+5. [Chapter 5: LSP Implementation](05-lsp-implementation.md)
+6. [Chapter 6: Visualization](06-visualization.md)
+7. [Chapter 7: Automation Pipelines](07-automation-pipelines.md)
+8. [Chapter 8: Production Rollout](08-production-rollout.md)
+
+*Generated by [AI Codebase Knowledge Builder](https://github.com/The-Pocket/Tutorial-Codebase-Knowledge)*
diff --git a/tutorials/codex-analysis-platform/index.md b/tutorials/codex-analysis-platform/index.md
deleted file mode 100644
index 09f5fcbf..00000000
--- a/tutorials/codex-analysis-platform/index.md
+++ /dev/null
@@ -1,102 +0,0 @@
----
-layout: default
-title: "Codex Analysis Platform"
-nav_order: 40
-has_children: true
-format_version: v2
----
-
-# Codex Analysis Platform Tutorial: Build Code Intelligence Systems
-
-> Design and operate a production-grade code analysis platform with parsing, symbol resolution, code intelligence features, LSP integration, and rollout governance.
-
-[![Category](https://img.shields.io/badge/category-code%20intelligence-blue)](../README.md)
-[![Focus](https://img.shields.io/badge/focus-static%20analysis%20%2B%20developer%20tooling-green)](01-analysis-engine.md)
-
-## Why This Track Matters
-
-Most engineering teams rely on code intelligence features but do not understand how they are built or operated.
-
-This track focuses on:
-
-- architecture of multi-language analysis systems
-- AST and symbol pipelines that power developer tooling
-- practical LSP implementation patterns
-- production rollout, governance, and CI automation
-
-## Current Snapshot (auto-updated)
-
-- tutorial scope: design and implementation patterns for code analysis platforms
-- primary references: TypeScript Compiler API, Babel parser/traverse, Tree-sitter, and LSP specification
-- chapter set includes architecture -> implementation -> operations
-- structure and links validated by repository docs-health checks
-
-## Mental Model
-
-```mermaid
-flowchart LR
-    A[Source Code Inputs] --> B[Parsing and AST Generation]
-    B --> C[Semantic Analysis]
-    C --> D[Intelligence Features]
-    D --> E[LSP and API Delivery]
-    E --> F[Automation and Production Ops]
-```
-
-## Chapter Guide
-
-| Chapter | Key Question | Outcome |
-|:--------|:-------------|:--------|
-| [01 - Analysis Engine](01-analysis-engine.md) | How should the core analysis runtime be structured? | Engine architecture baseline |
-| [02 - AST Processing](02-ast-processing.md) | How do we parse and transform code safely? | Robust AST workflow |
-| [03 - Symbol Resolution](03-symbol-resolution.md) | How do we map identifiers to meaning? | Semantic foundation |
-| [04 - Code Intelligence](04-code-intelligence.md) | How do we expose search/navigation features? | Developer-facing intelligence layer |
-| [05 - LSP Implementation](05-lsp-implementation.md) | How do we integrate with editors? | LSP-compatible service |
-| [06 - Visualization](06-visualization.md) | How do we make insights explorable? | Interactive analysis views |
-| [07 - Automation Pipelines](07-automation-pipelines.md) | How do we operationalize analysis in CI/CD? | Reliable automation patterns |
-| [08 - Production Rollout](08-production-rollout.md) | How do we govern and scale the platform? | Rollout and operations playbook |
-
-## What You Will Learn
-
-- how to design static analysis architecture for real repositories
-- how to build symbol/type/code-intelligence features incrementally
-- how to integrate analysis output into editor and CI workflows
-- how to operate analysis infrastructure with governance and reliability
-
-## Source References
-
-- [TypeScript Compiler API](https://github.com/microsoft/TypeScript/wiki/Using-the-Compiler-API)
-- [Babel Parser](https://babeljs.io/docs/babel-parser)
-- [Tree-sitter](https://tree-sitter.github.io/tree-sitter/)
-- [Language Server Protocol](https://microsoft.github.io/language-server-protocol/)
-
-## Related Tutorials
-
-- [Aider Tutorial](../aider-tutorial/)
-- [Cline Tutorial](../cline-tutorial/)
-- [Roo Code Tutorial](../roo-code-tutorial/)
-- [LangGraph Tutorial](../langgraph-tutorial/)
-
----
-
-Start with [Chapter 1: Building the Analysis Engine](01-analysis-engine.md).
-
-## Navigation & Backlinks
-
-- [Start Here: Chapter 1: Building the Analysis Engine](01-analysis-engine.md)
-- [Back to Main Catalog](../../README.md#-tutorial-catalog)
-- [Browse A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
-- [Search by Intent](../../discoverability/query-hub.md)
-- [Explore Category Hubs](../../README.md#category-hubs)
-
-## Full Chapter Map
-
-1. [Chapter 1: Building the Analysis Engine](01-analysis-engine.md)
-2. [Chapter 2: AST Processing](02-ast-processing.md)
-3. [Chapter 3: Symbol Resolution](03-symbol-resolution.md)
-4. [Chapter 4: Code Intelligence](04-code-intelligence.md)
-5. [Chapter 5: LSP Implementation](05-lsp-implementation.md)
-6. [Chapter 6: Visualization](06-visualization.md)
-7. [Chapter 7: Automation Pipelines](07-automation-pipelines.md)
-8. [Chapter 8: Production Rollout](08-production-rollout.md)
-
-*Generated by [AI Codebase Knowledge Builder](https://github.com/The-Pocket/Tutorial-Codebase-Knowledge)*
diff --git a/tutorials/codex-cli-tutorial/01-getting-started.md b/tutorials/codex-cli-tutorial/01-getting-started.md
index 393883e7..eecad3c0 100644
--- a/tutorials/codex-cli-tutorial/01-getting-started.md
+++ b/tutorials/codex-cli-tutorial/01-getting-started.md
@@ -629,7 +629,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Architecture and Local Execution Model](02-architecture-and-local-execution-model.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/codex-cli-tutorial/02-architecture-and-local-execution-model.md b/tutorials/codex-cli-tutorial/02-architecture-and-local-execution-model.md
index eec04761..5d687792 100644
--- a/tutorials/codex-cli-tutorial/02-architecture-and-local-execution-model.md
+++ b/tutorials/codex-cli-tutorial/02-architecture-and-local-execution-model.md
@@ -630,7 +630,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started](01-getting-started.md)
 - [Next Chapter: Chapter 3: Authentication and Model Configuration](03-authentication-and-model-configuration.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/codex-cli-tutorial/03-authentication-and-model-configuration.md b/tutorials/codex-cli-tutorial/03-authentication-and-model-configuration.md
index ba4977a2..a1eae9e6 100644
--- a/tutorials/codex-cli-tutorial/03-authentication-and-model-configuration.md
+++ b/tutorials/codex-cli-tutorial/03-authentication-and-model-configuration.md
@@ -629,7 +629,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Architecture and Local Execution Model](02-architecture-and-local-execution-model.md)
 - [Next Chapter: Chapter 4: Sandbox, Approvals, and MCP Integration](04-sandbox-approvals-and-mcp-integration.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/codex-cli-tutorial/04-sandbox-approvals-and-mcp-integration.md b/tutorials/codex-cli-tutorial/04-sandbox-approvals-and-mcp-integration.md
index 0ecc74fb..fdb1280a 100644
--- a/tutorials/codex-cli-tutorial/04-sandbox-approvals-and-mcp-integration.md
+++ b/tutorials/codex-cli-tutorial/04-sandbox-approvals-and-mcp-integration.md
@@ -629,7 +629,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Authentication and Model Configuration](03-authentication-and-model-configuration.md)
 - [Next Chapter: Chapter 5: Prompts, Skills, and Workflow Orchestration](05-prompts-skills-and-workflow-orchestration.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/codex-cli-tutorial/05-prompts-skills-and-workflow-orchestration.md b/tutorials/codex-cli-tutorial/05-prompts-skills-and-workflow-orchestration.md
index ab7523ca..252d412c 100644
--- a/tutorials/codex-cli-tutorial/05-prompts-skills-and-workflow-orchestration.md
+++ b/tutorials/codex-cli-tutorial/05-prompts-skills-and-workflow-orchestration.md
@@ -629,7 +629,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Sandbox, Approvals, and MCP Integration](04-sandbox-approvals-and-mcp-integration.md)
 - [Next Chapter: Chapter 6: Commands, Connectors, and Daily Operations](06-commands-connectors-and-daily-operations.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/codex-cli-tutorial/06-commands-connectors-and-daily-operations.md b/tutorials/codex-cli-tutorial/06-commands-connectors-and-daily-operations.md
index 951181d2..5257dc8f 100644
--- a/tutorials/codex-cli-tutorial/06-commands-connectors-and-daily-operations.md
+++ b/tutorials/codex-cli-tutorial/06-commands-connectors-and-daily-operations.md
@@ -629,7 +629,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Prompts, Skills, and Workflow Orchestration](05-prompts-skills-and-workflow-orchestration.md)
 - [Next Chapter: Chapter 7: Advanced Configuration and Policy Controls](07-advanced-configuration-and-policy-controls.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/codex-cli-tutorial/07-advanced-configuration-and-policy-controls.md b/tutorials/codex-cli-tutorial/07-advanced-configuration-and-policy-controls.md
index 6c0f06a5..49cbd419 100644
--- a/tutorials/codex-cli-tutorial/07-advanced-configuration-and-policy-controls.md
+++ b/tutorials/codex-cli-tutorial/07-advanced-configuration-and-policy-controls.md
@@ -629,7 +629,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Commands, Connectors, and Daily Operations](06-commands-connectors-and-daily-operations.md)
 - [Next Chapter: Chapter 8: Contribution Workflow and Ecosystem Strategy](08-contribution-workflow-and-ecosystem-strategy.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/codex-cli-tutorial/08-contribution-workflow-and-ecosystem-strategy.md b/tutorials/codex-cli-tutorial/08-contribution-workflow-and-ecosystem-strategy.md
index e809c885..37838d12 100644
--- a/tutorials/codex-cli-tutorial/08-contribution-workflow-and-ecosystem-strategy.md
+++ b/tutorials/codex-cli-tutorial/08-contribution-workflow-and-ecosystem-strategy.md
@@ -629,7 +629,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Advanced Configuration and Policy Controls](07-advanced-configuration-and-policy-controls.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/codex-cli-tutorial/index.md b/tutorials/codex-cli-tutorial/README.md
similarity index 100%
rename from tutorials/codex-cli-tutorial/index.md
rename to tutorials/codex-cli-tutorial/README.md
diff --git a/tutorials/comfyui-tutorial/01-getting-started.md b/tutorials/comfyui-tutorial/01-getting-started.md
index 82da5e52..7c0eed4c 100644
--- a/tutorials/comfyui-tutorial/01-getting-started.md
+++ b/tutorials/comfyui-tutorial/01-getting-started.md
@@ -453,7 +453,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Understanding Nodes & Workflows](02-nodes-workflows.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/comfyui-tutorial/02-nodes-workflows.md b/tutorials/comfyui-tutorial/02-nodes-workflows.md
index b0074928..933189ea 100644
--- a/tutorials/comfyui-tutorial/02-nodes-workflows.md
+++ b/tutorials/comfyui-tutorial/02-nodes-workflows.md
@@ -483,7 +483,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started with ComfyUI](01-getting-started.md)
 - [Next Chapter: Chapter 3: Text-to-Image Generation](03-text-to-image.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/comfyui-tutorial/03-text-to-image.md b/tutorials/comfyui-tutorial/03-text-to-image.md
index 47cd2b97..a2a5f302 100644
--- a/tutorials/comfyui-tutorial/03-text-to-image.md
+++ b/tutorials/comfyui-tutorial/03-text-to-image.md
@@ -506,7 +506,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Understanding Nodes & Workflows](02-nodes-workflows.md)
 - [Next Chapter: Chapter 4: Image-to-Image & Inpainting](04-image-to-image.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/comfyui-tutorial/04-image-to-image.md b/tutorials/comfyui-tutorial/04-image-to-image.md
index b4e8b882..2a10bcbb 100644
--- a/tutorials/comfyui-tutorial/04-image-to-image.md
+++ b/tutorials/comfyui-tutorial/04-image-to-image.md
@@ -185,7 +185,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Text-to-Image Generation](03-text-to-image.md)
 - [Next Chapter: Chapter 5: ControlNet & Pose Control](05-controlnet-integration.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/comfyui-tutorial/05-controlnet-integration.md b/tutorials/comfyui-tutorial/05-controlnet-integration.md
index a84977af..3735b705 100644
--- a/tutorials/comfyui-tutorial/05-controlnet-integration.md
+++ b/tutorials/comfyui-tutorial/05-controlnet-integration.md
@@ -640,7 +640,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Image-to-Image & Inpainting](04-image-to-image.md)
 - [Next Chapter: Chapter 6: LoRA & Model Customization](06-lora-customization.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/comfyui-tutorial/06-lora-customization.md b/tutorials/comfyui-tutorial/06-lora-customization.md
index db1302b1..93aeb365 100644
--- a/tutorials/comfyui-tutorial/06-lora-customization.md
+++ b/tutorials/comfyui-tutorial/06-lora-customization.md
@@ -662,7 +662,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: ControlNet & Pose Control](05-controlnet-integration.md)
 - [Next Chapter: Chapter 7: Advanced Workflows & Automation](07-advanced-workflows.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/comfyui-tutorial/07-advanced-workflows.md b/tutorials/comfyui-tutorial/07-advanced-workflows.md
index 5dc7025e..736182ee 100644
--- a/tutorials/comfyui-tutorial/07-advanced-workflows.md
+++ b/tutorials/comfyui-tutorial/07-advanced-workflows.md
@@ -773,7 +773,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: LoRA & Model Customization](06-lora-customization.md)
 - [Next Chapter: Chapter 8: Production & Optimization](08-production-optimization.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/comfyui-tutorial/08-production-optimization.md b/tutorials/comfyui-tutorial/08-production-optimization.md
index d8247788..96fce5f1 100644
--- a/tutorials/comfyui-tutorial/08-production-optimization.md
+++ b/tutorials/comfyui-tutorial/08-production-optimization.md
@@ -950,7 +950,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Advanced Workflows & Automation](07-advanced-workflows.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/comfyui-tutorial/index.md b/tutorials/comfyui-tutorial/README.md
similarity index 100%
rename from tutorials/comfyui-tutorial/index.md
rename to tutorials/comfyui-tutorial/README.md
diff --git a/tutorials/composio-tutorial/01-getting-started.md b/tutorials/composio-tutorial/01-getting-started.md
index 89775998..02999760 100644
--- a/tutorials/composio-tutorial/01-getting-started.md
+++ b/tutorials/composio-tutorial/01-getting-started.md
@@ -633,7 +633,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Sessions, Meta Tools, and User Scoping](02-sessions-meta-tools-and-user-scoping.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/composio-tutorial/02-sessions-meta-tools-and-user-scoping.md b/tutorials/composio-tutorial/02-sessions-meta-tools-and-user-scoping.md
index 1bb5640a..ee1a4bbc 100644
--- a/tutorials/composio-tutorial/02-sessions-meta-tools-and-user-scoping.md
+++ b/tutorials/composio-tutorial/02-sessions-meta-tools-and-user-scoping.md
@@ -632,7 +632,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started](01-getting-started.md)
 - [Next Chapter: Chapter 3: Provider Integrations and Framework Mapping](03-provider-integrations-and-framework-mapping.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/composio-tutorial/03-provider-integrations-and-framework-mapping.md b/tutorials/composio-tutorial/03-provider-integrations-and-framework-mapping.md
index 02e77d5a..ad71743e 100644
--- a/tutorials/composio-tutorial/03-provider-integrations-and-framework-mapping.md
+++ b/tutorials/composio-tutorial/03-provider-integrations-and-framework-mapping.md
@@ -633,7 +633,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Sessions, Meta Tools, and User Scoping](02-sessions-meta-tools-and-user-scoping.md)
 - [Next Chapter: Chapter 4: Authentication and Connected Accounts](04-authentication-and-connected-accounts.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/composio-tutorial/04-authentication-and-connected-accounts.md b/tutorials/composio-tutorial/04-authentication-and-connected-accounts.md
index d72a9b09..60df6e0a 100644
--- a/tutorials/composio-tutorial/04-authentication-and-connected-accounts.md
+++ b/tutorials/composio-tutorial/04-authentication-and-connected-accounts.md
@@ -635,7 +635,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Provider Integrations and Framework Mapping](03-provider-integrations-and-framework-mapping.md)
 - [Next Chapter: Chapter 5: Tool Execution Modes and Modifiers](05-tool-execution-modes-and-modifiers.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/composio-tutorial/05-tool-execution-modes-and-modifiers.md b/tutorials/composio-tutorial/05-tool-execution-modes-and-modifiers.md
index ee404f7f..992d8529 100644
--- a/tutorials/composio-tutorial/05-tool-execution-modes-and-modifiers.md
+++ b/tutorials/composio-tutorial/05-tool-execution-modes-and-modifiers.md
@@ -633,7 +633,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Authentication and Connected Accounts](04-authentication-and-connected-accounts.md)
 - [Next Chapter: Chapter 6: MCP Server Patterns and Toolkit Control](06-mcp-server-patterns-and-toolkit-control.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/composio-tutorial/06-mcp-server-patterns-and-toolkit-control.md b/tutorials/composio-tutorial/06-mcp-server-patterns-and-toolkit-control.md
index cc789f8e..d569f32b 100644
--- a/tutorials/composio-tutorial/06-mcp-server-patterns-and-toolkit-control.md
+++ b/tutorials/composio-tutorial/06-mcp-server-patterns-and-toolkit-control.md
@@ -643,7 +643,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Tool Execution Modes and Modifiers](05-tool-execution-modes-and-modifiers.md)
 - [Next Chapter: Chapter 7: Triggers, Webhooks, and Event Automation](07-triggers-webhooks-and-event-automation.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/composio-tutorial/07-triggers-webhooks-and-event-automation.md b/tutorials/composio-tutorial/07-triggers-webhooks-and-event-automation.md
index e599550b..a3e44710 100644
--- a/tutorials/composio-tutorial/07-triggers-webhooks-and-event-automation.md
+++ b/tutorials/composio-tutorial/07-triggers-webhooks-and-event-automation.md
@@ -635,7 +635,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: MCP Server Patterns and Toolkit Control](06-mcp-server-patterns-and-toolkit-control.md)
 - [Next Chapter: Chapter 8: Migration, Troubleshooting, and Production Ops](08-migration-troubleshooting-and-production-ops.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/composio-tutorial/08-migration-troubleshooting-and-production-ops.md b/tutorials/composio-tutorial/08-migration-troubleshooting-and-production-ops.md
index 5cb86c60..9593bcfc 100644
--- a/tutorials/composio-tutorial/08-migration-troubleshooting-and-production-ops.md
+++ b/tutorials/composio-tutorial/08-migration-troubleshooting-and-production-ops.md
@@ -641,7 +641,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Triggers, Webhooks, and Event Automation](07-triggers-webhooks-and-event-automation.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/composio-tutorial/index.md b/tutorials/composio-tutorial/README.md
similarity index 100%
rename from tutorials/composio-tutorial/index.md
rename to tutorials/composio-tutorial/README.md
diff --git a/tutorials/compound-engineering-plugin-tutorial/01-getting-started.md b/tutorials/compound-engineering-plugin-tutorial/01-getting-started.md
index 491e6d5f..b8f1d226 100644
--- a/tutorials/compound-engineering-plugin-tutorial/01-getting-started.md
+++ b/tutorials/compound-engineering-plugin-tutorial/01-getting-started.md
@@ -641,7 +641,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Compound Engineering Philosophy and Workflow Loop](02-compound-engineering-philosophy-and-workflow-loop.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/compound-engineering-plugin-tutorial/02-compound-engineering-philosophy-and-workflow-loop.md b/tutorials/compound-engineering-plugin-tutorial/02-compound-engineering-philosophy-and-workflow-loop.md
index 12995e1a..4def6184 100644
--- a/tutorials/compound-engineering-plugin-tutorial/02-compound-engineering-philosophy-and-workflow-loop.md
+++ b/tutorials/compound-engineering-plugin-tutorial/02-compound-engineering-philosophy-and-workflow-loop.md
@@ -633,7 +633,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started](01-getting-started.md)
 - [Next Chapter: Chapter 3: Architecture of Agents, Commands, and Skills](03-architecture-of-agents-commands-and-skills.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/compound-engineering-plugin-tutorial/03-architecture-of-agents-commands-and-skills.md b/tutorials/compound-engineering-plugin-tutorial/03-architecture-of-agents-commands-and-skills.md
index dd904172..583f9d57 100644
--- a/tutorials/compound-engineering-plugin-tutorial/03-architecture-of-agents-commands-and-skills.md
+++ b/tutorials/compound-engineering-plugin-tutorial/03-architecture-of-agents-commands-and-skills.md
@@ -629,7 +629,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Compound Engineering Philosophy and Workflow Loop](02-compound-engineering-philosophy-and-workflow-loop.md)
 - [Next Chapter: Chapter 4: Multi-Provider Conversion and Config Sync](04-multi-provider-conversion-and-config-sync.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/compound-engineering-plugin-tutorial/04-multi-provider-conversion-and-config-sync.md b/tutorials/compound-engineering-plugin-tutorial/04-multi-provider-conversion-and-config-sync.md
index e412ad79..a45c942c 100644
--- a/tutorials/compound-engineering-plugin-tutorial/04-multi-provider-conversion-and-config-sync.md
+++ b/tutorials/compound-engineering-plugin-tutorial/04-multi-provider-conversion-and-config-sync.md
@@ -637,7 +637,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Architecture of Agents, Commands, and Skills](03-architecture-of-agents-commands-and-skills.md)
 - [Next Chapter: Chapter 5: MCP Integrations and Browser Automation](05-mcp-integrations-and-browser-automation.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/compound-engineering-plugin-tutorial/05-mcp-integrations-and-browser-automation.md b/tutorials/compound-engineering-plugin-tutorial/05-mcp-integrations-and-browser-automation.md
index c84fe8e9..5ee168f9 100644
--- a/tutorials/compound-engineering-plugin-tutorial/05-mcp-integrations-and-browser-automation.md
+++ b/tutorials/compound-engineering-plugin-tutorial/05-mcp-integrations-and-browser-automation.md
@@ -637,7 +637,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Multi-Provider Conversion and Config Sync](04-multi-provider-conversion-and-config-sync.md)
 - [Next Chapter: Chapter 6: Daily Operations and Quality Gates](06-daily-operations-and-quality-gates.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/compound-engineering-plugin-tutorial/06-daily-operations-and-quality-gates.md b/tutorials/compound-engineering-plugin-tutorial/06-daily-operations-and-quality-gates.md
index 715fe0bf..ec3774f5 100644
--- a/tutorials/compound-engineering-plugin-tutorial/06-daily-operations-and-quality-gates.md
+++ b/tutorials/compound-engineering-plugin-tutorial/06-daily-operations-and-quality-gates.md
@@ -636,7 +636,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: MCP Integrations and Browser Automation](05-mcp-integrations-and-browser-automation.md)
 - [Next Chapter: Chapter 7: Troubleshooting and Runtime Maintenance](07-troubleshooting-and-runtime-maintenance.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/compound-engineering-plugin-tutorial/07-troubleshooting-and-runtime-maintenance.md b/tutorials/compound-engineering-plugin-tutorial/07-troubleshooting-and-runtime-maintenance.md
index 4fa8c79d..6d59b21b 100644
--- a/tutorials/compound-engineering-plugin-tutorial/07-troubleshooting-and-runtime-maintenance.md
+++ b/tutorials/compound-engineering-plugin-tutorial/07-troubleshooting-and-runtime-maintenance.md
@@ -637,7 +637,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Daily Operations and Quality Gates](06-daily-operations-and-quality-gates.md)
 - [Next Chapter: Chapter 8: Contribution Workflow and Versioning Discipline](08-contribution-workflow-and-versioning-discipline.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/compound-engineering-plugin-tutorial/08-contribution-workflow-and-versioning-discipline.md b/tutorials/compound-engineering-plugin-tutorial/08-contribution-workflow-and-versioning-discipline.md
index 679a79bb..265eeb18 100644
--- a/tutorials/compound-engineering-plugin-tutorial/08-contribution-workflow-and-versioning-discipline.md
+++ b/tutorials/compound-engineering-plugin-tutorial/08-contribution-workflow-and-versioning-discipline.md
@@ -629,7 +629,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Troubleshooting and Runtime Maintenance](07-troubleshooting-and-runtime-maintenance.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/compound-engineering-plugin-tutorial/index.md b/tutorials/compound-engineering-plugin-tutorial/README.md
similarity index 100%
rename from tutorials/compound-engineering-plugin-tutorial/index.md
rename to tutorials/compound-engineering-plugin-tutorial/README.md
diff --git a/tutorials/context7-tutorial/01-getting-started.md b/tutorials/context7-tutorial/01-getting-started.md
index 1117e359..6294a3e3 100644
--- a/tutorials/context7-tutorial/01-getting-started.md
+++ b/tutorials/context7-tutorial/01-getting-started.md
@@ -635,7 +635,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Architecture and Tooling Model](02-architecture-and-tooling-model.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/context7-tutorial/02-architecture-and-tooling-model.md b/tutorials/context7-tutorial/02-architecture-and-tooling-model.md
index c96d7c44..a109851c 100644
--- a/tutorials/context7-tutorial/02-architecture-and-tooling-model.md
+++ b/tutorials/context7-tutorial/02-architecture-and-tooling-model.md
@@ -633,7 +633,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started](01-getting-started.md)
 - [Next Chapter: Chapter 3: Client Integrations and Setup Patterns](03-client-integrations-and-setup-patterns.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/context7-tutorial/03-client-integrations-and-setup-patterns.md b/tutorials/context7-tutorial/03-client-integrations-and-setup-patterns.md
index 61d8d568..e25e2689 100644
--- a/tutorials/context7-tutorial/03-client-integrations-and-setup-patterns.md
+++ b/tutorials/context7-tutorial/03-client-integrations-and-setup-patterns.md
@@ -634,7 +634,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Architecture and Tooling Model](02-architecture-and-tooling-model.md)
 - [Next Chapter: Chapter 4: Prompting Strategies and Rules](04-prompting-strategies-and-rules.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/context7-tutorial/04-prompting-strategies-and-rules.md b/tutorials/context7-tutorial/04-prompting-strategies-and-rules.md
index e195f3ec..8fdb1029 100644
--- a/tutorials/context7-tutorial/04-prompting-strategies-and-rules.md
+++ b/tutorials/context7-tutorial/04-prompting-strategies-and-rules.md
@@ -631,7 +631,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Client Integrations and Setup Patterns](03-client-integrations-and-setup-patterns.md)
 - [Next Chapter: Chapter 5: API Workflows and SDK Patterns](05-api-workflows-and-sdk-patterns.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/context7-tutorial/05-api-workflows-and-sdk-patterns.md b/tutorials/context7-tutorial/05-api-workflows-and-sdk-patterns.md
index 313d4b04..9c7f3615 100644
--- a/tutorials/context7-tutorial/05-api-workflows-and-sdk-patterns.md
+++ b/tutorials/context7-tutorial/05-api-workflows-and-sdk-patterns.md
@@ -633,7 +633,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Prompting Strategies and Rules](04-prompting-strategies-and-rules.md)
 - [Next Chapter: Chapter 6: Library Onboarding and Documentation Quality](06-library-onboarding-and-documentation-quality.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/context7-tutorial/06-library-onboarding-and-documentation-quality.md b/tutorials/context7-tutorial/06-library-onboarding-and-documentation-quality.md
index 71f6522b..98a495b1 100644
--- a/tutorials/context7-tutorial/06-library-onboarding-and-documentation-quality.md
+++ b/tutorials/context7-tutorial/06-library-onboarding-and-documentation-quality.md
@@ -628,7 +628,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: API Workflows and SDK Patterns](05-api-workflows-and-sdk-patterns.md)
 - [Next Chapter: Chapter 7: Troubleshooting and Local Development](07-troubleshooting-and-local-development.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/context7-tutorial/07-troubleshooting-and-local-development.md b/tutorials/context7-tutorial/07-troubleshooting-and-local-development.md
index 2b2af07d..561c5395 100644
--- a/tutorials/context7-tutorial/07-troubleshooting-and-local-development.md
+++ b/tutorials/context7-tutorial/07-troubleshooting-and-local-development.md
@@ -641,7 +641,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Library Onboarding and Documentation Quality](06-library-onboarding-and-documentation-quality.md)
 - [Next Chapter: Chapter 8: Production Operations and Governance](08-production-operations-and-governance.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/context7-tutorial/08-production-operations-and-governance.md b/tutorials/context7-tutorial/08-production-operations-and-governance.md
index 3c5489c4..44b51ce4 100644
--- a/tutorials/context7-tutorial/08-production-operations-and-governance.md
+++ b/tutorials/context7-tutorial/08-production-operations-and-governance.md
@@ -629,7 +629,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Troubleshooting and Local Development](07-troubleshooting-and-local-development.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/context7-tutorial/index.md b/tutorials/context7-tutorial/README.md
similarity index 100%
rename from tutorials/context7-tutorial/index.md
rename to tutorials/context7-tutorial/README.md
diff --git a/tutorials/continue-tutorial/01-getting-started.md b/tutorials/continue-tutorial/01-getting-started.md
index 082f1832..13639792 100644
--- a/tutorials/continue-tutorial/01-getting-started.md
+++ b/tutorials/continue-tutorial/01-getting-started.md
@@ -642,7 +642,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Code Completion & Generation](02-code-completion.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/continue-tutorial/02-code-completion.md b/tutorials/continue-tutorial/02-code-completion.md
index 064ddbd5..cc986bd0 100644
--- a/tutorials/continue-tutorial/02-code-completion.md
+++ b/tutorials/continue-tutorial/02-code-completion.md
@@ -893,7 +893,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started with Continue](01-getting-started.md)
 - [Next Chapter: Chapter 3: Refactoring & Optimization](03-refactoring-optimization.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/continue-tutorial/03-refactoring-optimization.md b/tutorials/continue-tutorial/03-refactoring-optimization.md
index 38999ad3..0718982e 100644
--- a/tutorials/continue-tutorial/03-refactoring-optimization.md
+++ b/tutorials/continue-tutorial/03-refactoring-optimization.md
@@ -677,7 +677,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Code Completion & Generation](02-code-completion.md)
 - [Next Chapter: Chapter 4: Documentation & Comments](04-documentation-comments.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/continue-tutorial/04-documentation-comments.md b/tutorials/continue-tutorial/04-documentation-comments.md
index aefdda8f..a784d64f 100644
--- a/tutorials/continue-tutorial/04-documentation-comments.md
+++ b/tutorials/continue-tutorial/04-documentation-comments.md
@@ -754,7 +754,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Refactoring & Optimization](03-refactoring-optimization.md)
 - [Next Chapter: Chapter 5: Debugging & Testing](05-debugging-testing.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/continue-tutorial/05-debugging-testing.md b/tutorials/continue-tutorial/05-debugging-testing.md
index 27b2e146..cdf3bca7 100644
--- a/tutorials/continue-tutorial/05-debugging-testing.md
+++ b/tutorials/continue-tutorial/05-debugging-testing.md
@@ -716,7 +716,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Documentation & Comments](04-documentation-comments.md)
 - [Next Chapter: Chapter 6: Custom Models & Configuration](06-custom-models.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/continue-tutorial/06-custom-models.md b/tutorials/continue-tutorial/06-custom-models.md
index fcee7277..5efac32a 100644
--- a/tutorials/continue-tutorial/06-custom-models.md
+++ b/tutorials/continue-tutorial/06-custom-models.md
@@ -807,7 +807,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Debugging & Testing](05-debugging-testing.md)
 - [Next Chapter: Chapter 7: Team Collaboration & Sharing](07-team-collaboration.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/continue-tutorial/07-team-collaboration.md b/tutorials/continue-tutorial/07-team-collaboration.md
index 0205e7d6..c5b6a7a6 100644
--- a/tutorials/continue-tutorial/07-team-collaboration.md
+++ b/tutorials/continue-tutorial/07-team-collaboration.md
@@ -741,7 +741,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Custom Models & Configuration](06-custom-models.md)
 - [Next Chapter: Chapter 8: Advanced Enterprise Features](08-advanced-enterprise.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/continue-tutorial/08-advanced-enterprise.md b/tutorials/continue-tutorial/08-advanced-enterprise.md
index d2a6707c..f7239bd1 100644
--- a/tutorials/continue-tutorial/08-advanced-enterprise.md
+++ b/tutorials/continue-tutorial/08-advanced-enterprise.md
@@ -851,7 +851,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Team Collaboration & Sharing](07-team-collaboration.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/continue-tutorial/index.md b/tutorials/continue-tutorial/README.md
similarity index 100%
rename from tutorials/continue-tutorial/index.md
rename to tutorials/continue-tutorial/README.md
diff --git a/tutorials/copilot-cli-tutorial/01-getting-started.md b/tutorials/copilot-cli-tutorial/01-getting-started.md
index fe390999..992de183 100644
--- a/tutorials/copilot-cli-tutorial/01-getting-started.md
+++ b/tutorials/copilot-cli-tutorial/01-getting-started.md
@@ -639,7 +639,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Authentication and Access Policies](02-authentication-and-access-policies.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/copilot-cli-tutorial/02-authentication-and-access-policies.md b/tutorials/copilot-cli-tutorial/02-authentication-and-access-policies.md
index e8b009a2..868e676d 100644
--- a/tutorials/copilot-cli-tutorial/02-authentication-and-access-policies.md
+++ b/tutorials/copilot-cli-tutorial/02-authentication-and-access-policies.md
@@ -637,7 +637,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started](01-getting-started.md)
 - [Next Chapter: Chapter 3: Interactive Workflow and Approval Model](03-interactive-workflow-and-approval-model.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/copilot-cli-tutorial/03-interactive-workflow-and-approval-model.md b/tutorials/copilot-cli-tutorial/03-interactive-workflow-and-approval-model.md
index 69d424b5..c17fe089 100644
--- a/tutorials/copilot-cli-tutorial/03-interactive-workflow-and-approval-model.md
+++ b/tutorials/copilot-cli-tutorial/03-interactive-workflow-and-approval-model.md
@@ -636,7 +636,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Authentication and Access Policies](02-authentication-and-access-policies.md)
 - [Next Chapter: Chapter 4: Models, Experimental Features, and Autopilot](04-models-experimental-features-and-autopilot.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/copilot-cli-tutorial/04-models-experimental-features-and-autopilot.md b/tutorials/copilot-cli-tutorial/04-models-experimental-features-and-autopilot.md
index 3d64792f..0f3eca6e 100644
--- a/tutorials/copilot-cli-tutorial/04-models-experimental-features-and-autopilot.md
+++ b/tutorials/copilot-cli-tutorial/04-models-experimental-features-and-autopilot.md
@@ -626,7 +626,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Interactive Workflow and Approval Model](03-interactive-workflow-and-approval-model.md)
 - [Next Chapter: Chapter 5: MCP and LSP Extension Points](05-mcp-and-lsp-extension-points.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/copilot-cli-tutorial/05-mcp-and-lsp-extension-points.md b/tutorials/copilot-cli-tutorial/05-mcp-and-lsp-extension-points.md
index be882735..af327c7a 100644
--- a/tutorials/copilot-cli-tutorial/05-mcp-and-lsp-extension-points.md
+++ b/tutorials/copilot-cli-tutorial/05-mcp-and-lsp-extension-points.md
@@ -636,7 +636,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Models, Experimental Features, and Autopilot](04-models-experimental-features-and-autopilot.md)
 - [Next Chapter: Chapter 6: GitHub-Native Context Workflows](06-github-native-context-workflows.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/copilot-cli-tutorial/06-github-native-context-workflows.md b/tutorials/copilot-cli-tutorial/06-github-native-context-workflows.md
index e699158a..d4eb036e 100644
--- a/tutorials/copilot-cli-tutorial/06-github-native-context-workflows.md
+++ b/tutorials/copilot-cli-tutorial/06-github-native-context-workflows.md
@@ -637,7 +637,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: MCP and LSP Extension Points](05-mcp-and-lsp-extension-points.md)
 - [Next Chapter: Chapter 7: Installation and Update Channels](07-installation-and-update-channels.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/copilot-cli-tutorial/07-installation-and-update-channels.md b/tutorials/copilot-cli-tutorial/07-installation-and-update-channels.md
index 69c09f45..5001a269 100644
--- a/tutorials/copilot-cli-tutorial/07-installation-and-update-channels.md
+++ b/tutorials/copilot-cli-tutorial/07-installation-and-update-channels.md
@@ -628,7 +628,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: GitHub-Native Context Workflows](06-github-native-context-workflows.md)
 - [Next Chapter: Chapter 8: Production Governance and Team Rollout](08-production-governance-and-team-rollout.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/copilot-cli-tutorial/08-production-governance-and-team-rollout.md b/tutorials/copilot-cli-tutorial/08-production-governance-and-team-rollout.md
index 0e545ca8..14ca54cd 100644
--- a/tutorials/copilot-cli-tutorial/08-production-governance-and-team-rollout.md
+++ b/tutorials/copilot-cli-tutorial/08-production-governance-and-team-rollout.md
@@ -636,7 +636,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Installation and Update Channels](07-installation-and-update-channels.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/copilot-cli-tutorial/index.md b/tutorials/copilot-cli-tutorial/README.md
similarity index 100%
rename from tutorials/copilot-cli-tutorial/index.md
rename to tutorials/copilot-cli-tutorial/README.md
diff --git a/tutorials/copilotkit-tutorial/01-getting-started.md b/tutorials/copilotkit-tutorial/01-getting-started.md
index 503558cf..dc905d44 100644
--- a/tutorials/copilotkit-tutorial/01-getting-started.md
+++ b/tutorials/copilotkit-tutorial/01-getting-started.md
@@ -700,7 +700,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Reading App Context - Making Your App State Visible to AI](02-app-context.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/copilotkit-tutorial/02-app-context.md b/tutorials/copilotkit-tutorial/02-app-context.md
index ec8521fa..ef4a9193 100644
--- a/tutorials/copilotkit-tutorial/02-app-context.md
+++ b/tutorials/copilotkit-tutorial/02-app-context.md
@@ -822,7 +822,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started with CopilotKit](01-getting-started.md)
 - [Next Chapter: Chapter 3: Copilot Actions - Enabling AI to Take Actions in Your App](03-copilot-actions.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/copilotkit-tutorial/03-copilot-actions.md b/tutorials/copilotkit-tutorial/03-copilot-actions.md
index ba09090a..ae546fa4 100644
--- a/tutorials/copilotkit-tutorial/03-copilot-actions.md
+++ b/tutorials/copilotkit-tutorial/03-copilot-actions.md
@@ -969,7 +969,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Reading App Context - Making Your App State Visible to AI](02-app-context.md)
 - [Next Chapter: Chapter 4: Chat Components - Building Chat Interfaces with CopilotChat and CopilotSidebar](04-chat-components.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/copilotkit-tutorial/04-chat-components.md b/tutorials/copilotkit-tutorial/04-chat-components.md
index f0b04098..25efb6ca 100644
--- a/tutorials/copilotkit-tutorial/04-chat-components.md
+++ b/tutorials/copilotkit-tutorial/04-chat-components.md
@@ -876,7 +876,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Copilot Actions - Enabling AI to Take Actions in Your App](03-copilot-actions.md)
 - [Next Chapter: Chapter 5: Generative UI - AI-Generated React Components](05-generative-ui.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/copilotkit-tutorial/05-generative-ui.md b/tutorials/copilotkit-tutorial/05-generative-ui.md
index 1bdc0e10..279b11d4 100644
--- a/tutorials/copilotkit-tutorial/05-generative-ui.md
+++ b/tutorials/copilotkit-tutorial/05-generative-ui.md
@@ -778,7 +778,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Chat Components - Building Chat Interfaces with CopilotChat and CopilotSidebar](04-chat-components.md)
 - [Next Chapter: Chapter 6: CoAgents & LangGraph - Building Agentic Workflows](06-coagents.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/copilotkit-tutorial/06-coagents.md b/tutorials/copilotkit-tutorial/06-coagents.md
index b96d2609..d83e827e 100644
--- a/tutorials/copilotkit-tutorial/06-coagents.md
+++ b/tutorials/copilotkit-tutorial/06-coagents.md
@@ -853,7 +853,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Generative UI - AI-Generated React Components](05-generative-ui.md)
 - [Next Chapter: Chapter 7: Human-in-the-Loop - User Approval Flows and Interrupts](07-human-in-loop.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/copilotkit-tutorial/07-human-in-loop.md b/tutorials/copilotkit-tutorial/07-human-in-loop.md
index 274a3463..243a74e9 100644
--- a/tutorials/copilotkit-tutorial/07-human-in-loop.md
+++ b/tutorials/copilotkit-tutorial/07-human-in-loop.md
@@ -1152,7 +1152,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: CoAgents & LangGraph - Building Agentic Workflows](06-coagents.md)
 - [Next Chapter: Chapter 8: Production Deployment - Secure, Scalable Copilot Apps](08-production.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/copilotkit-tutorial/08-production.md b/tutorials/copilotkit-tutorial/08-production.md
index be417e65..b827c6ef 100644
--- a/tutorials/copilotkit-tutorial/08-production.md
+++ b/tutorials/copilotkit-tutorial/08-production.md
@@ -1094,7 +1094,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Human-in-the-Loop - User Approval Flows and Interrupts](07-human-in-loop.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/copilotkit-tutorial/index.md b/tutorials/copilotkit-tutorial/README.md
similarity index 100%
rename from tutorials/copilotkit-tutorial/index.md
rename to tutorials/copilotkit-tutorial/README.md
diff --git a/tutorials/create-python-server-tutorial/01-getting-started-and-scaffolding-workflow.md b/tutorials/create-python-server-tutorial/01-getting-started-and-scaffolding-workflow.md
index 2189e98c..fc0a9703 100644
--- a/tutorials/create-python-server-tutorial/01-getting-started-and-scaffolding-workflow.md
+++ b/tutorials/create-python-server-tutorial/01-getting-started-and-scaffolding-workflow.md
@@ -630,7 +630,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Generated Project Structure and Conventions](02-generated-project-structure-and-conventions.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/create-python-server-tutorial/02-generated-project-structure-and-conventions.md b/tutorials/create-python-server-tutorial/02-generated-project-structure-and-conventions.md
index 96ceb2da..38e68220 100644
--- a/tutorials/create-python-server-tutorial/02-generated-project-structure-and-conventions.md
+++ b/tutorials/create-python-server-tutorial/02-generated-project-structure-and-conventions.md
@@ -627,7 +627,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started and Scaffolding Workflow](01-getting-started-and-scaffolding-workflow.md)
 - [Next Chapter: Chapter 3: Template Server Architecture: Resources, Prompts, and Tools](03-template-server-architecture-resources-prompts-and-tools.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/create-python-server-tutorial/03-template-server-architecture-resources-prompts-and-tools.md b/tutorials/create-python-server-tutorial/03-template-server-architecture-resources-prompts-and-tools.md
index 1750b6fb..863a3783 100644
--- a/tutorials/create-python-server-tutorial/03-template-server-architecture-resources-prompts-and-tools.md
+++ b/tutorials/create-python-server-tutorial/03-template-server-architecture-resources-prompts-and-tools.md
@@ -637,7 +637,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Generated Project Structure and Conventions](02-generated-project-structure-and-conventions.md)
 - [Next Chapter: Chapter 4: Runtime, Dependencies, and uv Packaging](04-runtime-dependencies-and-uv-packaging.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/create-python-server-tutorial/04-runtime-dependencies-and-uv-packaging.md b/tutorials/create-python-server-tutorial/04-runtime-dependencies-and-uv-packaging.md
index 2824aa40..f90ac287 100644
--- a/tutorials/create-python-server-tutorial/04-runtime-dependencies-and-uv-packaging.md
+++ b/tutorials/create-python-server-tutorial/04-runtime-dependencies-and-uv-packaging.md
@@ -637,7 +637,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Template Server Architecture: Resources, Prompts, and Tools](03-template-server-architecture-resources-prompts-and-tools.md)
 - [Next Chapter: Chapter 5: Local Integration: Claude Desktop and Inspector](05-local-integration-claude-desktop-and-inspector.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/create-python-server-tutorial/05-local-integration-claude-desktop-and-inspector.md b/tutorials/create-python-server-tutorial/05-local-integration-claude-desktop-and-inspector.md
index 2c4311db..16980c70 100644
--- a/tutorials/create-python-server-tutorial/05-local-integration-claude-desktop-and-inspector.md
+++ b/tutorials/create-python-server-tutorial/05-local-integration-claude-desktop-and-inspector.md
@@ -626,7 +626,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Runtime, Dependencies, and uv Packaging](04-runtime-dependencies-and-uv-packaging.md)
 - [Next Chapter: Chapter 6: Customization and Extension Patterns](06-customization-and-extension-patterns.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/create-python-server-tutorial/06-customization-and-extension-patterns.md b/tutorials/create-python-server-tutorial/06-customization-and-extension-patterns.md
index 19f591f2..ff9e48aa 100644
--- a/tutorials/create-python-server-tutorial/06-customization-and-extension-patterns.md
+++ b/tutorials/create-python-server-tutorial/06-customization-and-extension-patterns.md
@@ -626,7 +626,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Local Integration: Claude Desktop and Inspector](05-local-integration-claude-desktop-and-inspector.md)
 - [Next Chapter: Chapter 7: Quality, Security, and Contribution Workflows](07-quality-security-and-contribution-workflows.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/create-python-server-tutorial/07-quality-security-and-contribution-workflows.md b/tutorials/create-python-server-tutorial/07-quality-security-and-contribution-workflows.md
index efe7674f..68a406c3 100644
--- a/tutorials/create-python-server-tutorial/07-quality-security-and-contribution-workflows.md
+++ b/tutorials/create-python-server-tutorial/07-quality-security-and-contribution-workflows.md
@@ -631,7 +631,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Customization and Extension Patterns](06-customization-and-extension-patterns.md)
 - [Next Chapter: Chapter 8: Archived Status, Migration, and Long-Term Operations](08-archived-status-migration-and-long-term-operations.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/create-python-server-tutorial/08-archived-status-migration-and-long-term-operations.md b/tutorials/create-python-server-tutorial/08-archived-status-migration-and-long-term-operations.md
index e21efe44..ade28291 100644
--- a/tutorials/create-python-server-tutorial/08-archived-status-migration-and-long-term-operations.md
+++ b/tutorials/create-python-server-tutorial/08-archived-status-migration-and-long-term-operations.md
@@ -38,7 +38,7 @@ This chapter covers long-term maintenance strategy for teams relying on archived
 
 You now have a long-term operating model for scaffold-derived Python MCP services in archived-tool scenarios.
 
-Return to the [Create Python Server Tutorial index](index.md).
+Return to the [Create Python Server Tutorial index](README.md).
 
 ## Depth Expansion Playbook
 
@@ -629,7 +629,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Quality, Security, and Contribution Workflows](07-quality-security-and-contribution-workflows.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/create-python-server-tutorial/index.md b/tutorials/create-python-server-tutorial/README.md
similarity index 100%
rename from tutorials/create-python-server-tutorial/index.md
rename to tutorials/create-python-server-tutorial/README.md
diff --git a/tutorials/create-typescript-server-tutorial/01-getting-started-and-scaffolding-flow.md b/tutorials/create-typescript-server-tutorial/01-getting-started-and-scaffolding-flow.md
index 71f8998f..a6b1a37a 100644
--- a/tutorials/create-typescript-server-tutorial/01-getting-started-and-scaffolding-flow.md
+++ b/tutorials/create-typescript-server-tutorial/01-getting-started-and-scaffolding-flow.md
@@ -633,7 +633,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Generated Structure and Build Pipeline](02-generated-structure-and-build-pipeline.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/create-typescript-server-tutorial/02-generated-structure-and-build-pipeline.md b/tutorials/create-typescript-server-tutorial/02-generated-structure-and-build-pipeline.md
index eb0eeca5..9665680e 100644
--- a/tutorials/create-typescript-server-tutorial/02-generated-structure-and-build-pipeline.md
+++ b/tutorials/create-typescript-server-tutorial/02-generated-structure-and-build-pipeline.md
@@ -634,7 +634,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started and Scaffolding Flow](01-getting-started-and-scaffolding-flow.md)
 - [Next Chapter: Chapter 3: Template MCP Primitives: Resources, Tools, Prompts](03-template-mcp-primitives-resources-tools-prompts.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/create-typescript-server-tutorial/03-template-mcp-primitives-resources-tools-prompts.md b/tutorials/create-typescript-server-tutorial/03-template-mcp-primitives-resources-tools-prompts.md
index e7d8f3e3..b4ab755a 100644
--- a/tutorials/create-typescript-server-tutorial/03-template-mcp-primitives-resources-tools-prompts.md
+++ b/tutorials/create-typescript-server-tutorial/03-template-mcp-primitives-resources-tools-prompts.md
@@ -634,7 +634,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Generated Structure and Build Pipeline](02-generated-structure-and-build-pipeline.md)
 - [Next Chapter: Chapter 4: Configuration, Metadata, and Packaging](04-configuration-metadata-and-packaging.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/create-typescript-server-tutorial/04-configuration-metadata-and-packaging.md b/tutorials/create-typescript-server-tutorial/04-configuration-metadata-and-packaging.md
index 376cec23..11305427 100644
--- a/tutorials/create-typescript-server-tutorial/04-configuration-metadata-and-packaging.md
+++ b/tutorials/create-typescript-server-tutorial/04-configuration-metadata-and-packaging.md
@@ -634,7 +634,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Template MCP Primitives: Resources, Tools, Prompts](03-template-mcp-primitives-resources-tools-prompts.md)
 - [Next Chapter: Chapter 5: Development Workflows: Build, Watch, and Link](05-development-workflows-build-watch-and-link.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/create-typescript-server-tutorial/05-development-workflows-build-watch-and-link.md b/tutorials/create-typescript-server-tutorial/05-development-workflows-build-watch-and-link.md
index cde40680..55aebb0b 100644
--- a/tutorials/create-typescript-server-tutorial/05-development-workflows-build-watch-and-link.md
+++ b/tutorials/create-typescript-server-tutorial/05-development-workflows-build-watch-and-link.md
@@ -628,7 +628,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Configuration, Metadata, and Packaging](04-configuration-metadata-and-packaging.md)
 - [Next Chapter: Chapter 6: Debugging and Local Integration](06-debugging-and-local-integration.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/create-typescript-server-tutorial/06-debugging-and-local-integration.md b/tutorials/create-typescript-server-tutorial/06-debugging-and-local-integration.md
index 417b547f..409f0e0b 100644
--- a/tutorials/create-typescript-server-tutorial/06-debugging-and-local-integration.md
+++ b/tutorials/create-typescript-server-tutorial/06-debugging-and-local-integration.md
@@ -634,7 +634,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Development Workflows: Build, Watch, and Link](05-development-workflows-build-watch-and-link.md)
 - [Next Chapter: Chapter 7: Quality, Security, and Contribution Practices](07-quality-security-and-contribution-practices.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/create-typescript-server-tutorial/07-quality-security-and-contribution-practices.md b/tutorials/create-typescript-server-tutorial/07-quality-security-and-contribution-practices.md
index 844d718b..6e35ca34 100644
--- a/tutorials/create-typescript-server-tutorial/07-quality-security-and-contribution-practices.md
+++ b/tutorials/create-typescript-server-tutorial/07-quality-security-and-contribution-practices.md
@@ -634,7 +634,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Debugging and Local Integration](06-debugging-and-local-integration.md)
 - [Next Chapter: Chapter 8: Archived Status, Migration, and Long-Term Strategy](08-archived-status-migration-and-long-term-strategy.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/create-typescript-server-tutorial/08-archived-status-migration-and-long-term-strategy.md b/tutorials/create-typescript-server-tutorial/08-archived-status-migration-and-long-term-strategy.md
index 37fcae9c..cf42969f 100644
--- a/tutorials/create-typescript-server-tutorial/08-archived-status-migration-and-long-term-strategy.md
+++ b/tutorials/create-typescript-server-tutorial/08-archived-status-migration-and-long-term-strategy.md
@@ -38,7 +38,7 @@ This chapter defines long-term maintenance strategy when relying on archived sca
 
 You now have a pragmatic long-term strategy for scaffold-based TypeScript MCP server development.
 
-Return to the [Create TypeScript Server Tutorial index](index.md).
+Return to the [Create TypeScript Server Tutorial index](README.md).
 
 ## Depth Expansion Playbook
 
@@ -632,7 +632,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Quality, Security, and Contribution Practices](07-quality-security-and-contribution-practices.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/create-typescript-server-tutorial/index.md b/tutorials/create-typescript-server-tutorial/README.md
similarity index 100%
rename from tutorials/create-typescript-server-tutorial/index.md
rename to tutorials/create-typescript-server-tutorial/README.md
diff --git a/tutorials/crewai-tutorial/01-getting-started.md b/tutorials/crewai-tutorial/01-getting-started.md
index c0f9a0cb..5534b040 100644
--- a/tutorials/crewai-tutorial/01-getting-started.md
+++ b/tutorials/crewai-tutorial/01-getting-started.md
@@ -447,7 +447,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Agent Roles & Specializations](02-agent-roles.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/crewai-tutorial/02-agent-roles.md b/tutorials/crewai-tutorial/02-agent-roles.md
index 3dfdeb0c..45298875 100644
--- a/tutorials/crewai-tutorial/02-agent-roles.md
+++ b/tutorials/crewai-tutorial/02-agent-roles.md
@@ -563,7 +563,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started with CrewAI](01-getting-started.md)
 - [Next Chapter: Chapter 3: Task Definition & Planning](03-task-planning.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/crewai-tutorial/03-task-planning.md b/tutorials/crewai-tutorial/03-task-planning.md
index 5fdd3649..ade48de2 100644
--- a/tutorials/crewai-tutorial/03-task-planning.md
+++ b/tutorials/crewai-tutorial/03-task-planning.md
@@ -494,7 +494,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Agent Roles & Specializations](02-agent-roles.md)
 - [Next Chapter: Chapter 4: Tool Integration](04-tool-integration.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/crewai-tutorial/04-tool-integration.md b/tutorials/crewai-tutorial/04-tool-integration.md
index ac731c95..3a211456 100644
--- a/tutorials/crewai-tutorial/04-tool-integration.md
+++ b/tutorials/crewai-tutorial/04-tool-integration.md
@@ -545,7 +545,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Task Definition & Planning](03-task-planning.md)
 - [Next Chapter: Chapter 5: Crew Communication](05-crew-communication.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/crewai-tutorial/05-crew-communication.md b/tutorials/crewai-tutorial/05-crew-communication.md
index 2b9805d8..59b32b35 100644
--- a/tutorials/crewai-tutorial/05-crew-communication.md
+++ b/tutorials/crewai-tutorial/05-crew-communication.md
@@ -554,7 +554,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Tool Integration](04-tool-integration.md)
 - [Next Chapter: Chapter 6: Process Management](06-process-management.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/crewai-tutorial/06-process-management.md b/tutorials/crewai-tutorial/06-process-management.md
index ec5ab5ea..2b6bc85b 100644
--- a/tutorials/crewai-tutorial/06-process-management.md
+++ b/tutorials/crewai-tutorial/06-process-management.md
@@ -555,7 +555,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Crew Communication](05-crew-communication.md)
 - [Next Chapter: Chapter 7: Advanced Crew Patterns](07-advanced-patterns.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/crewai-tutorial/07-advanced-patterns.md b/tutorials/crewai-tutorial/07-advanced-patterns.md
index bdc35672..9b7f4e3c 100644
--- a/tutorials/crewai-tutorial/07-advanced-patterns.md
+++ b/tutorials/crewai-tutorial/07-advanced-patterns.md
@@ -572,7 +572,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Process Management](06-process-management.md)
 - [Next Chapter: Chapter 8: Production Deployment](08-production-deployment.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/crewai-tutorial/08-production-deployment.md b/tutorials/crewai-tutorial/08-production-deployment.md
index 0bff3a52..a96b2885 100644
--- a/tutorials/crewai-tutorial/08-production-deployment.md
+++ b/tutorials/crewai-tutorial/08-production-deployment.md
@@ -616,7 +616,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Advanced Crew Patterns](07-advanced-patterns.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/crewai-tutorial/index.md b/tutorials/crewai-tutorial/README.md
similarity index 100%
rename from tutorials/crewai-tutorial/index.md
rename to tutorials/crewai-tutorial/README.md
diff --git a/tutorials/crush-tutorial/01-getting-started.md b/tutorials/crush-tutorial/01-getting-started.md
index 70432426..fb9c5a74 100644
--- a/tutorials/crush-tutorial/01-getting-started.md
+++ b/tutorials/crush-tutorial/01-getting-started.md
@@ -631,7 +631,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Architecture and Session Model](02-architecture-and-session-model.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/crush-tutorial/02-architecture-and-session-model.md b/tutorials/crush-tutorial/02-architecture-and-session-model.md
index af0e0699..37ef899c 100644
--- a/tutorials/crush-tutorial/02-architecture-and-session-model.md
+++ b/tutorials/crush-tutorial/02-architecture-and-session-model.md
@@ -632,7 +632,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started](01-getting-started.md)
 - [Next Chapter: Chapter 3: Providers and Model Configuration](03-providers-and-model-configuration.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/crush-tutorial/03-providers-and-model-configuration.md b/tutorials/crush-tutorial/03-providers-and-model-configuration.md
index 174608f0..6dc9e0d8 100644
--- a/tutorials/crush-tutorial/03-providers-and-model-configuration.md
+++ b/tutorials/crush-tutorial/03-providers-and-model-configuration.md
@@ -626,7 +626,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Architecture and Session Model](02-architecture-and-session-model.md)
 - [Next Chapter: Chapter 4: Permissions and Tool Controls](04-permissions-and-tool-controls.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/crush-tutorial/04-permissions-and-tool-controls.md b/tutorials/crush-tutorial/04-permissions-and-tool-controls.md
index 29b2838b..cfdabef7 100644
--- a/tutorials/crush-tutorial/04-permissions-and-tool-controls.md
+++ b/tutorials/crush-tutorial/04-permissions-and-tool-controls.md
@@ -636,7 +636,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Providers and Model Configuration](03-providers-and-model-configuration.md)
 - [Next Chapter: Chapter 5: LSP and MCP Integration](05-lsp-and-mcp-integration.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/crush-tutorial/05-lsp-and-mcp-integration.md b/tutorials/crush-tutorial/05-lsp-and-mcp-integration.md
index c057db6c..ac92dcd4 100644
--- a/tutorials/crush-tutorial/05-lsp-and-mcp-integration.md
+++ b/tutorials/crush-tutorial/05-lsp-and-mcp-integration.md
@@ -635,7 +635,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Permissions and Tool Controls](04-permissions-and-tool-controls.md)
 - [Next Chapter: Chapter 6: Skills, Commands, and Workflow Customization](06-skills-commands-and-workflow-customization.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/crush-tutorial/06-skills-commands-and-workflow-customization.md b/tutorials/crush-tutorial/06-skills-commands-and-workflow-customization.md
index dac4cc88..853ff9b9 100644
--- a/tutorials/crush-tutorial/06-skills-commands-and-workflow-customization.md
+++ b/tutorials/crush-tutorial/06-skills-commands-and-workflow-customization.md
@@ -633,7 +633,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: LSP and MCP Integration](05-lsp-and-mcp-integration.md)
 - [Next Chapter: Chapter 7: Logs, Debugging, and Operations](07-logs-debugging-and-operations.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/crush-tutorial/07-logs-debugging-and-operations.md b/tutorials/crush-tutorial/07-logs-debugging-and-operations.md
index 31acbd9f..fac21232 100644
--- a/tutorials/crush-tutorial/07-logs-debugging-and-operations.md
+++ b/tutorials/crush-tutorial/07-logs-debugging-and-operations.md
@@ -637,7 +637,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Skills, Commands, and Workflow Customization](06-skills-commands-and-workflow-customization.md)
 - [Next Chapter: Chapter 8: Production Governance and Rollout](08-production-governance-and-rollout.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/crush-tutorial/08-production-governance-and-rollout.md b/tutorials/crush-tutorial/08-production-governance-and-rollout.md
index 7774affc..9a254ead 100644
--- a/tutorials/crush-tutorial/08-production-governance-and-rollout.md
+++ b/tutorials/crush-tutorial/08-production-governance-and-rollout.md
@@ -626,7 +626,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Logs, Debugging, and Operations](07-logs-debugging-and-operations.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/crush-tutorial/index.md b/tutorials/crush-tutorial/README.md
similarity index 100%
rename from tutorials/crush-tutorial/index.md
rename to tutorials/crush-tutorial/README.md
diff --git a/tutorials/daytona-tutorial/01-getting-started.md b/tutorials/daytona-tutorial/01-getting-started.md
index 68c7281e..604b7856 100644
--- a/tutorials/daytona-tutorial/01-getting-started.md
+++ b/tutorials/daytona-tutorial/01-getting-started.md
@@ -638,7 +638,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Sandbox Lifecycle, Resources, and Regions](02-sandbox-lifecycle-resources-and-regions.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/daytona-tutorial/02-sandbox-lifecycle-resources-and-regions.md b/tutorials/daytona-tutorial/02-sandbox-lifecycle-resources-and-regions.md
index d3ae15e1..494eef2e 100644
--- a/tutorials/daytona-tutorial/02-sandbox-lifecycle-resources-and-regions.md
+++ b/tutorials/daytona-tutorial/02-sandbox-lifecycle-resources-and-regions.md
@@ -634,7 +634,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started](01-getting-started.md)
 - [Next Chapter: Chapter 3: Process and Code Execution Patterns](03-process-and-code-execution-patterns.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/daytona-tutorial/03-process-and-code-execution-patterns.md b/tutorials/daytona-tutorial/03-process-and-code-execution-patterns.md
index f26bd569..9bfb3b57 100644
--- a/tutorials/daytona-tutorial/03-process-and-code-execution-patterns.md
+++ b/tutorials/daytona-tutorial/03-process-and-code-execution-patterns.md
@@ -634,7 +634,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Sandbox Lifecycle, Resources, and Regions](02-sandbox-lifecycle-resources-and-regions.md)
 - [Next Chapter: Chapter 4: File, Git, and Preview Workflows](04-file-git-and-preview-workflows.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/daytona-tutorial/04-file-git-and-preview-workflows.md b/tutorials/daytona-tutorial/04-file-git-and-preview-workflows.md
index e8245002..04f0ca10 100644
--- a/tutorials/daytona-tutorial/04-file-git-and-preview-workflows.md
+++ b/tutorials/daytona-tutorial/04-file-git-and-preview-workflows.md
@@ -634,7 +634,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Process and Code Execution Patterns](03-process-and-code-execution-patterns.md)
 - [Next Chapter: Chapter 5: MCP Agent Integration and Tooling](05-mcp-agent-integration-and-tooling.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/daytona-tutorial/05-mcp-agent-integration-and-tooling.md b/tutorials/daytona-tutorial/05-mcp-agent-integration-and-tooling.md
index 5fbc6810..b1dd5bcf 100644
--- a/tutorials/daytona-tutorial/05-mcp-agent-integration-and-tooling.md
+++ b/tutorials/daytona-tutorial/05-mcp-agent-integration-and-tooling.md
@@ -633,7 +633,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: File, Git, and Preview Workflows](04-file-git-and-preview-workflows.md)
 - [Next Chapter: Chapter 6: Configuration, API, and Deployment Models](06-configuration-api-and-deployment-models.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/daytona-tutorial/06-configuration-api-and-deployment-models.md b/tutorials/daytona-tutorial/06-configuration-api-and-deployment-models.md
index c6d453cd..b808cfe1 100644
--- a/tutorials/daytona-tutorial/06-configuration-api-and-deployment-models.md
+++ b/tutorials/daytona-tutorial/06-configuration-api-and-deployment-models.md
@@ -633,7 +633,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: MCP Agent Integration and Tooling](05-mcp-agent-integration-and-tooling.md)
 - [Next Chapter: Chapter 7: Limits, Network Controls, and Security](07-limits-network-controls-and-security.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/daytona-tutorial/07-limits-network-controls-and-security.md b/tutorials/daytona-tutorial/07-limits-network-controls-and-security.md
index c8d62e96..ad7509a4 100644
--- a/tutorials/daytona-tutorial/07-limits-network-controls-and-security.md
+++ b/tutorials/daytona-tutorial/07-limits-network-controls-and-security.md
@@ -633,7 +633,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Configuration, API, and Deployment Models](06-configuration-api-and-deployment-models.md)
 - [Next Chapter: Chapter 8: Production Operations and Contribution](08-production-operations-and-contribution.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/daytona-tutorial/08-production-operations-and-contribution.md b/tutorials/daytona-tutorial/08-production-operations-and-contribution.md
index 912b737f..7b9f85c1 100644
--- a/tutorials/daytona-tutorial/08-production-operations-and-contribution.md
+++ b/tutorials/daytona-tutorial/08-production-operations-and-contribution.md
@@ -635,7 +635,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Limits, Network Controls, and Security](07-limits-network-controls-and-security.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/daytona-tutorial/index.md b/tutorials/daytona-tutorial/README.md
similarity index 100%
rename from tutorials/daytona-tutorial/index.md
rename to tutorials/daytona-tutorial/README.md
diff --git a/tutorials/deer-flow-tutorial/01-getting-started.md b/tutorials/deer-flow-tutorial/01-getting-started.md
index 1921e7f3..b01fa15b 100644
--- a/tutorials/deer-flow-tutorial/01-getting-started.md
+++ b/tutorials/deer-flow-tutorial/01-getting-started.md
@@ -665,7 +665,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Workflow Basics](02-workflow-basics.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/deer-flow-tutorial/02-workflow-basics.md b/tutorials/deer-flow-tutorial/02-workflow-basics.md
index ee2cc4db..6a5816cb 100644
--- a/tutorials/deer-flow-tutorial/02-workflow-basics.md
+++ b/tutorials/deer-flow-tutorial/02-workflow-basics.md
@@ -518,7 +518,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started with Deer Flow](01-getting-started.md)
 - [Next Chapter: Chapter 3: Task Management](03-task-management.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/deer-flow-tutorial/03-task-management.md b/tutorials/deer-flow-tutorial/03-task-management.md
index 59417de0..e28018f6 100644
--- a/tutorials/deer-flow-tutorial/03-task-management.md
+++ b/tutorials/deer-flow-tutorial/03-task-management.md
@@ -552,7 +552,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Workflow Basics](02-workflow-basics.md)
 - [Next Chapter: Chapter 4: Dependencies](04-dependencies.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/deer-flow-tutorial/04-dependencies.md b/tutorials/deer-flow-tutorial/04-dependencies.md
index f661389e..a7bb9448 100644
--- a/tutorials/deer-flow-tutorial/04-dependencies.md
+++ b/tutorials/deer-flow-tutorial/04-dependencies.md
@@ -502,7 +502,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Task Management](03-task-management.md)
 - [Next Chapter: Chapter 5: Error Handling](05-error-handling.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/deer-flow-tutorial/05-error-handling.md b/tutorials/deer-flow-tutorial/05-error-handling.md
index 75a0900e..6f3f91e3 100644
--- a/tutorials/deer-flow-tutorial/05-error-handling.md
+++ b/tutorials/deer-flow-tutorial/05-error-handling.md
@@ -554,7 +554,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Dependencies](04-dependencies.md)
 - [Next Chapter: Chapter 6: Scaling](06-scaling.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/deer-flow-tutorial/06-scaling.md b/tutorials/deer-flow-tutorial/06-scaling.md
index b78da6c9..5fbd4367 100644
--- a/tutorials/deer-flow-tutorial/06-scaling.md
+++ b/tutorials/deer-flow-tutorial/06-scaling.md
@@ -564,7 +564,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Error Handling](05-error-handling.md)
 - [Next Chapter: Chapter 7: Monitoring](07-monitoring.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/deer-flow-tutorial/07-monitoring.md b/tutorials/deer-flow-tutorial/07-monitoring.md
index 10c318bb..af13d25b 100644
--- a/tutorials/deer-flow-tutorial/07-monitoring.md
+++ b/tutorials/deer-flow-tutorial/07-monitoring.md
@@ -583,7 +583,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Scaling](06-scaling.md)
 - [Next Chapter: Chapter 8: Advanced Patterns](08-advanced-patterns.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/deer-flow-tutorial/08-advanced-patterns.md b/tutorials/deer-flow-tutorial/08-advanced-patterns.md
index c3c78329..966da0d6 100644
--- a/tutorials/deer-flow-tutorial/08-advanced-patterns.md
+++ b/tutorials/deer-flow-tutorial/08-advanced-patterns.md
@@ -536,7 +536,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Monitoring](07-monitoring.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/deer-flow-tutorial/index.md b/tutorials/deer-flow-tutorial/README.md
similarity index 100%
rename from tutorials/deer-flow-tutorial/index.md
rename to tutorials/deer-flow-tutorial/README.md
diff --git a/tutorials/devika-tutorial/01-getting-started.md b/tutorials/devika-tutorial/01-getting-started.md
index df16e41a..14d9fcdd 100644
--- a/tutorials/devika-tutorial/01-getting-started.md
+++ b/tutorials/devika-tutorial/01-getting-started.md
@@ -221,7 +221,7 @@ Devika's installation complexity stems from having three distinct runtimes (Pyth
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Architecture and Agent Pipeline](02-architecture-and-agent-pipeline.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/devika-tutorial/02-architecture-and-agent-pipeline.md b/tutorials/devika-tutorial/02-architecture-and-agent-pipeline.md
index 1821b224..3ece6f09 100644
--- a/tutorials/devika-tutorial/02-architecture-and-agent-pipeline.md
+++ b/tutorials/devika-tutorial/02-architecture-and-agent-pipeline.md
@@ -221,7 +221,7 @@ Devika's multi-agent architecture solves the single-agent context window and cap
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started](01-getting-started.md)
 - [Next Chapter: Chapter 3: LLM Provider Configuration](03-llm-provider-configuration.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/devika-tutorial/03-llm-provider-configuration.md b/tutorials/devika-tutorial/03-llm-provider-configuration.md
index 616e6c47..f9972779 100644
--- a/tutorials/devika-tutorial/03-llm-provider-configuration.md
+++ b/tutorials/devika-tutorial/03-llm-provider-configuration.md
@@ -221,7 +221,7 @@ Devika's multi-provider configuration model solves the vendor lock-in and cost o
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Architecture and Agent Pipeline](02-architecture-and-agent-pipeline.md)
 - [Next Chapter: Chapter 4: Task Planning and Code Generation](04-task-planning-and-code-generation.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/devika-tutorial/04-task-planning-and-code-generation.md b/tutorials/devika-tutorial/04-task-planning-and-code-generation.md
index 51de5d69..b0b28eea 100644
--- a/tutorials/devika-tutorial/04-task-planning-and-code-generation.md
+++ b/tutorials/devika-tutorial/04-task-planning-and-code-generation.md
@@ -221,7 +221,7 @@ Devika's task planning and code generation pipeline solves the coherence problem
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: LLM Provider Configuration](03-llm-provider-configuration.md)
 - [Next Chapter: Chapter 5: Web Research and Browser Integration](05-web-research-and-browser-integration.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/devika-tutorial/05-web-research-and-browser-integration.md b/tutorials/devika-tutorial/05-web-research-and-browser-integration.md
index 60d2bea8..5d8f52f1 100644
--- a/tutorials/devika-tutorial/05-web-research-and-browser-integration.md
+++ b/tutorials/devika-tutorial/05-web-research-and-browser-integration.md
@@ -221,7 +221,7 @@ Devika's browser research integration solves the knowledge cutoff and documentat
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Task Planning and Code Generation](04-task-planning-and-code-generation.md)
 - [Next Chapter: Chapter 6: Project Management and Workspaces](06-project-management-and-workspaces.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/devika-tutorial/06-project-management-and-workspaces.md b/tutorials/devika-tutorial/06-project-management-and-workspaces.md
index 9230dee7..956d5463 100644
--- a/tutorials/devika-tutorial/06-project-management-and-workspaces.md
+++ b/tutorials/devika-tutorial/06-project-management-and-workspaces.md
@@ -221,7 +221,7 @@ Devika's project and workspace management layer solves the isolation and traceab
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Web Research and Browser Integration](05-web-research-and-browser-integration.md)
 - [Next Chapter: Chapter 7: Debugging and Troubleshooting](07-debugging-and-troubleshooting.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/devika-tutorial/07-debugging-and-troubleshooting.md b/tutorials/devika-tutorial/07-debugging-and-troubleshooting.md
index 42adce00..8cd495aa 100644
--- a/tutorials/devika-tutorial/07-debugging-and-troubleshooting.md
+++ b/tutorials/devika-tutorial/07-debugging-and-troubleshooting.md
@@ -221,7 +221,7 @@ Devika's multi-agent pipeline creates multiple potential failure points that are
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Project Management and Workspaces](06-project-management-and-workspaces.md)
 - [Next Chapter: Chapter 8: Production Operations and Governance](08-production-operations-and-governance.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/devika-tutorial/08-production-operations-and-governance.md b/tutorials/devika-tutorial/08-production-operations-and-governance.md
index 254b4455..68325746 100644
--- a/tutorials/devika-tutorial/08-production-operations-and-governance.md
+++ b/tutorials/devika-tutorial/08-production-operations-and-governance.md
@@ -36,7 +36,7 @@ This chapter covers team deployment strategies, security hardening, API cost gov
 
 You now have a complete production governance framework for Devika covering security, cost controls, code review policies, and operational runbooks for safe team-scale autonomous coding.
 
-Return to: [Tutorial Index](index.md)
+Return to: [Tutorial Index](README.md)
 
 ## Depth Expansion Playbook
 
@@ -221,7 +221,7 @@ Devika's production governance framework solves the accountability and blast-rad
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Debugging and Troubleshooting](07-debugging-and-troubleshooting.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/devika-tutorial/index.md b/tutorials/devika-tutorial/README.md
similarity index 100%
rename from tutorials/devika-tutorial/index.md
rename to tutorials/devika-tutorial/README.md
diff --git a/tutorials/dify-platform-deep-dive/01-system-overview.md b/tutorials/dify-platform-deep-dive/01-system-overview.md
index f4d272f8..ed34b295 100644
--- a/tutorials/dify-platform-deep-dive/01-system-overview.md
+++ b/tutorials/dify-platform-deep-dive/01-system-overview.md
@@ -294,7 +294,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Core Architecture](02-core-architecture.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/dify-platform-deep-dive/02-core-architecture.md b/tutorials/dify-platform-deep-dive/02-core-architecture.md
index 5d3ee15d..b020ec61 100644
--- a/tutorials/dify-platform-deep-dive/02-core-architecture.md
+++ b/tutorials/dify-platform-deep-dive/02-core-architecture.md
@@ -470,7 +470,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Dify System Overview](01-system-overview.md)
 - [Next Chapter: Chapter 3: Workflow Engine](03-workflow-engine.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/dify-platform-deep-dive/03-workflow-engine.md b/tutorials/dify-platform-deep-dive/03-workflow-engine.md
index d22332ff..f57be014 100644
--- a/tutorials/dify-platform-deep-dive/03-workflow-engine.md
+++ b/tutorials/dify-platform-deep-dive/03-workflow-engine.md
@@ -601,7 +601,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Core Architecture](02-core-architecture.md)
 - [Next Chapter: Chapter 4: RAG Implementation](04-rag-implementation.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/dify-platform-deep-dive/04-rag-implementation.md b/tutorials/dify-platform-deep-dive/04-rag-implementation.md
index 5db66ead..ca46adb4 100644
--- a/tutorials/dify-platform-deep-dive/04-rag-implementation.md
+++ b/tutorials/dify-platform-deep-dive/04-rag-implementation.md
@@ -690,7 +690,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Workflow Engine](03-workflow-engine.md)
 - [Next Chapter: Chapter 5: Agent Framework](05-agent-framework.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/dify-platform-deep-dive/05-agent-framework.md b/tutorials/dify-platform-deep-dive/05-agent-framework.md
index b53885ed..31378425 100644
--- a/tutorials/dify-platform-deep-dive/05-agent-framework.md
+++ b/tutorials/dify-platform-deep-dive/05-agent-framework.md
@@ -658,7 +658,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: RAG Implementation](04-rag-implementation.md)
 - [Next Chapter: Chapter 6: Custom Nodes](06-custom-nodes.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/dify-platform-deep-dive/06-custom-nodes.md b/tutorials/dify-platform-deep-dive/06-custom-nodes.md
index 24143359..f4fc4195 100644
--- a/tutorials/dify-platform-deep-dive/06-custom-nodes.md
+++ b/tutorials/dify-platform-deep-dive/06-custom-nodes.md
@@ -835,7 +835,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Agent Framework](05-agent-framework.md)
 - [Next Chapter: Chapter 7: Production Deployment](07-production-deployment.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/dify-platform-deep-dive/07-production-deployment.md b/tutorials/dify-platform-deep-dive/07-production-deployment.md
index a95e93bc..597df3ce 100644
--- a/tutorials/dify-platform-deep-dive/07-production-deployment.md
+++ b/tutorials/dify-platform-deep-dive/07-production-deployment.md
@@ -1140,7 +1140,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Custom Nodes](06-custom-nodes.md)
 - [Next Chapter: Chapter 8: Operations Playbook](08-operations-playbook.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/dify-platform-deep-dive/08-operations-playbook.md b/tutorials/dify-platform-deep-dive/08-operations-playbook.md
index 8cad92b0..3c0379be 100644
--- a/tutorials/dify-platform-deep-dive/08-operations-playbook.md
+++ b/tutorials/dify-platform-deep-dive/08-operations-playbook.md
@@ -37,7 +37,7 @@ This chapter consolidates practical operations patterns for running Dify at scal
 You now have full Dify tutorial coverage from architecture through production operations.
 
 Related:
-- [Dify Index](index.md)
+- [Dify Index](README.md)
 - [Setup Guide](docs/setup.md)
 
 ## What Problem Does This Solve?
@@ -80,7 +80,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Production Deployment](07-production-deployment.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/dify-platform-deep-dive/README.md b/tutorials/dify-platform-deep-dive/README.md
index d37a346d..cad278d5 100644
--- a/tutorials/dify-platform-deep-dive/README.md
+++ b/tutorials/dify-platform-deep-dive/README.md
@@ -1,40 +1,143 @@
-# Dify Platform Deep Dive
+---
+layout: default
+title: "Dify Platform Deep Dive"
+nav_order: 3
+has_children: true
+format_version: v2
+---
+
+# Dify Platform: Deep Dive Tutorial
+
+> **Project**: [Dify](https://github.com/langgenius/dify) — An open-source LLM application development platform for building workflows, RAG pipelines, and AI agents with a visual interface.
+
+[![Stars](https://img.shields.io/github/stars/langgenius/dify?style=social)](https://github.com/langgenius/dify)
+[![License: Apache 2.0](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
+[![Python](https://img.shields.io/badge/Python-Flask-blue)](https://github.com/langgenius/dify)
+
+## Why This Track Matters
+
+Dify provides a complete open-source platform for building LLM applications with a visual workflow editor, RAG pipeline, and agent framework — reducing the time from idea to deployed AI application.
 
-A focused architecture tutorial for Dify workflows, RAG systems, and production operations.
+This track focuses on:
+- building and deploying LLM workflows with Dify's drag-and-drop node system
+- implementing RAG pipelines with multi-stage document processing and vector search
+- orchestrating agents with tool-calling loops and reasoning chain management
+- operating Dify in production with Docker, monitoring, and security controls
 
-## Current Status
+## What Is Dify?
 
-Core chapter set is now published.
+Dify is an open-source LLM application platform that provides a visual interface for building AI workflows, RAG systems, and agent frameworks. It supports orchestrating complex LLM pipelines with a drag-and-drop node system and offers one-click deployment via Docker.
 
-| Item | Status |
-|:-----|:-------|
-| Published chapter docs | 8 + setup guide |
-| Canonical entry point | [index.md](index.md) |
+| Feature | Description |
+|---------|-------------|
+| **Visual Workflows** | Drag-and-drop node system for chaining LLM operations |
+| **RAG Pipeline** | Multi-stage document processing with vector storage and retrieval |
+| **Agent Framework** | Tool-calling loops and reasoning chain management |
+| **Multi-Model** | OpenAI, Anthropic, Google, local models via Ollama |
+| **Plugin System** | Extensible architecture for custom nodes and integrations |
+| **Deployment** | One-click Docker Compose deployment |
 
-## Published Chapters
+## Mental Model
 
-| Chapter | File | Focus |
-|:--------|:-----|:------|
-| 1 | [01-system-overview.md](01-system-overview.md) | Platform overview and ecosystem context |
-| 2 | [02-core-architecture.md](02-core-architecture.md) | Service boundaries and data flow |
-| 3 | [03-workflow-engine.md](03-workflow-engine.md) | Node orchestration and execution model |
-| 4 | [04-rag-implementation.md](04-rag-implementation.md) | Retrieval architecture and indexing |
-| 5 | [05-agent-framework.md](05-agent-framework.md) | Agent loops and tool invocation |
-| 6 | [06-custom-nodes.md](06-custom-nodes.md) | Extensibility and plugin authoring |
-| 7 | [07-production-deployment.md](07-production-deployment.md) | Deployment, scaling, and hardening |
-| 8 | [08-operations-playbook.md](08-operations-playbook.md) | Incident response, SLOs, and cost controls |
-| Setup | [docs/setup.md](docs/setup.md) | Environment setup for local exploration |
+```mermaid
+graph TB
+    subgraph Frontend["React Frontend"]
+        UI[Visual Workflow Editor]
+        CHAT[Chat Interface]
+        ADMIN[Admin Console]
+    end
 
-## Suggested Reading Order
+    subgraph Backend["Flask Backend"]
+        WF[Workflow Engine]
+        RAG[RAG Pipeline]
+        AGENT[Agent Framework]
+        API[REST API]
+    end
 
-1. Start with [index.md](index.md).
-2. Read chapters [1](01-system-overview.md) through [8](08-operations-playbook.md) in order.
-3. Use [docs/setup.md](docs/setup.md) for environment setup.
+    subgraph Storage["Storage"]
+        PG[(PostgreSQL)]
+        REDIS[(Redis)]
+        VEC[(Vector Store)]
+        S3[Object Storage]
+    end
 
-## Upstream Project
+    subgraph LLM["LLM Providers"]
+        OAI[OpenAI]
+        CLAUDE[Anthropic]
+        LOCAL[Ollama]
+    end
 
-- Dify repository: <https://github.com/langgenius/dify>
+    Frontend --> Backend
+    Backend --> Storage
+    Backend --> LLM
+```
+
+## Chapter Guide
+
+| Chapter | Topic | What You'll Learn |
+|---------|-------|-------------------|
+| [1. System Overview](01-system-overview.md) | Architecture | Dify's place in the LLM ecosystem, core components |
+| [2. Core Architecture](02-core-architecture.md) | Design | Components, data flow, service boundaries |
+| [3. Workflow Engine](03-workflow-engine.md) | Orchestration | Node system, visual workflows, execution pipeline |
+| [4. RAG Implementation](04-rag-implementation.md) | Retrieval | Document processing, embeddings, vector search |
+| [5. Agent Framework](05-agent-framework.md) | Agents | Tool calling, reasoning loops, agent types |
+| [6. Custom Nodes](06-custom-nodes.md) | Extensibility | Building custom workflow nodes and plugins |
+| [7. Production Deployment](07-production-deployment.md) | Operations | Docker, scaling, monitoring, security |
+| [8. Operations Playbook](08-operations-playbook.md) | Reliability | Incident response, SLOs, and cost controls |
+
+## Tech Stack
+
+| Component | Technology |
+|-----------|-----------|
+| **Backend** | Python, Flask |
+| **Frontend** | React, TypeScript |
+| **Database** | PostgreSQL |
+| **Cache** | Redis |
+| **Vector Store** | Weaviate, Qdrant, pgvector |
+| **Deployment** | Docker Compose |
 
 ---
 
-Part of [Awesome Code Docs](../../README.md)
+Ready to begin? Start with [Chapter 1: System Overview](01-system-overview.md).
+
+---
+
+*Built with insights from the [Dify repository](https://github.com/langgenius/dify) and community documentation.*
+
+## Navigation & Backlinks
+
+- [Start Here: Chapter 1: Dify System Overview](01-system-overview.md)
+- [Back to Main Catalog](../../README.md#-tutorial-catalog)
+- [Browse A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
+- [Search by Intent](../../discoverability/query-hub.md)
+- [Explore Category Hubs](../../README.md#category-hubs)
+
+## Full Chapter Map
+
+1. [Chapter 1: Dify System Overview](01-system-overview.md)
+2. [Chapter 2: Core Architecture](02-core-architecture.md)
+3. [Chapter 3: Workflow Engine](03-workflow-engine.md)
+4. [Chapter 4: RAG Implementation](04-rag-implementation.md)
+5. [Chapter 5: Agent Framework](05-agent-framework.md)
+6. [Chapter 6: Custom Nodes](06-custom-nodes.md)
+7. [Chapter 7: Production Deployment](07-production-deployment.md)
+8. [Chapter 8: Operations Playbook](08-operations-playbook.md)
+
+## Current Snapshot (auto-updated)
+
+- repository: [langgenius/dify](https://github.com/langgenius/dify)
+- stars: about **68K**
+- project positioning: leading open-source LLM application development platform
+
+## What You Will Learn
+
+- how Dify's workflow engine executes node graphs and manages LLM pipeline state
+- how to implement multi-stage RAG with document processing, embeddings, and vector retrieval
+- how Dify's agent framework manages tool-calling loops and reasoning chains
+- how to deploy and operate Dify in production with Docker Compose and monitoring
+
+## Source References
+
+- [Dify](https://github.com/langgenius/dify)
+
+*Generated by [AI Codebase Knowledge Builder](https://github.com/The-Pocket/Tutorial-Codebase-Knowledge)*
diff --git a/tutorials/dify-platform-deep-dive/index.md b/tutorials/dify-platform-deep-dive/index.md
deleted file mode 100644
index cad278d5..00000000
--- a/tutorials/dify-platform-deep-dive/index.md
+++ /dev/null
@@ -1,143 +0,0 @@
----
-layout: default
-title: "Dify Platform Deep Dive"
-nav_order: 3
-has_children: true
-format_version: v2
----
-
-# Dify Platform: Deep Dive Tutorial
-
-> **Project**: [Dify](https://github.com/langgenius/dify) — An open-source LLM application development platform for building workflows, RAG pipelines, and AI agents with a visual interface.
-
-[![Stars](https://img.shields.io/github/stars/langgenius/dify?style=social)](https://github.com/langgenius/dify)
-[![License: Apache 2.0](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
-[![Python](https://img.shields.io/badge/Python-Flask-blue)](https://github.com/langgenius/dify)
-
-## Why This Track Matters
-
-Dify provides a complete open-source platform for building LLM applications with a visual workflow editor, RAG pipeline, and agent framework — reducing the time from idea to deployed AI application.
-
-This track focuses on:
-- building and deploying LLM workflows with Dify's drag-and-drop node system
-- implementing RAG pipelines with multi-stage document processing and vector search
-- orchestrating agents with tool-calling loops and reasoning chain management
-- operating Dify in production with Docker, monitoring, and security controls
-
-## What Is Dify?
-
-Dify is an open-source LLM application platform that provides a visual interface for building AI workflows, RAG systems, and agent frameworks. It supports orchestrating complex LLM pipelines with a drag-and-drop node system and offers one-click deployment via Docker.
-
-| Feature | Description |
-|---------|-------------|
-| **Visual Workflows** | Drag-and-drop node system for chaining LLM operations |
-| **RAG Pipeline** | Multi-stage document processing with vector storage and retrieval |
-| **Agent Framework** | Tool-calling loops and reasoning chain management |
-| **Multi-Model** | OpenAI, Anthropic, Google, local models via Ollama |
-| **Plugin System** | Extensible architecture for custom nodes and integrations |
-| **Deployment** | One-click Docker Compose deployment |
-
-## Mental Model
-
-```mermaid
-graph TB
-    subgraph Frontend["React Frontend"]
-        UI[Visual Workflow Editor]
-        CHAT[Chat Interface]
-        ADMIN[Admin Console]
-    end
-
-    subgraph Backend["Flask Backend"]
-        WF[Workflow Engine]
-        RAG[RAG Pipeline]
-        AGENT[Agent Framework]
-        API[REST API]
-    end
-
-    subgraph Storage["Storage"]
-        PG[(PostgreSQL)]
-        REDIS[(Redis)]
-        VEC[(Vector Store)]
-        S3[Object Storage]
-    end
-
-    subgraph LLM["LLM Providers"]
-        OAI[OpenAI]
-        CLAUDE[Anthropic]
-        LOCAL[Ollama]
-    end
-
-    Frontend --> Backend
-    Backend --> Storage
-    Backend --> LLM
-```
-
-## Chapter Guide
-
-| Chapter | Topic | What You'll Learn |
-|---------|-------|-------------------|
-| [1. System Overview](01-system-overview.md) | Architecture | Dify's place in the LLM ecosystem, core components |
-| [2. Core Architecture](02-core-architecture.md) | Design | Components, data flow, service boundaries |
-| [3. Workflow Engine](03-workflow-engine.md) | Orchestration | Node system, visual workflows, execution pipeline |
-| [4. RAG Implementation](04-rag-implementation.md) | Retrieval | Document processing, embeddings, vector search |
-| [5. Agent Framework](05-agent-framework.md) | Agents | Tool calling, reasoning loops, agent types |
-| [6. Custom Nodes](06-custom-nodes.md) | Extensibility | Building custom workflow nodes and plugins |
-| [7. Production Deployment](07-production-deployment.md) | Operations | Docker, scaling, monitoring, security |
-| [8. Operations Playbook](08-operations-playbook.md) | Reliability | Incident response, SLOs, and cost controls |
-
-## Tech Stack
-
-| Component | Technology |
-|-----------|-----------|
-| **Backend** | Python, Flask |
-| **Frontend** | React, TypeScript |
-| **Database** | PostgreSQL |
-| **Cache** | Redis |
-| **Vector Store** | Weaviate, Qdrant, pgvector |
-| **Deployment** | Docker Compose |
-
----
-
-Ready to begin? Start with [Chapter 1: System Overview](01-system-overview.md).
-
----
-
-*Built with insights from the [Dify repository](https://github.com/langgenius/dify) and community documentation.*
-
-## Navigation & Backlinks
-
-- [Start Here: Chapter 1: Dify System Overview](01-system-overview.md)
-- [Back to Main Catalog](../../README.md#-tutorial-catalog)
-- [Browse A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
-- [Search by Intent](../../discoverability/query-hub.md)
-- [Explore Category Hubs](../../README.md#category-hubs)
-
-## Full Chapter Map
-
-1. [Chapter 1: Dify System Overview](01-system-overview.md)
-2. [Chapter 2: Core Architecture](02-core-architecture.md)
-3. [Chapter 3: Workflow Engine](03-workflow-engine.md)
-4. [Chapter 4: RAG Implementation](04-rag-implementation.md)
-5. [Chapter 5: Agent Framework](05-agent-framework.md)
-6. [Chapter 6: Custom Nodes](06-custom-nodes.md)
-7. [Chapter 7: Production Deployment](07-production-deployment.md)
-8. [Chapter 8: Operations Playbook](08-operations-playbook.md)
-
-## Current Snapshot (auto-updated)
-
-- repository: [langgenius/dify](https://github.com/langgenius/dify)
-- stars: about **68K**
-- project positioning: leading open-source LLM application development platform
-
-## What You Will Learn
-
-- how Dify's workflow engine executes node graphs and manages LLM pipeline state
-- how to implement multi-stage RAG with document processing, embeddings, and vector retrieval
-- how Dify's agent framework manages tool-calling loops and reasoning chains
-- how to deploy and operate Dify in production with Docker Compose and monitoring
-
-## Source References
-
-- [Dify](https://github.com/langgenius/dify)
-
-*Generated by [AI Codebase Knowledge Builder](https://github.com/The-Pocket/Tutorial-Codebase-Knowledge)*
diff --git a/tutorials/dspy-tutorial/01-getting-started.md b/tutorials/dspy-tutorial/01-getting-started.md
index 0c987e42..45ff104a 100644
--- a/tutorials/dspy-tutorial/01-getting-started.md
+++ b/tutorials/dspy-tutorial/01-getting-started.md
@@ -477,7 +477,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Signatures - Defining LM Input/Output Behavior](02-signatures.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/dspy-tutorial/02-signatures.md b/tutorials/dspy-tutorial/02-signatures.md
index 3b6d228d..a6094e7c 100644
--- a/tutorials/dspy-tutorial/02-signatures.md
+++ b/tutorials/dspy-tutorial/02-signatures.md
@@ -575,7 +575,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started with DSPy](01-getting-started.md)
 - [Next Chapter: Chapter 3: Modules - Reusable DSPy Components](03-modules.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/dspy-tutorial/03-modules.md b/tutorials/dspy-tutorial/03-modules.md
index 00e034d4..dd0d7d88 100644
--- a/tutorials/dspy-tutorial/03-modules.md
+++ b/tutorials/dspy-tutorial/03-modules.md
@@ -783,7 +783,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Signatures - Defining LM Input/Output Behavior](02-signatures.md)
 - [Next Chapter: Chapter 4: Retrieval-Augmented Generation (RAG) with DSPy](04-rag.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/dspy-tutorial/04-rag.md b/tutorials/dspy-tutorial/04-rag.md
index c83c30f5..30bd4cc6 100644
--- a/tutorials/dspy-tutorial/04-rag.md
+++ b/tutorials/dspy-tutorial/04-rag.md
@@ -724,7 +724,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Modules - Reusable DSPy Components](03-modules.md)
 - [Next Chapter: Chapter 5: Automatic Optimization - DSPy's Superpower](05-optimization.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/dspy-tutorial/05-optimization.md b/tutorials/dspy-tutorial/05-optimization.md
index 64c704f1..43056c17 100644
--- a/tutorials/dspy-tutorial/05-optimization.md
+++ b/tutorials/dspy-tutorial/05-optimization.md
@@ -697,7 +697,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Retrieval-Augmented Generation (RAG) with DSPy](04-rag.md)
 - [Next Chapter: Chapter 6: Advanced Patterns - Multi-Hop Reasoning and Tool Integration](06-advanced-patterns.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/dspy-tutorial/06-advanced-patterns.md b/tutorials/dspy-tutorial/06-advanced-patterns.md
index b6b2e363..61ac31f0 100644
--- a/tutorials/dspy-tutorial/06-advanced-patterns.md
+++ b/tutorials/dspy-tutorial/06-advanced-patterns.md
@@ -838,7 +838,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Automatic Optimization - DSPy's Superpower](05-optimization.md)
 - [Next Chapter: Chapter 7: Evaluation & Metrics - Systematic Assessment of DSPy Programs](07-evaluation.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/dspy-tutorial/07-evaluation.md b/tutorials/dspy-tutorial/07-evaluation.md
index cac875ac..91b0884a 100644
--- a/tutorials/dspy-tutorial/07-evaluation.md
+++ b/tutorials/dspy-tutorial/07-evaluation.md
@@ -765,7 +765,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Advanced Patterns - Multi-Hop Reasoning and Tool Integration](06-advanced-patterns.md)
 - [Next Chapter: Chapter 8: Production Deployment - Scaling DSPy Systems](08-production.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/dspy-tutorial/08-production.md b/tutorials/dspy-tutorial/08-production.md
index 84c96e75..42d04f1e 100644
--- a/tutorials/dspy-tutorial/08-production.md
+++ b/tutorials/dspy-tutorial/08-production.md
@@ -925,7 +925,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Evaluation & Metrics - Systematic Assessment of DSPy Programs](07-evaluation.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/dspy-tutorial/index.md b/tutorials/dspy-tutorial/README.md
similarity index 100%
rename from tutorials/dspy-tutorial/index.md
rename to tutorials/dspy-tutorial/README.md
diff --git a/tutorials/dyad-tutorial/01-getting-started.md b/tutorials/dyad-tutorial/01-getting-started.md
index de308f93..7b694a8d 100644
--- a/tutorials/dyad-tutorial/01-getting-started.md
+++ b/tutorials/dyad-tutorial/01-getting-started.md
@@ -631,7 +631,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Natural Language App Building](02-natural-language-building.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/dyad-tutorial/02-natural-language-building.md b/tutorials/dyad-tutorial/02-natural-language-building.md
index c5b9f574..6a272c00 100644
--- a/tutorials/dyad-tutorial/02-natural-language-building.md
+++ b/tutorials/dyad-tutorial/02-natural-language-building.md
@@ -632,7 +632,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started with Dyad](01-getting-started.md)
 - [Next Chapter: Chapter 3: Component Integration](03-component-integration.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/dyad-tutorial/03-component-integration.md b/tutorials/dyad-tutorial/03-component-integration.md
index 1e897526..e0b08ae5 100644
--- a/tutorials/dyad-tutorial/03-component-integration.md
+++ b/tutorials/dyad-tutorial/03-component-integration.md
@@ -629,7 +629,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Natural Language App Building](02-natural-language-building.md)
 - [Next Chapter: Chapter 4: Data Management](04-data-management.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/dyad-tutorial/04-data-management.md b/tutorials/dyad-tutorial/04-data-management.md
index 829c8621..cac24991 100644
--- a/tutorials/dyad-tutorial/04-data-management.md
+++ b/tutorials/dyad-tutorial/04-data-management.md
@@ -633,7 +633,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Component Integration](03-component-integration.md)
 - [Next Chapter: Chapter 5: API Integration](05-api-integration.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/dyad-tutorial/05-api-integration.md b/tutorials/dyad-tutorial/05-api-integration.md
index c0b5eada..d09255ca 100644
--- a/tutorials/dyad-tutorial/05-api-integration.md
+++ b/tutorials/dyad-tutorial/05-api-integration.md
@@ -834,7 +834,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Data Management](04-data-management.md)
 - [Next Chapter: Chapter 6: Customization and Styling](06-customization-styling.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/dyad-tutorial/06-customization-styling.md b/tutorials/dyad-tutorial/06-customization-styling.md
index 2bfc411e..2b20e73c 100644
--- a/tutorials/dyad-tutorial/06-customization-styling.md
+++ b/tutorials/dyad-tutorial/06-customization-styling.md
@@ -893,7 +893,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: API Integration](05-api-integration.md)
 - [Next Chapter: Chapter 7: Testing and Validation](07-testing-validation.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/dyad-tutorial/07-testing-validation.md b/tutorials/dyad-tutorial/07-testing-validation.md
index 10e9a40e..a5f5677b 100644
--- a/tutorials/dyad-tutorial/07-testing-validation.md
+++ b/tutorials/dyad-tutorial/07-testing-validation.md
@@ -951,7 +951,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Customization and Styling](06-customization-styling.md)
 - [Next Chapter: Chapter 8: Deployment and Sharing](08-deployment-sharing.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/dyad-tutorial/08-deployment-sharing.md b/tutorials/dyad-tutorial/08-deployment-sharing.md
index 9c7aa447..c84d29a4 100644
--- a/tutorials/dyad-tutorial/08-deployment-sharing.md
+++ b/tutorials/dyad-tutorial/08-deployment-sharing.md
@@ -851,7 +851,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Testing and Validation](07-testing-validation.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/dyad-tutorial/index.md b/tutorials/dyad-tutorial/README.md
similarity index 100%
rename from tutorials/dyad-tutorial/index.md
rename to tutorials/dyad-tutorial/README.md
diff --git a/tutorials/elizaos-tutorial/01-getting-started.md b/tutorials/elizaos-tutorial/01-getting-started.md
index b24a13c1..7e5d508c 100644
--- a/tutorials/elizaos-tutorial/01-getting-started.md
+++ b/tutorials/elizaos-tutorial/01-getting-started.md
@@ -373,7 +373,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Agent Runtime](02-agent-runtime.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/elizaos-tutorial/02-agent-runtime.md b/tutorials/elizaos-tutorial/02-agent-runtime.md
index 61d1f434..6ea1d6d3 100644
--- a/tutorials/elizaos-tutorial/02-agent-runtime.md
+++ b/tutorials/elizaos-tutorial/02-agent-runtime.md
@@ -608,7 +608,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started with ElizaOS](01-getting-started.md)
 - [Next Chapter: Chapter 3: Character System](03-character-system.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/elizaos-tutorial/03-character-system.md b/tutorials/elizaos-tutorial/03-character-system.md
index c894911a..bcbf4cb9 100644
--- a/tutorials/elizaos-tutorial/03-character-system.md
+++ b/tutorials/elizaos-tutorial/03-character-system.md
@@ -483,7 +483,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Agent Runtime](02-agent-runtime.md)
 - [Next Chapter: Chapter 4: Plugin Architecture](04-plugin-architecture.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/elizaos-tutorial/04-plugin-architecture.md b/tutorials/elizaos-tutorial/04-plugin-architecture.md
index aa0b712f..3b05a765 100644
--- a/tutorials/elizaos-tutorial/04-plugin-architecture.md
+++ b/tutorials/elizaos-tutorial/04-plugin-architecture.md
@@ -587,7 +587,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Character System](03-character-system.md)
 - [Next Chapter: Chapter 5: Memory & RAG](05-memory-rag.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/elizaos-tutorial/05-memory-rag.md b/tutorials/elizaos-tutorial/05-memory-rag.md
index 0c875014..f15430bc 100644
--- a/tutorials/elizaos-tutorial/05-memory-rag.md
+++ b/tutorials/elizaos-tutorial/05-memory-rag.md
@@ -627,7 +627,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Plugin Architecture](04-plugin-architecture.md)
 - [Next Chapter: Chapter 6: Platform Connectors](06-platform-connectors.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/elizaos-tutorial/06-platform-connectors.md b/tutorials/elizaos-tutorial/06-platform-connectors.md
index 8005f68e..b1a83359 100644
--- a/tutorials/elizaos-tutorial/06-platform-connectors.md
+++ b/tutorials/elizaos-tutorial/06-platform-connectors.md
@@ -560,7 +560,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Memory & RAG](05-memory-rag.md)
 - [Next Chapter: Chapter 7: Multi-Agent Orchestration](07-multi-agent.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/elizaos-tutorial/07-multi-agent.md b/tutorials/elizaos-tutorial/07-multi-agent.md
index b97bdd48..cba11e99 100644
--- a/tutorials/elizaos-tutorial/07-multi-agent.md
+++ b/tutorials/elizaos-tutorial/07-multi-agent.md
@@ -616,7 +616,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Platform Connectors](06-platform-connectors.md)
 - [Next Chapter: Chapter 8: Production Deployment](08-production-deployment.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/elizaos-tutorial/08-production-deployment.md b/tutorials/elizaos-tutorial/08-production-deployment.md
index 614a3c82..03952d50 100644
--- a/tutorials/elizaos-tutorial/08-production-deployment.md
+++ b/tutorials/elizaos-tutorial/08-production-deployment.md
@@ -612,7 +612,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Multi-Agent Orchestration](07-multi-agent.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/elizaos-tutorial/index.md b/tutorials/elizaos-tutorial/README.md
similarity index 100%
rename from tutorials/elizaos-tutorial/index.md
rename to tutorials/elizaos-tutorial/README.md
diff --git a/tutorials/everything-claude-code-tutorial/01-getting-started.md b/tutorials/everything-claude-code-tutorial/01-getting-started.md
index d026eea0..748f8a08 100644
--- a/tutorials/everything-claude-code-tutorial/01-getting-started.md
+++ b/tutorials/everything-claude-code-tutorial/01-getting-started.md
@@ -632,7 +632,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Architecture and Component Topology](02-architecture-and-component-topology.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/everything-claude-code-tutorial/02-architecture-and-component-topology.md b/tutorials/everything-claude-code-tutorial/02-architecture-and-component-topology.md
index c022c48a..6d37b103 100644
--- a/tutorials/everything-claude-code-tutorial/02-architecture-and-component-topology.md
+++ b/tutorials/everything-claude-code-tutorial/02-architecture-and-component-topology.md
@@ -633,7 +633,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started](01-getting-started.md)
 - [Next Chapter: Chapter 3: Installation Modes and Rules Strategy](03-installation-modes-and-rules-strategy.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/everything-claude-code-tutorial/03-installation-modes-and-rules-strategy.md b/tutorials/everything-claude-code-tutorial/03-installation-modes-and-rules-strategy.md
index bc963941..7f11e879 100644
--- a/tutorials/everything-claude-code-tutorial/03-installation-modes-and-rules-strategy.md
+++ b/tutorials/everything-claude-code-tutorial/03-installation-modes-and-rules-strategy.md
@@ -631,7 +631,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Architecture and Component Topology](02-architecture-and-component-topology.md)
 - [Next Chapter: Chapter 4: Agents, Skills, and Command Orchestration](04-agents-skills-and-command-orchestration.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/everything-claude-code-tutorial/04-agents-skills-and-command-orchestration.md b/tutorials/everything-claude-code-tutorial/04-agents-skills-and-command-orchestration.md
index 5514dc87..363e3648 100644
--- a/tutorials/everything-claude-code-tutorial/04-agents-skills-and-command-orchestration.md
+++ b/tutorials/everything-claude-code-tutorial/04-agents-skills-and-command-orchestration.md
@@ -631,7 +631,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Installation Modes and Rules Strategy](03-installation-modes-and-rules-strategy.md)
 - [Next Chapter: Chapter 5: Hooks, MCP, and Continuous Learning Loops](05-hooks-mcp-and-continuous-learning-loops.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/everything-claude-code-tutorial/05-hooks-mcp-and-continuous-learning-loops.md b/tutorials/everything-claude-code-tutorial/05-hooks-mcp-and-continuous-learning-loops.md
index 9c6af786..731bd418 100644
--- a/tutorials/everything-claude-code-tutorial/05-hooks-mcp-and-continuous-learning-loops.md
+++ b/tutorials/everything-claude-code-tutorial/05-hooks-mcp-and-continuous-learning-loops.md
@@ -632,7 +632,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Agents, Skills, and Command Orchestration](04-agents-skills-and-command-orchestration.md)
 - [Next Chapter: Chapter 6: Cross-Platform Workflows (Cursor and OpenCode)](06-cross-platform-workflows-cursor-and-opencode.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/everything-claude-code-tutorial/06-cross-platform-workflows-cursor-and-opencode.md b/tutorials/everything-claude-code-tutorial/06-cross-platform-workflows-cursor-and-opencode.md
index f55b60e4..723e5f53 100644
--- a/tutorials/everything-claude-code-tutorial/06-cross-platform-workflows-cursor-and-opencode.md
+++ b/tutorials/everything-claude-code-tutorial/06-cross-platform-workflows-cursor-and-opencode.md
@@ -626,7 +626,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Hooks, MCP, and Continuous Learning Loops](05-hooks-mcp-and-continuous-learning-loops.md)
 - [Next Chapter: Chapter 7: Testing, Verification, and Troubleshooting](07-testing-verification-and-troubleshooting.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/everything-claude-code-tutorial/07-testing-verification-and-troubleshooting.md b/tutorials/everything-claude-code-tutorial/07-testing-verification-and-troubleshooting.md
index 257acafa..7a4d434b 100644
--- a/tutorials/everything-claude-code-tutorial/07-testing-verification-and-troubleshooting.md
+++ b/tutorials/everything-claude-code-tutorial/07-testing-verification-and-troubleshooting.md
@@ -627,7 +627,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Cross-Platform Workflows (Cursor and OpenCode)](06-cross-platform-workflows-cursor-and-opencode.md)
 - [Next Chapter: Chapter 8: Contribution Workflow and Governance](08-contribution-workflow-and-governance.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/everything-claude-code-tutorial/08-contribution-workflow-and-governance.md b/tutorials/everything-claude-code-tutorial/08-contribution-workflow-and-governance.md
index 1621c3cb..bf2e492e 100644
--- a/tutorials/everything-claude-code-tutorial/08-contribution-workflow-and-governance.md
+++ b/tutorials/everything-claude-code-tutorial/08-contribution-workflow-and-governance.md
@@ -626,7 +626,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Testing, Verification, and Troubleshooting](07-testing-verification-and-troubleshooting.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/everything-claude-code-tutorial/index.md b/tutorials/everything-claude-code-tutorial/README.md
similarity index 100%
rename from tutorials/everything-claude-code-tutorial/index.md
rename to tutorials/everything-claude-code-tutorial/README.md
diff --git a/tutorials/fabric-tutorial/01-getting-started.md b/tutorials/fabric-tutorial/01-getting-started.md
index 519d3e8e..de71d8e2 100644
--- a/tutorials/fabric-tutorial/01-getting-started.md
+++ b/tutorials/fabric-tutorial/01-getting-started.md
@@ -564,7 +564,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Pattern System](02-pattern-system.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/fabric-tutorial/02-pattern-system.md b/tutorials/fabric-tutorial/02-pattern-system.md
index fe56e2b7..340eae4d 100644
--- a/tutorials/fabric-tutorial/02-pattern-system.md
+++ b/tutorials/fabric-tutorial/02-pattern-system.md
@@ -486,7 +486,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started with Fabric](01-getting-started.md)
 - [Next Chapter: Chapter 3: Basic Usage](03-basic-usage.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/fabric-tutorial/03-basic-usage.md b/tutorials/fabric-tutorial/03-basic-usage.md
index 00d969e7..53a5cbf2 100644
--- a/tutorials/fabric-tutorial/03-basic-usage.md
+++ b/tutorials/fabric-tutorial/03-basic-usage.md
@@ -449,7 +449,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Pattern System](02-pattern-system.md)
 - [Next Chapter: Chapter 4: Advanced Patterns](04-advanced-patterns.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/fabric-tutorial/04-advanced-patterns.md b/tutorials/fabric-tutorial/04-advanced-patterns.md
index 43c4673b..c6420f55 100644
--- a/tutorials/fabric-tutorial/04-advanced-patterns.md
+++ b/tutorials/fabric-tutorial/04-advanced-patterns.md
@@ -540,7 +540,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Basic Usage](03-basic-usage.md)
 - [Next Chapter: Chapter 5: Stitch Composition](05-stitch-composition.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/fabric-tutorial/05-stitch-composition.md b/tutorials/fabric-tutorial/05-stitch-composition.md
index 124ac9e3..08bb34b2 100644
--- a/tutorials/fabric-tutorial/05-stitch-composition.md
+++ b/tutorials/fabric-tutorial/05-stitch-composition.md
@@ -536,7 +536,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Advanced Patterns](04-advanced-patterns.md)
 - [Next Chapter: Chapter 6: Custom Patterns](06-custom-patterns.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/fabric-tutorial/06-custom-patterns.md b/tutorials/fabric-tutorial/06-custom-patterns.md
index 8dce8fe4..6499ac50 100644
--- a/tutorials/fabric-tutorial/06-custom-patterns.md
+++ b/tutorials/fabric-tutorial/06-custom-patterns.md
@@ -603,7 +603,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Stitch Composition](05-stitch-composition.md)
 - [Next Chapter: Chapter 7: Integration & API](07-integration-api.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/fabric-tutorial/07-integration-api.md b/tutorials/fabric-tutorial/07-integration-api.md
index dbbf1a11..2c49e040 100644
--- a/tutorials/fabric-tutorial/07-integration-api.md
+++ b/tutorials/fabric-tutorial/07-integration-api.md
@@ -566,7 +566,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Custom Patterns](06-custom-patterns.md)
 - [Next Chapter: Chapter 8: Enterprise Deployment](08-enterprise-deployment.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/fabric-tutorial/08-enterprise-deployment.md b/tutorials/fabric-tutorial/08-enterprise-deployment.md
index a0efb412..b8678dd4 100644
--- a/tutorials/fabric-tutorial/08-enterprise-deployment.md
+++ b/tutorials/fabric-tutorial/08-enterprise-deployment.md
@@ -668,7 +668,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Integration & API](07-integration-api.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/fabric-tutorial/index.md b/tutorials/fabric-tutorial/README.md
similarity index 100%
rename from tutorials/fabric-tutorial/index.md
rename to tutorials/fabric-tutorial/README.md
diff --git a/tutorials/fastmcp-tutorial/01-getting-started.md b/tutorials/fastmcp-tutorial/01-getting-started.md
index 85aba7e6..bed8787f 100644
--- a/tutorials/fastmcp-tutorial/01-getting-started.md
+++ b/tutorials/fastmcp-tutorial/01-getting-started.md
@@ -636,7 +636,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Core Abstractions: Components, Providers, Transforms](02-core-abstractions-components-providers-transforms.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/fastmcp-tutorial/02-core-abstractions-components-providers-transforms.md b/tutorials/fastmcp-tutorial/02-core-abstractions-components-providers-transforms.md
index 4d7e659b..5e84ee3f 100644
--- a/tutorials/fastmcp-tutorial/02-core-abstractions-components-providers-transforms.md
+++ b/tutorials/fastmcp-tutorial/02-core-abstractions-components-providers-transforms.md
@@ -640,7 +640,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started](01-getting-started.md)
 - [Next Chapter: Chapter 3: Server Runtime and Transports](03-server-runtime-and-transports.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/fastmcp-tutorial/03-server-runtime-and-transports.md b/tutorials/fastmcp-tutorial/03-server-runtime-and-transports.md
index 427fc7ca..d2a1dbbb 100644
--- a/tutorials/fastmcp-tutorial/03-server-runtime-and-transports.md
+++ b/tutorials/fastmcp-tutorial/03-server-runtime-and-transports.md
@@ -642,7 +642,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Core Abstractions: Components, Providers, Transforms](02-core-abstractions-components-providers-transforms.md)
 - [Next Chapter: Chapter 4: Client Architecture and Transport Patterns](04-client-architecture-and-transport-patterns.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/fastmcp-tutorial/04-client-architecture-and-transport-patterns.md b/tutorials/fastmcp-tutorial/04-client-architecture-and-transport-patterns.md
index c7a87f99..f801df64 100644
--- a/tutorials/fastmcp-tutorial/04-client-architecture-and-transport-patterns.md
+++ b/tutorials/fastmcp-tutorial/04-client-architecture-and-transport-patterns.md
@@ -637,7 +637,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Server Runtime and Transports](03-server-runtime-and-transports.md)
 - [Next Chapter: Chapter 5: Integrations: Claude Code, Cursor, and Tooling](05-integrations-claude-code-cursor-and-tooling.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/fastmcp-tutorial/05-integrations-claude-code-cursor-and-tooling.md b/tutorials/fastmcp-tutorial/05-integrations-claude-code-cursor-and-tooling.md
index d1399825..019d7397 100644
--- a/tutorials/fastmcp-tutorial/05-integrations-claude-code-cursor-and-tooling.md
+++ b/tutorials/fastmcp-tutorial/05-integrations-claude-code-cursor-and-tooling.md
@@ -636,7 +636,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Client Architecture and Transport Patterns](04-client-architecture-and-transport-patterns.md)
 - [Next Chapter: Chapter 6: Configuration, Auth, and Deployment](06-configuration-auth-and-deployment.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/fastmcp-tutorial/06-configuration-auth-and-deployment.md b/tutorials/fastmcp-tutorial/06-configuration-auth-and-deployment.md
index 56fc14be..c5d7e428 100644
--- a/tutorials/fastmcp-tutorial/06-configuration-auth-and-deployment.md
+++ b/tutorials/fastmcp-tutorial/06-configuration-auth-and-deployment.md
@@ -636,7 +636,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Integrations: Claude Code, Cursor, and Tooling](05-integrations-claude-code-cursor-and-tooling.md)
 - [Next Chapter: Chapter 7: Testing, Contributing, and Upgrade Strategy](07-testing-contributing-and-upgrade-strategy.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/fastmcp-tutorial/07-testing-contributing-and-upgrade-strategy.md b/tutorials/fastmcp-tutorial/07-testing-contributing-and-upgrade-strategy.md
index 923ffd53..9d26cd86 100644
--- a/tutorials/fastmcp-tutorial/07-testing-contributing-and-upgrade-strategy.md
+++ b/tutorials/fastmcp-tutorial/07-testing-contributing-and-upgrade-strategy.md
@@ -638,7 +638,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Configuration, Auth, and Deployment](06-configuration-auth-and-deployment.md)
 - [Next Chapter: Chapter 8: Production Operations and Governance](08-production-operations-and-governance.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/fastmcp-tutorial/08-production-operations-and-governance.md b/tutorials/fastmcp-tutorial/08-production-operations-and-governance.md
index 948662a5..70333668 100644
--- a/tutorials/fastmcp-tutorial/08-production-operations-and-governance.md
+++ b/tutorials/fastmcp-tutorial/08-production-operations-and-governance.md
@@ -634,7 +634,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Testing, Contributing, and Upgrade Strategy](07-testing-contributing-and-upgrade-strategy.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/fastmcp-tutorial/index.md b/tutorials/fastmcp-tutorial/README.md
similarity index 100%
rename from tutorials/fastmcp-tutorial/index.md
rename to tutorials/fastmcp-tutorial/README.md
diff --git a/tutorials/figma-context-mcp-tutorial/01-getting-started.md b/tutorials/figma-context-mcp-tutorial/01-getting-started.md
index b7e4b957..ebec00dd 100644
--- a/tutorials/figma-context-mcp-tutorial/01-getting-started.md
+++ b/tutorials/figma-context-mcp-tutorial/01-getting-started.md
@@ -633,7 +633,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Architecture and Context Translation](02-architecture-and-context-translation.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/figma-context-mcp-tutorial/02-architecture-and-context-translation.md b/tutorials/figma-context-mcp-tutorial/02-architecture-and-context-translation.md
index 8367e95f..bc03d0ff 100644
--- a/tutorials/figma-context-mcp-tutorial/02-architecture-and-context-translation.md
+++ b/tutorials/figma-context-mcp-tutorial/02-architecture-and-context-translation.md
@@ -639,7 +639,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started](01-getting-started.md)
 - [Next Chapter: Chapter 3: Frame Targeting and Context Scope](03-frame-targeting-and-context-scope.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/figma-context-mcp-tutorial/03-frame-targeting-and-context-scope.md b/tutorials/figma-context-mcp-tutorial/03-frame-targeting-and-context-scope.md
index 24b214eb..5a0a9234 100644
--- a/tutorials/figma-context-mcp-tutorial/03-frame-targeting-and-context-scope.md
+++ b/tutorials/figma-context-mcp-tutorial/03-frame-targeting-and-context-scope.md
@@ -624,7 +624,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Architecture and Context Translation](02-architecture-and-context-translation.md)
 - [Next Chapter: Chapter 4: Prompt Patterns for One-Shot UI Implementation](04-prompt-patterns-for-one-shot-ui-implementation.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/figma-context-mcp-tutorial/04-prompt-patterns-for-one-shot-ui-implementation.md b/tutorials/figma-context-mcp-tutorial/04-prompt-patterns-for-one-shot-ui-implementation.md
index c8f8a5fd..6df18c31 100644
--- a/tutorials/figma-context-mcp-tutorial/04-prompt-patterns-for-one-shot-ui-implementation.md
+++ b/tutorials/figma-context-mcp-tutorial/04-prompt-patterns-for-one-shot-ui-implementation.md
@@ -629,7 +629,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Frame Targeting and Context Scope](03-frame-targeting-and-context-scope.md)
 - [Next Chapter: Chapter 5: MCP Client Integrations](05-mcp-client-integrations.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/figma-context-mcp-tutorial/05-mcp-client-integrations.md b/tutorials/figma-context-mcp-tutorial/05-mcp-client-integrations.md
index ce46cced..1536aa20 100644
--- a/tutorials/figma-context-mcp-tutorial/05-mcp-client-integrations.md
+++ b/tutorials/figma-context-mcp-tutorial/05-mcp-client-integrations.md
@@ -635,7 +635,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Prompt Patterns for One-Shot UI Implementation](04-prompt-patterns-for-one-shot-ui-implementation.md)
 - [Next Chapter: Chapter 6: Performance and Token Optimization](06-performance-and-token-optimization.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/figma-context-mcp-tutorial/06-performance-and-token-optimization.md b/tutorials/figma-context-mcp-tutorial/06-performance-and-token-optimization.md
index fd805794..14653210 100644
--- a/tutorials/figma-context-mcp-tutorial/06-performance-and-token-optimization.md
+++ b/tutorials/figma-context-mcp-tutorial/06-performance-and-token-optimization.md
@@ -624,7 +624,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: MCP Client Integrations](05-mcp-client-integrations.md)
 - [Next Chapter: Chapter 7: Team Workflows and Design Governance](07-team-workflows-and-design-governance.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/figma-context-mcp-tutorial/07-team-workflows-and-design-governance.md b/tutorials/figma-context-mcp-tutorial/07-team-workflows-and-design-governance.md
index e7f4c685..a0420744 100644
--- a/tutorials/figma-context-mcp-tutorial/07-team-workflows-and-design-governance.md
+++ b/tutorials/figma-context-mcp-tutorial/07-team-workflows-and-design-governance.md
@@ -635,7 +635,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Performance and Token Optimization](06-performance-and-token-optimization.md)
 - [Next Chapter: Chapter 8: Production Security and Operations](08-production-security-and-operations.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/figma-context-mcp-tutorial/08-production-security-and-operations.md b/tutorials/figma-context-mcp-tutorial/08-production-security-and-operations.md
index 71361d83..5228c2a7 100644
--- a/tutorials/figma-context-mcp-tutorial/08-production-security-and-operations.md
+++ b/tutorials/figma-context-mcp-tutorial/08-production-security-and-operations.md
@@ -629,7 +629,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Team Workflows and Design Governance](07-team-workflows-and-design-governance.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/figma-context-mcp-tutorial/index.md b/tutorials/figma-context-mcp-tutorial/README.md
similarity index 100%
rename from tutorials/figma-context-mcp-tutorial/index.md
rename to tutorials/figma-context-mcp-tutorial/README.md
diff --git a/tutorials/firecrawl-mcp-server-tutorial/01-getting-started-and-core-setup.md b/tutorials/firecrawl-mcp-server-tutorial/01-getting-started-and-core-setup.md
index dc656079..a0d5439b 100644
--- a/tutorials/firecrawl-mcp-server-tutorial/01-getting-started-and-core-setup.md
+++ b/tutorials/firecrawl-mcp-server-tutorial/01-getting-started-and-core-setup.md
@@ -631,7 +631,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Architecture, Transports, and Versioning](02-architecture-transports-and-versioning.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/firecrawl-mcp-server-tutorial/02-architecture-transports-and-versioning.md b/tutorials/firecrawl-mcp-server-tutorial/02-architecture-transports-and-versioning.md
index 67174b38..04580b57 100644
--- a/tutorials/firecrawl-mcp-server-tutorial/02-architecture-transports-and-versioning.md
+++ b/tutorials/firecrawl-mcp-server-tutorial/02-architecture-transports-and-versioning.md
@@ -628,7 +628,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started and Core Setup](01-getting-started-and-core-setup.md)
 - [Next Chapter: Chapter 3: Tool Selection: Scrape, Map, Crawl, Search, Extract](03-tool-selection-scrape-map-crawl-search-extract.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/firecrawl-mcp-server-tutorial/03-tool-selection-scrape-map-crawl-search-extract.md b/tutorials/firecrawl-mcp-server-tutorial/03-tool-selection-scrape-map-crawl-search-extract.md
index acf86d5f..e7a1c0f1 100644
--- a/tutorials/firecrawl-mcp-server-tutorial/03-tool-selection-scrape-map-crawl-search-extract.md
+++ b/tutorials/firecrawl-mcp-server-tutorial/03-tool-selection-scrape-map-crawl-search-extract.md
@@ -625,7 +625,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Architecture, Transports, and Versioning](02-architecture-transports-and-versioning.md)
 - [Next Chapter: Chapter 4: Client Integrations: Cursor, Claude, Windsurf, VS Code](04-client-integrations-cursor-claude-windsurf-vscode.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/firecrawl-mcp-server-tutorial/04-client-integrations-cursor-claude-windsurf-vscode.md b/tutorials/firecrawl-mcp-server-tutorial/04-client-integrations-cursor-claude-windsurf-vscode.md
index 8dcb2552..63c43983 100644
--- a/tutorials/firecrawl-mcp-server-tutorial/04-client-integrations-cursor-claude-windsurf-vscode.md
+++ b/tutorials/firecrawl-mcp-server-tutorial/04-client-integrations-cursor-claude-windsurf-vscode.md
@@ -635,7 +635,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Tool Selection: Scrape, Map, Crawl, Search, Extract](03-tool-selection-scrape-map-crawl-search-extract.md)
 - [Next Chapter: Chapter 5: Configuration, Retries, and Credit Monitoring](05-configuration-retries-and-credit-monitoring.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/firecrawl-mcp-server-tutorial/05-configuration-retries-and-credit-monitoring.md b/tutorials/firecrawl-mcp-server-tutorial/05-configuration-retries-and-credit-monitoring.md
index 1f939b16..88915ad1 100644
--- a/tutorials/firecrawl-mcp-server-tutorial/05-configuration-retries-and-credit-monitoring.md
+++ b/tutorials/firecrawl-mcp-server-tutorial/05-configuration-retries-and-credit-monitoring.md
@@ -624,7 +624,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Client Integrations: Cursor, Claude, Windsurf, VS Code](04-client-integrations-cursor-claude-windsurf-vscode.md)
 - [Next Chapter: Chapter 6: Batch Workflows, Deep Research, and API Evolution](06-batch-workflows-deep-research-and-api-evolution.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/firecrawl-mcp-server-tutorial/06-batch-workflows-deep-research-and-api-evolution.md b/tutorials/firecrawl-mcp-server-tutorial/06-batch-workflows-deep-research-and-api-evolution.md
index 1cfe7335..25ed5a52 100644
--- a/tutorials/firecrawl-mcp-server-tutorial/06-batch-workflows-deep-research-and-api-evolution.md
+++ b/tutorials/firecrawl-mcp-server-tutorial/06-batch-workflows-deep-research-and-api-evolution.md
@@ -634,7 +634,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Configuration, Retries, and Credit Monitoring](05-configuration-retries-and-credit-monitoring.md)
 - [Next Chapter: Chapter 7: Reliability, Observability, and Failure Handling](07-reliability-observability-and-failure-handling.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/firecrawl-mcp-server-tutorial/07-reliability-observability-and-failure-handling.md b/tutorials/firecrawl-mcp-server-tutorial/07-reliability-observability-and-failure-handling.md
index 3e0564c5..0d32a738 100644
--- a/tutorials/firecrawl-mcp-server-tutorial/07-reliability-observability-and-failure-handling.md
+++ b/tutorials/firecrawl-mcp-server-tutorial/07-reliability-observability-and-failure-handling.md
@@ -634,7 +634,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Batch Workflows, Deep Research, and API Evolution](06-batch-workflows-deep-research-and-api-evolution.md)
 - [Next Chapter: Chapter 8: Security, Governance, and Contribution Workflow](08-security-governance-and-contribution-workflow.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/firecrawl-mcp-server-tutorial/08-security-governance-and-contribution-workflow.md b/tutorials/firecrawl-mcp-server-tutorial/08-security-governance-and-contribution-workflow.md
index c6aa0ee3..8aedceeb 100644
--- a/tutorials/firecrawl-mcp-server-tutorial/08-security-governance-and-contribution-workflow.md
+++ b/tutorials/firecrawl-mcp-server-tutorial/08-security-governance-and-contribution-workflow.md
@@ -624,7 +624,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Reliability, Observability, and Failure Handling](07-reliability-observability-and-failure-handling.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/firecrawl-mcp-server-tutorial/index.md b/tutorials/firecrawl-mcp-server-tutorial/README.md
similarity index 100%
rename from tutorials/firecrawl-mcp-server-tutorial/index.md
rename to tutorials/firecrawl-mcp-server-tutorial/README.md
diff --git a/tutorials/firecrawl-tutorial/01-getting-started.md b/tutorials/firecrawl-tutorial/01-getting-started.md
index 21d8421b..abc99f2d 100644
--- a/tutorials/firecrawl-tutorial/01-getting-started.md
+++ b/tutorials/firecrawl-tutorial/01-getting-started.md
@@ -538,7 +538,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Basic Web Scraping](02-basic-scraping.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/firecrawl-tutorial/02-basic-scraping.md b/tutorials/firecrawl-tutorial/02-basic-scraping.md
index 70e53763..15a141f3 100644
--- a/tutorials/firecrawl-tutorial/02-basic-scraping.md
+++ b/tutorials/firecrawl-tutorial/02-basic-scraping.md
@@ -511,7 +511,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started with Firecrawl](01-getting-started.md)
 - [Next Chapter: Chapter 3: Advanced Data Extraction](03-advanced-extraction.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/firecrawl-tutorial/03-advanced-extraction.md b/tutorials/firecrawl-tutorial/03-advanced-extraction.md
index b396c0ab..d5b0f0f7 100644
--- a/tutorials/firecrawl-tutorial/03-advanced-extraction.md
+++ b/tutorials/firecrawl-tutorial/03-advanced-extraction.md
@@ -593,7 +593,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Basic Web Scraping](02-basic-scraping.md)
 - [Next Chapter: Chapter 4: JavaScript & Dynamic Content](04-javascript-handling.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/firecrawl-tutorial/04-javascript-handling.md b/tutorials/firecrawl-tutorial/04-javascript-handling.md
index 70968202..568c19c5 100644
--- a/tutorials/firecrawl-tutorial/04-javascript-handling.md
+++ b/tutorials/firecrawl-tutorial/04-javascript-handling.md
@@ -529,7 +529,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Advanced Data Extraction](03-advanced-extraction.md)
 - [Next Chapter: Chapter 5: Content Cleaning & Processing](05-content-cleaning.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/firecrawl-tutorial/05-content-cleaning.md b/tutorials/firecrawl-tutorial/05-content-cleaning.md
index 77ab41c0..4d640d54 100644
--- a/tutorials/firecrawl-tutorial/05-content-cleaning.md
+++ b/tutorials/firecrawl-tutorial/05-content-cleaning.md
@@ -636,7 +636,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: JavaScript & Dynamic Content](04-javascript-handling.md)
 - [Next Chapter: Chapter 6: Building RAG Systems](06-rag-integration.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/firecrawl-tutorial/06-rag-integration.md b/tutorials/firecrawl-tutorial/06-rag-integration.md
index 1d3327a3..fe345042 100644
--- a/tutorials/firecrawl-tutorial/06-rag-integration.md
+++ b/tutorials/firecrawl-tutorial/06-rag-integration.md
@@ -687,7 +687,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Content Cleaning & Processing](05-content-cleaning.md)
 - [Next Chapter: Chapter 7: Scaling & Performance](07-scaling-performance.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/firecrawl-tutorial/07-scaling-performance.md b/tutorials/firecrawl-tutorial/07-scaling-performance.md
index e12127b6..66e0996b 100644
--- a/tutorials/firecrawl-tutorial/07-scaling-performance.md
+++ b/tutorials/firecrawl-tutorial/07-scaling-performance.md
@@ -752,7 +752,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Building RAG Systems](06-rag-integration.md)
 - [Next Chapter: Chapter 8: Production Deployment](08-production-deployment.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/firecrawl-tutorial/08-production-deployment.md b/tutorials/firecrawl-tutorial/08-production-deployment.md
index 91f6c427..42d85bf3 100644
--- a/tutorials/firecrawl-tutorial/08-production-deployment.md
+++ b/tutorials/firecrawl-tutorial/08-production-deployment.md
@@ -901,7 +901,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Scaling & Performance](07-scaling-performance.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/firecrawl-tutorial/index.md b/tutorials/firecrawl-tutorial/README.md
similarity index 100%
rename from tutorials/firecrawl-tutorial/index.md
rename to tutorials/firecrawl-tutorial/README.md
diff --git a/tutorials/fireproof-tutorial/01-getting-started.md b/tutorials/fireproof-tutorial/01-getting-started.md
index 80ea2af2..65f8c26f 100644
--- a/tutorials/fireproof-tutorial/01-getting-started.md
+++ b/tutorials/fireproof-tutorial/01-getting-started.md
@@ -631,7 +631,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Core Document API and Query Lifecycle](02-core-document-api-and-query-lifecycle.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/fireproof-tutorial/02-core-document-api-and-query-lifecycle.md b/tutorials/fireproof-tutorial/02-core-document-api-and-query-lifecycle.md
index b87f576f..7c3256c1 100644
--- a/tutorials/fireproof-tutorial/02-core-document-api-and-query-lifecycle.md
+++ b/tutorials/fireproof-tutorial/02-core-document-api-and-query-lifecycle.md
@@ -630,7 +630,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started](01-getting-started.md)
 - [Next Chapter: Chapter 3: React Hooks and Live Local-First UX](03-react-hooks-and-live-local-first-ux.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/fireproof-tutorial/03-react-hooks-and-live-local-first-ux.md b/tutorials/fireproof-tutorial/03-react-hooks-and-live-local-first-ux.md
index cd77426d..03888763 100644
--- a/tutorials/fireproof-tutorial/03-react-hooks-and-live-local-first-ux.md
+++ b/tutorials/fireproof-tutorial/03-react-hooks-and-live-local-first-ux.md
@@ -628,7 +628,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Core Document API and Query Lifecycle](02-core-document-api-and-query-lifecycle.md)
 - [Next Chapter: Chapter 4: Ledger, CRDT, and Causal Consistency](04-ledger-crdt-and-causal-consistency.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/fireproof-tutorial/04-ledger-crdt-and-causal-consistency.md b/tutorials/fireproof-tutorial/04-ledger-crdt-and-causal-consistency.md
index d6e34dae..d74422a1 100644
--- a/tutorials/fireproof-tutorial/04-ledger-crdt-and-causal-consistency.md
+++ b/tutorials/fireproof-tutorial/04-ledger-crdt-and-causal-consistency.md
@@ -635,7 +635,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: React Hooks and Live Local-First UX](03-react-hooks-and-live-local-first-ux.md)
 - [Next Chapter: Chapter 5: Storage Gateways and Sync Topology](05-storage-gateways-and-sync-topology.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/fireproof-tutorial/05-storage-gateways-and-sync-topology.md b/tutorials/fireproof-tutorial/05-storage-gateways-and-sync-topology.md
index 14e7d5a9..64a2a7e1 100644
--- a/tutorials/fireproof-tutorial/05-storage-gateways-and-sync-topology.md
+++ b/tutorials/fireproof-tutorial/05-storage-gateways-and-sync-topology.md
@@ -627,7 +627,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Ledger, CRDT, and Causal Consistency](04-ledger-crdt-and-causal-consistency.md)
 - [Next Chapter: Chapter 6: Files, Attachments, and Rich Data Flows](06-files-attachments-and-rich-data-flows.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/fireproof-tutorial/06-files-attachments-and-rich-data-flows.md b/tutorials/fireproof-tutorial/06-files-attachments-and-rich-data-flows.md
index da0ee6c4..d4f4f175 100644
--- a/tutorials/fireproof-tutorial/06-files-attachments-and-rich-data-flows.md
+++ b/tutorials/fireproof-tutorial/06-files-attachments-and-rich-data-flows.md
@@ -636,7 +636,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Storage Gateways and Sync Topology](05-storage-gateways-and-sync-topology.md)
 - [Next Chapter: Chapter 7: Runtime Coverage: Browser, Node, Deno, and Edge](07-runtime-coverage-browser-node-deno-and-edge.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/fireproof-tutorial/07-runtime-coverage-browser-node-deno-and-edge.md b/tutorials/fireproof-tutorial/07-runtime-coverage-browser-node-deno-and-edge.md
index 324a4fff..c17c27c2 100644
--- a/tutorials/fireproof-tutorial/07-runtime-coverage-browser-node-deno-and-edge.md
+++ b/tutorials/fireproof-tutorial/07-runtime-coverage-browser-node-deno-and-edge.md
@@ -627,7 +627,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Files, Attachments, and Rich Data Flows](06-files-attachments-and-rich-data-flows.md)
 - [Next Chapter: Chapter 8: Production Operations, Security, and Debugging](08-production-operations-security-and-debugging.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/fireproof-tutorial/08-production-operations-security-and-debugging.md b/tutorials/fireproof-tutorial/08-production-operations-security-and-debugging.md
index a0436846..377d833c 100644
--- a/tutorials/fireproof-tutorial/08-production-operations-security-and-debugging.md
+++ b/tutorials/fireproof-tutorial/08-production-operations-security-and-debugging.md
@@ -629,7 +629,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Runtime Coverage: Browser, Node, Deno, and Edge](07-runtime-coverage-browser-node-deno-and-edge.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/fireproof-tutorial/index.md b/tutorials/fireproof-tutorial/README.md
similarity index 100%
rename from tutorials/fireproof-tutorial/index.md
rename to tutorials/fireproof-tutorial/README.md
diff --git a/tutorials/flowise-llm-orchestration/01-system-overview.md b/tutorials/flowise-llm-orchestration/01-system-overview.md
index 07051ac7..77f16de0 100644
--- a/tutorials/flowise-llm-orchestration/01-system-overview.md
+++ b/tutorials/flowise-llm-orchestration/01-system-overview.md
@@ -559,7 +559,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Workflow Engine](02-workflow-engine.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/flowise-llm-orchestration/02-workflow-engine.md b/tutorials/flowise-llm-orchestration/02-workflow-engine.md
index d822d93f..4b417238 100644
--- a/tutorials/flowise-llm-orchestration/02-workflow-engine.md
+++ b/tutorials/flowise-llm-orchestration/02-workflow-engine.md
@@ -753,7 +753,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Flowise System Overview](01-system-overview.md)
 - [Next Chapter: Chapter 3: Node Development](03-node-development.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/flowise-llm-orchestration/03-node-development.md b/tutorials/flowise-llm-orchestration/03-node-development.md
index 5cdec508..36a6642a 100644
--- a/tutorials/flowise-llm-orchestration/03-node-development.md
+++ b/tutorials/flowise-llm-orchestration/03-node-development.md
@@ -966,7 +966,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Workflow Engine](02-workflow-engine.md)
 - [Next Chapter: Chapter 4: Advanced Integrations](04-advanced-integrations.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/flowise-llm-orchestration/04-advanced-integrations.md b/tutorials/flowise-llm-orchestration/04-advanced-integrations.md
index 8c66931c..6b8031db 100644
--- a/tutorials/flowise-llm-orchestration/04-advanced-integrations.md
+++ b/tutorials/flowise-llm-orchestration/04-advanced-integrations.md
@@ -1232,7 +1232,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Node Development](03-node-development.md)
 - [Next Chapter: Chapter 5: Production Deployment](05-production-deployment.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/flowise-llm-orchestration/05-production-deployment.md b/tutorials/flowise-llm-orchestration/05-production-deployment.md
index c360f0cf..d3927209 100644
--- a/tutorials/flowise-llm-orchestration/05-production-deployment.md
+++ b/tutorials/flowise-llm-orchestration/05-production-deployment.md
@@ -1149,7 +1149,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Advanced Integrations](04-advanced-integrations.md)
 - [Next Chapter: Chapter 6: Security and Governance](06-security-governance.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/flowise-llm-orchestration/06-security-governance.md b/tutorials/flowise-llm-orchestration/06-security-governance.md
index 10d77c79..52a6bec4 100644
--- a/tutorials/flowise-llm-orchestration/06-security-governance.md
+++ b/tutorials/flowise-llm-orchestration/06-security-governance.md
@@ -99,7 +99,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Production Deployment](05-production-deployment.md)
 - [Next Chapter: Chapter 7: Observability](07-observability.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/flowise-llm-orchestration/07-observability.md b/tutorials/flowise-llm-orchestration/07-observability.md
index be9a6ba4..3ec754d4 100644
--- a/tutorials/flowise-llm-orchestration/07-observability.md
+++ b/tutorials/flowise-llm-orchestration/07-observability.md
@@ -96,7 +96,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Security and Governance](06-security-governance.md)
 - [Next Chapter: Chapter 8: Extension Ecosystem](08-extension-ecosystem.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/flowise-llm-orchestration/08-extension-ecosystem.md b/tutorials/flowise-llm-orchestration/08-extension-ecosystem.md
index 8962df8e..eaafd6d5 100644
--- a/tutorials/flowise-llm-orchestration/08-extension-ecosystem.md
+++ b/tutorials/flowise-llm-orchestration/08-extension-ecosystem.md
@@ -47,7 +47,7 @@ A sustainable extension ecosystem determines whether Flowise remains adaptable a
 You now have a blueprint for building and maintaining a robust Flowise extension ecosystem.
 
 Related:
-- [Flowise Index](index.md)
+- [Flowise Index](README.md)
 
 ## What Problem Does This Solve?
 
@@ -89,7 +89,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Observability](07-observability.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/flowise-llm-orchestration/README.md b/tutorials/flowise-llm-orchestration/README.md
index 2171e9df..2056edd0 100644
--- a/tutorials/flowise-llm-orchestration/README.md
+++ b/tutorials/flowise-llm-orchestration/README.md
@@ -1,38 +1,134 @@
-# Flowise LLM Orchestration Platform Deep Dive
+---
+layout: default
+title: "Flowise LLM Orchestration"
+nav_order: 4
+has_children: true
+format_version: v2
+---
+
+# Flowise LLM Orchestration: Deep Dive Tutorial
+
+> **Project**: [Flowise](https://github.com/FlowiseAI/Flowise) — An open-source visual tool for building LLM workflows with a drag-and-drop interface.
+
+[![Stars](https://img.shields.io/github/stars/FlowiseAI/Flowise?style=social)](https://github.com/FlowiseAI/Flowise)
+[![License: Apache 2.0](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
+[![Node.js](https://img.shields.io/badge/Node.js-React-green)](https://github.com/FlowiseAI/Flowise)
+
+## Why This Track Matters
+
+Flowise makes LLM orchestration visual and accessible — a drag-and-drop canvas for building production pipelines without boilerplate, with auto-generated APIs for every workflow you create.
+
+This track focuses on:
+- building LLM workflows visually with Flowise's node canvas
+- developing custom nodes to extend Flowise with new integrations
+- connecting LLM providers, vector stores, and tools in production pipelines
+- deploying and monitoring Flowise workflows with Docker
+
+## What Is Flowise?
+
+Flowise is an open-source visual workflow builder for LLM applications. It provides a drag-and-drop canvas for connecting AI models, data sources, and tools into production-ready pipelines — without writing boilerplate code.
+
+| Feature | Description |
+|---------|-------------|
+| **Visual Canvas** | Drag-and-drop workflow builder with real-time preview |
+| **Node Library** | 100+ pre-built nodes for LLMs, tools, and data sources |
+| **Streaming** | Real-time streaming responses with SSE |
+| **Multi-Model** | OpenAI, Anthropic, Google, HuggingFace, Ollama |
+| **Custom Nodes** | Extensible architecture for building custom integrations |
+| **API Export** | Auto-generated REST APIs for every workflow |
+
+## Mental Model
 
-A focused architecture tutorial for visual LLM workflow orchestration with Flowise.
+```mermaid
+graph TB
+    subgraph Frontend["React Frontend"]
+        CANVAS[Workflow Canvas]
+        NODES[Node Library]
+        PREVIEW[Chat Preview]
+    end
 
-## Current Status
+    subgraph Backend["Node.js Backend"]
+        ENGINE[Execution Engine]
+        STORE[Workflow Store]
+        STREAM[SSE Streaming]
+        API[REST API]
+    end
 
-Core chapter set is now published.
+    subgraph Integrations["Integrations"]
+        LLM[LLM Providers]
+        TOOLS[Tool Nodes]
+        DB[Vector Stores]
+    end
 
-| Item | Status |
-|:-----|:-------|
-| Published chapter docs | 8 |
-| Canonical entry point | [index.md](index.md) |
+    Frontend --> Backend
+    ENGINE --> Integrations
+```
 
-## Published Chapters
+## Chapter Guide
 
-| Chapter | File | Focus |
-|:--------|:-----|:------|
-| 1 | [01-system-overview.md](01-system-overview.md) | Monorepo architecture and component relationships |
-| 2 | [02-workflow-engine.md](02-workflow-engine.md) | Graph execution and streaming pipeline |
-| 3 | [03-node-development.md](03-node-development.md) | Custom node construction patterns |
-| 4 | [04-advanced-integrations.md](04-advanced-integrations.md) | Provider and tool integrations |
-| 5 | [05-production-deployment.md](05-production-deployment.md) | Deployment and scaling strategy |
-| 6 | [06-security-governance.md](06-security-governance.md) | Security posture and policy controls |
-| 7 | [07-observability.md](07-observability.md) | Metrics, tracing, and debugging |
-| 8 | [08-extension-ecosystem.md](08-extension-ecosystem.md) | Extension contracts and distribution |
+| Chapter | Topic | What You'll Learn |
+|---------|-------|-------------------|
+| [1. System Overview](01-system-overview.md) | Architecture | Monorepo structure, component relationships |
+| [2. Workflow Engine](02-workflow-engine.md) | Execution | Node graph execution, data flow, streaming |
+| [3. Node Development](03-node-development.md) | Extensibility | Building custom nodes, input/output types |
+| [4. Advanced Integrations](04-advanced-integrations.md) | Connections | LLM providers, vector stores, tools |
+| [5. Production Deployment](05-production-deployment.md) | Operations | Docker, scaling, monitoring |
+| [6. Security and Governance](06-security-governance.md) | Security | Secret handling, policy controls, tool safety |
+| [7. Observability](07-observability.md) | Monitoring | Tracing, metrics, and failure analysis |
+| [8. Extension Ecosystem](08-extension-ecosystem.md) | Growth | Extension contracts, distribution, compatibility |
 
-## Suggested Reading Order
+## Tech Stack
 
-1. Start with [index.md](index.md).
-2. Read chapters [1](01-system-overview.md) through [8](08-extension-ecosystem.md) in order.
+| Component | Technology |
+|-----------|-----------|
+| **Backend** | Node.js, Express |
+| **Frontend** | React, ReactFlow |
+| **Database** | SQLite / PostgreSQL / MySQL |
+| **Streaming** | Server-Sent Events |
+| **Deployment** | Docker, npm |
 
-## Upstream Project
+---
 
-- Flowise repository: <https://github.com/FlowiseAI/Flowise>
+Ready to begin? Start with [Chapter 1: System Overview](01-system-overview.md).
 
 ---
 
-Part of [Awesome Code Docs](../../README.md)
+*Built with insights from the [Flowise repository](https://github.com/FlowiseAI/Flowise) and community documentation.*
+
+## Navigation & Backlinks
+
+- [Start Here: Chapter 1: Flowise System Overview](01-system-overview.md)
+- [Back to Main Catalog](../../README.md#-tutorial-catalog)
+- [Browse A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
+- [Search by Intent](../../discoverability/query-hub.md)
+- [Explore Category Hubs](../../README.md#category-hubs)
+
+## Full Chapter Map
+
+1. [Chapter 1: Flowise System Overview](01-system-overview.md)
+2. [Chapter 2: Workflow Engine](02-workflow-engine.md)
+3. [Chapter 3: Node Development](03-node-development.md)
+4. [Chapter 4: Advanced Integrations](04-advanced-integrations.md)
+5. [Chapter 5: Production Deployment](05-production-deployment.md)
+6. [Chapter 6: Security and Governance](06-security-governance.md)
+7. [Chapter 7: Observability](07-observability.md)
+8. [Chapter 8: Extension Ecosystem](08-extension-ecosystem.md)
+
+## Current Snapshot (auto-updated)
+
+- repository: [FlowiseAI/Flowise](https://github.com/FlowiseAI/Flowise)
+- stars: about **34K**
+- project positioning: popular open-source visual LLM workflow builder with 100+ pre-built nodes
+
+## What You Will Learn
+
+- how Flowise's node graph execution engine processes data flow and streaming responses
+- how to build custom nodes with typed inputs and outputs for new integrations
+- how to connect LLM providers, vector stores, and external tools in visual workflows
+- how to deploy Flowise with Docker and manage security, governance, and observability
+
+## Source References
+
+- [Flowise](https://github.com/FlowiseAI/Flowise)
+
+*Generated by [AI Codebase Knowledge Builder](https://github.com/The-Pocket/Tutorial-Codebase-Knowledge)*
diff --git a/tutorials/flowise-llm-orchestration/index.md b/tutorials/flowise-llm-orchestration/index.md
deleted file mode 100644
index 2056edd0..00000000
--- a/tutorials/flowise-llm-orchestration/index.md
+++ /dev/null
@@ -1,134 +0,0 @@
----
-layout: default
-title: "Flowise LLM Orchestration"
-nav_order: 4
-has_children: true
-format_version: v2
----
-
-# Flowise LLM Orchestration: Deep Dive Tutorial
-
-> **Project**: [Flowise](https://github.com/FlowiseAI/Flowise) — An open-source visual tool for building LLM workflows with a drag-and-drop interface.
-
-[![Stars](https://img.shields.io/github/stars/FlowiseAI/Flowise?style=social)](https://github.com/FlowiseAI/Flowise)
-[![License: Apache 2.0](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
-[![Node.js](https://img.shields.io/badge/Node.js-React-green)](https://github.com/FlowiseAI/Flowise)
-
-## Why This Track Matters
-
-Flowise makes LLM orchestration visual and accessible — a drag-and-drop canvas for building production pipelines without boilerplate, with auto-generated APIs for every workflow you create.
-
-This track focuses on:
-- building LLM workflows visually with Flowise's node canvas
-- developing custom nodes to extend Flowise with new integrations
-- connecting LLM providers, vector stores, and tools in production pipelines
-- deploying and monitoring Flowise workflows with Docker
-
-## What Is Flowise?
-
-Flowise is an open-source visual workflow builder for LLM applications. It provides a drag-and-drop canvas for connecting AI models, data sources, and tools into production-ready pipelines — without writing boilerplate code.
-
-| Feature | Description |
-|---------|-------------|
-| **Visual Canvas** | Drag-and-drop workflow builder with real-time preview |
-| **Node Library** | 100+ pre-built nodes for LLMs, tools, and data sources |
-| **Streaming** | Real-time streaming responses with SSE |
-| **Multi-Model** | OpenAI, Anthropic, Google, HuggingFace, Ollama |
-| **Custom Nodes** | Extensible architecture for building custom integrations |
-| **API Export** | Auto-generated REST APIs for every workflow |
-
-## Mental Model
-
-```mermaid
-graph TB
-    subgraph Frontend["React Frontend"]
-        CANVAS[Workflow Canvas]
-        NODES[Node Library]
-        PREVIEW[Chat Preview]
-    end
-
-    subgraph Backend["Node.js Backend"]
-        ENGINE[Execution Engine]
-        STORE[Workflow Store]
-        STREAM[SSE Streaming]
-        API[REST API]
-    end
-
-    subgraph Integrations["Integrations"]
-        LLM[LLM Providers]
-        TOOLS[Tool Nodes]
-        DB[Vector Stores]
-    end
-
-    Frontend --> Backend
-    ENGINE --> Integrations
-```
-
-## Chapter Guide
-
-| Chapter | Topic | What You'll Learn |
-|---------|-------|-------------------|
-| [1. System Overview](01-system-overview.md) | Architecture | Monorepo structure, component relationships |
-| [2. Workflow Engine](02-workflow-engine.md) | Execution | Node graph execution, data flow, streaming |
-| [3. Node Development](03-node-development.md) | Extensibility | Building custom nodes, input/output types |
-| [4. Advanced Integrations](04-advanced-integrations.md) | Connections | LLM providers, vector stores, tools |
-| [5. Production Deployment](05-production-deployment.md) | Operations | Docker, scaling, monitoring |
-| [6. Security and Governance](06-security-governance.md) | Security | Secret handling, policy controls, tool safety |
-| [7. Observability](07-observability.md) | Monitoring | Tracing, metrics, and failure analysis |
-| [8. Extension Ecosystem](08-extension-ecosystem.md) | Growth | Extension contracts, distribution, compatibility |
-
-## Tech Stack
-
-| Component | Technology |
-|-----------|-----------|
-| **Backend** | Node.js, Express |
-| **Frontend** | React, ReactFlow |
-| **Database** | SQLite / PostgreSQL / MySQL |
-| **Streaming** | Server-Sent Events |
-| **Deployment** | Docker, npm |
-
----
-
-Ready to begin? Start with [Chapter 1: System Overview](01-system-overview.md).
-
----
-
-*Built with insights from the [Flowise repository](https://github.com/FlowiseAI/Flowise) and community documentation.*
-
-## Navigation & Backlinks
-
-- [Start Here: Chapter 1: Flowise System Overview](01-system-overview.md)
-- [Back to Main Catalog](../../README.md#-tutorial-catalog)
-- [Browse A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
-- [Search by Intent](../../discoverability/query-hub.md)
-- [Explore Category Hubs](../../README.md#category-hubs)
-
-## Full Chapter Map
-
-1. [Chapter 1: Flowise System Overview](01-system-overview.md)
-2. [Chapter 2: Workflow Engine](02-workflow-engine.md)
-3. [Chapter 3: Node Development](03-node-development.md)
-4. [Chapter 4: Advanced Integrations](04-advanced-integrations.md)
-5. [Chapter 5: Production Deployment](05-production-deployment.md)
-6. [Chapter 6: Security and Governance](06-security-governance.md)
-7. [Chapter 7: Observability](07-observability.md)
-8. [Chapter 8: Extension Ecosystem](08-extension-ecosystem.md)
-
-## Current Snapshot (auto-updated)
-
-- repository: [FlowiseAI/Flowise](https://github.com/FlowiseAI/Flowise)
-- stars: about **34K**
-- project positioning: popular open-source visual LLM workflow builder with 100+ pre-built nodes
-
-## What You Will Learn
-
-- how Flowise's node graph execution engine processes data flow and streaming responses
-- how to build custom nodes with typed inputs and outputs for new integrations
-- how to connect LLM providers, vector stores, and external tools in visual workflows
-- how to deploy Flowise with Docker and manage security, governance, and observability
-
-## Source References
-
-- [Flowise](https://github.com/FlowiseAI/Flowise)
-
-*Generated by [AI Codebase Knowledge Builder](https://github.com/The-Pocket/Tutorial-Codebase-Knowledge)*
diff --git a/tutorials/gemini-cli-tutorial/01-getting-started.md b/tutorials/gemini-cli-tutorial/01-getting-started.md
index 98e37536..4edce092 100644
--- a/tutorials/gemini-cli-tutorial/01-getting-started.md
+++ b/tutorials/gemini-cli-tutorial/01-getting-started.md
@@ -641,7 +641,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Architecture, Tools, and Agent Loop](02-architecture-tools-and-agent-loop.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/gemini-cli-tutorial/02-architecture-tools-and-agent-loop.md b/tutorials/gemini-cli-tutorial/02-architecture-tools-and-agent-loop.md
index 6aa84875..063ac1a6 100644
--- a/tutorials/gemini-cli-tutorial/02-architecture-tools-and-agent-loop.md
+++ b/tutorials/gemini-cli-tutorial/02-architecture-tools-and-agent-loop.md
@@ -636,7 +636,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started](01-getting-started.md)
 - [Next Chapter: Chapter 3: Authentication and Model Access Strategy](03-authentication-and-model-access-strategy.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/gemini-cli-tutorial/03-authentication-and-model-access-strategy.md b/tutorials/gemini-cli-tutorial/03-authentication-and-model-access-strategy.md
index e60d82ab..38ac726c 100644
--- a/tutorials/gemini-cli-tutorial/03-authentication-and-model-access-strategy.md
+++ b/tutorials/gemini-cli-tutorial/03-authentication-and-model-access-strategy.md
@@ -635,7 +635,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Architecture, Tools, and Agent Loop](02-architecture-tools-and-agent-loop.md)
 - [Next Chapter: Chapter 4: Settings, Context, and Custom Commands](04-settings-context-and-custom-commands.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/gemini-cli-tutorial/04-settings-context-and-custom-commands.md b/tutorials/gemini-cli-tutorial/04-settings-context-and-custom-commands.md
index 29af6e10..e0829728 100644
--- a/tutorials/gemini-cli-tutorial/04-settings-context-and-custom-commands.md
+++ b/tutorials/gemini-cli-tutorial/04-settings-context-and-custom-commands.md
@@ -630,7 +630,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Authentication and Model Access Strategy](03-authentication-and-model-access-strategy.md)
 - [Next Chapter: Chapter 5: MCP, Extensions, and Skills](05-mcp-extensions-and-skills.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/gemini-cli-tutorial/05-mcp-extensions-and-skills.md b/tutorials/gemini-cli-tutorial/05-mcp-extensions-and-skills.md
index 86c21f40..8d347a1e 100644
--- a/tutorials/gemini-cli-tutorial/05-mcp-extensions-and-skills.md
+++ b/tutorials/gemini-cli-tutorial/05-mcp-extensions-and-skills.md
@@ -628,7 +628,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Settings, Context, and Custom Commands](04-settings-context-and-custom-commands.md)
 - [Next Chapter: Chapter 6: Headless Mode and CI Automation](06-headless-mode-and-ci-automation.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/gemini-cli-tutorial/06-headless-mode-and-ci-automation.md b/tutorials/gemini-cli-tutorial/06-headless-mode-and-ci-automation.md
index 9b979c05..6604b0a4 100644
--- a/tutorials/gemini-cli-tutorial/06-headless-mode-and-ci-automation.md
+++ b/tutorials/gemini-cli-tutorial/06-headless-mode-and-ci-automation.md
@@ -638,7 +638,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: MCP, Extensions, and Skills](05-mcp-extensions-and-skills.md)
 - [Next Chapter: Chapter 7: Sandboxing, Security, and Troubleshooting](07-sandboxing-security-and-troubleshooting.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/gemini-cli-tutorial/07-sandboxing-security-and-troubleshooting.md b/tutorials/gemini-cli-tutorial/07-sandboxing-security-and-troubleshooting.md
index 0a24812e..4cdbe68a 100644
--- a/tutorials/gemini-cli-tutorial/07-sandboxing-security-and-troubleshooting.md
+++ b/tutorials/gemini-cli-tutorial/07-sandboxing-security-and-troubleshooting.md
@@ -629,7 +629,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Headless Mode and CI Automation](06-headless-mode-and-ci-automation.md)
 - [Next Chapter: Chapter 8: Contribution Workflow and Enterprise Operations](08-contribution-workflow-and-enterprise-operations.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/gemini-cli-tutorial/08-contribution-workflow-and-enterprise-operations.md b/tutorials/gemini-cli-tutorial/08-contribution-workflow-and-enterprise-operations.md
index 2c0308f1..f37b7123 100644
--- a/tutorials/gemini-cli-tutorial/08-contribution-workflow-and-enterprise-operations.md
+++ b/tutorials/gemini-cli-tutorial/08-contribution-workflow-and-enterprise-operations.md
@@ -637,7 +637,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Sandboxing, Security, and Troubleshooting](07-sandboxing-security-and-troubleshooting.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/gemini-cli-tutorial/index.md b/tutorials/gemini-cli-tutorial/README.md
similarity index 100%
rename from tutorials/gemini-cli-tutorial/index.md
rename to tutorials/gemini-cli-tutorial/README.md
diff --git a/tutorials/genai-toolbox-tutorial/01-getting-started.md b/tutorials/genai-toolbox-tutorial/01-getting-started.md
index 19add24a..9d71749e 100644
--- a/tutorials/genai-toolbox-tutorial/01-getting-started.md
+++ b/tutorials/genai-toolbox-tutorial/01-getting-started.md
@@ -637,7 +637,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Architecture and Control Plane](02-architecture-and-control-plane.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/genai-toolbox-tutorial/02-architecture-and-control-plane.md b/tutorials/genai-toolbox-tutorial/02-architecture-and-control-plane.md
index 054d86e5..5d96718c 100644
--- a/tutorials/genai-toolbox-tutorial/02-architecture-and-control-plane.md
+++ b/tutorials/genai-toolbox-tutorial/02-architecture-and-control-plane.md
@@ -632,7 +632,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started](01-getting-started.md)
 - [Next Chapter: Chapter 3: `tools.yaml`: Sources, Tools, Toolsets, Prompts](03-tools-yaml-sources-tools-toolsets-prompts.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/genai-toolbox-tutorial/03-tools-yaml-sources-tools-toolsets-prompts.md b/tutorials/genai-toolbox-tutorial/03-tools-yaml-sources-tools-toolsets-prompts.md
index 911b1876..2e7e43d8 100644
--- a/tutorials/genai-toolbox-tutorial/03-tools-yaml-sources-tools-toolsets-prompts.md
+++ b/tutorials/genai-toolbox-tutorial/03-tools-yaml-sources-tools-toolsets-prompts.md
@@ -632,7 +632,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Architecture and Control Plane](02-architecture-and-control-plane.md)
 - [Next Chapter: Chapter 4: MCP Connectivity and Client Integration](04-mcp-connectivity-and-client-integration.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/genai-toolbox-tutorial/04-mcp-connectivity-and-client-integration.md b/tutorials/genai-toolbox-tutorial/04-mcp-connectivity-and-client-integration.md
index f0655234..4d2d3e67 100644
--- a/tutorials/genai-toolbox-tutorial/04-mcp-connectivity-and-client-integration.md
+++ b/tutorials/genai-toolbox-tutorial/04-mcp-connectivity-and-client-integration.md
@@ -633,7 +633,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: `tools.yaml`: Sources, Tools, Toolsets, Prompts](03-tools-yaml-sources-tools-toolsets-prompts.md)
 - [Next Chapter: Chapter 5: Prebuilt Connectors and Database Patterns](05-prebuilt-connectors-and-database-patterns.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/genai-toolbox-tutorial/05-prebuilt-connectors-and-database-patterns.md b/tutorials/genai-toolbox-tutorial/05-prebuilt-connectors-and-database-patterns.md
index 9e535dc1..84e8688e 100644
--- a/tutorials/genai-toolbox-tutorial/05-prebuilt-connectors-and-database-patterns.md
+++ b/tutorials/genai-toolbox-tutorial/05-prebuilt-connectors-and-database-patterns.md
@@ -633,7 +633,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: MCP Connectivity and Client Integration](04-mcp-connectivity-and-client-integration.md)
 - [Next Chapter: Chapter 6: Deployment and Observability Patterns](06-deployment-and-observability-patterns.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/genai-toolbox-tutorial/06-deployment-and-observability-patterns.md b/tutorials/genai-toolbox-tutorial/06-deployment-and-observability-patterns.md
index f96dea18..1408a39f 100644
--- a/tutorials/genai-toolbox-tutorial/06-deployment-and-observability-patterns.md
+++ b/tutorials/genai-toolbox-tutorial/06-deployment-and-observability-patterns.md
@@ -633,7 +633,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Prebuilt Connectors and Database Patterns](05-prebuilt-connectors-and-database-patterns.md)
 - [Next Chapter: Chapter 7: CLI, Testing, and Development Workflow](07-cli-testing-and-development-workflow.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/genai-toolbox-tutorial/07-cli-testing-and-development-workflow.md b/tutorials/genai-toolbox-tutorial/07-cli-testing-and-development-workflow.md
index dd8985c3..5f0efb3b 100644
--- a/tutorials/genai-toolbox-tutorial/07-cli-testing-and-development-workflow.md
+++ b/tutorials/genai-toolbox-tutorial/07-cli-testing-and-development-workflow.md
@@ -633,7 +633,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Deployment and Observability Patterns](06-deployment-and-observability-patterns.md)
 - [Next Chapter: Chapter 8: Production Governance and Release Strategy](08-production-governance-and-release-strategy.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/genai-toolbox-tutorial/08-production-governance-and-release-strategy.md b/tutorials/genai-toolbox-tutorial/08-production-governance-and-release-strategy.md
index d9f4b0fe..20d1f8a8 100644
--- a/tutorials/genai-toolbox-tutorial/08-production-governance-and-release-strategy.md
+++ b/tutorials/genai-toolbox-tutorial/08-production-governance-and-release-strategy.md
@@ -635,7 +635,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: CLI, Testing, and Development Workflow](07-cli-testing-and-development-workflow.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/genai-toolbox-tutorial/index.md b/tutorials/genai-toolbox-tutorial/README.md
similarity index 100%
rename from tutorials/genai-toolbox-tutorial/index.md
rename to tutorials/genai-toolbox-tutorial/README.md
diff --git a/tutorials/github-mcp-server-tutorial/01-getting-started.md b/tutorials/github-mcp-server-tutorial/01-getting-started.md
index c87aad2b..b7a00f0f 100644
--- a/tutorials/github-mcp-server-tutorial/01-getting-started.md
+++ b/tutorials/github-mcp-server-tutorial/01-getting-started.md
@@ -633,7 +633,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Remote vs Local Architecture](02-remote-vs-local-architecture.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/github-mcp-server-tutorial/02-remote-vs-local-architecture.md b/tutorials/github-mcp-server-tutorial/02-remote-vs-local-architecture.md
index 09d3e18b..36f17321 100644
--- a/tutorials/github-mcp-server-tutorial/02-remote-vs-local-architecture.md
+++ b/tutorials/github-mcp-server-tutorial/02-remote-vs-local-architecture.md
@@ -631,7 +631,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started](01-getting-started.md)
 - [Next Chapter: Chapter 3: Authentication and Token Strategy](03-authentication-and-token-strategy.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/github-mcp-server-tutorial/03-authentication-and-token-strategy.md b/tutorials/github-mcp-server-tutorial/03-authentication-and-token-strategy.md
index 504b2359..e3b8eb16 100644
--- a/tutorials/github-mcp-server-tutorial/03-authentication-and-token-strategy.md
+++ b/tutorials/github-mcp-server-tutorial/03-authentication-and-token-strategy.md
@@ -635,7 +635,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Remote vs Local Architecture](02-remote-vs-local-architecture.md)
 - [Next Chapter: Chapter 4: Toolsets, Tools, and Dynamic Discovery](04-toolsets-tools-and-dynamic-discovery.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/github-mcp-server-tutorial/04-toolsets-tools-and-dynamic-discovery.md b/tutorials/github-mcp-server-tutorial/04-toolsets-tools-and-dynamic-discovery.md
index 6019d7a2..11945ea8 100644
--- a/tutorials/github-mcp-server-tutorial/04-toolsets-tools-and-dynamic-discovery.md
+++ b/tutorials/github-mcp-server-tutorial/04-toolsets-tools-and-dynamic-discovery.md
@@ -630,7 +630,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Authentication and Token Strategy](03-authentication-and-token-strategy.md)
 - [Next Chapter: Chapter 5: Host Integration Patterns](05-host-integration-patterns.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/github-mcp-server-tutorial/05-host-integration-patterns.md b/tutorials/github-mcp-server-tutorial/05-host-integration-patterns.md
index 29a23414..0ed8aed4 100644
--- a/tutorials/github-mcp-server-tutorial/05-host-integration-patterns.md
+++ b/tutorials/github-mcp-server-tutorial/05-host-integration-patterns.md
@@ -631,7 +631,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Toolsets, Tools, and Dynamic Discovery](04-toolsets-tools-and-dynamic-discovery.md)
 - [Next Chapter: Chapter 6: Security, Governance, and Enterprise Controls](06-security-governance-and-enterprise-controls.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/github-mcp-server-tutorial/06-security-governance-and-enterprise-controls.md b/tutorials/github-mcp-server-tutorial/06-security-governance-and-enterprise-controls.md
index 4422ff5c..82edd48a 100644
--- a/tutorials/github-mcp-server-tutorial/06-security-governance-and-enterprise-controls.md
+++ b/tutorials/github-mcp-server-tutorial/06-security-governance-and-enterprise-controls.md
@@ -629,7 +629,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Host Integration Patterns](05-host-integration-patterns.md)
 - [Next Chapter: Chapter 7: Troubleshooting, Read-Only, and Lockdown Operations](07-troubleshooting-read-only-and-lockdown-operations.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/github-mcp-server-tutorial/07-troubleshooting-read-only-and-lockdown-operations.md b/tutorials/github-mcp-server-tutorial/07-troubleshooting-read-only-and-lockdown-operations.md
index fc6dadd1..5c0649cb 100644
--- a/tutorials/github-mcp-server-tutorial/07-troubleshooting-read-only-and-lockdown-operations.md
+++ b/tutorials/github-mcp-server-tutorial/07-troubleshooting-read-only-and-lockdown-operations.md
@@ -629,7 +629,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Security, Governance, and Enterprise Controls](06-security-governance-and-enterprise-controls.md)
 - [Next Chapter: Chapter 8: Contribution and Upgrade Workflow](08-contribution-and-upgrade-workflow.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/github-mcp-server-tutorial/08-contribution-and-upgrade-workflow.md b/tutorials/github-mcp-server-tutorial/08-contribution-and-upgrade-workflow.md
index 379177d8..b7a255e4 100644
--- a/tutorials/github-mcp-server-tutorial/08-contribution-and-upgrade-workflow.md
+++ b/tutorials/github-mcp-server-tutorial/08-contribution-and-upgrade-workflow.md
@@ -631,7 +631,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Troubleshooting, Read-Only, and Lockdown Operations](07-troubleshooting-read-only-and-lockdown-operations.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/github-mcp-server-tutorial/index.md b/tutorials/github-mcp-server-tutorial/README.md
similarity index 100%
rename from tutorials/github-mcp-server-tutorial/index.md
rename to tutorials/github-mcp-server-tutorial/README.md
diff --git a/tutorials/goose-tutorial/01-getting-started.md b/tutorials/goose-tutorial/01-getting-started.md
index d4b4600f..1976437f 100644
--- a/tutorials/goose-tutorial/01-getting-started.md
+++ b/tutorials/goose-tutorial/01-getting-started.md
@@ -644,7 +644,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Architecture and Agent Loop](02-architecture-and-agent-loop.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/goose-tutorial/02-architecture-and-agent-loop.md b/tutorials/goose-tutorial/02-architecture-and-agent-loop.md
index 50769800..f013aee8 100644
--- a/tutorials/goose-tutorial/02-architecture-and-agent-loop.md
+++ b/tutorials/goose-tutorial/02-architecture-and-agent-loop.md
@@ -637,7 +637,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started](01-getting-started.md)
 - [Next Chapter: Chapter 3: Providers and Model Routing](03-providers-and-model-routing.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/goose-tutorial/03-providers-and-model-routing.md b/tutorials/goose-tutorial/03-providers-and-model-routing.md
index f1417e10..517b083d 100644
--- a/tutorials/goose-tutorial/03-providers-and-model-routing.md
+++ b/tutorials/goose-tutorial/03-providers-and-model-routing.md
@@ -636,7 +636,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Architecture and Agent Loop](02-architecture-and-agent-loop.md)
 - [Next Chapter: Chapter 4: Permissions and Tool Governance](04-permissions-and-tool-governance.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/goose-tutorial/04-permissions-and-tool-governance.md b/tutorials/goose-tutorial/04-permissions-and-tool-governance.md
index 87f9f11b..a6662891 100644
--- a/tutorials/goose-tutorial/04-permissions-and-tool-governance.md
+++ b/tutorials/goose-tutorial/04-permissions-and-tool-governance.md
@@ -638,7 +638,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Providers and Model Routing](03-providers-and-model-routing.md)
 - [Next Chapter: Chapter 5: Sessions and Context Management](05-sessions-and-context-management.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/goose-tutorial/05-sessions-and-context-management.md b/tutorials/goose-tutorial/05-sessions-and-context-management.md
index f0409fb2..eaaa3ce5 100644
--- a/tutorials/goose-tutorial/05-sessions-and-context-management.md
+++ b/tutorials/goose-tutorial/05-sessions-and-context-management.md
@@ -632,7 +632,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Permissions and Tool Governance](04-permissions-and-tool-governance.md)
 - [Next Chapter: Chapter 6: Extensions and MCP Integration](06-extensions-and-mcp-integration.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/goose-tutorial/06-extensions-and-mcp-integration.md b/tutorials/goose-tutorial/06-extensions-and-mcp-integration.md
index 43810e78..dc888a97 100644
--- a/tutorials/goose-tutorial/06-extensions-and-mcp-integration.md
+++ b/tutorials/goose-tutorial/06-extensions-and-mcp-integration.md
@@ -643,7 +643,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Sessions and Context Management](05-sessions-and-context-management.md)
 - [Next Chapter: Chapter 7: CLI Workflows and Automation](07-cli-workflows-and-automation.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/goose-tutorial/07-cli-workflows-and-automation.md b/tutorials/goose-tutorial/07-cli-workflows-and-automation.md
index bc62eaef..8c34b49a 100644
--- a/tutorials/goose-tutorial/07-cli-workflows-and-automation.md
+++ b/tutorials/goose-tutorial/07-cli-workflows-and-automation.md
@@ -642,7 +642,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Extensions and MCP Integration](06-extensions-and-mcp-integration.md)
 - [Next Chapter: Chapter 8: Production Operations and Security](08-production-operations-and-security.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/goose-tutorial/08-production-operations-and-security.md b/tutorials/goose-tutorial/08-production-operations-and-security.md
index 458ea840..f91b6fce 100644
--- a/tutorials/goose-tutorial/08-production-operations-and-security.md
+++ b/tutorials/goose-tutorial/08-production-operations-and-security.md
@@ -642,7 +642,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: CLI Workflows and Automation](07-cli-workflows-and-automation.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/goose-tutorial/index.md b/tutorials/goose-tutorial/README.md
similarity index 100%
rename from tutorials/goose-tutorial/index.md
rename to tutorials/goose-tutorial/README.md
diff --git a/tutorials/gpt-oss-tutorial/01-getting-started.md b/tutorials/gpt-oss-tutorial/01-getting-started.md
index 3a2c95c9..4205d060 100644
--- a/tutorials/gpt-oss-tutorial/01-getting-started.md
+++ b/tutorials/gpt-oss-tutorial/01-getting-started.md
@@ -507,7 +507,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Transformer Architecture -- Self-Attention, Multi-Head Attention, and Feed-Forward Networks](02-transformer-architecture.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/gpt-oss-tutorial/02-transformer-architecture.md b/tutorials/gpt-oss-tutorial/02-transformer-architecture.md
index 3d95dc63..0eda64db 100644
--- a/tutorials/gpt-oss-tutorial/02-transformer-architecture.md
+++ b/tutorials/gpt-oss-tutorial/02-transformer-architecture.md
@@ -607,7 +607,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started -- Understanding the Open-Source GPT Landscape](01-getting-started.md)
 - [Next Chapter: Chapter 3: Tokenization & Embeddings -- BPE, Vocabulary Construction, and Positional Encodings](03-tokenization-embeddings.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/gpt-oss-tutorial/03-tokenization-embeddings.md b/tutorials/gpt-oss-tutorial/03-tokenization-embeddings.md
index e8531628..cb239041 100644
--- a/tutorials/gpt-oss-tutorial/03-tokenization-embeddings.md
+++ b/tutorials/gpt-oss-tutorial/03-tokenization-embeddings.md
@@ -605,7 +605,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Transformer Architecture -- Self-Attention, Multi-Head Attention, and Feed-Forward Networks](02-transformer-architecture.md)
 - [Next Chapter: Chapter 4: Training Pipeline -- Data Loading, Loss Computation, Gradient Accumulation, and Mixed Precision](04-training-pipeline.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/gpt-oss-tutorial/04-training-pipeline.md b/tutorials/gpt-oss-tutorial/04-training-pipeline.md
index 6687243d..51921fe7 100644
--- a/tutorials/gpt-oss-tutorial/04-training-pipeline.md
+++ b/tutorials/gpt-oss-tutorial/04-training-pipeline.md
@@ -658,7 +658,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Tokenization & Embeddings -- BPE, Vocabulary Construction, and Positional Encodings](03-tokenization-embeddings.md)
 - [Next Chapter: Chapter 5: Attention Mechanisms -- Causal Masking, KV-Cache, Multi-Query Attention, and Flash Attention](05-attention-mechanisms.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/gpt-oss-tutorial/05-attention-mechanisms.md b/tutorials/gpt-oss-tutorial/05-attention-mechanisms.md
index 15f77682..11838d64 100644
--- a/tutorials/gpt-oss-tutorial/05-attention-mechanisms.md
+++ b/tutorials/gpt-oss-tutorial/05-attention-mechanisms.md
@@ -573,7 +573,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Training Pipeline -- Data Loading, Loss Computation, Gradient Accumulation, and Mixed Precision](04-training-pipeline.md)
 - [Next Chapter: Chapter 6: Scaling & Distributed Training -- Model Parallelism, Data Parallelism, ZeRO, and FSDP](06-scaling-distributed-training.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/gpt-oss-tutorial/06-scaling-distributed-training.md b/tutorials/gpt-oss-tutorial/06-scaling-distributed-training.md
index 37361cfa..7eacfe3c 100644
--- a/tutorials/gpt-oss-tutorial/06-scaling-distributed-training.md
+++ b/tutorials/gpt-oss-tutorial/06-scaling-distributed-training.md
@@ -670,7 +670,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Attention Mechanisms -- Causal Masking, KV-Cache, Multi-Query Attention, and Flash Attention](05-attention-mechanisms.md)
 - [Next Chapter: Chapter 7: Fine-Tuning & Alignment -- LoRA, QLoRA, RLHF, DPO, and Instruction Tuning](07-fine-tuning-alignment.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/gpt-oss-tutorial/07-fine-tuning-alignment.md b/tutorials/gpt-oss-tutorial/07-fine-tuning-alignment.md
index 51982921..aa2233c8 100644
--- a/tutorials/gpt-oss-tutorial/07-fine-tuning-alignment.md
+++ b/tutorials/gpt-oss-tutorial/07-fine-tuning-alignment.md
@@ -697,7 +697,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Scaling & Distributed Training -- Model Parallelism, Data Parallelism, ZeRO, and FSDP](06-scaling-distributed-training.md)
 - [Next Chapter: Chapter 8: Production Inference -- Quantization, Batching, Speculative Decoding, and Deployment](08-production-inference.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/gpt-oss-tutorial/08-production-inference.md b/tutorials/gpt-oss-tutorial/08-production-inference.md
index b7e276e8..1aebc46d 100644
--- a/tutorials/gpt-oss-tutorial/08-production-inference.md
+++ b/tutorials/gpt-oss-tutorial/08-production-inference.md
@@ -728,7 +728,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Fine-Tuning & Alignment -- LoRA, QLoRA, RLHF, DPO, and Instruction Tuning](07-fine-tuning-alignment.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/gpt-oss-tutorial/index.md b/tutorials/gpt-oss-tutorial/README.md
similarity index 100%
rename from tutorials/gpt-oss-tutorial/index.md
rename to tutorials/gpt-oss-tutorial/README.md
diff --git a/tutorials/gptme-tutorial/01-getting-started.md b/tutorials/gptme-tutorial/01-getting-started.md
index ecc10fad..fa14a728 100644
--- a/tutorials/gptme-tutorial/01-getting-started.md
+++ b/tutorials/gptme-tutorial/01-getting-started.md
@@ -631,7 +631,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Core CLI Workflow and Prompt Patterns](02-core-cli-workflow-and-prompt-patterns.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/gptme-tutorial/02-core-cli-workflow-and-prompt-patterns.md b/tutorials/gptme-tutorial/02-core-cli-workflow-and-prompt-patterns.md
index c077536b..dde7ba34 100644
--- a/tutorials/gptme-tutorial/02-core-cli-workflow-and-prompt-patterns.md
+++ b/tutorials/gptme-tutorial/02-core-cli-workflow-and-prompt-patterns.md
@@ -637,7 +637,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started](01-getting-started.md)
 - [Next Chapter: Chapter 3: Tooling and Local Execution Boundaries](03-tooling-and-local-execution-boundaries.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/gptme-tutorial/03-tooling-and-local-execution-boundaries.md b/tutorials/gptme-tutorial/03-tooling-and-local-execution-boundaries.md
index 466e593b..16e4e715 100644
--- a/tutorials/gptme-tutorial/03-tooling-and-local-execution-boundaries.md
+++ b/tutorials/gptme-tutorial/03-tooling-and-local-execution-boundaries.md
@@ -637,7 +637,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Core CLI Workflow and Prompt Patterns](02-core-cli-workflow-and-prompt-patterns.md)
 - [Next Chapter: Chapter 4: Configuration Layers and Environment Strategy](04-configuration-layers-and-environment-strategy.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/gptme-tutorial/04-configuration-layers-and-environment-strategy.md b/tutorials/gptme-tutorial/04-configuration-layers-and-environment-strategy.md
index 96c2e7fb..695249fb 100644
--- a/tutorials/gptme-tutorial/04-configuration-layers-and-environment-strategy.md
+++ b/tutorials/gptme-tutorial/04-configuration-layers-and-environment-strategy.md
@@ -636,7 +636,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Tooling and Local Execution Boundaries](03-tooling-and-local-execution-boundaries.md)
 - [Next Chapter: Chapter 5: Context, Lessons, and Conversation Management](05-context-lessons-and-conversation-management.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/gptme-tutorial/05-context-lessons-and-conversation-management.md b/tutorials/gptme-tutorial/05-context-lessons-and-conversation-management.md
index 469335bf..51126f24 100644
--- a/tutorials/gptme-tutorial/05-context-lessons-and-conversation-management.md
+++ b/tutorials/gptme-tutorial/05-context-lessons-and-conversation-management.md
@@ -636,7 +636,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Configuration Layers and Environment Strategy](04-configuration-layers-and-environment-strategy.md)
 - [Next Chapter: Chapter 6: MCP, ACP, and Plugin Extensibility](06-mcp-acp-and-plugin-extensibility.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/gptme-tutorial/06-mcp-acp-and-plugin-extensibility.md b/tutorials/gptme-tutorial/06-mcp-acp-and-plugin-extensibility.md
index 7c75a02d..c188fab5 100644
--- a/tutorials/gptme-tutorial/06-mcp-acp-and-plugin-extensibility.md
+++ b/tutorials/gptme-tutorial/06-mcp-acp-and-plugin-extensibility.md
@@ -637,7 +637,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Context, Lessons, and Conversation Management](05-context-lessons-and-conversation-management.md)
 - [Next Chapter: Chapter 7: Automation, Server Mode, and Agent Templates](07-automation-server-mode-and-agent-templates.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/gptme-tutorial/07-automation-server-mode-and-agent-templates.md b/tutorials/gptme-tutorial/07-automation-server-mode-and-agent-templates.md
index 05cc5f7d..fd468f37 100644
--- a/tutorials/gptme-tutorial/07-automation-server-mode-and-agent-templates.md
+++ b/tutorials/gptme-tutorial/07-automation-server-mode-and-agent-templates.md
@@ -633,7 +633,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: MCP, ACP, and Plugin Extensibility](06-mcp-acp-and-plugin-extensibility.md)
 - [Next Chapter: Chapter 8: Production Operations and Security](08-production-operations-and-security.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/gptme-tutorial/08-production-operations-and-security.md b/tutorials/gptme-tutorial/08-production-operations-and-security.md
index e02d43b6..498ddfd2 100644
--- a/tutorials/gptme-tutorial/08-production-operations-and-security.md
+++ b/tutorials/gptme-tutorial/08-production-operations-and-security.md
@@ -629,7 +629,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Automation, Server Mode, and Agent Templates](07-automation-server-mode-and-agent-templates.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/gptme-tutorial/index.md b/tutorials/gptme-tutorial/README.md
similarity index 100%
rename from tutorials/gptme-tutorial/index.md
rename to tutorials/gptme-tutorial/README.md
diff --git a/tutorials/hapi-tutorial/01-getting-started.md b/tutorials/hapi-tutorial/01-getting-started.md
index 38c06436..619f386b 100644
--- a/tutorials/hapi-tutorial/01-getting-started.md
+++ b/tutorials/hapi-tutorial/01-getting-started.md
@@ -94,7 +94,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: System Architecture](02-system-architecture.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/hapi-tutorial/02-system-architecture.md b/tutorials/hapi-tutorial/02-system-architecture.md
index c0fc2da0..275bd3fb 100644
--- a/tutorials/hapi-tutorial/02-system-architecture.md
+++ b/tutorials/hapi-tutorial/02-system-architecture.md
@@ -88,7 +88,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started](01-getting-started.md)
 - [Next Chapter: Chapter 3: Session Lifecycle and Handoff](03-session-lifecycle-and-handoff.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/hapi-tutorial/03-session-lifecycle-and-handoff.md b/tutorials/hapi-tutorial/03-session-lifecycle-and-handoff.md
index 93211da5..bfb06678 100644
--- a/tutorials/hapi-tutorial/03-session-lifecycle-and-handoff.md
+++ b/tutorials/hapi-tutorial/03-session-lifecycle-and-handoff.md
@@ -86,7 +86,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: System Architecture](02-system-architecture.md)
 - [Next Chapter: Chapter 4: Remote Access and Networking](04-remote-access-and-networking.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/hapi-tutorial/04-remote-access-and-networking.md b/tutorials/hapi-tutorial/04-remote-access-and-networking.md
index 564ceac1..30cd5316 100644
--- a/tutorials/hapi-tutorial/04-remote-access-and-networking.md
+++ b/tutorials/hapi-tutorial/04-remote-access-and-networking.md
@@ -80,7 +80,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Session Lifecycle and Handoff](03-session-lifecycle-and-handoff.md)
 - [Next Chapter: Chapter 5: Permissions and Approval Workflow](05-permissions-and-approval-workflow.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/hapi-tutorial/05-permissions-and-approval-workflow.md b/tutorials/hapi-tutorial/05-permissions-and-approval-workflow.md
index 9e8d6f1a..bfc9c134 100644
--- a/tutorials/hapi-tutorial/05-permissions-and-approval-workflow.md
+++ b/tutorials/hapi-tutorial/05-permissions-and-approval-workflow.md
@@ -80,7 +80,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Remote Access and Networking](04-remote-access-and-networking.md)
 - [Next Chapter: Chapter 6: PWA, Telegram, and Extensions](06-pwa-telegram-and-extensions.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/hapi-tutorial/06-pwa-telegram-and-extensions.md b/tutorials/hapi-tutorial/06-pwa-telegram-and-extensions.md
index 5d9d3ea9..050c5b3c 100644
--- a/tutorials/hapi-tutorial/06-pwa-telegram-and-extensions.md
+++ b/tutorials/hapi-tutorial/06-pwa-telegram-and-extensions.md
@@ -76,7 +76,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Permissions and Approval Workflow](05-permissions-and-approval-workflow.md)
 - [Next Chapter: Chapter 7: Configuration and Security](07-configuration-and-security.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/hapi-tutorial/07-configuration-and-security.md b/tutorials/hapi-tutorial/07-configuration-and-security.md
index ffe786d0..5d965162 100644
--- a/tutorials/hapi-tutorial/07-configuration-and-security.md
+++ b/tutorials/hapi-tutorial/07-configuration-and-security.md
@@ -80,7 +80,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: PWA, Telegram, and Extensions](06-pwa-telegram-and-extensions.md)
 - [Next Chapter: Chapter 8: Production Operations](08-production-operations.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/hapi-tutorial/08-production-operations.md b/tutorials/hapi-tutorial/08-production-operations.md
index a73b4235..756c856a 100644
--- a/tutorials/hapi-tutorial/08-production-operations.md
+++ b/tutorials/hapi-tutorial/08-production-operations.md
@@ -84,7 +84,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Configuration and Security](07-configuration-and-security.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/hapi-tutorial/index.md b/tutorials/hapi-tutorial/README.md
similarity index 100%
rename from tutorials/hapi-tutorial/index.md
rename to tutorials/hapi-tutorial/README.md
diff --git a/tutorials/haystack-tutorial/01-getting-started.md b/tutorials/haystack-tutorial/01-getting-started.md
index a8e5bb69..4579c614 100644
--- a/tutorials/haystack-tutorial/01-getting-started.md
+++ b/tutorials/haystack-tutorial/01-getting-started.md
@@ -442,7 +442,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Document Stores](02-document-stores.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/haystack-tutorial/02-document-stores.md b/tutorials/haystack-tutorial/02-document-stores.md
index a243802b..bc2d2450 100644
--- a/tutorials/haystack-tutorial/02-document-stores.md
+++ b/tutorials/haystack-tutorial/02-document-stores.md
@@ -585,7 +585,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started with Haystack](01-getting-started.md)
 - [Next Chapter: Chapter 3: Retrievers & Search](03-retrievers-search.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/haystack-tutorial/03-retrievers-search.md b/tutorials/haystack-tutorial/03-retrievers-search.md
index 7b0e36ef..30d7e651 100644
--- a/tutorials/haystack-tutorial/03-retrievers-search.md
+++ b/tutorials/haystack-tutorial/03-retrievers-search.md
@@ -721,7 +721,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Document Stores](02-document-stores.md)
 - [Next Chapter: Chapter 4: Generators & LLMs](04-generators-llms.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/haystack-tutorial/04-generators-llms.md b/tutorials/haystack-tutorial/04-generators-llms.md
index 8bb34b0c..9001e40f 100644
--- a/tutorials/haystack-tutorial/04-generators-llms.md
+++ b/tutorials/haystack-tutorial/04-generators-llms.md
@@ -799,7 +799,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Retrievers & Search](03-retrievers-search.md)
 - [Next Chapter: Chapter 5: Pipelines & Workflows](05-pipelines-workflows.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/haystack-tutorial/05-pipelines-workflows.md b/tutorials/haystack-tutorial/05-pipelines-workflows.md
index 2a8100db..6c85377d 100644
--- a/tutorials/haystack-tutorial/05-pipelines-workflows.md
+++ b/tutorials/haystack-tutorial/05-pipelines-workflows.md
@@ -895,7 +895,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Generators & LLMs](04-generators-llms.md)
 - [Next Chapter: Chapter 6: Evaluation & Optimization](06-evaluation-optimization.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/haystack-tutorial/06-evaluation-optimization.md b/tutorials/haystack-tutorial/06-evaluation-optimization.md
index 3f5df58a..2b3069a6 100644
--- a/tutorials/haystack-tutorial/06-evaluation-optimization.md
+++ b/tutorials/haystack-tutorial/06-evaluation-optimization.md
@@ -962,7 +962,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Pipelines & Workflows](05-pipelines-workflows.md)
 - [Next Chapter: Chapter 7: Custom Components](07-custom-components.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/haystack-tutorial/07-custom-components.md b/tutorials/haystack-tutorial/07-custom-components.md
index 274f2400..ac45a572 100644
--- a/tutorials/haystack-tutorial/07-custom-components.md
+++ b/tutorials/haystack-tutorial/07-custom-components.md
@@ -1189,7 +1189,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Evaluation & Optimization](06-evaluation-optimization.md)
 - [Next Chapter: Chapter 8: Production Deployment](08-production-deployment.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/haystack-tutorial/08-production-deployment.md b/tutorials/haystack-tutorial/08-production-deployment.md
index c38d559d..f0f52d80 100644
--- a/tutorials/haystack-tutorial/08-production-deployment.md
+++ b/tutorials/haystack-tutorial/08-production-deployment.md
@@ -1161,7 +1161,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Custom Components](07-custom-components.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/haystack-tutorial/index.md b/tutorials/haystack-tutorial/README.md
similarity index 100%
rename from tutorials/haystack-tutorial/index.md
rename to tutorials/haystack-tutorial/README.md
diff --git a/tutorials/huggingface-tutorial/01-getting-started.md b/tutorials/huggingface-tutorial/01-getting-started.md
index 7112aa0b..c472ee70 100644
--- a/tutorials/huggingface-tutorial/01-getting-started.md
+++ b/tutorials/huggingface-tutorial/01-getting-started.md
@@ -469,7 +469,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Text Classification & Analysis](02-text-classification.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/huggingface-tutorial/02-text-classification.md b/tutorials/huggingface-tutorial/02-text-classification.md
index a42023da..0cd2dc24 100644
--- a/tutorials/huggingface-tutorial/02-text-classification.md
+++ b/tutorials/huggingface-tutorial/02-text-classification.md
@@ -485,7 +485,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started with HuggingFace Transformers](01-getting-started.md)
 - [Next Chapter: Chapter 3: Text Generation](03-text-generation.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/huggingface-tutorial/03-text-generation.md b/tutorials/huggingface-tutorial/03-text-generation.md
index a4829731..05256edf 100644
--- a/tutorials/huggingface-tutorial/03-text-generation.md
+++ b/tutorials/huggingface-tutorial/03-text-generation.md
@@ -609,7 +609,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Text Classification & Analysis](02-text-classification.md)
 - [Next Chapter: Chapter 4: Question Answering](04-question-answering.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/huggingface-tutorial/04-question-answering.md b/tutorials/huggingface-tutorial/04-question-answering.md
index def95102..6093beea 100644
--- a/tutorials/huggingface-tutorial/04-question-answering.md
+++ b/tutorials/huggingface-tutorial/04-question-answering.md
@@ -752,7 +752,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Text Generation](03-text-generation.md)
 - [Next Chapter: Chapter 5: Named Entity Recognition](05-named-entity-recognition.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/huggingface-tutorial/05-named-entity-recognition.md b/tutorials/huggingface-tutorial/05-named-entity-recognition.md
index 9ced21c5..65dec4c4 100644
--- a/tutorials/huggingface-tutorial/05-named-entity-recognition.md
+++ b/tutorials/huggingface-tutorial/05-named-entity-recognition.md
@@ -850,7 +850,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Question Answering](04-question-answering.md)
 - [Next Chapter: Chapter 6: Translation & Multilingual Models](06-translation-multilingual.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/huggingface-tutorial/06-translation-multilingual.md b/tutorials/huggingface-tutorial/06-translation-multilingual.md
index 1288f488..9c9718d0 100644
--- a/tutorials/huggingface-tutorial/06-translation-multilingual.md
+++ b/tutorials/huggingface-tutorial/06-translation-multilingual.md
@@ -747,7 +747,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Named Entity Recognition](05-named-entity-recognition.md)
 - [Next Chapter: Chapter 7: Fine-tuning Models](07-fine-tuning.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/huggingface-tutorial/07-fine-tuning.md b/tutorials/huggingface-tutorial/07-fine-tuning.md
index 1d0dec3c..e6996a14 100644
--- a/tutorials/huggingface-tutorial/07-fine-tuning.md
+++ b/tutorials/huggingface-tutorial/07-fine-tuning.md
@@ -729,7 +729,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Translation & Multilingual Models](06-translation-multilingual.md)
 - [Next Chapter: Chapter 8: Production Deployment](08-production-deployment.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/huggingface-tutorial/08-production-deployment.md b/tutorials/huggingface-tutorial/08-production-deployment.md
index e233f9af..774ea776 100644
--- a/tutorials/huggingface-tutorial/08-production-deployment.md
+++ b/tutorials/huggingface-tutorial/08-production-deployment.md
@@ -1229,7 +1229,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Fine-tuning Models](07-fine-tuning.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/huggingface-tutorial/index.md b/tutorials/huggingface-tutorial/README.md
similarity index 100%
rename from tutorials/huggingface-tutorial/index.md
rename to tutorials/huggingface-tutorial/README.md
diff --git a/tutorials/humanlayer-tutorial/01-getting-started.md b/tutorials/humanlayer-tutorial/01-getting-started.md
index 0cef2602..7100cd41 100644
--- a/tutorials/humanlayer-tutorial/01-getting-started.md
+++ b/tutorials/humanlayer-tutorial/01-getting-started.md
@@ -633,7 +633,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Architecture and Monorepo Layout](02-architecture-and-monorepo-layout.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/humanlayer-tutorial/02-architecture-and-monorepo-layout.md b/tutorials/humanlayer-tutorial/02-architecture-and-monorepo-layout.md
index 39b513aa..4f59fbbe 100644
--- a/tutorials/humanlayer-tutorial/02-architecture-and-monorepo-layout.md
+++ b/tutorials/humanlayer-tutorial/02-architecture-and-monorepo-layout.md
@@ -625,7 +625,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started](01-getting-started.md)
 - [Next Chapter: Chapter 3: Context Engineering Workflows](03-context-engineering-workflows.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/humanlayer-tutorial/03-context-engineering-workflows.md b/tutorials/humanlayer-tutorial/03-context-engineering-workflows.md
index 79655df9..08eec071 100644
--- a/tutorials/humanlayer-tutorial/03-context-engineering-workflows.md
+++ b/tutorials/humanlayer-tutorial/03-context-engineering-workflows.md
@@ -634,7 +634,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Architecture and Monorepo Layout](02-architecture-and-monorepo-layout.md)
 - [Next Chapter: Chapter 4: Parallel Agent Orchestration](04-parallel-agent-orchestration.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/humanlayer-tutorial/04-parallel-agent-orchestration.md b/tutorials/humanlayer-tutorial/04-parallel-agent-orchestration.md
index 62536c19..9557dcf7 100644
--- a/tutorials/humanlayer-tutorial/04-parallel-agent-orchestration.md
+++ b/tutorials/humanlayer-tutorial/04-parallel-agent-orchestration.md
@@ -625,7 +625,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Context Engineering Workflows](03-context-engineering-workflows.md)
 - [Next Chapter: Chapter 5: Human Approval and High-Stakes Actions](05-human-approval-and-high-stakes-actions.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/humanlayer-tutorial/05-human-approval-and-high-stakes-actions.md b/tutorials/humanlayer-tutorial/05-human-approval-and-high-stakes-actions.md
index 6438ac1c..f9795149 100644
--- a/tutorials/humanlayer-tutorial/05-human-approval-and-high-stakes-actions.md
+++ b/tutorials/humanlayer-tutorial/05-human-approval-and-high-stakes-actions.md
@@ -634,7 +634,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Parallel Agent Orchestration](04-parallel-agent-orchestration.md)
 - [Next Chapter: Chapter 6: IDE and CLI Integration Patterns](06-ide-and-cli-integration-patterns.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/humanlayer-tutorial/06-ide-and-cli-integration-patterns.md b/tutorials/humanlayer-tutorial/06-ide-and-cli-integration-patterns.md
index 003297b5..cb702641 100644
--- a/tutorials/humanlayer-tutorial/06-ide-and-cli-integration-patterns.md
+++ b/tutorials/humanlayer-tutorial/06-ide-and-cli-integration-patterns.md
@@ -634,7 +634,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Human Approval and High-Stakes Actions](05-human-approval-and-high-stakes-actions.md)
 - [Next Chapter: Chapter 7: Telemetry, Cost, and Team Governance](07-telemetry-cost-and-team-governance.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/humanlayer-tutorial/07-telemetry-cost-and-team-governance.md b/tutorials/humanlayer-tutorial/07-telemetry-cost-and-team-governance.md
index f4fb6e68..7d006498 100644
--- a/tutorials/humanlayer-tutorial/07-telemetry-cost-and-team-governance.md
+++ b/tutorials/humanlayer-tutorial/07-telemetry-cost-and-team-governance.md
@@ -625,7 +625,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: IDE and CLI Integration Patterns](06-ide-and-cli-integration-patterns.md)
 - [Next Chapter: Chapter 8: Production Rollout and Adoption](08-production-rollout-and-adoption.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/humanlayer-tutorial/08-production-rollout-and-adoption.md b/tutorials/humanlayer-tutorial/08-production-rollout-and-adoption.md
index 74f5e13c..fd0fcb33 100644
--- a/tutorials/humanlayer-tutorial/08-production-rollout-and-adoption.md
+++ b/tutorials/humanlayer-tutorial/08-production-rollout-and-adoption.md
@@ -627,7 +627,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Telemetry, Cost, and Team Governance](07-telemetry-cost-and-team-governance.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/humanlayer-tutorial/index.md b/tutorials/humanlayer-tutorial/README.md
similarity index 100%
rename from tutorials/humanlayer-tutorial/index.md
rename to tutorials/humanlayer-tutorial/README.md
diff --git a/tutorials/instructor-tutorial/01-getting-started.md b/tutorials/instructor-tutorial/01-getting-started.md
index 436c5170..8336797e 100644
--- a/tutorials/instructor-tutorial/01-getting-started.md
+++ b/tutorials/instructor-tutorial/01-getting-started.md
@@ -731,7 +731,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Crafting Effective Pydantic Models](02-pydantic-models.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/instructor-tutorial/02-pydantic-models.md b/tutorials/instructor-tutorial/02-pydantic-models.md
index c7a1de1d..f1974448 100644
--- a/tutorials/instructor-tutorial/02-pydantic-models.md
+++ b/tutorials/instructor-tutorial/02-pydantic-models.md
@@ -936,7 +936,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started with Instructor](01-getting-started.md)
 - [Next Chapter: Chapter 3: Validation, Errors, and Retries](03-validation.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/instructor-tutorial/03-validation.md b/tutorials/instructor-tutorial/03-validation.md
index a8b8396a..7a965729 100644
--- a/tutorials/instructor-tutorial/03-validation.md
+++ b/tutorials/instructor-tutorial/03-validation.md
@@ -852,7 +852,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Crafting Effective Pydantic Models](02-pydantic-models.md)
 - [Next Chapter: Chapter 4: Complex Structures and Nested Data](04-complex.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/instructor-tutorial/04-complex.md b/tutorials/instructor-tutorial/04-complex.md
index 961444d6..cf706a1e 100644
--- a/tutorials/instructor-tutorial/04-complex.md
+++ b/tutorials/instructor-tutorial/04-complex.md
@@ -747,7 +747,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Validation, Errors, and Retries](03-validation.md)
 - [Next Chapter: Chapter 5: Streaming Structured Outputs](05-streaming.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/instructor-tutorial/05-streaming.md b/tutorials/instructor-tutorial/05-streaming.md
index dcd8b547..56f4b6ee 100644
--- a/tutorials/instructor-tutorial/05-streaming.md
+++ b/tutorials/instructor-tutorial/05-streaming.md
@@ -605,7 +605,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Complex Structures and Nested Data](04-complex.md)
 - [Next Chapter: Chapter 6: Using Multiple Providers](06-providers.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/instructor-tutorial/06-providers.md b/tutorials/instructor-tutorial/06-providers.md
index 886a2ea5..769a9c97 100644
--- a/tutorials/instructor-tutorial/06-providers.md
+++ b/tutorials/instructor-tutorial/06-providers.md
@@ -834,7 +834,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Streaming Structured Outputs](05-streaming.md)
 - [Next Chapter: Chapter 7: Advanced Patterns and Guardrails](07-advanced.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/instructor-tutorial/07-advanced.md b/tutorials/instructor-tutorial/07-advanced.md
index 1dd1ecaa..215c8b7b 100644
--- a/tutorials/instructor-tutorial/07-advanced.md
+++ b/tutorials/instructor-tutorial/07-advanced.md
@@ -928,7 +928,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Using Multiple Providers](06-providers.md)
 - [Next Chapter: Chapter 8: Production Use and Operations](08-production.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/instructor-tutorial/08-production.md b/tutorials/instructor-tutorial/08-production.md
index 35944cfd..bb116e82 100644
--- a/tutorials/instructor-tutorial/08-production.md
+++ b/tutorials/instructor-tutorial/08-production.md
@@ -1033,7 +1033,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Advanced Patterns and Guardrails](07-advanced.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/instructor-tutorial/index.md b/tutorials/instructor-tutorial/README.md
similarity index 100%
rename from tutorials/instructor-tutorial/index.md
rename to tutorials/instructor-tutorial/README.md
diff --git a/tutorials/khoj-tutorial/01-getting-started.md b/tutorials/khoj-tutorial/01-getting-started.md
index 800a0ac3..ff13d3a8 100644
--- a/tutorials/khoj-tutorial/01-getting-started.md
+++ b/tutorials/khoj-tutorial/01-getting-started.md
@@ -746,7 +746,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Architecture Overview](02-architecture-overview.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/khoj-tutorial/02-architecture-overview.md b/tutorials/khoj-tutorial/02-architecture-overview.md
index e0da9372..acc91003 100644
--- a/tutorials/khoj-tutorial/02-architecture-overview.md
+++ b/tutorials/khoj-tutorial/02-architecture-overview.md
@@ -994,7 +994,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started](01-getting-started.md)
 - [Next Chapter: Chapter 3: Data Connectors](03-data-connectors.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/khoj-tutorial/03-data-connectors.md b/tutorials/khoj-tutorial/03-data-connectors.md
index 5fc52ddc..c2a81968 100644
--- a/tutorials/khoj-tutorial/03-data-connectors.md
+++ b/tutorials/khoj-tutorial/03-data-connectors.md
@@ -1117,7 +1117,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Architecture Overview](02-architecture-overview.md)
 - [Next Chapter: Chapter 4: Search & Retrieval](04-search-and-retrieval.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/khoj-tutorial/04-search-and-retrieval.md b/tutorials/khoj-tutorial/04-search-and-retrieval.md
index dd6c4a42..a5ee28e2 100644
--- a/tutorials/khoj-tutorial/04-search-and-retrieval.md
+++ b/tutorials/khoj-tutorial/04-search-and-retrieval.md
@@ -1008,7 +1008,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Data Connectors](03-data-connectors.md)
 - [Next Chapter: Chapter 5: Chat Interface](05-chat-interface.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/khoj-tutorial/05-chat-interface.md b/tutorials/khoj-tutorial/05-chat-interface.md
index 8f580e00..d0e37cd8 100644
--- a/tutorials/khoj-tutorial/05-chat-interface.md
+++ b/tutorials/khoj-tutorial/05-chat-interface.md
@@ -1114,7 +1114,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Search & Retrieval](04-search-and-retrieval.md)
 - [Next Chapter: Chapter 6: Automation & Agents](06-automation-and-agents.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/khoj-tutorial/06-automation-and-agents.md b/tutorials/khoj-tutorial/06-automation-and-agents.md
index 70547511..46cf83c6 100644
--- a/tutorials/khoj-tutorial/06-automation-and-agents.md
+++ b/tutorials/khoj-tutorial/06-automation-and-agents.md
@@ -981,7 +981,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Chat Interface](05-chat-interface.md)
 - [Next Chapter: Chapter 7: Customization & Plugins](07-customization-and-plugins.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/khoj-tutorial/07-customization-and-plugins.md b/tutorials/khoj-tutorial/07-customization-and-plugins.md
index 12068afa..5dee77de 100644
--- a/tutorials/khoj-tutorial/07-customization-and-plugins.md
+++ b/tutorials/khoj-tutorial/07-customization-and-plugins.md
@@ -1087,7 +1087,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Automation & Agents](06-automation-and-agents.md)
 - [Next Chapter: Chapter 8: Production Deployment](08-production-deployment.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/khoj-tutorial/08-production-deployment.md b/tutorials/khoj-tutorial/08-production-deployment.md
index a64b3544..760f87dd 100644
--- a/tutorials/khoj-tutorial/08-production-deployment.md
+++ b/tutorials/khoj-tutorial/08-production-deployment.md
@@ -1256,7 +1256,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Customization & Plugins](07-customization-and-plugins.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/khoj-tutorial/index.md b/tutorials/khoj-tutorial/README.md
similarity index 100%
rename from tutorials/khoj-tutorial/index.md
rename to tutorials/khoj-tutorial/README.md
diff --git a/tutorials/kilocode-tutorial/01-getting-started.md b/tutorials/kilocode-tutorial/01-getting-started.md
index ac1f9b6f..eb38213c 100644
--- a/tutorials/kilocode-tutorial/01-getting-started.md
+++ b/tutorials/kilocode-tutorial/01-getting-started.md
@@ -634,7 +634,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Agent Loop and State Model](02-agent-loop-and-state-model.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/kilocode-tutorial/02-agent-loop-and-state-model.md b/tutorials/kilocode-tutorial/02-agent-loop-and-state-model.md
index f01e8c48..e4da3925 100644
--- a/tutorials/kilocode-tutorial/02-agent-loop-and-state-model.md
+++ b/tutorials/kilocode-tutorial/02-agent-loop-and-state-model.md
@@ -636,7 +636,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started](01-getting-started.md)
 - [Next Chapter: Chapter 3: Modes, Prompts, and Approval Workflow](03-modes-prompts-and-approval-workflow.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/kilocode-tutorial/03-modes-prompts-and-approval-workflow.md b/tutorials/kilocode-tutorial/03-modes-prompts-and-approval-workflow.md
index 4ade1720..9105c0f8 100644
--- a/tutorials/kilocode-tutorial/03-modes-prompts-and-approval-workflow.md
+++ b/tutorials/kilocode-tutorial/03-modes-prompts-and-approval-workflow.md
@@ -630,7 +630,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Agent Loop and State Model](02-agent-loop-and-state-model.md)
 - [Next Chapter: Chapter 4: Authentication and Provider Routing](04-authentication-and-provider-routing.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/kilocode-tutorial/04-authentication-and-provider-routing.md b/tutorials/kilocode-tutorial/04-authentication-and-provider-routing.md
index 39616856..3475cd97 100644
--- a/tutorials/kilocode-tutorial/04-authentication-and-provider-routing.md
+++ b/tutorials/kilocode-tutorial/04-authentication-and-provider-routing.md
@@ -630,7 +630,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Modes, Prompts, and Approval Workflow](03-modes-prompts-and-approval-workflow.md)
 - [Next Chapter: Chapter 5: Session, History, and Context Persistence](05-session-history-and-context-persistence.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/kilocode-tutorial/05-session-history-and-context-persistence.md b/tutorials/kilocode-tutorial/05-session-history-and-context-persistence.md
index fd89f97b..dc39f0b5 100644
--- a/tutorials/kilocode-tutorial/05-session-history-and-context-persistence.md
+++ b/tutorials/kilocode-tutorial/05-session-history-and-context-persistence.md
@@ -632,7 +632,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Authentication and Provider Routing](04-authentication-and-provider-routing.md)
 - [Next Chapter: Chapter 6: Extensions, MCP, and Custom Modes](06-extensions-mcp-and-custom-modes.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/kilocode-tutorial/06-extensions-mcp-and-custom-modes.md b/tutorials/kilocode-tutorial/06-extensions-mcp-and-custom-modes.md
index 38eaa905..53d75d89 100644
--- a/tutorials/kilocode-tutorial/06-extensions-mcp-and-custom-modes.md
+++ b/tutorials/kilocode-tutorial/06-extensions-mcp-and-custom-modes.md
@@ -630,7 +630,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Session, History, and Context Persistence](05-session-history-and-context-persistence.md)
 - [Next Chapter: Chapter 7: CLI/TUI Architecture for Contributors](07-cli-tui-architecture-for-contributors.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/kilocode-tutorial/07-cli-tui-architecture-for-contributors.md b/tutorials/kilocode-tutorial/07-cli-tui-architecture-for-contributors.md
index abf25d60..ec71d39e 100644
--- a/tutorials/kilocode-tutorial/07-cli-tui-architecture-for-contributors.md
+++ b/tutorials/kilocode-tutorial/07-cli-tui-architecture-for-contributors.md
@@ -633,7 +633,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Extensions, MCP, and Custom Modes](06-extensions-mcp-and-custom-modes.md)
 - [Next Chapter: Chapter 8: Production Operations and Governance](08-production-operations-and-governance.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/kilocode-tutorial/08-production-operations-and-governance.md b/tutorials/kilocode-tutorial/08-production-operations-and-governance.md
index 434d9625..c6f09848 100644
--- a/tutorials/kilocode-tutorial/08-production-operations-and-governance.md
+++ b/tutorials/kilocode-tutorial/08-production-operations-and-governance.md
@@ -630,7 +630,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: CLI/TUI Architecture for Contributors](07-cli-tui-architecture-for-contributors.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/kilocode-tutorial/index.md b/tutorials/kilocode-tutorial/README.md
similarity index 100%
rename from tutorials/kilocode-tutorial/index.md
rename to tutorials/kilocode-tutorial/README.md
diff --git a/tutorials/kimi-cli-tutorial/01-getting-started.md b/tutorials/kimi-cli-tutorial/01-getting-started.md
index af1fafd5..431c43c2 100644
--- a/tutorials/kimi-cli-tutorial/01-getting-started.md
+++ b/tutorials/kimi-cli-tutorial/01-getting-started.md
@@ -640,7 +640,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Command Surface and Session Controls](02-command-surface-and-session-controls.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/kimi-cli-tutorial/02-command-surface-and-session-controls.md b/tutorials/kimi-cli-tutorial/02-command-surface-and-session-controls.md
index c663799b..0e8a0e5c 100644
--- a/tutorials/kimi-cli-tutorial/02-command-surface-and-session-controls.md
+++ b/tutorials/kimi-cli-tutorial/02-command-surface-and-session-controls.md
@@ -629,7 +629,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started](01-getting-started.md)
 - [Next Chapter: Chapter 3: Agents, Subagents, and Skills](03-agents-subagents-and-skills.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/kimi-cli-tutorial/03-agents-subagents-and-skills.md b/tutorials/kimi-cli-tutorial/03-agents-subagents-and-skills.md
index 75039b9b..bd8999f4 100644
--- a/tutorials/kimi-cli-tutorial/03-agents-subagents-and-skills.md
+++ b/tutorials/kimi-cli-tutorial/03-agents-subagents-and-skills.md
@@ -626,7 +626,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Command Surface and Session Controls](02-command-surface-and-session-controls.md)
 - [Next Chapter: Chapter 4: MCP Tooling and Security Model](04-mcp-tooling-and-security-model.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/kimi-cli-tutorial/04-mcp-tooling-and-security-model.md b/tutorials/kimi-cli-tutorial/04-mcp-tooling-and-security-model.md
index 3b10f9ed..a77ac947 100644
--- a/tutorials/kimi-cli-tutorial/04-mcp-tooling-and-security-model.md
+++ b/tutorials/kimi-cli-tutorial/04-mcp-tooling-and-security-model.md
@@ -631,7 +631,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Agents, Subagents, and Skills](03-agents-subagents-and-skills.md)
 - [Next Chapter: Chapter 5: ACP and IDE Integrations](05-acp-and-ide-integrations.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/kimi-cli-tutorial/05-acp-and-ide-integrations.md b/tutorials/kimi-cli-tutorial/05-acp-and-ide-integrations.md
index b7d37f43..6dca83b2 100644
--- a/tutorials/kimi-cli-tutorial/05-acp-and-ide-integrations.md
+++ b/tutorials/kimi-cli-tutorial/05-acp-and-ide-integrations.md
@@ -634,7 +634,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: MCP Tooling and Security Model](04-mcp-tooling-and-security-model.md)
 - [Next Chapter: Chapter 6: Shell Mode, Print Mode, and Wire Mode](06-shell-mode-print-mode-and-wire-mode.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/kimi-cli-tutorial/06-shell-mode-print-mode-and-wire-mode.md b/tutorials/kimi-cli-tutorial/06-shell-mode-print-mode-and-wire-mode.md
index af8fa7d6..c323f5a5 100644
--- a/tutorials/kimi-cli-tutorial/06-shell-mode-print-mode-and-wire-mode.md
+++ b/tutorials/kimi-cli-tutorial/06-shell-mode-print-mode-and-wire-mode.md
@@ -630,7 +630,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: ACP and IDE Integrations](05-acp-and-ide-integrations.md)
 - [Next Chapter: Chapter 7: Loop Control, Retries, and Long Tasks](07-loop-control-retries-and-long-tasks.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/kimi-cli-tutorial/07-loop-control-retries-and-long-tasks.md b/tutorials/kimi-cli-tutorial/07-loop-control-retries-and-long-tasks.md
index 291f5821..4f965c54 100644
--- a/tutorials/kimi-cli-tutorial/07-loop-control-retries-and-long-tasks.md
+++ b/tutorials/kimi-cli-tutorial/07-loop-control-retries-and-long-tasks.md
@@ -626,7 +626,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Shell Mode, Print Mode, and Wire Mode](06-shell-mode-print-mode-and-wire-mode.md)
 - [Next Chapter: Chapter 8: Production Operations and Governance](08-production-operations-and-governance.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/kimi-cli-tutorial/08-production-operations-and-governance.md b/tutorials/kimi-cli-tutorial/08-production-operations-and-governance.md
index af77ac77..80a103b6 100644
--- a/tutorials/kimi-cli-tutorial/08-production-operations-and-governance.md
+++ b/tutorials/kimi-cli-tutorial/08-production-operations-and-governance.md
@@ -637,7 +637,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Loop Control, Retries, and Long Tasks](07-loop-control-retries-and-long-tasks.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/kimi-cli-tutorial/index.md b/tutorials/kimi-cli-tutorial/README.md
similarity index 100%
rename from tutorials/kimi-cli-tutorial/index.md
rename to tutorials/kimi-cli-tutorial/README.md
diff --git a/tutorials/kiro-tutorial/01-getting-started.md b/tutorials/kiro-tutorial/01-getting-started.md
index 9870df67..bb9a4dd6 100644
--- a/tutorials/kiro-tutorial/01-getting-started.md
+++ b/tutorials/kiro-tutorial/01-getting-started.md
@@ -310,7 +310,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Spec-Driven Development Workflow](02-spec-driven-development-workflow.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/kiro-tutorial/02-spec-driven-development-workflow.md b/tutorials/kiro-tutorial/02-spec-driven-development-workflow.md
index 2cc5744e..88329f45 100644
--- a/tutorials/kiro-tutorial/02-spec-driven-development-workflow.md
+++ b/tutorials/kiro-tutorial/02-spec-driven-development-workflow.md
@@ -383,7 +383,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started](01-getting-started.md)
 - [Next Chapter: Chapter 3: Agent Steering and Rules Configuration](03-agent-steering-and-rules-configuration.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/kiro-tutorial/03-agent-steering-and-rules-configuration.md b/tutorials/kiro-tutorial/03-agent-steering-and-rules-configuration.md
index 85b6d409..6e4a9e56 100644
--- a/tutorials/kiro-tutorial/03-agent-steering-and-rules-configuration.md
+++ b/tutorials/kiro-tutorial/03-agent-steering-and-rules-configuration.md
@@ -380,7 +380,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Spec-Driven Development Workflow](02-spec-driven-development-workflow.md)
 - [Next Chapter: Chapter 4: Autonomous Agent Mode](04-autonomous-agent-mode.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/kiro-tutorial/04-autonomous-agent-mode.md b/tutorials/kiro-tutorial/04-autonomous-agent-mode.md
index d7a8d902..b3b38e7d 100644
--- a/tutorials/kiro-tutorial/04-autonomous-agent-mode.md
+++ b/tutorials/kiro-tutorial/04-autonomous-agent-mode.md
@@ -381,7 +381,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Agent Steering and Rules Configuration](03-agent-steering-and-rules-configuration.md)
 - [Next Chapter: Chapter 5: MCP Integration and External Tools](05-mcp-integration-and-external-tools.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/kiro-tutorial/05-mcp-integration-and-external-tools.md b/tutorials/kiro-tutorial/05-mcp-integration-and-external-tools.md
index 7cda6a71..f5dc5936 100644
--- a/tutorials/kiro-tutorial/05-mcp-integration-and-external-tools.md
+++ b/tutorials/kiro-tutorial/05-mcp-integration-and-external-tools.md
@@ -426,7 +426,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Autonomous Agent Mode](04-autonomous-agent-mode.md)
 - [Next Chapter: Chapter 6: Hooks and Automation](06-hooks-and-automation.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/kiro-tutorial/06-hooks-and-automation.md b/tutorials/kiro-tutorial/06-hooks-and-automation.md
index 34186932..4497954c 100644
--- a/tutorials/kiro-tutorial/06-hooks-and-automation.md
+++ b/tutorials/kiro-tutorial/06-hooks-and-automation.md
@@ -414,7 +414,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: MCP Integration and External Tools](05-mcp-integration-and-external-tools.md)
 - [Next Chapter: Chapter 7: Multi-Model Strategy and Providers](07-multi-model-strategy-and-providers.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/kiro-tutorial/07-multi-model-strategy-and-providers.md b/tutorials/kiro-tutorial/07-multi-model-strategy-and-providers.md
index a83669ab..0be964f4 100644
--- a/tutorials/kiro-tutorial/07-multi-model-strategy-and-providers.md
+++ b/tutorials/kiro-tutorial/07-multi-model-strategy-and-providers.md
@@ -383,7 +383,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Hooks and Automation](06-hooks-and-automation.md)
 - [Next Chapter: Chapter 8: Team Operations and Governance](08-team-operations-and-governance.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/kiro-tutorial/08-team-operations-and-governance.md b/tutorials/kiro-tutorial/08-team-operations-and-governance.md
index a6fa4e65..60defd32 100644
--- a/tutorials/kiro-tutorial/08-team-operations-and-governance.md
+++ b/tutorials/kiro-tutorial/08-team-operations-and-governance.md
@@ -217,7 +217,7 @@ You now have the operational playbook for team-scale Kiro deployment: governance
 
 ---
 
-**You have completed the Kiro Tutorial.** Return to the [Tutorial Index](index.md) to explore related tutorials.
+**You have completed the Kiro Tutorial.** Return to the [Tutorial Index](README.md) to explore related tutorials.
 
 ## Depth Expansion Playbook
 
@@ -424,9 +424,9 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Multi-Model Strategy and Providers](07-multi-model-strategy-and-providers.md)
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
 
diff --git a/tutorials/kiro-tutorial/index.md b/tutorials/kiro-tutorial/README.md
similarity index 100%
rename from tutorials/kiro-tutorial/index.md
rename to tutorials/kiro-tutorial/README.md
diff --git a/tutorials/kubernetes-operator-patterns/01-getting-started.md b/tutorials/kubernetes-operator-patterns/01-getting-started.md
index b675f48e..9c9a7550 100644
--- a/tutorials/kubernetes-operator-patterns/01-getting-started.md
+++ b/tutorials/kubernetes-operator-patterns/01-getting-started.md
@@ -661,7 +661,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Custom Resource Definitions - Designing Robust APIs](02-custom-resources.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/kubernetes-operator-patterns/02-custom-resources.md b/tutorials/kubernetes-operator-patterns/02-custom-resources.md
index 87b4078f..d0ac69ce 100644
--- a/tutorials/kubernetes-operator-patterns/02-custom-resources.md
+++ b/tutorials/kubernetes-operator-patterns/02-custom-resources.md
@@ -810,7 +810,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started with Kubernetes Operators](01-getting-started.md)
 - [Next Chapter: Chapter 3: The Reconciliation Loop - Core Operator Logic](03-reconciliation-loop.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/kubernetes-operator-patterns/03-reconciliation-loop.md b/tutorials/kubernetes-operator-patterns/03-reconciliation-loop.md
index dab3f4df..86a2e52e 100644
--- a/tutorials/kubernetes-operator-patterns/03-reconciliation-loop.md
+++ b/tutorials/kubernetes-operator-patterns/03-reconciliation-loop.md
@@ -803,7 +803,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Custom Resource Definitions - Designing Robust APIs](02-custom-resources.md)
 - [Next Chapter: Chapter 4: Managing Owned Resources - Creating and Managing Kubernetes Objects](04-owned-resources.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/kubernetes-operator-patterns/04-owned-resources.md b/tutorials/kubernetes-operator-patterns/04-owned-resources.md
index 4301282b..605e55c2 100644
--- a/tutorials/kubernetes-operator-patterns/04-owned-resources.md
+++ b/tutorials/kubernetes-operator-patterns/04-owned-resources.md
@@ -822,7 +822,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: The Reconciliation Loop - Core Operator Logic](03-reconciliation-loop.md)
 - [Next Chapter: Chapter 5: Status and Conditions - Reporting Resource Status and Implementing Condition Patterns](05-status-conditions.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/kubernetes-operator-patterns/05-status-conditions.md b/tutorials/kubernetes-operator-patterns/05-status-conditions.md
index a50fd8ff..b129f0fd 100644
--- a/tutorials/kubernetes-operator-patterns/05-status-conditions.md
+++ b/tutorials/kubernetes-operator-patterns/05-status-conditions.md
@@ -808,7 +808,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Managing Owned Resources - Creating and Managing Kubernetes Objects](04-owned-resources.md)
 - [Next Chapter: Chapter 6: Testing Operators - Unit Tests, Integration Tests, and envtest Framework](06-testing.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/kubernetes-operator-patterns/06-testing.md b/tutorials/kubernetes-operator-patterns/06-testing.md
index 5c249fb6..65493105 100644
--- a/tutorials/kubernetes-operator-patterns/06-testing.md
+++ b/tutorials/kubernetes-operator-patterns/06-testing.md
@@ -1160,7 +1160,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Status and Conditions - Reporting Resource Status and Implementing Condition Patterns](05-status-conditions.md)
 - [Next Chapter: Chapter 7: Observability & Debugging - Metrics, Logging, Tracing, and Troubleshooting](07-observability.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/kubernetes-operator-patterns/07-observability.md b/tutorials/kubernetes-operator-patterns/07-observability.md
index f3bf953b..51811f6c 100644
--- a/tutorials/kubernetes-operator-patterns/07-observability.md
+++ b/tutorials/kubernetes-operator-patterns/07-observability.md
@@ -990,7 +990,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Testing Operators - Unit Tests, Integration Tests, and envtest Framework](06-testing.md)
 - [Next Chapter: Chapter 8: Production Deployment - OLM, Helm Charts, Security, and Scaling](08-production-deployment.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/kubernetes-operator-patterns/08-production-deployment.md b/tutorials/kubernetes-operator-patterns/08-production-deployment.md
index 145b1e8f..c876b29b 100644
--- a/tutorials/kubernetes-operator-patterns/08-production-deployment.md
+++ b/tutorials/kubernetes-operator-patterns/08-production-deployment.md
@@ -1027,7 +1027,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Observability & Debugging - Metrics, Logging, Tracing, and Troubleshooting](07-observability.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/kubernetes-operator-patterns/index.md b/tutorials/kubernetes-operator-patterns/README.md
similarity index 100%
rename from tutorials/kubernetes-operator-patterns/index.md
rename to tutorials/kubernetes-operator-patterns/README.md
diff --git a/tutorials/lancedb-tutorial/01-getting-started.md b/tutorials/lancedb-tutorial/01-getting-started.md
index 7ba21523..8b335cf9 100644
--- a/tutorials/lancedb-tutorial/01-getting-started.md
+++ b/tutorials/lancedb-tutorial/01-getting-started.md
@@ -681,7 +681,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Data Modeling](02-data-modeling.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/lancedb-tutorial/02-data-modeling.md b/tutorials/lancedb-tutorial/02-data-modeling.md
index a54df060..d7acc2f3 100644
--- a/tutorials/lancedb-tutorial/02-data-modeling.md
+++ b/tutorials/lancedb-tutorial/02-data-modeling.md
@@ -650,7 +650,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started with LanceDB](01-getting-started.md)
 - [Next Chapter: Chapter 3: Vector Operations](03-vector-operations.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/lancedb-tutorial/03-vector-operations.md b/tutorials/lancedb-tutorial/03-vector-operations.md
index 5c2e46a5..eb4280dd 100644
--- a/tutorials/lancedb-tutorial/03-vector-operations.md
+++ b/tutorials/lancedb-tutorial/03-vector-operations.md
@@ -575,7 +575,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Data Modeling](02-data-modeling.md)
 - [Next Chapter: Chapter 4: Hybrid Search](04-hybrid-search.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/lancedb-tutorial/04-hybrid-search.md b/tutorials/lancedb-tutorial/04-hybrid-search.md
index 411f8017..9ce18760 100644
--- a/tutorials/lancedb-tutorial/04-hybrid-search.md
+++ b/tutorials/lancedb-tutorial/04-hybrid-search.md
@@ -599,7 +599,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Vector Operations](03-vector-operations.md)
 - [Next Chapter: Chapter 5: Integrations](05-integrations.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/lancedb-tutorial/05-integrations.md b/tutorials/lancedb-tutorial/05-integrations.md
index 04fdaae2..ac13c63d 100644
--- a/tutorials/lancedb-tutorial/05-integrations.md
+++ b/tutorials/lancedb-tutorial/05-integrations.md
@@ -606,7 +606,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Hybrid Search](04-hybrid-search.md)
 - [Next Chapter: Chapter 6: Performance](06-performance.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/lancedb-tutorial/06-performance.md b/tutorials/lancedb-tutorial/06-performance.md
index 08d30cf6..8b2aa35f 100644
--- a/tutorials/lancedb-tutorial/06-performance.md
+++ b/tutorials/lancedb-tutorial/06-performance.md
@@ -663,7 +663,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Integrations](05-integrations.md)
 - [Next Chapter: Chapter 7: Production Deployment](07-production.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/lancedb-tutorial/07-production.md b/tutorials/lancedb-tutorial/07-production.md
index 0aa2c9c0..11622e69 100644
--- a/tutorials/lancedb-tutorial/07-production.md
+++ b/tutorials/lancedb-tutorial/07-production.md
@@ -657,7 +657,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Performance](06-performance.md)
 - [Next Chapter: Chapter 8: Advanced Patterns](08-advanced-patterns.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/lancedb-tutorial/08-advanced-patterns.md b/tutorials/lancedb-tutorial/08-advanced-patterns.md
index 3c76bc0a..3724bb57 100644
--- a/tutorials/lancedb-tutorial/08-advanced-patterns.md
+++ b/tutorials/lancedb-tutorial/08-advanced-patterns.md
@@ -719,7 +719,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Production Deployment](07-production.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/lancedb-tutorial/index.md b/tutorials/lancedb-tutorial/README.md
similarity index 100%
rename from tutorials/lancedb-tutorial/index.md
rename to tutorials/lancedb-tutorial/README.md
diff --git a/tutorials/langchain-architecture-guide/01-getting-started.md b/tutorials/langchain-architecture-guide/01-getting-started.md
index 4fe5aebe..80155acb 100644
--- a/tutorials/langchain-architecture-guide/01-getting-started.md
+++ b/tutorials/langchain-architecture-guide/01-getting-started.md
@@ -440,7 +440,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: The Runnable Interface (LCEL)](02-runnable-interface.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/langchain-architecture-guide/02-runnable-interface.md b/tutorials/langchain-architecture-guide/02-runnable-interface.md
index daaa186b..6a36c678 100644
--- a/tutorials/langchain-architecture-guide/02-runnable-interface.md
+++ b/tutorials/langchain-architecture-guide/02-runnable-interface.md
@@ -501,7 +501,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started -- Ecosystem Overview](01-getting-started.md)
 - [Next Chapter: Chapter 3: Chat Model Architecture](03-chat-model-architecture.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/langchain-architecture-guide/03-chat-model-architecture.md b/tutorials/langchain-architecture-guide/03-chat-model-architecture.md
index 5dd402e5..2fe7c94a 100644
--- a/tutorials/langchain-architecture-guide/03-chat-model-architecture.md
+++ b/tutorials/langchain-architecture-guide/03-chat-model-architecture.md
@@ -583,7 +583,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: The Runnable Interface (LCEL)](02-runnable-interface.md)
 - [Next Chapter: Chapter 4: Chain Composition](04-chain-composition.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/langchain-architecture-guide/04-chain-composition.md b/tutorials/langchain-architecture-guide/04-chain-composition.md
index 30eb195c..16e1b721 100644
--- a/tutorials/langchain-architecture-guide/04-chain-composition.md
+++ b/tutorials/langchain-architecture-guide/04-chain-composition.md
@@ -583,7 +583,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Chat Model Architecture](03-chat-model-architecture.md)
 - [Next Chapter: Chapter 5: Document Loading & Splitting](05-document-loading-splitting.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/langchain-architecture-guide/05-document-loading-splitting.md b/tutorials/langchain-architecture-guide/05-document-loading-splitting.md
index 77fc8e7c..95ee599e 100644
--- a/tutorials/langchain-architecture-guide/05-document-loading-splitting.md
+++ b/tutorials/langchain-architecture-guide/05-document-loading-splitting.md
@@ -631,7 +631,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Chain Composition](04-chain-composition.md)
 - [Next Chapter: Chapter 6: Vector Store Abstraction](06-vector-store-abstraction.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/langchain-architecture-guide/06-vector-store-abstraction.md b/tutorials/langchain-architecture-guide/06-vector-store-abstraction.md
index c30dcfe2..2646bdc2 100644
--- a/tutorials/langchain-architecture-guide/06-vector-store-abstraction.md
+++ b/tutorials/langchain-architecture-guide/06-vector-store-abstraction.md
@@ -620,7 +620,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Document Loading & Splitting](05-document-loading-splitting.md)
 - [Next Chapter: Chapter 7: Agent Architecture](07-agent-architecture.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/langchain-architecture-guide/07-agent-architecture.md b/tutorials/langchain-architecture-guide/07-agent-architecture.md
index acef0dc0..bd48bcaf 100644
--- a/tutorials/langchain-architecture-guide/07-agent-architecture.md
+++ b/tutorials/langchain-architecture-guide/07-agent-architecture.md
@@ -637,7 +637,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Vector Store Abstraction](06-vector-store-abstraction.md)
 - [Next Chapter: Chapter 8: Production Patterns](08-production-patterns.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/langchain-architecture-guide/08-production-patterns.md b/tutorials/langchain-architecture-guide/08-production-patterns.md
index f68b4a14..6eb2bb69 100644
--- a/tutorials/langchain-architecture-guide/08-production-patterns.md
+++ b/tutorials/langchain-architecture-guide/08-production-patterns.md
@@ -672,7 +672,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Agent Architecture](07-agent-architecture.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/langchain-architecture-guide/index.md b/tutorials/langchain-architecture-guide/README.md
similarity index 100%
rename from tutorials/langchain-architecture-guide/index.md
rename to tutorials/langchain-architecture-guide/README.md
diff --git a/tutorials/langchain-tutorial/01-getting-started.md b/tutorials/langchain-tutorial/01-getting-started.md
index 306d6533..017459d1 100644
--- a/tutorials/langchain-tutorial/01-getting-started.md
+++ b/tutorials/langchain-tutorial/01-getting-started.md
@@ -211,7 +211,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Prompt Templates & Chains](02-prompt-templates.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/langchain-tutorial/02-prompt-templates.md b/tutorials/langchain-tutorial/02-prompt-templates.md
index 340ad3eb..958c9917 100644
--- a/tutorials/langchain-tutorial/02-prompt-templates.md
+++ b/tutorials/langchain-tutorial/02-prompt-templates.md
@@ -375,7 +375,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started with LangChain](01-getting-started.md)
 - [Next Chapter: Chapter 3: Memory Systems](03-memory-systems.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/langchain-tutorial/03-memory-systems.md b/tutorials/langchain-tutorial/03-memory-systems.md
index 6a17096b..c45ea047 100644
--- a/tutorials/langchain-tutorial/03-memory-systems.md
+++ b/tutorials/langchain-tutorial/03-memory-systems.md
@@ -411,7 +411,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Prompt Templates & Chains](02-prompt-templates.md)
 - [Next Chapter: Chapter 4: Document Loading & Processing](04-document-processing.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/langchain-tutorial/04-document-processing.md b/tutorials/langchain-tutorial/04-document-processing.md
index 0de30798..9efb250c 100644
--- a/tutorials/langchain-tutorial/04-document-processing.md
+++ b/tutorials/langchain-tutorial/04-document-processing.md
@@ -487,7 +487,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Memory Systems](03-memory-systems.md)
 - [Next Chapter: Chapter 5: Vector Stores & Retrieval](05-vector-stores.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/langchain-tutorial/05-vector-stores.md b/tutorials/langchain-tutorial/05-vector-stores.md
index 9cbf14f3..36d9cb27 100644
--- a/tutorials/langchain-tutorial/05-vector-stores.md
+++ b/tutorials/langchain-tutorial/05-vector-stores.md
@@ -523,7 +523,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Document Loading & Processing](04-document-processing.md)
 - [Next Chapter: Chapter 6: Agents & Tools](06-agents-tools.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/langchain-tutorial/06-agents-tools.md b/tutorials/langchain-tutorial/06-agents-tools.md
index 645fa08c..651ff972 100644
--- a/tutorials/langchain-tutorial/06-agents-tools.md
+++ b/tutorials/langchain-tutorial/06-agents-tools.md
@@ -750,7 +750,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Vector Stores & Retrieval](05-vector-stores.md)
 - [Next Chapter: Chapter 7: Advanced Chains](07-advanced-chains.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/langchain-tutorial/07-advanced-chains.md b/tutorials/langchain-tutorial/07-advanced-chains.md
index 31889626..dd15e1f8 100644
--- a/tutorials/langchain-tutorial/07-advanced-chains.md
+++ b/tutorials/langchain-tutorial/07-advanced-chains.md
@@ -820,7 +820,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Agents & Tools](06-agents-tools.md)
 - [Next Chapter: Chapter 8: Production Deployment](08-production-deployment.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/langchain-tutorial/08-production-deployment.md b/tutorials/langchain-tutorial/08-production-deployment.md
index 46b76af5..95da844b 100644
--- a/tutorials/langchain-tutorial/08-production-deployment.md
+++ b/tutorials/langchain-tutorial/08-production-deployment.md
@@ -968,7 +968,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Advanced Chains](07-advanced-chains.md)
 - [Next Chapter: Chapter 9: Evaluation, Monitoring, and Observability](09-evaluation-monitoring.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/langchain-tutorial/09-evaluation-monitoring.md b/tutorials/langchain-tutorial/09-evaluation-monitoring.md
index b964e888..04333151 100644
--- a/tutorials/langchain-tutorial/09-evaluation-monitoring.md
+++ b/tutorials/langchain-tutorial/09-evaluation-monitoring.md
@@ -789,7 +789,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 8: Production Deployment](08-production-deployment.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/langchain-tutorial/index.md b/tutorials/langchain-tutorial/README.md
similarity index 100%
rename from tutorials/langchain-tutorial/index.md
rename to tutorials/langchain-tutorial/README.md
diff --git a/tutorials/langflow-tutorial/01-getting-started.md b/tutorials/langflow-tutorial/01-getting-started.md
index 6c376cbd..be46c39a 100644
--- a/tutorials/langflow-tutorial/01-getting-started.md
+++ b/tutorials/langflow-tutorial/01-getting-started.md
@@ -636,7 +636,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Platform Architecture](02-platform-architecture.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/langflow-tutorial/02-platform-architecture.md b/tutorials/langflow-tutorial/02-platform-architecture.md
index 6a0d9791..db20d67f 100644
--- a/tutorials/langflow-tutorial/02-platform-architecture.md
+++ b/tutorials/langflow-tutorial/02-platform-architecture.md
@@ -632,7 +632,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started](01-getting-started.md)
 - [Next Chapter: Chapter 3: Visual Flow Builder](03-visual-flow-builder.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/langflow-tutorial/03-visual-flow-builder.md b/tutorials/langflow-tutorial/03-visual-flow-builder.md
index b11c0f37..c618a89a 100644
--- a/tutorials/langflow-tutorial/03-visual-flow-builder.md
+++ b/tutorials/langflow-tutorial/03-visual-flow-builder.md
@@ -635,7 +635,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Platform Architecture](02-platform-architecture.md)
 - [Next Chapter: Chapter 4: Agent Workflows and Orchestration](04-agent-workflows-and-orchestration.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/langflow-tutorial/04-agent-workflows-and-orchestration.md b/tutorials/langflow-tutorial/04-agent-workflows-and-orchestration.md
index 96931a12..768894c9 100644
--- a/tutorials/langflow-tutorial/04-agent-workflows-and-orchestration.md
+++ b/tutorials/langflow-tutorial/04-agent-workflows-and-orchestration.md
@@ -633,7 +633,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Visual Flow Builder](03-visual-flow-builder.md)
 - [Next Chapter: Chapter 5: API and MCP Deployment](05-api-and-mcp-deployment.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/langflow-tutorial/05-api-and-mcp-deployment.md b/tutorials/langflow-tutorial/05-api-and-mcp-deployment.md
index 965593b0..e1f53293 100644
--- a/tutorials/langflow-tutorial/05-api-and-mcp-deployment.md
+++ b/tutorials/langflow-tutorial/05-api-and-mcp-deployment.md
@@ -635,7 +635,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Agent Workflows and Orchestration](04-agent-workflows-and-orchestration.md)
 - [Next Chapter: Chapter 6: Observability and Security](06-observability-and-security.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/langflow-tutorial/06-observability-and-security.md b/tutorials/langflow-tutorial/06-observability-and-security.md
index 88d5ef95..80d046d0 100644
--- a/tutorials/langflow-tutorial/06-observability-and-security.md
+++ b/tutorials/langflow-tutorial/06-observability-and-security.md
@@ -625,7 +625,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: API and MCP Deployment](05-api-and-mcp-deployment.md)
 - [Next Chapter: Chapter 7: Custom Components and Extensions](07-custom-components-and-extensions.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/langflow-tutorial/07-custom-components-and-extensions.md b/tutorials/langflow-tutorial/07-custom-components-and-extensions.md
index 13de5e5c..9470f391 100644
--- a/tutorials/langflow-tutorial/07-custom-components-and-extensions.md
+++ b/tutorials/langflow-tutorial/07-custom-components-and-extensions.md
@@ -624,7 +624,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Observability and Security](06-observability-and-security.md)
 - [Next Chapter: Chapter 8: Production Operations](08-production-operations.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/langflow-tutorial/08-production-operations.md b/tutorials/langflow-tutorial/08-production-operations.md
index 90e26450..ec92695d 100644
--- a/tutorials/langflow-tutorial/08-production-operations.md
+++ b/tutorials/langflow-tutorial/08-production-operations.md
@@ -635,7 +635,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Custom Components and Extensions](07-custom-components-and-extensions.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/langflow-tutorial/index.md b/tutorials/langflow-tutorial/README.md
similarity index 100%
rename from tutorials/langflow-tutorial/index.md
rename to tutorials/langflow-tutorial/README.md
diff --git a/tutorials/langfuse-tutorial/01-getting-started.md b/tutorials/langfuse-tutorial/01-getting-started.md
index b4dc4da5..43dfd669 100644
--- a/tutorials/langfuse-tutorial/01-getting-started.md
+++ b/tutorials/langfuse-tutorial/01-getting-started.md
@@ -317,7 +317,7 @@ Under **Settings** you manage API keys, team members, project configuration, and
 
 ---
 
-| [Previous: Tutorial Overview](./index.md) | [Next: Chapter 2 -- Tracing Fundamentals](./02-tracing.md) |
+| [Previous: Tutorial Overview](./README.md) | [Next: Chapter 2 -- Tracing Fundamentals](./02-tracing.md) |
 
 ## Depth Expansion Playbook
 
@@ -630,7 +630,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Tracing Fundamentals](02-tracing.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/langfuse-tutorial/02-tracing.md b/tutorials/langfuse-tutorial/02-tracing.md
index 81df42dc..e19d353b 100644
--- a/tutorials/langfuse-tutorial/02-tracing.md
+++ b/tutorials/langfuse-tutorial/02-tracing.md
@@ -666,7 +666,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started with Langfuse](01-getting-started.md)
 - [Next Chapter: Chapter 3: Prompt Management](03-prompts.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/langfuse-tutorial/03-prompts.md b/tutorials/langfuse-tutorial/03-prompts.md
index c0ced93a..af782750 100644
--- a/tutorials/langfuse-tutorial/03-prompts.md
+++ b/tutorials/langfuse-tutorial/03-prompts.md
@@ -634,7 +634,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Tracing Fundamentals](02-tracing.md)
 - [Next Chapter: Chapter 4: Evaluation](04-evaluation.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/langfuse-tutorial/04-evaluation.md b/tutorials/langfuse-tutorial/04-evaluation.md
index 9be05cb8..4fe20118 100644
--- a/tutorials/langfuse-tutorial/04-evaluation.md
+++ b/tutorials/langfuse-tutorial/04-evaluation.md
@@ -716,7 +716,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Prompt Management](03-prompts.md)
 - [Next Chapter: Chapter 5: Analytics & Metrics](05-analytics.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/langfuse-tutorial/05-analytics.md b/tutorials/langfuse-tutorial/05-analytics.md
index 12f119df..aef54858 100644
--- a/tutorials/langfuse-tutorial/05-analytics.md
+++ b/tutorials/langfuse-tutorial/05-analytics.md
@@ -665,7 +665,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Evaluation](04-evaluation.md)
 - [Next Chapter: Chapter 6: Datasets & Testing](06-datasets.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/langfuse-tutorial/06-datasets.md b/tutorials/langfuse-tutorial/06-datasets.md
index bf0d5ae8..1af856f0 100644
--- a/tutorials/langfuse-tutorial/06-datasets.md
+++ b/tutorials/langfuse-tutorial/06-datasets.md
@@ -656,7 +656,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Analytics & Metrics](05-analytics.md)
 - [Next Chapter: Chapter 7: Integrations](07-integrations.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/langfuse-tutorial/07-integrations.md b/tutorials/langfuse-tutorial/07-integrations.md
index 5722e47f..de7372f7 100644
--- a/tutorials/langfuse-tutorial/07-integrations.md
+++ b/tutorials/langfuse-tutorial/07-integrations.md
@@ -695,7 +695,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Datasets & Testing](06-datasets.md)
 - [Next Chapter: Chapter 8: Production Deployment](08-production.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/langfuse-tutorial/08-production.md b/tutorials/langfuse-tutorial/08-production.md
index 821d10cc..3c6a4991 100644
--- a/tutorials/langfuse-tutorial/08-production.md
+++ b/tutorials/langfuse-tutorial/08-production.md
@@ -630,7 +630,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Integrations](07-integrations.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/langfuse-tutorial/index.md b/tutorials/langfuse-tutorial/README.md
similarity index 100%
rename from tutorials/langfuse-tutorial/index.md
rename to tutorials/langfuse-tutorial/README.md
diff --git a/tutorials/langgraph-tutorial/01-getting-started.md b/tutorials/langgraph-tutorial/01-getting-started.md
index 28c1ddfa..351d4e99 100644
--- a/tutorials/langgraph-tutorial/01-getting-started.md
+++ b/tutorials/langgraph-tutorial/01-getting-started.md
@@ -426,7 +426,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: State Management](02-state-management.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/langgraph-tutorial/02-state-management.md b/tutorials/langgraph-tutorial/02-state-management.md
index 91ca5d59..c23416a0 100644
--- a/tutorials/langgraph-tutorial/02-state-management.md
+++ b/tutorials/langgraph-tutorial/02-state-management.md
@@ -457,7 +457,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started with LangGraph](01-getting-started.md)
 - [Next Chapter: Chapter 3: Nodes and Edges](03-nodes-edges.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/langgraph-tutorial/03-nodes-edges.md b/tutorials/langgraph-tutorial/03-nodes-edges.md
index f5242aff..d7120ff8 100644
--- a/tutorials/langgraph-tutorial/03-nodes-edges.md
+++ b/tutorials/langgraph-tutorial/03-nodes-edges.md
@@ -608,7 +608,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: State Management](02-state-management.md)
 - [Next Chapter: Chapter 4: Conditional Logic](04-conditional-logic.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/langgraph-tutorial/04-conditional-logic.md b/tutorials/langgraph-tutorial/04-conditional-logic.md
index 1d8dd10a..bb9829d2 100644
--- a/tutorials/langgraph-tutorial/04-conditional-logic.md
+++ b/tutorials/langgraph-tutorial/04-conditional-logic.md
@@ -841,7 +841,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Nodes and Edges](03-nodes-edges.md)
 - [Next Chapter: Chapter 5: Multi-Agent Systems](05-multi-agent-systems.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/langgraph-tutorial/05-multi-agent-systems.md b/tutorials/langgraph-tutorial/05-multi-agent-systems.md
index 55e742c3..601b7d2b 100644
--- a/tutorials/langgraph-tutorial/05-multi-agent-systems.md
+++ b/tutorials/langgraph-tutorial/05-multi-agent-systems.md
@@ -719,7 +719,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Conditional Logic](04-conditional-logic.md)
 - [Next Chapter: Chapter 6: Tool Integration](06-tool-integration.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/langgraph-tutorial/06-tool-integration.md b/tutorials/langgraph-tutorial/06-tool-integration.md
index 0b51ed7e..0e5812d7 100644
--- a/tutorials/langgraph-tutorial/06-tool-integration.md
+++ b/tutorials/langgraph-tutorial/06-tool-integration.md
@@ -618,7 +618,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Multi-Agent Systems](05-multi-agent-systems.md)
 - [Next Chapter: Chapter 7: Persistence and Checkpoints](07-persistence-checkpoints.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/langgraph-tutorial/07-persistence-checkpoints.md b/tutorials/langgraph-tutorial/07-persistence-checkpoints.md
index fc8222ab..bbba3520 100644
--- a/tutorials/langgraph-tutorial/07-persistence-checkpoints.md
+++ b/tutorials/langgraph-tutorial/07-persistence-checkpoints.md
@@ -784,7 +784,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Tool Integration](06-tool-integration.md)
 - [Next Chapter: Chapter 8: Production Deployment](08-production-deployment.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/langgraph-tutorial/08-production-deployment.md b/tutorials/langgraph-tutorial/08-production-deployment.md
index 3cdd64e9..dc4e5255 100644
--- a/tutorials/langgraph-tutorial/08-production-deployment.md
+++ b/tutorials/langgraph-tutorial/08-production-deployment.md
@@ -953,7 +953,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Persistence and Checkpoints](07-persistence-checkpoints.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/langgraph-tutorial/index.md b/tutorials/langgraph-tutorial/README.md
similarity index 100%
rename from tutorials/langgraph-tutorial/index.md
rename to tutorials/langgraph-tutorial/README.md
diff --git a/tutorials/letta-tutorial/01-getting-started.md b/tutorials/letta-tutorial/01-getting-started.md
index 335c0d08..93f82c39 100644
--- a/tutorials/letta-tutorial/01-getting-started.md
+++ b/tutorials/letta-tutorial/01-getting-started.md
@@ -209,7 +209,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Memory Architecture in Letta](02-memory.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/letta-tutorial/02-memory.md b/tutorials/letta-tutorial/02-memory.md
index 9c5bd929..09faa604 100644
--- a/tutorials/letta-tutorial/02-memory.md
+++ b/tutorials/letta-tutorial/02-memory.md
@@ -259,7 +259,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started with Letta](01-getting-started.md)
 - [Next Chapter: Chapter 3: Agent Configuration](03-configuration.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/letta-tutorial/03-configuration.md b/tutorials/letta-tutorial/03-configuration.md
index 21bcb41b..7f2eabfb 100644
--- a/tutorials/letta-tutorial/03-configuration.md
+++ b/tutorials/letta-tutorial/03-configuration.md
@@ -334,7 +334,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Memory Architecture in Letta](02-memory.md)
 - [Next Chapter: Chapter 4: Tool Integration](04-tools.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/letta-tutorial/04-tools.md b/tutorials/letta-tutorial/04-tools.md
index 88c546c6..965829b0 100644
--- a/tutorials/letta-tutorial/04-tools.md
+++ b/tutorials/letta-tutorial/04-tools.md
@@ -438,7 +438,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Agent Configuration](03-configuration.md)
 - [Next Chapter: Chapter 5: Conversation Management](05-conversations.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/letta-tutorial/05-conversations.md b/tutorials/letta-tutorial/05-conversations.md
index 0367771e..48605c90 100644
--- a/tutorials/letta-tutorial/05-conversations.md
+++ b/tutorials/letta-tutorial/05-conversations.md
@@ -450,7 +450,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Tool Integration](04-tools.md)
 - [Next Chapter: Chapter 6: Multi-Agent Systems](06-multi-agent.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/letta-tutorial/06-multi-agent.md b/tutorials/letta-tutorial/06-multi-agent.md
index 8bd7b8fa..4a314ec3 100644
--- a/tutorials/letta-tutorial/06-multi-agent.md
+++ b/tutorials/letta-tutorial/06-multi-agent.md
@@ -504,7 +504,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Conversation Management](05-conversations.md)
 - [Next Chapter: Chapter 7: REST API](07-api.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/letta-tutorial/07-api.md b/tutorials/letta-tutorial/07-api.md
index 9a40f34e..363d2a51 100644
--- a/tutorials/letta-tutorial/07-api.md
+++ b/tutorials/letta-tutorial/07-api.md
@@ -510,7 +510,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Multi-Agent Systems](06-multi-agent.md)
 - [Next Chapter: Chapter 8: Production Deployment](08-production.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/letta-tutorial/08-production.md b/tutorials/letta-tutorial/08-production.md
index e5d77b41..76fdedab 100644
--- a/tutorials/letta-tutorial/08-production.md
+++ b/tutorials/letta-tutorial/08-production.md
@@ -682,7 +682,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: REST API](07-api.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/letta-tutorial/index.md b/tutorials/letta-tutorial/README.md
similarity index 100%
rename from tutorials/letta-tutorial/index.md
rename to tutorials/letta-tutorial/README.md
diff --git a/tutorials/litellm-tutorial/01-getting-started.md b/tutorials/litellm-tutorial/01-getting-started.md
index 4fe2955b..c16ec931 100644
--- a/tutorials/litellm-tutorial/01-getting-started.md
+++ b/tutorials/litellm-tutorial/01-getting-started.md
@@ -626,7 +626,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Provider Configuration](02-providers.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/litellm-tutorial/02-providers.md b/tutorials/litellm-tutorial/02-providers.md
index 4801cde6..832a3f54 100644
--- a/tutorials/litellm-tutorial/02-providers.md
+++ b/tutorials/litellm-tutorial/02-providers.md
@@ -626,7 +626,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started with LiteLLM](01-getting-started.md)
 - [Next Chapter: Chapter 3: Completion API](03-completion.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/litellm-tutorial/03-completion.md b/tutorials/litellm-tutorial/03-completion.md
index 4834bd92..0f7fc6c6 100644
--- a/tutorials/litellm-tutorial/03-completion.md
+++ b/tutorials/litellm-tutorial/03-completion.md
@@ -652,7 +652,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Provider Configuration](02-providers.md)
 - [Next Chapter: Chapter 4: Streaming & Async](04-streaming.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/litellm-tutorial/04-streaming.md b/tutorials/litellm-tutorial/04-streaming.md
index e8c77e9e..e20824f9 100644
--- a/tutorials/litellm-tutorial/04-streaming.md
+++ b/tutorials/litellm-tutorial/04-streaming.md
@@ -630,7 +630,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Completion API](03-completion.md)
 - [Next Chapter: Chapter 5: Fallbacks & Retries](05-fallbacks.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/litellm-tutorial/05-fallbacks.md b/tutorials/litellm-tutorial/05-fallbacks.md
index 02a65b93..d5fc3123 100644
--- a/tutorials/litellm-tutorial/05-fallbacks.md
+++ b/tutorials/litellm-tutorial/05-fallbacks.md
@@ -676,7 +676,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Streaming & Async](04-streaming.md)
 - [Next Chapter: Chapter 6: Cost Tracking](06-cost-tracking.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/litellm-tutorial/06-cost-tracking.md b/tutorials/litellm-tutorial/06-cost-tracking.md
index 63536606..ede78ae1 100644
--- a/tutorials/litellm-tutorial/06-cost-tracking.md
+++ b/tutorials/litellm-tutorial/06-cost-tracking.md
@@ -636,7 +636,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Fallbacks & Retries](05-fallbacks.md)
 - [Next Chapter: Chapter 7: LiteLLM Proxy](07-proxy.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/litellm-tutorial/07-proxy.md b/tutorials/litellm-tutorial/07-proxy.md
index 32eb1048..b6d589ad 100644
--- a/tutorials/litellm-tutorial/07-proxy.md
+++ b/tutorials/litellm-tutorial/07-proxy.md
@@ -631,7 +631,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Cost Tracking](06-cost-tracking.md)
 - [Next Chapter: Chapter 8: Production Deployment](08-production.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/litellm-tutorial/08-production.md b/tutorials/litellm-tutorial/08-production.md
index 1e55bfcf..05ac9f95 100644
--- a/tutorials/litellm-tutorial/08-production.md
+++ b/tutorials/litellm-tutorial/08-production.md
@@ -847,7 +847,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: LiteLLM Proxy](07-proxy.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/litellm-tutorial/index.md b/tutorials/litellm-tutorial/README.md
similarity index 100%
rename from tutorials/litellm-tutorial/index.md
rename to tutorials/litellm-tutorial/README.md
diff --git a/tutorials/liveblocks-tutorial/01-getting-started.md b/tutorials/liveblocks-tutorial/01-getting-started.md
index 22e809fc..21ea7258 100644
--- a/tutorials/liveblocks-tutorial/01-getting-started.md
+++ b/tutorials/liveblocks-tutorial/01-getting-started.md
@@ -676,7 +676,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Presence & Awareness](02-presence-awareness.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/liveblocks-tutorial/02-presence-awareness.md b/tutorials/liveblocks-tutorial/02-presence-awareness.md
index ce2975a6..77083078 100644
--- a/tutorials/liveblocks-tutorial/02-presence-awareness.md
+++ b/tutorials/liveblocks-tutorial/02-presence-awareness.md
@@ -781,7 +781,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started](01-getting-started.md)
 - [Next Chapter: Chapter 3: Storage & Conflict Resolution](03-storage-conflict-resolution.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/liveblocks-tutorial/03-storage-conflict-resolution.md b/tutorials/liveblocks-tutorial/03-storage-conflict-resolution.md
index c269ea93..5310191e 100644
--- a/tutorials/liveblocks-tutorial/03-storage-conflict-resolution.md
+++ b/tutorials/liveblocks-tutorial/03-storage-conflict-resolution.md
@@ -752,7 +752,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Presence & Awareness](02-presence-awareness.md)
 - [Next Chapter: Chapter 4: Comments & Threads](04-comments-threads.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/liveblocks-tutorial/04-comments-threads.md b/tutorials/liveblocks-tutorial/04-comments-threads.md
index 5069f99d..12d22a19 100644
--- a/tutorials/liveblocks-tutorial/04-comments-threads.md
+++ b/tutorials/liveblocks-tutorial/04-comments-threads.md
@@ -862,7 +862,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Storage & Conflict Resolution](03-storage-conflict-resolution.md)
 - [Next Chapter: Chapter 5: Notifications](05-notifications.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/liveblocks-tutorial/05-notifications.md b/tutorials/liveblocks-tutorial/05-notifications.md
index d7b61052..11c4c452 100644
--- a/tutorials/liveblocks-tutorial/05-notifications.md
+++ b/tutorials/liveblocks-tutorial/05-notifications.md
@@ -838,7 +838,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Comments & Threads](04-comments-threads.md)
 - [Next Chapter: Chapter 6: React Integration](06-react-integration.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/liveblocks-tutorial/06-react-integration.md b/tutorials/liveblocks-tutorial/06-react-integration.md
index 6f3ba2cf..5a409d2a 100644
--- a/tutorials/liveblocks-tutorial/06-react-integration.md
+++ b/tutorials/liveblocks-tutorial/06-react-integration.md
@@ -816,7 +816,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Notifications](05-notifications.md)
 - [Next Chapter: Chapter 7: Advanced Patterns](07-advanced-patterns.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/liveblocks-tutorial/07-advanced-patterns.md b/tutorials/liveblocks-tutorial/07-advanced-patterns.md
index 7df03bf1..f5eb1302 100644
--- a/tutorials/liveblocks-tutorial/07-advanced-patterns.md
+++ b/tutorials/liveblocks-tutorial/07-advanced-patterns.md
@@ -799,7 +799,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: React Integration](06-react-integration.md)
 - [Next Chapter: Chapter 8: Production Deployment](08-production-deployment.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/liveblocks-tutorial/08-production-deployment.md b/tutorials/liveblocks-tutorial/08-production-deployment.md
index 18ea7064..6c4a9f3f 100644
--- a/tutorials/liveblocks-tutorial/08-production-deployment.md
+++ b/tutorials/liveblocks-tutorial/08-production-deployment.md
@@ -910,7 +910,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Advanced Patterns](07-advanced-patterns.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/liveblocks-tutorial/index.md b/tutorials/liveblocks-tutorial/README.md
similarity index 100%
rename from tutorials/liveblocks-tutorial/index.md
rename to tutorials/liveblocks-tutorial/README.md
diff --git a/tutorials/llama-cpp-tutorial/01-getting-started.md b/tutorials/llama-cpp-tutorial/01-getting-started.md
index 83a15880..a59fb2a5 100644
--- a/tutorials/llama-cpp-tutorial/01-getting-started.md
+++ b/tutorials/llama-cpp-tutorial/01-getting-started.md
@@ -359,7 +359,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Model Formats and GGUF](02-model-formats.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/llama-cpp-tutorial/02-model-formats.md b/tutorials/llama-cpp-tutorial/02-model-formats.md
index 88abbe35..b67548c2 100644
--- a/tutorials/llama-cpp-tutorial/02-model-formats.md
+++ b/tutorials/llama-cpp-tutorial/02-model-formats.md
@@ -386,7 +386,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started with llama.cpp](01-getting-started.md)
 - [Next Chapter: Chapter 3: Command Line Interface](03-cli-usage.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/llama-cpp-tutorial/03-cli-usage.md b/tutorials/llama-cpp-tutorial/03-cli-usage.md
index 56339dba..8caa8772 100644
--- a/tutorials/llama-cpp-tutorial/03-cli-usage.md
+++ b/tutorials/llama-cpp-tutorial/03-cli-usage.md
@@ -536,7 +536,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Model Formats and GGUF](02-model-formats.md)
 - [Next Chapter: Chapter 4: Server Mode](04-server.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/llama-cpp-tutorial/04-server.md b/tutorials/llama-cpp-tutorial/04-server.md
index 94cdc01a..f15c8812 100644
--- a/tutorials/llama-cpp-tutorial/04-server.md
+++ b/tutorials/llama-cpp-tutorial/04-server.md
@@ -650,7 +650,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Command Line Interface](03-cli-usage.md)
 - [Next Chapter: Chapter 5: GPU Acceleration](05-gpu.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/llama-cpp-tutorial/05-gpu.md b/tutorials/llama-cpp-tutorial/05-gpu.md
index 69ee3d80..fda76ee4 100644
--- a/tutorials/llama-cpp-tutorial/05-gpu.md
+++ b/tutorials/llama-cpp-tutorial/05-gpu.md
@@ -543,7 +543,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Server Mode](04-server.md)
 - [Next Chapter: Chapter 6: Quantization](06-quantization.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/llama-cpp-tutorial/06-quantization.md b/tutorials/llama-cpp-tutorial/06-quantization.md
index 957025a1..2fdb12cc 100644
--- a/tutorials/llama-cpp-tutorial/06-quantization.md
+++ b/tutorials/llama-cpp-tutorial/06-quantization.md
@@ -498,7 +498,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: GPU Acceleration](05-gpu.md)
 - [Next Chapter: Chapter 7: Advanced Features](07-advanced.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/llama-cpp-tutorial/07-advanced.md b/tutorials/llama-cpp-tutorial/07-advanced.md
index c8f1ad57..82472fc9 100644
--- a/tutorials/llama-cpp-tutorial/07-advanced.md
+++ b/tutorials/llama-cpp-tutorial/07-advanced.md
@@ -561,7 +561,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Quantization](06-quantization.md)
 - [Next Chapter: Chapter 8: Integration](08-integration.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/llama-cpp-tutorial/08-integration.md b/tutorials/llama-cpp-tutorial/08-integration.md
index c98f42ca..95239ef6 100644
--- a/tutorials/llama-cpp-tutorial/08-integration.md
+++ b/tutorials/llama-cpp-tutorial/08-integration.md
@@ -746,7 +746,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Advanced Features](07-advanced.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/llama-cpp-tutorial/index.md b/tutorials/llama-cpp-tutorial/README.md
similarity index 100%
rename from tutorials/llama-cpp-tutorial/index.md
rename to tutorials/llama-cpp-tutorial/README.md
diff --git a/tutorials/llama-factory-tutorial/01-getting-started.md b/tutorials/llama-factory-tutorial/01-getting-started.md
index 771fb3ab..23e3ab69 100644
--- a/tutorials/llama-factory-tutorial/01-getting-started.md
+++ b/tutorials/llama-factory-tutorial/01-getting-started.md
@@ -404,7 +404,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Data Preparation](02-data-preparation.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/llama-factory-tutorial/02-data-preparation.md b/tutorials/llama-factory-tutorial/02-data-preparation.md
index 2df52010..7b9a35db 100644
--- a/tutorials/llama-factory-tutorial/02-data-preparation.md
+++ b/tutorials/llama-factory-tutorial/02-data-preparation.md
@@ -663,7 +663,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started with LLaMA-Factory](01-getting-started.md)
 - [Next Chapter: Chapter 3: Model Configuration](03-model-configuration.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/llama-factory-tutorial/03-model-configuration.md b/tutorials/llama-factory-tutorial/03-model-configuration.md
index 5a558b32..ad9692de 100644
--- a/tutorials/llama-factory-tutorial/03-model-configuration.md
+++ b/tutorials/llama-factory-tutorial/03-model-configuration.md
@@ -623,7 +623,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Data Preparation](02-data-preparation.md)
 - [Next Chapter: Chapter 4: Training Pipeline](04-training-pipeline.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/llama-factory-tutorial/04-training-pipeline.md b/tutorials/llama-factory-tutorial/04-training-pipeline.md
index 0e516442..af89df85 100644
--- a/tutorials/llama-factory-tutorial/04-training-pipeline.md
+++ b/tutorials/llama-factory-tutorial/04-training-pipeline.md
@@ -734,7 +734,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Model Configuration](03-model-configuration.md)
 - [Next Chapter: Chapter 5: Model Evaluation](05-model-evaluation.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/llama-factory-tutorial/05-model-evaluation.md b/tutorials/llama-factory-tutorial/05-model-evaluation.md
index b1bfbf66..42520052 100644
--- a/tutorials/llama-factory-tutorial/05-model-evaluation.md
+++ b/tutorials/llama-factory-tutorial/05-model-evaluation.md
@@ -828,7 +828,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Training Pipeline](04-training-pipeline.md)
 - [Next Chapter: Chapter 6: Deployment](06-deployment.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/llama-factory-tutorial/06-deployment.md b/tutorials/llama-factory-tutorial/06-deployment.md
index 7a595029..839436f8 100644
--- a/tutorials/llama-factory-tutorial/06-deployment.md
+++ b/tutorials/llama-factory-tutorial/06-deployment.md
@@ -639,7 +639,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Model Evaluation](05-model-evaluation.md)
 - [Next Chapter: Chapter 7: Advanced Techniques](07-advanced-techniques.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/llama-factory-tutorial/07-advanced-techniques.md b/tutorials/llama-factory-tutorial/07-advanced-techniques.md
index 5058caef..4b6d2595 100644
--- a/tutorials/llama-factory-tutorial/07-advanced-techniques.md
+++ b/tutorials/llama-factory-tutorial/07-advanced-techniques.md
@@ -669,7 +669,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Deployment](06-deployment.md)
 - [Next Chapter: Chapter 8: Production Case Studies](08-production-case-studies.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/llama-factory-tutorial/08-production-case-studies.md b/tutorials/llama-factory-tutorial/08-production-case-studies.md
index 4e2da256..31b8488a 100644
--- a/tutorials/llama-factory-tutorial/08-production-case-studies.md
+++ b/tutorials/llama-factory-tutorial/08-production-case-studies.md
@@ -836,7 +836,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Advanced Techniques](07-advanced-techniques.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/llama-factory-tutorial/index.md b/tutorials/llama-factory-tutorial/README.md
similarity index 100%
rename from tutorials/llama-factory-tutorial/index.md
rename to tutorials/llama-factory-tutorial/README.md
diff --git a/tutorials/llamaindex-tutorial/01-getting-started.md b/tutorials/llamaindex-tutorial/01-getting-started.md
index 4ce5823a..658bbf7e 100644
--- a/tutorials/llamaindex-tutorial/01-getting-started.md
+++ b/tutorials/llamaindex-tutorial/01-getting-started.md
@@ -597,7 +597,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Data Ingestion & Loading](02-data-ingestion.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/llamaindex-tutorial/02-data-ingestion.md b/tutorials/llamaindex-tutorial/02-data-ingestion.md
index 0d45a82a..f68969a7 100644
--- a/tutorials/llamaindex-tutorial/02-data-ingestion.md
+++ b/tutorials/llamaindex-tutorial/02-data-ingestion.md
@@ -1162,7 +1162,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started with LlamaIndex](01-getting-started.md)
 - [Next Chapter: Chapter 3: Indexing & Storage](03-indexing-storage.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/llamaindex-tutorial/03-indexing-storage.md b/tutorials/llamaindex-tutorial/03-indexing-storage.md
index 86a4b399..16e888fe 100644
--- a/tutorials/llamaindex-tutorial/03-indexing-storage.md
+++ b/tutorials/llamaindex-tutorial/03-indexing-storage.md
@@ -987,7 +987,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Data Ingestion & Loading](02-data-ingestion.md)
 - [Next Chapter: Chapter 4: Query Engines & Retrieval](04-query-engines.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/llamaindex-tutorial/04-query-engines.md b/tutorials/llamaindex-tutorial/04-query-engines.md
index 26bf0581..c42058ad 100644
--- a/tutorials/llamaindex-tutorial/04-query-engines.md
+++ b/tutorials/llamaindex-tutorial/04-query-engines.md
@@ -821,7 +821,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Indexing & Storage](03-indexing-storage.md)
 - [Next Chapter: Chapter 5: Advanced RAG Patterns](05-advanced-rag.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/llamaindex-tutorial/05-advanced-rag.md b/tutorials/llamaindex-tutorial/05-advanced-rag.md
index 3e2bcdbe..86223a74 100644
--- a/tutorials/llamaindex-tutorial/05-advanced-rag.md
+++ b/tutorials/llamaindex-tutorial/05-advanced-rag.md
@@ -867,7 +867,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Query Engines & Retrieval](04-query-engines.md)
 - [Next Chapter: Chapter 6: Custom Components](06-custom-components.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/llamaindex-tutorial/06-custom-components.md b/tutorials/llamaindex-tutorial/06-custom-components.md
index e7c61720..cf25d4cb 100644
--- a/tutorials/llamaindex-tutorial/06-custom-components.md
+++ b/tutorials/llamaindex-tutorial/06-custom-components.md
@@ -966,7 +966,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Advanced RAG Patterns](05-advanced-rag.md)
 - [Next Chapter: Chapter 7: Production Deployment](07-production-deployment.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/llamaindex-tutorial/07-production-deployment.md b/tutorials/llamaindex-tutorial/07-production-deployment.md
index a36dae9d..407e8a2c 100644
--- a/tutorials/llamaindex-tutorial/07-production-deployment.md
+++ b/tutorials/llamaindex-tutorial/07-production-deployment.md
@@ -1403,7 +1403,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Custom Components](06-custom-components.md)
 - [Next Chapter: Chapter 8: Monitoring & Optimization](08-monitoring-optimization.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/llamaindex-tutorial/08-monitoring-optimization.md b/tutorials/llamaindex-tutorial/08-monitoring-optimization.md
index 0b01d20e..6b219ea0 100644
--- a/tutorials/llamaindex-tutorial/08-monitoring-optimization.md
+++ b/tutorials/llamaindex-tutorial/08-monitoring-optimization.md
@@ -1537,7 +1537,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Production Deployment](07-production-deployment.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/llamaindex-tutorial/index.md b/tutorials/llamaindex-tutorial/README.md
similarity index 100%
rename from tutorials/llamaindex-tutorial/index.md
rename to tutorials/llamaindex-tutorial/README.md
diff --git a/tutorials/lobechat-ai-platform/01-system-overview.md b/tutorials/lobechat-ai-platform/01-system-overview.md
index f251d57a..37b7e2d4 100644
--- a/tutorials/lobechat-ai-platform/01-system-overview.md
+++ b/tutorials/lobechat-ai-platform/01-system-overview.md
@@ -621,7 +621,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Chat Interface Implementation](02-chat-interface.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/lobechat-ai-platform/02-chat-interface.md b/tutorials/lobechat-ai-platform/02-chat-interface.md
index 832c85d3..9f8da7bf 100644
--- a/tutorials/lobechat-ai-platform/02-chat-interface.md
+++ b/tutorials/lobechat-ai-platform/02-chat-interface.md
@@ -1000,7 +1000,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: LobeChat System Overview](01-system-overview.md)
 - [Next Chapter: Chapter 3: Streaming Architecture](03-streaming-architecture.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/lobechat-ai-platform/03-streaming-architecture.md b/tutorials/lobechat-ai-platform/03-streaming-architecture.md
index 036acc4f..485bd7a1 100644
--- a/tutorials/lobechat-ai-platform/03-streaming-architecture.md
+++ b/tutorials/lobechat-ai-platform/03-streaming-architecture.md
@@ -890,7 +890,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Chat Interface Implementation](02-chat-interface.md)
 - [Next Chapter: Chapter 4: AI Integration Patterns](04-ai-integration.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/lobechat-ai-platform/04-ai-integration.md b/tutorials/lobechat-ai-platform/04-ai-integration.md
index 6eb1df87..481d03c2 100644
--- a/tutorials/lobechat-ai-platform/04-ai-integration.md
+++ b/tutorials/lobechat-ai-platform/04-ai-integration.md
@@ -932,7 +932,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Streaming Architecture](03-streaming-architecture.md)
 - [Next Chapter: Chapter 5: Production Deployment](05-production-deployment.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/lobechat-ai-platform/05-production-deployment.md b/tutorials/lobechat-ai-platform/05-production-deployment.md
index 97eb0053..b0a8b687 100644
--- a/tutorials/lobechat-ai-platform/05-production-deployment.md
+++ b/tutorials/lobechat-ai-platform/05-production-deployment.md
@@ -1255,7 +1255,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: AI Integration Patterns](04-ai-integration.md)
 - [Next Chapter: Chapter 6: Plugin Development](06-plugin-development.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/lobechat-ai-platform/06-plugin-development.md b/tutorials/lobechat-ai-platform/06-plugin-development.md
index b03830b3..dd08cddc 100644
--- a/tutorials/lobechat-ai-platform/06-plugin-development.md
+++ b/tutorials/lobechat-ai-platform/06-plugin-development.md
@@ -492,7 +492,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Production Deployment](05-production-deployment.md)
 - [Next Chapter: Chapter 7: Advanced Customization](07-advanced-customization.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/lobechat-ai-platform/07-advanced-customization.md b/tutorials/lobechat-ai-platform/07-advanced-customization.md
index e924b2bc..4a9a5844 100644
--- a/tutorials/lobechat-ai-platform/07-advanced-customization.md
+++ b/tutorials/lobechat-ai-platform/07-advanced-customization.md
@@ -530,7 +530,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Plugin Development](06-plugin-development.md)
 - [Next Chapter: Chapter 8: Scaling & Performance](08-scaling-performance.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/lobechat-ai-platform/08-scaling-performance.md b/tutorials/lobechat-ai-platform/08-scaling-performance.md
index 798d0313..45c9a274 100644
--- a/tutorials/lobechat-ai-platform/08-scaling-performance.md
+++ b/tutorials/lobechat-ai-platform/08-scaling-performance.md
@@ -580,7 +580,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Advanced Customization](07-advanced-customization.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/lobechat-ai-platform/README.md b/tutorials/lobechat-ai-platform/README.md
index e9174a8a..d682c28f 100644
--- a/tutorials/lobechat-ai-platform/README.md
+++ b/tutorials/lobechat-ai-platform/README.md
@@ -1,72 +1,119 @@
-# LobeChat AI Platform Deep Dive
-
-> Master LobeChat's modern AI chat platform architecture - building scalable conversational AI with Next.js, streaming responses, and advanced UI patterns
-
-## 🎯 Learning Objectives
-
-- **Modern AI Chat Architecture** - Building responsive, scalable chat interfaces
-- **Streaming Response Handling** - Real-time AI response processing and display
-- **Next.js Advanced Patterns** - Server-side rendering, API routes, and optimization
-- **Multi-Model Integration** - Supporting various AI providers and models
-- **Advanced UI/UX Patterns** - Creating engaging conversational interfaces
-- **Performance Optimization** - Handling high-throughput chat applications
-- **Plugin System Design** - Extensible architecture for custom functionality
-
-## 📋 Prerequisites
-
-- **Next.js**: Solid understanding of Next.js App Router and React patterns
-- **TypeScript**: Advanced TypeScript knowledge for type-safe development
-- **AI APIs**: Experience with OpenAI, Anthropic, or similar AI service APIs
-- **Real-time Systems**: Understanding of WebSockets and streaming data
-- **UI/UX Design**: Knowledge of modern interface design principles
-
-## ⏱️ Time Investment
-
-**Total: 8-10 hours**
-- Architecture overview: 1.5 hours
-- Chat interface implementation: 2.5 hours
-- AI integration patterns: 2 hours
-- Advanced features: 2 hours
-- Production deployment: 2 hours
+---
+title: "LobeChat AI Platform"
+nav_order: 96
+has_children: true
+---
 
-## 🔧 Quick Setup
+# LobeChat AI Platform: Deep Dive Tutorial
+
+> **Project**: [LobeChat](https://github.com/lobehub/lobe-chat) — An open-source, modern-design AI chat framework for building private LLM applications.
+
+[![Stars](https://img.shields.io/github/stars/lobehub/lobe-chat?style=social)](https://github.com/lobehub/lobe-chat)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![TypeScript](https://img.shields.io/badge/TypeScript-Next.js-blue)](https://github.com/lobehub/lobe-chat)
+
+## What Is LobeChat?
+
+LobeChat is an open-source AI chat framework that enables you to build and deploy private LLM applications with multi-agent collaboration, plugin extensibility, and a modern UI. It supports dozens of model providers and offers one-click deployment via Vercel or Docker.
+
+| Feature | Description |
+|---------|-------------|
+| **Multi-Model** | OpenAI, Claude, Gemini, Ollama, Qwen, Azure, Bedrock, and more |
+| **Plugin System** | Function Calling-based plugin architecture for extensibility |
+| **Knowledge Base** | File upload, RAG, and knowledge management |
+| **Multimodal** | Vision, text-to-speech, speech-to-text support |
+| **Themes** | Modern, customizable UI with extensive theming |
+| **Deployment** | One-click Vercel, Docker, and cloud-native deployment |
+
+## Architecture Overview
+
+```mermaid
+graph TB
+    subgraph Frontend["Next.js Frontend"]
+        UI[Chat Interface]
+        THEME[Theme System]
+        STATE[Zustand State]
+    end
+
+    subgraph Backend["API Layer"]
+        ROUTE[API Routes]
+        STREAM[Streaming Engine]
+        AUTH[Authentication]
+    end
+
+    subgraph Providers["AI Providers"]
+        OAI[OpenAI]
+        CLAUDE[Anthropic]
+        GEMINI[Google]
+        OLLAMA[Ollama]
+        CUSTOM[Custom]
+    end
+
+    subgraph Extensions["Extensions"]
+        PLUGINS[Plugin System]
+        KB[Knowledge Base]
+        TTS[TTS / STT]
+    end
+
+    Frontend --> Backend
+    Backend --> Providers
+    Backend --> Extensions
+```
 
-```bash
-# Clone LobeChat
-git clone https://github.com/lobehub/lobe-chat.git
-cd lobe-chat
+## Tutorial Structure
+
+| Chapter | Topic | What You'll Learn |
+|---------|-------|-------------------|
+| [1. System Overview](01-system-overview.md) | Architecture | Next.js structure, data flow, core components |
+| [2. Chat Interface](02-chat-interface.md) | Frontend | Message rendering, input handling, conversation management |
+| [3. Streaming Architecture](03-streaming-architecture.md) | Real-Time | SSE streams, token handling, multi-model streaming |
+| [4. AI Integration](04-ai-integration.md) | Providers | Model configuration, provider abstraction, Function Calling |
+| [5. Production Deployment](05-production-deployment.md) | Operations | Docker, Vercel, monitoring, CI/CD, security |
+| [6. Plugin Development](06-plugin-development.md) | Extensibility | Plugin SDK, Function Calling extensions, custom tools |
+| [7. Advanced Customization](07-advanced-customization.md) | Deep Dive | Theme engine, i18n, monorepo architecture, component system |
+| [8. Scaling & Performance](08-scaling-performance.md) | Optimization | Caching, database tuning, edge deployment, load testing |
+
+## Tech Stack
+
+| Component | Technology |
+|-----------|-----------|
+| **Framework** | Next.js (App Router) |
+| **Language** | TypeScript |
+| **State** | Zustand |
+| **Styling** | Ant Design, Tailwind CSS |
+| **Database** | Drizzle ORM (PostgreSQL, SQLite) |
+| **Auth** | NextAuth.js |
+| **Deployment** | Vercel, Docker |
 
-# Install dependencies
-npm install
+---
 
-# Configure environment
-cp .env.example .env.local
-# Add your AI API keys
+Ready to begin? Start with [Chapter 1: System Overview](01-system-overview.md).
 
-# Start development server
-npm run dev
+---
 
-# Access at http://localhost:3000
-```
+*Built with insights from the [LobeChat repository](https://github.com/lobehub/lobe-chat) and community documentation.*
 
-## 💡 Key Architecture Insights
+## Navigation & Backlinks
 
-- **Streaming Chat Interface** - Real-time response handling with smooth UX
-- **Multi-Provider Architecture** - Abstracted AI service integration
-- **Advanced State Management** - Complex chat state and history management
-- **Performance Optimization** - Efficient rendering of large conversation histories
-- **Plugin Architecture** - Extensible system for custom AI tools and integrations
+- [Start Here: Chapter 1: LobeChat System Overview](01-system-overview.md)
+- [Back to Main Catalog](../../README.md#-tutorial-catalog)
+- [Browse A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
+- [Search by Intent](../../discoverability/query-hub.md)
+- [Explore Category Hubs](../../README.md#category-hubs)
 
-## 🎯 What You'll Build
+## Full Chapter Map
 
-1. **Streaming Chat Interface** - Real-time AI conversation system
-2. **Multi-Model Integration** - Support for various AI providers
-3. **Advanced Chat Features** - File uploads, code execution, and tool calling
-4. **Custom Plugin System** - Extensible architecture for new capabilities
-5. **Production Deployment** - Scalable chat platform deployment
+1. [Chapter 1: LobeChat System Overview](01-system-overview.md)
+2. [Chapter 2: Chat Interface Implementation](02-chat-interface.md)
+3. [Chapter 3: Streaming Architecture](03-streaming-architecture.md)
+4. [Chapter 4: AI Integration Patterns](04-ai-integration.md)
+5. [Chapter 5: Production Deployment](05-production-deployment.md)
+6. [Chapter 6: Plugin Development](06-plugin-development.md)
+7. [Chapter 7: Advanced Customization](07-advanced-customization.md)
+8. [Chapter 8: Scaling & Performance](08-scaling-performance.md)
 
----
+## Source References
 
-**🎉 Tutorial Complete**: This comprehensive guide now includes full implementations of chat interfaces, streaming architecture, AI integration patterns, and production deployment strategies.
+- [LobeChat](https://github.com/lobehub/lobe-chat)
 
-*Part of the [Awesome Code Docs](../../README.md) collection*
+*Generated by [AI Codebase Knowledge Builder](https://github.com/The-Pocket/Tutorial-Codebase-Knowledge)*
diff --git a/tutorials/lobechat-ai-platform/index.md b/tutorials/lobechat-ai-platform/index.md
deleted file mode 100644
index d682c28f..00000000
--- a/tutorials/lobechat-ai-platform/index.md
+++ /dev/null
@@ -1,119 +0,0 @@
----
-title: "LobeChat AI Platform"
-nav_order: 96
-has_children: true
----
-
-# LobeChat AI Platform: Deep Dive Tutorial
-
-> **Project**: [LobeChat](https://github.com/lobehub/lobe-chat) — An open-source, modern-design AI chat framework for building private LLM applications.
-
-[![Stars](https://img.shields.io/github/stars/lobehub/lobe-chat?style=social)](https://github.com/lobehub/lobe-chat)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-[![TypeScript](https://img.shields.io/badge/TypeScript-Next.js-blue)](https://github.com/lobehub/lobe-chat)
-
-## What Is LobeChat?
-
-LobeChat is an open-source AI chat framework that enables you to build and deploy private LLM applications with multi-agent collaboration, plugin extensibility, and a modern UI. It supports dozens of model providers and offers one-click deployment via Vercel or Docker.
-
-| Feature | Description |
-|---------|-------------|
-| **Multi-Model** | OpenAI, Claude, Gemini, Ollama, Qwen, Azure, Bedrock, and more |
-| **Plugin System** | Function Calling-based plugin architecture for extensibility |
-| **Knowledge Base** | File upload, RAG, and knowledge management |
-| **Multimodal** | Vision, text-to-speech, speech-to-text support |
-| **Themes** | Modern, customizable UI with extensive theming |
-| **Deployment** | One-click Vercel, Docker, and cloud-native deployment |
-
-## Architecture Overview
-
-```mermaid
-graph TB
-    subgraph Frontend["Next.js Frontend"]
-        UI[Chat Interface]
-        THEME[Theme System]
-        STATE[Zustand State]
-    end
-
-    subgraph Backend["API Layer"]
-        ROUTE[API Routes]
-        STREAM[Streaming Engine]
-        AUTH[Authentication]
-    end
-
-    subgraph Providers["AI Providers"]
-        OAI[OpenAI]
-        CLAUDE[Anthropic]
-        GEMINI[Google]
-        OLLAMA[Ollama]
-        CUSTOM[Custom]
-    end
-
-    subgraph Extensions["Extensions"]
-        PLUGINS[Plugin System]
-        KB[Knowledge Base]
-        TTS[TTS / STT]
-    end
-
-    Frontend --> Backend
-    Backend --> Providers
-    Backend --> Extensions
-```
-
-## Tutorial Structure
-
-| Chapter | Topic | What You'll Learn |
-|---------|-------|-------------------|
-| [1. System Overview](01-system-overview.md) | Architecture | Next.js structure, data flow, core components |
-| [2. Chat Interface](02-chat-interface.md) | Frontend | Message rendering, input handling, conversation management |
-| [3. Streaming Architecture](03-streaming-architecture.md) | Real-Time | SSE streams, token handling, multi-model streaming |
-| [4. AI Integration](04-ai-integration.md) | Providers | Model configuration, provider abstraction, Function Calling |
-| [5. Production Deployment](05-production-deployment.md) | Operations | Docker, Vercel, monitoring, CI/CD, security |
-| [6. Plugin Development](06-plugin-development.md) | Extensibility | Plugin SDK, Function Calling extensions, custom tools |
-| [7. Advanced Customization](07-advanced-customization.md) | Deep Dive | Theme engine, i18n, monorepo architecture, component system |
-| [8. Scaling & Performance](08-scaling-performance.md) | Optimization | Caching, database tuning, edge deployment, load testing |
-
-## Tech Stack
-
-| Component | Technology |
-|-----------|-----------|
-| **Framework** | Next.js (App Router) |
-| **Language** | TypeScript |
-| **State** | Zustand |
-| **Styling** | Ant Design, Tailwind CSS |
-| **Database** | Drizzle ORM (PostgreSQL, SQLite) |
-| **Auth** | NextAuth.js |
-| **Deployment** | Vercel, Docker |
-
----
-
-Ready to begin? Start with [Chapter 1: System Overview](01-system-overview.md).
-
----
-
-*Built with insights from the [LobeChat repository](https://github.com/lobehub/lobe-chat) and community documentation.*
-
-## Navigation & Backlinks
-
-- [Start Here: Chapter 1: LobeChat System Overview](01-system-overview.md)
-- [Back to Main Catalog](../../README.md#-tutorial-catalog)
-- [Browse A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
-- [Search by Intent](../../discoverability/query-hub.md)
-- [Explore Category Hubs](../../README.md#category-hubs)
-
-## Full Chapter Map
-
-1. [Chapter 1: LobeChat System Overview](01-system-overview.md)
-2. [Chapter 2: Chat Interface Implementation](02-chat-interface.md)
-3. [Chapter 3: Streaming Architecture](03-streaming-architecture.md)
-4. [Chapter 4: AI Integration Patterns](04-ai-integration.md)
-5. [Chapter 5: Production Deployment](05-production-deployment.md)
-6. [Chapter 6: Plugin Development](06-plugin-development.md)
-7. [Chapter 7: Advanced Customization](07-advanced-customization.md)
-8. [Chapter 8: Scaling & Performance](08-scaling-performance.md)
-
-## Source References
-
-- [LobeChat](https://github.com/lobehub/lobe-chat)
-
-*Generated by [AI Codebase Knowledge Builder](https://github.com/The-Pocket/Tutorial-Codebase-Knowledge)*
diff --git a/tutorials/localai-tutorial/01-getting-started.md b/tutorials/localai-tutorial/01-getting-started.md
index b689f748..7ae5cd90 100644
--- a/tutorials/localai-tutorial/01-getting-started.md
+++ b/tutorials/localai-tutorial/01-getting-started.md
@@ -477,7 +477,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Model Gallery and Management](02-models.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/localai-tutorial/02-models.md b/tutorials/localai-tutorial/02-models.md
index e1d0b472..593ee9f4 100644
--- a/tutorials/localai-tutorial/02-models.md
+++ b/tutorials/localai-tutorial/02-models.md
@@ -554,7 +554,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started with LocalAI](01-getting-started.md)
 - [Next Chapter: Chapter 3: Text Generation and Chat Completions](03-text-generation.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/localai-tutorial/03-text-generation.md b/tutorials/localai-tutorial/03-text-generation.md
index 0f7362b0..6b2c1e07 100644
--- a/tutorials/localai-tutorial/03-text-generation.md
+++ b/tutorials/localai-tutorial/03-text-generation.md
@@ -620,7 +620,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Model Gallery and Management](02-models.md)
 - [Next Chapter: Chapter 4: Image Generation with Stable Diffusion](04-image-generation.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/localai-tutorial/04-image-generation.md b/tutorials/localai-tutorial/04-image-generation.md
index c58fd9b5..4ca98ad1 100644
--- a/tutorials/localai-tutorial/04-image-generation.md
+++ b/tutorials/localai-tutorial/04-image-generation.md
@@ -487,7 +487,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Text Generation and Chat Completions](03-text-generation.md)
 - [Next Chapter: Chapter 5: Audio Processing - Whisper & TTS](05-audio.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/localai-tutorial/05-audio.md b/tutorials/localai-tutorial/05-audio.md
index aa1a32b9..f7c35392 100644
--- a/tutorials/localai-tutorial/05-audio.md
+++ b/tutorials/localai-tutorial/05-audio.md
@@ -562,7 +562,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Image Generation with Stable Diffusion](04-image-generation.md)
 - [Next Chapter: Chapter 6: Vector Embeddings for RAG](06-embeddings.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/localai-tutorial/06-embeddings.md b/tutorials/localai-tutorial/06-embeddings.md
index f2c31715..e3cbf2f9 100644
--- a/tutorials/localai-tutorial/06-embeddings.md
+++ b/tutorials/localai-tutorial/06-embeddings.md
@@ -549,7 +549,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Audio Processing - Whisper & TTS](05-audio.md)
 - [Next Chapter: Chapter 7: Advanced Configuration and Tuning](07-configuration.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/localai-tutorial/07-configuration.md b/tutorials/localai-tutorial/07-configuration.md
index e8eca673..e9baca0f 100644
--- a/tutorials/localai-tutorial/07-configuration.md
+++ b/tutorials/localai-tutorial/07-configuration.md
@@ -636,7 +636,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Vector Embeddings for RAG](06-embeddings.md)
 - [Next Chapter: Chapter 8: Production Integration and Applications](08-integration.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/localai-tutorial/08-integration.md b/tutorials/localai-tutorial/08-integration.md
index be171800..5b13406c 100644
--- a/tutorials/localai-tutorial/08-integration.md
+++ b/tutorials/localai-tutorial/08-integration.md
@@ -834,7 +834,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Advanced Configuration and Tuning](07-configuration.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/localai-tutorial/index.md b/tutorials/localai-tutorial/README.md
similarity index 100%
rename from tutorials/localai-tutorial/index.md
rename to tutorials/localai-tutorial/README.md
diff --git a/tutorials/logseq-knowledge-management/01-knowledge-management-principles.md b/tutorials/logseq-knowledge-management/01-knowledge-management-principles.md
index 8814ebb5..e8baadb9 100644
--- a/tutorials/logseq-knowledge-management/01-knowledge-management-principles.md
+++ b/tutorials/logseq-knowledge-management/01-knowledge-management-principles.md
@@ -519,7 +519,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: System Architecture](02-system-architecture.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/logseq-knowledge-management/02-system-architecture.md b/tutorials/logseq-knowledge-management/02-system-architecture.md
index e3de4768..b3988f28 100644
--- a/tutorials/logseq-knowledge-management/02-system-architecture.md
+++ b/tutorials/logseq-knowledge-management/02-system-architecture.md
@@ -87,7 +87,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Knowledge Management Philosophy](01-knowledge-management-principles.md)
 - [Next Chapter: Chapter 3: Local-First Data](03-local-first-data.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/logseq-knowledge-management/03-local-first-data.md b/tutorials/logseq-knowledge-management/03-local-first-data.md
index 87281242..4835ac7d 100644
--- a/tutorials/logseq-knowledge-management/03-local-first-data.md
+++ b/tutorials/logseq-knowledge-management/03-local-first-data.md
@@ -88,7 +88,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: System Architecture](02-system-architecture.md)
 - [Next Chapter: Logseq Development Environment Setup](04-development-setup.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/logseq-knowledge-management/04-development-setup.md b/tutorials/logseq-knowledge-management/04-development-setup.md
index 13a48b56..d526cab9 100644
--- a/tutorials/logseq-knowledge-management/04-development-setup.md
+++ b/tutorials/logseq-knowledge-management/04-development-setup.md
@@ -710,7 +710,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Local-First Data](03-local-first-data.md)
 - [Next Chapter: Chapter 5: Block Data Model](05-block-data-model.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/logseq-knowledge-management/05-block-data-model.md b/tutorials/logseq-knowledge-management/05-block-data-model.md
index 519e675d..fb260018 100644
--- a/tutorials/logseq-knowledge-management/05-block-data-model.md
+++ b/tutorials/logseq-knowledge-management/05-block-data-model.md
@@ -92,7 +92,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Logseq Development Environment Setup](04-development-setup.md)
 - [Next Chapter: Chapter 6: Block Editor](06-block-editor.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/logseq-knowledge-management/06-block-editor.md b/tutorials/logseq-knowledge-management/06-block-editor.md
index cd7504a1..ce066b31 100644
--- a/tutorials/logseq-knowledge-management/06-block-editor.md
+++ b/tutorials/logseq-knowledge-management/06-block-editor.md
@@ -88,7 +88,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Block Data Model](05-block-data-model.md)
 - [Next Chapter: Chapter 7: Bi-Directional Links](07-bidirectional-links.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/logseq-knowledge-management/07-bidirectional-links.md b/tutorials/logseq-knowledge-management/07-bidirectional-links.md
index 35e8ad06..f986c80b 100644
--- a/tutorials/logseq-knowledge-management/07-bidirectional-links.md
+++ b/tutorials/logseq-knowledge-management/07-bidirectional-links.md
@@ -84,7 +84,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Block Editor](06-block-editor.md)
 - [Next Chapter: Chapter 8: Graph Visualization](08-graph-visualization.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/logseq-knowledge-management/08-graph-visualization.md b/tutorials/logseq-knowledge-management/08-graph-visualization.md
index 5d340c7a..4294bb73 100644
--- a/tutorials/logseq-knowledge-management/08-graph-visualization.md
+++ b/tutorials/logseq-knowledge-management/08-graph-visualization.md
@@ -49,7 +49,7 @@ Useful controls include:
 You now have complete Logseq coverage from architecture and local-first data to graph visualization behavior at scale.
 
 Related:
-- [Logseq Index](index.md)
+- [Logseq Index](README.md)
 
 ## What Problem Does This Solve?
 
@@ -91,7 +91,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Bi-Directional Links](07-bidirectional-links.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/logseq-knowledge-management/README.md b/tutorials/logseq-knowledge-management/README.md
index cd370132..85eff08e 100644
--- a/tutorials/logseq-knowledge-management/README.md
+++ b/tutorials/logseq-knowledge-management/README.md
@@ -1,38 +1,136 @@
-# Logseq Knowledge Management Platform Deep Dive
+---
+layout: default
+title: "Logseq Knowledge Management"
+nav_order: 40
+has_children: true
+format_version: v2
+---
+
+# Logseq: Deep Dive Tutorial
+
+> **Project**: [Logseq](https://github.com/logseq/logseq) — A privacy-first, local-first knowledge management platform with block-based editing and graph visualization.
+
+[![Stars](https://img.shields.io/github/stars/logseq/logseq?style=social)](https://github.com/logseq/logseq)
+[![License: AGPL v3](https://img.shields.io/badge/License-AGPL_v3-blue.svg)](https://www.gnu.org/licenses/agpl-3.0)
+[![ClojureScript](https://img.shields.io/badge/ClojureScript-Electron-purple)](https://github.com/logseq/logseq)
+
+## Why This Track Matters
+
+Logseq proves that a local-first, privacy-preserving knowledge system can be as powerful as cloud-based alternatives — all notes stay as plain Markdown files you own, with a rich graph visualization layer on top.
+
+This track focuses on:
+- understanding block-based editing with bi-directional linking
+- working with Datascript and ClojureScript for local-first data management
+- building knowledge graph visualizations with D3.js
+- operating and extending Logseq with its JavaScript plugin API
+
+## What Is Logseq?
+
+Logseq is a local-first, privacy-preserving knowledge management platform built with ClojureScript and Electron. It stores notes as plain Markdown/Org-mode files on your filesystem, provides block-based editing with bi-directional linking, and visualizes your knowledge as an interactive graph.
+
+| Feature | Description |
+|---------|-------------|
+| **Local-First** | Files stored as plain Markdown on your filesystem |
+| **Block-Based** | Atomic content units with outliner-style editing |
+| **Bi-Directional Links** | Automatic backlinks and page references |
+| **Knowledge Graph** | Interactive D3.js visualization of note connections |
+| **Plugin System** | JavaScript plugin API with sandboxed execution |
+| **Git Sync** | Built-in Git-based synchronization across devices |
+
+## Mental Model
 
-A focused architecture walkthrough of Logseq's local-first knowledge management design.
+```mermaid
+graph TB
+    subgraph Desktop["Electron App"]
+        EDITOR[Block Editor]
+        GRAPH[Graph View]
+        SEARCH[Full-Text Search]
+        PLUGINS[Plugin Runtime]
+    end
 
-## Current Status
+    subgraph Core["ClojureScript Core"]
+        REFRAME[Re-frame State]
+        PARSER[Markdown/Org Parser]
+        INDEX[Block Index]
+    end
 
-Core chapter set is now published.
+    subgraph Storage["Local Storage"]
+        FS[File System / Markdown]
+        GIT[Git Sync]
+        DB[(Datascript)]
+    end
 
-| Item | Status |
-|:-----|:-------|
-| Published chapter docs | 8 |
-| Canonical entry point | [index.md](index.md) |
+    Desktop --> Core
+    Core --> Storage
+```
 
-## Published Chapters
+## Chapter Guide
 
-| Chapter | File | Focus |
-|:--------|:-----|:------|
-| 1 | [01-knowledge-management-principles.md](01-knowledge-management-principles.md) | Local-first and block-based design principles |
-| 2 | [02-system-architecture.md](02-system-architecture.md) | Runtime layers and application boundaries |
-| 3 | [03-local-first-data.md](03-local-first-data.md) | Filesystem-first storage and indexing |
-| 4 | [04-development-setup.md](04-development-setup.md) | Development environment and tooling setup |
-| 5 | [05-block-data-model.md](05-block-data-model.md) | Block graph data model and constraints |
-| 6 | [06-block-editor.md](06-block-editor.md) | Editor behavior and command handling |
-| 7 | [07-bidirectional-links.md](07-bidirectional-links.md) | Reference lifecycle and backlinks |
-| 8 | [08-graph-visualization.md](08-graph-visualization.md) | Graph rendering and performance strategies |
+| Chapter | Topic | What You'll Learn |
+|---------|-------|-------------------|
+| [1. Knowledge Management Principles](01-knowledge-management-principles.md) | Philosophy | Local-first paradigms, block-based thinking |
+| [2. System Architecture](02-system-architecture.md) | Architecture | Desktop/runtime boundaries and data flow |
+| [3. Local-First Data](03-local-first-data.md) | Data Model | Filesystem-first storage, indexing, and sync tradeoffs |
+| [4. Development Setup](04-development-setup.md) | Setup | ClojureScript + Electron development stack |
+| [5. Block Data Model](05-block-data-model.md) | Block Graph | Block identity, hierarchy, and constraints |
+| [6. Block Editor](06-block-editor.md) | Editing UX | Command handling and structural edits |
+| [7. Bi-Directional Links](07-bidirectional-links.md) | Graph Edges | Reference lifecycle and backlink generation |
+| [8. Graph Visualization](08-graph-visualization.md) | Visualization | Graph rendering and large-graph performance |
 
-## Suggested Reading Order
+## Tech Stack
 
-1. Start with [index.md](index.md).
-2. Read chapters [1](01-knowledge-management-principles.md) through [8](08-graph-visualization.md) in order.
+| Component | Technology |
+|-----------|-----------|
+| **Language** | ClojureScript |
+| **UI Framework** | Reagent (React wrapper) |
+| **State** | Re-frame |
+| **Database** | Datascript (in-memory) |
+| **Desktop** | Electron |
+| **Graph Viz** | D3.js |
+| **File Format** | Markdown, Org-mode |
 
-## Upstream Project
+---
 
-- Logseq repository: <https://github.com/logseq/logseq>
+Ready to begin? Start with [Chapter 1: Knowledge Management Principles](01-knowledge-management-principles.md).
 
 ---
 
-Part of [Awesome Code Docs](../../README.md)
+*Built with insights from the [Logseq repository](https://github.com/logseq/logseq) and community documentation.*
+
+## Navigation & Backlinks
+
+- [Start Here: Chapter 1: Knowledge Management Philosophy](01-knowledge-management-principles.md)
+- [Back to Main Catalog](../../README.md#-tutorial-catalog)
+- [Browse A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
+- [Search by Intent](../../discoverability/query-hub.md)
+- [Explore Category Hubs](../../README.md#category-hubs)
+
+## Full Chapter Map
+
+1. [Chapter 1: Knowledge Management Philosophy](01-knowledge-management-principles.md)
+2. [Chapter 2: System Architecture](02-system-architecture.md)
+3. [Chapter 3: Local-First Data](03-local-first-data.md)
+4. [Logseq Development Environment Setup](04-development-setup.md)
+5. [Chapter 5: Block Data Model](05-block-data-model.md)
+6. [Chapter 6: Block Editor](06-block-editor.md)
+7. [Chapter 7: Bi-Directional Links](07-bidirectional-links.md)
+8. [Chapter 8: Graph Visualization](08-graph-visualization.md)
+
+## Current Snapshot (auto-updated)
+
+- repository: [logseq/logseq](https://github.com/logseq/logseq)
+- stars: about **32K**
+- project positioning: privacy-first, local-first knowledge management platform with graph visualization
+
+## What You Will Learn
+
+- how Logseq stores notes as plain Markdown files with Datascript indexing for fast queries
+- how block identity, hierarchy, and bi-directional links are managed in the graph model
+- how ClojureScript and Re-frame power the local-first state management architecture
+- how the graph visualization renders large knowledge networks with D3.js
+
+## Source References
+
+- [Logseq](https://github.com/logseq/logseq)
+
+*Generated by [AI Codebase Knowledge Builder](https://github.com/The-Pocket/Tutorial-Codebase-Knowledge)*
diff --git a/tutorials/logseq-knowledge-management/index.md b/tutorials/logseq-knowledge-management/index.md
deleted file mode 100644
index 85eff08e..00000000
--- a/tutorials/logseq-knowledge-management/index.md
+++ /dev/null
@@ -1,136 +0,0 @@
----
-layout: default
-title: "Logseq Knowledge Management"
-nav_order: 40
-has_children: true
-format_version: v2
----
-
-# Logseq: Deep Dive Tutorial
-
-> **Project**: [Logseq](https://github.com/logseq/logseq) — A privacy-first, local-first knowledge management platform with block-based editing and graph visualization.
-
-[![Stars](https://img.shields.io/github/stars/logseq/logseq?style=social)](https://github.com/logseq/logseq)
-[![License: AGPL v3](https://img.shields.io/badge/License-AGPL_v3-blue.svg)](https://www.gnu.org/licenses/agpl-3.0)
-[![ClojureScript](https://img.shields.io/badge/ClojureScript-Electron-purple)](https://github.com/logseq/logseq)
-
-## Why This Track Matters
-
-Logseq proves that a local-first, privacy-preserving knowledge system can be as powerful as cloud-based alternatives — all notes stay as plain Markdown files you own, with a rich graph visualization layer on top.
-
-This track focuses on:
-- understanding block-based editing with bi-directional linking
-- working with Datascript and ClojureScript for local-first data management
-- building knowledge graph visualizations with D3.js
-- operating and extending Logseq with its JavaScript plugin API
-
-## What Is Logseq?
-
-Logseq is a local-first, privacy-preserving knowledge management platform built with ClojureScript and Electron. It stores notes as plain Markdown/Org-mode files on your filesystem, provides block-based editing with bi-directional linking, and visualizes your knowledge as an interactive graph.
-
-| Feature | Description |
-|---------|-------------|
-| **Local-First** | Files stored as plain Markdown on your filesystem |
-| **Block-Based** | Atomic content units with outliner-style editing |
-| **Bi-Directional Links** | Automatic backlinks and page references |
-| **Knowledge Graph** | Interactive D3.js visualization of note connections |
-| **Plugin System** | JavaScript plugin API with sandboxed execution |
-| **Git Sync** | Built-in Git-based synchronization across devices |
-
-## Mental Model
-
-```mermaid
-graph TB
-    subgraph Desktop["Electron App"]
-        EDITOR[Block Editor]
-        GRAPH[Graph View]
-        SEARCH[Full-Text Search]
-        PLUGINS[Plugin Runtime]
-    end
-
-    subgraph Core["ClojureScript Core"]
-        REFRAME[Re-frame State]
-        PARSER[Markdown/Org Parser]
-        INDEX[Block Index]
-    end
-
-    subgraph Storage["Local Storage"]
-        FS[File System / Markdown]
-        GIT[Git Sync]
-        DB[(Datascript)]
-    end
-
-    Desktop --> Core
-    Core --> Storage
-```
-
-## Chapter Guide
-
-| Chapter | Topic | What You'll Learn |
-|---------|-------|-------------------|
-| [1. Knowledge Management Principles](01-knowledge-management-principles.md) | Philosophy | Local-first paradigms, block-based thinking |
-| [2. System Architecture](02-system-architecture.md) | Architecture | Desktop/runtime boundaries and data flow |
-| [3. Local-First Data](03-local-first-data.md) | Data Model | Filesystem-first storage, indexing, and sync tradeoffs |
-| [4. Development Setup](04-development-setup.md) | Setup | ClojureScript + Electron development stack |
-| [5. Block Data Model](05-block-data-model.md) | Block Graph | Block identity, hierarchy, and constraints |
-| [6. Block Editor](06-block-editor.md) | Editing UX | Command handling and structural edits |
-| [7. Bi-Directional Links](07-bidirectional-links.md) | Graph Edges | Reference lifecycle and backlink generation |
-| [8. Graph Visualization](08-graph-visualization.md) | Visualization | Graph rendering and large-graph performance |
-
-## Tech Stack
-
-| Component | Technology |
-|-----------|-----------|
-| **Language** | ClojureScript |
-| **UI Framework** | Reagent (React wrapper) |
-| **State** | Re-frame |
-| **Database** | Datascript (in-memory) |
-| **Desktop** | Electron |
-| **Graph Viz** | D3.js |
-| **File Format** | Markdown, Org-mode |
-
----
-
-Ready to begin? Start with [Chapter 1: Knowledge Management Principles](01-knowledge-management-principles.md).
-
----
-
-*Built with insights from the [Logseq repository](https://github.com/logseq/logseq) and community documentation.*
-
-## Navigation & Backlinks
-
-- [Start Here: Chapter 1: Knowledge Management Philosophy](01-knowledge-management-principles.md)
-- [Back to Main Catalog](../../README.md#-tutorial-catalog)
-- [Browse A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
-- [Search by Intent](../../discoverability/query-hub.md)
-- [Explore Category Hubs](../../README.md#category-hubs)
-
-## Full Chapter Map
-
-1. [Chapter 1: Knowledge Management Philosophy](01-knowledge-management-principles.md)
-2. [Chapter 2: System Architecture](02-system-architecture.md)
-3. [Chapter 3: Local-First Data](03-local-first-data.md)
-4. [Logseq Development Environment Setup](04-development-setup.md)
-5. [Chapter 5: Block Data Model](05-block-data-model.md)
-6. [Chapter 6: Block Editor](06-block-editor.md)
-7. [Chapter 7: Bi-Directional Links](07-bidirectional-links.md)
-8. [Chapter 8: Graph Visualization](08-graph-visualization.md)
-
-## Current Snapshot (auto-updated)
-
-- repository: [logseq/logseq](https://github.com/logseq/logseq)
-- stars: about **32K**
-- project positioning: privacy-first, local-first knowledge management platform with graph visualization
-
-## What You Will Learn
-
-- how Logseq stores notes as plain Markdown files with Datascript indexing for fast queries
-- how block identity, hierarchy, and bi-directional links are managed in the graph model
-- how ClojureScript and Re-frame power the local-first state management architecture
-- how the graph visualization renders large knowledge networks with D3.js
-
-## Source References
-
-- [Logseq](https://github.com/logseq/logseq)
-
-*Generated by [AI Codebase Knowledge Builder](https://github.com/The-Pocket/Tutorial-Codebase-Knowledge)*
diff --git a/tutorials/mastra-tutorial/01-getting-started.md b/tutorials/mastra-tutorial/01-getting-started.md
index dfce04a1..c2d56638 100644
--- a/tutorials/mastra-tutorial/01-getting-started.md
+++ b/tutorials/mastra-tutorial/01-getting-started.md
@@ -638,7 +638,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: System Architecture](02-system-architecture.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/mastra-tutorial/02-system-architecture.md b/tutorials/mastra-tutorial/02-system-architecture.md
index 78b0c83b..8c81f833 100644
--- a/tutorials/mastra-tutorial/02-system-architecture.md
+++ b/tutorials/mastra-tutorial/02-system-architecture.md
@@ -639,7 +639,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started](01-getting-started.md)
 - [Next Chapter: Chapter 3: Agents and Tools](03-agents-and-tools.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mastra-tutorial/03-agents-and-tools.md b/tutorials/mastra-tutorial/03-agents-and-tools.md
index fca90b0c..196fee1a 100644
--- a/tutorials/mastra-tutorial/03-agents-and-tools.md
+++ b/tutorials/mastra-tutorial/03-agents-and-tools.md
@@ -625,7 +625,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: System Architecture](02-system-architecture.md)
 - [Next Chapter: Chapter 4: Workflows and Control Flow](04-workflows-and-control-flow.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mastra-tutorial/04-workflows-and-control-flow.md b/tutorials/mastra-tutorial/04-workflows-and-control-flow.md
index 8c3f4269..ef4a24a2 100644
--- a/tutorials/mastra-tutorial/04-workflows-and-control-flow.md
+++ b/tutorials/mastra-tutorial/04-workflows-and-control-flow.md
@@ -629,7 +629,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Agents and Tools](03-agents-and-tools.md)
 - [Next Chapter: Chapter 5: Memory, RAG, and Context](05-memory-rag-and-context.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mastra-tutorial/05-memory-rag-and-context.md b/tutorials/mastra-tutorial/05-memory-rag-and-context.md
index 020a946b..612fa526 100644
--- a/tutorials/mastra-tutorial/05-memory-rag-and-context.md
+++ b/tutorials/mastra-tutorial/05-memory-rag-and-context.md
@@ -624,7 +624,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Workflows and Control Flow](04-workflows-and-control-flow.md)
 - [Next Chapter: Chapter 6: MCP and Integration Patterns](06-mcp-and-integration-patterns.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mastra-tutorial/06-mcp-and-integration-patterns.md b/tutorials/mastra-tutorial/06-mcp-and-integration-patterns.md
index 2b67ec36..d0e70d9d 100644
--- a/tutorials/mastra-tutorial/06-mcp-and-integration-patterns.md
+++ b/tutorials/mastra-tutorial/06-mcp-and-integration-patterns.md
@@ -635,7 +635,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Memory, RAG, and Context](05-memory-rag-and-context.md)
 - [Next Chapter: Chapter 7: Evals, Observability, and Quality](07-evals-observability-and-quality.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mastra-tutorial/07-evals-observability-and-quality.md b/tutorials/mastra-tutorial/07-evals-observability-and-quality.md
index 9bce7198..4b9a167b 100644
--- a/tutorials/mastra-tutorial/07-evals-observability-and-quality.md
+++ b/tutorials/mastra-tutorial/07-evals-observability-and-quality.md
@@ -625,7 +625,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: MCP and Integration Patterns](06-mcp-and-integration-patterns.md)
 - [Next Chapter: Chapter 8: Production Deployment and Scaling](08-production-deployment-and-scaling.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mastra-tutorial/08-production-deployment-and-scaling.md b/tutorials/mastra-tutorial/08-production-deployment-and-scaling.md
index 07c088c2..646eba42 100644
--- a/tutorials/mastra-tutorial/08-production-deployment-and-scaling.md
+++ b/tutorials/mastra-tutorial/08-production-deployment-and-scaling.md
@@ -631,7 +631,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Evals, Observability, and Quality](07-evals-observability-and-quality.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/mastra-tutorial/index.md b/tutorials/mastra-tutorial/README.md
similarity index 100%
rename from tutorials/mastra-tutorial/index.md
rename to tutorials/mastra-tutorial/README.md
diff --git a/tutorials/mcp-chrome-tutorial/01-getting-started-and-native-bridge-setup.md b/tutorials/mcp-chrome-tutorial/01-getting-started-and-native-bridge-setup.md
index 4804e720..583f6fd8 100644
--- a/tutorials/mcp-chrome-tutorial/01-getting-started-and-native-bridge-setup.md
+++ b/tutorials/mcp-chrome-tutorial/01-getting-started-and-native-bridge-setup.md
@@ -638,7 +638,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Architecture and Component Boundaries](02-architecture-and-component-boundaries.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/mcp-chrome-tutorial/02-architecture-and-component-boundaries.md b/tutorials/mcp-chrome-tutorial/02-architecture-and-component-boundaries.md
index eead9832..8e96f391 100644
--- a/tutorials/mcp-chrome-tutorial/02-architecture-and-component-boundaries.md
+++ b/tutorials/mcp-chrome-tutorial/02-architecture-and-component-boundaries.md
@@ -637,7 +637,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started and Native Bridge Setup](01-getting-started-and-native-bridge-setup.md)
 - [Next Chapter: Chapter 3: Tool Surface: Browser, Network, and Interaction](03-tool-surface-browser-network-and-interaction.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-chrome-tutorial/03-tool-surface-browser-network-and-interaction.md b/tutorials/mcp-chrome-tutorial/03-tool-surface-browser-network-and-interaction.md
index a69da00a..99c88557 100644
--- a/tutorials/mcp-chrome-tutorial/03-tool-surface-browser-network-and-interaction.md
+++ b/tutorials/mcp-chrome-tutorial/03-tool-surface-browser-network-and-interaction.md
@@ -643,7 +643,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Architecture and Component Boundaries](02-architecture-and-component-boundaries.md)
 - [Next Chapter: Chapter 4: Semantic Search and Vector Processing](04-semantic-search-and-vector-processing.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-chrome-tutorial/04-semantic-search-and-vector-processing.md b/tutorials/mcp-chrome-tutorial/04-semantic-search-and-vector-processing.md
index bd335632..623a668a 100644
--- a/tutorials/mcp-chrome-tutorial/04-semantic-search-and-vector-processing.md
+++ b/tutorials/mcp-chrome-tutorial/04-semantic-search-and-vector-processing.md
@@ -637,7 +637,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Tool Surface: Browser, Network, and Interaction](03-tool-surface-browser-network-and-interaction.md)
 - [Next Chapter: Chapter 5: Transport Modes and Client Configuration](05-transport-modes-and-client-configuration.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-chrome-tutorial/05-transport-modes-and-client-configuration.md b/tutorials/mcp-chrome-tutorial/05-transport-modes-and-client-configuration.md
index 222fb094..f18a48ff 100644
--- a/tutorials/mcp-chrome-tutorial/05-transport-modes-and-client-configuration.md
+++ b/tutorials/mcp-chrome-tutorial/05-transport-modes-and-client-configuration.md
@@ -639,7 +639,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Semantic Search and Vector Processing](04-semantic-search-and-vector-processing.md)
 - [Next Chapter: Chapter 6: Visual Editor and Prompt Workflows](06-visual-editor-and-prompt-workflows.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-chrome-tutorial/06-visual-editor-and-prompt-workflows.md b/tutorials/mcp-chrome-tutorial/06-visual-editor-and-prompt-workflows.md
index df63cc41..80cada15 100644
--- a/tutorials/mcp-chrome-tutorial/06-visual-editor-and-prompt-workflows.md
+++ b/tutorials/mcp-chrome-tutorial/06-visual-editor-and-prompt-workflows.md
@@ -634,7 +634,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Transport Modes and Client Configuration](05-transport-modes-and-client-configuration.md)
 - [Next Chapter: Chapter 7: Troubleshooting, Permissions, and Security](07-troubleshooting-permissions-and-security.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-chrome-tutorial/07-troubleshooting-permissions-and-security.md b/tutorials/mcp-chrome-tutorial/07-troubleshooting-permissions-and-security.md
index fd52e903..635931a8 100644
--- a/tutorials/mcp-chrome-tutorial/07-troubleshooting-permissions-and-security.md
+++ b/tutorials/mcp-chrome-tutorial/07-troubleshooting-permissions-and-security.md
@@ -643,7 +643,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Visual Editor and Prompt Workflows](06-visual-editor-and-prompt-workflows.md)
 - [Next Chapter: Chapter 8: Contribution, Release, and Runtime Operations](08-contribution-release-and-runtime-operations.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-chrome-tutorial/08-contribution-release-and-runtime-operations.md b/tutorials/mcp-chrome-tutorial/08-contribution-release-and-runtime-operations.md
index 24aec846..8869ad94 100644
--- a/tutorials/mcp-chrome-tutorial/08-contribution-release-and-runtime-operations.md
+++ b/tutorials/mcp-chrome-tutorial/08-contribution-release-and-runtime-operations.md
@@ -635,7 +635,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Troubleshooting, Permissions, and Security](07-troubleshooting-permissions-and-security.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/mcp-chrome-tutorial/index.md b/tutorials/mcp-chrome-tutorial/README.md
similarity index 100%
rename from tutorials/mcp-chrome-tutorial/index.md
rename to tutorials/mcp-chrome-tutorial/README.md
diff --git a/tutorials/mcp-csharp-sdk-tutorial/01-getting-started-and-package-selection.md b/tutorials/mcp-csharp-sdk-tutorial/01-getting-started-and-package-selection.md
index 0da1607d..170ed816 100644
--- a/tutorials/mcp-csharp-sdk-tutorial/01-getting-started-and-package-selection.md
+++ b/tutorials/mcp-csharp-sdk-tutorial/01-getting-started-and-package-selection.md
@@ -637,7 +637,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Client/Server Hosting and stdio Basics](02-client-server-hosting-and-stdio-basics.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/mcp-csharp-sdk-tutorial/02-client-server-hosting-and-stdio-basics.md b/tutorials/mcp-csharp-sdk-tutorial/02-client-server-hosting-and-stdio-basics.md
index 13ec3d19..8a47f574 100644
--- a/tutorials/mcp-csharp-sdk-tutorial/02-client-server-hosting-and-stdio-basics.md
+++ b/tutorials/mcp-csharp-sdk-tutorial/02-client-server-hosting-and-stdio-basics.md
@@ -635,7 +635,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started and Package Selection](01-getting-started-and-package-selection.md)
 - [Next Chapter: Chapter 3: ASP.NET Core HTTP Transport and Session Routing](03-aspnetcore-http-transport-and-session-routing.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-csharp-sdk-tutorial/03-aspnetcore-http-transport-and-session-routing.md b/tutorials/mcp-csharp-sdk-tutorial/03-aspnetcore-http-transport-and-session-routing.md
index 58e7a431..a0bb5012 100644
--- a/tutorials/mcp-csharp-sdk-tutorial/03-aspnetcore-http-transport-and-session-routing.md
+++ b/tutorials/mcp-csharp-sdk-tutorial/03-aspnetcore-http-transport-and-session-routing.md
@@ -636,7 +636,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Client/Server Hosting and stdio Basics](02-client-server-hosting-and-stdio-basics.md)
 - [Next Chapter: Chapter 4: Tools, Prompts, Resources, and Filter Pipelines](04-tools-prompts-resources-and-filter-pipelines.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-csharp-sdk-tutorial/04-tools-prompts-resources-and-filter-pipelines.md b/tutorials/mcp-csharp-sdk-tutorial/04-tools-prompts-resources-and-filter-pipelines.md
index 5d7310d4..06caee3a 100644
--- a/tutorials/mcp-csharp-sdk-tutorial/04-tools-prompts-resources-and-filter-pipelines.md
+++ b/tutorials/mcp-csharp-sdk-tutorial/04-tools-prompts-resources-and-filter-pipelines.md
@@ -637,7 +637,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: ASP.NET Core HTTP Transport and Session Routing](03-aspnetcore-http-transport-and-session-routing.md)
 - [Next Chapter: Chapter 5: Logging, Progress, Elicitation, and Tasks](05-logging-progress-elicitation-and-tasks.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-csharp-sdk-tutorial/05-logging-progress-elicitation-and-tasks.md b/tutorials/mcp-csharp-sdk-tutorial/05-logging-progress-elicitation-and-tasks.md
index 86e2fdbf..e68392f3 100644
--- a/tutorials/mcp-csharp-sdk-tutorial/05-logging-progress-elicitation-and-tasks.md
+++ b/tutorials/mcp-csharp-sdk-tutorial/05-logging-progress-elicitation-and-tasks.md
@@ -638,7 +638,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Tools, Prompts, Resources, and Filter Pipelines](04-tools-prompts-resources-and-filter-pipelines.md)
 - [Next Chapter: Chapter 6: OAuth-Protected MCP Servers and Clients](06-oauth-protected-mcp-servers-and-clients.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-csharp-sdk-tutorial/06-oauth-protected-mcp-servers-and-clients.md b/tutorials/mcp-csharp-sdk-tutorial/06-oauth-protected-mcp-servers-and-clients.md
index 7cb31892..3d4ba2f5 100644
--- a/tutorials/mcp-csharp-sdk-tutorial/06-oauth-protected-mcp-servers-and-clients.md
+++ b/tutorials/mcp-csharp-sdk-tutorial/06-oauth-protected-mcp-servers-and-clients.md
@@ -636,7 +636,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Logging, Progress, Elicitation, and Tasks](05-logging-progress-elicitation-and-tasks.md)
 - [Next Chapter: Chapter 7: Diagnostics, Versioning, and Breaking-Change Management](07-diagnostics-versioning-and-breaking-change-management.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-csharp-sdk-tutorial/07-diagnostics-versioning-and-breaking-change-management.md b/tutorials/mcp-csharp-sdk-tutorial/07-diagnostics-versioning-and-breaking-change-management.md
index e9836dbb..9769aa4f 100644
--- a/tutorials/mcp-csharp-sdk-tutorial/07-diagnostics-versioning-and-breaking-change-management.md
+++ b/tutorials/mcp-csharp-sdk-tutorial/07-diagnostics-versioning-and-breaking-change-management.md
@@ -636,7 +636,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: OAuth-Protected MCP Servers and Clients](06-oauth-protected-mcp-servers-and-clients.md)
 - [Next Chapter: Chapter 8: Testing, Operations, and Contribution Workflows](08-testing-operations-and-contribution-workflows.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-csharp-sdk-tutorial/08-testing-operations-and-contribution-workflows.md b/tutorials/mcp-csharp-sdk-tutorial/08-testing-operations-and-contribution-workflows.md
index 4275ba61..12e08af7 100644
--- a/tutorials/mcp-csharp-sdk-tutorial/08-testing-operations-and-contribution-workflows.md
+++ b/tutorials/mcp-csharp-sdk-tutorial/08-testing-operations-and-contribution-workflows.md
@@ -636,7 +636,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Diagnostics, Versioning, and Breaking-Change Management](07-diagnostics-versioning-and-breaking-change-management.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/mcp-csharp-sdk-tutorial/index.md b/tutorials/mcp-csharp-sdk-tutorial/README.md
similarity index 100%
rename from tutorials/mcp-csharp-sdk-tutorial/index.md
rename to tutorials/mcp-csharp-sdk-tutorial/README.md
diff --git a/tutorials/mcp-docs-repo-tutorial/01-getting-started-and-archive-context.md b/tutorials/mcp-docs-repo-tutorial/01-getting-started-and-archive-context.md
index b2c67497..7aabee49 100644
--- a/tutorials/mcp-docs-repo-tutorial/01-getting-started-and-archive-context.md
+++ b/tutorials/mcp-docs-repo-tutorial/01-getting-started-and-archive-context.md
@@ -640,7 +640,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Repository Layout and Canonical Migration Path](02-repository-layout-and-canonical-migration-path.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/mcp-docs-repo-tutorial/02-repository-layout-and-canonical-migration-path.md b/tutorials/mcp-docs-repo-tutorial/02-repository-layout-and-canonical-migration-path.md
index 9675cd52..8bfcfa3c 100644
--- a/tutorials/mcp-docs-repo-tutorial/02-repository-layout-and-canonical-migration-path.md
+++ b/tutorials/mcp-docs-repo-tutorial/02-repository-layout-and-canonical-migration-path.md
@@ -638,7 +638,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started and Archive Context](01-getting-started-and-archive-context.md)
 - [Next Chapter: Chapter 3: Quickstart Flows: User, Server, and Client](03-quickstart-flows-user-server-and-client.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-docs-repo-tutorial/03-quickstart-flows-user-server-and-client.md b/tutorials/mcp-docs-repo-tutorial/03-quickstart-flows-user-server-and-client.md
index ed321e27..88e5eb88 100644
--- a/tutorials/mcp-docs-repo-tutorial/03-quickstart-flows-user-server-and-client.md
+++ b/tutorials/mcp-docs-repo-tutorial/03-quickstart-flows-user-server-and-client.md
@@ -641,7 +641,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Repository Layout and Canonical Migration Path](02-repository-layout-and-canonical-migration-path.md)
 - [Next Chapter: Chapter 4: Core Concepts: Architecture, Tools, Resources, Prompts](04-core-concepts-architecture-tools-resources-prompts.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-docs-repo-tutorial/04-core-concepts-architecture-tools-resources-prompts.md b/tutorials/mcp-docs-repo-tutorial/04-core-concepts-architecture-tools-resources-prompts.md
index daea69e9..4fd9f86c 100644
--- a/tutorials/mcp-docs-repo-tutorial/04-core-concepts-architecture-tools-resources-prompts.md
+++ b/tutorials/mcp-docs-repo-tutorial/04-core-concepts-architecture-tools-resources-prompts.md
@@ -642,7 +642,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Quickstart Flows: User, Server, and Client](03-quickstart-flows-user-server-and-client.md)
 - [Next Chapter: Chapter 5: Advanced Concepts: Transports, Sampling, and Roots](05-advanced-concepts-transports-sampling-and-roots.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-docs-repo-tutorial/05-advanced-concepts-transports-sampling-and-roots.md b/tutorials/mcp-docs-repo-tutorial/05-advanced-concepts-transports-sampling-and-roots.md
index e097a2c4..63eff727 100644
--- a/tutorials/mcp-docs-repo-tutorial/05-advanced-concepts-transports-sampling-and-roots.md
+++ b/tutorials/mcp-docs-repo-tutorial/05-advanced-concepts-transports-sampling-and-roots.md
@@ -641,7 +641,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Core Concepts: Architecture, Tools, Resources, Prompts](04-core-concepts-architecture-tools-resources-prompts.md)
 - [Next Chapter: Chapter 6: Tooling Docs: Inspector and Debugging](06-tooling-docs-inspector-and-debugging.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-docs-repo-tutorial/06-tooling-docs-inspector-and-debugging.md b/tutorials/mcp-docs-repo-tutorial/06-tooling-docs-inspector-and-debugging.md
index 69e77eb1..66f94e71 100644
--- a/tutorials/mcp-docs-repo-tutorial/06-tooling-docs-inspector-and-debugging.md
+++ b/tutorials/mcp-docs-repo-tutorial/06-tooling-docs-inspector-and-debugging.md
@@ -640,7 +640,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Advanced Concepts: Transports, Sampling, and Roots](05-advanced-concepts-transports-sampling-and-roots.md)
 - [Next Chapter: Chapter 7: Tutorial Assets and Client Ecosystem Matrix](07-tutorial-assets-and-client-ecosystem-matrix.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-docs-repo-tutorial/07-tutorial-assets-and-client-ecosystem-matrix.md b/tutorials/mcp-docs-repo-tutorial/07-tutorial-assets-and-client-ecosystem-matrix.md
index 0e55986d..afdc4014 100644
--- a/tutorials/mcp-docs-repo-tutorial/07-tutorial-assets-and-client-ecosystem-matrix.md
+++ b/tutorials/mcp-docs-repo-tutorial/07-tutorial-assets-and-client-ecosystem-matrix.md
@@ -641,7 +641,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Tooling Docs: Inspector and Debugging](06-tooling-docs-inspector-and-debugging.md)
 - [Next Chapter: Chapter 8: Contribution Governance and Documentation Operations](08-contribution-governance-and-documentation-operations.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-docs-repo-tutorial/08-contribution-governance-and-documentation-operations.md b/tutorials/mcp-docs-repo-tutorial/08-contribution-governance-and-documentation-operations.md
index 3717a2fb..051ade6c 100644
--- a/tutorials/mcp-docs-repo-tutorial/08-contribution-governance-and-documentation-operations.md
+++ b/tutorials/mcp-docs-repo-tutorial/08-contribution-governance-and-documentation-operations.md
@@ -28,7 +28,7 @@ This chapter defines governance controls for teams maintaining internal MCP docs
 
 You now have a governance model for documentation operations across archived and active MCP sources.
 
-Return to the [MCP Docs Repo Tutorial index](index.md).
+Return to the [MCP Docs Repo Tutorial index](README.md).
 
 ## Depth Expansion Playbook
 
@@ -640,7 +640,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Tutorial Assets and Client Ecosystem Matrix](07-tutorial-assets-and-client-ecosystem-matrix.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/mcp-docs-repo-tutorial/index.md b/tutorials/mcp-docs-repo-tutorial/README.md
similarity index 100%
rename from tutorials/mcp-docs-repo-tutorial/index.md
rename to tutorials/mcp-docs-repo-tutorial/README.md
diff --git a/tutorials/mcp-ext-apps-tutorial/01-getting-started-and-spec-orientation.md b/tutorials/mcp-ext-apps-tutorial/01-getting-started-and-spec-orientation.md
index 7f803be5..2692f0e8 100644
--- a/tutorials/mcp-ext-apps-tutorial/01-getting-started-and-spec-orientation.md
+++ b/tutorials/mcp-ext-apps-tutorial/01-getting-started-and-spec-orientation.md
@@ -641,7 +641,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: MCP Apps Architecture and Lifecycle](02-mcp-apps-architecture-and-lifecycle.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/mcp-ext-apps-tutorial/02-mcp-apps-architecture-and-lifecycle.md b/tutorials/mcp-ext-apps-tutorial/02-mcp-apps-architecture-and-lifecycle.md
index 014640fd..04943ed2 100644
--- a/tutorials/mcp-ext-apps-tutorial/02-mcp-apps-architecture-and-lifecycle.md
+++ b/tutorials/mcp-ext-apps-tutorial/02-mcp-apps-architecture-and-lifecycle.md
@@ -636,7 +636,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started and Spec Orientation](01-getting-started-and-spec-orientation.md)
 - [Next Chapter: Chapter 3: App SDK: UI Resources and Tool Linkage](03-app-sdk-ui-resources-and-tool-linkage.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-ext-apps-tutorial/03-app-sdk-ui-resources-and-tool-linkage.md b/tutorials/mcp-ext-apps-tutorial/03-app-sdk-ui-resources-and-tool-linkage.md
index 0f025a41..2389439b 100644
--- a/tutorials/mcp-ext-apps-tutorial/03-app-sdk-ui-resources-and-tool-linkage.md
+++ b/tutorials/mcp-ext-apps-tutorial/03-app-sdk-ui-resources-and-tool-linkage.md
@@ -636,7 +636,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: MCP Apps Architecture and Lifecycle](02-mcp-apps-architecture-and-lifecycle.md)
 - [Next Chapter: Chapter 4: Host Bridge and Context Management](04-host-bridge-and-context-management.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-ext-apps-tutorial/04-host-bridge-and-context-management.md b/tutorials/mcp-ext-apps-tutorial/04-host-bridge-and-context-management.md
index 62b4f263..6166a5ac 100644
--- a/tutorials/mcp-ext-apps-tutorial/04-host-bridge-and-context-management.md
+++ b/tutorials/mcp-ext-apps-tutorial/04-host-bridge-and-context-management.md
@@ -638,7 +638,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: App SDK: UI Resources and Tool Linkage](03-app-sdk-ui-resources-and-tool-linkage.md)
 - [Next Chapter: Chapter 5: Patterns, Security, and Performance](05-patterns-security-and-performance.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-ext-apps-tutorial/05-patterns-security-and-performance.md b/tutorials/mcp-ext-apps-tutorial/05-patterns-security-and-performance.md
index 99a40f87..45b02ee4 100644
--- a/tutorials/mcp-ext-apps-tutorial/05-patterns-security-and-performance.md
+++ b/tutorials/mcp-ext-apps-tutorial/05-patterns-security-and-performance.md
@@ -637,7 +637,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Host Bridge and Context Management](04-host-bridge-and-context-management.md)
 - [Next Chapter: Chapter 6: Testing, Local Hosts, and Integration Workflows](06-testing-local-hosts-and-integration-workflows.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-ext-apps-tutorial/06-testing-local-hosts-and-integration-workflows.md b/tutorials/mcp-ext-apps-tutorial/06-testing-local-hosts-and-integration-workflows.md
index 78f60e6f..f00da144 100644
--- a/tutorials/mcp-ext-apps-tutorial/06-testing-local-hosts-and-integration-workflows.md
+++ b/tutorials/mcp-ext-apps-tutorial/06-testing-local-hosts-and-integration-workflows.md
@@ -637,7 +637,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Patterns, Security, and Performance](05-patterns-security-and-performance.md)
 - [Next Chapter: Chapter 7: Agent Skills and OpenAI Apps Migration](07-agent-skills-and-openai-apps-migration.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-ext-apps-tutorial/07-agent-skills-and-openai-apps-migration.md b/tutorials/mcp-ext-apps-tutorial/07-agent-skills-and-openai-apps-migration.md
index fbeeb1ee..0d911fd1 100644
--- a/tutorials/mcp-ext-apps-tutorial/07-agent-skills-and-openai-apps-migration.md
+++ b/tutorials/mcp-ext-apps-tutorial/07-agent-skills-and-openai-apps-migration.md
@@ -636,7 +636,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Testing, Local Hosts, and Integration Workflows](06-testing-local-hosts-and-integration-workflows.md)
 - [Next Chapter: Chapter 8: Release Strategy and Production Operations](08-release-strategy-and-production-operations.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-ext-apps-tutorial/08-release-strategy-and-production-operations.md b/tutorials/mcp-ext-apps-tutorial/08-release-strategy-and-production-operations.md
index b9a53169..3f43247d 100644
--- a/tutorials/mcp-ext-apps-tutorial/08-release-strategy-and-production-operations.md
+++ b/tutorials/mcp-ext-apps-tutorial/08-release-strategy-and-production-operations.md
@@ -38,7 +38,7 @@ This chapter defines long-term operating practices for MCP Apps-based systems.
 
 You now have a production operations framework for MCP Apps across app and host stacks.
 
-Return to the [MCP Ext Apps Tutorial index](index.md).
+Return to the [MCP Ext Apps Tutorial index](README.md).
 
 ## Depth Expansion Playbook
 
@@ -638,7 +638,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Agent Skills and OpenAI Apps Migration](07-agent-skills-and-openai-apps-migration.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/mcp-ext-apps-tutorial/index.md b/tutorials/mcp-ext-apps-tutorial/README.md
similarity index 100%
rename from tutorials/mcp-ext-apps-tutorial/index.md
rename to tutorials/mcp-ext-apps-tutorial/README.md
diff --git a/tutorials/mcp-go-sdk-tutorial/01-getting-started-and-sdk-package-map.md b/tutorials/mcp-go-sdk-tutorial/01-getting-started-and-sdk-package-map.md
index 7c947c02..4fe69a55 100644
--- a/tutorials/mcp-go-sdk-tutorial/01-getting-started-and-sdk-package-map.md
+++ b/tutorials/mcp-go-sdk-tutorial/01-getting-started-and-sdk-package-map.md
@@ -639,7 +639,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Client/Server Lifecycle and Session Management](02-client-server-lifecycle-and-session-management.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/mcp-go-sdk-tutorial/02-client-server-lifecycle-and-session-management.md b/tutorials/mcp-go-sdk-tutorial/02-client-server-lifecycle-and-session-management.md
index 63617575..c4e6c7b4 100644
--- a/tutorials/mcp-go-sdk-tutorial/02-client-server-lifecycle-and-session-management.md
+++ b/tutorials/mcp-go-sdk-tutorial/02-client-server-lifecycle-and-session-management.md
@@ -643,7 +643,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started and SDK Package Map](01-getting-started-and-sdk-package-map.md)
 - [Next Chapter: Chapter 3: Transports: stdio, Streamable HTTP, and Custom Flows](03-transports-stdio-streamable-http-and-custom-flows.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-go-sdk-tutorial/03-transports-stdio-streamable-http-and-custom-flows.md b/tutorials/mcp-go-sdk-tutorial/03-transports-stdio-streamable-http-and-custom-flows.md
index e9f90173..3ced4581 100644
--- a/tutorials/mcp-go-sdk-tutorial/03-transports-stdio-streamable-http-and-custom-flows.md
+++ b/tutorials/mcp-go-sdk-tutorial/03-transports-stdio-streamable-http-and-custom-flows.md
@@ -643,7 +643,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Client/Server Lifecycle and Session Management](02-client-server-lifecycle-and-session-management.md)
 - [Next Chapter: Chapter 4: Building Tools, Resources, and Prompts in Go](04-building-tools-resources-and-prompts-in-go.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-go-sdk-tutorial/04-building-tools-resources-and-prompts-in-go.md b/tutorials/mcp-go-sdk-tutorial/04-building-tools-resources-and-prompts-in-go.md
index 6011fc60..3939cae5 100644
--- a/tutorials/mcp-go-sdk-tutorial/04-building-tools-resources-and-prompts-in-go.md
+++ b/tutorials/mcp-go-sdk-tutorial/04-building-tools-resources-and-prompts-in-go.md
@@ -643,7 +643,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Transports: stdio, Streamable HTTP, and Custom Flows](03-transports-stdio-streamable-http-and-custom-flows.md)
 - [Next Chapter: Chapter 5: Client Capabilities: Roots, Sampling, and Elicitation](05-client-capabilities-roots-sampling-and-elicitation.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-go-sdk-tutorial/05-client-capabilities-roots-sampling-and-elicitation.md b/tutorials/mcp-go-sdk-tutorial/05-client-capabilities-roots-sampling-and-elicitation.md
index 9e7bebe3..295994cd 100644
--- a/tutorials/mcp-go-sdk-tutorial/05-client-capabilities-roots-sampling-and-elicitation.md
+++ b/tutorials/mcp-go-sdk-tutorial/05-client-capabilities-roots-sampling-and-elicitation.md
@@ -643,7 +643,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Building Tools, Resources, and Prompts in Go](04-building-tools-resources-and-prompts-in-go.md)
 - [Next Chapter: Chapter 6: Auth, Security, and Runtime Hardening](06-auth-security-and-runtime-hardening.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-go-sdk-tutorial/06-auth-security-and-runtime-hardening.md b/tutorials/mcp-go-sdk-tutorial/06-auth-security-and-runtime-hardening.md
index 413e4707..9994ed5b 100644
--- a/tutorials/mcp-go-sdk-tutorial/06-auth-security-and-runtime-hardening.md
+++ b/tutorials/mcp-go-sdk-tutorial/06-auth-security-and-runtime-hardening.md
@@ -633,7 +633,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Client Capabilities: Roots, Sampling, and Elicitation](05-client-capabilities-roots-sampling-and-elicitation.md)
 - [Next Chapter: Chapter 7: Testing, Troubleshooting, and Rough Edges](07-testing-troubleshooting-and-rough-edges.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-go-sdk-tutorial/07-testing-troubleshooting-and-rough-edges.md b/tutorials/mcp-go-sdk-tutorial/07-testing-troubleshooting-and-rough-edges.md
index 447b7254..b8678112 100644
--- a/tutorials/mcp-go-sdk-tutorial/07-testing-troubleshooting-and-rough-edges.md
+++ b/tutorials/mcp-go-sdk-tutorial/07-testing-troubleshooting-and-rough-edges.md
@@ -642,7 +642,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Auth, Security, and Runtime Hardening](06-auth-security-and-runtime-hardening.md)
 - [Next Chapter: Chapter 8: Conformance, Operations, and Upgrade Strategy](08-conformance-operations-and-upgrade-strategy.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-go-sdk-tutorial/08-conformance-operations-and-upgrade-strategy.md b/tutorials/mcp-go-sdk-tutorial/08-conformance-operations-and-upgrade-strategy.md
index f419d8de..f73a28e0 100644
--- a/tutorials/mcp-go-sdk-tutorial/08-conformance-operations-and-upgrade-strategy.md
+++ b/tutorials/mcp-go-sdk-tutorial/08-conformance-operations-and-upgrade-strategy.md
@@ -633,7 +633,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Testing, Troubleshooting, and Rough Edges](07-testing-troubleshooting-and-rough-edges.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/mcp-go-sdk-tutorial/index.md b/tutorials/mcp-go-sdk-tutorial/README.md
similarity index 100%
rename from tutorials/mcp-go-sdk-tutorial/index.md
rename to tutorials/mcp-go-sdk-tutorial/README.md
diff --git a/tutorials/mcp-inspector-tutorial/01-getting-started.md b/tutorials/mcp-inspector-tutorial/01-getting-started.md
index 13ea1997..fa532127 100644
--- a/tutorials/mcp-inspector-tutorial/01-getting-started.md
+++ b/tutorials/mcp-inspector-tutorial/01-getting-started.md
@@ -635,7 +635,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Architecture, Transports, and Session Model](02-architecture-transports-and-session-model.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/mcp-inspector-tutorial/02-architecture-transports-and-session-model.md b/tutorials/mcp-inspector-tutorial/02-architecture-transports-and-session-model.md
index 6df2e7e1..2acd0b2e 100644
--- a/tutorials/mcp-inspector-tutorial/02-architecture-transports-and-session-model.md
+++ b/tutorials/mcp-inspector-tutorial/02-architecture-transports-and-session-model.md
@@ -637,7 +637,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started](01-getting-started.md)
 - [Next Chapter: Chapter 3: UI Debugging Workflows: Tools, Resources, Prompts](03-ui-debugging-workflows-tools-resources-prompts.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-inspector-tutorial/03-ui-debugging-workflows-tools-resources-prompts.md b/tutorials/mcp-inspector-tutorial/03-ui-debugging-workflows-tools-resources-prompts.md
index 4cae0e53..e16ed728 100644
--- a/tutorials/mcp-inspector-tutorial/03-ui-debugging-workflows-tools-resources-prompts.md
+++ b/tutorials/mcp-inspector-tutorial/03-ui-debugging-workflows-tools-resources-prompts.md
@@ -635,7 +635,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Architecture, Transports, and Session Model](02-architecture-transports-and-session-model.md)
 - [Next Chapter: Chapter 4: CLI Mode, Automation, and CI Loops](04-cli-mode-automation-and-ci-loops.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-inspector-tutorial/04-cli-mode-automation-and-ci-loops.md b/tutorials/mcp-inspector-tutorial/04-cli-mode-automation-and-ci-loops.md
index 3dd055f2..d0c7d075 100644
--- a/tutorials/mcp-inspector-tutorial/04-cli-mode-automation-and-ci-loops.md
+++ b/tutorials/mcp-inspector-tutorial/04-cli-mode-automation-and-ci-loops.md
@@ -636,7 +636,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: UI Debugging Workflows: Tools, Resources, Prompts](03-ui-debugging-workflows-tools-resources-prompts.md)
 - [Next Chapter: Chapter 5: Security, Auth, and Network Hardening](05-security-auth-and-network-hardening.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-inspector-tutorial/05-security-auth-and-network-hardening.md b/tutorials/mcp-inspector-tutorial/05-security-auth-and-network-hardening.md
index 6c6f9e09..2182219e 100644
--- a/tutorials/mcp-inspector-tutorial/05-security-auth-and-network-hardening.md
+++ b/tutorials/mcp-inspector-tutorial/05-security-auth-and-network-hardening.md
@@ -636,7 +636,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: CLI Mode, Automation, and CI Loops](04-cli-mode-automation-and-ci-loops.md)
 - [Next Chapter: Chapter 6: Configuration, Timeouts, and Runtime Tuning](06-configuration-timeouts-and-runtime-tuning.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-inspector-tutorial/06-configuration-timeouts-and-runtime-tuning.md b/tutorials/mcp-inspector-tutorial/06-configuration-timeouts-and-runtime-tuning.md
index d4eedf57..65e1acc1 100644
--- a/tutorials/mcp-inspector-tutorial/06-configuration-timeouts-and-runtime-tuning.md
+++ b/tutorials/mcp-inspector-tutorial/06-configuration-timeouts-and-runtime-tuning.md
@@ -636,7 +636,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Security, Auth, and Network Hardening](05-security-auth-and-network-hardening.md)
 - [Next Chapter: Chapter 7: Inspector in Server Development Lifecycle](07-inspector-in-server-development-lifecycle.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-inspector-tutorial/07-inspector-in-server-development-lifecycle.md b/tutorials/mcp-inspector-tutorial/07-inspector-in-server-development-lifecycle.md
index e5ae505d..0fe93f19 100644
--- a/tutorials/mcp-inspector-tutorial/07-inspector-in-server-development-lifecycle.md
+++ b/tutorials/mcp-inspector-tutorial/07-inspector-in-server-development-lifecycle.md
@@ -637,7 +637,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Configuration, Timeouts, and Runtime Tuning](06-configuration-timeouts-and-runtime-tuning.md)
 - [Next Chapter: Chapter 8: Production Ops, Testing, and Contribution](08-production-ops-testing-and-contribution.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-inspector-tutorial/08-production-ops-testing-and-contribution.md b/tutorials/mcp-inspector-tutorial/08-production-ops-testing-and-contribution.md
index 70bb985e..368fee30 100644
--- a/tutorials/mcp-inspector-tutorial/08-production-ops-testing-and-contribution.md
+++ b/tutorials/mcp-inspector-tutorial/08-production-ops-testing-and-contribution.md
@@ -630,7 +630,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Inspector in Server Development Lifecycle](07-inspector-in-server-development-lifecycle.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/mcp-inspector-tutorial/index.md b/tutorials/mcp-inspector-tutorial/README.md
similarity index 100%
rename from tutorials/mcp-inspector-tutorial/index.md
rename to tutorials/mcp-inspector-tutorial/README.md
diff --git a/tutorials/mcp-java-sdk-tutorial/01-getting-started-and-module-selection.md b/tutorials/mcp-java-sdk-tutorial/01-getting-started-and-module-selection.md
index 13e2e07e..93e9807e 100644
--- a/tutorials/mcp-java-sdk-tutorial/01-getting-started-and-module-selection.md
+++ b/tutorials/mcp-java-sdk-tutorial/01-getting-started-and-module-selection.md
@@ -632,7 +632,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: SDK Architecture: Reactive Model and JSON Layer](02-sdk-architecture-reactive-model-and-json-layer.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/mcp-java-sdk-tutorial/02-sdk-architecture-reactive-model-and-json-layer.md b/tutorials/mcp-java-sdk-tutorial/02-sdk-architecture-reactive-model-and-json-layer.md
index 2f03f669..9fa0447c 100644
--- a/tutorials/mcp-java-sdk-tutorial/02-sdk-architecture-reactive-model-and-json-layer.md
+++ b/tutorials/mcp-java-sdk-tutorial/02-sdk-architecture-reactive-model-and-json-layer.md
@@ -643,7 +643,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started and Module Selection](01-getting-started-and-module-selection.md)
 - [Next Chapter: Chapter 3: Client Transports and Connection Strategy](03-client-transports-and-connection-strategy.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-java-sdk-tutorial/03-client-transports-and-connection-strategy.md b/tutorials/mcp-java-sdk-tutorial/03-client-transports-and-connection-strategy.md
index ceffc3d2..f00b21b4 100644
--- a/tutorials/mcp-java-sdk-tutorial/03-client-transports-and-connection-strategy.md
+++ b/tutorials/mcp-java-sdk-tutorial/03-client-transports-and-connection-strategy.md
@@ -638,7 +638,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: SDK Architecture: Reactive Model and JSON Layer](02-sdk-architecture-reactive-model-and-json-layer.md)
 - [Next Chapter: Chapter 4: Server Transports and Deployment Patterns](04-server-transports-and-deployment-patterns.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-java-sdk-tutorial/04-server-transports-and-deployment-patterns.md b/tutorials/mcp-java-sdk-tutorial/04-server-transports-and-deployment-patterns.md
index 4bc85dcf..0f9d22d8 100644
--- a/tutorials/mcp-java-sdk-tutorial/04-server-transports-and-deployment-patterns.md
+++ b/tutorials/mcp-java-sdk-tutorial/04-server-transports-and-deployment-patterns.md
@@ -637,7 +637,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Client Transports and Connection Strategy](03-client-transports-and-connection-strategy.md)
 - [Next Chapter: Chapter 5: Tools, Resources, Prompts, and Schema Validation](05-tools-resources-prompts-and-schema-validation.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-java-sdk-tutorial/05-tools-resources-prompts-and-schema-validation.md b/tutorials/mcp-java-sdk-tutorial/05-tools-resources-prompts-and-schema-validation.md
index 75294c28..ff599d90 100644
--- a/tutorials/mcp-java-sdk-tutorial/05-tools-resources-prompts-and-schema-validation.md
+++ b/tutorials/mcp-java-sdk-tutorial/05-tools-resources-prompts-and-schema-validation.md
@@ -636,7 +636,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Server Transports and Deployment Patterns](04-server-transports-and-deployment-patterns.md)
 - [Next Chapter: Chapter 6: Security, Authorization, and Runtime Controls](06-security-authorization-and-runtime-controls.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-java-sdk-tutorial/06-security-authorization-and-runtime-controls.md b/tutorials/mcp-java-sdk-tutorial/06-security-authorization-and-runtime-controls.md
index 8e29622c..93495767 100644
--- a/tutorials/mcp-java-sdk-tutorial/06-security-authorization-and-runtime-controls.md
+++ b/tutorials/mcp-java-sdk-tutorial/06-security-authorization-and-runtime-controls.md
@@ -637,7 +637,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Tools, Resources, Prompts, and Schema Validation](05-tools-resources-prompts-and-schema-validation.md)
 - [Next Chapter: Chapter 7: Conformance Testing and Quality Workflows](07-conformance-testing-and-quality-workflows.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-java-sdk-tutorial/07-conformance-testing-and-quality-workflows.md b/tutorials/mcp-java-sdk-tutorial/07-conformance-testing-and-quality-workflows.md
index ac89a53a..828a1b25 100644
--- a/tutorials/mcp-java-sdk-tutorial/07-conformance-testing-and-quality-workflows.md
+++ b/tutorials/mcp-java-sdk-tutorial/07-conformance-testing-and-quality-workflows.md
@@ -636,7 +636,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Security, Authorization, and Runtime Controls](06-security-authorization-and-runtime-controls.md)
 - [Next Chapter: Chapter 8: Spring Integration and Upgrade Strategy](08-spring-integration-and-upgrade-strategy.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-java-sdk-tutorial/08-spring-integration-and-upgrade-strategy.md b/tutorials/mcp-java-sdk-tutorial/08-spring-integration-and-upgrade-strategy.md
index 50c79df8..bfca91ca 100644
--- a/tutorials/mcp-java-sdk-tutorial/08-spring-integration-and-upgrade-strategy.md
+++ b/tutorials/mcp-java-sdk-tutorial/08-spring-integration-and-upgrade-strategy.md
@@ -637,7 +637,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Conformance Testing and Quality Workflows](07-conformance-testing-and-quality-workflows.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/mcp-java-sdk-tutorial/index.md b/tutorials/mcp-java-sdk-tutorial/README.md
similarity index 100%
rename from tutorials/mcp-java-sdk-tutorial/index.md
rename to tutorials/mcp-java-sdk-tutorial/README.md
diff --git a/tutorials/mcp-kotlin-sdk-tutorial/01-getting-started-and-module-selection.md b/tutorials/mcp-kotlin-sdk-tutorial/01-getting-started-and-module-selection.md
index 34c57041..1c96a0cf 100644
--- a/tutorials/mcp-kotlin-sdk-tutorial/01-getting-started-and-module-selection.md
+++ b/tutorials/mcp-kotlin-sdk-tutorial/01-getting-started-and-module-selection.md
@@ -632,7 +632,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Core Protocol Model and Module Architecture](02-core-protocol-model-and-module-architecture.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/mcp-kotlin-sdk-tutorial/02-core-protocol-model-and-module-architecture.md b/tutorials/mcp-kotlin-sdk-tutorial/02-core-protocol-model-and-module-architecture.md
index 83acf3fe..069b22c3 100644
--- a/tutorials/mcp-kotlin-sdk-tutorial/02-core-protocol-model-and-module-architecture.md
+++ b/tutorials/mcp-kotlin-sdk-tutorial/02-core-protocol-model-and-module-architecture.md
@@ -632,7 +632,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started and Module Selection](01-getting-started-and-module-selection.md)
 - [Next Chapter: Chapter 3: Client Runtime and Capability Negotiation](03-client-runtime-and-capability-negotiation.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-kotlin-sdk-tutorial/03-client-runtime-and-capability-negotiation.md b/tutorials/mcp-kotlin-sdk-tutorial/03-client-runtime-and-capability-negotiation.md
index f3d73bb9..b6323d3f 100644
--- a/tutorials/mcp-kotlin-sdk-tutorial/03-client-runtime-and-capability-negotiation.md
+++ b/tutorials/mcp-kotlin-sdk-tutorial/03-client-runtime-and-capability-negotiation.md
@@ -643,7 +643,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Core Protocol Model and Module Architecture](02-core-protocol-model-and-module-architecture.md)
 - [Next Chapter: Chapter 4: Server Runtime, Primitives, and Feature Registration](04-server-runtime-primitives-and-feature-registration.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-kotlin-sdk-tutorial/04-server-runtime-primitives-and-feature-registration.md b/tutorials/mcp-kotlin-sdk-tutorial/04-server-runtime-primitives-and-feature-registration.md
index 61c482a6..b54d7877 100644
--- a/tutorials/mcp-kotlin-sdk-tutorial/04-server-runtime-primitives-and-feature-registration.md
+++ b/tutorials/mcp-kotlin-sdk-tutorial/04-server-runtime-primitives-and-feature-registration.md
@@ -632,7 +632,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Client Runtime and Capability Negotiation](03-client-runtime-and-capability-negotiation.md)
 - [Next Chapter: Chapter 5: Transports: stdio, Streamable HTTP, SSE, and WebSocket](05-transports-stdio-streamable-http-sse-and-websocket.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-kotlin-sdk-tutorial/05-transports-stdio-streamable-http-sse-and-websocket.md b/tutorials/mcp-kotlin-sdk-tutorial/05-transports-stdio-streamable-http-sse-and-websocket.md
index a5305079..f2eaf57b 100644
--- a/tutorials/mcp-kotlin-sdk-tutorial/05-transports-stdio-streamable-http-sse-and-websocket.md
+++ b/tutorials/mcp-kotlin-sdk-tutorial/05-transports-stdio-streamable-http-sse-and-websocket.md
@@ -632,7 +632,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Server Runtime, Primitives, and Feature Registration](04-server-runtime-primitives-and-feature-registration.md)
 - [Next Chapter: Chapter 6: Advanced Client Features: Roots, Sampling, and Elicitation](06-advanced-client-features-roots-sampling-and-elicitation.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-kotlin-sdk-tutorial/06-advanced-client-features-roots-sampling-and-elicitation.md b/tutorials/mcp-kotlin-sdk-tutorial/06-advanced-client-features-roots-sampling-and-elicitation.md
index 87326517..9ffbd628 100644
--- a/tutorials/mcp-kotlin-sdk-tutorial/06-advanced-client-features-roots-sampling-and-elicitation.md
+++ b/tutorials/mcp-kotlin-sdk-tutorial/06-advanced-client-features-roots-sampling-and-elicitation.md
@@ -636,7 +636,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Transports: stdio, Streamable HTTP, SSE, and WebSocket](05-transports-stdio-streamable-http-sse-and-websocket.md)
 - [Next Chapter: Chapter 7: Testing, Conformance, and Operational Diagnostics](07-testing-conformance-and-operational-diagnostics.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-kotlin-sdk-tutorial/07-testing-conformance-and-operational-diagnostics.md b/tutorials/mcp-kotlin-sdk-tutorial/07-testing-conformance-and-operational-diagnostics.md
index 73f882d4..a9ec4972 100644
--- a/tutorials/mcp-kotlin-sdk-tutorial/07-testing-conformance-and-operational-diagnostics.md
+++ b/tutorials/mcp-kotlin-sdk-tutorial/07-testing-conformance-and-operational-diagnostics.md
@@ -637,7 +637,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Advanced Client Features: Roots, Sampling, and Elicitation](06-advanced-client-features-roots-sampling-and-elicitation.md)
 - [Next Chapter: Chapter 8: Release Strategy and Production Rollout](08-release-strategy-and-production-rollout.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-kotlin-sdk-tutorial/08-release-strategy-and-production-rollout.md b/tutorials/mcp-kotlin-sdk-tutorial/08-release-strategy-and-production-rollout.md
index 38e3aa09..6c4065f3 100644
--- a/tutorials/mcp-kotlin-sdk-tutorial/08-release-strategy-and-production-rollout.md
+++ b/tutorials/mcp-kotlin-sdk-tutorial/08-release-strategy-and-production-rollout.md
@@ -39,7 +39,7 @@ This chapter defines how to keep Kotlin MCP services production-ready through pr
 
 You now have a production rollout framework for operating Kotlin MCP systems with lower drift and clearer upgrade discipline.
 
-Return to the [MCP Kotlin SDK Tutorial index](index.md).
+Return to the [MCP Kotlin SDK Tutorial index](README.md).
 
 ## Depth Expansion Playbook
 
@@ -639,7 +639,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Testing, Conformance, and Operational Diagnostics](07-testing-conformance-and-operational-diagnostics.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/mcp-kotlin-sdk-tutorial/index.md b/tutorials/mcp-kotlin-sdk-tutorial/README.md
similarity index 100%
rename from tutorials/mcp-kotlin-sdk-tutorial/index.md
rename to tutorials/mcp-kotlin-sdk-tutorial/README.md
diff --git a/tutorials/mcp-php-sdk-tutorial/01-getting-started-and-experimental-baseline.md b/tutorials/mcp-php-sdk-tutorial/01-getting-started-and-experimental-baseline.md
index 828fe4cf..4c3b7e4e 100644
--- a/tutorials/mcp-php-sdk-tutorial/01-getting-started-and-experimental-baseline.md
+++ b/tutorials/mcp-php-sdk-tutorial/01-getting-started-and-experimental-baseline.md
@@ -636,7 +636,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Server Builder and Capability Registration](02-server-builder-and-capability-registration.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/mcp-php-sdk-tutorial/02-server-builder-and-capability-registration.md b/tutorials/mcp-php-sdk-tutorial/02-server-builder-and-capability-registration.md
index 5ac54fda..f5fc4467 100644
--- a/tutorials/mcp-php-sdk-tutorial/02-server-builder-and-capability-registration.md
+++ b/tutorials/mcp-php-sdk-tutorial/02-server-builder-and-capability-registration.md
@@ -643,7 +643,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started and Experimental Baseline](01-getting-started-and-experimental-baseline.md)
 - [Next Chapter: Chapter 3: MCP Elements: Tools, Resources, Prompts, and Schemas](03-mcp-elements-tools-resources-prompts-and-schemas.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-php-sdk-tutorial/03-mcp-elements-tools-resources-prompts-and-schemas.md b/tutorials/mcp-php-sdk-tutorial/03-mcp-elements-tools-resources-prompts-and-schemas.md
index 424c777a..b34fbc48 100644
--- a/tutorials/mcp-php-sdk-tutorial/03-mcp-elements-tools-resources-prompts-and-schemas.md
+++ b/tutorials/mcp-php-sdk-tutorial/03-mcp-elements-tools-resources-prompts-and-schemas.md
@@ -632,7 +632,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Server Builder and Capability Registration](02-server-builder-and-capability-registration.md)
 - [Next Chapter: Chapter 4: Discovery, Manual Registration, and Caching](04-discovery-manual-registration-and-caching.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-php-sdk-tutorial/04-discovery-manual-registration-and-caching.md b/tutorials/mcp-php-sdk-tutorial/04-discovery-manual-registration-and-caching.md
index 78180670..e459752a 100644
--- a/tutorials/mcp-php-sdk-tutorial/04-discovery-manual-registration-and-caching.md
+++ b/tutorials/mcp-php-sdk-tutorial/04-discovery-manual-registration-and-caching.md
@@ -643,7 +643,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: MCP Elements: Tools, Resources, Prompts, and Schemas](03-mcp-elements-tools-resources-prompts-and-schemas.md)
 - [Next Chapter: Chapter 5: Transports: STDIO and Streamable HTTP](05-transports-stdio-and-streamable-http.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-php-sdk-tutorial/05-transports-stdio-and-streamable-http.md b/tutorials/mcp-php-sdk-tutorial/05-transports-stdio-and-streamable-http.md
index 23c607f0..4eb1afac 100644
--- a/tutorials/mcp-php-sdk-tutorial/05-transports-stdio-and-streamable-http.md
+++ b/tutorials/mcp-php-sdk-tutorial/05-transports-stdio-and-streamable-http.md
@@ -642,7 +642,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Discovery, Manual Registration, and Caching](04-discovery-manual-registration-and-caching.md)
 - [Next Chapter: Chapter 6: Client Communication: Sampling, Logging, and Progress](06-client-communication-sampling-logging-and-progress.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-php-sdk-tutorial/06-client-communication-sampling-logging-and-progress.md b/tutorials/mcp-php-sdk-tutorial/06-client-communication-sampling-logging-and-progress.md
index b7ce8820..5f36a2a3 100644
--- a/tutorials/mcp-php-sdk-tutorial/06-client-communication-sampling-logging-and-progress.md
+++ b/tutorials/mcp-php-sdk-tutorial/06-client-communication-sampling-logging-and-progress.md
@@ -637,7 +637,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Transports: STDIO and Streamable HTTP](05-transports-stdio-and-streamable-http.md)
 - [Next Chapter: Chapter 7: Framework Integration, Session Stores, and Dependencies](07-framework-integration-session-stores-and-dependencies.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-php-sdk-tutorial/07-framework-integration-session-stores-and-dependencies.md b/tutorials/mcp-php-sdk-tutorial/07-framework-integration-session-stores-and-dependencies.md
index 4e195235..5de2c10a 100644
--- a/tutorials/mcp-php-sdk-tutorial/07-framework-integration-session-stores-and-dependencies.md
+++ b/tutorials/mcp-php-sdk-tutorial/07-framework-integration-session-stores-and-dependencies.md
@@ -643,7 +643,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Client Communication: Sampling, Logging, and Progress](06-client-communication-sampling-logging-and-progress.md)
 - [Next Chapter: Chapter 8: Roadmap, Release Strategy, and Production Readiness](08-roadmap-release-strategy-and-production-readiness.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-php-sdk-tutorial/08-roadmap-release-strategy-and-production-readiness.md b/tutorials/mcp-php-sdk-tutorial/08-roadmap-release-strategy-and-production-readiness.md
index ba611a57..5819ab16 100644
--- a/tutorials/mcp-php-sdk-tutorial/08-roadmap-release-strategy-and-production-readiness.md
+++ b/tutorials/mcp-php-sdk-tutorial/08-roadmap-release-strategy-and-production-readiness.md
@@ -36,7 +36,7 @@ This chapter defines a roadmap-aware operations strategy for using the PHP SDK i
 
 You now have a production rollout strategy for PHP MCP implementations under active SDK evolution.
 
-Return to the [MCP PHP SDK Tutorial index](index.md).
+Return to the [MCP PHP SDK Tutorial index](README.md).
 
 ## Depth Expansion Playbook
 
@@ -636,7 +636,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Framework Integration, Session Stores, and Dependencies](07-framework-integration-session-stores-and-dependencies.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/mcp-php-sdk-tutorial/index.md b/tutorials/mcp-php-sdk-tutorial/README.md
similarity index 100%
rename from tutorials/mcp-php-sdk-tutorial/index.md
rename to tutorials/mcp-php-sdk-tutorial/README.md
diff --git a/tutorials/mcp-python-sdk-tutorial/01-getting-started.md b/tutorials/mcp-python-sdk-tutorial/01-getting-started.md
index 4bd714a0..d423f9b2 100644
--- a/tutorials/mcp-python-sdk-tutorial/01-getting-started.md
+++ b/tutorials/mcp-python-sdk-tutorial/01-getting-started.md
@@ -636,7 +636,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Core Concepts - Resources, Tools, and Prompts](02-core-concepts.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/mcp-python-sdk-tutorial/02-core-concepts.md b/tutorials/mcp-python-sdk-tutorial/02-core-concepts.md
index af69e255..ed10755e 100644
--- a/tutorials/mcp-python-sdk-tutorial/02-core-concepts.md
+++ b/tutorials/mcp-python-sdk-tutorial/02-core-concepts.md
@@ -538,7 +538,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started with MCP Python SDK](01-getting-started.md)
 - [Next Chapter: Chapter 3: Server Architecture](03-server-architecture.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-python-sdk-tutorial/03-server-architecture.md b/tutorials/mcp-python-sdk-tutorial/03-server-architecture.md
index 47c2f43c..051a4ba5 100644
--- a/tutorials/mcp-python-sdk-tutorial/03-server-architecture.md
+++ b/tutorials/mcp-python-sdk-tutorial/03-server-architecture.md
@@ -276,7 +276,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Core Concepts - Resources, Tools, and Prompts](02-core-concepts.md)
 - [Next Chapter: Chapter 4: Advanced Patterns](04-advanced-patterns.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-python-sdk-tutorial/04-advanced-patterns.md b/tutorials/mcp-python-sdk-tutorial/04-advanced-patterns.md
index a32f834c..123011df 100644
--- a/tutorials/mcp-python-sdk-tutorial/04-advanced-patterns.md
+++ b/tutorials/mcp-python-sdk-tutorial/04-advanced-patterns.md
@@ -217,7 +217,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Server Architecture](03-server-architecture.md)
 - [Next Chapter: Chapter 5: Authentication & Security](05-authentication-security.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-python-sdk-tutorial/05-authentication-security.md b/tutorials/mcp-python-sdk-tutorial/05-authentication-security.md
index 2e2d1103..b95b92f4 100644
--- a/tutorials/mcp-python-sdk-tutorial/05-authentication-security.md
+++ b/tutorials/mcp-python-sdk-tutorial/05-authentication-security.md
@@ -251,7 +251,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Advanced Patterns](04-advanced-patterns.md)
 - [Next Chapter: Chapter 6: Production Deployment](06-production-deployment.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-python-sdk-tutorial/06-production-deployment.md b/tutorials/mcp-python-sdk-tutorial/06-production-deployment.md
index 1d4f6f27..47e11fad 100644
--- a/tutorials/mcp-python-sdk-tutorial/06-production-deployment.md
+++ b/tutorials/mcp-python-sdk-tutorial/06-production-deployment.md
@@ -303,7 +303,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Authentication & Security](05-authentication-security.md)
 - [Next Chapter: Chapter 7: Client Integration](07-client-integration.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-python-sdk-tutorial/07-client-integration.md b/tutorials/mcp-python-sdk-tutorial/07-client-integration.md
index b81bb842..a660f597 100644
--- a/tutorials/mcp-python-sdk-tutorial/07-client-integration.md
+++ b/tutorials/mcp-python-sdk-tutorial/07-client-integration.md
@@ -226,7 +226,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Production Deployment](06-production-deployment.md)
 - [Next Chapter: Chapter 8: Real-World Examples](08-real-world-examples.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-python-sdk-tutorial/08-real-world-examples.md b/tutorials/mcp-python-sdk-tutorial/08-real-world-examples.md
index 24478861..234a9821 100644
--- a/tutorials/mcp-python-sdk-tutorial/08-real-world-examples.md
+++ b/tutorials/mcp-python-sdk-tutorial/08-real-world-examples.md
@@ -280,7 +280,7 @@ You now have a complete understanding of building production MCP servers:
 ---
 
 *Previous: [← Chapter 7: Client Integration](07-client-integration.md)*
-*Start: [↑ Back to Index](index.md)*
+*Start: [↑ Back to Index](README.md)*
 
 ## What Problem Does This Solve?
 
@@ -322,7 +322,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Client Integration](07-client-integration.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/mcp-python-sdk-tutorial/index.md b/tutorials/mcp-python-sdk-tutorial/README.md
similarity index 100%
rename from tutorials/mcp-python-sdk-tutorial/index.md
rename to tutorials/mcp-python-sdk-tutorial/README.md
diff --git a/tutorials/mcp-quickstart-resources-tutorial/01-getting-started-and-repository-topology.md b/tutorials/mcp-quickstart-resources-tutorial/01-getting-started-and-repository-topology.md
index c11e69db..2de9429f 100644
--- a/tutorials/mcp-quickstart-resources-tutorial/01-getting-started-and-repository-topology.md
+++ b/tutorials/mcp-quickstart-resources-tutorial/01-getting-started-and-repository-topology.md
@@ -635,7 +635,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Weather Server Patterns Across Languages](02-weather-server-patterns-across-languages.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/mcp-quickstart-resources-tutorial/02-weather-server-patterns-across-languages.md b/tutorials/mcp-quickstart-resources-tutorial/02-weather-server-patterns-across-languages.md
index 5b8c057d..2e3d0059 100644
--- a/tutorials/mcp-quickstart-resources-tutorial/02-weather-server-patterns-across-languages.md
+++ b/tutorials/mcp-quickstart-resources-tutorial/02-weather-server-patterns-across-languages.md
@@ -637,7 +637,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started and Repository Topology](01-getting-started-and-repository-topology.md)
 - [Next Chapter: Chapter 3: MCP Client Patterns and LLM Chat Loops](03-mcp-client-patterns-and-llm-chat-loops.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-quickstart-resources-tutorial/03-mcp-client-patterns-and-llm-chat-loops.md b/tutorials/mcp-quickstart-resources-tutorial/03-mcp-client-patterns-and-llm-chat-loops.md
index e487914c..9bc45ee6 100644
--- a/tutorials/mcp-quickstart-resources-tutorial/03-mcp-client-patterns-and-llm-chat-loops.md
+++ b/tutorials/mcp-quickstart-resources-tutorial/03-mcp-client-patterns-and-llm-chat-loops.md
@@ -635,7 +635,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Weather Server Patterns Across Languages](02-weather-server-patterns-across-languages.md)
 - [Next Chapter: Chapter 4: Protocol Flow and stdio Transport Behavior](04-protocol-flow-and-stdio-transport-behavior.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-quickstart-resources-tutorial/04-protocol-flow-and-stdio-transport-behavior.md b/tutorials/mcp-quickstart-resources-tutorial/04-protocol-flow-and-stdio-transport-behavior.md
index c884ce02..7eb5d694 100644
--- a/tutorials/mcp-quickstart-resources-tutorial/04-protocol-flow-and-stdio-transport-behavior.md
+++ b/tutorials/mcp-quickstart-resources-tutorial/04-protocol-flow-and-stdio-transport-behavior.md
@@ -635,7 +635,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: MCP Client Patterns and LLM Chat Loops](03-mcp-client-patterns-and-llm-chat-loops.md)
 - [Next Chapter: Chapter 5: Smoke Tests and Mock Infrastructure](05-smoke-tests-and-mock-infrastructure.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-quickstart-resources-tutorial/05-smoke-tests-and-mock-infrastructure.md b/tutorials/mcp-quickstart-resources-tutorial/05-smoke-tests-and-mock-infrastructure.md
index 15be8def..350c037a 100644
--- a/tutorials/mcp-quickstart-resources-tutorial/05-smoke-tests-and-mock-infrastructure.md
+++ b/tutorials/mcp-quickstart-resources-tutorial/05-smoke-tests-and-mock-infrastructure.md
@@ -636,7 +636,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Protocol Flow and stdio Transport Behavior](04-protocol-flow-and-stdio-transport-behavior.md)
 - [Next Chapter: Chapter 6: Cross-Language Consistency and Extension Strategy](06-cross-language-consistency-and-extension-strategy.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-quickstart-resources-tutorial/06-cross-language-consistency-and-extension-strategy.md b/tutorials/mcp-quickstart-resources-tutorial/06-cross-language-consistency-and-extension-strategy.md
index 6eaddd18..90874174 100644
--- a/tutorials/mcp-quickstart-resources-tutorial/06-cross-language-consistency-and-extension-strategy.md
+++ b/tutorials/mcp-quickstart-resources-tutorial/06-cross-language-consistency-and-extension-strategy.md
@@ -635,7 +635,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Smoke Tests and Mock Infrastructure](05-smoke-tests-and-mock-infrastructure.md)
 - [Next Chapter: Chapter 7: CI, Toolchain Setup, and Troubleshooting](07-ci-toolchain-setup-and-troubleshooting.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-quickstart-resources-tutorial/07-ci-toolchain-setup-and-troubleshooting.md b/tutorials/mcp-quickstart-resources-tutorial/07-ci-toolchain-setup-and-troubleshooting.md
index e8ce5e2c..b16ada56 100644
--- a/tutorials/mcp-quickstart-resources-tutorial/07-ci-toolchain-setup-and-troubleshooting.md
+++ b/tutorials/mcp-quickstart-resources-tutorial/07-ci-toolchain-setup-and-troubleshooting.md
@@ -640,7 +640,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Cross-Language Consistency and Extension Strategy](06-cross-language-consistency-and-extension-strategy.md)
 - [Next Chapter: Chapter 8: From Tutorial Assets to Production Systems](08-from-tutorial-assets-to-production-systems.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-quickstart-resources-tutorial/08-from-tutorial-assets-to-production-systems.md b/tutorials/mcp-quickstart-resources-tutorial/08-from-tutorial-assets-to-production-systems.md
index 7ff30db9..30ce2909 100644
--- a/tutorials/mcp-quickstart-resources-tutorial/08-from-tutorial-assets-to-production-systems.md
+++ b/tutorials/mcp-quickstart-resources-tutorial/08-from-tutorial-assets-to-production-systems.md
@@ -38,7 +38,7 @@ This chapter defines a migration path from tutorial reference code to production
 
 You now have a roadmap for evolving quickstart MCP assets into durable production systems.
 
-Return to the [MCP Quickstart Resources Tutorial index](index.md).
+Return to the [MCP Quickstart Resources Tutorial index](README.md).
 
 ## Depth Expansion Playbook
 
@@ -638,7 +638,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: CI, Toolchain Setup, and Troubleshooting](07-ci-toolchain-setup-and-troubleshooting.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/mcp-quickstart-resources-tutorial/index.md b/tutorials/mcp-quickstart-resources-tutorial/README.md
similarity index 100%
rename from tutorials/mcp-quickstart-resources-tutorial/index.md
rename to tutorials/mcp-quickstart-resources-tutorial/README.md
diff --git a/tutorials/mcp-registry-tutorial/01-getting-started-and-first-publish.md b/tutorials/mcp-registry-tutorial/01-getting-started-and-first-publish.md
index 7104790d..79b32c9b 100644
--- a/tutorials/mcp-registry-tutorial/01-getting-started-and-first-publish.md
+++ b/tutorials/mcp-registry-tutorial/01-getting-started-and-first-publish.md
@@ -644,7 +644,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Registry Architecture and Data Flow](02-registry-architecture-and-data-flow.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/mcp-registry-tutorial/02-registry-architecture-and-data-flow.md b/tutorials/mcp-registry-tutorial/02-registry-architecture-and-data-flow.md
index 86226a2b..c71e5fb6 100644
--- a/tutorials/mcp-registry-tutorial/02-registry-architecture-and-data-flow.md
+++ b/tutorials/mcp-registry-tutorial/02-registry-architecture-and-data-flow.md
@@ -642,7 +642,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started and First Publish](01-getting-started-and-first-publish.md)
 - [Next Chapter: Chapter 3: server.json Schema and Package Verification](03-server-json-schema-and-package-verification.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-registry-tutorial/03-server-json-schema-and-package-verification.md b/tutorials/mcp-registry-tutorial/03-server-json-schema-and-package-verification.md
index 309b4348..a337f5ba 100644
--- a/tutorials/mcp-registry-tutorial/03-server-json-schema-and-package-verification.md
+++ b/tutorials/mcp-registry-tutorial/03-server-json-schema-and-package-verification.md
@@ -643,7 +643,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Registry Architecture and Data Flow](02-registry-architecture-and-data-flow.md)
 - [Next Chapter: Chapter 4: Authentication Models and Namespace Ownership](04-authentication-models-and-namespace-ownership.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-registry-tutorial/04-authentication-models-and-namespace-ownership.md b/tutorials/mcp-registry-tutorial/04-authentication-models-and-namespace-ownership.md
index 70732a1e..dc269f70 100644
--- a/tutorials/mcp-registry-tutorial/04-authentication-models-and-namespace-ownership.md
+++ b/tutorials/mcp-registry-tutorial/04-authentication-models-and-namespace-ownership.md
@@ -642,7 +642,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: server.json Schema and Package Verification](03-server-json-schema-and-package-verification.md)
 - [Next Chapter: Chapter 5: API Consumption, Subregistries, and Sync Strategies](05-api-consumption-subregistries-and-sync-strategies.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-registry-tutorial/05-api-consumption-subregistries-and-sync-strategies.md b/tutorials/mcp-registry-tutorial/05-api-consumption-subregistries-and-sync-strategies.md
index 2d4266cd..9dd04309 100644
--- a/tutorials/mcp-registry-tutorial/05-api-consumption-subregistries-and-sync-strategies.md
+++ b/tutorials/mcp-registry-tutorial/05-api-consumption-subregistries-and-sync-strategies.md
@@ -632,7 +632,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Authentication Models and Namespace Ownership](04-authentication-models-and-namespace-ownership.md)
 - [Next Chapter: Chapter 6: Versioning, Governance, and Moderation Lifecycle](06-versioning-governance-and-moderation-lifecycle.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-registry-tutorial/06-versioning-governance-and-moderation-lifecycle.md b/tutorials/mcp-registry-tutorial/06-versioning-governance-and-moderation-lifecycle.md
index 7dba6bed..222694a1 100644
--- a/tutorials/mcp-registry-tutorial/06-versioning-governance-and-moderation-lifecycle.md
+++ b/tutorials/mcp-registry-tutorial/06-versioning-governance-and-moderation-lifecycle.md
@@ -642,7 +642,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: API Consumption, Subregistries, and Sync Strategies](05-api-consumption-subregistries-and-sync-strategies.md)
 - [Next Chapter: Chapter 7: Admin Operations, Deployment, and Observability](07-admin-operations-deployment-and-observability.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-registry-tutorial/07-admin-operations-deployment-and-observability.md b/tutorials/mcp-registry-tutorial/07-admin-operations-deployment-and-observability.md
index faff949b..cdc42ebe 100644
--- a/tutorials/mcp-registry-tutorial/07-admin-operations-deployment-and-observability.md
+++ b/tutorials/mcp-registry-tutorial/07-admin-operations-deployment-and-observability.md
@@ -642,7 +642,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Versioning, Governance, and Moderation Lifecycle](06-versioning-governance-and-moderation-lifecycle.md)
 - [Next Chapter: Chapter 8: Production Rollout, Automation, and Contribution](08-production-rollout-automation-and-contribution.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-registry-tutorial/08-production-rollout-automation-and-contribution.md b/tutorials/mcp-registry-tutorial/08-production-rollout-automation-and-contribution.md
index 9c8e6a21..e3b8a4f1 100644
--- a/tutorials/mcp-registry-tutorial/08-production-rollout-automation-and-contribution.md
+++ b/tutorials/mcp-registry-tutorial/08-production-rollout-automation-and-contribution.md
@@ -632,7 +632,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Admin Operations, Deployment, and Observability](07-admin-operations-deployment-and-observability.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/mcp-registry-tutorial/index.md b/tutorials/mcp-registry-tutorial/README.md
similarity index 100%
rename from tutorials/mcp-registry-tutorial/index.md
rename to tutorials/mcp-registry-tutorial/README.md
diff --git a/tutorials/mcp-ruby-sdk-tutorial/01-getting-started-and-gem-baseline.md b/tutorials/mcp-ruby-sdk-tutorial/01-getting-started-and-gem-baseline.md
index 699ff720..f940e1ed 100644
--- a/tutorials/mcp-ruby-sdk-tutorial/01-getting-started-and-gem-baseline.md
+++ b/tutorials/mcp-ruby-sdk-tutorial/01-getting-started-and-gem-baseline.md
@@ -635,7 +635,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Server Architecture and Capability Negotiation](02-server-architecture-and-capability-negotiation.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/mcp-ruby-sdk-tutorial/02-server-architecture-and-capability-negotiation.md b/tutorials/mcp-ruby-sdk-tutorial/02-server-architecture-and-capability-negotiation.md
index eb139793..4e70eefe 100644
--- a/tutorials/mcp-ruby-sdk-tutorial/02-server-architecture-and-capability-negotiation.md
+++ b/tutorials/mcp-ruby-sdk-tutorial/02-server-architecture-and-capability-negotiation.md
@@ -634,7 +634,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started and Gem Baseline](01-getting-started-and-gem-baseline.md)
 - [Next Chapter: Chapter 3: Tools, Prompts, Resources, and Schema Discipline](03-tools-prompts-resources-and-schema-discipline.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-ruby-sdk-tutorial/03-tools-prompts-resources-and-schema-discipline.md b/tutorials/mcp-ruby-sdk-tutorial/03-tools-prompts-resources-and-schema-discipline.md
index fc995071..637f5d71 100644
--- a/tutorials/mcp-ruby-sdk-tutorial/03-tools-prompts-resources-and-schema-discipline.md
+++ b/tutorials/mcp-ruby-sdk-tutorial/03-tools-prompts-resources-and-schema-discipline.md
@@ -628,7 +628,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Server Architecture and Capability Negotiation](02-server-architecture-and-capability-negotiation.md)
 - [Next Chapter: Chapter 4: Notifications, Logging, and Observability](04-notifications-logging-and-observability.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-ruby-sdk-tutorial/04-notifications-logging-and-observability.md b/tutorials/mcp-ruby-sdk-tutorial/04-notifications-logging-and-observability.md
index 15011208..5fb4196a 100644
--- a/tutorials/mcp-ruby-sdk-tutorial/04-notifications-logging-and-observability.md
+++ b/tutorials/mcp-ruby-sdk-tutorial/04-notifications-logging-and-observability.md
@@ -635,7 +635,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Tools, Prompts, Resources, and Schema Discipline](03-tools-prompts-resources-and-schema-discipline.md)
 - [Next Chapter: Chapter 5: Transports: stdio, Streamable HTTP, and Session Modes](05-transports-stdio-streamable-http-and-session-modes.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-ruby-sdk-tutorial/05-transports-stdio-streamable-http-and-session-modes.md b/tutorials/mcp-ruby-sdk-tutorial/05-transports-stdio-streamable-http-and-session-modes.md
index ad951061..dafd20df 100644
--- a/tutorials/mcp-ruby-sdk-tutorial/05-transports-stdio-streamable-http-and-session-modes.md
+++ b/tutorials/mcp-ruby-sdk-tutorial/05-transports-stdio-streamable-http-and-session-modes.md
@@ -635,7 +635,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Notifications, Logging, and Observability](04-notifications-logging-and-observability.md)
 - [Next Chapter: Chapter 6: Client Workflows, HTTP Integration, and Auth Considerations](06-client-workflows-http-integration-and-auth-considerations.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-ruby-sdk-tutorial/06-client-workflows-http-integration-and-auth-considerations.md b/tutorials/mcp-ruby-sdk-tutorial/06-client-workflows-http-integration-and-auth-considerations.md
index 6fcf3e15..ce411491 100644
--- a/tutorials/mcp-ruby-sdk-tutorial/06-client-workflows-http-integration-and-auth-considerations.md
+++ b/tutorials/mcp-ruby-sdk-tutorial/06-client-workflows-http-integration-and-auth-considerations.md
@@ -628,7 +628,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Transports: stdio, Streamable HTTP, and Session Modes](05-transports-stdio-streamable-http-and-session-modes.md)
 - [Next Chapter: Chapter 7: Quality, Security, and Release Workflows](07-quality-security-and-release-workflows.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-ruby-sdk-tutorial/07-quality-security-and-release-workflows.md b/tutorials/mcp-ruby-sdk-tutorial/07-quality-security-and-release-workflows.md
index f3d9289f..4e1943cd 100644
--- a/tutorials/mcp-ruby-sdk-tutorial/07-quality-security-and-release-workflows.md
+++ b/tutorials/mcp-ruby-sdk-tutorial/07-quality-security-and-release-workflows.md
@@ -629,7 +629,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Client Workflows, HTTP Integration, and Auth Considerations](06-client-workflows-http-integration-and-auth-considerations.md)
 - [Next Chapter: Chapter 8: Production Deployment and Upgrade Strategy](08-production-deployment-and-upgrade-strategy.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-ruby-sdk-tutorial/08-production-deployment-and-upgrade-strategy.md b/tutorials/mcp-ruby-sdk-tutorial/08-production-deployment-and-upgrade-strategy.md
index b7753f44..332a9a2f 100644
--- a/tutorials/mcp-ruby-sdk-tutorial/08-production-deployment-and-upgrade-strategy.md
+++ b/tutorials/mcp-ruby-sdk-tutorial/08-production-deployment-and-upgrade-strategy.md
@@ -38,7 +38,7 @@ This chapter defines practical production controls for Ruby MCP services and cli
 
 You now have a production rollout and upgrade strategy for Ruby MCP implementations.
 
-Return to the [MCP Ruby SDK Tutorial index](index.md).
+Return to the [MCP Ruby SDK Tutorial index](README.md).
 
 ## Depth Expansion Playbook
 
@@ -629,7 +629,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Quality, Security, and Release Workflows](07-quality-security-and-release-workflows.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/mcp-ruby-sdk-tutorial/index.md b/tutorials/mcp-ruby-sdk-tutorial/README.md
similarity index 100%
rename from tutorials/mcp-ruby-sdk-tutorial/index.md
rename to tutorials/mcp-ruby-sdk-tutorial/README.md
diff --git a/tutorials/mcp-rust-sdk-tutorial/01-getting-started-and-crate-setup.md b/tutorials/mcp-rust-sdk-tutorial/01-getting-started-and-crate-setup.md
index 94496e04..7d4ebd2c 100644
--- a/tutorials/mcp-rust-sdk-tutorial/01-getting-started-and-crate-setup.md
+++ b/tutorials/mcp-rust-sdk-tutorial/01-getting-started-and-crate-setup.md
@@ -640,7 +640,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Service Model and Macro-Based Tooling](02-service-model-and-macro-based-tooling.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/mcp-rust-sdk-tutorial/02-service-model-and-macro-based-tooling.md b/tutorials/mcp-rust-sdk-tutorial/02-service-model-and-macro-based-tooling.md
index 4e970f25..3f1c3eee 100644
--- a/tutorials/mcp-rust-sdk-tutorial/02-service-model-and-macro-based-tooling.md
+++ b/tutorials/mcp-rust-sdk-tutorial/02-service-model-and-macro-based-tooling.md
@@ -635,7 +635,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started and Crate Setup](01-getting-started-and-crate-setup.md)
 - [Next Chapter: Chapter 3: Transports: stdio, Streamable HTTP, and Custom Channels](03-transports-stdio-streamable-http-and-custom-channels.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-rust-sdk-tutorial/03-transports-stdio-streamable-http-and-custom-channels.md b/tutorials/mcp-rust-sdk-tutorial/03-transports-stdio-streamable-http-and-custom-channels.md
index 4ca4c8f3..3f849eb9 100644
--- a/tutorials/mcp-rust-sdk-tutorial/03-transports-stdio-streamable-http-and-custom-channels.md
+++ b/tutorials/mcp-rust-sdk-tutorial/03-transports-stdio-streamable-http-and-custom-channels.md
@@ -636,7 +636,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Service Model and Macro-Based Tooling](02-service-model-and-macro-based-tooling.md)
 - [Next Chapter: Chapter 4: Client Patterns, Sampling, and Batching Flows](04-client-patterns-sampling-and-batching-flows.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-rust-sdk-tutorial/04-client-patterns-sampling-and-batching-flows.md b/tutorials/mcp-rust-sdk-tutorial/04-client-patterns-sampling-and-batching-flows.md
index 09bab09c..d96c73b5 100644
--- a/tutorials/mcp-rust-sdk-tutorial/04-client-patterns-sampling-and-batching-flows.md
+++ b/tutorials/mcp-rust-sdk-tutorial/04-client-patterns-sampling-and-batching-flows.md
@@ -636,7 +636,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Transports: stdio, Streamable HTTP, and Custom Channels](03-transports-stdio-streamable-http-and-custom-channels.md)
 - [Next Chapter: Chapter 5: Server Patterns: Tools, Resources, Prompts, and Tasks](05-server-patterns-tools-resources-prompts-and-tasks.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-rust-sdk-tutorial/05-server-patterns-tools-resources-prompts-and-tasks.md b/tutorials/mcp-rust-sdk-tutorial/05-server-patterns-tools-resources-prompts-and-tasks.md
index 482618ee..c2e8ec33 100644
--- a/tutorials/mcp-rust-sdk-tutorial/05-server-patterns-tools-resources-prompts-and-tasks.md
+++ b/tutorials/mcp-rust-sdk-tutorial/05-server-patterns-tools-resources-prompts-and-tasks.md
@@ -636,7 +636,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Client Patterns, Sampling, and Batching Flows](04-client-patterns-sampling-and-batching-flows.md)
 - [Next Chapter: Chapter 6: OAuth, Security, and Auth Workflows](06-oauth-security-and-auth-workflows.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-rust-sdk-tutorial/06-oauth-security-and-auth-workflows.md b/tutorials/mcp-rust-sdk-tutorial/06-oauth-security-and-auth-workflows.md
index 5f1b488c..29e429cd 100644
--- a/tutorials/mcp-rust-sdk-tutorial/06-oauth-security-and-auth-workflows.md
+++ b/tutorials/mcp-rust-sdk-tutorial/06-oauth-security-and-auth-workflows.md
@@ -636,7 +636,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Server Patterns: Tools, Resources, Prompts, and Tasks](05-server-patterns-tools-resources-prompts-and-tasks.md)
 - [Next Chapter: Chapter 7: Conformance, Changelog, and Release Discipline](07-conformance-changelog-and-release-discipline.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-rust-sdk-tutorial/07-conformance-changelog-and-release-discipline.md b/tutorials/mcp-rust-sdk-tutorial/07-conformance-changelog-and-release-discipline.md
index 471099f5..20d8ad51 100644
--- a/tutorials/mcp-rust-sdk-tutorial/07-conformance-changelog-and-release-discipline.md
+++ b/tutorials/mcp-rust-sdk-tutorial/07-conformance-changelog-and-release-discipline.md
@@ -636,7 +636,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: OAuth, Security, and Auth Workflows](06-oauth-security-and-auth-workflows.md)
 - [Next Chapter: Chapter 8: Ecosystem Integration and Production Operations](08-ecosystem-integration-and-production-operations.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-rust-sdk-tutorial/08-ecosystem-integration-and-production-operations.md b/tutorials/mcp-rust-sdk-tutorial/08-ecosystem-integration-and-production-operations.md
index 87eb9761..96884279 100644
--- a/tutorials/mcp-rust-sdk-tutorial/08-ecosystem-integration-and-production-operations.md
+++ b/tutorials/mcp-rust-sdk-tutorial/08-ecosystem-integration-and-production-operations.md
@@ -636,7 +636,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Conformance, Changelog, and Release Discipline](07-conformance-changelog-and-release-discipline.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/mcp-rust-sdk-tutorial/index.md b/tutorials/mcp-rust-sdk-tutorial/README.md
similarity index 100%
rename from tutorials/mcp-rust-sdk-tutorial/index.md
rename to tutorials/mcp-rust-sdk-tutorial/README.md
diff --git a/tutorials/mcp-servers-tutorial/01-getting-started.md b/tutorials/mcp-servers-tutorial/01-getting-started.md
index e47d4e5d..840adf0c 100644
--- a/tutorials/mcp-servers-tutorial/01-getting-started.md
+++ b/tutorials/mcp-servers-tutorial/01-getting-started.md
@@ -108,7 +108,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Filesystem Server](02-filesystem-server.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/mcp-servers-tutorial/02-filesystem-server.md b/tutorials/mcp-servers-tutorial/02-filesystem-server.md
index ab6fa8ca..8cc900d4 100644
--- a/tutorials/mcp-servers-tutorial/02-filesystem-server.md
+++ b/tutorials/mcp-servers-tutorial/02-filesystem-server.md
@@ -116,7 +116,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started](01-getting-started.md)
 - [Next Chapter: Chapter 3: Git Server](03-git-server.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-servers-tutorial/03-git-server.md b/tutorials/mcp-servers-tutorial/03-git-server.md
index 6d662d6c..760af182 100644
--- a/tutorials/mcp-servers-tutorial/03-git-server.md
+++ b/tutorials/mcp-servers-tutorial/03-git-server.md
@@ -107,7 +107,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Filesystem Server](02-filesystem-server.md)
 - [Next Chapter: Chapter 4: Memory Server](04-memory-server.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-servers-tutorial/04-memory-server.md b/tutorials/mcp-servers-tutorial/04-memory-server.md
index cd93cc55..da574dec 100644
--- a/tutorials/mcp-servers-tutorial/04-memory-server.md
+++ b/tutorials/mcp-servers-tutorial/04-memory-server.md
@@ -107,7 +107,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Git Server](03-git-server.md)
 - [Next Chapter: Chapter 5: Multi-Language Servers](05-multi-language-servers.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-servers-tutorial/05-multi-language-servers.md b/tutorials/mcp-servers-tutorial/05-multi-language-servers.md
index afd890d3..8612e1fc 100644
--- a/tutorials/mcp-servers-tutorial/05-multi-language-servers.md
+++ b/tutorials/mcp-servers-tutorial/05-multi-language-servers.md
@@ -96,7 +96,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Memory Server](04-memory-server.md)
 - [Next Chapter: Chapter 6: Custom Server Development](06-custom-server-development.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-servers-tutorial/06-custom-server-development.md b/tutorials/mcp-servers-tutorial/06-custom-server-development.md
index 05d0192d..1cce52d7 100644
--- a/tutorials/mcp-servers-tutorial/06-custom-server-development.md
+++ b/tutorials/mcp-servers-tutorial/06-custom-server-development.md
@@ -110,7 +110,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Multi-Language Servers](05-multi-language-servers.md)
 - [Next Chapter: Chapter 7: Security Considerations](07-security-considerations.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-servers-tutorial/07-security-considerations.md b/tutorials/mcp-servers-tutorial/07-security-considerations.md
index d363d5f8..eb9f0db0 100644
--- a/tutorials/mcp-servers-tutorial/07-security-considerations.md
+++ b/tutorials/mcp-servers-tutorial/07-security-considerations.md
@@ -100,7 +100,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Custom Server Development](06-custom-server-development.md)
 - [Next Chapter: Chapter 8: Production Adaptation](08-production-adaptation.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-servers-tutorial/08-production-adaptation.md b/tutorials/mcp-servers-tutorial/08-production-adaptation.md
index 6e8d6430..3a27334d 100644
--- a/tutorials/mcp-servers-tutorial/08-production-adaptation.md
+++ b/tutorials/mcp-servers-tutorial/08-production-adaptation.md
@@ -107,7 +107,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Security Considerations](07-security-considerations.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/mcp-servers-tutorial/index.md b/tutorials/mcp-servers-tutorial/README.md
similarity index 100%
rename from tutorials/mcp-servers-tutorial/index.md
rename to tutorials/mcp-servers-tutorial/README.md
diff --git a/tutorials/mcp-specification-tutorial/01-getting-started-and-version-navigation.md b/tutorials/mcp-specification-tutorial/01-getting-started-and-version-navigation.md
index f7a9528a..32acf5c3 100644
--- a/tutorials/mcp-specification-tutorial/01-getting-started-and-version-navigation.md
+++ b/tutorials/mcp-specification-tutorial/01-getting-started-and-version-navigation.md
@@ -633,7 +633,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Architecture and Capability Negotiation](02-architecture-and-capability-negotiation.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/mcp-specification-tutorial/02-architecture-and-capability-negotiation.md b/tutorials/mcp-specification-tutorial/02-architecture-and-capability-negotiation.md
index 7128b92e..2fc49d4e 100644
--- a/tutorials/mcp-specification-tutorial/02-architecture-and-capability-negotiation.md
+++ b/tutorials/mcp-specification-tutorial/02-architecture-and-capability-negotiation.md
@@ -647,7 +647,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started and Version Navigation](01-getting-started-and-version-navigation.md)
 - [Next Chapter: Chapter 3: Base Protocol Messages and Schema Contracts](03-base-protocol-messages-and-schema-contracts.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-specification-tutorial/03-base-protocol-messages-and-schema-contracts.md b/tutorials/mcp-specification-tutorial/03-base-protocol-messages-and-schema-contracts.md
index 30cb8b15..5740413e 100644
--- a/tutorials/mcp-specification-tutorial/03-base-protocol-messages-and-schema-contracts.md
+++ b/tutorials/mcp-specification-tutorial/03-base-protocol-messages-and-schema-contracts.md
@@ -636,7 +636,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Architecture and Capability Negotiation](02-architecture-and-capability-negotiation.md)
 - [Next Chapter: Chapter 4: Transport Model: stdio, Streamable HTTP, and Sessions](04-transport-model-stdio-streamable-http-and-sessions.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-specification-tutorial/04-transport-model-stdio-streamable-http-and-sessions.md b/tutorials/mcp-specification-tutorial/04-transport-model-stdio-streamable-http-and-sessions.md
index 5dbfb605..eda5e0f0 100644
--- a/tutorials/mcp-specification-tutorial/04-transport-model-stdio-streamable-http-and-sessions.md
+++ b/tutorials/mcp-specification-tutorial/04-transport-model-stdio-streamable-http-and-sessions.md
@@ -633,7 +633,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Base Protocol Messages and Schema Contracts](03-base-protocol-messages-and-schema-contracts.md)
 - [Next Chapter: Chapter 5: Server Primitives: Tools, Resources, and Prompts](05-server-primitives-tools-resources-and-prompts.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-specification-tutorial/05-server-primitives-tools-resources-and-prompts.md b/tutorials/mcp-specification-tutorial/05-server-primitives-tools-resources-and-prompts.md
index ef1c7bc5..fbd8ec7d 100644
--- a/tutorials/mcp-specification-tutorial/05-server-primitives-tools-resources-and-prompts.md
+++ b/tutorials/mcp-specification-tutorial/05-server-primitives-tools-resources-and-prompts.md
@@ -635,7 +635,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Transport Model: stdio, Streamable HTTP, and Sessions](04-transport-model-stdio-streamable-http-and-sessions.md)
 - [Next Chapter: Chapter 6: Client Primitives: Roots, Sampling, Elicitation, and Tasks](06-client-primitives-roots-sampling-elicitation-and-tasks.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-specification-tutorial/06-client-primitives-roots-sampling-elicitation-and-tasks.md b/tutorials/mcp-specification-tutorial/06-client-primitives-roots-sampling-elicitation-and-tasks.md
index 0bdf5c21..e536c72e 100644
--- a/tutorials/mcp-specification-tutorial/06-client-primitives-roots-sampling-elicitation-and-tasks.md
+++ b/tutorials/mcp-specification-tutorial/06-client-primitives-roots-sampling-elicitation-and-tasks.md
@@ -634,7 +634,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Server Primitives: Tools, Resources, and Prompts](05-server-primitives-tools-resources-and-prompts.md)
 - [Next Chapter: Chapter 7: Authorization and Security Best Practices](07-authorization-and-security-best-practices.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-specification-tutorial/07-authorization-and-security-best-practices.md b/tutorials/mcp-specification-tutorial/07-authorization-and-security-best-practices.md
index e655dd74..3094bc02 100644
--- a/tutorials/mcp-specification-tutorial/07-authorization-and-security-best-practices.md
+++ b/tutorials/mcp-specification-tutorial/07-authorization-and-security-best-practices.md
@@ -635,7 +635,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Client Primitives: Roots, Sampling, Elicitation, and Tasks](06-client-primitives-roots-sampling-elicitation-and-tasks.md)
 - [Next Chapter: Chapter 8: Governance, SEPs, and Contribution Workflow](08-governance-seps-and-contribution-workflow.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-specification-tutorial/08-governance-seps-and-contribution-workflow.md b/tutorials/mcp-specification-tutorial/08-governance-seps-and-contribution-workflow.md
index 881be061..db0c78aa 100644
--- a/tutorials/mcp-specification-tutorial/08-governance-seps-and-contribution-workflow.md
+++ b/tutorials/mcp-specification-tutorial/08-governance-seps-and-contribution-workflow.md
@@ -635,7 +635,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Authorization and Security Best Practices](07-authorization-and-security-best-practices.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/mcp-specification-tutorial/index.md b/tutorials/mcp-specification-tutorial/README.md
similarity index 100%
rename from tutorials/mcp-specification-tutorial/index.md
rename to tutorials/mcp-specification-tutorial/README.md
diff --git a/tutorials/mcp-swift-sdk-tutorial/01-getting-started-and-package-baseline.md b/tutorials/mcp-swift-sdk-tutorial/01-getting-started-and-package-baseline.md
index 8ad06a37..6875df52 100644
--- a/tutorials/mcp-swift-sdk-tutorial/01-getting-started-and-package-baseline.md
+++ b/tutorials/mcp-swift-sdk-tutorial/01-getting-started-and-package-baseline.md
@@ -632,7 +632,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Client Transport and Capability Negotiation](02-client-transport-and-capability-negotiation.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/mcp-swift-sdk-tutorial/02-client-transport-and-capability-negotiation.md b/tutorials/mcp-swift-sdk-tutorial/02-client-transport-and-capability-negotiation.md
index d51b2d91..0c0dd591 100644
--- a/tutorials/mcp-swift-sdk-tutorial/02-client-transport-and-capability-negotiation.md
+++ b/tutorials/mcp-swift-sdk-tutorial/02-client-transport-and-capability-negotiation.md
@@ -632,7 +632,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started and Package Baseline](01-getting-started-and-package-baseline.md)
 - [Next Chapter: Chapter 3: Tools, Resources, Prompts, and Request Patterns](03-tools-resources-prompts-and-request-patterns.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-swift-sdk-tutorial/03-tools-resources-prompts-and-request-patterns.md b/tutorials/mcp-swift-sdk-tutorial/03-tools-resources-prompts-and-request-patterns.md
index 02e040c4..166d461d 100644
--- a/tutorials/mcp-swift-sdk-tutorial/03-tools-resources-prompts-and-request-patterns.md
+++ b/tutorials/mcp-swift-sdk-tutorial/03-tools-resources-prompts-and-request-patterns.md
@@ -633,7 +633,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Client Transport and Capability Negotiation](02-client-transport-and-capability-negotiation.md)
 - [Next Chapter: Chapter 4: Sampling, Human-in-the-Loop, and Error Handling](04-sampling-human-in-the-loop-and-error-handling.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-swift-sdk-tutorial/04-sampling-human-in-the-loop-and-error-handling.md b/tutorials/mcp-swift-sdk-tutorial/04-sampling-human-in-the-loop-and-error-handling.md
index ab382ed9..773f1603 100644
--- a/tutorials/mcp-swift-sdk-tutorial/04-sampling-human-in-the-loop-and-error-handling.md
+++ b/tutorials/mcp-swift-sdk-tutorial/04-sampling-human-in-the-loop-and-error-handling.md
@@ -632,7 +632,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Tools, Resources, Prompts, and Request Patterns](03-tools-resources-prompts-and-request-patterns.md)
 - [Next Chapter: Chapter 5: Server Setup, Hooks, and Primitive Authoring](05-server-setup-hooks-and-primitive-authoring.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-swift-sdk-tutorial/05-server-setup-hooks-and-primitive-authoring.md b/tutorials/mcp-swift-sdk-tutorial/05-server-setup-hooks-and-primitive-authoring.md
index 53d12598..8c27cca8 100644
--- a/tutorials/mcp-swift-sdk-tutorial/05-server-setup-hooks-and-primitive-authoring.md
+++ b/tutorials/mcp-swift-sdk-tutorial/05-server-setup-hooks-and-primitive-authoring.md
@@ -632,7 +632,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Sampling, Human-in-the-Loop, and Error Handling](04-sampling-human-in-the-loop-and-error-handling.md)
 - [Next Chapter: Chapter 6: Transports, Custom Implementations, and Shutdown](06-transports-custom-implementations-and-shutdown.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-swift-sdk-tutorial/06-transports-custom-implementations-and-shutdown.md b/tutorials/mcp-swift-sdk-tutorial/06-transports-custom-implementations-and-shutdown.md
index 84da075b..d7ddb6ef 100644
--- a/tutorials/mcp-swift-sdk-tutorial/06-transports-custom-implementations-and-shutdown.md
+++ b/tutorials/mcp-swift-sdk-tutorial/06-transports-custom-implementations-and-shutdown.md
@@ -633,7 +633,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Server Setup, Hooks, and Primitive Authoring](05-server-setup-hooks-and-primitive-authoring.md)
 - [Next Chapter: Chapter 7: Strict Mode, Batching, Logging, and Debugging](07-strict-mode-batching-logging-and-debugging.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-swift-sdk-tutorial/07-strict-mode-batching-logging-and-debugging.md b/tutorials/mcp-swift-sdk-tutorial/07-strict-mode-batching-logging-and-debugging.md
index e621dc58..94ec10ce 100644
--- a/tutorials/mcp-swift-sdk-tutorial/07-strict-mode-batching-logging-and-debugging.md
+++ b/tutorials/mcp-swift-sdk-tutorial/07-strict-mode-batching-logging-and-debugging.md
@@ -633,7 +633,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Transports, Custom Implementations, and Shutdown](06-transports-custom-implementations-and-shutdown.md)
 - [Next Chapter: Chapter 8: Release, Versioning, and Production Guidelines](08-release-versioning-and-production-guidelines.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-swift-sdk-tutorial/08-release-versioning-and-production-guidelines.md b/tutorials/mcp-swift-sdk-tutorial/08-release-versioning-and-production-guidelines.md
index e21d01dd..7803bf44 100644
--- a/tutorials/mcp-swift-sdk-tutorial/08-release-versioning-and-production-guidelines.md
+++ b/tutorials/mcp-swift-sdk-tutorial/08-release-versioning-and-production-guidelines.md
@@ -633,7 +633,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Strict Mode, Batching, Logging, and Debugging](07-strict-mode-batching-logging-and-debugging.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/mcp-swift-sdk-tutorial/index.md b/tutorials/mcp-swift-sdk-tutorial/README.md
similarity index 100%
rename from tutorials/mcp-swift-sdk-tutorial/index.md
rename to tutorials/mcp-swift-sdk-tutorial/README.md
diff --git a/tutorials/mcp-typescript-sdk-tutorial/01-getting-started-and-package-model.md b/tutorials/mcp-typescript-sdk-tutorial/01-getting-started-and-package-model.md
index a0477adf..a9aa6891 100644
--- a/tutorials/mcp-typescript-sdk-tutorial/01-getting-started-and-package-model.md
+++ b/tutorials/mcp-typescript-sdk-tutorial/01-getting-started-and-package-model.md
@@ -641,7 +641,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Server Transports and Deployment Patterns](02-server-transports-and-deployment-patterns.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/mcp-typescript-sdk-tutorial/02-server-transports-and-deployment-patterns.md b/tutorials/mcp-typescript-sdk-tutorial/02-server-transports-and-deployment-patterns.md
index 0ce334a7..184d4f86 100644
--- a/tutorials/mcp-typescript-sdk-tutorial/02-server-transports-and-deployment-patterns.md
+++ b/tutorials/mcp-typescript-sdk-tutorial/02-server-transports-and-deployment-patterns.md
@@ -643,7 +643,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started and Package Model](01-getting-started-and-package-model.md)
 - [Next Chapter: Chapter 3: Client Transports, OAuth, and Backwards Compatibility](03-client-transports-oauth-and-backwards-compatibility.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-typescript-sdk-tutorial/03-client-transports-oauth-and-backwards-compatibility.md b/tutorials/mcp-typescript-sdk-tutorial/03-client-transports-oauth-and-backwards-compatibility.md
index 30f1053a..fa904484 100644
--- a/tutorials/mcp-typescript-sdk-tutorial/03-client-transports-oauth-and-backwards-compatibility.md
+++ b/tutorials/mcp-typescript-sdk-tutorial/03-client-transports-oauth-and-backwards-compatibility.md
@@ -636,7 +636,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Server Transports and Deployment Patterns](02-server-transports-and-deployment-patterns.md)
 - [Next Chapter: Chapter 4: Tool, Resource, Prompt Design and Completions](04-tool-resource-prompt-design-and-completions.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-typescript-sdk-tutorial/04-tool-resource-prompt-design-and-completions.md b/tutorials/mcp-typescript-sdk-tutorial/04-tool-resource-prompt-design-and-completions.md
index ed8e6b7d..b5c50996 100644
--- a/tutorials/mcp-typescript-sdk-tutorial/04-tool-resource-prompt-design-and-completions.md
+++ b/tutorials/mcp-typescript-sdk-tutorial/04-tool-resource-prompt-design-and-completions.md
@@ -637,7 +637,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Client Transports, OAuth, and Backwards Compatibility](03-client-transports-oauth-and-backwards-compatibility.md)
 - [Next Chapter: Chapter 5: Sampling, Elicitation, and Experimental Tasks](05-sampling-elicitation-and-experimental-tasks.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-typescript-sdk-tutorial/05-sampling-elicitation-and-experimental-tasks.md b/tutorials/mcp-typescript-sdk-tutorial/05-sampling-elicitation-and-experimental-tasks.md
index 6d2906ed..d300be11 100644
--- a/tutorials/mcp-typescript-sdk-tutorial/05-sampling-elicitation-and-experimental-tasks.md
+++ b/tutorials/mcp-typescript-sdk-tutorial/05-sampling-elicitation-and-experimental-tasks.md
@@ -636,7 +636,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Tool, Resource, Prompt Design and Completions](04-tool-resource-prompt-design-and-completions.md)
 - [Next Chapter: Chapter 6: Middleware, Security, and Host Validation](06-middleware-security-and-host-validation.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-typescript-sdk-tutorial/06-middleware-security-and-host-validation.md b/tutorials/mcp-typescript-sdk-tutorial/06-middleware-security-and-host-validation.md
index 864af07a..c28d3c6e 100644
--- a/tutorials/mcp-typescript-sdk-tutorial/06-middleware-security-and-host-validation.md
+++ b/tutorials/mcp-typescript-sdk-tutorial/06-middleware-security-and-host-validation.md
@@ -638,7 +638,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Sampling, Elicitation, and Experimental Tasks](05-sampling-elicitation-and-experimental-tasks.md)
 - [Next Chapter: Chapter 7: v1 to v2 Migration Strategy](07-v1-to-v2-migration-strategy.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-typescript-sdk-tutorial/07-v1-to-v2-migration-strategy.md b/tutorials/mcp-typescript-sdk-tutorial/07-v1-to-v2-migration-strategy.md
index b3f9584f..e3b119fb 100644
--- a/tutorials/mcp-typescript-sdk-tutorial/07-v1-to-v2-migration-strategy.md
+++ b/tutorials/mcp-typescript-sdk-tutorial/07-v1-to-v2-migration-strategy.md
@@ -637,7 +637,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Middleware, Security, and Host Validation](06-middleware-security-and-host-validation.md)
 - [Next Chapter: Chapter 8: Conformance Testing and Contribution Workflows](08-conformance-testing-and-contribution-workflows.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-typescript-sdk-tutorial/08-conformance-testing-and-contribution-workflows.md b/tutorials/mcp-typescript-sdk-tutorial/08-conformance-testing-and-contribution-workflows.md
index e382d74c..d9ed67ae 100644
--- a/tutorials/mcp-typescript-sdk-tutorial/08-conformance-testing-and-contribution-workflows.md
+++ b/tutorials/mcp-typescript-sdk-tutorial/08-conformance-testing-and-contribution-workflows.md
@@ -636,7 +636,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: v1 to v2 Migration Strategy](07-v1-to-v2-migration-strategy.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/mcp-typescript-sdk-tutorial/index.md b/tutorials/mcp-typescript-sdk-tutorial/README.md
similarity index 100%
rename from tutorials/mcp-typescript-sdk-tutorial/index.md
rename to tutorials/mcp-typescript-sdk-tutorial/README.md
diff --git a/tutorials/mcp-use-tutorial/01-getting-started-and-stack-selection.md b/tutorials/mcp-use-tutorial/01-getting-started-and-stack-selection.md
index 3d8e655d..4fe6cd5e 100644
--- a/tutorials/mcp-use-tutorial/01-getting-started-and-stack-selection.md
+++ b/tutorials/mcp-use-tutorial/01-getting-started-and-stack-selection.md
@@ -637,7 +637,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Client Configuration, Sessions, and Transport Choices](02-client-configuration-sessions-and-transport-choices.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/mcp-use-tutorial/02-client-configuration-sessions-and-transport-choices.md b/tutorials/mcp-use-tutorial/02-client-configuration-sessions-and-transport-choices.md
index a2f3c753..b34c70b4 100644
--- a/tutorials/mcp-use-tutorial/02-client-configuration-sessions-and-transport-choices.md
+++ b/tutorials/mcp-use-tutorial/02-client-configuration-sessions-and-transport-choices.md
@@ -637,7 +637,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started and Stack Selection](01-getting-started-and-stack-selection.md)
 - [Next Chapter: Chapter 3: Agent Configuration, Tool Governance, and Memory](03-agent-configuration-tool-governance-and-memory.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-use-tutorial/03-agent-configuration-tool-governance-and-memory.md b/tutorials/mcp-use-tutorial/03-agent-configuration-tool-governance-and-memory.md
index ee4518d8..cc1e5af6 100644
--- a/tutorials/mcp-use-tutorial/03-agent-configuration-tool-governance-and-memory.md
+++ b/tutorials/mcp-use-tutorial/03-agent-configuration-tool-governance-and-memory.md
@@ -636,7 +636,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Client Configuration, Sessions, and Transport Choices](02-client-configuration-sessions-and-transport-choices.md)
 - [Next Chapter: Chapter 4: TypeScript Server Framework and UI Widgets](04-typescript-server-framework-and-ui-widgets.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-use-tutorial/04-typescript-server-framework-and-ui-widgets.md b/tutorials/mcp-use-tutorial/04-typescript-server-framework-and-ui-widgets.md
index d3cf686d..5562738b 100644
--- a/tutorials/mcp-use-tutorial/04-typescript-server-framework-and-ui-widgets.md
+++ b/tutorials/mcp-use-tutorial/04-typescript-server-framework-and-ui-widgets.md
@@ -637,7 +637,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Agent Configuration, Tool Governance, and Memory](03-agent-configuration-tool-governance-and-memory.md)
 - [Next Chapter: Chapter 5: Python Server Framework and Debug Endpoints](05-python-server-framework-and-debug-endpoints.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-use-tutorial/05-python-server-framework-and-debug-endpoints.md b/tutorials/mcp-use-tutorial/05-python-server-framework-and-debug-endpoints.md
index 47d98025..c301232d 100644
--- a/tutorials/mcp-use-tutorial/05-python-server-framework-and-debug-endpoints.md
+++ b/tutorials/mcp-use-tutorial/05-python-server-framework-and-debug-endpoints.md
@@ -636,7 +636,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: TypeScript Server Framework and UI Widgets](04-typescript-server-framework-and-ui-widgets.md)
 - [Next Chapter: Chapter 6: Inspector Debugging and Chat App Workflows](06-inspector-debugging-and-chat-app-workflows.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-use-tutorial/06-inspector-debugging-and-chat-app-workflows.md b/tutorials/mcp-use-tutorial/06-inspector-debugging-and-chat-app-workflows.md
index 586cf4a7..1ce7e8c2 100644
--- a/tutorials/mcp-use-tutorial/06-inspector-debugging-and-chat-app-workflows.md
+++ b/tutorials/mcp-use-tutorial/06-inspector-debugging-and-chat-app-workflows.md
@@ -635,7 +635,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Python Server Framework and Debug Endpoints](05-python-server-framework-and-debug-endpoints.md)
 - [Next Chapter: Chapter 7: Security, Runtime Controls, and Production Hardening](07-security-runtime-controls-and-production-hardening.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-use-tutorial/07-security-runtime-controls-and-production-hardening.md b/tutorials/mcp-use-tutorial/07-security-runtime-controls-and-production-hardening.md
index a1b77a55..e1ba042e 100644
--- a/tutorials/mcp-use-tutorial/07-security-runtime-controls-and-production-hardening.md
+++ b/tutorials/mcp-use-tutorial/07-security-runtime-controls-and-production-hardening.md
@@ -638,7 +638,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Inspector Debugging and Chat App Workflows](06-inspector-debugging-and-chat-app-workflows.md)
 - [Next Chapter: Chapter 8: Operations, Observability, and Contribution Model](08-operations-observability-and-contribution-model.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcp-use-tutorial/08-operations-observability-and-contribution-model.md b/tutorials/mcp-use-tutorial/08-operations-observability-and-contribution-model.md
index 783851b7..d51cd58e 100644
--- a/tutorials/mcp-use-tutorial/08-operations-observability-and-contribution-model.md
+++ b/tutorials/mcp-use-tutorial/08-operations-observability-and-contribution-model.md
@@ -637,7 +637,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Security, Runtime Controls, and Production Hardening](07-security-runtime-controls-and-production-hardening.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/mcp-use-tutorial/index.md b/tutorials/mcp-use-tutorial/README.md
similarity index 100%
rename from tutorials/mcp-use-tutorial/index.md
rename to tutorials/mcp-use-tutorial/README.md
diff --git a/tutorials/mcpb-tutorial/01-getting-started-and-bundle-fundamentals.md b/tutorials/mcpb-tutorial/01-getting-started-and-bundle-fundamentals.md
index c7ca47d1..0b815743 100644
--- a/tutorials/mcpb-tutorial/01-getting-started-and-bundle-fundamentals.md
+++ b/tutorials/mcpb-tutorial/01-getting-started-and-bundle-fundamentals.md
@@ -634,7 +634,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Manifest Model, Metadata, and Compatibility](02-manifest-model-metadata-and-compatibility.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/mcpb-tutorial/02-manifest-model-metadata-and-compatibility.md b/tutorials/mcpb-tutorial/02-manifest-model-metadata-and-compatibility.md
index e77aff48..ac8483cc 100644
--- a/tutorials/mcpb-tutorial/02-manifest-model-metadata-and-compatibility.md
+++ b/tutorials/mcpb-tutorial/02-manifest-model-metadata-and-compatibility.md
@@ -630,7 +630,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started and Bundle Fundamentals](01-getting-started-and-bundle-fundamentals.md)
 - [Next Chapter: Chapter 3: Server Configuration and Runtime Packaging](03-server-configuration-and-runtime-packaging.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcpb-tutorial/03-server-configuration-and-runtime-packaging.md b/tutorials/mcpb-tutorial/03-server-configuration-and-runtime-packaging.md
index 0e5892e8..bc479261 100644
--- a/tutorials/mcpb-tutorial/03-server-configuration-and-runtime-packaging.md
+++ b/tutorials/mcpb-tutorial/03-server-configuration-and-runtime-packaging.md
@@ -632,7 +632,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Manifest Model, Metadata, and Compatibility](02-manifest-model-metadata-and-compatibility.md)
 - [Next Chapter: Chapter 4: Tools, Prompts, User Config, and Localization](04-tools-prompts-user-config-and-localization.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcpb-tutorial/04-tools-prompts-user-config-and-localization.md b/tutorials/mcpb-tutorial/04-tools-prompts-user-config-and-localization.md
index c630fe3c..06716e1c 100644
--- a/tutorials/mcpb-tutorial/04-tools-prompts-user-config-and-localization.md
+++ b/tutorials/mcpb-tutorial/04-tools-prompts-user-config-and-localization.md
@@ -630,7 +630,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Server Configuration and Runtime Packaging](03-server-configuration-and-runtime-packaging.md)
 - [Next Chapter: Chapter 5: CLI Workflows: Init, Validate, and Pack](05-cli-workflows-init-validate-and-pack.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcpb-tutorial/05-cli-workflows-init-validate-and-pack.md b/tutorials/mcpb-tutorial/05-cli-workflows-init-validate-and-pack.md
index b2338f06..38a7653c 100644
--- a/tutorials/mcpb-tutorial/05-cli-workflows-init-validate-and-pack.md
+++ b/tutorials/mcpb-tutorial/05-cli-workflows-init-validate-and-pack.md
@@ -629,7 +629,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Tools, Prompts, User Config, and Localization](04-tools-prompts-user-config-and-localization.md)
 - [Next Chapter: Chapter 6: Signing, Verification, and Trust Controls](06-signing-verification-and-trust-controls.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcpb-tutorial/06-signing-verification-and-trust-controls.md b/tutorials/mcpb-tutorial/06-signing-verification-and-trust-controls.md
index 9349bcda..caed25e7 100644
--- a/tutorials/mcpb-tutorial/06-signing-verification-and-trust-controls.md
+++ b/tutorials/mcpb-tutorial/06-signing-verification-and-trust-controls.md
@@ -631,7 +631,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: CLI Workflows: Init, Validate, and Pack](05-cli-workflows-init-validate-and-pack.md)
 - [Next Chapter: Chapter 7: Examples, Language Patterns, and Distribution Readiness](07-examples-language-patterns-and-distribution-readiness.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcpb-tutorial/07-examples-language-patterns-and-distribution-readiness.md b/tutorials/mcpb-tutorial/07-examples-language-patterns-and-distribution-readiness.md
index ea782401..baf252f9 100644
--- a/tutorials/mcpb-tutorial/07-examples-language-patterns-and-distribution-readiness.md
+++ b/tutorials/mcpb-tutorial/07-examples-language-patterns-and-distribution-readiness.md
@@ -628,7 +628,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Signing, Verification, and Trust Controls](06-signing-verification-and-trust-controls.md)
 - [Next Chapter: Chapter 8: Release, Governance, and Ecosystem Operations](08-release-governance-and-ecosystem-operations.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mcpb-tutorial/08-release-governance-and-ecosystem-operations.md b/tutorials/mcpb-tutorial/08-release-governance-and-ecosystem-operations.md
index 06f0f6da..48c0b61d 100644
--- a/tutorials/mcpb-tutorial/08-release-governance-and-ecosystem-operations.md
+++ b/tutorials/mcpb-tutorial/08-release-governance-and-ecosystem-operations.md
@@ -36,7 +36,7 @@ This chapter defines long-term governance controls for operating MCPB workflows
 
 You now have a governance model for operating MCPB packaging and distribution at scale.
 
-Return to the [MCPB Tutorial index](index.md).
+Return to the [MCPB Tutorial index](README.md).
 
 ## Depth Expansion Playbook
 
@@ -630,7 +630,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Examples, Language Patterns, and Distribution Readiness](07-examples-language-patterns-and-distribution-readiness.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/mcpb-tutorial/index.md b/tutorials/mcpb-tutorial/README.md
similarity index 100%
rename from tutorials/mcpb-tutorial/index.md
rename to tutorials/mcpb-tutorial/README.md
diff --git a/tutorials/meilisearch-tutorial/01-getting-started.md b/tutorials/meilisearch-tutorial/01-getting-started.md
index d9de8966..901b1694 100644
--- a/tutorials/meilisearch-tutorial/01-getting-started.md
+++ b/tutorials/meilisearch-tutorial/01-getting-started.md
@@ -317,7 +317,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Document Management](02-document-management.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/meilisearch-tutorial/02-document-management.md b/tutorials/meilisearch-tutorial/02-document-management.md
index 59094719..d0e90410 100644
--- a/tutorials/meilisearch-tutorial/02-document-management.md
+++ b/tutorials/meilisearch-tutorial/02-document-management.md
@@ -395,7 +395,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started with Meilisearch](01-getting-started.md)
 - [Next Chapter: Chapter 3: Search Fundamentals](03-search-fundamentals.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/meilisearch-tutorial/03-search-fundamentals.md b/tutorials/meilisearch-tutorial/03-search-fundamentals.md
index 9d02a77d..0cf9ec8c 100644
--- a/tutorials/meilisearch-tutorial/03-search-fundamentals.md
+++ b/tutorials/meilisearch-tutorial/03-search-fundamentals.md
@@ -366,7 +366,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Document Management](02-document-management.md)
 - [Next Chapter: Chapter 4: Typo Tolerance & Relevance](04-typo-tolerance-relevance.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/meilisearch-tutorial/04-typo-tolerance-relevance.md b/tutorials/meilisearch-tutorial/04-typo-tolerance-relevance.md
index 9049deef..b36d87c4 100644
--- a/tutorials/meilisearch-tutorial/04-typo-tolerance-relevance.md
+++ b/tutorials/meilisearch-tutorial/04-typo-tolerance-relevance.md
@@ -409,7 +409,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Search Fundamentals](03-search-fundamentals.md)
 - [Next Chapter: Chapter 5: Filtering & Facets](05-filtering-facets.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/meilisearch-tutorial/05-filtering-facets.md b/tutorials/meilisearch-tutorial/05-filtering-facets.md
index c02456b3..470b8103 100644
--- a/tutorials/meilisearch-tutorial/05-filtering-facets.md
+++ b/tutorials/meilisearch-tutorial/05-filtering-facets.md
@@ -432,7 +432,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Typo Tolerance & Relevance](04-typo-tolerance-relevance.md)
 - [Next Chapter: Chapter 6: Multi-Language Support](06-multi-language-support.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/meilisearch-tutorial/06-multi-language-support.md b/tutorials/meilisearch-tutorial/06-multi-language-support.md
index 9d30cca6..bcb0cd5c 100644
--- a/tutorials/meilisearch-tutorial/06-multi-language-support.md
+++ b/tutorials/meilisearch-tutorial/06-multi-language-support.md
@@ -439,7 +439,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Filtering & Facets](05-filtering-facets.md)
 - [Next Chapter: Chapter 7: API Integration](07-api-integration.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/meilisearch-tutorial/07-api-integration.md b/tutorials/meilisearch-tutorial/07-api-integration.md
index 2d21d745..0c49c17a 100644
--- a/tutorials/meilisearch-tutorial/07-api-integration.md
+++ b/tutorials/meilisearch-tutorial/07-api-integration.md
@@ -650,7 +650,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Multi-Language Support](06-multi-language-support.md)
 - [Next Chapter: Chapter 8: Production Deployment](08-production-deployment.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/meilisearch-tutorial/08-production-deployment.md b/tutorials/meilisearch-tutorial/08-production-deployment.md
index 83759813..f65afb04 100644
--- a/tutorials/meilisearch-tutorial/08-production-deployment.md
+++ b/tutorials/meilisearch-tutorial/08-production-deployment.md
@@ -605,7 +605,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: API Integration](07-api-integration.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/meilisearch-tutorial/index.md b/tutorials/meilisearch-tutorial/README.md
similarity index 100%
rename from tutorials/meilisearch-tutorial/index.md
rename to tutorials/meilisearch-tutorial/README.md
diff --git a/tutorials/mem0-tutorial/01-getting-started.md b/tutorials/mem0-tutorial/01-getting-started.md
index bcdb9d8b..39c8767c 100644
--- a/tutorials/mem0-tutorial/01-getting-started.md
+++ b/tutorials/mem0-tutorial/01-getting-started.md
@@ -505,7 +505,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Memory Architecture & Types](02-memory-architecture.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/mem0-tutorial/02-memory-architecture.md b/tutorials/mem0-tutorial/02-memory-architecture.md
index 05c9cba0..0908e9d8 100644
--- a/tutorials/mem0-tutorial/02-memory-architecture.md
+++ b/tutorials/mem0-tutorial/02-memory-architecture.md
@@ -915,7 +915,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started with Mem0](01-getting-started.md)
 - [Next Chapter: Chapter 3: Core Memory Operations](03-memory-operations.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mem0-tutorial/03-memory-operations.md b/tutorials/mem0-tutorial/03-memory-operations.md
index 5042cf6a..d944c817 100644
--- a/tutorials/mem0-tutorial/03-memory-operations.md
+++ b/tutorials/mem0-tutorial/03-memory-operations.md
@@ -1224,7 +1224,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Memory Architecture & Types](02-memory-architecture.md)
 - [Next Chapter: Chapter 4: Advanced Memory Features](04-advanced-features.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mem0-tutorial/04-advanced-features.md b/tutorials/mem0-tutorial/04-advanced-features.md
index 03afca2d..9b629598 100644
--- a/tutorials/mem0-tutorial/04-advanced-features.md
+++ b/tutorials/mem0-tutorial/04-advanced-features.md
@@ -1075,7 +1075,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Core Memory Operations](03-memory-operations.md)
 - [Next Chapter: Chapter 5: Integrating with LLMs](05-llm-integration.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mem0-tutorial/05-llm-integration.md b/tutorials/mem0-tutorial/05-llm-integration.md
index 23b71618..c819fab3 100644
--- a/tutorials/mem0-tutorial/05-llm-integration.md
+++ b/tutorials/mem0-tutorial/05-llm-integration.md
@@ -1202,7 +1202,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Advanced Memory Features](04-advanced-features.md)
 - [Next Chapter: Chapter 6: Building Memory-Enabled Applications](06-memory-applications.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mem0-tutorial/06-memory-applications.md b/tutorials/mem0-tutorial/06-memory-applications.md
index 80cac7b1..52b59f8c 100644
--- a/tutorials/mem0-tutorial/06-memory-applications.md
+++ b/tutorials/mem0-tutorial/06-memory-applications.md
@@ -1180,7 +1180,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Integrating with LLMs](05-llm-integration.md)
 - [Next Chapter: Chapter 7: Performance Optimization](07-performance-optimization.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mem0-tutorial/07-performance-optimization.md b/tutorials/mem0-tutorial/07-performance-optimization.md
index 67b50ceb..66cc714c 100644
--- a/tutorials/mem0-tutorial/07-performance-optimization.md
+++ b/tutorials/mem0-tutorial/07-performance-optimization.md
@@ -1176,7 +1176,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Building Memory-Enabled Applications](06-memory-applications.md)
 - [Next Chapter: Chapter 8: Production Deployment & Scaling](08-production-deployment.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mem0-tutorial/08-production-deployment.md b/tutorials/mem0-tutorial/08-production-deployment.md
index d8143ba7..0bfac216 100644
--- a/tutorials/mem0-tutorial/08-production-deployment.md
+++ b/tutorials/mem0-tutorial/08-production-deployment.md
@@ -595,7 +595,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Performance Optimization](07-performance-optimization.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/mem0-tutorial/index.md b/tutorials/mem0-tutorial/README.md
similarity index 100%
rename from tutorials/mem0-tutorial/index.md
rename to tutorials/mem0-tutorial/README.md
diff --git a/tutorials/mini-swe-agent-tutorial/01-getting-started.md b/tutorials/mini-swe-agent-tutorial/01-getting-started.md
index f48d31da..6bdc13ea 100644
--- a/tutorials/mini-swe-agent-tutorial/01-getting-started.md
+++ b/tutorials/mini-swe-agent-tutorial/01-getting-started.md
@@ -629,7 +629,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Core Architecture and Minimal Design](02-core-architecture-and-minimal-design.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/mini-swe-agent-tutorial/02-core-architecture-and-minimal-design.md b/tutorials/mini-swe-agent-tutorial/02-core-architecture-and-minimal-design.md
index 1ed0532e..56cc1d11 100644
--- a/tutorials/mini-swe-agent-tutorial/02-core-architecture-and-minimal-design.md
+++ b/tutorials/mini-swe-agent-tutorial/02-core-architecture-and-minimal-design.md
@@ -629,7 +629,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started](01-getting-started.md)
 - [Next Chapter: Chapter 3: CLI, Batch, and Inspector Workflows](03-cli-batch-and-inspector-workflows.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mini-swe-agent-tutorial/03-cli-batch-and-inspector-workflows.md b/tutorials/mini-swe-agent-tutorial/03-cli-batch-and-inspector-workflows.md
index 08646cbb..4701e0db 100644
--- a/tutorials/mini-swe-agent-tutorial/03-cli-batch-and-inspector-workflows.md
+++ b/tutorials/mini-swe-agent-tutorial/03-cli-batch-and-inspector-workflows.md
@@ -629,7 +629,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Core Architecture and Minimal Design](02-core-architecture-and-minimal-design.md)
 - [Next Chapter: Chapter 4: Global and YAML Configuration Strategy](04-global-and-yaml-configuration-strategy.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mini-swe-agent-tutorial/04-global-and-yaml-configuration-strategy.md b/tutorials/mini-swe-agent-tutorial/04-global-and-yaml-configuration-strategy.md
index 732167bc..a53e4266 100644
--- a/tutorials/mini-swe-agent-tutorial/04-global-and-yaml-configuration-strategy.md
+++ b/tutorials/mini-swe-agent-tutorial/04-global-and-yaml-configuration-strategy.md
@@ -629,7 +629,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: CLI, Batch, and Inspector Workflows](03-cli-batch-and-inspector-workflows.md)
 - [Next Chapter: Chapter 5: Environments, Sandboxing, and Deployment](05-environments-sandboxing-and-deployment.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mini-swe-agent-tutorial/05-environments-sandboxing-and-deployment.md b/tutorials/mini-swe-agent-tutorial/05-environments-sandboxing-and-deployment.md
index a461de6b..d1655fc3 100644
--- a/tutorials/mini-swe-agent-tutorial/05-environments-sandboxing-and-deployment.md
+++ b/tutorials/mini-swe-agent-tutorial/05-environments-sandboxing-and-deployment.md
@@ -629,7 +629,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Global and YAML Configuration Strategy](04-global-and-yaml-configuration-strategy.md)
 - [Next Chapter: Chapter 6: Benchmarking and SWE-bench Practices](06-benchmarking-and-swe-bench-practices.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mini-swe-agent-tutorial/06-benchmarking-and-swe-bench-practices.md b/tutorials/mini-swe-agent-tutorial/06-benchmarking-and-swe-bench-practices.md
index 3256f08d..ef56051b 100644
--- a/tutorials/mini-swe-agent-tutorial/06-benchmarking-and-swe-bench-practices.md
+++ b/tutorials/mini-swe-agent-tutorial/06-benchmarking-and-swe-bench-practices.md
@@ -630,7 +630,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Environments, Sandboxing, and Deployment](05-environments-sandboxing-and-deployment.md)
 - [Next Chapter: Chapter 7: Cookbook Extensions and Python Bindings](07-cookbook-extensions-and-python-bindings.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mini-swe-agent-tutorial/07-cookbook-extensions-and-python-bindings.md b/tutorials/mini-swe-agent-tutorial/07-cookbook-extensions-and-python-bindings.md
index d8a835b2..4d53d999 100644
--- a/tutorials/mini-swe-agent-tutorial/07-cookbook-extensions-and-python-bindings.md
+++ b/tutorials/mini-swe-agent-tutorial/07-cookbook-extensions-and-python-bindings.md
@@ -629,7 +629,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Benchmarking and SWE-bench Practices](06-benchmarking-and-swe-bench-practices.md)
 - [Next Chapter: Chapter 8: Contribution Workflow and Governance](08-contribution-workflow-and-governance.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mini-swe-agent-tutorial/08-contribution-workflow-and-governance.md b/tutorials/mini-swe-agent-tutorial/08-contribution-workflow-and-governance.md
index 45d56404..0ec68e87 100644
--- a/tutorials/mini-swe-agent-tutorial/08-contribution-workflow-and-governance.md
+++ b/tutorials/mini-swe-agent-tutorial/08-contribution-workflow-and-governance.md
@@ -630,7 +630,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Cookbook Extensions and Python Bindings](07-cookbook-extensions-and-python-bindings.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/mini-swe-agent-tutorial/index.md b/tutorials/mini-swe-agent-tutorial/README.md
similarity index 100%
rename from tutorials/mini-swe-agent-tutorial/index.md
rename to tutorials/mini-swe-agent-tutorial/README.md
diff --git a/tutorials/mistral-vibe-tutorial/01-getting-started.md b/tutorials/mistral-vibe-tutorial/01-getting-started.md
index 9af3df1f..35ed83bb 100644
--- a/tutorials/mistral-vibe-tutorial/01-getting-started.md
+++ b/tutorials/mistral-vibe-tutorial/01-getting-started.md
@@ -631,7 +631,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Agent Profiles and Trust Model](02-agent-profiles-and-trust-model.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/mistral-vibe-tutorial/02-agent-profiles-and-trust-model.md b/tutorials/mistral-vibe-tutorial/02-agent-profiles-and-trust-model.md
index 1477e20d..df145d61 100644
--- a/tutorials/mistral-vibe-tutorial/02-agent-profiles-and-trust-model.md
+++ b/tutorials/mistral-vibe-tutorial/02-agent-profiles-and-trust-model.md
@@ -634,7 +634,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started](01-getting-started.md)
 - [Next Chapter: Chapter 3: Tooling and Approval Workflow](03-tooling-and-approval-workflow.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mistral-vibe-tutorial/03-tooling-and-approval-workflow.md b/tutorials/mistral-vibe-tutorial/03-tooling-and-approval-workflow.md
index 92cf762e..09fa8e19 100644
--- a/tutorials/mistral-vibe-tutorial/03-tooling-and-approval-workflow.md
+++ b/tutorials/mistral-vibe-tutorial/03-tooling-and-approval-workflow.md
@@ -633,7 +633,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Agent Profiles and Trust Model](02-agent-profiles-and-trust-model.md)
 - [Next Chapter: Chapter 4: Skills and Slash Command Extensions](04-skills-and-slash-command-extensions.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mistral-vibe-tutorial/04-skills-and-slash-command-extensions.md b/tutorials/mistral-vibe-tutorial/04-skills-and-slash-command-extensions.md
index 63d62913..4d9069e1 100644
--- a/tutorials/mistral-vibe-tutorial/04-skills-and-slash-command-extensions.md
+++ b/tutorials/mistral-vibe-tutorial/04-skills-and-slash-command-extensions.md
@@ -633,7 +633,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Tooling and Approval Workflow](03-tooling-and-approval-workflow.md)
 - [Next Chapter: Chapter 5: Subagents and Task Delegation](05-subagents-and-task-delegation.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mistral-vibe-tutorial/05-subagents-and-task-delegation.md b/tutorials/mistral-vibe-tutorial/05-subagents-and-task-delegation.md
index bb1b774a..61991425 100644
--- a/tutorials/mistral-vibe-tutorial/05-subagents-and-task-delegation.md
+++ b/tutorials/mistral-vibe-tutorial/05-subagents-and-task-delegation.md
@@ -632,7 +632,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Skills and Slash Command Extensions](04-skills-and-slash-command-extensions.md)
 - [Next Chapter: Chapter 6: Programmatic and Non-Interactive Modes](06-programmatic-and-non-interactive-modes.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mistral-vibe-tutorial/06-programmatic-and-non-interactive-modes.md b/tutorials/mistral-vibe-tutorial/06-programmatic-and-non-interactive-modes.md
index f2484f54..8ff8278c 100644
--- a/tutorials/mistral-vibe-tutorial/06-programmatic-and-non-interactive-modes.md
+++ b/tutorials/mistral-vibe-tutorial/06-programmatic-and-non-interactive-modes.md
@@ -636,7 +636,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Subagents and Task Delegation](05-subagents-and-task-delegation.md)
 - [Next Chapter: Chapter 7: ACP and Editor Integrations](07-acp-and-editor-integrations.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mistral-vibe-tutorial/07-acp-and-editor-integrations.md b/tutorials/mistral-vibe-tutorial/07-acp-and-editor-integrations.md
index 22436b46..001fe88e 100644
--- a/tutorials/mistral-vibe-tutorial/07-acp-and-editor-integrations.md
+++ b/tutorials/mistral-vibe-tutorial/07-acp-and-editor-integrations.md
@@ -627,7 +627,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Programmatic and Non-Interactive Modes](06-programmatic-and-non-interactive-modes.md)
 - [Next Chapter: Chapter 8: Production Operations and Governance](08-production-operations-and-governance.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/mistral-vibe-tutorial/08-production-operations-and-governance.md b/tutorials/mistral-vibe-tutorial/08-production-operations-and-governance.md
index e91c4c93..35deccb9 100644
--- a/tutorials/mistral-vibe-tutorial/08-production-operations-and-governance.md
+++ b/tutorials/mistral-vibe-tutorial/08-production-operations-and-governance.md
@@ -627,7 +627,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: ACP and Editor Integrations](07-acp-and-editor-integrations.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/mistral-vibe-tutorial/index.md b/tutorials/mistral-vibe-tutorial/README.md
similarity index 100%
rename from tutorials/mistral-vibe-tutorial/index.md
rename to tutorials/mistral-vibe-tutorial/README.md
diff --git a/tutorials/n8n-ai-tutorial/01-getting-started.md b/tutorials/n8n-ai-tutorial/01-getting-started.md
index 6af807a8..b57171e0 100644
--- a/tutorials/n8n-ai-tutorial/01-getting-started.md
+++ b/tutorials/n8n-ai-tutorial/01-getting-started.md
@@ -498,7 +498,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: AI Nodes and LLM Integration](02-ai-nodes.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/n8n-ai-tutorial/02-ai-nodes.md b/tutorials/n8n-ai-tutorial/02-ai-nodes.md
index 69ffab85..1f6d7872 100644
--- a/tutorials/n8n-ai-tutorial/02-ai-nodes.md
+++ b/tutorials/n8n-ai-tutorial/02-ai-nodes.md
@@ -661,7 +661,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started with n8n AI](01-getting-started.md)
 - [Next Chapter: Chapter 3: Document AI and Content Processing](03-document-ai.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/n8n-ai-tutorial/03-document-ai.md b/tutorials/n8n-ai-tutorial/03-document-ai.md
index 2271ad49..4730e8e1 100644
--- a/tutorials/n8n-ai-tutorial/03-document-ai.md
+++ b/tutorials/n8n-ai-tutorial/03-document-ai.md
@@ -641,7 +641,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: AI Nodes and LLM Integration](02-ai-nodes.md)
 - [Next Chapter: Chapter 4: Building AI Agents with Tools](04-ai-agents.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/n8n-ai-tutorial/04-ai-agents.md b/tutorials/n8n-ai-tutorial/04-ai-agents.md
index ba28ad4e..13dd38bf 100644
--- a/tutorials/n8n-ai-tutorial/04-ai-agents.md
+++ b/tutorials/n8n-ai-tutorial/04-ai-agents.md
@@ -597,7 +597,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Document AI and Content Processing](03-document-ai.md)
 - [Next Chapter: Chapter 5: Retrieval-Augmented Generation (RAG)](05-rag.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/n8n-ai-tutorial/05-rag.md b/tutorials/n8n-ai-tutorial/05-rag.md
index 09744588..bb3d3f95 100644
--- a/tutorials/n8n-ai-tutorial/05-rag.md
+++ b/tutorials/n8n-ai-tutorial/05-rag.md
@@ -547,7 +547,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Building AI Agents with Tools](04-ai-agents.md)
 - [Next Chapter: Chapter 6: AI-Powered Decision Making and Routing](06-decisions.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/n8n-ai-tutorial/06-decisions.md b/tutorials/n8n-ai-tutorial/06-decisions.md
index 3e7c7cc0..49294c62 100644
--- a/tutorials/n8n-ai-tutorial/06-decisions.md
+++ b/tutorials/n8n-ai-tutorial/06-decisions.md
@@ -387,7 +387,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Retrieval-Augmented Generation (RAG)](05-rag.md)
 - [Next Chapter: Chapter 7: Building Custom AI Tools and Integrations](07-custom-tools.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/n8n-ai-tutorial/07-custom-tools.md b/tutorials/n8n-ai-tutorial/07-custom-tools.md
index 6634bec3..a2f80c17 100644
--- a/tutorials/n8n-ai-tutorial/07-custom-tools.md
+++ b/tutorials/n8n-ai-tutorial/07-custom-tools.md
@@ -513,7 +513,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: AI-Powered Decision Making and Routing](06-decisions.md)
 - [Next Chapter: Chapter 8: Production Deployment and Scaling](08-production.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/n8n-ai-tutorial/08-production.md b/tutorials/n8n-ai-tutorial/08-production.md
index 64bc313b..9b12f978 100644
--- a/tutorials/n8n-ai-tutorial/08-production.md
+++ b/tutorials/n8n-ai-tutorial/08-production.md
@@ -570,7 +570,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Building Custom AI Tools and Integrations](07-custom-tools.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/n8n-ai-tutorial/index.md b/tutorials/n8n-ai-tutorial/README.md
similarity index 100%
rename from tutorials/n8n-ai-tutorial/index.md
rename to tutorials/n8n-ai-tutorial/README.md
diff --git a/tutorials/n8n-mcp-tutorial/README.md b/tutorials/n8n-mcp-tutorial/README.md
index 3d3509bf..f70868e5 100644
--- a/tutorials/n8n-mcp-tutorial/README.md
+++ b/tutorials/n8n-mcp-tutorial/README.md
@@ -1,273 +1,113 @@
-# n8n-MCP Tutorial - AI-Powered Workflow Automation Bridge
-
-[![GitHub Stars](https://img.shields.io/github/stars/czlonkowski/n8n-mcp?style=social)](https://github.com/czlonkowski/n8n-mcp)
-[![Documentation Status](https://img.shields.io/badge/docs-complete-brightgreen.svg)](https://github.com/czlonkowski/n8n-mcp)
-[![Tutorial Hours](https://img.shields.io/badge/tutorial-18--22%20hours-blue.svg)](#)
-[![Difficulty](https://img.shields.io/badge/difficulty-intermediate-orange.svg)](#)
-
-> **Master the Model Context Protocol by building a production-grade AI assistant bridge to n8n workflow automation**
-
-## 🎯 What You'll Learn
-
-This deep-dive tutorial reveals how **n8n-MCP** bridges AI assistants (like Claude) with n8n's 1,084+ workflow automation nodes through the Model Context Protocol. You'll understand:
-
-- **Model Context Protocol (MCP)** - How AI assistants communicate with external tools
-- **Production Architecture** - Multi-tenant, session-based, horizontally scalable design
-- **Data Processing** - Extracting and indexing 1,000+ node schemas with full-text search
-- **API Integration** - Robust REST client patterns with retry logic and version compatibility
-- **Tool Design** - Creating 15+ MCP tools for discovery, validation, and workflow management
-- **Real-World Deployment** - Docker, Kubernetes, serverless, and SaaS patterns
-
-## 💡 Why This Tutorial Matters
-
-### The Problem
-AI assistants know about n8n conceptually but lack deep knowledge of:
-- Specific node configurations and parameters
-- Real-world workflow patterns and examples
-- How to validate and fix workflow issues
-- Direct workflow creation and management capabilities
-
-### The Solution
-n8n-MCP transforms AI assistants from general consultants into n8n workflow experts by:
-- Providing instant access to 1,084+ node schemas
-- Offering 2,646+ real workflow examples
-- Enabling direct workflow CRUD operations
-- Validating and auto-fixing workflow configurations
-
-### Technical Sophistication
-- **99% property coverage** across all n8n nodes
-- **Sub-second search** through full-text indexing (SQLite FTS5)
-- **Multi-tenant architecture** with instance-level isolation
-- **Session persistence** for zero-downtime deployments
-- **Comprehensive validation** with automatic error correction
-
-## 🏗️ Core Architecture
-
-```
-┌─────────────────────────────────────────────────────────────┐
-│                     AI Assistant (Claude)                    │
-└────────────────────────┬────────────────────────────────────┘
-                         │ MCP Protocol (JSON-RPC)
-                         ▼
-┌─────────────────────────────────────────────────────────────┐
-│                      N8NMCPEngine                            │
-│  ┌──────────────────────────────────────────────────────┐  │
-│  │          SingleSessionHTTPServer                      │  │
-│  │  • Session Management                                 │  │
-│  │  • JSON-RPC & SSE Transport                          │  │
-│  └──────────────────────────────────────────────────────┘  │
-│                                                              │
-│  ┌──────────────────────────────────────────────────────┐  │
-│  │       N8NDocumentationMCPServer                       │  │
-│  │  ┌────────────────┐  ┌─────────────────────────┐    │  │
-│  │  │  MCP Tools     │  │  Data Layer             │    │  │
-│  │  │  • Discovery   │  │  • SQLiteStorage        │    │  │
-│  │  │  • Validation  │  │  • FTS5 Search          │    │  │
-│  │  │  • Workflow    │  │  • Node Schemas         │    │  │
-│  │  │    Management  │  │  • Template Library     │    │  │
-│  │  └────────────────┘  └─────────────────────────┘    │  │
-│  └──────────────────────────────────────────────────────┘  │
-│                                                              │
-│  ┌──────────────────────────────────────────────────────┐  │
-│  │            N8nApiClient                               │  │
-│  │  • Version Detection                                  │  │
-│  │  • Retry Logic                                        │  │
-│  │  • Error Handling                                     │  │
-│  └──────────────────────────────────────────────────────┘  │
-└────────────────────────┬────────────────────────────────────┘
-                         │ REST API
-                         ▼
-┌─────────────────────────────────────────────────────────────┐
-│                    n8n Instance(s)                           │
-└─────────────────────────────────────────────────────────────┘
-```
-
-## 📚 Tutorial Structure
-
-### **Part 1: Foundation** (4-5 hours)
-1. **[Understanding MCP Protocol](01_mcp_protocol.md)** - Protocol fundamentals and n8n integration overview
-2. **[N8NMCPEngine Architecture](02_engine_architecture.md)** - Core integration interface and API design
-
-### **Part 2: Infrastructure** (6-7 hours)
-3. **[Session Management & HTTP Server](03_session_management.md)** - Stateful conversations and transport protocols
-4. **[N8nApiClient Communication](04_api_client.md)** - Robust REST client with retry logic
-5. **[SQLiteStorageService Data Layer](05_data_storage.md)** - High-performance node indexing
-
-### **Part 3: Advanced Patterns** (8-10 hours)
-6. **[Instance Context & Multi-tenancy](06_instance_context.md)** - Flexible configuration and SaaS patterns
-7. **[MCP Tools Architecture](07_mcp_tools.md)** - 15+ tool ecosystem overview
-8. **[Discovery Tools](08_discovery_tools.md)** - Intelligent node search and filtering
-9. **[Workflow Management Tools](09_workflow_management.md)** - Direct workflow CRUD operations
-
-## 🎓 Who Should Read This
-
-### Perfect For:
-- **AI Engineers** building MCP servers or AI tool integrations
-- **Backend Developers** creating API bridges and multi-tenant platforms
-- **DevOps Engineers** deploying production AI assistant infrastructure
-- **System Architects** designing scalable AI tool ecosystems
-
-### Prerequisites:
-- TypeScript/JavaScript proficiency
-- REST API experience
-- Basic understanding of workflow automation
-- Familiarity with SQLite (helpful but not required)
-
-### Difficulty Level: **Intermediate to Advanced**
-This tutorial assumes solid programming fundamentals and introduces advanced architectural patterns for production systems.
-
-## 🚀 What Makes This Tutorial Special
-
-### ✅ Real Production Code
-Every example comes from the actual n8n-MCP codebase—no toy examples or simplified demos. You'll see:
-- Complete class implementations with error handling
-- Production deployment configurations (Docker, K8s)
-- Multi-tenant isolation patterns
-- Performance optimization strategies
-
-### ✅ Visual Learning
-- **15+ Mermaid diagrams** showing system flows and relationships
-- **Architecture overviews** for each major component
-- **Sequence diagrams** for request/response patterns
-- **Decision trees** for configuration hierarchies
-
-### ✅ Progressive Complexity
-Start with MCP fundamentals, build through infrastructure layers, master advanced patterns:
-```
-Protocol Basics → Core Engine → Infrastructure → Advanced Patterns
-     ↓                ↓               ↓                  ↓
- Understand      Integrate        Deploy             Optimize
-```
-
-### ✅ Hands-On Focus
-- **50+ code examples** with line-by-line explanations
-- **Real-world scenarios** (email automation, social media, e-commerce)
-- **Testing strategies** for each component
-- **Debugging tips** and troubleshooting guides
-
-## 📈 Learning Outcomes
-
-After completing this tutorial, you'll be able to:
-
-1. **Design MCP Servers** - Build production-grade Model Context Protocol servers
-2. **Implement Tool Ecosystems** - Create comprehensive tool suites for AI assistants
-3. **Architect Multi-tenant Systems** - Handle instance isolation and flexible configuration
-4. **Optimize Data Access** - Use SQLite FTS5 for millisecond searches across large datasets
-5. **Deploy at Scale** - Containerize, orchestrate, and monitor AI assistant integrations
-
-## 🔗 Repository & Resources
-
-- **Source Code**: [github.com/czlonkowski/n8n-mcp](https://github.com/czlonkowski/n8n-mcp)
-- **npm Package**: [npmjs.com/package/n8n-mcp](https://www.npmjs.com/package/n8n-mcp)
-- **Live Demo**: [dashboard.n8n-mcp.com](https://dashboard.n8n-mcp.com)
-- **Tutorial Files**: Complete 9-chapter tutorial with examples
-
-## 📊 Tutorial Metrics
-
-| Metric | Value |
-|--------|-------|
-| **Total Content** | ~50,000 words |
-| **Code Examples** | 50+ implementations |
-| **Diagrams** | 15+ Mermaid flowcharts |
-| **Chapters** | 9 comprehensive chapters |
-| **Estimated Time** | 18-22 hours |
-| **Difficulty** | Intermediate-Advanced |
-| **Last Updated** | January 2026 |
-
-## 🛠️ Technologies Covered
-
-- **Languages**: TypeScript, Node.js
-- **Protocols**: Model Context Protocol (MCP), JSON-RPC, SSE
-- **Databases**: SQLite, FTS5 full-text search
-- **APIs**: REST, n8n API
-- **Deployment**: Docker, Kubernetes, Serverless
-- **Patterns**: Multi-tenancy, Session Management, Circuit Breakers
-
-## 🎯 Key Concepts Explained
-
-### Model Context Protocol (MCP)
-Learn how AI assistants discover and use external tools through standardized JSON-RPC communication.
-
-### Instance Context Pattern
-Master flexible configuration that supports single-tenant, multi-tenant, and hybrid deployments without code changes.
-
-### Tool Design Principles
-Understand how to create AI assistant tools that are discoverable, composable, and production-ready.
-
-### Session Persistence
-Implement zero-downtime deployments with session state export/import for containerized environments.
-
-## 💻 Code Examples Preview
-
-### Creating Workflows with AI
-```typescript
-// AI assistant creates workflow from natural language
-const workflow = await mcpEngine.processRequest(req, res, {
-  instanceId: 'tenant-123',
-  n8nApiUrl: 'https://n8n.company.com',
-  n8nApiKey: process.env.N8N_API_KEY
-});
-
-// Result: Fully configured, validated workflow deployed to n8n
-```
+---
+layout: default
+title: "n8n MCP Tutorial"
+nav_order: 88
+has_children: true
+---
 
-### Intelligent Node Discovery
-```typescript
-// Search 1,000+ nodes in milliseconds
-const nodes = await searchNodes({
-  query: "email automation",
-  category: "Communication",
-  is_ai_tool: false,
-  limit: 10
-});
-// Returns: Gmail, Outlook, SendGrid, etc. with full schemas
+# n8n Model Context Protocol: Deep Dive Tutorial
+
+> **Project**: [n8n](https://github.com/n8n-io/n8n) — Visual workflow automation with Model Context Protocol (MCP) integration for AI-powered tool use.
+
+[![Stars](https://img.shields.io/github/stars/n8n-io/n8n?style=social)](https://github.com/n8n-io/n8n)
+[![License: Sustainable Use](https://img.shields.io/badge/License-Sustainable_Use-blue.svg)](https://github.com/n8n-io/n8n/blob/master/LICENSE.md)
+[![TypeScript](https://img.shields.io/badge/TypeScript-Node.js-blue)](https://github.com/n8n-io/n8n)
+
+## What Is This Tutorial?
+
+This tutorial covers n8n's integration with the Model Context Protocol (MCP) — the open standard for connecting AI models to external tools and data sources. Learn how n8n implements MCP servers, manages sessions, and exposes workflow automation as AI-callable tools.
+
+| Feature | Description |
+|---------|-------------|
+| **MCP Protocol** | Anthropic's standard for AI-tool communication |
+| **Session Management** | Multi-tenant session handling with lifecycle |
+| **Tool Discovery** | Dynamic tool registration and schema generation |
+| **Workflow Integration** | Expose n8n workflows as MCP-callable tools |
+| **Data Storage** | Persistent context and state management |
+
+## Architecture Overview
+
+```mermaid
+graph TB
+    subgraph AI["AI Client"]
+        LLM[LLM / Claude]
+        CLIENT[MCP Client]
+    end
+
+    subgraph N8N["n8n MCP Server"]
+        PROTO[Protocol Handler]
+        SESSION[Session Manager]
+        TOOLS[Tool Registry]
+        CONTEXT[Instance Context]
+    end
+
+    subgraph Backend["n8n Engine"]
+        WF[Workflow Engine]
+        STORE[(Data Store)]
+        DISC[Discovery Service]
+    end
+
+    CLIENT --> PROTO
+    PROTO --> SESSION
+    SESSION --> TOOLS
+    TOOLS --> WF
+    CONTEXT --> STORE
+    DISC --> TOOLS
 ```
 
-## 🌟 Community & Support
-
-- **GitHub Stars**: 17+ (and growing)
-- **Production Users**: Multiple SaaS deployments
-- **Active Development**: Regular updates and improvements
-- **Documentation**: Comprehensive API docs and examples
-
-## 📖 Related Tutorials
-
-If you enjoyed this tutorial, you might also like:
-- **LangChain Tutorial** - Building AI chains and agents
-- **Dify Platform Deep-Dive** - LLMOps and AI application frameworks
-- **Supabase Tutorial** - Real-time backend infrastructure
+## Tutorial Structure
+
+| Chapter | Topic | What You'll Learn |
+|---------|-------|-------------------|
+| [1. MCP Protocol](01_mcp_protocol.md) | Foundation | Protocol spec, message types, transport |
+| [2. Engine Architecture](02_engine_architecture.md) | Core | MCP server engine, request routing |
+| [3. Session Management](03_session_management.md) | Sessions | Multi-tenant sessions, lifecycle, state |
+| [4. API Client](04_api_client.md) | Client | MCP client implementation, auth |
+| [5. Data Storage](05_data_storage.md) | Persistence | Context storage, state management |
+| [6. Instance Context](06_instance_context.md) | Context | Environment config, tenant isolation |
+| [7. MCP Tools](07_mcp_tools.md) | Tools | Tool definition, schema, execution |
+| [8. Discovery Tools](08_discovery_tools.md) | Discovery | Dynamic tool registration, catalog |
+| [9. Workflow Management](09_workflow_management.md) | Workflows | Exposing workflows as MCP tools |
+
+## Tech Stack
+
+| Component | Technology |
+|-----------|-----------|
+| **Runtime** | Node.js, TypeScript |
+| **Protocol** | Model Context Protocol (MCP) |
+| **Transport** | JSON-RPC over stdio / HTTP |
+| **Platform** | n8n workflow engine |
 
 ---
 
-## 🚦 Getting Started
+Ready to begin? Start with [Chapter 1: MCP Protocol](01_mcp_protocol.md).
 
-1. **Clone the repository**
-   ```bash
-   git clone https://github.com/czlonkowski/n8n-mcp.git
-   cd n8n-mcp
-   ```
+---
 
-2. **Start with Chapter 1**
-   - Read [Understanding MCP Protocol](01_mcp_protocol.md)
-   - Follow along with code examples
-   - Experiment with the provided implementations
+*Built with insights from the [n8n repository](https://github.com/n8n-io/n8n) and MCP specification.*
 
-3. **Build Your Understanding**
-   - Progress through chapters sequentially
-   - Try the hands-on exercises
-   - Explore the production codebase
+## Navigation & Backlinks
 
-4. **Apply Your Knowledge**
-   - Deploy your own MCP server
-   - Build custom tools for AI assistants
-   - Contribute improvements back to the project
+- [Start Here: Chapter 1: Understanding MCP Protocol and n8n Integration](01_mcp_protocol.md)
+- [Back to Main Catalog](../../README.md#-tutorial-catalog)
+- [Browse A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
+- [Search by Intent](../../discoverability/query-hub.md)
+- [Explore Category Hubs](../../README.md#category-hubs)
 
----
+## Full Chapter Map
 
-**Ready to transform AI assistants into n8n workflow automation experts?**
+1. [Chapter 1: Understanding MCP Protocol and n8n Integration](01_mcp_protocol.md)
+2. [Chapter 2: The N8NMCPEngine - Core Integration Interface](02_engine_architecture.md)
+3. [Chapter 3: Session Management and HTTP Server](03_session_management.md)
+4. [Chapter 4: N8nApiClient - Communicating with n8n](04_api_client.md)
+5. [Chapter 5: Data Storage with SQLiteStorageService](05_data_storage.md)
+6. [Chapter 6: Instance Context and Multi-tenancy](06_instance_context.md)
+7. [Chapter 7: MCP Tools Architecture](07_mcp_tools.md)
+8. [Chapter 8: Discovery Tools - Finding n8n Nodes](08_discovery_tools.md)
+9. [Chapter 9: Workflow Management Tools](09_workflow_management.md)
 
-**[Start Chapter 1: Understanding MCP Protocol →](01_mcp_protocol.md)**
+## Source References
 
----
+- [n8n](https://github.com/n8n-io/n8n)
 
-*This tutorial is part of the [Awesome Code Docs](https://github.com/johnxie/awesome-code-docs) collection - transforming complex systems into accessible learning experiences.*
+*Generated by [AI Codebase Knowledge Builder](https://github.com/The-Pocket/Tutorial-Codebase-Knowledge)*
diff --git a/tutorials/n8n-mcp-tutorial/index.md b/tutorials/n8n-mcp-tutorial/index.md
deleted file mode 100644
index f70868e5..00000000
--- a/tutorials/n8n-mcp-tutorial/index.md
+++ /dev/null
@@ -1,113 +0,0 @@
----
-layout: default
-title: "n8n MCP Tutorial"
-nav_order: 88
-has_children: true
----
-
-# n8n Model Context Protocol: Deep Dive Tutorial
-
-> **Project**: [n8n](https://github.com/n8n-io/n8n) — Visual workflow automation with Model Context Protocol (MCP) integration for AI-powered tool use.
-
-[![Stars](https://img.shields.io/github/stars/n8n-io/n8n?style=social)](https://github.com/n8n-io/n8n)
-[![License: Sustainable Use](https://img.shields.io/badge/License-Sustainable_Use-blue.svg)](https://github.com/n8n-io/n8n/blob/master/LICENSE.md)
-[![TypeScript](https://img.shields.io/badge/TypeScript-Node.js-blue)](https://github.com/n8n-io/n8n)
-
-## What Is This Tutorial?
-
-This tutorial covers n8n's integration with the Model Context Protocol (MCP) — the open standard for connecting AI models to external tools and data sources. Learn how n8n implements MCP servers, manages sessions, and exposes workflow automation as AI-callable tools.
-
-| Feature | Description |
-|---------|-------------|
-| **MCP Protocol** | Anthropic's standard for AI-tool communication |
-| **Session Management** | Multi-tenant session handling with lifecycle |
-| **Tool Discovery** | Dynamic tool registration and schema generation |
-| **Workflow Integration** | Expose n8n workflows as MCP-callable tools |
-| **Data Storage** | Persistent context and state management |
-
-## Architecture Overview
-
-```mermaid
-graph TB
-    subgraph AI["AI Client"]
-        LLM[LLM / Claude]
-        CLIENT[MCP Client]
-    end
-
-    subgraph N8N["n8n MCP Server"]
-        PROTO[Protocol Handler]
-        SESSION[Session Manager]
-        TOOLS[Tool Registry]
-        CONTEXT[Instance Context]
-    end
-
-    subgraph Backend["n8n Engine"]
-        WF[Workflow Engine]
-        STORE[(Data Store)]
-        DISC[Discovery Service]
-    end
-
-    CLIENT --> PROTO
-    PROTO --> SESSION
-    SESSION --> TOOLS
-    TOOLS --> WF
-    CONTEXT --> STORE
-    DISC --> TOOLS
-```
-
-## Tutorial Structure
-
-| Chapter | Topic | What You'll Learn |
-|---------|-------|-------------------|
-| [1. MCP Protocol](01_mcp_protocol.md) | Foundation | Protocol spec, message types, transport |
-| [2. Engine Architecture](02_engine_architecture.md) | Core | MCP server engine, request routing |
-| [3. Session Management](03_session_management.md) | Sessions | Multi-tenant sessions, lifecycle, state |
-| [4. API Client](04_api_client.md) | Client | MCP client implementation, auth |
-| [5. Data Storage](05_data_storage.md) | Persistence | Context storage, state management |
-| [6. Instance Context](06_instance_context.md) | Context | Environment config, tenant isolation |
-| [7. MCP Tools](07_mcp_tools.md) | Tools | Tool definition, schema, execution |
-| [8. Discovery Tools](08_discovery_tools.md) | Discovery | Dynamic tool registration, catalog |
-| [9. Workflow Management](09_workflow_management.md) | Workflows | Exposing workflows as MCP tools |
-
-## Tech Stack
-
-| Component | Technology |
-|-----------|-----------|
-| **Runtime** | Node.js, TypeScript |
-| **Protocol** | Model Context Protocol (MCP) |
-| **Transport** | JSON-RPC over stdio / HTTP |
-| **Platform** | n8n workflow engine |
-
----
-
-Ready to begin? Start with [Chapter 1: MCP Protocol](01_mcp_protocol.md).
-
----
-
-*Built with insights from the [n8n repository](https://github.com/n8n-io/n8n) and MCP specification.*
-
-## Navigation & Backlinks
-
-- [Start Here: Chapter 1: Understanding MCP Protocol and n8n Integration](01_mcp_protocol.md)
-- [Back to Main Catalog](../../README.md#-tutorial-catalog)
-- [Browse A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
-- [Search by Intent](../../discoverability/query-hub.md)
-- [Explore Category Hubs](../../README.md#category-hubs)
-
-## Full Chapter Map
-
-1. [Chapter 1: Understanding MCP Protocol and n8n Integration](01_mcp_protocol.md)
-2. [Chapter 2: The N8NMCPEngine - Core Integration Interface](02_engine_architecture.md)
-3. [Chapter 3: Session Management and HTTP Server](03_session_management.md)
-4. [Chapter 4: N8nApiClient - Communicating with n8n](04_api_client.md)
-5. [Chapter 5: Data Storage with SQLiteStorageService](05_data_storage.md)
-6. [Chapter 6: Instance Context and Multi-tenancy](06_instance_context.md)
-7. [Chapter 7: MCP Tools Architecture](07_mcp_tools.md)
-8. [Chapter 8: Discovery Tools - Finding n8n Nodes](08_discovery_tools.md)
-9. [Chapter 9: Workflow Management Tools](09_workflow_management.md)
-
-## Source References
-
-- [n8n](https://github.com/n8n-io/n8n)
-
-*Generated by [AI Codebase Knowledge Builder](https://github.com/The-Pocket/Tutorial-Codebase-Knowledge)*
diff --git a/tutorials/nanocoder-tutorial/01-getting-started.md b/tutorials/nanocoder-tutorial/01-getting-started.md
index 964d6f05..dd18f2a1 100644
--- a/tutorials/nanocoder-tutorial/01-getting-started.md
+++ b/tutorials/nanocoder-tutorial/01-getting-started.md
@@ -633,7 +633,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Architecture & Agent Loop](02-architecture-agent-loop.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/nanocoder-tutorial/02-architecture-agent-loop.md b/tutorials/nanocoder-tutorial/02-architecture-agent-loop.md
index b5bc06bf..d0df9e20 100644
--- a/tutorials/nanocoder-tutorial/02-architecture-agent-loop.md
+++ b/tutorials/nanocoder-tutorial/02-architecture-agent-loop.md
@@ -641,7 +641,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started](01-getting-started.md)
 - [Next Chapter: Chapter 3: Tool System Internals](03-tool-system-internals.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/nanocoder-tutorial/03-tool-system-internals.md b/tutorials/nanocoder-tutorial/03-tool-system-internals.md
index 7d7e8442..c8b3e668 100644
--- a/tutorials/nanocoder-tutorial/03-tool-system-internals.md
+++ b/tutorials/nanocoder-tutorial/03-tool-system-internals.md
@@ -631,7 +631,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Architecture & Agent Loop](02-architecture-agent-loop.md)
 - [Next Chapter: Chapter 4: Multi-Provider Integration](04-multi-provider-integration.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/nanocoder-tutorial/04-multi-provider-integration.md b/tutorials/nanocoder-tutorial/04-multi-provider-integration.md
index 76e622a3..f7c8c429 100644
--- a/tutorials/nanocoder-tutorial/04-multi-provider-integration.md
+++ b/tutorials/nanocoder-tutorial/04-multi-provider-integration.md
@@ -636,7 +636,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Tool System Internals](03-tool-system-internals.md)
 - [Next Chapter: Chapter 5: Context Management](05-context-management.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/nanocoder-tutorial/05-context-management.md b/tutorials/nanocoder-tutorial/05-context-management.md
index 2deac33a..183dbdac 100644
--- a/tutorials/nanocoder-tutorial/05-context-management.md
+++ b/tutorials/nanocoder-tutorial/05-context-management.md
@@ -641,7 +641,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Multi-Provider Integration](04-multi-provider-integration.md)
 - [Next Chapter: Chapter 6: Configuration & Customization](06-configuration-customization.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/nanocoder-tutorial/06-configuration-customization.md b/tutorials/nanocoder-tutorial/06-configuration-customization.md
index 8f0ed07a..d053879e 100644
--- a/tutorials/nanocoder-tutorial/06-configuration-customization.md
+++ b/tutorials/nanocoder-tutorial/06-configuration-customization.md
@@ -641,7 +641,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Context Management](05-context-management.md)
 - [Next Chapter: Chapter 7: Building Your Own Agent](07-building-your-own-agent.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/nanocoder-tutorial/07-building-your-own-agent.md b/tutorials/nanocoder-tutorial/07-building-your-own-agent.md
index 97b5ee84..0d2b4441 100644
--- a/tutorials/nanocoder-tutorial/07-building-your-own-agent.md
+++ b/tutorials/nanocoder-tutorial/07-building-your-own-agent.md
@@ -685,7 +685,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Configuration & Customization](06-configuration-customization.md)
 - [Next Chapter: Chapter 8: Production Patterns & Security](08-production-patterns-security.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/nanocoder-tutorial/08-production-patterns-security.md b/tutorials/nanocoder-tutorial/08-production-patterns-security.md
index fadcf517..7530b2b7 100644
--- a/tutorials/nanocoder-tutorial/08-production-patterns-security.md
+++ b/tutorials/nanocoder-tutorial/08-production-patterns-security.md
@@ -669,7 +669,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Building Your Own Agent](07-building-your-own-agent.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/nanocoder-tutorial/index.md b/tutorials/nanocoder-tutorial/README.md
similarity index 100%
rename from tutorials/nanocoder-tutorial/index.md
rename to tutorials/nanocoder-tutorial/README.md
diff --git a/tutorials/nocodb-database-platform/01-system-overview.md b/tutorials/nocodb-database-platform/01-system-overview.md
index 144c7885..7cc2e983 100644
--- a/tutorials/nocodb-database-platform/01-system-overview.md
+++ b/tutorials/nocodb-database-platform/01-system-overview.md
@@ -479,7 +479,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Database Abstraction Layer](02-database-abstraction.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/nocodb-database-platform/02-database-abstraction.md b/tutorials/nocodb-database-platform/02-database-abstraction.md
index b030dbac..c4b97073 100644
--- a/tutorials/nocodb-database-platform/02-database-abstraction.md
+++ b/tutorials/nocodb-database-platform/02-database-abstraction.md
@@ -974,7 +974,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: NocoDB System Overview](01-system-overview.md)
 - [Next Chapter: Chapter 3: Schema Management](03-schema-management.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/nocodb-database-platform/03-schema-management.md b/tutorials/nocodb-database-platform/03-schema-management.md
index 5da6d8cf..5653c6a8 100644
--- a/tutorials/nocodb-database-platform/03-schema-management.md
+++ b/tutorials/nocodb-database-platform/03-schema-management.md
@@ -893,7 +893,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Database Abstraction Layer](02-database-abstraction.md)
 - [Next Chapter: Chapter 4: API Generation Engine](04-api-generation.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/nocodb-database-platform/04-api-generation.md b/tutorials/nocodb-database-platform/04-api-generation.md
index 1a2b77e1..a2b5a102 100644
--- a/tutorials/nocodb-database-platform/04-api-generation.md
+++ b/tutorials/nocodb-database-platform/04-api-generation.md
@@ -906,7 +906,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Schema Management](03-schema-management.md)
 - [Next Chapter: Chapter 5: Query Builder](05-query-builder.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/nocodb-database-platform/05-query-builder.md b/tutorials/nocodb-database-platform/05-query-builder.md
index 4131fa78..5309443b 100644
--- a/tutorials/nocodb-database-platform/05-query-builder.md
+++ b/tutorials/nocodb-database-platform/05-query-builder.md
@@ -88,7 +88,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: API Generation Engine](04-api-generation.md)
 - [Next Chapter: Chapter 6: Auth System](06-auth-system.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/nocodb-database-platform/06-auth-system.md b/tutorials/nocodb-database-platform/06-auth-system.md
index 1474e593..579a2eb4 100644
--- a/tutorials/nocodb-database-platform/06-auth-system.md
+++ b/tutorials/nocodb-database-platform/06-auth-system.md
@@ -89,7 +89,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Query Builder](05-query-builder.md)
 - [Next Chapter: Chapter 7: Vue Components](07-vue-components.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/nocodb-database-platform/07-vue-components.md b/tutorials/nocodb-database-platform/07-vue-components.md
index ab435505..befd7dac 100644
--- a/tutorials/nocodb-database-platform/07-vue-components.md
+++ b/tutorials/nocodb-database-platform/07-vue-components.md
@@ -87,7 +87,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Auth System](06-auth-system.md)
 - [Next Chapter: Chapter 8: Realtime Features](08-realtime-features.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/nocodb-database-platform/08-realtime-features.md b/tutorials/nocodb-database-platform/08-realtime-features.md
index c095eccf..f57e9035 100644
--- a/tutorials/nocodb-database-platform/08-realtime-features.md
+++ b/tutorials/nocodb-database-platform/08-realtime-features.md
@@ -42,7 +42,7 @@ Use explicit conflict semantics:
 You now have complete NocoDB foundations from schema and API design through realtime multi-user consistency.
 
 Related:
-- [NocoDB Index](index.md)
+- [NocoDB Index](README.md)
 - [Setup Guide](docs/setup.md)
 
 ## What Problem Does This Solve?
@@ -85,7 +85,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Vue Components](07-vue-components.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/nocodb-database-platform/README.md b/tutorials/nocodb-database-platform/README.md
index d1abb1bf..fa9ec3c2 100644
--- a/tutorials/nocodb-database-platform/README.md
+++ b/tutorials/nocodb-database-platform/README.md
@@ -1,40 +1,136 @@
-# NocoDB Database Platform Deep Dive
+---
+layout: default
+title: "NocoDB Database Platform"
+nav_order: 38
+has_children: true
+format_version: v2
+---
+
+# NocoDB: Deep Dive Tutorial
+
+> **Project**: [NocoDB](https://github.com/nocodb/nocodb) — An open-source Airtable alternative that turns any database into a smart spreadsheet.
+
+[![Stars](https://img.shields.io/github/stars/nocodb/nocodb?style=social)](https://github.com/nocodb/nocodb)
+[![License: AGPL v3](https://img.shields.io/badge/License-AGPL_v3-blue.svg)](https://www.gnu.org/licenses/agpl-3.0)
+[![Node.js](https://img.shields.io/badge/Node.js-Vue.js-green)](https://github.com/nocodb/nocodb)
+
+## Why This Track Matters
+
+NocoDB lets teams build collaborative no-code applications on top of their existing databases without rewriting their data layer — turning any SQL database into an Airtable-like interface with auto-generated APIs.
+
+This track focuses on:
+- connecting NocoDB to MySQL, PostgreSQL, SQLite, and SQL Server
+- understanding automatic REST API generation from database schemas
+- implementing RBAC, authentication, and audit logging
+- deploying NocoDB with Docker for full self-hosted data ownership
+
+## What Is NocoDB?
+
+NocoDB transforms any SQL database (MySQL, PostgreSQL, SQL Server, SQLite) into a spreadsheet-like interface with auto-generated REST APIs. It provides a no-code layer over existing databases, enabling teams to build applications without rewriting their data layer.
+
+| Feature | Description |
+|---------|-------------|
+| **Database Abstraction** | Connect to MySQL, PostgreSQL, SQL Server, SQLite |
+| **Spreadsheet UI** | Grid, gallery, kanban, and form views |
+| **Auto REST API** | Automatic API generation from database schema |
+| **Collaboration** | Real-time multi-user editing with roles and permissions |
+| **Plugin System** | Extensible with custom field types and integrations |
+| **Self-Hosted** | Full Docker deployment, data stays on your infrastructure |
+
+## Mental Model
 
-A focused architecture walkthrough of NocoDB's database abstraction approach.
+```mermaid
+graph TB
+    subgraph Frontend["Vue.js Frontend"]
+        GRID[Grid View]
+        GALLERY[Gallery View]
+        KANBAN[Kanban View]
+        FORM[Form Builder]
+    end
 
-## Current Status
+    subgraph Backend["Node.js Backend"]
+        API[REST API Engine]
+        QB[Query Builder]
+        SCHEMA[Schema Manager]
+        AUTH[Auth & Roles]
+    end
 
-Core chapter set is now published.
+    subgraph Databases["Connected Databases"]
+        PG[(PostgreSQL)]
+        MYSQL[(MySQL)]
+        SQLITE[(SQLite)]
+        MSSQL[(SQL Server)]
+    end
 
-| Item | Status |
-|:-----|:-------|
-| Published chapter docs | 8 + setup guide |
-| Canonical entry point | [index.md](index.md) |
+    Frontend --> Backend
+    Backend --> Databases
+```
 
-## Published Chapters
+## Chapter Guide
 
-| Chapter | File | Focus |
-|:--------|:-----|:------|
-| 1 | [01-system-overview.md](01-system-overview.md) | System overview and architecture |
-| 2 | [02-database-abstraction.md](02-database-abstraction.md) | Multi-database abstraction layer |
-| 3 | [03-schema-management.md](03-schema-management.md) | Dynamic schema handling |
-| 4 | [04-api-generation.md](04-api-generation.md) | API generation architecture |
-| 5 | [05-query-builder.md](05-query-builder.md) | Query builder internals |
-| 6 | [06-auth-system.md](06-auth-system.md) | Auth and permission model |
-| 7 | [07-vue-components.md](07-vue-components.md) | Frontend component architecture |
-| 8 | [08-realtime-features.md](08-realtime-features.md) | Realtime collaboration pipeline |
-| Setup | [docs/setup.md](docs/setup.md) | Environment setup for code exploration |
+| Chapter | Topic | What You'll Learn |
+|---------|-------|-------------------|
+| [1. System Overview](01-system-overview.md) | Architecture | NocoDB's approach to database abstraction |
+| [2. Database Abstraction](02-database-abstraction.md) | Connectors | Multi-database support and schema mapping |
+| [3. Schema Management](03-schema-management.md) | Data Model | Dynamic table/field handling and migrations |
+| [4. API Generation](04-api-generation.md) | APIs | Automatic REST endpoint creation |
+| [5. Query Builder](05-query-builder.md) | Querying | Translating UI/API filters into SQL safely |
+| [6. Auth System](06-auth-system.md) | Security | Authentication, RBAC, and auditability |
+| [7. Vue Components](07-vue-components.md) | Frontend | Grid/editor component architecture |
+| [8. Realtime Features](08-realtime-features.md) | Collaboration | Event streams, optimistic updates, and conflict handling |
 
-## Suggested Reading Order
+## Tech Stack
 
-1. Start with [index.md](index.md).
-2. Read chapters [1](01-system-overview.md) through [8](08-realtime-features.md) in order.
-3. Use [docs/setup.md](docs/setup.md) for hands-on setup.
+| Component | Technology |
+|-----------|-----------|
+| **Backend** | Node.js, Express, Knex.js |
+| **Frontend** | Vue.js, Nuxt |
+| **Databases** | PostgreSQL, MySQL, SQLite, SQL Server |
+| **Auth** | JWT, role-based access control |
+| **Deployment** | Docker, npm |
 
-## Upstream Project
+---
 
-- NocoDB repository: <https://github.com/nocodb/nocodb>
+Ready to begin? Start with [Chapter 1: System Overview](01-system-overview.md).
 
 ---
 
-Part of [Awesome Code Docs](../../README.md)
+*Built with insights from the [NocoDB repository](https://github.com/nocodb/nocodb) and community documentation.*
+
+## Navigation & Backlinks
+
+- [Start Here: Chapter 1: NocoDB System Overview](01-system-overview.md)
+- [Back to Main Catalog](../../README.md#-tutorial-catalog)
+- [Browse A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
+- [Search by Intent](../../discoverability/query-hub.md)
+- [Explore Category Hubs](../../README.md#category-hubs)
+
+## Full Chapter Map
+
+1. [Chapter 1: NocoDB System Overview](01-system-overview.md)
+2. [Chapter 2: Database Abstraction Layer](02-database-abstraction.md)
+3. [Chapter 3: Schema Management](03-schema-management.md)
+4. [Chapter 4: API Generation Engine](04-api-generation.md)
+5. [Chapter 5: Query Builder](05-query-builder.md)
+6. [Chapter 6: Auth System](06-auth-system.md)
+7. [Chapter 7: Vue Components](07-vue-components.md)
+8. [Chapter 8: Realtime Features](08-realtime-features.md)
+
+## Current Snapshot (auto-updated)
+
+- repository: [nocodb/nocodb](https://github.com/nocodb/nocodb)
+- stars: about **48K**
+- project positioning: open-source Airtable alternative built on top of existing SQL databases
+
+## What You Will Learn
+
+- how NocoDB abstracts multiple SQL databases behind a unified spreadsheet-like interface
+- how automatic REST API generation works from existing database schemas
+- how the query builder safely translates UI filters into parameterized SQL
+- how to implement RBAC, configure authentication, and deploy NocoDB with Docker
+
+## Source References
+
+- [NocoDB](https://github.com/nocodb/nocodb)
+
+*Generated by [AI Codebase Knowledge Builder](https://github.com/The-Pocket/Tutorial-Codebase-Knowledge)*
diff --git a/tutorials/nocodb-database-platform/index.md b/tutorials/nocodb-database-platform/index.md
deleted file mode 100644
index fa9ec3c2..00000000
--- a/tutorials/nocodb-database-platform/index.md
+++ /dev/null
@@ -1,136 +0,0 @@
----
-layout: default
-title: "NocoDB Database Platform"
-nav_order: 38
-has_children: true
-format_version: v2
----
-
-# NocoDB: Deep Dive Tutorial
-
-> **Project**: [NocoDB](https://github.com/nocodb/nocodb) — An open-source Airtable alternative that turns any database into a smart spreadsheet.
-
-[![Stars](https://img.shields.io/github/stars/nocodb/nocodb?style=social)](https://github.com/nocodb/nocodb)
-[![License: AGPL v3](https://img.shields.io/badge/License-AGPL_v3-blue.svg)](https://www.gnu.org/licenses/agpl-3.0)
-[![Node.js](https://img.shields.io/badge/Node.js-Vue.js-green)](https://github.com/nocodb/nocodb)
-
-## Why This Track Matters
-
-NocoDB lets teams build collaborative no-code applications on top of their existing databases without rewriting their data layer — turning any SQL database into an Airtable-like interface with auto-generated APIs.
-
-This track focuses on:
-- connecting NocoDB to MySQL, PostgreSQL, SQLite, and SQL Server
-- understanding automatic REST API generation from database schemas
-- implementing RBAC, authentication, and audit logging
-- deploying NocoDB with Docker for full self-hosted data ownership
-
-## What Is NocoDB?
-
-NocoDB transforms any SQL database (MySQL, PostgreSQL, SQL Server, SQLite) into a spreadsheet-like interface with auto-generated REST APIs. It provides a no-code layer over existing databases, enabling teams to build applications without rewriting their data layer.
-
-| Feature | Description |
-|---------|-------------|
-| **Database Abstraction** | Connect to MySQL, PostgreSQL, SQL Server, SQLite |
-| **Spreadsheet UI** | Grid, gallery, kanban, and form views |
-| **Auto REST API** | Automatic API generation from database schema |
-| **Collaboration** | Real-time multi-user editing with roles and permissions |
-| **Plugin System** | Extensible with custom field types and integrations |
-| **Self-Hosted** | Full Docker deployment, data stays on your infrastructure |
-
-## Mental Model
-
-```mermaid
-graph TB
-    subgraph Frontend["Vue.js Frontend"]
-        GRID[Grid View]
-        GALLERY[Gallery View]
-        KANBAN[Kanban View]
-        FORM[Form Builder]
-    end
-
-    subgraph Backend["Node.js Backend"]
-        API[REST API Engine]
-        QB[Query Builder]
-        SCHEMA[Schema Manager]
-        AUTH[Auth & Roles]
-    end
-
-    subgraph Databases["Connected Databases"]
-        PG[(PostgreSQL)]
-        MYSQL[(MySQL)]
-        SQLITE[(SQLite)]
-        MSSQL[(SQL Server)]
-    end
-
-    Frontend --> Backend
-    Backend --> Databases
-```
-
-## Chapter Guide
-
-| Chapter | Topic | What You'll Learn |
-|---------|-------|-------------------|
-| [1. System Overview](01-system-overview.md) | Architecture | NocoDB's approach to database abstraction |
-| [2. Database Abstraction](02-database-abstraction.md) | Connectors | Multi-database support and schema mapping |
-| [3. Schema Management](03-schema-management.md) | Data Model | Dynamic table/field handling and migrations |
-| [4. API Generation](04-api-generation.md) | APIs | Automatic REST endpoint creation |
-| [5. Query Builder](05-query-builder.md) | Querying | Translating UI/API filters into SQL safely |
-| [6. Auth System](06-auth-system.md) | Security | Authentication, RBAC, and auditability |
-| [7. Vue Components](07-vue-components.md) | Frontend | Grid/editor component architecture |
-| [8. Realtime Features](08-realtime-features.md) | Collaboration | Event streams, optimistic updates, and conflict handling |
-
-## Tech Stack
-
-| Component | Technology |
-|-----------|-----------|
-| **Backend** | Node.js, Express, Knex.js |
-| **Frontend** | Vue.js, Nuxt |
-| **Databases** | PostgreSQL, MySQL, SQLite, SQL Server |
-| **Auth** | JWT, role-based access control |
-| **Deployment** | Docker, npm |
-
----
-
-Ready to begin? Start with [Chapter 1: System Overview](01-system-overview.md).
-
----
-
-*Built with insights from the [NocoDB repository](https://github.com/nocodb/nocodb) and community documentation.*
-
-## Navigation & Backlinks
-
-- [Start Here: Chapter 1: NocoDB System Overview](01-system-overview.md)
-- [Back to Main Catalog](../../README.md#-tutorial-catalog)
-- [Browse A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
-- [Search by Intent](../../discoverability/query-hub.md)
-- [Explore Category Hubs](../../README.md#category-hubs)
-
-## Full Chapter Map
-
-1. [Chapter 1: NocoDB System Overview](01-system-overview.md)
-2. [Chapter 2: Database Abstraction Layer](02-database-abstraction.md)
-3. [Chapter 3: Schema Management](03-schema-management.md)
-4. [Chapter 4: API Generation Engine](04-api-generation.md)
-5. [Chapter 5: Query Builder](05-query-builder.md)
-6. [Chapter 6: Auth System](06-auth-system.md)
-7. [Chapter 7: Vue Components](07-vue-components.md)
-8. [Chapter 8: Realtime Features](08-realtime-features.md)
-
-## Current Snapshot (auto-updated)
-
-- repository: [nocodb/nocodb](https://github.com/nocodb/nocodb)
-- stars: about **48K**
-- project positioning: open-source Airtable alternative built on top of existing SQL databases
-
-## What You Will Learn
-
-- how NocoDB abstracts multiple SQL databases behind a unified spreadsheet-like interface
-- how automatic REST API generation works from existing database schemas
-- how the query builder safely translates UI filters into parameterized SQL
-- how to implement RBAC, configure authentication, and deploy NocoDB with Docker
-
-## Source References
-
-- [NocoDB](https://github.com/nocodb/nocodb)
-
-*Generated by [AI Codebase Knowledge Builder](https://github.com/The-Pocket/Tutorial-Codebase-Knowledge)*
diff --git a/tutorials/obsidian-outliner-plugin/01-plugin-architecture.md b/tutorials/obsidian-outliner-plugin/01-plugin-architecture.md
index 4d4d2f3c..56dac3d5 100644
--- a/tutorials/obsidian-outliner-plugin/01-plugin-architecture.md
+++ b/tutorials/obsidian-outliner-plugin/01-plugin-architecture.md
@@ -516,7 +516,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Text Editing Implementation](02-text-editing.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/obsidian-outliner-plugin/02-text-editing.md b/tutorials/obsidian-outliner-plugin/02-text-editing.md
index 1b5f5902..9989a2c9 100644
--- a/tutorials/obsidian-outliner-plugin/02-text-editing.md
+++ b/tutorials/obsidian-outliner-plugin/02-text-editing.md
@@ -722,7 +722,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Obsidian Plugin Architecture](01-plugin-architecture.md)
 - [Next Chapter: Chapter 3: Tree Data Structures](03-tree-structures.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/obsidian-outliner-plugin/03-tree-structures.md b/tutorials/obsidian-outliner-plugin/03-tree-structures.md
index c0484b98..2c766d31 100644
--- a/tutorials/obsidian-outliner-plugin/03-tree-structures.md
+++ b/tutorials/obsidian-outliner-plugin/03-tree-structures.md
@@ -897,7 +897,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Text Editing Implementation](02-text-editing.md)
 - [Next Chapter: Chapter 4: Advanced Features](04-advanced-features.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/obsidian-outliner-plugin/04-advanced-features.md b/tutorials/obsidian-outliner-plugin/04-advanced-features.md
index 8728416c..8a26420d 100644
--- a/tutorials/obsidian-outliner-plugin/04-advanced-features.md
+++ b/tutorials/obsidian-outliner-plugin/04-advanced-features.md
@@ -903,7 +903,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Tree Data Structures](03-tree-structures.md)
 - [Next Chapter: Chapter 5: Keyboard Shortcuts](05-keyboard-shortcuts.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/obsidian-outliner-plugin/05-keyboard-shortcuts.md b/tutorials/obsidian-outliner-plugin/05-keyboard-shortcuts.md
index 80e4f730..be77ed64 100644
--- a/tutorials/obsidian-outliner-plugin/05-keyboard-shortcuts.md
+++ b/tutorials/obsidian-outliner-plugin/05-keyboard-shortcuts.md
@@ -77,7 +77,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Advanced Features](04-advanced-features.md)
 - [Next Chapter: Chapter 6: Testing and Debugging](06-testing-debugging.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/obsidian-outliner-plugin/06-testing-debugging.md b/tutorials/obsidian-outliner-plugin/06-testing-debugging.md
index 88871342..21916100 100644
--- a/tutorials/obsidian-outliner-plugin/06-testing-debugging.md
+++ b/tutorials/obsidian-outliner-plugin/06-testing-debugging.md
@@ -88,7 +88,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Keyboard Shortcuts](05-keyboard-shortcuts.md)
 - [Next Chapter: Chapter 7: Plugin Packaging](07-plugin-packaging.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/obsidian-outliner-plugin/07-plugin-packaging.md b/tutorials/obsidian-outliner-plugin/07-plugin-packaging.md
index 9078a43c..a9ce93a4 100644
--- a/tutorials/obsidian-outliner-plugin/07-plugin-packaging.md
+++ b/tutorials/obsidian-outliner-plugin/07-plugin-packaging.md
@@ -81,7 +81,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Testing and Debugging](06-testing-debugging.md)
 - [Next Chapter: Chapter 8: Production Maintenance](08-production-maintenance.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/obsidian-outliner-plugin/08-production-maintenance.md b/tutorials/obsidian-outliner-plugin/08-production-maintenance.md
index cd3f8745..523b9024 100644
--- a/tutorials/obsidian-outliner-plugin/08-production-maintenance.md
+++ b/tutorials/obsidian-outliner-plugin/08-production-maintenance.md
@@ -40,7 +40,7 @@ Long-term plugin quality depends on maintenance discipline more than launch poli
 You now have end-to-end coverage for developing, shipping, and sustaining an Obsidian outliner plugin in production.
 
 Related:
-- [Obsidian Outliner Index](index.md)
+- [Obsidian Outliner Index](README.md)
 
 ## What Problem Does This Solve?
 
@@ -82,7 +82,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Plugin Packaging](07-plugin-packaging.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/obsidian-outliner-plugin/README.md b/tutorials/obsidian-outliner-plugin/README.md
index 3b42df05..b0491e74 100644
--- a/tutorials/obsidian-outliner-plugin/README.md
+++ b/tutorials/obsidian-outliner-plugin/README.md
@@ -1,38 +1,128 @@
-# Obsidian Outliner Plugin Architecture Deep Dive
+---
+layout: default
+title: "Obsidian Outliner Plugin"
+nav_order: 41
+has_children: true
+format_version: v2
+---
+
+# Obsidian Outliner Plugin: Deep Dive Tutorial
+
+> **Project**: [Obsidian Outliner](https://github.com/vslinko/obsidian-outliner) — A plugin that adds outliner-style editing behaviors to Obsidian, demonstrating advanced plugin architecture patterns.
+
+[![Stars](https://img.shields.io/github/stars/vslinko/obsidian-outliner?style=social)](https://github.com/vslinko/obsidian-outliner)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![TypeScript](https://img.shields.io/badge/TypeScript-Obsidian_API-blue)](https://github.com/vslinko/obsidian-outliner)
+
+## Why This Track Matters
 
-A focused architecture tutorial for advanced Obsidian plugin development patterns.
+The Obsidian Outliner plugin is an ideal case study for Obsidian plugin development — it covers the full arc from API integration and CodeMirror editor extensions to tree data structures and production maintenance.
 
-## Current Status
+This track focuses on:
+- understanding the Obsidian plugin lifecycle and API boundaries
+- implementing custom editing behaviors with CodeMirror 6
+- managing hierarchical list structures with tree manipulation algorithms
+- packaging, releasing, and maintaining a production Obsidian plugin
 
-Core chapter set is now published.
+## What Is This Tutorial?
 
-| Item | Status |
-|:-----|:-------|
-| Published chapter docs | 8 |
-| Canonical entry point | [index.md](index.md) |
+This tutorial uses the Obsidian Outliner plugin as a case study for understanding Obsidian plugin development patterns — including editor extensions, tree data structures, keyboard shortcuts, and the Obsidian Plugin API.
 
-## Published Chapters
+| Feature | Description |
+|---------|-------------|
+| **Plugin Architecture** | Obsidian's plugin system, API boundaries, lifecycle |
+| **Editor Extensions** | Custom editing behaviors, cursor management |
+| **Tree Manipulation** | Hierarchical list operations (indent, move, fold) |
+| **Keyboard Shortcuts** | Custom hotkey handling and command registration |
+| **Performance** | Efficient algorithms for large documents |
 
-| Chapter | File | Focus |
-|:--------|:-----|:------|
-| 1 | [01-plugin-architecture.md](01-plugin-architecture.md) | Plugin lifecycle and API boundaries |
-| 2 | [02-text-editing.md](02-text-editing.md) | Editor integration and cursor behavior |
-| 3 | [03-tree-structures.md](03-tree-structures.md) | Hierarchical list parsing and operations |
-| 4 | [04-advanced-features.md](04-advanced-features.md) | Performance and advanced UX features |
-| 5 | [05-keyboard-shortcuts.md](05-keyboard-shortcuts.md) | Command registration and hotkey handling |
-| 6 | [06-testing-debugging.md](06-testing-debugging.md) | Testing and debugging strategies |
-| 7 | [07-plugin-packaging.md](07-plugin-packaging.md) | Build/release packaging and compatibility |
-| 8 | [08-production-maintenance.md](08-production-maintenance.md) | Stability and long-term maintenance |
+## Mental Model
 
-## Suggested Reading Order
+```mermaid
+graph TB
+    subgraph Obsidian["Obsidian App"]
+        API[Plugin API]
+        EDITOR[CodeMirror Editor]
+        VAULT[Vault / Files]
+    end
 
-1. Start with [index.md](index.md).
-2. Read chapters [1](01-plugin-architecture.md) through [8](08-production-maintenance.md) in order.
+    subgraph Plugin["Outliner Plugin"]
+        COMMANDS[Command Registry]
+        TREE[Tree Operations]
+        PARSER[List Parser]
+        KEYS[Keyboard Handlers]
+    end
 
-## Upstream Project
+    Plugin --> Obsidian
+    COMMANDS --> EDITOR
+    TREE --> PARSER
+    KEYS --> COMMANDS
+```
+
+## Chapter Guide
+
+| Chapter | Topic | What You'll Learn |
+|---------|-------|-------------------|
+| [1. Plugin Architecture](01-plugin-architecture.md) | Foundation | Obsidian plugin API, lifecycle, settings |
+| [2. Text Editing](02-text-editing.md) | Editor | CodeMirror integration, cursor management |
+| [3. Tree Structures](03-tree-structures.md) | Data | Hierarchical list parsing and manipulation |
+| [4. Advanced Features](04-advanced-features.md) | Polish | Folding, drag-and-drop, performance |
+| [5. Keyboard Shortcuts](05-keyboard-shortcuts.md) | Commands | Hotkey registration and command precedence |
+| [6. Testing and Debugging](06-testing-debugging.md) | Quality | Test strategy for tree mutations and editor state |
+| [7. Plugin Packaging](07-plugin-packaging.md) | Release | Manifest/versioning and compatibility strategy |
+| [8. Production Maintenance](08-production-maintenance.md) | Operations | Stability, triage, and long-term maintenance |
+
+## Tech Stack
+
+| Component | Technology |
+|-----------|-----------|
+| **Language** | TypeScript |
+| **Editor** | CodeMirror 6 (via Obsidian) |
+| **Platform** | Obsidian Plugin API |
+| **Build** | esbuild |
+
+---
 
-- Obsidian Outliner repository: <https://github.com/vslinko/obsidian-outliner>
+Ready to begin? Start with [Chapter 1: Plugin Architecture](01-plugin-architecture.md).
 
 ---
 
-Part of [Awesome Code Docs](../../README.md)
+*Built with insights from the [Obsidian Outliner](https://github.com/vslinko/obsidian-outliner) plugin and Obsidian developer documentation.*
+
+## Navigation & Backlinks
+
+- [Start Here: Chapter 1: Obsidian Plugin Architecture](01-plugin-architecture.md)
+- [Back to Main Catalog](../../README.md#-tutorial-catalog)
+- [Browse A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
+- [Search by Intent](../../discoverability/query-hub.md)
+- [Explore Category Hubs](../../README.md#category-hubs)
+
+## Full Chapter Map
+
+1. [Chapter 1: Obsidian Plugin Architecture](01-plugin-architecture.md)
+2. [Chapter 2: Text Editing Implementation](02-text-editing.md)
+3. [Chapter 3: Tree Data Structures](03-tree-structures.md)
+4. [Chapter 4: Advanced Features](04-advanced-features.md)
+5. [Chapter 5: Keyboard Shortcuts](05-keyboard-shortcuts.md)
+6. [Chapter 6: Testing and Debugging](06-testing-debugging.md)
+7. [Chapter 7: Plugin Packaging](07-plugin-packaging.md)
+8. [Chapter 8: Production Maintenance](08-production-maintenance.md)
+
+## Current Snapshot (auto-updated)
+
+- repository: [vslinko/obsidian-outliner](https://github.com/vslinko/obsidian-outliner)
+- stars: about **2.5K**
+- project positioning: popular Obsidian plugin adding outliner-style editing to Obsidian notes
+
+## What You Will Learn
+
+- how the Obsidian Plugin API and CodeMirror 6 are used to extend editor behavior
+- how tree data structures model and manipulate hierarchical markdown lists
+- how keyboard shortcuts, commands, and hotkeys are registered and managed
+- how to package, version, and maintain an Obsidian plugin for long-term compatibility
+
+## Source References
+
+- [Obsidian Outliner](https://github.com/vslinko/obsidian-outliner)
+
+*Generated by [AI Codebase Knowledge Builder](https://github.com/The-Pocket/Tutorial-Codebase-Knowledge)*
diff --git a/tutorials/obsidian-outliner-plugin/index.md b/tutorials/obsidian-outliner-plugin/index.md
deleted file mode 100644
index b0491e74..00000000
--- a/tutorials/obsidian-outliner-plugin/index.md
+++ /dev/null
@@ -1,128 +0,0 @@
----
-layout: default
-title: "Obsidian Outliner Plugin"
-nav_order: 41
-has_children: true
-format_version: v2
----
-
-# Obsidian Outliner Plugin: Deep Dive Tutorial
-
-> **Project**: [Obsidian Outliner](https://github.com/vslinko/obsidian-outliner) — A plugin that adds outliner-style editing behaviors to Obsidian, demonstrating advanced plugin architecture patterns.
-
-[![Stars](https://img.shields.io/github/stars/vslinko/obsidian-outliner?style=social)](https://github.com/vslinko/obsidian-outliner)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-[![TypeScript](https://img.shields.io/badge/TypeScript-Obsidian_API-blue)](https://github.com/vslinko/obsidian-outliner)
-
-## Why This Track Matters
-
-The Obsidian Outliner plugin is an ideal case study for Obsidian plugin development — it covers the full arc from API integration and CodeMirror editor extensions to tree data structures and production maintenance.
-
-This track focuses on:
-- understanding the Obsidian plugin lifecycle and API boundaries
-- implementing custom editing behaviors with CodeMirror 6
-- managing hierarchical list structures with tree manipulation algorithms
-- packaging, releasing, and maintaining a production Obsidian plugin
-
-## What Is This Tutorial?
-
-This tutorial uses the Obsidian Outliner plugin as a case study for understanding Obsidian plugin development patterns — including editor extensions, tree data structures, keyboard shortcuts, and the Obsidian Plugin API.
-
-| Feature | Description |
-|---------|-------------|
-| **Plugin Architecture** | Obsidian's plugin system, API boundaries, lifecycle |
-| **Editor Extensions** | Custom editing behaviors, cursor management |
-| **Tree Manipulation** | Hierarchical list operations (indent, move, fold) |
-| **Keyboard Shortcuts** | Custom hotkey handling and command registration |
-| **Performance** | Efficient algorithms for large documents |
-
-## Mental Model
-
-```mermaid
-graph TB
-    subgraph Obsidian["Obsidian App"]
-        API[Plugin API]
-        EDITOR[CodeMirror Editor]
-        VAULT[Vault / Files]
-    end
-
-    subgraph Plugin["Outliner Plugin"]
-        COMMANDS[Command Registry]
-        TREE[Tree Operations]
-        PARSER[List Parser]
-        KEYS[Keyboard Handlers]
-    end
-
-    Plugin --> Obsidian
-    COMMANDS --> EDITOR
-    TREE --> PARSER
-    KEYS --> COMMANDS
-```
-
-## Chapter Guide
-
-| Chapter | Topic | What You'll Learn |
-|---------|-------|-------------------|
-| [1. Plugin Architecture](01-plugin-architecture.md) | Foundation | Obsidian plugin API, lifecycle, settings |
-| [2. Text Editing](02-text-editing.md) | Editor | CodeMirror integration, cursor management |
-| [3. Tree Structures](03-tree-structures.md) | Data | Hierarchical list parsing and manipulation |
-| [4. Advanced Features](04-advanced-features.md) | Polish | Folding, drag-and-drop, performance |
-| [5. Keyboard Shortcuts](05-keyboard-shortcuts.md) | Commands | Hotkey registration and command precedence |
-| [6. Testing and Debugging](06-testing-debugging.md) | Quality | Test strategy for tree mutations and editor state |
-| [7. Plugin Packaging](07-plugin-packaging.md) | Release | Manifest/versioning and compatibility strategy |
-| [8. Production Maintenance](08-production-maintenance.md) | Operations | Stability, triage, and long-term maintenance |
-
-## Tech Stack
-
-| Component | Technology |
-|-----------|-----------|
-| **Language** | TypeScript |
-| **Editor** | CodeMirror 6 (via Obsidian) |
-| **Platform** | Obsidian Plugin API |
-| **Build** | esbuild |
-
----
-
-Ready to begin? Start with [Chapter 1: Plugin Architecture](01-plugin-architecture.md).
-
----
-
-*Built with insights from the [Obsidian Outliner](https://github.com/vslinko/obsidian-outliner) plugin and Obsidian developer documentation.*
-
-## Navigation & Backlinks
-
-- [Start Here: Chapter 1: Obsidian Plugin Architecture](01-plugin-architecture.md)
-- [Back to Main Catalog](../../README.md#-tutorial-catalog)
-- [Browse A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
-- [Search by Intent](../../discoverability/query-hub.md)
-- [Explore Category Hubs](../../README.md#category-hubs)
-
-## Full Chapter Map
-
-1. [Chapter 1: Obsidian Plugin Architecture](01-plugin-architecture.md)
-2. [Chapter 2: Text Editing Implementation](02-text-editing.md)
-3. [Chapter 3: Tree Data Structures](03-tree-structures.md)
-4. [Chapter 4: Advanced Features](04-advanced-features.md)
-5. [Chapter 5: Keyboard Shortcuts](05-keyboard-shortcuts.md)
-6. [Chapter 6: Testing and Debugging](06-testing-debugging.md)
-7. [Chapter 7: Plugin Packaging](07-plugin-packaging.md)
-8. [Chapter 8: Production Maintenance](08-production-maintenance.md)
-
-## Current Snapshot (auto-updated)
-
-- repository: [vslinko/obsidian-outliner](https://github.com/vslinko/obsidian-outliner)
-- stars: about **2.5K**
-- project positioning: popular Obsidian plugin adding outliner-style editing to Obsidian notes
-
-## What You Will Learn
-
-- how the Obsidian Plugin API and CodeMirror 6 are used to extend editor behavior
-- how tree data structures model and manipulate hierarchical markdown lists
-- how keyboard shortcuts, commands, and hotkeys are registered and managed
-- how to package, version, and maintain an Obsidian plugin for long-term compatibility
-
-## Source References
-
-- [Obsidian Outliner](https://github.com/vslinko/obsidian-outliner)
-
-*Generated by [AI Codebase Knowledge Builder](https://github.com/The-Pocket/Tutorial-Codebase-Knowledge)*
diff --git a/tutorials/ollama-tutorial/01-getting-started.md b/tutorials/ollama-tutorial/01-getting-started.md
index 4b7e720f..b563312a 100644
--- a/tutorials/ollama-tutorial/01-getting-started.md
+++ b/tutorials/ollama-tutorial/01-getting-started.md
@@ -628,7 +628,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Models, Pulling, and Modelfiles](02-models.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/ollama-tutorial/02-models.md b/tutorials/ollama-tutorial/02-models.md
index 9dbb6c9f..9eb78bb1 100644
--- a/tutorials/ollama-tutorial/02-models.md
+++ b/tutorials/ollama-tutorial/02-models.md
@@ -711,7 +711,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started with Ollama](01-getting-started.md)
 - [Next Chapter: Chapter 3: Chat, Completions, and Parameters](03-chat-completions.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/ollama-tutorial/03-chat-completions.md b/tutorials/ollama-tutorial/03-chat-completions.md
index 9dc91eac..c2adb9d3 100644
--- a/tutorials/ollama-tutorial/03-chat-completions.md
+++ b/tutorials/ollama-tutorial/03-chat-completions.md
@@ -905,7 +905,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Models, Pulling, and Modelfiles](02-models.md)
 - [Next Chapter: Chapter 4: Embeddings and RAG with Ollama](04-embeddings-rag.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/ollama-tutorial/04-embeddings-rag.md b/tutorials/ollama-tutorial/04-embeddings-rag.md
index ea3c4cc5..828f6c22 100644
--- a/tutorials/ollama-tutorial/04-embeddings-rag.md
+++ b/tutorials/ollama-tutorial/04-embeddings-rag.md
@@ -837,7 +837,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Chat, Completions, and Parameters](03-chat-completions.md)
 - [Next Chapter: Chapter 5: Modelfiles, Templates, and Custom Models](05-modelfiles-custom.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/ollama-tutorial/05-modelfiles-custom.md b/tutorials/ollama-tutorial/05-modelfiles-custom.md
index 7b7bbe8c..a4d67872 100644
--- a/tutorials/ollama-tutorial/05-modelfiles-custom.md
+++ b/tutorials/ollama-tutorial/05-modelfiles-custom.md
@@ -569,7 +569,7 @@ ollama push yourname/code-reviewer:v1.0
 |---|---|
 | Previous | [Chapter 4: Embeddings & RAG](./04-embeddings-rag.md) |
 | Next | [Chapter 6: Performance & Hardware Tuning](./06-performance.md) |
-| Index | [Ollama Tutorial Home](./index.md) |
+| Index | [Ollama Tutorial Home](./README.md) |
 
 ## Depth Expansion Playbook
 
@@ -714,7 +714,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Embeddings and RAG with Ollama](04-embeddings-rag.md)
 - [Next Chapter: Chapter 6: Performance, GPU Tuning, and Quantization](06-performance.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/ollama-tutorial/06-performance.md b/tutorials/ollama-tutorial/06-performance.md
index c4c68c8f..0028b0f8 100644
--- a/tutorials/ollama-tutorial/06-performance.md
+++ b/tutorials/ollama-tutorial/06-performance.md
@@ -503,7 +503,7 @@ Here are ready-to-use option sets for common scenarios.
 |---|---|
 | Previous | [Chapter 5: Modelfiles & Custom Models](./05-modelfiles-custom.md) |
 | Next | [Chapter 7: Integrations](./07-integrations.md) |
-| Index | [Ollama Tutorial Home](./index.md) |
+| Index | [Ollama Tutorial Home](./README.md) |
 
 ## Depth Expansion Playbook
 
@@ -648,7 +648,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Modelfiles, Templates, and Custom Models](05-modelfiles-custom.md)
 - [Next Chapter: Chapter 7: Integrations with OpenAI API, LangChain, and LlamaIndex](07-integrations.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/ollama-tutorial/07-integrations.md b/tutorials/ollama-tutorial/07-integrations.md
index 434be6d7..e72b3a25 100644
--- a/tutorials/ollama-tutorial/07-integrations.md
+++ b/tutorials/ollama-tutorial/07-integrations.md
@@ -776,7 +776,7 @@ Ollama embeddings work with all major vector databases:
 |---|---|
 | Previous | [Chapter 6: Performance & Hardware Tuning](./06-performance.md) |
 | Next | [Chapter 8: Production Deployment](./08-production.md) |
-| Index | [Ollama Tutorial Home](./index.md) |
+| Index | [Ollama Tutorial Home](./README.md) |
 
 ## What Problem Does This Solve?
 
@@ -822,7 +822,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Performance, GPU Tuning, and Quantization](06-performance.md)
 - [Next Chapter: Chapter 8: Production Deployment, Security, and Monitoring](08-production.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/ollama-tutorial/08-production.md b/tutorials/ollama-tutorial/08-production.md
index 3b2b4843..49241631 100644
--- a/tutorials/ollama-tutorial/08-production.md
+++ b/tutorials/ollama-tutorial/08-production.md
@@ -819,7 +819,7 @@ With these practices in place, you can operate Ollama safely in production, deli
 | Navigation | |
 |---|---|
 | Previous | [Chapter 7: Integrations](./07-integrations.md) |
-| Index | [Ollama Tutorial Home](./index.md) |
+| Index | [Ollama Tutorial Home](./README.md) |
 
 ## What Problem Does This Solve?
 
@@ -865,7 +865,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Integrations with OpenAI API, LangChain, and LlamaIndex](07-integrations.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/ollama-tutorial/index.md b/tutorials/ollama-tutorial/README.md
similarity index 100%
rename from tutorials/ollama-tutorial/index.md
rename to tutorials/ollama-tutorial/README.md
diff --git a/tutorials/onlook-tutorial/01-getting-started.md b/tutorials/onlook-tutorial/01-getting-started.md
index 9127b823..8ed32297 100644
--- a/tutorials/onlook-tutorial/01-getting-started.md
+++ b/tutorials/onlook-tutorial/01-getting-started.md
@@ -637,7 +637,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Product and Architecture Foundations](02-product-and-architecture-foundations.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/onlook-tutorial/02-product-and-architecture-foundations.md b/tutorials/onlook-tutorial/02-product-and-architecture-foundations.md
index 0f9b5221..e6daeda2 100644
--- a/tutorials/onlook-tutorial/02-product-and-architecture-foundations.md
+++ b/tutorials/onlook-tutorial/02-product-and-architecture-foundations.md
@@ -638,7 +638,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started](01-getting-started.md)
 - [Next Chapter: Chapter 3: Visual Editing and Code Mapping](03-visual-editing-and-code-mapping.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/onlook-tutorial/03-visual-editing-and-code-mapping.md b/tutorials/onlook-tutorial/03-visual-editing-and-code-mapping.md
index 3cb7064d..5451681c 100644
--- a/tutorials/onlook-tutorial/03-visual-editing-and-code-mapping.md
+++ b/tutorials/onlook-tutorial/03-visual-editing-and-code-mapping.md
@@ -639,7 +639,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Product and Architecture Foundations](02-product-and-architecture-foundations.md)
 - [Next Chapter: Chapter 4: AI Chat, Branching, and Iteration](04-ai-chat-branching-and-iteration.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/onlook-tutorial/04-ai-chat-branching-and-iteration.md b/tutorials/onlook-tutorial/04-ai-chat-branching-and-iteration.md
index 2432d40a..9ff8dd90 100644
--- a/tutorials/onlook-tutorial/04-ai-chat-branching-and-iteration.md
+++ b/tutorials/onlook-tutorial/04-ai-chat-branching-and-iteration.md
@@ -637,7 +637,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Visual Editing and Code Mapping](03-visual-editing-and-code-mapping.md)
 - [Next Chapter: Chapter 5: Local Development and Runtime Setup](05-local-development-and-runtime-setup.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/onlook-tutorial/05-local-development-and-runtime-setup.md b/tutorials/onlook-tutorial/05-local-development-and-runtime-setup.md
index bcdc4676..bff7c44f 100644
--- a/tutorials/onlook-tutorial/05-local-development-and-runtime-setup.md
+++ b/tutorials/onlook-tutorial/05-local-development-and-runtime-setup.md
@@ -637,7 +637,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: AI Chat, Branching, and Iteration](04-ai-chat-branching-and-iteration.md)
 - [Next Chapter: Chapter 6: Deployment and Team Collaboration](06-deployment-and-team-collaboration.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/onlook-tutorial/06-deployment-and-team-collaboration.md b/tutorials/onlook-tutorial/06-deployment-and-team-collaboration.md
index e0980a08..2f622400 100644
--- a/tutorials/onlook-tutorial/06-deployment-and-team-collaboration.md
+++ b/tutorials/onlook-tutorial/06-deployment-and-team-collaboration.md
@@ -637,7 +637,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Local Development and Runtime Setup](05-local-development-and-runtime-setup.md)
 - [Next Chapter: Chapter 7: Contributing and Quality Workflow](07-contributing-and-quality-workflow.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/onlook-tutorial/07-contributing-and-quality-workflow.md b/tutorials/onlook-tutorial/07-contributing-and-quality-workflow.md
index 7ae60092..93bf8f5c 100644
--- a/tutorials/onlook-tutorial/07-contributing-and-quality-workflow.md
+++ b/tutorials/onlook-tutorial/07-contributing-and-quality-workflow.md
@@ -634,7 +634,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Deployment and Team Collaboration](06-deployment-and-team-collaboration.md)
 - [Next Chapter: Chapter 8: Production Operations and Governance](08-production-operations-and-governance.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/onlook-tutorial/08-production-operations-and-governance.md b/tutorials/onlook-tutorial/08-production-operations-and-governance.md
index 1bb5ec71..e85d3ebe 100644
--- a/tutorials/onlook-tutorial/08-production-operations-and-governance.md
+++ b/tutorials/onlook-tutorial/08-production-operations-and-governance.md
@@ -628,7 +628,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Contributing and Quality Workflow](07-contributing-and-quality-workflow.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/onlook-tutorial/index.md b/tutorials/onlook-tutorial/README.md
similarity index 100%
rename from tutorials/onlook-tutorial/index.md
rename to tutorials/onlook-tutorial/README.md
diff --git a/tutorials/opcode-tutorial/01-getting-started.md b/tutorials/opcode-tutorial/01-getting-started.md
index a558b276..f43789f6 100644
--- a/tutorials/opcode-tutorial/01-getting-started.md
+++ b/tutorials/opcode-tutorial/01-getting-started.md
@@ -632,7 +632,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Architecture and Platform Stack](02-architecture-and-platform-stack.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/opcode-tutorial/02-architecture-and-platform-stack.md b/tutorials/opcode-tutorial/02-architecture-and-platform-stack.md
index d3e23c5c..28594b64 100644
--- a/tutorials/opcode-tutorial/02-architecture-and-platform-stack.md
+++ b/tutorials/opcode-tutorial/02-architecture-and-platform-stack.md
@@ -629,7 +629,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started](01-getting-started.md)
 - [Next Chapter: Chapter 3: Projects and Session Management](03-projects-and-session-management.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/opcode-tutorial/03-projects-and-session-management.md b/tutorials/opcode-tutorial/03-projects-and-session-management.md
index 73732499..181cd6f7 100644
--- a/tutorials/opcode-tutorial/03-projects-and-session-management.md
+++ b/tutorials/opcode-tutorial/03-projects-and-session-management.md
@@ -629,7 +629,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Architecture and Platform Stack](02-architecture-and-platform-stack.md)
 - [Next Chapter: Chapter 4: Custom Agents and Background Runs](04-custom-agents-and-background-runs.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/opcode-tutorial/04-custom-agents-and-background-runs.md b/tutorials/opcode-tutorial/04-custom-agents-and-background-runs.md
index 39fbb559..5f3337d9 100644
--- a/tutorials/opcode-tutorial/04-custom-agents-and-background-runs.md
+++ b/tutorials/opcode-tutorial/04-custom-agents-and-background-runs.md
@@ -629,7 +629,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Projects and Session Management](03-projects-and-session-management.md)
 - [Next Chapter: Chapter 5: MCP and Context Management](05-mcp-and-context-management.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/opcode-tutorial/05-mcp-and-context-management.md b/tutorials/opcode-tutorial/05-mcp-and-context-management.md
index fbe08cfb..424ce6cd 100644
--- a/tutorials/opcode-tutorial/05-mcp-and-context-management.md
+++ b/tutorials/opcode-tutorial/05-mcp-and-context-management.md
@@ -625,7 +625,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Custom Agents and Background Runs](04-custom-agents-and-background-runs.md)
 - [Next Chapter: Chapter 6: Timeline, Checkpoints, and Recovery](06-timeline-checkpoints-and-recovery.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/opcode-tutorial/06-timeline-checkpoints-and-recovery.md b/tutorials/opcode-tutorial/06-timeline-checkpoints-and-recovery.md
index 0123d52b..5b01eb75 100644
--- a/tutorials/opcode-tutorial/06-timeline-checkpoints-and-recovery.md
+++ b/tutorials/opcode-tutorial/06-timeline-checkpoints-and-recovery.md
@@ -633,7 +633,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: MCP and Context Management](05-mcp-and-context-management.md)
 - [Next Chapter: Chapter 7: Development Workflow and Build from Source](07-development-workflow-and-build-from-source.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/opcode-tutorial/07-development-workflow-and-build-from-source.md b/tutorials/opcode-tutorial/07-development-workflow-and-build-from-source.md
index 4700663b..7f0be308 100644
--- a/tutorials/opcode-tutorial/07-development-workflow-and-build-from-source.md
+++ b/tutorials/opcode-tutorial/07-development-workflow-and-build-from-source.md
@@ -631,7 +631,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Timeline, Checkpoints, and Recovery](06-timeline-checkpoints-and-recovery.md)
 - [Next Chapter: Chapter 8: Production Operations and Security](08-production-operations-and-security.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/opcode-tutorial/08-production-operations-and-security.md b/tutorials/opcode-tutorial/08-production-operations-and-security.md
index 4bef05be..3522695e 100644
--- a/tutorials/opcode-tutorial/08-production-operations-and-security.md
+++ b/tutorials/opcode-tutorial/08-production-operations-and-security.md
@@ -629,7 +629,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Development Workflow and Build from Source](07-development-workflow-and-build-from-source.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/opcode-tutorial/index.md b/tutorials/opcode-tutorial/README.md
similarity index 100%
rename from tutorials/opcode-tutorial/index.md
rename to tutorials/opcode-tutorial/README.md
diff --git a/tutorials/open-swe-tutorial/01-getting-started-and-project-status.md b/tutorials/open-swe-tutorial/01-getting-started-and-project-status.md
index 0f6499f4..652ca5e2 100644
--- a/tutorials/open-swe-tutorial/01-getting-started-and-project-status.md
+++ b/tutorials/open-swe-tutorial/01-getting-started-and-project-status.md
@@ -636,7 +636,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: LangGraph Architecture and Agent Graphs](02-langgraph-architecture-and-agent-graphs.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/open-swe-tutorial/02-langgraph-architecture-and-agent-graphs.md b/tutorials/open-swe-tutorial/02-langgraph-architecture-and-agent-graphs.md
index 690ac7ce..14d3d89e 100644
--- a/tutorials/open-swe-tutorial/02-langgraph-architecture-and-agent-graphs.md
+++ b/tutorials/open-swe-tutorial/02-langgraph-architecture-and-agent-graphs.md
@@ -626,7 +626,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started and Project Status](01-getting-started-and-project-status.md)
 - [Next Chapter: Chapter 3: Development Environment and Monorepo Setup](03-development-environment-and-monorepo-setup.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/open-swe-tutorial/03-development-environment-and-monorepo-setup.md b/tutorials/open-swe-tutorial/03-development-environment-and-monorepo-setup.md
index f27a7b68..d4015283 100644
--- a/tutorials/open-swe-tutorial/03-development-environment-and-monorepo-setup.md
+++ b/tutorials/open-swe-tutorial/03-development-environment-and-monorepo-setup.md
@@ -626,7 +626,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: LangGraph Architecture and Agent Graphs](02-langgraph-architecture-and-agent-graphs.md)
 - [Next Chapter: Chapter 4: Usage Patterns: UI and GitHub Workflows](04-usage-patterns-ui-and-github-workflows.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/open-swe-tutorial/04-usage-patterns-ui-and-github-workflows.md b/tutorials/open-swe-tutorial/04-usage-patterns-ui-and-github-workflows.md
index 288d7bef..2b05029b 100644
--- a/tutorials/open-swe-tutorial/04-usage-patterns-ui-and-github-workflows.md
+++ b/tutorials/open-swe-tutorial/04-usage-patterns-ui-and-github-workflows.md
@@ -626,7 +626,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Development Environment and Monorepo Setup](03-development-environment-and-monorepo-setup.md)
 - [Next Chapter: Chapter 5: Planning Control and Human-in-the-Loop](05-planning-control-and-human-in-the-loop.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/open-swe-tutorial/05-planning-control-and-human-in-the-loop.md b/tutorials/open-swe-tutorial/05-planning-control-and-human-in-the-loop.md
index 60e6f631..adebf3ee 100644
--- a/tutorials/open-swe-tutorial/05-planning-control-and-human-in-the-loop.md
+++ b/tutorials/open-swe-tutorial/05-planning-control-and-human-in-the-loop.md
@@ -626,7 +626,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Usage Patterns: UI and GitHub Workflows](04-usage-patterns-ui-and-github-workflows.md)
 - [Next Chapter: Chapter 6: Security, Auth, and Operational Constraints](06-security-auth-and-operational-constraints.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/open-swe-tutorial/06-security-auth-and-operational-constraints.md b/tutorials/open-swe-tutorial/06-security-auth-and-operational-constraints.md
index 1e021b42..58cef125 100644
--- a/tutorials/open-swe-tutorial/06-security-auth-and-operational-constraints.md
+++ b/tutorials/open-swe-tutorial/06-security-auth-and-operational-constraints.md
@@ -627,7 +627,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Planning Control and Human-in-the-Loop](05-planning-control-and-human-in-the-loop.md)
 - [Next Chapter: Chapter 7: Fork Maintenance and Migration Strategy](07-fork-maintenance-and-migration-strategy.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/open-swe-tutorial/07-fork-maintenance-and-migration-strategy.md b/tutorials/open-swe-tutorial/07-fork-maintenance-and-migration-strategy.md
index 3a9875fc..773dd31e 100644
--- a/tutorials/open-swe-tutorial/07-fork-maintenance-and-migration-strategy.md
+++ b/tutorials/open-swe-tutorial/07-fork-maintenance-and-migration-strategy.md
@@ -627,7 +627,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Security, Auth, and Operational Constraints](06-security-auth-and-operational-constraints.md)
 - [Next Chapter: Chapter 8: Contribution, Legacy Support, and Next Steps](08-contribution-legacy-support-and-next-steps.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/open-swe-tutorial/08-contribution-legacy-support-and-next-steps.md b/tutorials/open-swe-tutorial/08-contribution-legacy-support-and-next-steps.md
index 48d2bca5..f5119166 100644
--- a/tutorials/open-swe-tutorial/08-contribution-legacy-support-and-next-steps.md
+++ b/tutorials/open-swe-tutorial/08-contribution-legacy-support-and-next-steps.md
@@ -627,7 +627,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Fork Maintenance and Migration Strategy](07-fork-maintenance-and-migration-strategy.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/open-swe-tutorial/index.md b/tutorials/open-swe-tutorial/README.md
similarity index 100%
rename from tutorials/open-swe-tutorial/index.md
rename to tutorials/open-swe-tutorial/README.md
diff --git a/tutorials/open-webui-tutorial/01-getting-started.md b/tutorials/open-webui-tutorial/01-getting-started.md
index 64d62fad..e7b2f9d9 100644
--- a/tutorials/open-webui-tutorial/01-getting-started.md
+++ b/tutorials/open-webui-tutorial/01-getting-started.md
@@ -634,7 +634,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Model Management & Backend Configuration](02-model-management.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/open-webui-tutorial/02-model-management.md b/tutorials/open-webui-tutorial/02-model-management.md
index 51c16c35..6651f353 100644
--- a/tutorials/open-webui-tutorial/02-model-management.md
+++ b/tutorials/open-webui-tutorial/02-model-management.md
@@ -683,7 +683,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started with Open WebUI](01-getting-started.md)
 - [Next Chapter: Chapter 3: Interface Customization & Personalization](03-interface-customization.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/open-webui-tutorial/03-interface-customization.md b/tutorials/open-webui-tutorial/03-interface-customization.md
index d4072cf6..53bc1f38 100644
--- a/tutorials/open-webui-tutorial/03-interface-customization.md
+++ b/tutorials/open-webui-tutorial/03-interface-customization.md
@@ -1104,7 +1104,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Model Management & Backend Configuration](02-model-management.md)
 - [Next Chapter: Chapter 4: Advanced Chat Features & Multi-Modal Conversations](04-advanced-chat-features.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/open-webui-tutorial/04-advanced-chat-features.md b/tutorials/open-webui-tutorial/04-advanced-chat-features.md
index cf41a9d0..f7eda352 100644
--- a/tutorials/open-webui-tutorial/04-advanced-chat-features.md
+++ b/tutorials/open-webui-tutorial/04-advanced-chat-features.md
@@ -1210,7 +1210,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Interface Customization & Personalization](03-interface-customization.md)
 - [Next Chapter: Chapter 5: Data, Knowledge Bases & RAG Implementation](05-data-knowledge.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/open-webui-tutorial/05-data-knowledge.md b/tutorials/open-webui-tutorial/05-data-knowledge.md
index 299704ef..a17c2405 100644
--- a/tutorials/open-webui-tutorial/05-data-knowledge.md
+++ b/tutorials/open-webui-tutorial/05-data-knowledge.md
@@ -1117,7 +1117,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Advanced Chat Features & Multi-Modal Conversations](04-advanced-chat-features.md)
 - [Next Chapter: Chapter 6: User Management, Authentication & Access Control](06-user-management.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/open-webui-tutorial/06-user-management.md b/tutorials/open-webui-tutorial/06-user-management.md
index 3b052add..81ead817 100644
--- a/tutorials/open-webui-tutorial/06-user-management.md
+++ b/tutorials/open-webui-tutorial/06-user-management.md
@@ -921,7 +921,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Data, Knowledge Bases & RAG Implementation](05-data-knowledge.md)
 - [Next Chapter: Chapter 7: API Integrations, Webhooks & External Service Connections](07-integrations.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/open-webui-tutorial/07-integrations.md b/tutorials/open-webui-tutorial/07-integrations.md
index f6ef91cf..202ead1a 100644
--- a/tutorials/open-webui-tutorial/07-integrations.md
+++ b/tutorials/open-webui-tutorial/07-integrations.md
@@ -894,7 +894,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: User Management, Authentication & Access Control](06-user-management.md)
 - [Next Chapter: Chapter 8: Production Deployment, Scaling & Enterprise Configuration](08-production-deployment.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/open-webui-tutorial/08-production-deployment.md b/tutorials/open-webui-tutorial/08-production-deployment.md
index d14ef585..4bdf92e8 100644
--- a/tutorials/open-webui-tutorial/08-production-deployment.md
+++ b/tutorials/open-webui-tutorial/08-production-deployment.md
@@ -1496,7 +1496,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: API Integrations, Webhooks & External Service Connections](07-integrations.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/open-webui-tutorial/index.md b/tutorials/open-webui-tutorial/README.md
similarity index 100%
rename from tutorials/open-webui-tutorial/index.md
rename to tutorials/open-webui-tutorial/README.md
diff --git a/tutorials/openai-python-sdk-tutorial/01-getting-started.md b/tutorials/openai-python-sdk-tutorial/01-getting-started.md
index f82535e3..9786205b 100644
--- a/tutorials/openai-python-sdk-tutorial/01-getting-started.md
+++ b/tutorials/openai-python-sdk-tutorial/01-getting-started.md
@@ -633,7 +633,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Chat Completions](02-chat-completions.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/openai-python-sdk-tutorial/02-chat-completions.md b/tutorials/openai-python-sdk-tutorial/02-chat-completions.md
index 7d314efe..d092e068 100644
--- a/tutorials/openai-python-sdk-tutorial/02-chat-completions.md
+++ b/tutorials/openai-python-sdk-tutorial/02-chat-completions.md
@@ -629,7 +629,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started](01-getting-started.md)
 - [Next Chapter: Chapter 3: Embeddings and Search](03-embeddings-search.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/openai-python-sdk-tutorial/03-embeddings-search.md b/tutorials/openai-python-sdk-tutorial/03-embeddings-search.md
index cb4ce133..8b3eedc0 100644
--- a/tutorials/openai-python-sdk-tutorial/03-embeddings-search.md
+++ b/tutorials/openai-python-sdk-tutorial/03-embeddings-search.md
@@ -632,7 +632,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Chat Completions](02-chat-completions.md)
 - [Next Chapter: Chapter 4: Agents and Assistants](04-assistants-api.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/openai-python-sdk-tutorial/04-assistants-api.md b/tutorials/openai-python-sdk-tutorial/04-assistants-api.md
index 722689e9..88f48e6a 100644
--- a/tutorials/openai-python-sdk-tutorial/04-assistants-api.md
+++ b/tutorials/openai-python-sdk-tutorial/04-assistants-api.md
@@ -638,7 +638,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Embeddings and Search](03-embeddings-search.md)
 - [Next Chapter: Chapter 5: Batch Processing](05-batch-processing.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/openai-python-sdk-tutorial/05-batch-processing.md b/tutorials/openai-python-sdk-tutorial/05-batch-processing.md
index 92b2d92c..bd59c5ba 100644
--- a/tutorials/openai-python-sdk-tutorial/05-batch-processing.md
+++ b/tutorials/openai-python-sdk-tutorial/05-batch-processing.md
@@ -634,7 +634,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Agents and Assistants](04-assistants-api.md)
 - [Next Chapter: Chapter 6: Fine-Tuning](06-fine-tuning.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/openai-python-sdk-tutorial/06-fine-tuning.md b/tutorials/openai-python-sdk-tutorial/06-fine-tuning.md
index 0918b7d2..481415fd 100644
--- a/tutorials/openai-python-sdk-tutorial/06-fine-tuning.md
+++ b/tutorials/openai-python-sdk-tutorial/06-fine-tuning.md
@@ -639,7 +639,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Batch Processing](05-batch-processing.md)
 - [Next Chapter: Chapter 7: Advanced Patterns](07-advanced-patterns.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/openai-python-sdk-tutorial/07-advanced-patterns.md b/tutorials/openai-python-sdk-tutorial/07-advanced-patterns.md
index 2cb98e2d..69efbaa9 100644
--- a/tutorials/openai-python-sdk-tutorial/07-advanced-patterns.md
+++ b/tutorials/openai-python-sdk-tutorial/07-advanced-patterns.md
@@ -634,7 +634,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Fine-Tuning](06-fine-tuning.md)
 - [Next Chapter: Chapter 8: Integration Examples](08-integration-examples.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/openai-python-sdk-tutorial/08-integration-examples.md b/tutorials/openai-python-sdk-tutorial/08-integration-examples.md
index 3f0552a9..5b41e9c9 100644
--- a/tutorials/openai-python-sdk-tutorial/08-integration-examples.md
+++ b/tutorials/openai-python-sdk-tutorial/08-integration-examples.md
@@ -639,7 +639,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Advanced Patterns](07-advanced-patterns.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/openai-python-sdk-tutorial/index.md b/tutorials/openai-python-sdk-tutorial/README.md
similarity index 100%
rename from tutorials/openai-python-sdk-tutorial/index.md
rename to tutorials/openai-python-sdk-tutorial/README.md
diff --git a/tutorials/openai-realtime-agents-tutorial/01-getting-started.md b/tutorials/openai-realtime-agents-tutorial/01-getting-started.md
index 5493908a..ada7f8f1 100644
--- a/tutorials/openai-realtime-agents-tutorial/01-getting-started.md
+++ b/tutorials/openai-realtime-agents-tutorial/01-getting-started.md
@@ -632,7 +632,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Realtime API Fundamentals](02-realtime-api-fundamentals.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/openai-realtime-agents-tutorial/02-realtime-api-fundamentals.md b/tutorials/openai-realtime-agents-tutorial/02-realtime-api-fundamentals.md
index e2515744..b752fc4b 100644
--- a/tutorials/openai-realtime-agents-tutorial/02-realtime-api-fundamentals.md
+++ b/tutorials/openai-realtime-agents-tutorial/02-realtime-api-fundamentals.md
@@ -630,7 +630,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started](01-getting-started.md)
 - [Next Chapter: Chapter 3: Voice Input Processing](03-voice-input-processing.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/openai-realtime-agents-tutorial/03-voice-input-processing.md b/tutorials/openai-realtime-agents-tutorial/03-voice-input-processing.md
index 93ef1e5c..6bc29b61 100644
--- a/tutorials/openai-realtime-agents-tutorial/03-voice-input-processing.md
+++ b/tutorials/openai-realtime-agents-tutorial/03-voice-input-processing.md
@@ -632,7 +632,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Realtime API Fundamentals](02-realtime-api-fundamentals.md)
 - [Next Chapter: Chapter 4: Conversational AI](04-conversational-ai.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/openai-realtime-agents-tutorial/04-conversational-ai.md b/tutorials/openai-realtime-agents-tutorial/04-conversational-ai.md
index 0a252f6f..1ff54d39 100644
--- a/tutorials/openai-realtime-agents-tutorial/04-conversational-ai.md
+++ b/tutorials/openai-realtime-agents-tutorial/04-conversational-ai.md
@@ -632,7 +632,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Voice Input Processing](03-voice-input-processing.md)
 - [Next Chapter: Chapter 5: Function Calling](05-function-calling.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/openai-realtime-agents-tutorial/05-function-calling.md b/tutorials/openai-realtime-agents-tutorial/05-function-calling.md
index 65d5b7f0..1eed61f6 100644
--- a/tutorials/openai-realtime-agents-tutorial/05-function-calling.md
+++ b/tutorials/openai-realtime-agents-tutorial/05-function-calling.md
@@ -631,7 +631,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Conversational AI](04-conversational-ai.md)
 - [Next Chapter: Chapter 6: Voice Output](06-voice-output.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/openai-realtime-agents-tutorial/06-voice-output.md b/tutorials/openai-realtime-agents-tutorial/06-voice-output.md
index c950dc5f..47d45634 100644
--- a/tutorials/openai-realtime-agents-tutorial/06-voice-output.md
+++ b/tutorials/openai-realtime-agents-tutorial/06-voice-output.md
@@ -634,7 +634,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Function Calling](05-function-calling.md)
 - [Next Chapter: Chapter 7: Advanced Patterns](07-advanced-patterns.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/openai-realtime-agents-tutorial/07-advanced-patterns.md b/tutorials/openai-realtime-agents-tutorial/07-advanced-patterns.md
index f3427280..d6b78440 100644
--- a/tutorials/openai-realtime-agents-tutorial/07-advanced-patterns.md
+++ b/tutorials/openai-realtime-agents-tutorial/07-advanced-patterns.md
@@ -634,7 +634,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Voice Output](06-voice-output.md)
 - [Next Chapter: Chapter 8: Production Deployment](08-production-deployment.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/openai-realtime-agents-tutorial/08-production-deployment.md b/tutorials/openai-realtime-agents-tutorial/08-production-deployment.md
index af127473..eb7edf81 100644
--- a/tutorials/openai-realtime-agents-tutorial/08-production-deployment.md
+++ b/tutorials/openai-realtime-agents-tutorial/08-production-deployment.md
@@ -634,7 +634,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Advanced Patterns](07-advanced-patterns.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/openai-realtime-agents-tutorial/index.md b/tutorials/openai-realtime-agents-tutorial/README.md
similarity index 100%
rename from tutorials/openai-realtime-agents-tutorial/index.md
rename to tutorials/openai-realtime-agents-tutorial/README.md
diff --git a/tutorials/openai-whisper-tutorial/01-getting-started.md b/tutorials/openai-whisper-tutorial/01-getting-started.md
index 0f6a2d70..b286359c 100644
--- a/tutorials/openai-whisper-tutorial/01-getting-started.md
+++ b/tutorials/openai-whisper-tutorial/01-getting-started.md
@@ -100,7 +100,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Model Architecture](02-model-architecture.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/openai-whisper-tutorial/02-model-architecture.md b/tutorials/openai-whisper-tutorial/02-model-architecture.md
index e8c00781..9344545c 100644
--- a/tutorials/openai-whisper-tutorial/02-model-architecture.md
+++ b/tutorials/openai-whisper-tutorial/02-model-architecture.md
@@ -95,7 +95,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started](01-getting-started.md)
 - [Next Chapter: Chapter 3: Audio Preprocessing](03-audio-preprocessing.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/openai-whisper-tutorial/03-audio-preprocessing.md b/tutorials/openai-whisper-tutorial/03-audio-preprocessing.md
index 18a5629d..0eacbfc1 100644
--- a/tutorials/openai-whisper-tutorial/03-audio-preprocessing.md
+++ b/tutorials/openai-whisper-tutorial/03-audio-preprocessing.md
@@ -90,7 +90,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Model Architecture](02-model-architecture.md)
 - [Next Chapter: Chapter 4: Transcription and Translation](04-transcription-translation.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/openai-whisper-tutorial/04-transcription-translation.md b/tutorials/openai-whisper-tutorial/04-transcription-translation.md
index 6870cf0e..b3f0975e 100644
--- a/tutorials/openai-whisper-tutorial/04-transcription-translation.md
+++ b/tutorials/openai-whisper-tutorial/04-transcription-translation.md
@@ -92,7 +92,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Audio Preprocessing](03-audio-preprocessing.md)
 - [Next Chapter: Chapter 5: Fine-Tuning and Adaptation](05-fine-tuning.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/openai-whisper-tutorial/05-fine-tuning.md b/tutorials/openai-whisper-tutorial/05-fine-tuning.md
index 0782b387..b1998912 100644
--- a/tutorials/openai-whisper-tutorial/05-fine-tuning.md
+++ b/tutorials/openai-whisper-tutorial/05-fine-tuning.md
@@ -90,7 +90,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Transcription and Translation](04-transcription-translation.md)
 - [Next Chapter: Chapter 6: Advanced Features](06-advanced-features.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/openai-whisper-tutorial/06-advanced-features.md b/tutorials/openai-whisper-tutorial/06-advanced-features.md
index 849fb9ec..ce6dd8cb 100644
--- a/tutorials/openai-whisper-tutorial/06-advanced-features.md
+++ b/tutorials/openai-whisper-tutorial/06-advanced-features.md
@@ -92,7 +92,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Fine-Tuning and Adaptation](05-fine-tuning.md)
 - [Next Chapter: Chapter 7: Performance Optimization](07-performance-optimization.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/openai-whisper-tutorial/07-performance-optimization.md b/tutorials/openai-whisper-tutorial/07-performance-optimization.md
index ec0cb74b..77a1d2f0 100644
--- a/tutorials/openai-whisper-tutorial/07-performance-optimization.md
+++ b/tutorials/openai-whisper-tutorial/07-performance-optimization.md
@@ -83,7 +83,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Advanced Features](06-advanced-features.md)
 - [Next Chapter: Chapter 8: Production Deployment](08-production-deployment.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/openai-whisper-tutorial/08-production-deployment.md b/tutorials/openai-whisper-tutorial/08-production-deployment.md
index 68cd230e..90eecd14 100644
--- a/tutorials/openai-whisper-tutorial/08-production-deployment.md
+++ b/tutorials/openai-whisper-tutorial/08-production-deployment.md
@@ -92,7 +92,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Performance Optimization](07-performance-optimization.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/openai-whisper-tutorial/index.md b/tutorials/openai-whisper-tutorial/README.md
similarity index 100%
rename from tutorials/openai-whisper-tutorial/index.md
rename to tutorials/openai-whisper-tutorial/README.md
diff --git a/tutorials/openbb-tutorial/01-getting-started.md b/tutorials/openbb-tutorial/01-getting-started.md
index 7badd530..66e78d46 100644
--- a/tutorials/openbb-tutorial/01-getting-started.md
+++ b/tutorials/openbb-tutorial/01-getting-started.md
@@ -523,7 +523,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Financial Data Access](02-data-access.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/openbb-tutorial/02-data-access.md b/tutorials/openbb-tutorial/02-data-access.md
index 638b58c9..67bc12a0 100644
--- a/tutorials/openbb-tutorial/02-data-access.md
+++ b/tutorials/openbb-tutorial/02-data-access.md
@@ -780,7 +780,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started with OpenBB](01-getting-started.md)
 - [Next Chapter: Chapter 3: Technical Analysis](03-technical-analysis.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/openbb-tutorial/03-technical-analysis.md b/tutorials/openbb-tutorial/03-technical-analysis.md
index 9343c215..a86d9bf8 100644
--- a/tutorials/openbb-tutorial/03-technical-analysis.md
+++ b/tutorials/openbb-tutorial/03-technical-analysis.md
@@ -919,7 +919,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Financial Data Access](02-data-access.md)
 - [Next Chapter: Chapter 4: Fundamental Analysis](04-quantitative-analysis.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/openbb-tutorial/04-quantitative-analysis.md b/tutorials/openbb-tutorial/04-quantitative-analysis.md
index 45dc8be8..b16aa27c 100644
--- a/tutorials/openbb-tutorial/04-quantitative-analysis.md
+++ b/tutorials/openbb-tutorial/04-quantitative-analysis.md
@@ -897,7 +897,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Technical Analysis](03-technical-analysis.md)
 - [Next Chapter: Chapter 5: Portfolio Management](05-portfolio-management.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/openbb-tutorial/05-portfolio-management.md b/tutorials/openbb-tutorial/05-portfolio-management.md
index f619c7b4..f99668bb 100644
--- a/tutorials/openbb-tutorial/05-portfolio-management.md
+++ b/tutorials/openbb-tutorial/05-portfolio-management.md
@@ -965,7 +965,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Fundamental Analysis](04-quantitative-analysis.md)
 - [Next Chapter: Chapter 6: Custom Data Sources](06-research-automation.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/openbb-tutorial/06-research-automation.md b/tutorials/openbb-tutorial/06-research-automation.md
index d23052ff..b8b10830 100644
--- a/tutorials/openbb-tutorial/06-research-automation.md
+++ b/tutorials/openbb-tutorial/06-research-automation.md
@@ -839,7 +839,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Portfolio Management](05-portfolio-management.md)
 - [Next Chapter: Chapter 7: Visualization & Dashboards](07-custom-extensions.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/openbb-tutorial/07-custom-extensions.md b/tutorials/openbb-tutorial/07-custom-extensions.md
index 1c373c21..208ee157 100644
--- a/tutorials/openbb-tutorial/07-custom-extensions.md
+++ b/tutorials/openbb-tutorial/07-custom-extensions.md
@@ -1098,7 +1098,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Custom Data Sources](06-research-automation.md)
 - [Next Chapter: Chapter 8: Production Deployment](08-enterprise-deployment.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/openbb-tutorial/08-enterprise-deployment.md b/tutorials/openbb-tutorial/08-enterprise-deployment.md
index 31d6ade7..f99af2d2 100644
--- a/tutorials/openbb-tutorial/08-enterprise-deployment.md
+++ b/tutorials/openbb-tutorial/08-enterprise-deployment.md
@@ -1226,7 +1226,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Visualization & Dashboards](07-custom-extensions.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/openbb-tutorial/index.md b/tutorials/openbb-tutorial/README.md
similarity index 100%
rename from tutorials/openbb-tutorial/index.md
rename to tutorials/openbb-tutorial/README.md
diff --git a/tutorials/openclaw-tutorial/01-getting-started.md b/tutorials/openclaw-tutorial/01-getting-started.md
index 2a9bcaa4..add9f2a1 100644
--- a/tutorials/openclaw-tutorial/01-getting-started.md
+++ b/tutorials/openclaw-tutorial/01-getting-started.md
@@ -449,7 +449,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Gateway Architecture](02-gateway-architecture.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/openclaw-tutorial/02-gateway-architecture.md b/tutorials/openclaw-tutorial/02-gateway-architecture.md
index 24d1309b..9517c89f 100644
--- a/tutorials/openclaw-tutorial/02-gateway-architecture.md
+++ b/tutorials/openclaw-tutorial/02-gateway-architecture.md
@@ -668,7 +668,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started with OpenClaw](01-getting-started.md)
 - [Next Chapter: Chapter 3: Channel Drivers](03-channel-drivers.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/openclaw-tutorial/03-channel-drivers.md b/tutorials/openclaw-tutorial/03-channel-drivers.md
index 8e5fdea3..6822fc3d 100644
--- a/tutorials/openclaw-tutorial/03-channel-drivers.md
+++ b/tutorials/openclaw-tutorial/03-channel-drivers.md
@@ -779,7 +779,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Gateway Architecture](02-gateway-architecture.md)
 - [Next Chapter: Chapter 4: Agent Runtime](04-agent-runtime.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/openclaw-tutorial/04-agent-runtime.md b/tutorials/openclaw-tutorial/04-agent-runtime.md
index f9456b83..43cde36d 100644
--- a/tutorials/openclaw-tutorial/04-agent-runtime.md
+++ b/tutorials/openclaw-tutorial/04-agent-runtime.md
@@ -680,7 +680,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Channel Drivers](03-channel-drivers.md)
 - [Next Chapter: Chapter 5: Memory & Sessions](05-memory-sessions.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/openclaw-tutorial/05-memory-sessions.md b/tutorials/openclaw-tutorial/05-memory-sessions.md
index f8e368a9..468fc82e 100644
--- a/tutorials/openclaw-tutorial/05-memory-sessions.md
+++ b/tutorials/openclaw-tutorial/05-memory-sessions.md
@@ -670,7 +670,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Agent Runtime](04-agent-runtime.md)
 - [Next Chapter: Chapter 6: Skills & Tools](06-skills-tools.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/openclaw-tutorial/06-skills-tools.md b/tutorials/openclaw-tutorial/06-skills-tools.md
index d116c001..13a0402a 100644
--- a/tutorials/openclaw-tutorial/06-skills-tools.md
+++ b/tutorials/openclaw-tutorial/06-skills-tools.md
@@ -671,7 +671,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Memory & Sessions](05-memory-sessions.md)
 - [Next Chapter: Chapter 7: Security & Networking](07-security-networking.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/openclaw-tutorial/07-security-networking.md b/tutorials/openclaw-tutorial/07-security-networking.md
index 92082a62..936b8465 100644
--- a/tutorials/openclaw-tutorial/07-security-networking.md
+++ b/tutorials/openclaw-tutorial/07-security-networking.md
@@ -726,7 +726,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Skills & Tools](06-skills-tools.md)
 - [Next Chapter: Chapter 8: Production Deployment](08-production-deployment.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/openclaw-tutorial/08-production-deployment.md b/tutorials/openclaw-tutorial/08-production-deployment.md
index 7a54cffc..84e7128f 100644
--- a/tutorials/openclaw-tutorial/08-production-deployment.md
+++ b/tutorials/openclaw-tutorial/08-production-deployment.md
@@ -749,7 +749,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Security & Networking](07-security-networking.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/openclaw-tutorial/index.md b/tutorials/openclaw-tutorial/README.md
similarity index 100%
rename from tutorials/openclaw-tutorial/index.md
rename to tutorials/openclaw-tutorial/README.md
diff --git a/tutorials/opencode-ai-legacy-tutorial/01-getting-started-and-project-status.md b/tutorials/opencode-ai-legacy-tutorial/01-getting-started-and-project-status.md
index 79c4695d..ca2f69d4 100644
--- a/tutorials/opencode-ai-legacy-tutorial/01-getting-started-and-project-status.md
+++ b/tutorials/opencode-ai-legacy-tutorial/01-getting-started-and-project-status.md
@@ -632,7 +632,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Legacy Architecture and Feature Model](02-legacy-architecture-and-feature-model.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/opencode-ai-legacy-tutorial/02-legacy-architecture-and-feature-model.md b/tutorials/opencode-ai-legacy-tutorial/02-legacy-architecture-and-feature-model.md
index 9849cd08..17353fc7 100644
--- a/tutorials/opencode-ai-legacy-tutorial/02-legacy-architecture-and-feature-model.md
+++ b/tutorials/opencode-ai-legacy-tutorial/02-legacy-architecture-and-feature-model.md
@@ -634,7 +634,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started and Project Status](01-getting-started-and-project-status.md)
 - [Next Chapter: Chapter 3: Installation and Configuration Baseline](03-installation-and-configuration-baseline.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/opencode-ai-legacy-tutorial/03-installation-and-configuration-baseline.md b/tutorials/opencode-ai-legacy-tutorial/03-installation-and-configuration-baseline.md
index 03585f8a..202f2a73 100644
--- a/tutorials/opencode-ai-legacy-tutorial/03-installation-and-configuration-baseline.md
+++ b/tutorials/opencode-ai-legacy-tutorial/03-installation-and-configuration-baseline.md
@@ -635,7 +635,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Legacy Architecture and Feature Model](02-legacy-architecture-and-feature-model.md)
 - [Next Chapter: Chapter 4: Model Providers and Runtime Operations](04-model-providers-and-runtime-operations.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/opencode-ai-legacy-tutorial/04-model-providers-and-runtime-operations.md b/tutorials/opencode-ai-legacy-tutorial/04-model-providers-and-runtime-operations.md
index 3a3c483a..f2f915c5 100644
--- a/tutorials/opencode-ai-legacy-tutorial/04-model-providers-and-runtime-operations.md
+++ b/tutorials/opencode-ai-legacy-tutorial/04-model-providers-and-runtime-operations.md
@@ -634,7 +634,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Installation and Configuration Baseline](03-installation-and-configuration-baseline.md)
 - [Next Chapter: Chapter 5: Interactive and Non-Interactive Workflows](05-interactive-and-non-interactive-workflows.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/opencode-ai-legacy-tutorial/05-interactive-and-non-interactive-workflows.md b/tutorials/opencode-ai-legacy-tutorial/05-interactive-and-non-interactive-workflows.md
index ebe3dc6e..8e27fffb 100644
--- a/tutorials/opencode-ai-legacy-tutorial/05-interactive-and-non-interactive-workflows.md
+++ b/tutorials/opencode-ai-legacy-tutorial/05-interactive-and-non-interactive-workflows.md
@@ -634,7 +634,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Model Providers and Runtime Operations](04-model-providers-and-runtime-operations.md)
 - [Next Chapter: Chapter 6: Session, Tooling, and Integration Practices](06-session-tooling-and-integration-practices.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/opencode-ai-legacy-tutorial/06-session-tooling-and-integration-practices.md b/tutorials/opencode-ai-legacy-tutorial/06-session-tooling-and-integration-practices.md
index 559ba3dd..5fe09b55 100644
--- a/tutorials/opencode-ai-legacy-tutorial/06-session-tooling-and-integration-practices.md
+++ b/tutorials/opencode-ai-legacy-tutorial/06-session-tooling-and-integration-practices.md
@@ -634,7 +634,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Interactive and Non-Interactive Workflows](05-interactive-and-non-interactive-workflows.md)
 - [Next Chapter: Chapter 7: Migration to Crush and Modern Alternatives](07-migration-to-crush-and-modern-alternatives.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/opencode-ai-legacy-tutorial/07-migration-to-crush-and-modern-alternatives.md b/tutorials/opencode-ai-legacy-tutorial/07-migration-to-crush-and-modern-alternatives.md
index f43977b2..56c83082 100644
--- a/tutorials/opencode-ai-legacy-tutorial/07-migration-to-crush-and-modern-alternatives.md
+++ b/tutorials/opencode-ai-legacy-tutorial/07-migration-to-crush-and-modern-alternatives.md
@@ -624,7 +624,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Session, Tooling, and Integration Practices](06-session-tooling-and-integration-practices.md)
 - [Next Chapter: Chapter 8: Legacy Governance and Controlled Sunset](08-legacy-governance-and-controlled-sunset.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/opencode-ai-legacy-tutorial/08-legacy-governance-and-controlled-sunset.md b/tutorials/opencode-ai-legacy-tutorial/08-legacy-governance-and-controlled-sunset.md
index a7d44347..4753cdd8 100644
--- a/tutorials/opencode-ai-legacy-tutorial/08-legacy-governance-and-controlled-sunset.md
+++ b/tutorials/opencode-ai-legacy-tutorial/08-legacy-governance-and-controlled-sunset.md
@@ -624,7 +624,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Migration to Crush and Modern Alternatives](07-migration-to-crush-and-modern-alternatives.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/opencode-ai-legacy-tutorial/index.md b/tutorials/opencode-ai-legacy-tutorial/README.md
similarity index 100%
rename from tutorials/opencode-ai-legacy-tutorial/index.md
rename to tutorials/opencode-ai-legacy-tutorial/README.md
diff --git a/tutorials/opencode-tutorial/01-getting-started.md b/tutorials/opencode-tutorial/01-getting-started.md
index 1c4fdf4e..891121a1 100644
--- a/tutorials/opencode-tutorial/01-getting-started.md
+++ b/tutorials/opencode-tutorial/01-getting-started.md
@@ -628,7 +628,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Architecture and Agent Loop](02-architecture-agent-loop.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/opencode-tutorial/02-architecture-agent-loop.md b/tutorials/opencode-tutorial/02-architecture-agent-loop.md
index c5717a3a..2ee98786 100644
--- a/tutorials/opencode-tutorial/02-architecture-agent-loop.md
+++ b/tutorials/opencode-tutorial/02-architecture-agent-loop.md
@@ -637,7 +637,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started](01-getting-started.md)
 - [Next Chapter: Chapter 3: Model and Provider Routing](03-model-and-provider-routing.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/opencode-tutorial/03-model-and-provider-routing.md b/tutorials/opencode-tutorial/03-model-and-provider-routing.md
index a3ff5263..86e71daa 100644
--- a/tutorials/opencode-tutorial/03-model-and-provider-routing.md
+++ b/tutorials/opencode-tutorial/03-model-and-provider-routing.md
@@ -630,7 +630,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Architecture and Agent Loop](02-architecture-agent-loop.md)
 - [Next Chapter: Chapter 4: Tools, Permissions, and Execution](04-tools-permissions-and-execution.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/opencode-tutorial/04-tools-permissions-and-execution.md b/tutorials/opencode-tutorial/04-tools-permissions-and-execution.md
index 25a30450..27b00a46 100644
--- a/tutorials/opencode-tutorial/04-tools-permissions-and-execution.md
+++ b/tutorials/opencode-tutorial/04-tools-permissions-and-execution.md
@@ -632,7 +632,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Model and Provider Routing](03-model-and-provider-routing.md)
 - [Next Chapter: Chapter 5: Agents, Subagents, and Planning](05-agents-subagents-and-planning.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/opencode-tutorial/05-agents-subagents-and-planning.md b/tutorials/opencode-tutorial/05-agents-subagents-and-planning.md
index 382a0413..e30d2c1b 100644
--- a/tutorials/opencode-tutorial/05-agents-subagents-and-planning.md
+++ b/tutorials/opencode-tutorial/05-agents-subagents-and-planning.md
@@ -630,7 +630,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Tools, Permissions, and Execution](04-tools-permissions-and-execution.md)
 - [Next Chapter: Chapter 6: Client/Server and Remote Workflows](06-client-server-and-remote-workflows.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/opencode-tutorial/06-client-server-and-remote-workflows.md b/tutorials/opencode-tutorial/06-client-server-and-remote-workflows.md
index 2192f0ca..02001342 100644
--- a/tutorials/opencode-tutorial/06-client-server-and-remote-workflows.md
+++ b/tutorials/opencode-tutorial/06-client-server-and-remote-workflows.md
@@ -627,7 +627,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Agents, Subagents, and Planning](05-agents-subagents-and-planning.md)
 - [Next Chapter: Chapter 7: Integrations: MCP, LSP, and Extensions](07-integrations-mcp-lsp-and-extensions.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/opencode-tutorial/07-integrations-mcp-lsp-and-extensions.md b/tutorials/opencode-tutorial/07-integrations-mcp-lsp-and-extensions.md
index 2a1512b9..dac27c1f 100644
--- a/tutorials/opencode-tutorial/07-integrations-mcp-lsp-and-extensions.md
+++ b/tutorials/opencode-tutorial/07-integrations-mcp-lsp-and-extensions.md
@@ -624,7 +624,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Client/Server and Remote Workflows](06-client-server-and-remote-workflows.md)
 - [Next Chapter: Chapter 8: Production Operations and Security](08-production-operations-security.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/opencode-tutorial/08-production-operations-security.md b/tutorials/opencode-tutorial/08-production-operations-security.md
index 4880d444..5f3d36f2 100644
--- a/tutorials/opencode-tutorial/08-production-operations-security.md
+++ b/tutorials/opencode-tutorial/08-production-operations-security.md
@@ -632,7 +632,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Integrations: MCP, LSP, and Extensions](07-integrations-mcp-lsp-and-extensions.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/opencode-tutorial/index.md b/tutorials/opencode-tutorial/README.md
similarity index 100%
rename from tutorials/opencode-tutorial/index.md
rename to tutorials/opencode-tutorial/README.md
diff --git a/tutorials/openhands-tutorial/01-getting-started.md b/tutorials/openhands-tutorial/01-getting-started.md
index 4e81d92e..893987e8 100644
--- a/tutorials/openhands-tutorial/01-getting-started.md
+++ b/tutorials/openhands-tutorial/01-getting-started.md
@@ -713,7 +713,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Basic Operations - Files, Commands, and Environments](02-basic-operations.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/openhands-tutorial/02-basic-operations.md b/tutorials/openhands-tutorial/02-basic-operations.md
index f92c995c..6398cb20 100644
--- a/tutorials/openhands-tutorial/02-basic-operations.md
+++ b/tutorials/openhands-tutorial/02-basic-operations.md
@@ -650,7 +650,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started with OpenHands](01-getting-started.md)
 - [Next Chapter: Chapter 3: Code Generation - Creating Production-Ready Code](03-code-generation.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/openhands-tutorial/03-code-generation.md b/tutorials/openhands-tutorial/03-code-generation.md
index 3df4f836..b0af235c 100644
--- a/tutorials/openhands-tutorial/03-code-generation.md
+++ b/tutorials/openhands-tutorial/03-code-generation.md
@@ -709,7 +709,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Basic Operations - Files, Commands, and Environments](02-basic-operations.md)
 - [Next Chapter: Chapter 4: Bug Fixing - Autonomous Debugging and Resolution](04-bug-fixing.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/openhands-tutorial/04-bug-fixing.md b/tutorials/openhands-tutorial/04-bug-fixing.md
index 6ed754f0..218d74a6 100644
--- a/tutorials/openhands-tutorial/04-bug-fixing.md
+++ b/tutorials/openhands-tutorial/04-bug-fixing.md
@@ -867,7 +867,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Code Generation - Creating Production-Ready Code](03-code-generation.md)
 - [Next Chapter: Chapter 5: Testing - Comprehensive Test Suite Generation and Quality Assurance](05-testing.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/openhands-tutorial/05-testing.md b/tutorials/openhands-tutorial/05-testing.md
index 11994269..089f5164 100644
--- a/tutorials/openhands-tutorial/05-testing.md
+++ b/tutorials/openhands-tutorial/05-testing.md
@@ -704,7 +704,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Bug Fixing - Autonomous Debugging and Resolution](04-bug-fixing.md)
 - [Next Chapter: Chapter 6: Refactoring - Code Structure Improvement and Modernization](06-refactoring.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/openhands-tutorial/06-refactoring.md b/tutorials/openhands-tutorial/06-refactoring.md
index ae240bf1..99df1515 100644
--- a/tutorials/openhands-tutorial/06-refactoring.md
+++ b/tutorials/openhands-tutorial/06-refactoring.md
@@ -922,7 +922,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Testing - Comprehensive Test Suite Generation and Quality Assurance](05-testing.md)
 - [Next Chapter: Chapter 7: Integration - Connecting Applications with External Services](07-integration.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/openhands-tutorial/07-integration.md b/tutorials/openhands-tutorial/07-integration.md
index 9ce67ffe..bf40c841 100644
--- a/tutorials/openhands-tutorial/07-integration.md
+++ b/tutorials/openhands-tutorial/07-integration.md
@@ -729,7 +729,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Refactoring - Code Structure Improvement and Modernization](06-refactoring.md)
 - [Next Chapter: Chapter 8: Advanced Projects - Complete Applications and System Architectures](08-advanced-projects.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/openhands-tutorial/08-advanced-projects.md b/tutorials/openhands-tutorial/08-advanced-projects.md
index 6bce5855..41bb38fe 100644
--- a/tutorials/openhands-tutorial/08-advanced-projects.md
+++ b/tutorials/openhands-tutorial/08-advanced-projects.md
@@ -753,7 +753,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Integration - Connecting Applications with External Services](07-integration.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/openhands-tutorial/index.md b/tutorials/openhands-tutorial/README.md
similarity index 100%
rename from tutorials/openhands-tutorial/index.md
rename to tutorials/openhands-tutorial/README.md
diff --git a/tutorials/openskills-tutorial/01-getting-started.md b/tutorials/openskills-tutorial/01-getting-started.md
index 4a7bd469..cb497fe2 100644
--- a/tutorials/openskills-tutorial/01-getting-started.md
+++ b/tutorials/openskills-tutorial/01-getting-started.md
@@ -630,7 +630,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Skill Format and Loader Architecture](02-skill-format-and-loader-architecture.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/openskills-tutorial/02-skill-format-and-loader-architecture.md b/tutorials/openskills-tutorial/02-skill-format-and-loader-architecture.md
index b5b58bd3..6bb72cf0 100644
--- a/tutorials/openskills-tutorial/02-skill-format-and-loader-architecture.md
+++ b/tutorials/openskills-tutorial/02-skill-format-and-loader-architecture.md
@@ -633,7 +633,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started](01-getting-started.md)
 - [Next Chapter: Chapter 3: Installation Sources and Trust Model](03-installation-sources-and-trust-model.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/openskills-tutorial/03-installation-sources-and-trust-model.md b/tutorials/openskills-tutorial/03-installation-sources-and-trust-model.md
index 8601dcbb..d72b06f8 100644
--- a/tutorials/openskills-tutorial/03-installation-sources-and-trust-model.md
+++ b/tutorials/openskills-tutorial/03-installation-sources-and-trust-model.md
@@ -633,7 +633,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Skill Format and Loader Architecture](02-skill-format-and-loader-architecture.md)
 - [Next Chapter: Chapter 4: Sync and AGENTS.md Integration](04-sync-and-agents-md-integration.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/openskills-tutorial/04-sync-and-agents-md-integration.md b/tutorials/openskills-tutorial/04-sync-and-agents-md-integration.md
index 20a8ef8a..fd9223ed 100644
--- a/tutorials/openskills-tutorial/04-sync-and-agents-md-integration.md
+++ b/tutorials/openskills-tutorial/04-sync-and-agents-md-integration.md
@@ -632,7 +632,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Installation Sources and Trust Model](03-installation-sources-and-trust-model.md)
 - [Next Chapter: Chapter 5: Universal Mode and Multi-Agent Setups](05-universal-mode-and-multi-agent-setups.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/openskills-tutorial/05-universal-mode-and-multi-agent-setups.md b/tutorials/openskills-tutorial/05-universal-mode-and-multi-agent-setups.md
index 72059780..b95c4309 100644
--- a/tutorials/openskills-tutorial/05-universal-mode-and-multi-agent-setups.md
+++ b/tutorials/openskills-tutorial/05-universal-mode-and-multi-agent-setups.md
@@ -632,7 +632,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Sync and AGENTS.md Integration](04-sync-and-agents-md-integration.md)
 - [Next Chapter: Chapter 6: Skill Authoring and Packaging](06-skill-authoring-and-packaging.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/openskills-tutorial/06-skill-authoring-and-packaging.md b/tutorials/openskills-tutorial/06-skill-authoring-and-packaging.md
index 06e2d817..4f96b6fd 100644
--- a/tutorials/openskills-tutorial/06-skill-authoring-and-packaging.md
+++ b/tutorials/openskills-tutorial/06-skill-authoring-and-packaging.md
@@ -632,7 +632,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Universal Mode and Multi-Agent Setups](05-universal-mode-and-multi-agent-setups.md)
 - [Next Chapter: Chapter 7: Updates, Versioning, and Governance](07-updates-versioning-and-governance.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/openskills-tutorial/07-updates-versioning-and-governance.md b/tutorials/openskills-tutorial/07-updates-versioning-and-governance.md
index b62868d3..551dc54b 100644
--- a/tutorials/openskills-tutorial/07-updates-versioning-and-governance.md
+++ b/tutorials/openskills-tutorial/07-updates-versioning-and-governance.md
@@ -633,7 +633,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Skill Authoring and Packaging](06-skill-authoring-and-packaging.md)
 - [Next Chapter: Chapter 8: Production Security and Operations](08-production-security-and-operations.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/openskills-tutorial/08-production-security-and-operations.md b/tutorials/openskills-tutorial/08-production-security-and-operations.md
index b5d84467..684d5e11 100644
--- a/tutorials/openskills-tutorial/08-production-security-and-operations.md
+++ b/tutorials/openskills-tutorial/08-production-security-and-operations.md
@@ -630,7 +630,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Updates, Versioning, and Governance](07-updates-versioning-and-governance.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/openskills-tutorial/index.md b/tutorials/openskills-tutorial/README.md
similarity index 100%
rename from tutorials/openskills-tutorial/index.md
rename to tutorials/openskills-tutorial/README.md
diff --git a/tutorials/openspec-tutorial/01-getting-started-and-opsx-basics.md b/tutorials/openspec-tutorial/01-getting-started-and-opsx-basics.md
index 23a7a2dc..1635cb9d 100644
--- a/tutorials/openspec-tutorial/01-getting-started-and-opsx-basics.md
+++ b/tutorials/openspec-tutorial/01-getting-started-and-opsx-basics.md
@@ -641,7 +641,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Artifact Graph and Change Lifecycle](02-artifact-graph-and-change-lifecycle.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/openspec-tutorial/02-artifact-graph-and-change-lifecycle.md b/tutorials/openspec-tutorial/02-artifact-graph-and-change-lifecycle.md
index aef8bd62..3406a8b1 100644
--- a/tutorials/openspec-tutorial/02-artifact-graph-and-change-lifecycle.md
+++ b/tutorials/openspec-tutorial/02-artifact-graph-and-change-lifecycle.md
@@ -637,7 +637,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started and OPSX Basics](01-getting-started-and-opsx-basics.md)
 - [Next Chapter: Chapter 3: Command Surface and Agent Workflows](03-command-surface-and-agent-workflows.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/openspec-tutorial/03-command-surface-and-agent-workflows.md b/tutorials/openspec-tutorial/03-command-surface-and-agent-workflows.md
index 08e433aa..b4663613 100644
--- a/tutorials/openspec-tutorial/03-command-surface-and-agent-workflows.md
+++ b/tutorials/openspec-tutorial/03-command-surface-and-agent-workflows.md
@@ -644,7 +644,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Artifact Graph and Change Lifecycle](02-artifact-graph-and-change-lifecycle.md)
 - [Next Chapter: Chapter 4: Spec Authoring, Delta Patterns, and Quality](04-spec-authoring-delta-patterns-and-quality.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/openspec-tutorial/04-spec-authoring-delta-patterns-and-quality.md b/tutorials/openspec-tutorial/04-spec-authoring-delta-patterns-and-quality.md
index 062c8659..e4594ed4 100644
--- a/tutorials/openspec-tutorial/04-spec-authoring-delta-patterns-and-quality.md
+++ b/tutorials/openspec-tutorial/04-spec-authoring-delta-patterns-and-quality.md
@@ -636,7 +636,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Command Surface and Agent Workflows](03-command-surface-and-agent-workflows.md)
 - [Next Chapter: Chapter 5: Customization, Schemas, and Project Rules](05-customization-schemas-and-project-rules.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/openspec-tutorial/05-customization-schemas-and-project-rules.md b/tutorials/openspec-tutorial/05-customization-schemas-and-project-rules.md
index 1c4045d1..88f9d8a6 100644
--- a/tutorials/openspec-tutorial/05-customization-schemas-and-project-rules.md
+++ b/tutorials/openspec-tutorial/05-customization-schemas-and-project-rules.md
@@ -639,7 +639,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Spec Authoring, Delta Patterns, and Quality](04-spec-authoring-delta-patterns-and-quality.md)
 - [Next Chapter: Chapter 6: Tool Integrations and Multi-Agent Portability](06-tool-integrations-and-multi-agent-portability.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/openspec-tutorial/06-tool-integrations-and-multi-agent-portability.md b/tutorials/openspec-tutorial/06-tool-integrations-and-multi-agent-portability.md
index e1821ae1..4b24515e 100644
--- a/tutorials/openspec-tutorial/06-tool-integrations-and-multi-agent-portability.md
+++ b/tutorials/openspec-tutorial/06-tool-integrations-and-multi-agent-portability.md
@@ -642,7 +642,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Customization, Schemas, and Project Rules](05-customization-schemas-and-project-rules.md)
 - [Next Chapter: Chapter 7: Validation, Automation, and CI Operations](07-validation-automation-and-ci-operations.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/openspec-tutorial/07-validation-automation-and-ci-operations.md b/tutorials/openspec-tutorial/07-validation-automation-and-ci-operations.md
index e0caa5e6..d1f8cbed 100644
--- a/tutorials/openspec-tutorial/07-validation-automation-and-ci-operations.md
+++ b/tutorials/openspec-tutorial/07-validation-automation-and-ci-operations.md
@@ -637,7 +637,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Tool Integrations and Multi-Agent Portability](06-tool-integrations-and-multi-agent-portability.md)
 - [Next Chapter: Chapter 8: Migration, Governance, and Team Adoption](08-migration-governance-and-team-adoption.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/openspec-tutorial/08-migration-governance-and-team-adoption.md b/tutorials/openspec-tutorial/08-migration-governance-and-team-adoption.md
index 1647e3f6..be8200a1 100644
--- a/tutorials/openspec-tutorial/08-migration-governance-and-team-adoption.md
+++ b/tutorials/openspec-tutorial/08-migration-governance-and-team-adoption.md
@@ -639,7 +639,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Validation, Automation, and CI Operations](07-validation-automation-and-ci-operations.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/openspec-tutorial/index.md b/tutorials/openspec-tutorial/README.md
similarity index 100%
rename from tutorials/openspec-tutorial/index.md
rename to tutorials/openspec-tutorial/README.md
diff --git a/tutorials/opensrc-tutorial/01-getting-started.md b/tutorials/opensrc-tutorial/01-getting-started.md
index f11798f5..6a47ad62 100644
--- a/tutorials/opensrc-tutorial/01-getting-started.md
+++ b/tutorials/opensrc-tutorial/01-getting-started.md
@@ -635,7 +635,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Input Parsing and Resolution Pipeline](02-input-parsing-and-resolution-pipeline.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/opensrc-tutorial/02-input-parsing-and-resolution-pipeline.md b/tutorials/opensrc-tutorial/02-input-parsing-and-resolution-pipeline.md
index ba2c03ca..a4fffb2a 100644
--- a/tutorials/opensrc-tutorial/02-input-parsing-and-resolution-pipeline.md
+++ b/tutorials/opensrc-tutorial/02-input-parsing-and-resolution-pipeline.md
@@ -628,7 +628,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started](01-getting-started.md)
 - [Next Chapter: Chapter 3: Multi-Registry Package Fetching](03-multi-registry-package-fetching.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/opensrc-tutorial/03-multi-registry-package-fetching.md b/tutorials/opensrc-tutorial/03-multi-registry-package-fetching.md
index 69cd179c..e8901803 100644
--- a/tutorials/opensrc-tutorial/03-multi-registry-package-fetching.md
+++ b/tutorials/opensrc-tutorial/03-multi-registry-package-fetching.md
@@ -639,7 +639,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Input Parsing and Resolution Pipeline](02-input-parsing-and-resolution-pipeline.md)
 - [Next Chapter: Chapter 4: Git Repository Source Imports](04-git-repository-source-imports.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/opensrc-tutorial/04-git-repository-source-imports.md b/tutorials/opensrc-tutorial/04-git-repository-source-imports.md
index 3b4475c3..c0aa3e12 100644
--- a/tutorials/opensrc-tutorial/04-git-repository-source-imports.md
+++ b/tutorials/opensrc-tutorial/04-git-repository-source-imports.md
@@ -636,7 +636,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Multi-Registry Package Fetching](03-multi-registry-package-fetching.md)
 - [Next Chapter: Chapter 5: AGENTS.md and sources.json Integration](05-agents-md-and-sources-json-integration.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/opensrc-tutorial/05-agents-md-and-sources-json-integration.md b/tutorials/opensrc-tutorial/05-agents-md-and-sources-json-integration.md
index b5dd3214..a2efe2cb 100644
--- a/tutorials/opensrc-tutorial/05-agents-md-and-sources-json-integration.md
+++ b/tutorials/opensrc-tutorial/05-agents-md-and-sources-json-integration.md
@@ -637,7 +637,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Git Repository Source Imports](04-git-repository-source-imports.md)
 - [Next Chapter: Chapter 6: Update, Remove, and Clean Lifecycle](06-update-remove-and-clean-lifecycle.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/opensrc-tutorial/06-update-remove-and-clean-lifecycle.md b/tutorials/opensrc-tutorial/06-update-remove-and-clean-lifecycle.md
index fe4c7101..0fc66f55 100644
--- a/tutorials/opensrc-tutorial/06-update-remove-and-clean-lifecycle.md
+++ b/tutorials/opensrc-tutorial/06-update-remove-and-clean-lifecycle.md
@@ -633,7 +633,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: AGENTS.md and sources.json Integration](05-agents-md-and-sources-json-integration.md)
 - [Next Chapter: Chapter 7: Reliability, Rate Limits, and Version Fallbacks](07-reliability-rate-limits-and-version-fallbacks.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/opensrc-tutorial/07-reliability-rate-limits-and-version-fallbacks.md b/tutorials/opensrc-tutorial/07-reliability-rate-limits-and-version-fallbacks.md
index 7d2d6bb5..8af46985 100644
--- a/tutorials/opensrc-tutorial/07-reliability-rate-limits-and-version-fallbacks.md
+++ b/tutorials/opensrc-tutorial/07-reliability-rate-limits-and-version-fallbacks.md
@@ -636,7 +636,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Update, Remove, and Clean Lifecycle](06-update-remove-and-clean-lifecycle.md)
 - [Next Chapter: Chapter 8: Team Operations and Governance](08-team-operations-and-governance.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/opensrc-tutorial/08-team-operations-and-governance.md b/tutorials/opensrc-tutorial/08-team-operations-and-governance.md
index 0e0f73ff..116806d7 100644
--- a/tutorials/opensrc-tutorial/08-team-operations-and-governance.md
+++ b/tutorials/opensrc-tutorial/08-team-operations-and-governance.md
@@ -635,7 +635,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Reliability, Rate Limits, and Version Fallbacks](07-reliability-rate-limits-and-version-fallbacks.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/opensrc-tutorial/index.md b/tutorials/opensrc-tutorial/README.md
similarity index 100%
rename from tutorials/opensrc-tutorial/index.md
rename to tutorials/opensrc-tutorial/README.md
diff --git a/tutorials/outlines-tutorial/01-getting-started.md b/tutorials/outlines-tutorial/01-getting-started.md
index a08933ee..124286e4 100644
--- a/tutorials/outlines-tutorial/01-getting-started.md
+++ b/tutorials/outlines-tutorial/01-getting-started.md
@@ -472,7 +472,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Text Patterns & Regular Expressions](02-text-patterns.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/outlines-tutorial/02-text-patterns.md b/tutorials/outlines-tutorial/02-text-patterns.md
index 8672bcee..10c297e0 100644
--- a/tutorials/outlines-tutorial/02-text-patterns.md
+++ b/tutorials/outlines-tutorial/02-text-patterns.md
@@ -594,7 +594,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started with Outlines](01-getting-started.md)
 - [Next Chapter: Chapter 3: JSON Schema & Structured Data Generation](03-json-schema.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/outlines-tutorial/03-json-schema.md b/tutorials/outlines-tutorial/03-json-schema.md
index 14ee736b..2a5ac457 100644
--- a/tutorials/outlines-tutorial/03-json-schema.md
+++ b/tutorials/outlines-tutorial/03-json-schema.md
@@ -676,7 +676,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Text Patterns & Regular Expressions](02-text-patterns.md)
 - [Next Chapter: Chapter 4: Type Safety & Pydantic Integration](04-type-safety.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/outlines-tutorial/04-type-safety.md b/tutorials/outlines-tutorial/04-type-safety.md
index 29d12701..5d6a3bc5 100644
--- a/tutorials/outlines-tutorial/04-type-safety.md
+++ b/tutorials/outlines-tutorial/04-type-safety.md
@@ -736,7 +736,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: JSON Schema & Structured Data Generation](03-json-schema.md)
 - [Next Chapter: Chapter 5: Grammar-Based Generation & Context-Free Grammars](05-grammar-based.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/outlines-tutorial/05-grammar-based.md b/tutorials/outlines-tutorial/05-grammar-based.md
index 2f934246..6431b6e0 100644
--- a/tutorials/outlines-tutorial/05-grammar-based.md
+++ b/tutorials/outlines-tutorial/05-grammar-based.md
@@ -706,7 +706,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Type Safety & Pydantic Integration](04-type-safety.md)
 - [Next Chapter: Chapter 6: Advanced Features & Performance Optimization](06-advanced-features.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/outlines-tutorial/06-advanced-features.md b/tutorials/outlines-tutorial/06-advanced-features.md
index d662a8b1..80d488c2 100644
--- a/tutorials/outlines-tutorial/06-advanced-features.md
+++ b/tutorials/outlines-tutorial/06-advanced-features.md
@@ -873,7 +873,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Grammar-Based Generation & Context-Free Grammars](05-grammar-based.md)
 - [Next Chapter: Chapter 7: Integration with AI Frameworks](07-integration.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/outlines-tutorial/07-integration.md b/tutorials/outlines-tutorial/07-integration.md
index d1342769..0a7248fb 100644
--- a/tutorials/outlines-tutorial/07-integration.md
+++ b/tutorials/outlines-tutorial/07-integration.md
@@ -898,7 +898,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Advanced Features & Performance Optimization](06-advanced-features.md)
 - [Next Chapter: Chapter 8: Production Deployment & Scaling](08-production.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/outlines-tutorial/08-production.md b/tutorials/outlines-tutorial/08-production.md
index f6740a92..56e5620b 100644
--- a/tutorials/outlines-tutorial/08-production.md
+++ b/tutorials/outlines-tutorial/08-production.md
@@ -1363,7 +1363,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Integration with AI Frameworks](07-integration.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/outlines-tutorial/index.md b/tutorials/outlines-tutorial/README.md
similarity index 100%
rename from tutorials/outlines-tutorial/index.md
rename to tutorials/outlines-tutorial/README.md
diff --git a/tutorials/perplexica-tutorial/01-getting-started.md b/tutorials/perplexica-tutorial/01-getting-started.md
index 2f441011..dfa07c74 100644
--- a/tutorials/perplexica-tutorial/01-getting-started.md
+++ b/tutorials/perplexica-tutorial/01-getting-started.md
@@ -174,7 +174,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Search Engine Architecture](02-search-architecture.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/perplexica-tutorial/02-search-architecture.md b/tutorials/perplexica-tutorial/02-search-architecture.md
index 13e1f7f5..80c5dbae 100644
--- a/tutorials/perplexica-tutorial/02-search-architecture.md
+++ b/tutorials/perplexica-tutorial/02-search-architecture.md
@@ -570,7 +570,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started with Perplexica](01-getting-started.md)
 - [Next Chapter: Chapter 3: AI Integration](03-ai-integration.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/perplexica-tutorial/03-ai-integration.md b/tutorials/perplexica-tutorial/03-ai-integration.md
index 18b1b9bb..dba023d2 100644
--- a/tutorials/perplexica-tutorial/03-ai-integration.md
+++ b/tutorials/perplexica-tutorial/03-ai-integration.md
@@ -549,7 +549,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Search Engine Architecture](02-search-architecture.md)
 - [Next Chapter: Chapter 4: Web Scraping and Data Collection](04-web-scraping.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/perplexica-tutorial/04-web-scraping.md b/tutorials/perplexica-tutorial/04-web-scraping.md
index 52b4b47f..5fe31f37 100644
--- a/tutorials/perplexica-tutorial/04-web-scraping.md
+++ b/tutorials/perplexica-tutorial/04-web-scraping.md
@@ -655,7 +655,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: AI Integration](03-ai-integration.md)
 - [Next Chapter: Chapter 5: Result Processing and Ranking](05-result-processing.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/perplexica-tutorial/05-result-processing.md b/tutorials/perplexica-tutorial/05-result-processing.md
index 57d1b4ed..c357c31b 100644
--- a/tutorials/perplexica-tutorial/05-result-processing.md
+++ b/tutorials/perplexica-tutorial/05-result-processing.md
@@ -656,7 +656,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Web Scraping and Data Collection](04-web-scraping.md)
 - [Next Chapter: Chapter 6: User Interface Development](06-user-interface.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/perplexica-tutorial/06-user-interface.md b/tutorials/perplexica-tutorial/06-user-interface.md
index a1c95a90..4d128519 100644
--- a/tutorials/perplexica-tutorial/06-user-interface.md
+++ b/tutorials/perplexica-tutorial/06-user-interface.md
@@ -747,7 +747,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Result Processing and Ranking](05-result-processing.md)
 - [Next Chapter: Chapter 7: Advanced Features](07-advanced-features.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/perplexica-tutorial/07-advanced-features.md b/tutorials/perplexica-tutorial/07-advanced-features.md
index fe851ccb..bea11bd2 100644
--- a/tutorials/perplexica-tutorial/07-advanced-features.md
+++ b/tutorials/perplexica-tutorial/07-advanced-features.md
@@ -765,7 +765,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: User Interface Development](06-user-interface.md)
 - [Next Chapter: Chapter 8: Production Deployment](08-production-deployment.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/perplexica-tutorial/08-production-deployment.md b/tutorials/perplexica-tutorial/08-production-deployment.md
index 0ab2e9e9..a9d1a590 100644
--- a/tutorials/perplexica-tutorial/08-production-deployment.md
+++ b/tutorials/perplexica-tutorial/08-production-deployment.md
@@ -720,7 +720,7 @@ Deploying Perplexica in production is a matter of wrapping the Docker containers
 
 You have completed the Perplexica tutorial. You now have the knowledge to install, configure, extend, and deploy an AI-powered search engine. Whether you are building a personal research assistant, a team knowledge tool, or a customer-facing search product, Perplexica's open-source architecture gives you full control over every layer of the stack.
 
-**Go back to the [Tutorial Index](index.md) to review any chapter.**
+**Go back to the [Tutorial Index](README.md) to review any chapter.**
 
 ---
 
@@ -766,7 +766,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Advanced Features](07-advanced-features.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/perplexica-tutorial/index.md b/tutorials/perplexica-tutorial/README.md
similarity index 100%
rename from tutorials/perplexica-tutorial/index.md
rename to tutorials/perplexica-tutorial/README.md
diff --git a/tutorials/phidata-tutorial/01-getting-started.md b/tutorials/phidata-tutorial/01-getting-started.md
index a344d919..39baab37 100644
--- a/tutorials/phidata-tutorial/01-getting-started.md
+++ b/tutorials/phidata-tutorial/01-getting-started.md
@@ -544,7 +544,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Understanding Phidata Agent Architecture](02-agent-architecture.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/phidata-tutorial/02-agent-architecture.md b/tutorials/phidata-tutorial/02-agent-architecture.md
index 7e94c3a5..0e2a2fd8 100644
--- a/tutorials/phidata-tutorial/02-agent-architecture.md
+++ b/tutorials/phidata-tutorial/02-agent-architecture.md
@@ -914,7 +914,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started with Phidata Agents](01-getting-started.md)
 - [Next Chapter: Chapter 3: Tools & Functions - Extending Agent Capabilities](03-tools-functions.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/phidata-tutorial/03-tools-functions.md b/tutorials/phidata-tutorial/03-tools-functions.md
index 6baad8ba..0eb8a87b 100644
--- a/tutorials/phidata-tutorial/03-tools-functions.md
+++ b/tutorials/phidata-tutorial/03-tools-functions.md
@@ -866,7 +866,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Understanding Phidata Agent Architecture](02-agent-architecture.md)
 - [Next Chapter: Chapter 4: Memory Systems - Building Context-Aware Agents](04-memory-systems.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/phidata-tutorial/04-memory-systems.md b/tutorials/phidata-tutorial/04-memory-systems.md
index bfd4abad..e3b33f4e 100644
--- a/tutorials/phidata-tutorial/04-memory-systems.md
+++ b/tutorials/phidata-tutorial/04-memory-systems.md
@@ -935,7 +935,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Tools & Functions - Extending Agent Capabilities](03-tools-functions.md)
 - [Next Chapter: Chapter 5: Multi-Agent Systems - Coordinating Teams of AI Agents](05-multi-agent-systems.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/phidata-tutorial/05-multi-agent-systems.md b/tutorials/phidata-tutorial/05-multi-agent-systems.md
index aed05573..16b88dc9 100644
--- a/tutorials/phidata-tutorial/05-multi-agent-systems.md
+++ b/tutorials/phidata-tutorial/05-multi-agent-systems.md
@@ -894,7 +894,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Memory Systems - Building Context-Aware Agents](04-memory-systems.md)
 - [Next Chapter: Chapter 6: Advanced Reasoning - Complex Decision Making and Problem Solving](06-advanced-reasoning.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/phidata-tutorial/06-advanced-reasoning.md b/tutorials/phidata-tutorial/06-advanced-reasoning.md
index 567302e9..269d45f3 100644
--- a/tutorials/phidata-tutorial/06-advanced-reasoning.md
+++ b/tutorials/phidata-tutorial/06-advanced-reasoning.md
@@ -1048,7 +1048,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Multi-Agent Systems - Coordinating Teams of AI Agents](05-multi-agent-systems.md)
 - [Next Chapter: Chapter 7: Integrations - Connecting Phidata Agents to External Systems](07-integrations.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/phidata-tutorial/07-integrations.md b/tutorials/phidata-tutorial/07-integrations.md
index 005491da..f237959c 100644
--- a/tutorials/phidata-tutorial/07-integrations.md
+++ b/tutorials/phidata-tutorial/07-integrations.md
@@ -1079,7 +1079,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Advanced Reasoning - Complex Decision Making and Problem Solving](06-advanced-reasoning.md)
 - [Next Chapter: Chapter 8: Production Deployment & Scaling Phidata Agents](08-production-deployment.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/phidata-tutorial/08-production-deployment.md b/tutorials/phidata-tutorial/08-production-deployment.md
index ac67d1f8..70c15ffd 100644
--- a/tutorials/phidata-tutorial/08-production-deployment.md
+++ b/tutorials/phidata-tutorial/08-production-deployment.md
@@ -1759,7 +1759,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Integrations - Connecting Phidata Agents to External Systems](07-integrations.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/phidata-tutorial/index.md b/tutorials/phidata-tutorial/README.md
similarity index 100%
rename from tutorials/phidata-tutorial/index.md
rename to tutorials/phidata-tutorial/README.md
diff --git a/tutorials/photoprism-tutorial/01-getting-started.md b/tutorials/photoprism-tutorial/01-getting-started.md
index beaac0e0..eb236d9f 100644
--- a/tutorials/photoprism-tutorial/01-getting-started.md
+++ b/tutorials/photoprism-tutorial/01-getting-started.md
@@ -430,7 +430,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: AI Features & Configuration](02-ai-features-configuration.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/photoprism-tutorial/02-ai-features-configuration.md b/tutorials/photoprism-tutorial/02-ai-features-configuration.md
index 60484301..83a791ba 100644
--- a/tutorials/photoprism-tutorial/02-ai-features-configuration.md
+++ b/tutorials/photoprism-tutorial/02-ai-features-configuration.md
@@ -294,7 +294,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started with PhotoPrism](01-getting-started.md)
 - [Next Chapter: Chapter 3: Photo Management](03-photo-management.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/photoprism-tutorial/03-photo-management.md b/tutorials/photoprism-tutorial/03-photo-management.md
index d48ff199..c4d2eb66 100644
--- a/tutorials/photoprism-tutorial/03-photo-management.md
+++ b/tutorials/photoprism-tutorial/03-photo-management.md
@@ -309,7 +309,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: AI Features & Configuration](02-ai-features-configuration.md)
 - [Next Chapter: Chapter 4: Search & Discovery](04-search-discovery.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/photoprism-tutorial/04-search-discovery.md b/tutorials/photoprism-tutorial/04-search-discovery.md
index 8f735edc..ce99246a 100644
--- a/tutorials/photoprism-tutorial/04-search-discovery.md
+++ b/tutorials/photoprism-tutorial/04-search-discovery.md
@@ -343,7 +343,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Photo Management](03-photo-management.md)
 - [Next Chapter: Chapter 5: Facial Recognition](05-facial-recognition.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/photoprism-tutorial/05-facial-recognition.md b/tutorials/photoprism-tutorial/05-facial-recognition.md
index 26d339ae..2d21760c 100644
--- a/tutorials/photoprism-tutorial/05-facial-recognition.md
+++ b/tutorials/photoprism-tutorial/05-facial-recognition.md
@@ -356,7 +356,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Search & Discovery](04-search-discovery.md)
 - [Next Chapter: Chapter 6: API Integration](06-api-integration.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/photoprism-tutorial/06-api-integration.md b/tutorials/photoprism-tutorial/06-api-integration.md
index c70e2f07..0be3350f 100644
--- a/tutorials/photoprism-tutorial/06-api-integration.md
+++ b/tutorials/photoprism-tutorial/06-api-integration.md
@@ -472,7 +472,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Facial Recognition](05-facial-recognition.md)
 - [Next Chapter: Chapter 7: Backup & Migration](07-backup-migration.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/photoprism-tutorial/07-backup-migration.md b/tutorials/photoprism-tutorial/07-backup-migration.md
index f5c7c2a0..7792fa24 100644
--- a/tutorials/photoprism-tutorial/07-backup-migration.md
+++ b/tutorials/photoprism-tutorial/07-backup-migration.md
@@ -494,7 +494,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: API Integration](06-api-integration.md)
 - [Next Chapter: Chapter 8: Production Deployment](08-production-deployment.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/photoprism-tutorial/08-production-deployment.md b/tutorials/photoprism-tutorial/08-production-deployment.md
index fdb75902..3c538907 100644
--- a/tutorials/photoprism-tutorial/08-production-deployment.md
+++ b/tutorials/photoprism-tutorial/08-production-deployment.md
@@ -694,7 +694,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Backup & Migration](07-backup-migration.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/photoprism-tutorial/index.md b/tutorials/photoprism-tutorial/README.md
similarity index 100%
rename from tutorials/photoprism-tutorial/index.md
rename to tutorials/photoprism-tutorial/README.md
diff --git a/tutorials/plandex-tutorial/01-getting-started.md b/tutorials/plandex-tutorial/01-getting-started.md
index 89e1bb96..ee066a31 100644
--- a/tutorials/plandex-tutorial/01-getting-started.md
+++ b/tutorials/plandex-tutorial/01-getting-started.md
@@ -637,7 +637,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Architecture and Workflow](02-architecture-and-workflow.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/plandex-tutorial/02-architecture-and-workflow.md b/tutorials/plandex-tutorial/02-architecture-and-workflow.md
index 358ff9ea..dbc43ede 100644
--- a/tutorials/plandex-tutorial/02-architecture-and-workflow.md
+++ b/tutorials/plandex-tutorial/02-architecture-and-workflow.md
@@ -635,7 +635,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started](01-getting-started.md)
 - [Next Chapter: Chapter 3: Context Management at Scale](03-context-management-at-scale.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/plandex-tutorial/03-context-management-at-scale.md b/tutorials/plandex-tutorial/03-context-management-at-scale.md
index 3f9222c4..7334fab3 100644
--- a/tutorials/plandex-tutorial/03-context-management-at-scale.md
+++ b/tutorials/plandex-tutorial/03-context-management-at-scale.md
@@ -624,7 +624,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Architecture and Workflow](02-architecture-and-workflow.md)
 - [Next Chapter: Chapter 4: Planning, Execution, and Diff Sandbox](04-planning-execution-and-diff-sandbox.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/plandex-tutorial/04-planning-execution-and-diff-sandbox.md b/tutorials/plandex-tutorial/04-planning-execution-and-diff-sandbox.md
index c0c51835..db2f25a5 100644
--- a/tutorials/plandex-tutorial/04-planning-execution-and-diff-sandbox.md
+++ b/tutorials/plandex-tutorial/04-planning-execution-and-diff-sandbox.md
@@ -635,7 +635,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Context Management at Scale](03-context-management-at-scale.md)
 - [Next Chapter: Chapter 5: Model Packs and Provider Strategy](05-model-packs-and-provider-strategy.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/plandex-tutorial/05-model-packs-and-provider-strategy.md b/tutorials/plandex-tutorial/05-model-packs-and-provider-strategy.md
index 8a1e0f3a..9a93e1ca 100644
--- a/tutorials/plandex-tutorial/05-model-packs-and-provider-strategy.md
+++ b/tutorials/plandex-tutorial/05-model-packs-and-provider-strategy.md
@@ -634,7 +634,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Planning, Execution, and Diff Sandbox](04-planning-execution-and-diff-sandbox.md)
 - [Next Chapter: Chapter 6: Autonomy, Control, and Debugging](06-autonomy-control-and-debugging.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/plandex-tutorial/06-autonomy-control-and-debugging.md b/tutorials/plandex-tutorial/06-autonomy-control-and-debugging.md
index 0465ef19..cf2ca176 100644
--- a/tutorials/plandex-tutorial/06-autonomy-control-and-debugging.md
+++ b/tutorials/plandex-tutorial/06-autonomy-control-and-debugging.md
@@ -635,7 +635,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Model Packs and Provider Strategy](05-model-packs-and-provider-strategy.md)
 - [Next Chapter: Chapter 7: Git, Branching, and Review Workflows](07-git-branching-and-review-workflows.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/plandex-tutorial/07-git-branching-and-review-workflows.md b/tutorials/plandex-tutorial/07-git-branching-and-review-workflows.md
index c52ca243..f17e9807 100644
--- a/tutorials/plandex-tutorial/07-git-branching-and-review-workflows.md
+++ b/tutorials/plandex-tutorial/07-git-branching-and-review-workflows.md
@@ -635,7 +635,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Autonomy, Control, and Debugging](06-autonomy-control-and-debugging.md)
 - [Next Chapter: Chapter 8: Self-Hosting and Production Operations](08-self-hosting-and-production-operations.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/plandex-tutorial/08-self-hosting-and-production-operations.md b/tutorials/plandex-tutorial/08-self-hosting-and-production-operations.md
index 5dc4dd4e..3a9406ea 100644
--- a/tutorials/plandex-tutorial/08-self-hosting-and-production-operations.md
+++ b/tutorials/plandex-tutorial/08-self-hosting-and-production-operations.md
@@ -625,7 +625,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Git, Branching, and Review Workflows](07-git-branching-and-review-workflows.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/plandex-tutorial/index.md b/tutorials/plandex-tutorial/README.md
similarity index 100%
rename from tutorials/plandex-tutorial/index.md
rename to tutorials/plandex-tutorial/README.md
diff --git a/tutorials/planning-with-files-tutorial/01-getting-started.md b/tutorials/planning-with-files-tutorial/01-getting-started.md
index a1b68b15..e469513c 100644
--- a/tutorials/planning-with-files-tutorial/01-getting-started.md
+++ b/tutorials/planning-with-files-tutorial/01-getting-started.md
@@ -633,7 +633,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Core Philosophy and the 3-File Pattern](02-core-philosophy-and-the-3-file-pattern.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/planning-with-files-tutorial/02-core-philosophy-and-the-3-file-pattern.md b/tutorials/planning-with-files-tutorial/02-core-philosophy-and-the-3-file-pattern.md
index a7a525eb..579ab8ad 100644
--- a/tutorials/planning-with-files-tutorial/02-core-philosophy-and-the-3-file-pattern.md
+++ b/tutorials/planning-with-files-tutorial/02-core-philosophy-and-the-3-file-pattern.md
@@ -630,7 +630,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started](01-getting-started.md)
 - [Next Chapter: Chapter 3: Installation Paths Across IDEs and Agents](03-installation-paths-across-ides-and-agents.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/planning-with-files-tutorial/03-installation-paths-across-ides-and-agents.md b/tutorials/planning-with-files-tutorial/03-installation-paths-across-ides-and-agents.md
index 962a5946..0b3da356 100644
--- a/tutorials/planning-with-files-tutorial/03-installation-paths-across-ides-and-agents.md
+++ b/tutorials/planning-with-files-tutorial/03-installation-paths-across-ides-and-agents.md
@@ -631,7 +631,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Core Philosophy and the 3-File Pattern](02-core-philosophy-and-the-3-file-pattern.md)
 - [Next Chapter: Chapter 4: Commands, Hooks, and Workflow Orchestration](04-commands-hooks-and-workflow-orchestration.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/planning-with-files-tutorial/04-commands-hooks-and-workflow-orchestration.md b/tutorials/planning-with-files-tutorial/04-commands-hooks-and-workflow-orchestration.md
index 31ba8efa..acd242d8 100644
--- a/tutorials/planning-with-files-tutorial/04-commands-hooks-and-workflow-orchestration.md
+++ b/tutorials/planning-with-files-tutorial/04-commands-hooks-and-workflow-orchestration.md
@@ -632,7 +632,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Installation Paths Across IDEs and Agents](03-installation-paths-across-ides-and-agents.md)
 - [Next Chapter: Chapter 5: Templates, Scripts, and Session Recovery](05-templates-scripts-and-session-recovery.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/planning-with-files-tutorial/05-templates-scripts-and-session-recovery.md b/tutorials/planning-with-files-tutorial/05-templates-scripts-and-session-recovery.md
index b57dc84e..f6f8ff84 100644
--- a/tutorials/planning-with-files-tutorial/05-templates-scripts-and-session-recovery.md
+++ b/tutorials/planning-with-files-tutorial/05-templates-scripts-and-session-recovery.md
@@ -630,7 +630,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Commands, Hooks, and Workflow Orchestration](04-commands-hooks-and-workflow-orchestration.md)
 - [Next Chapter: Chapter 6: Multi-IDE Adaptation (Codex, Gemini, OpenCode, Cursor)](06-multi-ide-adaptation-codex-gemini-opencode-cursor.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/planning-with-files-tutorial/06-multi-ide-adaptation-codex-gemini-opencode-cursor.md b/tutorials/planning-with-files-tutorial/06-multi-ide-adaptation-codex-gemini-opencode-cursor.md
index 61276a1e..6de2d5d6 100644
--- a/tutorials/planning-with-files-tutorial/06-multi-ide-adaptation-codex-gemini-opencode-cursor.md
+++ b/tutorials/planning-with-files-tutorial/06-multi-ide-adaptation-codex-gemini-opencode-cursor.md
@@ -627,7 +627,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Templates, Scripts, and Session Recovery](05-templates-scripts-and-session-recovery.md)
 - [Next Chapter: Chapter 7: Troubleshooting, Anti-Patterns, and Safety Checks](07-troubleshooting-anti-patterns-and-safety-checks.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/planning-with-files-tutorial/07-troubleshooting-anti-patterns-and-safety-checks.md b/tutorials/planning-with-files-tutorial/07-troubleshooting-anti-patterns-and-safety-checks.md
index af9e2f47..6c974250 100644
--- a/tutorials/planning-with-files-tutorial/07-troubleshooting-anti-patterns-and-safety-checks.md
+++ b/tutorials/planning-with-files-tutorial/07-troubleshooting-anti-patterns-and-safety-checks.md
@@ -633,7 +633,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Multi-IDE Adaptation (Codex, Gemini, OpenCode, Cursor)](06-multi-ide-adaptation-codex-gemini-opencode-cursor.md)
 - [Next Chapter: Chapter 8: Contribution Workflow and Team Adoption](08-contribution-workflow-and-team-adoption.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/planning-with-files-tutorial/08-contribution-workflow-and-team-adoption.md b/tutorials/planning-with-files-tutorial/08-contribution-workflow-and-team-adoption.md
index e65d166a..20e27b93 100644
--- a/tutorials/planning-with-files-tutorial/08-contribution-workflow-and-team-adoption.md
+++ b/tutorials/planning-with-files-tutorial/08-contribution-workflow-and-team-adoption.md
@@ -637,7 +637,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Troubleshooting, Anti-Patterns, and Safety Checks](07-troubleshooting-anti-patterns-and-safety-checks.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/planning-with-files-tutorial/index.md b/tutorials/planning-with-files-tutorial/README.md
similarity index 100%
rename from tutorials/planning-with-files-tutorial/index.md
rename to tutorials/planning-with-files-tutorial/README.md
diff --git a/tutorials/playwright-mcp-tutorial/01-getting-started.md b/tutorials/playwright-mcp-tutorial/01-getting-started.md
index 25764613..658fe988 100644
--- a/tutorials/playwright-mcp-tutorial/01-getting-started.md
+++ b/tutorials/playwright-mcp-tutorial/01-getting-started.md
@@ -630,7 +630,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Operating Model: Accessibility Snapshots](02-operating-model-accessibility-snapshots.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/playwright-mcp-tutorial/02-operating-model-accessibility-snapshots.md b/tutorials/playwright-mcp-tutorial/02-operating-model-accessibility-snapshots.md
index 15bb5842..a053e267 100644
--- a/tutorials/playwright-mcp-tutorial/02-operating-model-accessibility-snapshots.md
+++ b/tutorials/playwright-mcp-tutorial/02-operating-model-accessibility-snapshots.md
@@ -631,7 +631,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started](01-getting-started.md)
 - [Next Chapter: Chapter 3: Installation Across Host Clients](03-installation-across-host-clients.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/playwright-mcp-tutorial/03-installation-across-host-clients.md b/tutorials/playwright-mcp-tutorial/03-installation-across-host-clients.md
index 9c76f72c..ec46fd9a 100644
--- a/tutorials/playwright-mcp-tutorial/03-installation-across-host-clients.md
+++ b/tutorials/playwright-mcp-tutorial/03-installation-across-host-clients.md
@@ -629,7 +629,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Operating Model: Accessibility Snapshots](02-operating-model-accessibility-snapshots.md)
 - [Next Chapter: Chapter 4: Configuration, Capabilities, and Runtime Modes](04-configuration-capabilities-and-runtime-modes.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/playwright-mcp-tutorial/04-configuration-capabilities-and-runtime-modes.md b/tutorials/playwright-mcp-tutorial/04-configuration-capabilities-and-runtime-modes.md
index e619eedd..88b57a7e 100644
--- a/tutorials/playwright-mcp-tutorial/04-configuration-capabilities-and-runtime-modes.md
+++ b/tutorials/playwright-mcp-tutorial/04-configuration-capabilities-and-runtime-modes.md
@@ -628,7 +628,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Installation Across Host Clients](03-installation-across-host-clients.md)
 - [Next Chapter: Chapter 5: Profile State, Extension, and Auth Sessions](05-profile-state-extension-and-auth-sessions.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/playwright-mcp-tutorial/05-profile-state-extension-and-auth-sessions.md b/tutorials/playwright-mcp-tutorial/05-profile-state-extension-and-auth-sessions.md
index 8d34dcc7..e0362fd8 100644
--- a/tutorials/playwright-mcp-tutorial/05-profile-state-extension-and-auth-sessions.md
+++ b/tutorials/playwright-mcp-tutorial/05-profile-state-extension-and-auth-sessions.md
@@ -628,7 +628,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Configuration, Capabilities, and Runtime Modes](04-configuration-capabilities-and-runtime-modes.md)
 - [Next Chapter: Chapter 6: Standalone and Docker Deployment](06-standalone-and-docker-deployment.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/playwright-mcp-tutorial/06-standalone-and-docker-deployment.md b/tutorials/playwright-mcp-tutorial/06-standalone-and-docker-deployment.md
index 80389751..097eee60 100644
--- a/tutorials/playwright-mcp-tutorial/06-standalone-and-docker-deployment.md
+++ b/tutorials/playwright-mcp-tutorial/06-standalone-and-docker-deployment.md
@@ -628,7 +628,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Profile State, Extension, and Auth Sessions](05-profile-state-extension-and-auth-sessions.md)
 - [Next Chapter: Chapter 7: Tooling Surface and Automation Patterns](07-tooling-surface-and-automation-patterns.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/playwright-mcp-tutorial/07-tooling-surface-and-automation-patterns.md b/tutorials/playwright-mcp-tutorial/07-tooling-surface-and-automation-patterns.md
index e6655f64..940f3a22 100644
--- a/tutorials/playwright-mcp-tutorial/07-tooling-surface-and-automation-patterns.md
+++ b/tutorials/playwright-mcp-tutorial/07-tooling-surface-and-automation-patterns.md
@@ -628,7 +628,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Standalone and Docker Deployment](06-standalone-and-docker-deployment.md)
 - [Next Chapter: Chapter 8: Troubleshooting, Security, and Contribution](08-troubleshooting-security-and-contribution.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/playwright-mcp-tutorial/08-troubleshooting-security-and-contribution.md b/tutorials/playwright-mcp-tutorial/08-troubleshooting-security-and-contribution.md
index dd572246..76b2d081 100644
--- a/tutorials/playwright-mcp-tutorial/08-troubleshooting-security-and-contribution.md
+++ b/tutorials/playwright-mcp-tutorial/08-troubleshooting-security-and-contribution.md
@@ -632,7 +632,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Tooling Surface and Automation Patterns](07-tooling-surface-and-automation-patterns.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/playwright-mcp-tutorial/index.md b/tutorials/playwright-mcp-tutorial/README.md
similarity index 100%
rename from tutorials/playwright-mcp-tutorial/index.md
rename to tutorials/playwright-mcp-tutorial/README.md
diff --git a/tutorials/pocketflow-tutorial/01-getting-started.md b/tutorials/pocketflow-tutorial/01-getting-started.md
index db270cc3..8d488118 100644
--- a/tutorials/pocketflow-tutorial/01-getting-started.md
+++ b/tutorials/pocketflow-tutorial/01-getting-started.md
@@ -635,7 +635,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Core Graph Abstraction](02-core-graph-abstraction.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/pocketflow-tutorial/02-core-graph-abstraction.md b/tutorials/pocketflow-tutorial/02-core-graph-abstraction.md
index 44da3950..996e3391 100644
--- a/tutorials/pocketflow-tutorial/02-core-graph-abstraction.md
+++ b/tutorials/pocketflow-tutorial/02-core-graph-abstraction.md
@@ -631,7 +631,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started](01-getting-started.md)
 - [Next Chapter: Chapter 3: Agent and Workflow Patterns](03-agent-and-workflow-patterns.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/pocketflow-tutorial/03-agent-and-workflow-patterns.md b/tutorials/pocketflow-tutorial/03-agent-and-workflow-patterns.md
index 860af01b..a6f409c3 100644
--- a/tutorials/pocketflow-tutorial/03-agent-and-workflow-patterns.md
+++ b/tutorials/pocketflow-tutorial/03-agent-and-workflow-patterns.md
@@ -633,7 +633,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Core Graph Abstraction](02-core-graph-abstraction.md)
 - [Next Chapter: Chapter 4: RAG and Knowledge Patterns](04-rag-and-knowledge-patterns.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/pocketflow-tutorial/04-rag-and-knowledge-patterns.md b/tutorials/pocketflow-tutorial/04-rag-and-knowledge-patterns.md
index 0a0e8c8c..34835b1f 100644
--- a/tutorials/pocketflow-tutorial/04-rag-and-knowledge-patterns.md
+++ b/tutorials/pocketflow-tutorial/04-rag-and-knowledge-patterns.md
@@ -632,7 +632,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Agent and Workflow Patterns](03-agent-and-workflow-patterns.md)
 - [Next Chapter: Chapter 5: Multi-Agent and Supervision](05-multi-agent-and-supervision.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/pocketflow-tutorial/05-multi-agent-and-supervision.md b/tutorials/pocketflow-tutorial/05-multi-agent-and-supervision.md
index f0b81c9e..2756fc47 100644
--- a/tutorials/pocketflow-tutorial/05-multi-agent-and-supervision.md
+++ b/tutorials/pocketflow-tutorial/05-multi-agent-and-supervision.md
@@ -631,7 +631,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: RAG and Knowledge Patterns](04-rag-and-knowledge-patterns.md)
 - [Next Chapter: Chapter 6: Streaming, HITL, and Interrupts](06-streaming-hitl-and-interrupts.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/pocketflow-tutorial/06-streaming-hitl-and-interrupts.md b/tutorials/pocketflow-tutorial/06-streaming-hitl-and-interrupts.md
index d34d3057..4215ba90 100644
--- a/tutorials/pocketflow-tutorial/06-streaming-hitl-and-interrupts.md
+++ b/tutorials/pocketflow-tutorial/06-streaming-hitl-and-interrupts.md
@@ -633,7 +633,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Multi-Agent and Supervision](05-multi-agent-and-supervision.md)
 - [Next Chapter: Chapter 7: Multi-Language Ecosystem](07-multi-language-ecosystem.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/pocketflow-tutorial/07-multi-language-ecosystem.md b/tutorials/pocketflow-tutorial/07-multi-language-ecosystem.md
index 21c125f7..ef45b6e0 100644
--- a/tutorials/pocketflow-tutorial/07-multi-language-ecosystem.md
+++ b/tutorials/pocketflow-tutorial/07-multi-language-ecosystem.md
@@ -631,7 +631,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Streaming, HITL, and Interrupts](06-streaming-hitl-and-interrupts.md)
 - [Next Chapter: Chapter 8: Production Usage and Scaling](08-production-usage-and-scaling.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/pocketflow-tutorial/08-production-usage-and-scaling.md b/tutorials/pocketflow-tutorial/08-production-usage-and-scaling.md
index 5544cbb5..d4863998 100644
--- a/tutorials/pocketflow-tutorial/08-production-usage-and-scaling.md
+++ b/tutorials/pocketflow-tutorial/08-production-usage-and-scaling.md
@@ -630,7 +630,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Multi-Language Ecosystem](07-multi-language-ecosystem.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/pocketflow-tutorial/index.md b/tutorials/pocketflow-tutorial/README.md
similarity index 100%
rename from tutorials/pocketflow-tutorial/index.md
rename to tutorials/pocketflow-tutorial/README.md
diff --git a/tutorials/postgresql-query-planner/01-fundamentals.md b/tutorials/postgresql-query-planner/01-fundamentals.md
index 8edc6335..34049edf 100644
--- a/tutorials/postgresql-query-planner/01-fundamentals.md
+++ b/tutorials/postgresql-query-planner/01-fundamentals.md
@@ -431,7 +431,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Statistics and Cost Estimation](02-statistics.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/postgresql-query-planner/02-statistics.md b/tutorials/postgresql-query-planner/02-statistics.md
index 525b6502..3e5bddcf 100644
--- a/tutorials/postgresql-query-planner/02-statistics.md
+++ b/tutorials/postgresql-query-planner/02-statistics.md
@@ -472,7 +472,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Query Planning Fundamentals](01-fundamentals.md)
 - [Next Chapter: Chapter 3: Scan Operations](03-scan-operations.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/postgresql-query-planner/03-scan-operations.md b/tutorials/postgresql-query-planner/03-scan-operations.md
index 8adde060..d09fc813 100644
--- a/tutorials/postgresql-query-planner/03-scan-operations.md
+++ b/tutorials/postgresql-query-planner/03-scan-operations.md
@@ -448,7 +448,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Statistics and Cost Estimation](02-statistics.md)
 - [Next Chapter: Chapter 4: Join Strategies](04-join-strategies.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/postgresql-query-planner/04-join-strategies.md b/tutorials/postgresql-query-planner/04-join-strategies.md
index 45ce5eb8..2f8e6bc3 100644
--- a/tutorials/postgresql-query-planner/04-join-strategies.md
+++ b/tutorials/postgresql-query-planner/04-join-strategies.md
@@ -506,7 +506,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Scan Operations](03-scan-operations.md)
 - [Next Chapter: Chapter 5: Index Deep Dive](05-index-strategies.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/postgresql-query-planner/05-index-strategies.md b/tutorials/postgresql-query-planner/05-index-strategies.md
index ee7039fe..99d0e215 100644
--- a/tutorials/postgresql-query-planner/05-index-strategies.md
+++ b/tutorials/postgresql-query-planner/05-index-strategies.md
@@ -455,7 +455,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Join Strategies](04-join-strategies.md)
 - [Next Chapter: Chapter 6: Advanced Optimization](06-advanced-optimization.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/postgresql-query-planner/06-advanced-optimization.md b/tutorials/postgresql-query-planner/06-advanced-optimization.md
index 16c8e37e..82f18c0f 100644
--- a/tutorials/postgresql-query-planner/06-advanced-optimization.md
+++ b/tutorials/postgresql-query-planner/06-advanced-optimization.md
@@ -465,7 +465,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Index Deep Dive](05-index-strategies.md)
 - [Next Chapter: Chapter 7: Performance Tuning](07-performance-tuning.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/postgresql-query-planner/07-performance-tuning.md b/tutorials/postgresql-query-planner/07-performance-tuning.md
index 5f5d5f77..b0fa8162 100644
--- a/tutorials/postgresql-query-planner/07-performance-tuning.md
+++ b/tutorials/postgresql-query-planner/07-performance-tuning.md
@@ -477,7 +477,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Advanced Optimization](06-advanced-optimization.md)
 - [Next Chapter: Chapter 8: Real-World Patterns](08-real-world-patterns.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/postgresql-query-planner/08-real-world-patterns.md b/tutorials/postgresql-query-planner/08-real-world-patterns.md
index 753ad397..ade934f0 100644
--- a/tutorials/postgresql-query-planner/08-real-world-patterns.md
+++ b/tutorials/postgresql-query-planner/08-real-world-patterns.md
@@ -507,7 +507,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Performance Tuning](07-performance-tuning.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/postgresql-query-planner/index.md b/tutorials/postgresql-query-planner/README.md
similarity index 100%
rename from tutorials/postgresql-query-planner/index.md
rename to tutorials/postgresql-query-planner/README.md
diff --git a/tutorials/posthog-tutorial/01-getting-started.md b/tutorials/posthog-tutorial/01-getting-started.md
index 4b594ca1..e5b4a1b6 100644
--- a/tutorials/posthog-tutorial/01-getting-started.md
+++ b/tutorials/posthog-tutorial/01-getting-started.md
@@ -432,7 +432,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Event Tracking & Properties](02-event-tracking.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/posthog-tutorial/02-event-tracking.md b/tutorials/posthog-tutorial/02-event-tracking.md
index 8e683f2c..c8d8f591 100644
--- a/tutorials/posthog-tutorial/02-event-tracking.md
+++ b/tutorials/posthog-tutorial/02-event-tracking.md
@@ -656,7 +656,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started with PostHog](01-getting-started.md)
 - [Next Chapter: Chapter 3: User Analytics & Funnels](03-user-analytics.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/posthog-tutorial/03-user-analytics.md b/tutorials/posthog-tutorial/03-user-analytics.md
index b0d6a590..d179465d 100644
--- a/tutorials/posthog-tutorial/03-user-analytics.md
+++ b/tutorials/posthog-tutorial/03-user-analytics.md
@@ -572,7 +572,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Event Tracking & Properties](02-event-tracking.md)
 - [Next Chapter: Chapter 4: Session Recordings](04-session-recordings.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/posthog-tutorial/04-session-recordings.md b/tutorials/posthog-tutorial/04-session-recordings.md
index 6f9ca6d9..859dcebe 100644
--- a/tutorials/posthog-tutorial/04-session-recordings.md
+++ b/tutorials/posthog-tutorial/04-session-recordings.md
@@ -576,7 +576,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: User Analytics & Funnels](03-user-analytics.md)
 - [Next Chapter: Chapter 5: Feature Flags & Experiments](05-feature-flags.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/posthog-tutorial/05-feature-flags.md b/tutorials/posthog-tutorial/05-feature-flags.md
index f0e5c859..514b9cb8 100644
--- a/tutorials/posthog-tutorial/05-feature-flags.md
+++ b/tutorials/posthog-tutorial/05-feature-flags.md
@@ -716,7 +716,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Session Recordings](04-session-recordings.md)
 - [Next Chapter: Chapter 6: Dashboards & Insights](06-dashboards-insights.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/posthog-tutorial/06-dashboards-insights.md b/tutorials/posthog-tutorial/06-dashboards-insights.md
index eb98abcc..054078fd 100644
--- a/tutorials/posthog-tutorial/06-dashboards-insights.md
+++ b/tutorials/posthog-tutorial/06-dashboards-insights.md
@@ -690,7 +690,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Feature Flags & Experiments](05-feature-flags.md)
 - [Next Chapter: Chapter 7: Advanced Analytics](07-advanced-analytics.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/posthog-tutorial/07-advanced-analytics.md b/tutorials/posthog-tutorial/07-advanced-analytics.md
index 27a3663f..7062b6a5 100644
--- a/tutorials/posthog-tutorial/07-advanced-analytics.md
+++ b/tutorials/posthog-tutorial/07-advanced-analytics.md
@@ -808,7 +808,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Dashboards & Insights](06-dashboards-insights.md)
 - [Next Chapter: Chapter 8: Production Deployment](08-production-deployment.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/posthog-tutorial/08-production-deployment.md b/tutorials/posthog-tutorial/08-production-deployment.md
index 756a5374..73ecf2d5 100644
--- a/tutorials/posthog-tutorial/08-production-deployment.md
+++ b/tutorials/posthog-tutorial/08-production-deployment.md
@@ -997,7 +997,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Advanced Analytics](07-advanced-analytics.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/posthog-tutorial/index.md b/tutorials/posthog-tutorial/README.md
similarity index 100%
rename from tutorials/posthog-tutorial/index.md
rename to tutorials/posthog-tutorial/README.md
diff --git a/tutorials/pydantic-ai-tutorial/01-getting-started.md b/tutorials/pydantic-ai-tutorial/01-getting-started.md
index c029a0ae..bfbbb538 100644
--- a/tutorials/pydantic-ai-tutorial/01-getting-started.md
+++ b/tutorials/pydantic-ai-tutorial/01-getting-started.md
@@ -597,7 +597,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Advanced Model Configuration & Provider Setup](02-model-configuration.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/pydantic-ai-tutorial/02-model-configuration.md b/tutorials/pydantic-ai-tutorial/02-model-configuration.md
index 7d7f8d33..83a8d708 100644
--- a/tutorials/pydantic-ai-tutorial/02-model-configuration.md
+++ b/tutorials/pydantic-ai-tutorial/02-model-configuration.md
@@ -969,7 +969,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started with Pydantic AI](01-getting-started.md)
 - [Next Chapter: Chapter 3: Structured Outputs & Pydantic Models](03-structured-outputs.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/pydantic-ai-tutorial/03-structured-outputs.md b/tutorials/pydantic-ai-tutorial/03-structured-outputs.md
index fdec043f..d8d553da 100644
--- a/tutorials/pydantic-ai-tutorial/03-structured-outputs.md
+++ b/tutorials/pydantic-ai-tutorial/03-structured-outputs.md
@@ -747,7 +747,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Advanced Model Configuration & Provider Setup](02-model-configuration.md)
 - [Next Chapter: Chapter 4: Dependencies, Tools & External Integrations](04-dependencies-tools.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/pydantic-ai-tutorial/04-dependencies-tools.md b/tutorials/pydantic-ai-tutorial/04-dependencies-tools.md
index 91534867..962d6a80 100644
--- a/tutorials/pydantic-ai-tutorial/04-dependencies-tools.md
+++ b/tutorials/pydantic-ai-tutorial/04-dependencies-tools.md
@@ -1027,7 +1027,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Structured Outputs & Pydantic Models](03-structured-outputs.md)
 - [Next Chapter: Chapter 5: Streaming Responses & Async Operations](05-streaming-async.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/pydantic-ai-tutorial/05-streaming-async.md b/tutorials/pydantic-ai-tutorial/05-streaming-async.md
index 85be4ea6..1d4aa8ba 100644
--- a/tutorials/pydantic-ai-tutorial/05-streaming-async.md
+++ b/tutorials/pydantic-ai-tutorial/05-streaming-async.md
@@ -802,7 +802,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Dependencies, Tools & External Integrations](04-dependencies-tools.md)
 - [Next Chapter: Chapter 6: Error Handling, Retry Mechanisms & Recovery](06-error-handling.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/pydantic-ai-tutorial/06-error-handling.md b/tutorials/pydantic-ai-tutorial/06-error-handling.md
index bd650fb5..ce0336c5 100644
--- a/tutorials/pydantic-ai-tutorial/06-error-handling.md
+++ b/tutorials/pydantic-ai-tutorial/06-error-handling.md
@@ -1106,7 +1106,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Streaming Responses & Async Operations](05-streaming-async.md)
 - [Next Chapter: Chapter 7: Advanced Patterns & Multi-Step Workflows](07-advanced-patterns.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/pydantic-ai-tutorial/07-advanced-patterns.md b/tutorials/pydantic-ai-tutorial/07-advanced-patterns.md
index f374df56..bf51531b 100644
--- a/tutorials/pydantic-ai-tutorial/07-advanced-patterns.md
+++ b/tutorials/pydantic-ai-tutorial/07-advanced-patterns.md
@@ -1020,7 +1020,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Error Handling, Retry Mechanisms & Recovery](06-error-handling.md)
 - [Next Chapter: Chapter 8: Production Deployment & Scaling Pydantic AI Systems](08-production.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/pydantic-ai-tutorial/08-production.md b/tutorials/pydantic-ai-tutorial/08-production.md
index aa3fd50a..64501c0e 100644
--- a/tutorials/pydantic-ai-tutorial/08-production.md
+++ b/tutorials/pydantic-ai-tutorial/08-production.md
@@ -1592,7 +1592,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Advanced Patterns & Multi-Step Workflows](07-advanced-patterns.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/pydantic-ai-tutorial/index.md b/tutorials/pydantic-ai-tutorial/README.md
similarity index 100%
rename from tutorials/pydantic-ai-tutorial/index.md
rename to tutorials/pydantic-ai-tutorial/README.md
diff --git a/tutorials/quivr-tutorial/01-getting-started.md b/tutorials/quivr-tutorial/01-getting-started.md
index dac889d7..269a42c0 100644
--- a/tutorials/quivr-tutorial/01-getting-started.md
+++ b/tutorials/quivr-tutorial/01-getting-started.md
@@ -441,7 +441,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Document Processing](02-document-processing.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/quivr-tutorial/02-document-processing.md b/tutorials/quivr-tutorial/02-document-processing.md
index 672ae1c0..36787a16 100644
--- a/tutorials/quivr-tutorial/02-document-processing.md
+++ b/tutorials/quivr-tutorial/02-document-processing.md
@@ -672,7 +672,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started with Quivr](01-getting-started.md)
 - [Next Chapter: Chapter 3: Vector Embeddings](03-vector-embeddings.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/quivr-tutorial/03-vector-embeddings.md b/tutorials/quivr-tutorial/03-vector-embeddings.md
index 4c9761bb..08b1f3a2 100644
--- a/tutorials/quivr-tutorial/03-vector-embeddings.md
+++ b/tutorials/quivr-tutorial/03-vector-embeddings.md
@@ -662,7 +662,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Document Processing](02-document-processing.md)
 - [Next Chapter: Chapter 4: Query Processing](04-query-processing.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/quivr-tutorial/04-query-processing.md b/tutorials/quivr-tutorial/04-query-processing.md
index a823fb29..8f4b5a6f 100644
--- a/tutorials/quivr-tutorial/04-query-processing.md
+++ b/tutorials/quivr-tutorial/04-query-processing.md
@@ -646,7 +646,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Vector Embeddings](03-vector-embeddings.md)
 - [Next Chapter: Chapter 5: Knowledge Bases](05-knowledge-bases.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/quivr-tutorial/05-knowledge-bases.md b/tutorials/quivr-tutorial/05-knowledge-bases.md
index 49a70ee3..a866a6e2 100644
--- a/tutorials/quivr-tutorial/05-knowledge-bases.md
+++ b/tutorials/quivr-tutorial/05-knowledge-bases.md
@@ -631,7 +631,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Query Processing](04-query-processing.md)
 - [Next Chapter: Chapter 6: Integration APIs](06-integration-apis.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/quivr-tutorial/06-integration-apis.md b/tutorials/quivr-tutorial/06-integration-apis.md
index 3c1979f3..a5fbe4ed 100644
--- a/tutorials/quivr-tutorial/06-integration-apis.md
+++ b/tutorials/quivr-tutorial/06-integration-apis.md
@@ -800,7 +800,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Knowledge Bases](05-knowledge-bases.md)
 - [Next Chapter: Chapter 7: Customization](07-customization.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/quivr-tutorial/07-customization.md b/tutorials/quivr-tutorial/07-customization.md
index 2486ab4e..e1a5a683 100644
--- a/tutorials/quivr-tutorial/07-customization.md
+++ b/tutorials/quivr-tutorial/07-customization.md
@@ -1011,7 +1011,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Integration APIs](06-integration-apis.md)
 - [Next Chapter: Chapter 8: Production Deployment](08-production-deployment.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/quivr-tutorial/08-production-deployment.md b/tutorials/quivr-tutorial/08-production-deployment.md
index 03af241f..8b8d7cf5 100644
--- a/tutorials/quivr-tutorial/08-production-deployment.md
+++ b/tutorials/quivr-tutorial/08-production-deployment.md
@@ -1029,7 +1029,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Customization](07-customization.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/quivr-tutorial/index.md b/tutorials/quivr-tutorial/README.md
similarity index 100%
rename from tutorials/quivr-tutorial/index.md
rename to tutorials/quivr-tutorial/README.md
diff --git a/tutorials/qwen-agent-tutorial/01-getting-started.md b/tutorials/qwen-agent-tutorial/01-getting-started.md
index f8b9a5ce..7b281ac6 100644
--- a/tutorials/qwen-agent-tutorial/01-getting-started.md
+++ b/tutorials/qwen-agent-tutorial/01-getting-started.md
@@ -630,7 +630,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Framework Architecture and Core Modules](02-framework-architecture-and-core-modules.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/qwen-agent-tutorial/02-framework-architecture-and-core-modules.md b/tutorials/qwen-agent-tutorial/02-framework-architecture-and-core-modules.md
index 0a93930e..c87a9a02 100644
--- a/tutorials/qwen-agent-tutorial/02-framework-architecture-and-core-modules.md
+++ b/tutorials/qwen-agent-tutorial/02-framework-architecture-and-core-modules.md
@@ -627,7 +627,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started](01-getting-started.md)
 - [Next Chapter: Chapter 3: Model Service and Runtime Strategy](03-model-service-and-runtime-strategy.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/qwen-agent-tutorial/03-model-service-and-runtime-strategy.md b/tutorials/qwen-agent-tutorial/03-model-service-and-runtime-strategy.md
index 14ae712a..13c93201 100644
--- a/tutorials/qwen-agent-tutorial/03-model-service-and-runtime-strategy.md
+++ b/tutorials/qwen-agent-tutorial/03-model-service-and-runtime-strategy.md
@@ -626,7 +626,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Framework Architecture and Core Modules](02-framework-architecture-and-core-modules.md)
 - [Next Chapter: Chapter 4: Tool Calling and MCP Integration](04-tool-calling-and-mcp-integration.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/qwen-agent-tutorial/04-tool-calling-and-mcp-integration.md b/tutorials/qwen-agent-tutorial/04-tool-calling-and-mcp-integration.md
index d408f9fa..2ac182e8 100644
--- a/tutorials/qwen-agent-tutorial/04-tool-calling-and-mcp-integration.md
+++ b/tutorials/qwen-agent-tutorial/04-tool-calling-and-mcp-integration.md
@@ -626,7 +626,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Model Service and Runtime Strategy](03-model-service-and-runtime-strategy.md)
 - [Next Chapter: Chapter 5: Memory, RAG, and Long-Context Workflows](05-memory-rag-and-long-context-workflows.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/qwen-agent-tutorial/05-memory-rag-and-long-context-workflows.md b/tutorials/qwen-agent-tutorial/05-memory-rag-and-long-context-workflows.md
index dbdb9206..ccc20e3e 100644
--- a/tutorials/qwen-agent-tutorial/05-memory-rag-and-long-context-workflows.md
+++ b/tutorials/qwen-agent-tutorial/05-memory-rag-and-long-context-workflows.md
@@ -626,7 +626,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Tool Calling and MCP Integration](04-tool-calling-and-mcp-integration.md)
 - [Next Chapter: Chapter 6: Application Patterns and Safety Boundaries](06-application-patterns-and-safety-boundaries.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/qwen-agent-tutorial/06-application-patterns-and-safety-boundaries.md b/tutorials/qwen-agent-tutorial/06-application-patterns-and-safety-boundaries.md
index 86ed96d2..2d87f4bd 100644
--- a/tutorials/qwen-agent-tutorial/06-application-patterns-and-safety-boundaries.md
+++ b/tutorials/qwen-agent-tutorial/06-application-patterns-and-safety-boundaries.md
@@ -626,7 +626,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Memory, RAG, and Long-Context Workflows](05-memory-rag-and-long-context-workflows.md)
 - [Next Chapter: Chapter 7: Benchmarking and DeepPlanning Evaluation](07-benchmarking-and-deepplanning-evaluation.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/qwen-agent-tutorial/07-benchmarking-and-deepplanning-evaluation.md b/tutorials/qwen-agent-tutorial/07-benchmarking-and-deepplanning-evaluation.md
index 698d7673..c6ddadcb 100644
--- a/tutorials/qwen-agent-tutorial/07-benchmarking-and-deepplanning-evaluation.md
+++ b/tutorials/qwen-agent-tutorial/07-benchmarking-and-deepplanning-evaluation.md
@@ -626,7 +626,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Application Patterns and Safety Boundaries](06-application-patterns-and-safety-boundaries.md)
 - [Next Chapter: Chapter 8: Contribution Workflow and Production Governance](08-contribution-workflow-and-production-governance.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/qwen-agent-tutorial/08-contribution-workflow-and-production-governance.md b/tutorials/qwen-agent-tutorial/08-contribution-workflow-and-production-governance.md
index 3f84fc25..7c6e84cd 100644
--- a/tutorials/qwen-agent-tutorial/08-contribution-workflow-and-production-governance.md
+++ b/tutorials/qwen-agent-tutorial/08-contribution-workflow-and-production-governance.md
@@ -628,7 +628,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Benchmarking and DeepPlanning Evaluation](07-benchmarking-and-deepplanning-evaluation.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/qwen-agent-tutorial/index.md b/tutorials/qwen-agent-tutorial/README.md
similarity index 100%
rename from tutorials/qwen-agent-tutorial/index.md
rename to tutorials/qwen-agent-tutorial/README.md
diff --git a/tutorials/ragflow-tutorial/01-getting-started.md b/tutorials/ragflow-tutorial/01-getting-started.md
index 7ccce887..c4930ebd 100644
--- a/tutorials/ragflow-tutorial/01-getting-started.md
+++ b/tutorials/ragflow-tutorial/01-getting-started.md
@@ -545,7 +545,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Document Processing](02-document-processing.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/ragflow-tutorial/02-document-processing.md b/tutorials/ragflow-tutorial/02-document-processing.md
index 45d6bf99..5306e4f6 100644
--- a/tutorials/ragflow-tutorial/02-document-processing.md
+++ b/tutorials/ragflow-tutorial/02-document-processing.md
@@ -770,7 +770,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started with RAGFlow](01-getting-started.md)
 - [Next Chapter: Chapter 3: Knowledge Base Setup](03-knowledge-base-setup.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/ragflow-tutorial/03-knowledge-base-setup.md b/tutorials/ragflow-tutorial/03-knowledge-base-setup.md
index a9af12b8..c197bf27 100644
--- a/tutorials/ragflow-tutorial/03-knowledge-base-setup.md
+++ b/tutorials/ragflow-tutorial/03-knowledge-base-setup.md
@@ -693,7 +693,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Document Processing](02-document-processing.md)
 - [Next Chapter: Chapter 4: Retrieval System](04-retrieval-system.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/ragflow-tutorial/04-retrieval-system.md b/tutorials/ragflow-tutorial/04-retrieval-system.md
index 9841fdc5..d967b5df 100644
--- a/tutorials/ragflow-tutorial/04-retrieval-system.md
+++ b/tutorials/ragflow-tutorial/04-retrieval-system.md
@@ -810,7 +810,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Knowledge Base Setup](03-knowledge-base-setup.md)
 - [Next Chapter: Chapter 5: LLM Integration & Configuration](05-llm-integration.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/ragflow-tutorial/05-llm-integration.md b/tutorials/ragflow-tutorial/05-llm-integration.md
index 38fd6201..e9adf0a7 100644
--- a/tutorials/ragflow-tutorial/05-llm-integration.md
+++ b/tutorials/ragflow-tutorial/05-llm-integration.md
@@ -441,7 +441,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Retrieval System](04-retrieval-system.md)
 - [Next Chapter: Chapter 6: Chatbot Development](06-chatbot-development.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/ragflow-tutorial/06-chatbot-development.md b/tutorials/ragflow-tutorial/06-chatbot-development.md
index 1e15bf70..7265f4e8 100644
--- a/tutorials/ragflow-tutorial/06-chatbot-development.md
+++ b/tutorials/ragflow-tutorial/06-chatbot-development.md
@@ -668,7 +668,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: LLM Integration & Configuration](05-llm-integration.md)
 - [Next Chapter: Chapter 7: Advanced Features](07-advanced-features.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/ragflow-tutorial/07-advanced-features.md b/tutorials/ragflow-tutorial/07-advanced-features.md
index 34b72f61..f9e2d448 100644
--- a/tutorials/ragflow-tutorial/07-advanced-features.md
+++ b/tutorials/ragflow-tutorial/07-advanced-features.md
@@ -782,7 +782,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Chatbot Development](06-chatbot-development.md)
 - [Next Chapter: Chapter 8: Production Deployment](08-production-deployment.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/ragflow-tutorial/08-production-deployment.md b/tutorials/ragflow-tutorial/08-production-deployment.md
index 411a8a41..1796bba8 100644
--- a/tutorials/ragflow-tutorial/08-production-deployment.md
+++ b/tutorials/ragflow-tutorial/08-production-deployment.md
@@ -1285,7 +1285,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Advanced Features](07-advanced-features.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/ragflow-tutorial/index.md b/tutorials/ragflow-tutorial/README.md
similarity index 100%
rename from tutorials/ragflow-tutorial/index.md
rename to tutorials/ragflow-tutorial/README.md
diff --git a/tutorials/react-fiber-internals/01-introduction.md b/tutorials/react-fiber-internals/01-introduction.md
index 5bd0f5ec..78e624da 100644
--- a/tutorials/react-fiber-internals/01-introduction.md
+++ b/tutorials/react-fiber-internals/01-introduction.md
@@ -446,7 +446,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Fiber Data Structure](02-fiber-structure.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/react-fiber-internals/02-fiber-structure.md b/tutorials/react-fiber-internals/02-fiber-structure.md
index 403c3211..a55a9189 100644
--- a/tutorials/react-fiber-internals/02-fiber-structure.md
+++ b/tutorials/react-fiber-internals/02-fiber-structure.md
@@ -475,7 +475,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Introduction to Fiber](01-introduction.md)
 - [Next Chapter: Chapter 3: Render Phase](03-render-phase.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/react-fiber-internals/03-render-phase.md b/tutorials/react-fiber-internals/03-render-phase.md
index 3725e57b..ac66f84c 100644
--- a/tutorials/react-fiber-internals/03-render-phase.md
+++ b/tutorials/react-fiber-internals/03-render-phase.md
@@ -761,7 +761,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Fiber Data Structure](02-fiber-structure.md)
 - [Next Chapter: Chapter 4: Commit Phase](04-commit-phase.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/react-fiber-internals/04-commit-phase.md b/tutorials/react-fiber-internals/04-commit-phase.md
index e371ecaf..3de78e9d 100644
--- a/tutorials/react-fiber-internals/04-commit-phase.md
+++ b/tutorials/react-fiber-internals/04-commit-phase.md
@@ -776,7 +776,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Render Phase](03-render-phase.md)
 - [Next Chapter: Chapter 5: Scheduling and Lanes](05-scheduling.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/react-fiber-internals/05-scheduling.md b/tutorials/react-fiber-internals/05-scheduling.md
index b39b042f..b36cf107 100644
--- a/tutorials/react-fiber-internals/05-scheduling.md
+++ b/tutorials/react-fiber-internals/05-scheduling.md
@@ -639,7 +639,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Commit Phase](04-commit-phase.md)
 - [Next Chapter: Chapter 6: Hooks Implementation](06-hooks.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/react-fiber-internals/06-hooks.md b/tutorials/react-fiber-internals/06-hooks.md
index 1bde6d42..8a3adab9 100644
--- a/tutorials/react-fiber-internals/06-hooks.md
+++ b/tutorials/react-fiber-internals/06-hooks.md
@@ -758,7 +758,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Scheduling and Lanes](05-scheduling.md)
 - [Next Chapter: Chapter 7: Concurrent Features](07-concurrent.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/react-fiber-internals/07-concurrent.md b/tutorials/react-fiber-internals/07-concurrent.md
index a0ab4b4a..e23a6414 100644
--- a/tutorials/react-fiber-internals/07-concurrent.md
+++ b/tutorials/react-fiber-internals/07-concurrent.md
@@ -663,7 +663,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Hooks Implementation](06-hooks.md)
 - [Next Chapter: Chapter 8: Debugging and Profiling](08-debugging.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/react-fiber-internals/08-debugging.md b/tutorials/react-fiber-internals/08-debugging.md
index d68c7ba1..25e2afcc 100644
--- a/tutorials/react-fiber-internals/08-debugging.md
+++ b/tutorials/react-fiber-internals/08-debugging.md
@@ -668,7 +668,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Concurrent Features](07-concurrent.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/react-fiber-internals/index.md b/tutorials/react-fiber-internals/README.md
similarity index 100%
rename from tutorials/react-fiber-internals/index.md
rename to tutorials/react-fiber-internals/README.md
diff --git a/tutorials/refly-tutorial/01-getting-started.md b/tutorials/refly-tutorial/01-getting-started.md
index 051aeb08..96ca49ee 100644
--- a/tutorials/refly-tutorial/01-getting-started.md
+++ b/tutorials/refly-tutorial/01-getting-started.md
@@ -641,7 +641,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Architecture and Component Topology](02-architecture-and-component-topology.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/refly-tutorial/02-architecture-and-component-topology.md b/tutorials/refly-tutorial/02-architecture-and-component-topology.md
index 5a22a52d..99b127f2 100644
--- a/tutorials/refly-tutorial/02-architecture-and-component-topology.md
+++ b/tutorials/refly-tutorial/02-architecture-and-component-topology.md
@@ -629,7 +629,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started](01-getting-started.md)
 - [Next Chapter: Chapter 3: Workflow Construction and Deterministic Runtime](03-workflow-construction-and-deterministic-runtime.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/refly-tutorial/03-workflow-construction-and-deterministic-runtime.md b/tutorials/refly-tutorial/03-workflow-construction-and-deterministic-runtime.md
index 008c490e..816514c5 100644
--- a/tutorials/refly-tutorial/03-workflow-construction-and-deterministic-runtime.md
+++ b/tutorials/refly-tutorial/03-workflow-construction-and-deterministic-runtime.md
@@ -637,7 +637,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Architecture and Component Topology](02-architecture-and-component-topology.md)
 - [Next Chapter: Chapter 4: API and Webhook Integrations](04-api-and-webhook-integrations.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/refly-tutorial/04-api-and-webhook-integrations.md b/tutorials/refly-tutorial/04-api-and-webhook-integrations.md
index 51fdf4d3..e5aae3ae 100644
--- a/tutorials/refly-tutorial/04-api-and-webhook-integrations.md
+++ b/tutorials/refly-tutorial/04-api-and-webhook-integrations.md
@@ -636,7 +636,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Workflow Construction and Deterministic Runtime](03-workflow-construction-and-deterministic-runtime.md)
 - [Next Chapter: Chapter 5: Refly CLI and Claude Code Skill Export](05-refly-cli-and-claude-code-skill-export.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/refly-tutorial/05-refly-cli-and-claude-code-skill-export.md b/tutorials/refly-tutorial/05-refly-cli-and-claude-code-skill-export.md
index 46f6351d..e7442f6f 100644
--- a/tutorials/refly-tutorial/05-refly-cli-and-claude-code-skill-export.md
+++ b/tutorials/refly-tutorial/05-refly-cli-and-claude-code-skill-export.md
@@ -630,7 +630,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: API and Webhook Integrations](04-api-and-webhook-integrations.md)
 - [Next Chapter: Chapter 6: Observability, Deployment, and Operations](06-observability-deployment-and-operations.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/refly-tutorial/06-observability-deployment-and-operations.md b/tutorials/refly-tutorial/06-observability-deployment-and-operations.md
index cc7e397a..9085a31b 100644
--- a/tutorials/refly-tutorial/06-observability-deployment-and-operations.md
+++ b/tutorials/refly-tutorial/06-observability-deployment-and-operations.md
@@ -630,7 +630,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Refly CLI and Claude Code Skill Export](05-refly-cli-and-claude-code-skill-export.md)
 - [Next Chapter: Chapter 7: Troubleshooting, Safety, and Cost Controls](07-troubleshooting-safety-and-cost-controls.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/refly-tutorial/07-troubleshooting-safety-and-cost-controls.md b/tutorials/refly-tutorial/07-troubleshooting-safety-and-cost-controls.md
index 55443b3c..29d767f9 100644
--- a/tutorials/refly-tutorial/07-troubleshooting-safety-and-cost-controls.md
+++ b/tutorials/refly-tutorial/07-troubleshooting-safety-and-cost-controls.md
@@ -636,7 +636,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Observability, Deployment, and Operations](06-observability-deployment-and-operations.md)
 - [Next Chapter: Chapter 8: Contribution Workflow and Governance](08-contribution-workflow-and-governance.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/refly-tutorial/08-contribution-workflow-and-governance.md b/tutorials/refly-tutorial/08-contribution-workflow-and-governance.md
index ab62f75b..9a08a010 100644
--- a/tutorials/refly-tutorial/08-contribution-workflow-and-governance.md
+++ b/tutorials/refly-tutorial/08-contribution-workflow-and-governance.md
@@ -626,7 +626,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Troubleshooting, Safety, and Cost Controls](07-troubleshooting-safety-and-cost-controls.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/refly-tutorial/index.md b/tutorials/refly-tutorial/README.md
similarity index 100%
rename from tutorials/refly-tutorial/index.md
rename to tutorials/refly-tutorial/README.md
diff --git a/tutorials/roo-code-tutorial/01-getting-started.md b/tutorials/roo-code-tutorial/01-getting-started.md
index d80ce33e..0c14136a 100644
--- a/tutorials/roo-code-tutorial/01-getting-started.md
+++ b/tutorials/roo-code-tutorial/01-getting-started.md
@@ -637,7 +637,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Modes and Task Design](02-modes-and-task-design.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/roo-code-tutorial/02-modes-and-task-design.md b/tutorials/roo-code-tutorial/02-modes-and-task-design.md
index b23e0461..b0705612 100644
--- a/tutorials/roo-code-tutorial/02-modes-and-task-design.md
+++ b/tutorials/roo-code-tutorial/02-modes-and-task-design.md
@@ -628,7 +628,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started](01-getting-started.md)
 - [Next Chapter: Chapter 3: File and Command Operations](03-file-and-command-operations.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/roo-code-tutorial/03-file-and-command-operations.md b/tutorials/roo-code-tutorial/03-file-and-command-operations.md
index edd4f01c..8aef9be4 100644
--- a/tutorials/roo-code-tutorial/03-file-and-command-operations.md
+++ b/tutorials/roo-code-tutorial/03-file-and-command-operations.md
@@ -630,7 +630,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Modes and Task Design](02-modes-and-task-design.md)
 - [Next Chapter: Chapter 4: Context and Indexing](04-context-and-indexing.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/roo-code-tutorial/04-context-and-indexing.md b/tutorials/roo-code-tutorial/04-context-and-indexing.md
index e063253d..2ac455ea 100644
--- a/tutorials/roo-code-tutorial/04-context-and-indexing.md
+++ b/tutorials/roo-code-tutorial/04-context-and-indexing.md
@@ -632,7 +632,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: File and Command Operations](03-file-and-command-operations.md)
 - [Next Chapter: Chapter 5: Checkpoints and Recovery](05-checkpoints-and-recovery.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/roo-code-tutorial/05-checkpoints-and-recovery.md b/tutorials/roo-code-tutorial/05-checkpoints-and-recovery.md
index 8aba3a2a..6393843a 100644
--- a/tutorials/roo-code-tutorial/05-checkpoints-and-recovery.md
+++ b/tutorials/roo-code-tutorial/05-checkpoints-and-recovery.md
@@ -630,7 +630,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Context and Indexing](04-context-and-indexing.md)
 - [Next Chapter: Chapter 6: MCP and Tool Extensions](06-mcp-and-tool-extensions.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/roo-code-tutorial/06-mcp-and-tool-extensions.md b/tutorials/roo-code-tutorial/06-mcp-and-tool-extensions.md
index c223a536..b0a9d48b 100644
--- a/tutorials/roo-code-tutorial/06-mcp-and-tool-extensions.md
+++ b/tutorials/roo-code-tutorial/06-mcp-and-tool-extensions.md
@@ -628,7 +628,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Checkpoints and Recovery](05-checkpoints-and-recovery.md)
 - [Next Chapter: Chapter 7: Profiles and Team Standards](07-profiles-and-team-standards.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/roo-code-tutorial/07-profiles-and-team-standards.md b/tutorials/roo-code-tutorial/07-profiles-and-team-standards.md
index b7802835..52e316ba 100644
--- a/tutorials/roo-code-tutorial/07-profiles-and-team-standards.md
+++ b/tutorials/roo-code-tutorial/07-profiles-and-team-standards.md
@@ -631,7 +631,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: MCP and Tool Extensions](06-mcp-and-tool-extensions.md)
 - [Next Chapter: Chapter 8: Enterprise Operations](08-enterprise-operations.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/roo-code-tutorial/08-enterprise-operations.md b/tutorials/roo-code-tutorial/08-enterprise-operations.md
index 1ba1df50..460d8c15 100644
--- a/tutorials/roo-code-tutorial/08-enterprise-operations.md
+++ b/tutorials/roo-code-tutorial/08-enterprise-operations.md
@@ -637,7 +637,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Profiles and Team Standards](07-profiles-and-team-standards.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/roo-code-tutorial/index.md b/tutorials/roo-code-tutorial/README.md
similarity index 100%
rename from tutorials/roo-code-tutorial/index.md
rename to tutorials/roo-code-tutorial/README.md
diff --git a/tutorials/semantic-kernel-tutorial/01-getting-started.md b/tutorials/semantic-kernel-tutorial/01-getting-started.md
index ab42cf22..2b0e3470 100644
--- a/tutorials/semantic-kernel-tutorial/01-getting-started.md
+++ b/tutorials/semantic-kernel-tutorial/01-getting-started.md
@@ -474,7 +474,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Plugins & Functions](02-plugins.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/semantic-kernel-tutorial/02-plugins.md b/tutorials/semantic-kernel-tutorial/02-plugins.md
index eae85a42..9d90e9c1 100644
--- a/tutorials/semantic-kernel-tutorial/02-plugins.md
+++ b/tutorials/semantic-kernel-tutorial/02-plugins.md
@@ -775,7 +775,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started with Semantic Kernel](01-getting-started.md)
 - [Next Chapter: Chapter 3: Prompt Engineering](03-prompts.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/semantic-kernel-tutorial/03-prompts.md b/tutorials/semantic-kernel-tutorial/03-prompts.md
index 63ca89a5..456b4191 100644
--- a/tutorials/semantic-kernel-tutorial/03-prompts.md
+++ b/tutorials/semantic-kernel-tutorial/03-prompts.md
@@ -811,7 +811,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Plugins & Functions](02-plugins.md)
 - [Next Chapter: Chapter 4: AI Services & Connectors](04-services.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/semantic-kernel-tutorial/04-services.md b/tutorials/semantic-kernel-tutorial/04-services.md
index 6c269f27..d8f2507d 100644
--- a/tutorials/semantic-kernel-tutorial/04-services.md
+++ b/tutorials/semantic-kernel-tutorial/04-services.md
@@ -762,7 +762,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Prompt Engineering](03-prompts.md)
 - [Next Chapter: Chapter 5: Memory & Embeddings](05-memory.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/semantic-kernel-tutorial/05-memory.md b/tutorials/semantic-kernel-tutorial/05-memory.md
index d6f919f2..fb09cc8a 100644
--- a/tutorials/semantic-kernel-tutorial/05-memory.md
+++ b/tutorials/semantic-kernel-tutorial/05-memory.md
@@ -829,7 +829,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: AI Services & Connectors](04-services.md)
 - [Next Chapter: Chapter 6: Planners](06-planners.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/semantic-kernel-tutorial/06-planners.md b/tutorials/semantic-kernel-tutorial/06-planners.md
index 0fd64383..50c57c2a 100644
--- a/tutorials/semantic-kernel-tutorial/06-planners.md
+++ b/tutorials/semantic-kernel-tutorial/06-planners.md
@@ -752,7 +752,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Memory & Embeddings](05-memory.md)
 - [Next Chapter: Chapter 7: Agents & Tool Use](07-agents.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/semantic-kernel-tutorial/07-agents.md b/tutorials/semantic-kernel-tutorial/07-agents.md
index 1ed62ba0..27d55816 100644
--- a/tutorials/semantic-kernel-tutorial/07-agents.md
+++ b/tutorials/semantic-kernel-tutorial/07-agents.md
@@ -820,7 +820,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Planners](06-planners.md)
 - [Next Chapter: Chapter 8: Production Deployment & Operations](08-production.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/semantic-kernel-tutorial/08-production.md b/tutorials/semantic-kernel-tutorial/08-production.md
index 0597e3c0..2a403579 100644
--- a/tutorials/semantic-kernel-tutorial/08-production.md
+++ b/tutorials/semantic-kernel-tutorial/08-production.md
@@ -1075,7 +1075,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Agents & Tool Use](07-agents.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/semantic-kernel-tutorial/index.md b/tutorials/semantic-kernel-tutorial/README.md
similarity index 100%
rename from tutorials/semantic-kernel-tutorial/index.md
rename to tutorials/semantic-kernel-tutorial/README.md
diff --git a/tutorials/serena-tutorial/01-getting-started.md b/tutorials/serena-tutorial/01-getting-started.md
index cb96b193..5c0cbb95 100644
--- a/tutorials/serena-tutorial/01-getting-started.md
+++ b/tutorials/serena-tutorial/01-getting-started.md
@@ -635,7 +635,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Semantic Toolkit and Agent Loop](02-semantic-toolkit-and-agent-loop.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/serena-tutorial/02-semantic-toolkit-and-agent-loop.md b/tutorials/serena-tutorial/02-semantic-toolkit-and-agent-loop.md
index 094f350f..ba530660 100644
--- a/tutorials/serena-tutorial/02-semantic-toolkit-and-agent-loop.md
+++ b/tutorials/serena-tutorial/02-semantic-toolkit-and-agent-loop.md
@@ -628,7 +628,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started](01-getting-started.md)
 - [Next Chapter: Chapter 3: MCP Client Integrations](03-mcp-client-integrations.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/serena-tutorial/03-mcp-client-integrations.md b/tutorials/serena-tutorial/03-mcp-client-integrations.md
index 28c36e64..f6ffc238 100644
--- a/tutorials/serena-tutorial/03-mcp-client-integrations.md
+++ b/tutorials/serena-tutorial/03-mcp-client-integrations.md
@@ -628,7 +628,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Semantic Toolkit and Agent Loop](02-semantic-toolkit-and-agent-loop.md)
 - [Next Chapter: Chapter 4: Language Backends and Analysis Strategy](04-language-backends-and-analysis-strategy.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/serena-tutorial/04-language-backends-and-analysis-strategy.md b/tutorials/serena-tutorial/04-language-backends-and-analysis-strategy.md
index f17a1de6..24b9c93b 100644
--- a/tutorials/serena-tutorial/04-language-backends-and-analysis-strategy.md
+++ b/tutorials/serena-tutorial/04-language-backends-and-analysis-strategy.md
@@ -637,7 +637,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: MCP Client Integrations](03-mcp-client-integrations.md)
 - [Next Chapter: Chapter 5: Project Workflow and Context Practices](05-project-workflow-and-context-practices.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/serena-tutorial/05-project-workflow-and-context-practices.md b/tutorials/serena-tutorial/05-project-workflow-and-context-practices.md
index d1c8093d..068d4a31 100644
--- a/tutorials/serena-tutorial/05-project-workflow-and-context-practices.md
+++ b/tutorials/serena-tutorial/05-project-workflow-and-context-practices.md
@@ -637,7 +637,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Language Backends and Analysis Strategy](04-language-backends-and-analysis-strategy.md)
 - [Next Chapter: Chapter 6: Configuration and Operational Controls](06-configuration-and-operational-controls.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/serena-tutorial/06-configuration-and-operational-controls.md b/tutorials/serena-tutorial/06-configuration-and-operational-controls.md
index c4768509..de73665d 100644
--- a/tutorials/serena-tutorial/06-configuration-and-operational-controls.md
+++ b/tutorials/serena-tutorial/06-configuration-and-operational-controls.md
@@ -637,7 +637,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Project Workflow and Context Practices](05-project-workflow-and-context-practices.md)
 - [Next Chapter: Chapter 7: Extending Serena and Custom Agent Integration](07-extending-serena-and-custom-agent-integration.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/serena-tutorial/07-extending-serena-and-custom-agent-integration.md b/tutorials/serena-tutorial/07-extending-serena-and-custom-agent-integration.md
index e978053c..b3b41e2b 100644
--- a/tutorials/serena-tutorial/07-extending-serena-and-custom-agent-integration.md
+++ b/tutorials/serena-tutorial/07-extending-serena-and-custom-agent-integration.md
@@ -635,7 +635,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Configuration and Operational Controls](06-configuration-and-operational-controls.md)
 - [Next Chapter: Chapter 8: Production Operations and Governance](08-production-operations-and-governance.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/serena-tutorial/08-production-operations-and-governance.md b/tutorials/serena-tutorial/08-production-operations-and-governance.md
index 6a4647d9..84ef5217 100644
--- a/tutorials/serena-tutorial/08-production-operations-and-governance.md
+++ b/tutorials/serena-tutorial/08-production-operations-and-governance.md
@@ -639,7 +639,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Extending Serena and Custom Agent Integration](07-extending-serena-and-custom-agent-integration.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/serena-tutorial/index.md b/tutorials/serena-tutorial/README.md
similarity index 100%
rename from tutorials/serena-tutorial/index.md
rename to tutorials/serena-tutorial/README.md
diff --git a/tutorials/shotgun-tutorial/01-getting-started.md b/tutorials/shotgun-tutorial/01-getting-started.md
index fa8c71bc..136c2966 100644
--- a/tutorials/shotgun-tutorial/01-getting-started.md
+++ b/tutorials/shotgun-tutorial/01-getting-started.md
@@ -641,7 +641,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Router Architecture and Agent Lifecycle](02-router-architecture-and-agent-lifecycle.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/shotgun-tutorial/02-router-architecture-and-agent-lifecycle.md b/tutorials/shotgun-tutorial/02-router-architecture-and-agent-lifecycle.md
index 9964d490..35017603 100644
--- a/tutorials/shotgun-tutorial/02-router-architecture-and-agent-lifecycle.md
+++ b/tutorials/shotgun-tutorial/02-router-architecture-and-agent-lifecycle.md
@@ -632,7 +632,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started](01-getting-started.md)
 - [Next Chapter: Chapter 3: Planning vs Drafting Execution Modes](03-planning-vs-drafting-execution-modes.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/shotgun-tutorial/03-planning-vs-drafting-execution-modes.md b/tutorials/shotgun-tutorial/03-planning-vs-drafting-execution-modes.md
index 414a9d12..6599bf2a 100644
--- a/tutorials/shotgun-tutorial/03-planning-vs-drafting-execution-modes.md
+++ b/tutorials/shotgun-tutorial/03-planning-vs-drafting-execution-modes.md
@@ -626,7 +626,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Router Architecture and Agent Lifecycle](02-router-architecture-and-agent-lifecycle.md)
 - [Next Chapter: Chapter 4: Codebase Indexing and Context Retrieval](04-codebase-indexing-and-context-retrieval.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/shotgun-tutorial/04-codebase-indexing-and-context-retrieval.md b/tutorials/shotgun-tutorial/04-codebase-indexing-and-context-retrieval.md
index 4eaed502..ae367407 100644
--- a/tutorials/shotgun-tutorial/04-codebase-indexing-and-context-retrieval.md
+++ b/tutorials/shotgun-tutorial/04-codebase-indexing-and-context-retrieval.md
@@ -628,7 +628,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Planning vs Drafting Execution Modes](03-planning-vs-drafting-execution-modes.md)
 - [Next Chapter: Chapter 5: CLI Automation and Scripting](05-cli-automation-and-scripting.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/shotgun-tutorial/05-cli-automation-and-scripting.md b/tutorials/shotgun-tutorial/05-cli-automation-and-scripting.md
index d724febe..eb60f523 100644
--- a/tutorials/shotgun-tutorial/05-cli-automation-and-scripting.md
+++ b/tutorials/shotgun-tutorial/05-cli-automation-and-scripting.md
@@ -633,7 +633,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Codebase Indexing and Context Retrieval](04-codebase-indexing-and-context-retrieval.md)
 - [Next Chapter: Chapter 6: Context7 MCP and Local Models](06-context7-mcp-and-local-models.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/shotgun-tutorial/06-context7-mcp-and-local-models.md b/tutorials/shotgun-tutorial/06-context7-mcp-and-local-models.md
index 10608056..2fd1c7f5 100644
--- a/tutorials/shotgun-tutorial/06-context7-mcp-and-local-models.md
+++ b/tutorials/shotgun-tutorial/06-context7-mcp-and-local-models.md
@@ -626,7 +626,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: CLI Automation and Scripting](05-cli-automation-and-scripting.md)
 - [Next Chapter: Chapter 7: Spec Sharing and Collaboration Workflows](07-spec-sharing-and-collaboration-workflows.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/shotgun-tutorial/07-spec-sharing-and-collaboration-workflows.md b/tutorials/shotgun-tutorial/07-spec-sharing-and-collaboration-workflows.md
index bedeabd6..30a318de 100644
--- a/tutorials/shotgun-tutorial/07-spec-sharing-and-collaboration-workflows.md
+++ b/tutorials/shotgun-tutorial/07-spec-sharing-and-collaboration-workflows.md
@@ -628,7 +628,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Context7 MCP and Local Models](06-context7-mcp-and-local-models.md)
 - [Next Chapter: Chapter 8: Production Operations, Observability, and Security](08-production-operations-observability-and-security.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/shotgun-tutorial/08-production-operations-observability-and-security.md b/tutorials/shotgun-tutorial/08-production-operations-observability-and-security.md
index 07adc657..f07c88e8 100644
--- a/tutorials/shotgun-tutorial/08-production-operations-observability-and-security.md
+++ b/tutorials/shotgun-tutorial/08-production-operations-observability-and-security.md
@@ -630,7 +630,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Spec Sharing and Collaboration Workflows](07-spec-sharing-and-collaboration-workflows.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/shotgun-tutorial/index.md b/tutorials/shotgun-tutorial/README.md
similarity index 100%
rename from tutorials/shotgun-tutorial/index.md
rename to tutorials/shotgun-tutorial/README.md
diff --git a/tutorials/sillytavern-tutorial/01-getting-started.md b/tutorials/sillytavern-tutorial/01-getting-started.md
index 52927935..2804677e 100644
--- a/tutorials/sillytavern-tutorial/01-getting-started.md
+++ b/tutorials/sillytavern-tutorial/01-getting-started.md
@@ -553,7 +553,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Character Creation](02-character-creation.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/sillytavern-tutorial/02-character-creation.md b/tutorials/sillytavern-tutorial/02-character-creation.md
index 24040d1c..ead73eca 100644
--- a/tutorials/sillytavern-tutorial/02-character-creation.md
+++ b/tutorials/sillytavern-tutorial/02-character-creation.md
@@ -500,7 +500,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started with SillyTavern](01-getting-started.md)
 - [Next Chapter: Chapter 3: Chat Management](03-chat-management.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/sillytavern-tutorial/03-chat-management.md b/tutorials/sillytavern-tutorial/03-chat-management.md
index eea2548d..410d3224 100644
--- a/tutorials/sillytavern-tutorial/03-chat-management.md
+++ b/tutorials/sillytavern-tutorial/03-chat-management.md
@@ -652,7 +652,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Character Creation](02-character-creation.md)
 - [Next Chapter: Chapter 4: Prompt Engineering](04-prompt-engineering.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/sillytavern-tutorial/04-prompt-engineering.md b/tutorials/sillytavern-tutorial/04-prompt-engineering.md
index b9743978..328d9268 100644
--- a/tutorials/sillytavern-tutorial/04-prompt-engineering.md
+++ b/tutorials/sillytavern-tutorial/04-prompt-engineering.md
@@ -540,7 +540,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Chat Management](03-chat-management.md)
 - [Next Chapter: Chapter 5: Extensions Ecosystem](05-extensions-ecosystem.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/sillytavern-tutorial/05-extensions-ecosystem.md b/tutorials/sillytavern-tutorial/05-extensions-ecosystem.md
index b2519241..84a5b860 100644
--- a/tutorials/sillytavern-tutorial/05-extensions-ecosystem.md
+++ b/tutorials/sillytavern-tutorial/05-extensions-ecosystem.md
@@ -753,7 +753,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Prompt Engineering](04-prompt-engineering.md)
 - [Next Chapter: Chapter 6: Multi-Model Setup](06-multi-model-setup.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/sillytavern-tutorial/06-multi-model-setup.md b/tutorials/sillytavern-tutorial/06-multi-model-setup.md
index 9dff3c40..9beb27c2 100644
--- a/tutorials/sillytavern-tutorial/06-multi-model-setup.md
+++ b/tutorials/sillytavern-tutorial/06-multi-model-setup.md
@@ -677,7 +677,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Extensions Ecosystem](05-extensions-ecosystem.md)
 - [Next Chapter: Chapter 7: Advanced Features](07-advanced-features.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/sillytavern-tutorial/07-advanced-features.md b/tutorials/sillytavern-tutorial/07-advanced-features.md
index 28214370..2f5acb19 100644
--- a/tutorials/sillytavern-tutorial/07-advanced-features.md
+++ b/tutorials/sillytavern-tutorial/07-advanced-features.md
@@ -673,7 +673,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Multi-Model Setup](06-multi-model-setup.md)
 - [Next Chapter: Chapter 8: Custom Development](08-custom-development.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/sillytavern-tutorial/08-custom-development.md b/tutorials/sillytavern-tutorial/08-custom-development.md
index c5ac1140..66cf86bc 100644
--- a/tutorials/sillytavern-tutorial/08-custom-development.md
+++ b/tutorials/sillytavern-tutorial/08-custom-development.md
@@ -903,7 +903,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Advanced Features](07-advanced-features.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/sillytavern-tutorial/index.md b/tutorials/sillytavern-tutorial/README.md
similarity index 100%
rename from tutorials/sillytavern-tutorial/index.md
rename to tutorials/sillytavern-tutorial/README.md
diff --git a/tutorials/siyuan-tutorial/01-getting-started.md b/tutorials/siyuan-tutorial/01-getting-started.md
index 3c753ec4..8fb14502 100644
--- a/tutorials/siyuan-tutorial/01-getting-started.md
+++ b/tutorials/siyuan-tutorial/01-getting-started.md
@@ -402,7 +402,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Block-Based Architecture](02-block-architecture.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/siyuan-tutorial/02-block-architecture.md b/tutorials/siyuan-tutorial/02-block-architecture.md
index 11b4d7de..3cbaf31c 100644
--- a/tutorials/siyuan-tutorial/02-block-architecture.md
+++ b/tutorials/siyuan-tutorial/02-block-architecture.md
@@ -799,7 +799,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started with SiYuan](01-getting-started.md)
 - [Next Chapter: Chapter 3: Data Storage & Persistence](03-data-storage.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/siyuan-tutorial/03-data-storage.md b/tutorials/siyuan-tutorial/03-data-storage.md
index 2beef171..c9417d8d 100644
--- a/tutorials/siyuan-tutorial/03-data-storage.md
+++ b/tutorials/siyuan-tutorial/03-data-storage.md
@@ -1047,7 +1047,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Block-Based Architecture](02-block-architecture.md)
 - [Next Chapter: Chapter 4: Query System & Search](04-query-system.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/siyuan-tutorial/04-query-system.md b/tutorials/siyuan-tutorial/04-query-system.md
index 356410ff..b53b5e0a 100644
--- a/tutorials/siyuan-tutorial/04-query-system.md
+++ b/tutorials/siyuan-tutorial/04-query-system.md
@@ -981,7 +981,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Data Storage & Persistence](03-data-storage.md)
 - [Next Chapter: Chapter 5: Plugin Architecture](05-plugin-architecture.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/siyuan-tutorial/05-plugin-architecture.md b/tutorials/siyuan-tutorial/05-plugin-architecture.md
index 110df809..bf510145 100644
--- a/tutorials/siyuan-tutorial/05-plugin-architecture.md
+++ b/tutorials/siyuan-tutorial/05-plugin-architecture.md
@@ -965,7 +965,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Query System & Search](04-query-system.md)
 - [Next Chapter: Chapter 6: Synchronization & Backup](06-synchronization.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/siyuan-tutorial/06-synchronization.md b/tutorials/siyuan-tutorial/06-synchronization.md
index 57efc728..9d233b99 100644
--- a/tutorials/siyuan-tutorial/06-synchronization.md
+++ b/tutorials/siyuan-tutorial/06-synchronization.md
@@ -1027,7 +1027,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Plugin Architecture](05-plugin-architecture.md)
 - [Next Chapter: Chapter 7: Advanced Features](07-advanced-features.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/siyuan-tutorial/07-advanced-features.md b/tutorials/siyuan-tutorial/07-advanced-features.md
index b18c85c5..33f4eed6 100644
--- a/tutorials/siyuan-tutorial/07-advanced-features.md
+++ b/tutorials/siyuan-tutorial/07-advanced-features.md
@@ -1066,7 +1066,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Synchronization & Backup](06-synchronization.md)
 - [Next Chapter: Chapter 8: Production Deployment](08-production-deployment.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/siyuan-tutorial/08-production-deployment.md b/tutorials/siyuan-tutorial/08-production-deployment.md
index 4474c088..57f48538 100644
--- a/tutorials/siyuan-tutorial/08-production-deployment.md
+++ b/tutorials/siyuan-tutorial/08-production-deployment.md
@@ -1267,7 +1267,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Advanced Features](07-advanced-features.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/siyuan-tutorial/index.md b/tutorials/siyuan-tutorial/README.md
similarity index 100%
rename from tutorials/siyuan-tutorial/index.md
rename to tutorials/siyuan-tutorial/README.md
diff --git a/tutorials/smolagents-tutorial/01-getting-started.md b/tutorials/smolagents-tutorial/01-getting-started.md
index a7d5bba2..8c951c07 100644
--- a/tutorials/smolagents-tutorial/01-getting-started.md
+++ b/tutorials/smolagents-tutorial/01-getting-started.md
@@ -437,7 +437,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Understanding Smolagents](02-understanding-agents.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/smolagents-tutorial/02-understanding-agents.md b/tutorials/smolagents-tutorial/02-understanding-agents.md
index 49a575a3..5efa9143 100644
--- a/tutorials/smolagents-tutorial/02-understanding-agents.md
+++ b/tutorials/smolagents-tutorial/02-understanding-agents.md
@@ -518,7 +518,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started with Smolagents](01-getting-started.md)
 - [Next Chapter: Chapter 3: Tools & Functions](03-tools.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/smolagents-tutorial/03-tools.md b/tutorials/smolagents-tutorial/03-tools.md
index 28d84403..d4aa7cff 100644
--- a/tutorials/smolagents-tutorial/03-tools.md
+++ b/tutorials/smolagents-tutorial/03-tools.md
@@ -652,7 +652,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Understanding Smolagents](02-understanding-agents.md)
 - [Next Chapter: Chapter 4: Safe Code Execution](04-code-execution.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/smolagents-tutorial/04-code-execution.md b/tutorials/smolagents-tutorial/04-code-execution.md
index dd2d5887..48596afe 100644
--- a/tutorials/smolagents-tutorial/04-code-execution.md
+++ b/tutorials/smolagents-tutorial/04-code-execution.md
@@ -609,7 +609,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Tools & Functions](03-tools.md)
 - [Next Chapter: Chapter 5: Multi-Step Reasoning](05-multi-step.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/smolagents-tutorial/05-multi-step.md b/tutorials/smolagents-tutorial/05-multi-step.md
index 0589e5cc..7310985b 100644
--- a/tutorials/smolagents-tutorial/05-multi-step.md
+++ b/tutorials/smolagents-tutorial/05-multi-step.md
@@ -657,7 +657,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Safe Code Execution](04-code-execution.md)
 - [Next Chapter: Chapter 6: Memory & Context](06-memory.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/smolagents-tutorial/06-memory.md b/tutorials/smolagents-tutorial/06-memory.md
index 1d66b85e..2269c3a9 100644
--- a/tutorials/smolagents-tutorial/06-memory.md
+++ b/tutorials/smolagents-tutorial/06-memory.md
@@ -697,7 +697,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Multi-Step Reasoning](05-multi-step.md)
 - [Next Chapter: Chapter 7: Advanced Patterns](07-advanced.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/smolagents-tutorial/07-advanced.md b/tutorials/smolagents-tutorial/07-advanced.md
index 02dd511e..951026db 100644
--- a/tutorials/smolagents-tutorial/07-advanced.md
+++ b/tutorials/smolagents-tutorial/07-advanced.md
@@ -800,7 +800,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Memory & Context](06-memory.md)
 - [Next Chapter: Chapter 8: Production Deployment & Operations](08-production.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/smolagents-tutorial/08-production.md b/tutorials/smolagents-tutorial/08-production.md
index 6172d40c..93ba451a 100644
--- a/tutorials/smolagents-tutorial/08-production.md
+++ b/tutorials/smolagents-tutorial/08-production.md
@@ -923,7 +923,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Advanced Patterns](07-advanced.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/smolagents-tutorial/index.md b/tutorials/smolagents-tutorial/README.md
similarity index 100%
rename from tutorials/smolagents-tutorial/index.md
rename to tutorials/smolagents-tutorial/README.md
diff --git a/tutorials/stagewise-tutorial/01-getting-started-and-cli-bootstrap.md b/tutorials/stagewise-tutorial/01-getting-started-and-cli-bootstrap.md
index ac19bb1f..a61da7cc 100644
--- a/tutorials/stagewise-tutorial/01-getting-started-and-cli-bootstrap.md
+++ b/tutorials/stagewise-tutorial/01-getting-started-and-cli-bootstrap.md
@@ -639,7 +639,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Proxy and Toolbar Architecture](02-proxy-and-toolbar-architecture.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/stagewise-tutorial/02-proxy-and-toolbar-architecture.md b/tutorials/stagewise-tutorial/02-proxy-and-toolbar-architecture.md
index 3a3d6397..27a67a95 100644
--- a/tutorials/stagewise-tutorial/02-proxy-and-toolbar-architecture.md
+++ b/tutorials/stagewise-tutorial/02-proxy-and-toolbar-architecture.md
@@ -644,7 +644,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started and CLI Bootstrap](01-getting-started-and-cli-bootstrap.md)
 - [Next Chapter: Chapter 3: Bridge Mode and Multi-Agent Integrations](03-bridge-mode-and-multi-agent-integrations.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/stagewise-tutorial/03-bridge-mode-and-multi-agent-integrations.md b/tutorials/stagewise-tutorial/03-bridge-mode-and-multi-agent-integrations.md
index 0e7df8a1..c03f4689 100644
--- a/tutorials/stagewise-tutorial/03-bridge-mode-and-multi-agent-integrations.md
+++ b/tutorials/stagewise-tutorial/03-bridge-mode-and-multi-agent-integrations.md
@@ -640,7 +640,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Proxy and Toolbar Architecture](02-proxy-and-toolbar-architecture.md)
 - [Next Chapter: Chapter 4: Configuration and Plugin Loading](04-configuration-and-plugin-loading.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/stagewise-tutorial/04-configuration-and-plugin-loading.md b/tutorials/stagewise-tutorial/04-configuration-and-plugin-loading.md
index 208ba6ce..54d5ea7a 100644
--- a/tutorials/stagewise-tutorial/04-configuration-and-plugin-loading.md
+++ b/tutorials/stagewise-tutorial/04-configuration-and-plugin-loading.md
@@ -642,7 +642,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Bridge Mode and Multi-Agent Integrations](03-bridge-mode-and-multi-agent-integrations.md)
 - [Next Chapter: Chapter 5: Building Plugins with Plugin SDK](05-building-plugins-with-plugin-sdk.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/stagewise-tutorial/05-building-plugins-with-plugin-sdk.md b/tutorials/stagewise-tutorial/05-building-plugins-with-plugin-sdk.md
index 1fa2ce87..fe65b5c6 100644
--- a/tutorials/stagewise-tutorial/05-building-plugins-with-plugin-sdk.md
+++ b/tutorials/stagewise-tutorial/05-building-plugins-with-plugin-sdk.md
@@ -646,7 +646,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Configuration and Plugin Loading](04-configuration-and-plugin-loading.md)
 - [Next Chapter: Chapter 6: Custom Agent Integrations with Agent Interface](06-custom-agent-integrations-with-agent-interface.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/stagewise-tutorial/06-custom-agent-integrations-with-agent-interface.md b/tutorials/stagewise-tutorial/06-custom-agent-integrations-with-agent-interface.md
index af5a98e6..e3523467 100644
--- a/tutorials/stagewise-tutorial/06-custom-agent-integrations-with-agent-interface.md
+++ b/tutorials/stagewise-tutorial/06-custom-agent-integrations-with-agent-interface.md
@@ -637,7 +637,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Building Plugins with Plugin SDK](05-building-plugins-with-plugin-sdk.md)
 - [Next Chapter: Chapter 7: Troubleshooting, Security, and Operations](07-troubleshooting-security-and-operations.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/stagewise-tutorial/07-troubleshooting-security-and-operations.md b/tutorials/stagewise-tutorial/07-troubleshooting-security-and-operations.md
index ed2e6158..007d84ae 100644
--- a/tutorials/stagewise-tutorial/07-troubleshooting-security-and-operations.md
+++ b/tutorials/stagewise-tutorial/07-troubleshooting-security-and-operations.md
@@ -641,7 +641,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Custom Agent Integrations with Agent Interface](06-custom-agent-integrations-with-agent-interface.md)
 - [Next Chapter: Chapter 8: Contribution Workflow and Ecosystem Evolution](08-contribution-workflow-and-ecosystem-evolution.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/stagewise-tutorial/08-contribution-workflow-and-ecosystem-evolution.md b/tutorials/stagewise-tutorial/08-contribution-workflow-and-ecosystem-evolution.md
index 85d8555b..2fdaf307 100644
--- a/tutorials/stagewise-tutorial/08-contribution-workflow-and-ecosystem-evolution.md
+++ b/tutorials/stagewise-tutorial/08-contribution-workflow-and-ecosystem-evolution.md
@@ -639,7 +639,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Troubleshooting, Security, and Operations](07-troubleshooting-security-and-operations.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/stagewise-tutorial/index.md b/tutorials/stagewise-tutorial/README.md
similarity index 100%
rename from tutorials/stagewise-tutorial/index.md
rename to tutorials/stagewise-tutorial/README.md
diff --git a/tutorials/strands-agents-tutorial/01-getting-started.md b/tutorials/strands-agents-tutorial/01-getting-started.md
index b4c90dab..6b195bdd 100644
--- a/tutorials/strands-agents-tutorial/01-getting-started.md
+++ b/tutorials/strands-agents-tutorial/01-getting-started.md
@@ -641,7 +641,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Agent Loop and Model-Driven Architecture](02-agent-loop-and-model-driven-architecture.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/strands-agents-tutorial/02-agent-loop-and-model-driven-architecture.md b/tutorials/strands-agents-tutorial/02-agent-loop-and-model-driven-architecture.md
index b663346c..5509ed74 100644
--- a/tutorials/strands-agents-tutorial/02-agent-loop-and-model-driven-architecture.md
+++ b/tutorials/strands-agents-tutorial/02-agent-loop-and-model-driven-architecture.md
@@ -626,7 +626,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started](01-getting-started.md)
 - [Next Chapter: Chapter 3: Tools and MCP Integration](03-tools-and-mcp-integration.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/strands-agents-tutorial/03-tools-and-mcp-integration.md b/tutorials/strands-agents-tutorial/03-tools-and-mcp-integration.md
index 3cdf384d..9d30cd73 100644
--- a/tutorials/strands-agents-tutorial/03-tools-and-mcp-integration.md
+++ b/tutorials/strands-agents-tutorial/03-tools-and-mcp-integration.md
@@ -630,7 +630,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Agent Loop and Model-Driven Architecture](02-agent-loop-and-model-driven-architecture.md)
 - [Next Chapter: Chapter 4: Model Providers and Runtime Strategy](04-model-providers-and-runtime-strategy.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/strands-agents-tutorial/04-model-providers-and-runtime-strategy.md b/tutorials/strands-agents-tutorial/04-model-providers-and-runtime-strategy.md
index 169b1bda..bd11f742 100644
--- a/tutorials/strands-agents-tutorial/04-model-providers-and-runtime-strategy.md
+++ b/tutorials/strands-agents-tutorial/04-model-providers-and-runtime-strategy.md
@@ -626,7 +626,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Tools and MCP Integration](03-tools-and-mcp-integration.md)
 - [Next Chapter: Chapter 5: Hooks, State, and Reliability Controls](05-hooks-state-and-reliability-controls.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/strands-agents-tutorial/05-hooks-state-and-reliability-controls.md b/tutorials/strands-agents-tutorial/05-hooks-state-and-reliability-controls.md
index 4d5c6c71..b33c7e9b 100644
--- a/tutorials/strands-agents-tutorial/05-hooks-state-and-reliability-controls.md
+++ b/tutorials/strands-agents-tutorial/05-hooks-state-and-reliability-controls.md
@@ -626,7 +626,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Model Providers and Runtime Strategy](04-model-providers-and-runtime-strategy.md)
 - [Next Chapter: Chapter 6: Multi-Agent and Advanced Patterns](06-multi-agent-and-advanced-patterns.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/strands-agents-tutorial/06-multi-agent-and-advanced-patterns.md b/tutorials/strands-agents-tutorial/06-multi-agent-and-advanced-patterns.md
index 1ea32d41..c4b514fa 100644
--- a/tutorials/strands-agents-tutorial/06-multi-agent-and-advanced-patterns.md
+++ b/tutorials/strands-agents-tutorial/06-multi-agent-and-advanced-patterns.md
@@ -626,7 +626,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Hooks, State, and Reliability Controls](05-hooks-state-and-reliability-controls.md)
 - [Next Chapter: Chapter 7: Deployment and Production Operations](07-deployment-and-production-operations.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/strands-agents-tutorial/07-deployment-and-production-operations.md b/tutorials/strands-agents-tutorial/07-deployment-and-production-operations.md
index 5f0e53b4..e77e4a13 100644
--- a/tutorials/strands-agents-tutorial/07-deployment-and-production-operations.md
+++ b/tutorials/strands-agents-tutorial/07-deployment-and-production-operations.md
@@ -627,7 +627,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Multi-Agent and Advanced Patterns](06-multi-agent-and-advanced-patterns.md)
 - [Next Chapter: Chapter 8: Contribution Workflow and Ecosystem Extensions](08-contribution-workflow-and-ecosystem-extensions.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/strands-agents-tutorial/08-contribution-workflow-and-ecosystem-extensions.md b/tutorials/strands-agents-tutorial/08-contribution-workflow-and-ecosystem-extensions.md
index dc763e9d..86d04d00 100644
--- a/tutorials/strands-agents-tutorial/08-contribution-workflow-and-ecosystem-extensions.md
+++ b/tutorials/strands-agents-tutorial/08-contribution-workflow-and-ecosystem-extensions.md
@@ -627,7 +627,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Deployment and Production Operations](07-deployment-and-production-operations.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/strands-agents-tutorial/index.md b/tutorials/strands-agents-tutorial/README.md
similarity index 100%
rename from tutorials/strands-agents-tutorial/index.md
rename to tutorials/strands-agents-tutorial/README.md
diff --git a/tutorials/supabase-tutorial/01-getting-started.md b/tutorials/supabase-tutorial/01-getting-started.md
index 3b595717..ca11a687 100644
--- a/tutorials/supabase-tutorial/01-getting-started.md
+++ b/tutorials/supabase-tutorial/01-getting-started.md
@@ -679,7 +679,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Database Design & Management](02-database-design.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/supabase-tutorial/02-database-design.md b/tutorials/supabase-tutorial/02-database-design.md
index 8f9eea1f..863aa8c5 100644
--- a/tutorials/supabase-tutorial/02-database-design.md
+++ b/tutorials/supabase-tutorial/02-database-design.md
@@ -754,7 +754,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started with Supabase](01-getting-started.md)
 - [Next Chapter: Chapter 3: Authentication & Authorization](03-authentication.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/supabase-tutorial/03-authentication.md b/tutorials/supabase-tutorial/03-authentication.md
index c86910c5..ceaf87bf 100644
--- a/tutorials/supabase-tutorial/03-authentication.md
+++ b/tutorials/supabase-tutorial/03-authentication.md
@@ -841,7 +841,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Database Design & Management](02-database-design.md)
 - [Next Chapter: Chapter 4: Real-time Features](04-realtime-features.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/supabase-tutorial/04-realtime-features.md b/tutorials/supabase-tutorial/04-realtime-features.md
index 09dbb966..cf233c69 100644
--- a/tutorials/supabase-tutorial/04-realtime-features.md
+++ b/tutorials/supabase-tutorial/04-realtime-features.md
@@ -1015,7 +1015,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Authentication & Authorization](03-authentication.md)
 - [Next Chapter: Chapter 5: Storage & File Management](05-storage-management.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/supabase-tutorial/05-storage-management.md b/tutorials/supabase-tutorial/05-storage-management.md
index 56f686ea..1b280909 100644
--- a/tutorials/supabase-tutorial/05-storage-management.md
+++ b/tutorials/supabase-tutorial/05-storage-management.md
@@ -871,7 +871,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Real-time Features](04-realtime-features.md)
 - [Next Chapter: Chapter 6: Edge Functions](06-edge-functions.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/supabase-tutorial/06-edge-functions.md b/tutorials/supabase-tutorial/06-edge-functions.md
index 73ae95b1..a39aba85 100644
--- a/tutorials/supabase-tutorial/06-edge-functions.md
+++ b/tutorials/supabase-tutorial/06-edge-functions.md
@@ -735,7 +735,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Storage & File Management](05-storage-management.md)
 - [Next Chapter: Chapter 7: Advanced Queries & RLS](07-advanced-queries.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/supabase-tutorial/07-advanced-queries.md b/tutorials/supabase-tutorial/07-advanced-queries.md
index 3700b224..964a7c7b 100644
--- a/tutorials/supabase-tutorial/07-advanced-queries.md
+++ b/tutorials/supabase-tutorial/07-advanced-queries.md
@@ -761,7 +761,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Edge Functions](06-edge-functions.md)
 - [Next Chapter: Chapter 8: Production Deployment](08-production-deployment.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/supabase-tutorial/08-production-deployment.md b/tutorials/supabase-tutorial/08-production-deployment.md
index cb962f75..e1cf517b 100644
--- a/tutorials/supabase-tutorial/08-production-deployment.md
+++ b/tutorials/supabase-tutorial/08-production-deployment.md
@@ -916,7 +916,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Advanced Queries & RLS](07-advanced-queries.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/supabase-tutorial/index.md b/tutorials/supabase-tutorial/README.md
similarity index 100%
rename from tutorials/supabase-tutorial/index.md
rename to tutorials/supabase-tutorial/README.md
diff --git a/tutorials/superagi-tutorial/01-getting-started.md b/tutorials/superagi-tutorial/01-getting-started.md
index 95ea08f0..65de1e9f 100644
--- a/tutorials/superagi-tutorial/01-getting-started.md
+++ b/tutorials/superagi-tutorial/01-getting-started.md
@@ -605,7 +605,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Agent Architecture](02-agent-architecture.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/superagi-tutorial/02-agent-architecture.md b/tutorials/superagi-tutorial/02-agent-architecture.md
index b1a5fcc0..f5319215 100644
--- a/tutorials/superagi-tutorial/02-agent-architecture.md
+++ b/tutorials/superagi-tutorial/02-agent-architecture.md
@@ -571,7 +571,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started with SuperAGI](01-getting-started.md)
 - [Next Chapter: Chapter 3: Tool Integration](03-tool-integration.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/superagi-tutorial/03-tool-integration.md b/tutorials/superagi-tutorial/03-tool-integration.md
index 2b5bc83b..1323348f 100644
--- a/tutorials/superagi-tutorial/03-tool-integration.md
+++ b/tutorials/superagi-tutorial/03-tool-integration.md
@@ -714,7 +714,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Agent Architecture](02-agent-architecture.md)
 - [Next Chapter: Chapter 4: Memory & Learning](04-memory-learning.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/superagi-tutorial/04-memory-learning.md b/tutorials/superagi-tutorial/04-memory-learning.md
index 7e972911..a5d995e6 100644
--- a/tutorials/superagi-tutorial/04-memory-learning.md
+++ b/tutorials/superagi-tutorial/04-memory-learning.md
@@ -718,7 +718,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Tool Integration](03-tool-integration.md)
 - [Next Chapter: Chapter 5: Task Planning](05-task-planning.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/superagi-tutorial/05-task-planning.md b/tutorials/superagi-tutorial/05-task-planning.md
index bf43c0cd..f323150b 100644
--- a/tutorials/superagi-tutorial/05-task-planning.md
+++ b/tutorials/superagi-tutorial/05-task-planning.md
@@ -731,7 +731,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Memory & Learning](04-memory-learning.md)
 - [Next Chapter: Chapter 6: Multi-Agent Systems](06-multi-agent-systems.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/superagi-tutorial/06-multi-agent-systems.md b/tutorials/superagi-tutorial/06-multi-agent-systems.md
index c883eb38..c5918a84 100644
--- a/tutorials/superagi-tutorial/06-multi-agent-systems.md
+++ b/tutorials/superagi-tutorial/06-multi-agent-systems.md
@@ -781,7 +781,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Task Planning](05-task-planning.md)
 - [Next Chapter: Chapter 7: Deployment & Scaling](07-deployment-scaling.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/superagi-tutorial/07-deployment-scaling.md b/tutorials/superagi-tutorial/07-deployment-scaling.md
index 41e83098..e890ec63 100644
--- a/tutorials/superagi-tutorial/07-deployment-scaling.md
+++ b/tutorials/superagi-tutorial/07-deployment-scaling.md
@@ -1058,7 +1058,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Multi-Agent Systems](06-multi-agent-systems.md)
 - [Next Chapter: Chapter 8: Advanced Features](08-advanced-features.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/superagi-tutorial/08-advanced-features.md b/tutorials/superagi-tutorial/08-advanced-features.md
index b344548d..6f44100e 100644
--- a/tutorials/superagi-tutorial/08-advanced-features.md
+++ b/tutorials/superagi-tutorial/08-advanced-features.md
@@ -1138,7 +1138,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Deployment & Scaling](07-deployment-scaling.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/superagi-tutorial/index.md b/tutorials/superagi-tutorial/README.md
similarity index 100%
rename from tutorials/superagi-tutorial/index.md
rename to tutorials/superagi-tutorial/README.md
diff --git a/tutorials/superset-terminal-tutorial/01-getting-started.md b/tutorials/superset-terminal-tutorial/01-getting-started.md
index 70b3d78c..6923883e 100644
--- a/tutorials/superset-terminal-tutorial/01-getting-started.md
+++ b/tutorials/superset-terminal-tutorial/01-getting-started.md
@@ -639,7 +639,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Worktree Isolation and Workspace Model](02-worktree-isolation-and-workspace-model.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/superset-terminal-tutorial/02-worktree-isolation-and-workspace-model.md b/tutorials/superset-terminal-tutorial/02-worktree-isolation-and-workspace-model.md
index 4d3df394..e0e4d6bd 100644
--- a/tutorials/superset-terminal-tutorial/02-worktree-isolation-and-workspace-model.md
+++ b/tutorials/superset-terminal-tutorial/02-worktree-isolation-and-workspace-model.md
@@ -630,7 +630,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started](01-getting-started.md)
 - [Next Chapter: Chapter 3: Workspace Orchestration Lifecycle](03-workspace-orchestration-lifecycle.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/superset-terminal-tutorial/03-workspace-orchestration-lifecycle.md b/tutorials/superset-terminal-tutorial/03-workspace-orchestration-lifecycle.md
index 537ef07e..fe7da541 100644
--- a/tutorials/superset-terminal-tutorial/03-workspace-orchestration-lifecycle.md
+++ b/tutorials/superset-terminal-tutorial/03-workspace-orchestration-lifecycle.md
@@ -632,7 +632,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Worktree Isolation and Workspace Model](02-worktree-isolation-and-workspace-model.md)
 - [Next Chapter: Chapter 4: Multi-Agent Program Compatibility](04-multi-agent-program-compatibility.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/superset-terminal-tutorial/04-multi-agent-program-compatibility.md b/tutorials/superset-terminal-tutorial/04-multi-agent-program-compatibility.md
index 827702c7..fa9600ab 100644
--- a/tutorials/superset-terminal-tutorial/04-multi-agent-program-compatibility.md
+++ b/tutorials/superset-terminal-tutorial/04-multi-agent-program-compatibility.md
@@ -630,7 +630,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Workspace Orchestration Lifecycle](03-workspace-orchestration-lifecycle.md)
 - [Next Chapter: Chapter 5: Monitoring, Diff, and Review Workflow](05-monitoring-diff-and-review-workflow.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/superset-terminal-tutorial/05-monitoring-diff-and-review-workflow.md b/tutorials/superset-terminal-tutorial/05-monitoring-diff-and-review-workflow.md
index 84a3fb8d..bdae1146 100644
--- a/tutorials/superset-terminal-tutorial/05-monitoring-diff-and-review-workflow.md
+++ b/tutorials/superset-terminal-tutorial/05-monitoring-diff-and-review-workflow.md
@@ -629,7 +629,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Multi-Agent Program Compatibility](04-multi-agent-program-compatibility.md)
 - [Next Chapter: Chapter 6: Setup/Teardown Presets and Automation](06-setup-teardown-presets-and-automation.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/superset-terminal-tutorial/06-setup-teardown-presets-and-automation.md b/tutorials/superset-terminal-tutorial/06-setup-teardown-presets-and-automation.md
index 3acfff46..81b87eeb 100644
--- a/tutorials/superset-terminal-tutorial/06-setup-teardown-presets-and-automation.md
+++ b/tutorials/superset-terminal-tutorial/06-setup-teardown-presets-and-automation.md
@@ -639,7 +639,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Monitoring, Diff, and Review Workflow](05-monitoring-diff-and-review-workflow.md)
 - [Next Chapter: Chapter 7: Runtime and Package Architecture](07-runtime-and-package-architecture.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/superset-terminal-tutorial/07-runtime-and-package-architecture.md b/tutorials/superset-terminal-tutorial/07-runtime-and-package-architecture.md
index 4eaabf93..49ba1746 100644
--- a/tutorials/superset-terminal-tutorial/07-runtime-and-package-architecture.md
+++ b/tutorials/superset-terminal-tutorial/07-runtime-and-package-architecture.md
@@ -632,7 +632,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Setup/Teardown Presets and Automation](06-setup-teardown-presets-and-automation.md)
 - [Next Chapter: Chapter 8: Production Team Operations](08-production-team-operations.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/superset-terminal-tutorial/08-production-team-operations.md b/tutorials/superset-terminal-tutorial/08-production-team-operations.md
index 50c07d10..eb8fd473 100644
--- a/tutorials/superset-terminal-tutorial/08-production-team-operations.md
+++ b/tutorials/superset-terminal-tutorial/08-production-team-operations.md
@@ -630,7 +630,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Runtime and Package Architecture](07-runtime-and-package-architecture.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/superset-terminal-tutorial/index.md b/tutorials/superset-terminal-tutorial/README.md
similarity index 100%
rename from tutorials/superset-terminal-tutorial/index.md
rename to tutorials/superset-terminal-tutorial/README.md
diff --git a/tutorials/swarm-tutorial/01-getting-started.md b/tutorials/swarm-tutorial/01-getting-started.md
index 69d6aee8..ff48e103 100644
--- a/tutorials/swarm-tutorial/01-getting-started.md
+++ b/tutorials/swarm-tutorial/01-getting-started.md
@@ -342,7 +342,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Agent Design](02-agent-design.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/swarm-tutorial/02-agent-design.md b/tutorials/swarm-tutorial/02-agent-design.md
index c4395968..df034629 100644
--- a/tutorials/swarm-tutorial/02-agent-design.md
+++ b/tutorials/swarm-tutorial/02-agent-design.md
@@ -544,7 +544,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started with OpenAI Swarm](01-getting-started.md)
 - [Next Chapter: Chapter 3: Function Calling & Tools](03-function-calling.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/swarm-tutorial/03-function-calling.md b/tutorials/swarm-tutorial/03-function-calling.md
index b299da3f..7119db1a 100644
--- a/tutorials/swarm-tutorial/03-function-calling.md
+++ b/tutorials/swarm-tutorial/03-function-calling.md
@@ -623,7 +623,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Agent Design](02-agent-design.md)
 - [Next Chapter: Chapter 4: Routines](04-routines.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/swarm-tutorial/04-routines.md b/tutorials/swarm-tutorial/04-routines.md
index 29c3401a..2b1e6be7 100644
--- a/tutorials/swarm-tutorial/04-routines.md
+++ b/tutorials/swarm-tutorial/04-routines.md
@@ -651,7 +651,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Function Calling & Tools](03-function-calling.md)
 - [Next Chapter: Chapter 5: Agent Handoffs](05-handoffs.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/swarm-tutorial/05-handoffs.md b/tutorials/swarm-tutorial/05-handoffs.md
index 22c0ddde..10950d29 100644
--- a/tutorials/swarm-tutorial/05-handoffs.md
+++ b/tutorials/swarm-tutorial/05-handoffs.md
@@ -709,7 +709,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Routines](04-routines.md)
 - [Next Chapter: Chapter 6: Context Variables](06-context-variables.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/swarm-tutorial/06-context-variables.md b/tutorials/swarm-tutorial/06-context-variables.md
index c31e34f8..7c5e8915 100644
--- a/tutorials/swarm-tutorial/06-context-variables.md
+++ b/tutorials/swarm-tutorial/06-context-variables.md
@@ -645,7 +645,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Agent Handoffs](05-handoffs.md)
 - [Next Chapter: Chapter 7: Multi-Agent Patterns](07-multi-agent-patterns.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/swarm-tutorial/07-multi-agent-patterns.md b/tutorials/swarm-tutorial/07-multi-agent-patterns.md
index 072eeda9..be0560d5 100644
--- a/tutorials/swarm-tutorial/07-multi-agent-patterns.md
+++ b/tutorials/swarm-tutorial/07-multi-agent-patterns.md
@@ -1002,7 +1002,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Context Variables](06-context-variables.md)
 - [Next Chapter: Chapter 8: Production Considerations](08-production.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/swarm-tutorial/08-production.md b/tutorials/swarm-tutorial/08-production.md
index 6ccab474..ae44fccf 100644
--- a/tutorials/swarm-tutorial/08-production.md
+++ b/tutorials/swarm-tutorial/08-production.md
@@ -826,7 +826,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Multi-Agent Patterns](07-multi-agent-patterns.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/swarm-tutorial/index.md b/tutorials/swarm-tutorial/README.md
similarity index 100%
rename from tutorials/swarm-tutorial/index.md
rename to tutorials/swarm-tutorial/README.md
diff --git a/tutorials/swe-agent-tutorial/01-getting-started.md b/tutorials/swe-agent-tutorial/01-getting-started.md
index 95ec48dc..77b51ea4 100644
--- a/tutorials/swe-agent-tutorial/01-getting-started.md
+++ b/tutorials/swe-agent-tutorial/01-getting-started.md
@@ -630,7 +630,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Core Architecture and YAML Configuration](02-core-architecture-and-yaml-configuration.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/swe-agent-tutorial/02-core-architecture-and-yaml-configuration.md b/tutorials/swe-agent-tutorial/02-core-architecture-and-yaml-configuration.md
index 72cd7cd1..69e3e264 100644
--- a/tutorials/swe-agent-tutorial/02-core-architecture-and-yaml-configuration.md
+++ b/tutorials/swe-agent-tutorial/02-core-architecture-and-yaml-configuration.md
@@ -630,7 +630,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started](01-getting-started.md)
 - [Next Chapter: Chapter 3: CLI Workflows and Usage Modes](03-cli-workflows-and-usage-modes.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/swe-agent-tutorial/03-cli-workflows-and-usage-modes.md b/tutorials/swe-agent-tutorial/03-cli-workflows-and-usage-modes.md
index 3d59b757..196a5a2e 100644
--- a/tutorials/swe-agent-tutorial/03-cli-workflows-and-usage-modes.md
+++ b/tutorials/swe-agent-tutorial/03-cli-workflows-and-usage-modes.md
@@ -629,7 +629,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Core Architecture and YAML Configuration](02-core-architecture-and-yaml-configuration.md)
 - [Next Chapter: Chapter 4: Tooling, Environments, and Model Strategy](04-tooling-environments-and-model-strategy.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/swe-agent-tutorial/04-tooling-environments-and-model-strategy.md b/tutorials/swe-agent-tutorial/04-tooling-environments-and-model-strategy.md
index 3c7b7e0a..8680dbfa 100644
--- a/tutorials/swe-agent-tutorial/04-tooling-environments-and-model-strategy.md
+++ b/tutorials/swe-agent-tutorial/04-tooling-environments-and-model-strategy.md
@@ -630,7 +630,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: CLI Workflows and Usage Modes](03-cli-workflows-and-usage-modes.md)
 - [Next Chapter: Chapter 5: Benchmarking and Evaluation Practices](05-benchmarking-and-evaluation-practices.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/swe-agent-tutorial/05-benchmarking-and-evaluation-practices.md b/tutorials/swe-agent-tutorial/05-benchmarking-and-evaluation-practices.md
index d1bd4119..4d84a484 100644
--- a/tutorials/swe-agent-tutorial/05-benchmarking-and-evaluation-practices.md
+++ b/tutorials/swe-agent-tutorial/05-benchmarking-and-evaluation-practices.md
@@ -630,7 +630,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Tooling, Environments, and Model Strategy](04-tooling-environments-and-model-strategy.md)
 - [Next Chapter: Chapter 6: Offensive Security Mode and Specialized Workloads](06-offensive-security-mode-and-specialized-workloads.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/swe-agent-tutorial/06-offensive-security-mode-and-specialized-workloads.md b/tutorials/swe-agent-tutorial/06-offensive-security-mode-and-specialized-workloads.md
index eaaf36af..333ad007 100644
--- a/tutorials/swe-agent-tutorial/06-offensive-security-mode-and-specialized-workloads.md
+++ b/tutorials/swe-agent-tutorial/06-offensive-security-mode-and-specialized-workloads.md
@@ -639,7 +639,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Benchmarking and Evaluation Practices](05-benchmarking-and-evaluation-practices.md)
 - [Next Chapter: Chapter 7: Development and Contribution Workflow](07-development-and-contribution-workflow.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/swe-agent-tutorial/07-development-and-contribution-workflow.md b/tutorials/swe-agent-tutorial/07-development-and-contribution-workflow.md
index c5788fa6..442c3f18 100644
--- a/tutorials/swe-agent-tutorial/07-development-and-contribution-workflow.md
+++ b/tutorials/swe-agent-tutorial/07-development-and-contribution-workflow.md
@@ -630,7 +630,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Offensive Security Mode and Specialized Workloads](06-offensive-security-mode-and-specialized-workloads.md)
 - [Next Chapter: Chapter 8: Production Operations and Governance](08-production-operations-and-governance.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/swe-agent-tutorial/08-production-operations-and-governance.md b/tutorials/swe-agent-tutorial/08-production-operations-and-governance.md
index 91031549..fc880bec 100644
--- a/tutorials/swe-agent-tutorial/08-production-operations-and-governance.md
+++ b/tutorials/swe-agent-tutorial/08-production-operations-and-governance.md
@@ -630,7 +630,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Development and Contribution Workflow](07-development-and-contribution-workflow.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/swe-agent-tutorial/index.md b/tutorials/swe-agent-tutorial/README.md
similarity index 100%
rename from tutorials/swe-agent-tutorial/index.md
rename to tutorials/swe-agent-tutorial/README.md
diff --git a/tutorials/sweep-tutorial/01-getting-started-and-current-product-posture.md b/tutorials/sweep-tutorial/01-getting-started-and-current-product-posture.md
index d25417fd..991ecff8 100644
--- a/tutorials/sweep-tutorial/01-getting-started-and-current-product-posture.md
+++ b/tutorials/sweep-tutorial/01-getting-started-and-current-product-posture.md
@@ -637,7 +637,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Issue to PR Workflow Architecture](02-issue-to-pr-workflow-architecture.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/sweep-tutorial/02-issue-to-pr-workflow-architecture.md b/tutorials/sweep-tutorial/02-issue-to-pr-workflow-architecture.md
index bef077e7..61f429f5 100644
--- a/tutorials/sweep-tutorial/02-issue-to-pr-workflow-architecture.md
+++ b/tutorials/sweep-tutorial/02-issue-to-pr-workflow-architecture.md
@@ -646,7 +646,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started and Current Product Posture](01-getting-started-and-current-product-posture.md)
 - [Next Chapter: Chapter 3: Repository Configuration and Governance](03-repository-configuration-and-governance.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/sweep-tutorial/03-repository-configuration-and-governance.md b/tutorials/sweep-tutorial/03-repository-configuration-and-governance.md
index fa582bc7..1413cdf7 100644
--- a/tutorials/sweep-tutorial/03-repository-configuration-and-governance.md
+++ b/tutorials/sweep-tutorial/03-repository-configuration-and-governance.md
@@ -645,7 +645,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Issue to PR Workflow Architecture](02-issue-to-pr-workflow-architecture.md)
 - [Next Chapter: Chapter 4: Feedback Loops, Review Comments, and CI Repair](04-feedback-loops-review-comments-and-ci-repair.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/sweep-tutorial/04-feedback-loops-review-comments-and-ci-repair.md b/tutorials/sweep-tutorial/04-feedback-loops-review-comments-and-ci-repair.md
index 8d7a167f..b6ea9dc9 100644
--- a/tutorials/sweep-tutorial/04-feedback-loops-review-comments-and-ci-repair.md
+++ b/tutorials/sweep-tutorial/04-feedback-loops-review-comments-and-ci-repair.md
@@ -641,7 +641,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Repository Configuration and Governance](03-repository-configuration-and-governance.md)
 - [Next Chapter: Chapter 5: CLI and Self-Hosted Deployment](05-cli-and-self-hosted-deployment.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/sweep-tutorial/05-cli-and-self-hosted-deployment.md b/tutorials/sweep-tutorial/05-cli-and-self-hosted-deployment.md
index 028805cc..7f47aafa 100644
--- a/tutorials/sweep-tutorial/05-cli-and-self-hosted-deployment.md
+++ b/tutorials/sweep-tutorial/05-cli-and-self-hosted-deployment.md
@@ -642,7 +642,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Feedback Loops, Review Comments, and CI Repair](04-feedback-loops-review-comments-and-ci-repair.md)
 - [Next Chapter: Chapter 6: Search, Planning, and Execution Patterns](06-search-planning-and-execution-patterns.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/sweep-tutorial/06-search-planning-and-execution-patterns.md b/tutorials/sweep-tutorial/06-search-planning-and-execution-patterns.md
index 24385111..d84d3c1d 100644
--- a/tutorials/sweep-tutorial/06-search-planning-and-execution-patterns.md
+++ b/tutorials/sweep-tutorial/06-search-planning-and-execution-patterns.md
@@ -632,7 +632,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: CLI and Self-Hosted Deployment](05-cli-and-self-hosted-deployment.md)
 - [Next Chapter: Chapter 7: Limitations, Risk Controls, and Safe Scope](07-limitations-risk-controls-and-safe-scope.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/sweep-tutorial/07-limitations-risk-controls-and-safe-scope.md b/tutorials/sweep-tutorial/07-limitations-risk-controls-and-safe-scope.md
index ff76139d..114c30b3 100644
--- a/tutorials/sweep-tutorial/07-limitations-risk-controls-and-safe-scope.md
+++ b/tutorials/sweep-tutorial/07-limitations-risk-controls-and-safe-scope.md
@@ -641,7 +641,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Search, Planning, and Execution Patterns](06-search-planning-and-execution-patterns.md)
 - [Next Chapter: Chapter 8: Migration Strategy and Long-Term Operations](08-migration-strategy-and-long-term-operations.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/sweep-tutorial/08-migration-strategy-and-long-term-operations.md b/tutorials/sweep-tutorial/08-migration-strategy-and-long-term-operations.md
index 0c38cc85..050c89e7 100644
--- a/tutorials/sweep-tutorial/08-migration-strategy-and-long-term-operations.md
+++ b/tutorials/sweep-tutorial/08-migration-strategy-and-long-term-operations.md
@@ -642,7 +642,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Limitations, Risk Controls, and Safe Scope](07-limitations-risk-controls-and-safe-scope.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/sweep-tutorial/index.md b/tutorials/sweep-tutorial/README.md
similarity index 100%
rename from tutorials/sweep-tutorial/index.md
rename to tutorials/sweep-tutorial/README.md
diff --git a/tutorials/tabby-tutorial/01-getting-started-and-first-server.md b/tutorials/tabby-tutorial/01-getting-started-and-first-server.md
index 021112b1..ff46d285 100644
--- a/tutorials/tabby-tutorial/01-getting-started-and-first-server.md
+++ b/tutorials/tabby-tutorial/01-getting-started-and-first-server.md
@@ -638,7 +638,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Architecture and Runtime Components](02-architecture-and-runtime-components.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/tabby-tutorial/02-architecture-and-runtime-components.md b/tutorials/tabby-tutorial/02-architecture-and-runtime-components.md
index acf81ebf..96130fa9 100644
--- a/tutorials/tabby-tutorial/02-architecture-and-runtime-components.md
+++ b/tutorials/tabby-tutorial/02-architecture-and-runtime-components.md
@@ -641,7 +641,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started and First Server](01-getting-started-and-first-server.md)
 - [Next Chapter: Chapter 3: Model Serving and Completion Pipeline](03-model-serving-and-completion-pipeline.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/tabby-tutorial/03-model-serving-and-completion-pipeline.md b/tutorials/tabby-tutorial/03-model-serving-and-completion-pipeline.md
index 86f58ee3..36131535 100644
--- a/tutorials/tabby-tutorial/03-model-serving-and-completion-pipeline.md
+++ b/tutorials/tabby-tutorial/03-model-serving-and-completion-pipeline.md
@@ -637,7 +637,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Architecture and Runtime Components](02-architecture-and-runtime-components.md)
 - [Next Chapter: Chapter 4: Answer Engine and Context Indexing](04-answer-engine-and-context-indexing.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/tabby-tutorial/04-answer-engine-and-context-indexing.md b/tutorials/tabby-tutorial/04-answer-engine-and-context-indexing.md
index 503dacb3..306f9ccd 100644
--- a/tutorials/tabby-tutorial/04-answer-engine-and-context-indexing.md
+++ b/tutorials/tabby-tutorial/04-answer-engine-and-context-indexing.md
@@ -638,7 +638,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Model Serving and Completion Pipeline](03-model-serving-and-completion-pipeline.md)
 - [Next Chapter: Chapter 5: Editor Agents and Client Integrations](05-editor-agents-and-client-integrations.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/tabby-tutorial/05-editor-agents-and-client-integrations.md b/tutorials/tabby-tutorial/05-editor-agents-and-client-integrations.md
index 8dcae7d9..f14aea81 100644
--- a/tutorials/tabby-tutorial/05-editor-agents-and-client-integrations.md
+++ b/tutorials/tabby-tutorial/05-editor-agents-and-client-integrations.md
@@ -638,7 +638,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Answer Engine and Context Indexing](04-answer-engine-and-context-indexing.md)
 - [Next Chapter: Chapter 6: Configuration, Security, and Enterprise Controls](06-configuration-security-and-enterprise-controls.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/tabby-tutorial/06-configuration-security-and-enterprise-controls.md b/tutorials/tabby-tutorial/06-configuration-security-and-enterprise-controls.md
index 0bfa7c80..223dae0e 100644
--- a/tutorials/tabby-tutorial/06-configuration-security-and-enterprise-controls.md
+++ b/tutorials/tabby-tutorial/06-configuration-security-and-enterprise-controls.md
@@ -641,7 +641,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Editor Agents and Client Integrations](05-editor-agents-and-client-integrations.md)
 - [Next Chapter: Chapter 7: Operations, Upgrades, and Observability](07-operations-upgrades-and-observability.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/tabby-tutorial/07-operations-upgrades-and-observability.md b/tutorials/tabby-tutorial/07-operations-upgrades-and-observability.md
index 5bc423e9..4b4dda8d 100644
--- a/tutorials/tabby-tutorial/07-operations-upgrades-and-observability.md
+++ b/tutorials/tabby-tutorial/07-operations-upgrades-and-observability.md
@@ -639,7 +639,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Configuration, Security, and Enterprise Controls](06-configuration-security-and-enterprise-controls.md)
 - [Next Chapter: Chapter 8: Contribution, Roadmap, and Team Adoption](08-contribution-roadmap-and-team-adoption.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/tabby-tutorial/08-contribution-roadmap-and-team-adoption.md b/tutorials/tabby-tutorial/08-contribution-roadmap-and-team-adoption.md
index 42d0ba2e..ddf95467 100644
--- a/tutorials/tabby-tutorial/08-contribution-roadmap-and-team-adoption.md
+++ b/tutorials/tabby-tutorial/08-contribution-roadmap-and-team-adoption.md
@@ -637,7 +637,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Operations, Upgrades, and Observability](07-operations-upgrades-and-observability.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/tabby-tutorial/index.md b/tutorials/tabby-tutorial/README.md
similarity index 100%
rename from tutorials/tabby-tutorial/index.md
rename to tutorials/tabby-tutorial/README.md
diff --git a/tutorials/taskade-awesome-vibe-coding-tutorial/01-getting-started-and-list-orientation.md b/tutorials/taskade-awesome-vibe-coding-tutorial/01-getting-started-and-list-orientation.md
index 4baee2cb..9ca5b350 100644
--- a/tutorials/taskade-awesome-vibe-coding-tutorial/01-getting-started-and-list-orientation.md
+++ b/tutorials/taskade-awesome-vibe-coding-tutorial/01-getting-started-and-list-orientation.md
@@ -631,7 +631,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Information Architecture and Taxonomy](02-information-architecture-and-taxonomy.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/taskade-awesome-vibe-coding-tutorial/02-information-architecture-and-taxonomy.md b/tutorials/taskade-awesome-vibe-coding-tutorial/02-information-architecture-and-taxonomy.md
index c3d85be7..2d81a7a2 100644
--- a/tutorials/taskade-awesome-vibe-coding-tutorial/02-information-architecture-and-taxonomy.md
+++ b/tutorials/taskade-awesome-vibe-coding-tutorial/02-information-architecture-and-taxonomy.md
@@ -638,7 +638,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started and List Orientation](01-getting-started-and-list-orientation.md)
 - [Next Chapter: Chapter 3: Taskade Genesis Positioning and Comparison Patterns](03-taskade-genesis-positioning-and-comparison-patterns.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/taskade-awesome-vibe-coding-tutorial/03-taskade-genesis-positioning-and-comparison-patterns.md b/tutorials/taskade-awesome-vibe-coding-tutorial/03-taskade-genesis-positioning-and-comparison-patterns.md
index 3ee48c5c..96b34415 100644
--- a/tutorials/taskade-awesome-vibe-coding-tutorial/03-taskade-genesis-positioning-and-comparison-patterns.md
+++ b/tutorials/taskade-awesome-vibe-coding-tutorial/03-taskade-genesis-positioning-and-comparison-patterns.md
@@ -632,7 +632,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Information Architecture and Taxonomy](02-information-architecture-and-taxonomy.md)
 - [Next Chapter: Chapter 4: AI Coding Tool Categories and Selection Framework](04-ai-coding-tool-categories-and-selection-framework.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/taskade-awesome-vibe-coding-tutorial/04-ai-coding-tool-categories-and-selection-framework.md b/tutorials/taskade-awesome-vibe-coding-tutorial/04-ai-coding-tool-categories-and-selection-framework.md
index 2c2100b7..d9c54191 100644
--- a/tutorials/taskade-awesome-vibe-coding-tutorial/04-ai-coding-tool-categories-and-selection-framework.md
+++ b/tutorials/taskade-awesome-vibe-coding-tutorial/04-ai-coding-tool-categories-and-selection-framework.md
@@ -639,7 +639,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Taskade Genesis Positioning and Comparison Patterns](03-taskade-genesis-positioning-and-comparison-patterns.md)
 - [Next Chapter: Chapter 5: MCP and Agent Ecosystem Coverage](05-mcp-and-agent-ecosystem-coverage.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/taskade-awesome-vibe-coding-tutorial/05-mcp-and-agent-ecosystem-coverage.md b/tutorials/taskade-awesome-vibe-coding-tutorial/05-mcp-and-agent-ecosystem-coverage.md
index dd436d52..4f5618c8 100644
--- a/tutorials/taskade-awesome-vibe-coding-tutorial/05-mcp-and-agent-ecosystem-coverage.md
+++ b/tutorials/taskade-awesome-vibe-coding-tutorial/05-mcp-and-agent-ecosystem-coverage.md
@@ -644,7 +644,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: AI Coding Tool Categories and Selection Framework](04-ai-coding-tool-categories-and-selection-framework.md)
 - [Next Chapter: Chapter 6: Practical Workflows and Learning Paths](06-practical-workflows-and-learning-paths.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/taskade-awesome-vibe-coding-tutorial/06-practical-workflows-and-learning-paths.md b/tutorials/taskade-awesome-vibe-coding-tutorial/06-practical-workflows-and-learning-paths.md
index 057bb5aa..11bc9b94 100644
--- a/tutorials/taskade-awesome-vibe-coding-tutorial/06-practical-workflows-and-learning-paths.md
+++ b/tutorials/taskade-awesome-vibe-coding-tutorial/06-practical-workflows-and-learning-paths.md
@@ -635,7 +635,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: MCP and Agent Ecosystem Coverage](05-mcp-and-agent-ecosystem-coverage.md)
 - [Next Chapter: Chapter 7: Contribution Governance and List Quality Controls](07-contribution-governance-and-list-quality-controls.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/taskade-awesome-vibe-coding-tutorial/07-contribution-governance-and-list-quality-controls.md b/tutorials/taskade-awesome-vibe-coding-tutorial/07-contribution-governance-and-list-quality-controls.md
index 07472e7c..7bce58f3 100644
--- a/tutorials/taskade-awesome-vibe-coding-tutorial/07-contribution-governance-and-list-quality-controls.md
+++ b/tutorials/taskade-awesome-vibe-coding-tutorial/07-contribution-governance-and-list-quality-controls.md
@@ -635,7 +635,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Practical Workflows and Learning Paths](06-practical-workflows-and-learning-paths.md)
 - [Next Chapter: Chapter 8: Market Monitoring and Operations Playbook](08-market-monitoring-and-operations-playbook.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/taskade-awesome-vibe-coding-tutorial/08-market-monitoring-and-operations-playbook.md b/tutorials/taskade-awesome-vibe-coding-tutorial/08-market-monitoring-and-operations-playbook.md
index e6534989..feee1773 100644
--- a/tutorials/taskade-awesome-vibe-coding-tutorial/08-market-monitoring-and-operations-playbook.md
+++ b/tutorials/taskade-awesome-vibe-coding-tutorial/08-market-monitoring-and-operations-playbook.md
@@ -638,7 +638,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Contribution Governance and List Quality Controls](07-contribution-governance-and-list-quality-controls.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/taskade-awesome-vibe-coding-tutorial/index.md b/tutorials/taskade-awesome-vibe-coding-tutorial/README.md
similarity index 100%
rename from tutorials/taskade-awesome-vibe-coding-tutorial/index.md
rename to tutorials/taskade-awesome-vibe-coding-tutorial/README.md
diff --git a/tutorials/taskade-docs-tutorial/01-getting-started-and-docs-entry-points.md b/tutorials/taskade-docs-tutorial/01-getting-started-and-docs-entry-points.md
index b5524913..79edb423 100644
--- a/tutorials/taskade-docs-tutorial/01-getting-started-and-docs-entry-points.md
+++ b/tutorials/taskade-docs-tutorial/01-getting-started-and-docs-entry-points.md
@@ -635,7 +635,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: GitBook Structure, Navigation, and Information Architecture](02-gitbook-structure-navigation-and-information-architecture.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/taskade-docs-tutorial/02-gitbook-structure-navigation-and-information-architecture.md b/tutorials/taskade-docs-tutorial/02-gitbook-structure-navigation-and-information-architecture.md
index 0a97f4cb..7ae0ec4d 100644
--- a/tutorials/taskade-docs-tutorial/02-gitbook-structure-navigation-and-information-architecture.md
+++ b/tutorials/taskade-docs-tutorial/02-gitbook-structure-navigation-and-information-architecture.md
@@ -642,7 +642,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started and Docs Entry Points](01-getting-started-and-docs-entry-points.md)
 - [Next Chapter: Chapter 3: Genesis, Workspace DNA, and Living-System Docs Model](03-genesis-workspace-dna-and-living-systems-doc-model.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/taskade-docs-tutorial/03-genesis-workspace-dna-and-living-systems-doc-model.md b/tutorials/taskade-docs-tutorial/03-genesis-workspace-dna-and-living-systems-doc-model.md
index c2bb1bc2..e1f1e2cb 100644
--- a/tutorials/taskade-docs-tutorial/03-genesis-workspace-dna-and-living-systems-doc-model.md
+++ b/tutorials/taskade-docs-tutorial/03-genesis-workspace-dna-and-living-systems-doc-model.md
@@ -637,7 +637,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: GitBook Structure, Navigation, and Information Architecture](02-gitbook-structure-navigation-and-information-architecture.md)
 - [Next Chapter: Chapter 4: API Documentation Surface and Endpoint Coverage](04-api-documentation-surface-and-endpoint-coverage.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/taskade-docs-tutorial/04-api-documentation-surface-and-endpoint-coverage.md b/tutorials/taskade-docs-tutorial/04-api-documentation-surface-and-endpoint-coverage.md
index 69d9ca10..509c59fc 100644
--- a/tutorials/taskade-docs-tutorial/04-api-documentation-surface-and-endpoint-coverage.md
+++ b/tutorials/taskade-docs-tutorial/04-api-documentation-surface-and-endpoint-coverage.md
@@ -631,7 +631,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Genesis, Workspace DNA, and Living-System Docs Model](03-genesis-workspace-dna-and-living-systems-doc-model.md)
 - [Next Chapter: Chapter 5: AI Agents and Automation Documentation Patterns](05-ai-agents-and-automation-documentation-patterns.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/taskade-docs-tutorial/05-ai-agents-and-automation-documentation-patterns.md b/tutorials/taskade-docs-tutorial/05-ai-agents-and-automation-documentation-patterns.md
index 7574b9d8..1176d30e 100644
--- a/tutorials/taskade-docs-tutorial/05-ai-agents-and-automation-documentation-patterns.md
+++ b/tutorials/taskade-docs-tutorial/05-ai-agents-and-automation-documentation-patterns.md
@@ -642,7 +642,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: API Documentation Surface and Endpoint Coverage](04-api-documentation-surface-and-endpoint-coverage.md)
 - [Next Chapter: Chapter 6: Release Notes, Changelog, and Timeline Operations](06-release-notes-changelog-and-timeline-operations.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/taskade-docs-tutorial/06-release-notes-changelog-and-timeline-operations.md b/tutorials/taskade-docs-tutorial/06-release-notes-changelog-and-timeline-operations.md
index 92f77d79..617c05bb 100644
--- a/tutorials/taskade-docs-tutorial/06-release-notes-changelog-and-timeline-operations.md
+++ b/tutorials/taskade-docs-tutorial/06-release-notes-changelog-and-timeline-operations.md
@@ -638,7 +638,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: AI Agents and Automation Documentation Patterns](05-ai-agents-and-automation-documentation-patterns.md)
 - [Next Chapter: Chapter 7: Doc Quality Governance and Link Hygiene](07-doc-quality-governance-and-link-hygiene.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/taskade-docs-tutorial/07-doc-quality-governance-and-link-hygiene.md b/tutorials/taskade-docs-tutorial/07-doc-quality-governance-and-link-hygiene.md
index fa4b2a46..12e8ba77 100644
--- a/tutorials/taskade-docs-tutorial/07-doc-quality-governance-and-link-hygiene.md
+++ b/tutorials/taskade-docs-tutorial/07-doc-quality-governance-and-link-hygiene.md
@@ -638,7 +638,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Release Notes, Changelog, and Timeline Operations](06-release-notes-changelog-and-timeline-operations.md)
 - [Next Chapter: Chapter 8: Contribution Workflow and Docs Operations Playbook](08-contribution-workflow-and-docs-operations-playbook.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/taskade-docs-tutorial/08-contribution-workflow-and-docs-operations-playbook.md b/tutorials/taskade-docs-tutorial/08-contribution-workflow-and-docs-operations-playbook.md
index 70f61030..dbcd67ac 100644
--- a/tutorials/taskade-docs-tutorial/08-contribution-workflow-and-docs-operations-playbook.md
+++ b/tutorials/taskade-docs-tutorial/08-contribution-workflow-and-docs-operations-playbook.md
@@ -636,7 +636,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Doc Quality Governance and Link Hygiene](07-doc-quality-governance-and-link-hygiene.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/taskade-docs-tutorial/index.md b/tutorials/taskade-docs-tutorial/README.md
similarity index 100%
rename from tutorials/taskade-docs-tutorial/index.md
rename to tutorials/taskade-docs-tutorial/README.md
diff --git a/tutorials/taskade-mcp-tutorial/01-getting-started-and-first-client-connection.md b/tutorials/taskade-mcp-tutorial/01-getting-started-and-first-client-connection.md
index 2fe34228..709d7e4c 100644
--- a/tutorials/taskade-mcp-tutorial/01-getting-started-and-first-client-connection.md
+++ b/tutorials/taskade-mcp-tutorial/01-getting-started-and-first-client-connection.md
@@ -642,7 +642,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Repository Architecture and Package Layout](02-repository-architecture-and-package-layout.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/taskade-mcp-tutorial/02-repository-architecture-and-package-layout.md b/tutorials/taskade-mcp-tutorial/02-repository-architecture-and-package-layout.md
index a4e4758b..1c74eeb8 100644
--- a/tutorials/taskade-mcp-tutorial/02-repository-architecture-and-package-layout.md
+++ b/tutorials/taskade-mcp-tutorial/02-repository-architecture-and-package-layout.md
@@ -640,7 +640,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started and First Client Connection](01-getting-started-and-first-client-connection.md)
 - [Next Chapter: Chapter 3: MCP Server Tools, Auth, and API Surface](03-mcp-server-tools-auth-and-api-surface.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/taskade-mcp-tutorial/03-mcp-server-tools-auth-and-api-surface.md b/tutorials/taskade-mcp-tutorial/03-mcp-server-tools-auth-and-api-surface.md
index 96f49370..ddf5b06d 100644
--- a/tutorials/taskade-mcp-tutorial/03-mcp-server-tools-auth-and-api-surface.md
+++ b/tutorials/taskade-mcp-tutorial/03-mcp-server-tools-auth-and-api-surface.md
@@ -641,7 +641,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Repository Architecture and Package Layout](02-repository-architecture-and-package-layout.md)
 - [Next Chapter: Chapter 4: OpenAPI to MCP Codegen Pipeline](04-openapi-to-mcp-codegen-pipeline.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/taskade-mcp-tutorial/04-openapi-to-mcp-codegen-pipeline.md b/tutorials/taskade-mcp-tutorial/04-openapi-to-mcp-codegen-pipeline.md
index 8d224ebf..5594985d 100644
--- a/tutorials/taskade-mcp-tutorial/04-openapi-to-mcp-codegen-pipeline.md
+++ b/tutorials/taskade-mcp-tutorial/04-openapi-to-mcp-codegen-pipeline.md
@@ -638,7 +638,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: MCP Server Tools, Auth, and API Surface](03-mcp-server-tools-auth-and-api-surface.md)
 - [Next Chapter: Chapter 5: Client Integration Across Claude, Cursor, Windsurf, and n8n](05-client-integration-across-claude-cursor-windsurf-and-n8n.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/taskade-mcp-tutorial/05-client-integration-across-claude-cursor-windsurf-and-n8n.md b/tutorials/taskade-mcp-tutorial/05-client-integration-across-claude-cursor-windsurf-and-n8n.md
index afb2eca8..0a7eb106 100644
--- a/tutorials/taskade-mcp-tutorial/05-client-integration-across-claude-cursor-windsurf-and-n8n.md
+++ b/tutorials/taskade-mcp-tutorial/05-client-integration-across-claude-cursor-windsurf-and-n8n.md
@@ -647,7 +647,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: OpenAPI to MCP Codegen Pipeline](04-openapi-to-mcp-codegen-pipeline.md)
 - [Next Chapter: Chapter 6: Deployment, Configuration, and Operations](06-deployment-configuration-and-operations.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/taskade-mcp-tutorial/06-deployment-configuration-and-operations.md b/tutorials/taskade-mcp-tutorial/06-deployment-configuration-and-operations.md
index 8a59182a..f7f5e4a8 100644
--- a/tutorials/taskade-mcp-tutorial/06-deployment-configuration-and-operations.md
+++ b/tutorials/taskade-mcp-tutorial/06-deployment-configuration-and-operations.md
@@ -641,7 +641,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Client Integration Across Claude, Cursor, Windsurf, and n8n](05-client-integration-across-claude-cursor-windsurf-and-n8n.md)
 - [Next Chapter: Chapter 7: Security Guardrails and Governance](07-security-guardrails-and-governance.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/taskade-mcp-tutorial/07-security-guardrails-and-governance.md b/tutorials/taskade-mcp-tutorial/07-security-guardrails-and-governance.md
index 1e4a81cb..0fa75739 100644
--- a/tutorials/taskade-mcp-tutorial/07-security-guardrails-and-governance.md
+++ b/tutorials/taskade-mcp-tutorial/07-security-guardrails-and-governance.md
@@ -634,7 +634,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Deployment, Configuration, and Operations](06-deployment-configuration-and-operations.md)
 - [Next Chapter: Chapter 8: Contribution, Testing, and Release Operations](08-contribution-testing-and-release-operations.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/taskade-mcp-tutorial/08-contribution-testing-and-release-operations.md b/tutorials/taskade-mcp-tutorial/08-contribution-testing-and-release-operations.md
index 41486853..bd18b436 100644
--- a/tutorials/taskade-mcp-tutorial/08-contribution-testing-and-release-operations.md
+++ b/tutorials/taskade-mcp-tutorial/08-contribution-testing-and-release-operations.md
@@ -638,7 +638,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Security Guardrails and Governance](07-security-guardrails-and-governance.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/taskade-mcp-tutorial/index.md b/tutorials/taskade-mcp-tutorial/README.md
similarity index 100%
rename from tutorials/taskade-mcp-tutorial/index.md
rename to tutorials/taskade-mcp-tutorial/README.md
diff --git a/tutorials/taskade-tutorial/01-getting-started.md b/tutorials/taskade-tutorial/01-getting-started.md
index bfd8cacf..596f90ba 100644
--- a/tutorials/taskade-tutorial/01-getting-started.md
+++ b/tutorials/taskade-tutorial/01-getting-started.md
@@ -614,7 +614,7 @@ Use these sources in this order for first-setup accuracy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Living DNA Architecture](02-living-dna-architecture.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/taskade-tutorial/02-living-dna-architecture.md b/tutorials/taskade-tutorial/02-living-dna-architecture.md
index adede45a..dd0d04d9 100644
--- a/tutorials/taskade-tutorial/02-living-dna-architecture.md
+++ b/tutorials/taskade-tutorial/02-living-dna-architecture.md
@@ -652,7 +652,7 @@ Primary references for this chapter:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started with Taskade](01-getting-started.md)
 - [Next Chapter: Chapter 3: AI Agents & Intelligence](03-ai-agents-intelligence.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/taskade-tutorial/03-ai-agents-intelligence.md b/tutorials/taskade-tutorial/03-ai-agents-intelligence.md
index ff875435..84093140 100644
--- a/tutorials/taskade-tutorial/03-ai-agents-intelligence.md
+++ b/tutorials/taskade-tutorial/03-ai-agents-intelligence.md
@@ -628,7 +628,7 @@ Use these references for agent-specific validation:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Living DNA Architecture](02-living-dna-architecture.md)
 - [Next Chapter: Chapter 4: Smart Automations](04-smart-automations.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/taskade-tutorial/04-smart-automations.md b/tutorials/taskade-tutorial/04-smart-automations.md
index 712711a0..306db795 100644
--- a/tutorials/taskade-tutorial/04-smart-automations.md
+++ b/tutorials/taskade-tutorial/04-smart-automations.md
@@ -622,7 +622,7 @@ Automation references to read alongside this chapter:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: AI Agents & Intelligence](03-ai-agents-intelligence.md)
 - [Next Chapter: Chapter 5: Genesis App Builder](05-genesis-app-builder.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/taskade-tutorial/05-genesis-app-builder.md b/tutorials/taskade-tutorial/05-genesis-app-builder.md
index dac49745..7fdd2632 100644
--- a/tutorials/taskade-tutorial/05-genesis-app-builder.md
+++ b/tutorials/taskade-tutorial/05-genesis-app-builder.md
@@ -614,7 +614,7 @@ Use these Genesis-specific references:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Smart Automations](04-smart-automations.md)
 - [Next Chapter: Chapter 6: Multi-Agent Collaboration](06-multi-agent-collaboration.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/taskade-tutorial/06-multi-agent-collaboration.md b/tutorials/taskade-tutorial/06-multi-agent-collaboration.md
index 357f022c..e4f1b7f3 100644
--- a/tutorials/taskade-tutorial/06-multi-agent-collaboration.md
+++ b/tutorials/taskade-tutorial/06-multi-agent-collaboration.md
@@ -661,7 +661,7 @@ Best references for this chapter:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Genesis App Builder](05-genesis-app-builder.md)
 - [Next Chapter: Chapter 7: Enterprise Features & Advanced Workflows](07-enterprise-features.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/taskade-tutorial/07-enterprise-features.md b/tutorials/taskade-tutorial/07-enterprise-features.md
index 71c4b635..9e888d8f 100644
--- a/tutorials/taskade-tutorial/07-enterprise-features.md
+++ b/tutorials/taskade-tutorial/07-enterprise-features.md
@@ -947,7 +947,7 @@ Key enterprise references:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Multi-Agent Collaboration](06-multi-agent-collaboration.md)
 - [Next Chapter: Chapter 8: Production Deployment](08-production-deployment.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/taskade-tutorial/08-production-deployment.md b/tutorials/taskade-tutorial/08-production-deployment.md
index ede093b6..0ae9ee9b 100644
--- a/tutorials/taskade-tutorial/08-production-deployment.md
+++ b/tutorials/taskade-tutorial/08-production-deployment.md
@@ -718,7 +718,7 @@ Production references to monitor continuously:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Enterprise Features & Advanced Workflows](07-enterprise-features.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/taskade-tutorial/index.md b/tutorials/taskade-tutorial/README.md
similarity index 100%
rename from tutorials/taskade-tutorial/index.md
rename to tutorials/taskade-tutorial/README.md
diff --git a/tutorials/teable-database-platform/01-system-overview.md b/tutorials/teable-database-platform/01-system-overview.md
index e76b72b7..6259317c 100644
--- a/tutorials/teable-database-platform/01-system-overview.md
+++ b/tutorials/teable-database-platform/01-system-overview.md
@@ -882,7 +882,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Database Architecture](02-database-architecture.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/teable-database-platform/02-database-architecture.md b/tutorials/teable-database-platform/02-database-architecture.md
index d7fc9671..698727b5 100644
--- a/tutorials/teable-database-platform/02-database-architecture.md
+++ b/tutorials/teable-database-platform/02-database-architecture.md
@@ -1010,7 +1010,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: System Overview](01-system-overview.md)
 - [Next Chapter: Teable Development Environment Setup](03-setup-environment.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/teable-database-platform/03-setup-environment.md b/tutorials/teable-database-platform/03-setup-environment.md
index 9ab76a04..c78265a7 100644
--- a/tutorials/teable-database-platform/03-setup-environment.md
+++ b/tutorials/teable-database-platform/03-setup-environment.md
@@ -613,7 +613,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Database Architecture](02-database-architecture.md)
 - [Next Chapter: Chapter 4: API Development](04-api-development.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/teable-database-platform/04-api-development.md b/tutorials/teable-database-platform/04-api-development.md
index c754ec72..221d468d 100644
--- a/tutorials/teable-database-platform/04-api-development.md
+++ b/tutorials/teable-database-platform/04-api-development.md
@@ -81,7 +81,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Teable Development Environment Setup](03-setup-environment.md)
 - [Next Chapter: Chapter 5: Realtime Collaboration](05-realtime-collaboration.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/teable-database-platform/05-realtime-collaboration.md b/tutorials/teable-database-platform/05-realtime-collaboration.md
index 982b7df4..2bf406e6 100644
--- a/tutorials/teable-database-platform/05-realtime-collaboration.md
+++ b/tutorials/teable-database-platform/05-realtime-collaboration.md
@@ -81,7 +81,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: API Development](04-api-development.md)
 - [Next Chapter: Chapter 6: Query System](06-query-system.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/teable-database-platform/06-query-system.md b/tutorials/teable-database-platform/06-query-system.md
index 697ea888..3422ea02 100644
--- a/tutorials/teable-database-platform/06-query-system.md
+++ b/tutorials/teable-database-platform/06-query-system.md
@@ -80,7 +80,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Realtime Collaboration](05-realtime-collaboration.md)
 - [Next Chapter: Chapter 7: Frontend Architecture](07-frontend-architecture.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/teable-database-platform/07-frontend-architecture.md b/tutorials/teable-database-platform/07-frontend-architecture.md
index 19178d47..23fbd034 100644
--- a/tutorials/teable-database-platform/07-frontend-architecture.md
+++ b/tutorials/teable-database-platform/07-frontend-architecture.md
@@ -81,7 +81,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Query System](06-query-system.md)
 - [Next Chapter: Chapter 8: Production Deployment](08-production-deployment.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/teable-database-platform/08-production-deployment.md b/tutorials/teable-database-platform/08-production-deployment.md
index 63b2e269..c8fa0c69 100644
--- a/tutorials/teable-database-platform/08-production-deployment.md
+++ b/tutorials/teable-database-platform/08-production-deployment.md
@@ -41,7 +41,7 @@ Track:
 You now have full Teable coverage from architecture to production-grade deployment and operations.
 
 Related:
-- [Teable Index](index.md)
+- [Teable Index](README.md)
 
 ## What Problem Does This Solve?
 
@@ -83,7 +83,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Frontend Architecture](07-frontend-architecture.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/teable-database-platform/README.md b/tutorials/teable-database-platform/README.md
index 73d46caa..5a468c58 100644
--- a/tutorials/teable-database-platform/README.md
+++ b/tutorials/teable-database-platform/README.md
@@ -1,38 +1,136 @@
-# Teable Database Platform Deep Dive
+---
+layout: default
+title: "Teable Database Platform"
+nav_order: 42
+has_children: true
+format_version: v2
+---
+
+# Teable: Deep Dive Tutorial
+
+> **Project**: [Teable](https://github.com/teableio/teable) — A high-performance, multi-dimensional database platform built on PostgreSQL with real-time collaboration.
+
+[![Stars](https://img.shields.io/github/stars/teableio/teable?style=social)](https://github.com/teableio/teable)
+[![License: AGPL v3](https://img.shields.io/badge/License-AGPL_v3-blue.svg)](https://www.gnu.org/licenses/agpl-3.0)
+[![TypeScript](https://img.shields.io/badge/TypeScript-Next.js-blue)](https://github.com/teableio/teable)
+
+## Why This Track Matters
+
+Teable combines the power of PostgreSQL with a collaborative spreadsheet interface, offering teams a scalable no-code database that doesn't sacrifice data integrity or query performance for usability.
+
+This track focuses on:
+- building on PostgreSQL with Teable's schema management and query system
+- implementing real-time collaborative editing with WebSocket consistency
+- generating and consuming REST and GraphQL APIs from Teable tables
+- deploying and scaling Teable with Docker for production workloads
+
+## What Is Teable?
+
+Teable is a high-performance, multi-dimensional database platform that combines the power of PostgreSQL with a spreadsheet-like UI. It supports real-time collaboration, complex data relationships, and advanced querying — offering a scalable alternative to Airtable built on proven database technology.
+
+| Feature | Description |
+|---------|-------------|
+| **PostgreSQL Native** | Built directly on PostgreSQL for performance and reliability |
+| **Multi-Dimensional** | Grid, kanban, gallery, form, and calendar views |
+| **Real-Time Collab** | WebSocket-based collaborative editing with conflict resolution |
+| **Advanced Queries** | Complex filters, aggregations, cross-table relationships |
+| **REST & GraphQL** | Auto-generated APIs with schema validation |
+| **Self-Hosted** | Docker deployment with horizontal scaling |
+
+## Mental Model
 
-A focused architecture walkthrough of Teable's multi-dimensional database platform.
+```mermaid
+graph TB
+    subgraph Frontend["Next.js Frontend"]
+        GRID[Grid View]
+        KANBAN[Kanban View]
+        FORM[Form View]
+        GALLERY[Gallery View]
+    end
 
-## Current Status
+    subgraph Backend["NestJS Backend"]
+        API[REST / GraphQL API]
+        REALTIME[WebSocket Engine]
+        QUERY[Query Builder]
+        AUTH[Auth & RBAC]
+    end
 
-Core chapter set is now published.
+    subgraph Data["Data Layer"]
+        PG[(PostgreSQL)]
+        REDIS[(Redis Cache)]
+        S3[Object Storage]
+    end
 
-| Item | Status |
-|:-----|:-------|
-| Published chapter docs | 8 |
-| Canonical entry point | [index.md](index.md) |
+    Frontend --> Backend
+    Backend --> Data
+```
 
-## Published Chapters
+## Chapter Guide
 
-| Chapter | File | Focus |
-|:--------|:-----|:------|
-| 1 | [01-system-overview.md](01-system-overview.md) | System overview and architectural principles |
-| 2 | [02-database-architecture.md](02-database-architecture.md) | Core database architecture |
-| 3 | [03-setup-environment.md](03-setup-environment.md) | Local development setup |
-| 4 | [04-api-development.md](04-api-development.md) | REST/GraphQL API layer design |
-| 5 | [05-realtime-collaboration.md](05-realtime-collaboration.md) | Multi-user realtime consistency model |
-| 6 | [06-query-system.md](06-query-system.md) | View-driven query and optimization |
-| 7 | [07-frontend-architecture.md](07-frontend-architecture.md) | Frontend rendering and state boundaries |
-| 8 | [08-production-deployment.md](08-production-deployment.md) | Production hardening and observability |
+| Chapter | Topic | What You'll Learn |
+|---------|-------|-------------------|
+| [1. System Overview](01-system-overview.md) | Architecture | Teable's position in the database ecosystem |
+| [2. Database Architecture](02-database-architecture.md) | Data Layer | PostgreSQL schema, storage engines, indexing |
+| [3. Setup Environment](03-setup-environment.md) | Development | Complete development stack configuration |
+| [4. API Development](04-api-development.md) | API Layer | REST/GraphQL contracts and validation patterns |
+| [5. Realtime Collaboration](05-realtime-collaboration.md) | Collaboration | WebSocket events and multi-user consistency |
+| [6. Query System](06-query-system.md) | Querying | View-driven query planning and optimization |
+| [7. Frontend Architecture](07-frontend-architecture.md) | UI Layer | Dynamic view rendering and state boundaries |
+| [8. Production Deployment](08-production-deployment.md) | Operations | Deployment hardening, scaling, and observability |
 
-## Suggested Reading Order
+## Tech Stack
 
-1. Start with [index.md](index.md).
-2. Read chapters [1](01-system-overview.md) through [8](08-production-deployment.md) in order.
+| Component | Technology |
+|-----------|-----------|
+| **Backend** | NestJS, TypeScript |
+| **Frontend** | Next.js, React |
+| **Database** | PostgreSQL |
+| **Cache** | Redis |
+| **Real-Time** | WebSockets |
+| **Deployment** | Docker Compose |
 
-## Upstream Project
+---
 
-- Teable repository: <https://github.com/teableio/teable>
+Ready to begin? Start with [Chapter 1: System Overview](01-system-overview.md).
 
 ---
 
-Part of [Awesome Code Docs](../../README.md)
+*Built with insights from the [Teable repository](https://github.com/teableio/teable) and community documentation.*
+
+## Navigation & Backlinks
+
+- [Start Here: Chapter 1: System Overview](01-system-overview.md)
+- [Back to Main Catalog](../../README.md#-tutorial-catalog)
+- [Browse A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
+- [Search by Intent](../../discoverability/query-hub.md)
+- [Explore Category Hubs](../../README.md#category-hubs)
+
+## Full Chapter Map
+
+1. [Chapter 1: System Overview](01-system-overview.md)
+2. [Chapter 2: Database Architecture](02-database-architecture.md)
+3. [Teable Development Environment Setup](03-setup-environment.md)
+4. [Chapter 4: API Development](04-api-development.md)
+5. [Chapter 5: Realtime Collaboration](05-realtime-collaboration.md)
+6. [Chapter 6: Query System](06-query-system.md)
+7. [Chapter 7: Frontend Architecture](07-frontend-architecture.md)
+8. [Chapter 8: Production Deployment](08-production-deployment.md)
+
+## Current Snapshot (auto-updated)
+
+- repository: [teableio/teable](https://github.com/teableio/teable)
+- stars: about **15K**
+- project positioning: high-performance PostgreSQL-native no-code database with real-time collaboration
+
+## What You Will Learn
+
+- how Teable uses PostgreSQL as its native storage layer with schema management and indexing
+- how WebSocket-based real-time collaboration handles multi-user consistency
+- how the query system translates view-driven filters into optimized PostgreSQL queries
+- how to deploy and scale Teable with Docker Compose for production environments
+
+## Source References
+
+- [Teable](https://github.com/teableio/teable)
+
+*Generated by [AI Codebase Knowledge Builder](https://github.com/The-Pocket/Tutorial-Codebase-Knowledge)*
diff --git a/tutorials/teable-database-platform/index.md b/tutorials/teable-database-platform/index.md
deleted file mode 100644
index 5a468c58..00000000
--- a/tutorials/teable-database-platform/index.md
+++ /dev/null
@@ -1,136 +0,0 @@
----
-layout: default
-title: "Teable Database Platform"
-nav_order: 42
-has_children: true
-format_version: v2
----
-
-# Teable: Deep Dive Tutorial
-
-> **Project**: [Teable](https://github.com/teableio/teable) — A high-performance, multi-dimensional database platform built on PostgreSQL with real-time collaboration.
-
-[![Stars](https://img.shields.io/github/stars/teableio/teable?style=social)](https://github.com/teableio/teable)
-[![License: AGPL v3](https://img.shields.io/badge/License-AGPL_v3-blue.svg)](https://www.gnu.org/licenses/agpl-3.0)
-[![TypeScript](https://img.shields.io/badge/TypeScript-Next.js-blue)](https://github.com/teableio/teable)
-
-## Why This Track Matters
-
-Teable combines the power of PostgreSQL with a collaborative spreadsheet interface, offering teams a scalable no-code database that doesn't sacrifice data integrity or query performance for usability.
-
-This track focuses on:
-- building on PostgreSQL with Teable's schema management and query system
-- implementing real-time collaborative editing with WebSocket consistency
-- generating and consuming REST and GraphQL APIs from Teable tables
-- deploying and scaling Teable with Docker for production workloads
-
-## What Is Teable?
-
-Teable is a high-performance, multi-dimensional database platform that combines the power of PostgreSQL with a spreadsheet-like UI. It supports real-time collaboration, complex data relationships, and advanced querying — offering a scalable alternative to Airtable built on proven database technology.
-
-| Feature | Description |
-|---------|-------------|
-| **PostgreSQL Native** | Built directly on PostgreSQL for performance and reliability |
-| **Multi-Dimensional** | Grid, kanban, gallery, form, and calendar views |
-| **Real-Time Collab** | WebSocket-based collaborative editing with conflict resolution |
-| **Advanced Queries** | Complex filters, aggregations, cross-table relationships |
-| **REST & GraphQL** | Auto-generated APIs with schema validation |
-| **Self-Hosted** | Docker deployment with horizontal scaling |
-
-## Mental Model
-
-```mermaid
-graph TB
-    subgraph Frontend["Next.js Frontend"]
-        GRID[Grid View]
-        KANBAN[Kanban View]
-        FORM[Form View]
-        GALLERY[Gallery View]
-    end
-
-    subgraph Backend["NestJS Backend"]
-        API[REST / GraphQL API]
-        REALTIME[WebSocket Engine]
-        QUERY[Query Builder]
-        AUTH[Auth & RBAC]
-    end
-
-    subgraph Data["Data Layer"]
-        PG[(PostgreSQL)]
-        REDIS[(Redis Cache)]
-        S3[Object Storage]
-    end
-
-    Frontend --> Backend
-    Backend --> Data
-```
-
-## Chapter Guide
-
-| Chapter | Topic | What You'll Learn |
-|---------|-------|-------------------|
-| [1. System Overview](01-system-overview.md) | Architecture | Teable's position in the database ecosystem |
-| [2. Database Architecture](02-database-architecture.md) | Data Layer | PostgreSQL schema, storage engines, indexing |
-| [3. Setup Environment](03-setup-environment.md) | Development | Complete development stack configuration |
-| [4. API Development](04-api-development.md) | API Layer | REST/GraphQL contracts and validation patterns |
-| [5. Realtime Collaboration](05-realtime-collaboration.md) | Collaboration | WebSocket events and multi-user consistency |
-| [6. Query System](06-query-system.md) | Querying | View-driven query planning and optimization |
-| [7. Frontend Architecture](07-frontend-architecture.md) | UI Layer | Dynamic view rendering and state boundaries |
-| [8. Production Deployment](08-production-deployment.md) | Operations | Deployment hardening, scaling, and observability |
-
-## Tech Stack
-
-| Component | Technology |
-|-----------|-----------|
-| **Backend** | NestJS, TypeScript |
-| **Frontend** | Next.js, React |
-| **Database** | PostgreSQL |
-| **Cache** | Redis |
-| **Real-Time** | WebSockets |
-| **Deployment** | Docker Compose |
-
----
-
-Ready to begin? Start with [Chapter 1: System Overview](01-system-overview.md).
-
----
-
-*Built with insights from the [Teable repository](https://github.com/teableio/teable) and community documentation.*
-
-## Navigation & Backlinks
-
-- [Start Here: Chapter 1: System Overview](01-system-overview.md)
-- [Back to Main Catalog](../../README.md#-tutorial-catalog)
-- [Browse A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
-- [Search by Intent](../../discoverability/query-hub.md)
-- [Explore Category Hubs](../../README.md#category-hubs)
-
-## Full Chapter Map
-
-1. [Chapter 1: System Overview](01-system-overview.md)
-2. [Chapter 2: Database Architecture](02-database-architecture.md)
-3. [Teable Development Environment Setup](03-setup-environment.md)
-4. [Chapter 4: API Development](04-api-development.md)
-5. [Chapter 5: Realtime Collaboration](05-realtime-collaboration.md)
-6. [Chapter 6: Query System](06-query-system.md)
-7. [Chapter 7: Frontend Architecture](07-frontend-architecture.md)
-8. [Chapter 8: Production Deployment](08-production-deployment.md)
-
-## Current Snapshot (auto-updated)
-
-- repository: [teableio/teable](https://github.com/teableio/teable)
-- stars: about **15K**
-- project positioning: high-performance PostgreSQL-native no-code database with real-time collaboration
-
-## What You Will Learn
-
-- how Teable uses PostgreSQL as its native storage layer with schema management and indexing
-- how WebSocket-based real-time collaboration handles multi-user consistency
-- how the query system translates view-driven filters into optimized PostgreSQL queries
-- how to deploy and scale Teable with Docker Compose for production environments
-
-## Source References
-
-- [Teable](https://github.com/teableio/teable)
-
-*Generated by [AI Codebase Knowledge Builder](https://github.com/The-Pocket/Tutorial-Codebase-Knowledge)*
diff --git a/tutorials/tiktoken-tutorial/01-getting-started.md b/tutorials/tiktoken-tutorial/01-getting-started.md
index 11b89eb4..43043ab9 100644
--- a/tutorials/tiktoken-tutorial/01-getting-started.md
+++ b/tutorials/tiktoken-tutorial/01-getting-started.md
@@ -104,7 +104,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Tokenization Mechanics](02-tokenization-mechanics.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/tiktoken-tutorial/02-tokenization-mechanics.md b/tutorials/tiktoken-tutorial/02-tokenization-mechanics.md
index cd7c94ea..ffc3cc08 100644
--- a/tutorials/tiktoken-tutorial/02-tokenization-mechanics.md
+++ b/tutorials/tiktoken-tutorial/02-tokenization-mechanics.md
@@ -94,7 +94,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started](01-getting-started.md)
 - [Next Chapter: Chapter 3: Practical Applications](03-practical-applications.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/tiktoken-tutorial/03-practical-applications.md b/tutorials/tiktoken-tutorial/03-practical-applications.md
index f50b0b68..86881c27 100644
--- a/tutorials/tiktoken-tutorial/03-practical-applications.md
+++ b/tutorials/tiktoken-tutorial/03-practical-applications.md
@@ -98,7 +98,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Tokenization Mechanics](02-tokenization-mechanics.md)
 - [Next Chapter: Chapter 4: Educational Module](04-educational-module.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/tiktoken-tutorial/04-educational-module.md b/tutorials/tiktoken-tutorial/04-educational-module.md
index 2ecc10b4..ded0c249 100644
--- a/tutorials/tiktoken-tutorial/04-educational-module.md
+++ b/tutorials/tiktoken-tutorial/04-educational-module.md
@@ -89,7 +89,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Practical Applications](03-practical-applications.md)
 - [Next Chapter: Chapter 5: Optimization Strategies](05-optimization-strategies.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/tiktoken-tutorial/05-optimization-strategies.md b/tutorials/tiktoken-tutorial/05-optimization-strategies.md
index d9812176..671da773 100644
--- a/tutorials/tiktoken-tutorial/05-optimization-strategies.md
+++ b/tutorials/tiktoken-tutorial/05-optimization-strategies.md
@@ -104,7 +104,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Educational Module](04-educational-module.md)
 - [Next Chapter: Chapter 6: ChatML and Tool Call Accounting](06-chatml-and-tool-calls.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/tiktoken-tutorial/06-chatml-and-tool-calls.md b/tutorials/tiktoken-tutorial/06-chatml-and-tool-calls.md
index 98bfc2b6..c11c98b6 100644
--- a/tutorials/tiktoken-tutorial/06-chatml-and-tool-calls.md
+++ b/tutorials/tiktoken-tutorial/06-chatml-and-tool-calls.md
@@ -96,7 +96,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Optimization Strategies](05-optimization-strategies.md)
 - [Next Chapter: Chapter 7: Multilingual Tokenization](07-multilingual-tokenization.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/tiktoken-tutorial/07-multilingual-tokenization.md b/tutorials/tiktoken-tutorial/07-multilingual-tokenization.md
index a72dfb35..ef98468a 100644
--- a/tutorials/tiktoken-tutorial/07-multilingual-tokenization.md
+++ b/tutorials/tiktoken-tutorial/07-multilingual-tokenization.md
@@ -92,7 +92,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: ChatML and Tool Call Accounting](06-chatml-and-tool-calls.md)
 - [Next Chapter: Chapter 8: Cost Governance](08-cost-governance.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/tiktoken-tutorial/08-cost-governance.md b/tutorials/tiktoken-tutorial/08-cost-governance.md
index 2d584c83..7a566bd2 100644
--- a/tutorials/tiktoken-tutorial/08-cost-governance.md
+++ b/tutorials/tiktoken-tutorial/08-cost-governance.md
@@ -94,7 +94,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Multilingual Tokenization](07-multilingual-tokenization.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/tiktoken-tutorial/index.md b/tutorials/tiktoken-tutorial/README.md
similarity index 100%
rename from tutorials/tiktoken-tutorial/index.md
rename to tutorials/tiktoken-tutorial/README.md
diff --git a/tutorials/turborepo-tutorial/01-getting-started.md b/tutorials/turborepo-tutorial/01-getting-started.md
index 07dc256a..21229e56 100644
--- a/tutorials/turborepo-tutorial/01-getting-started.md
+++ b/tutorials/turborepo-tutorial/01-getting-started.md
@@ -421,7 +421,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Workspace Configuration](02-workspace-configuration.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/turborepo-tutorial/02-workspace-configuration.md b/tutorials/turborepo-tutorial/02-workspace-configuration.md
index e42e3dd6..c82fdc8a 100644
--- a/tutorials/turborepo-tutorial/02-workspace-configuration.md
+++ b/tutorials/turborepo-tutorial/02-workspace-configuration.md
@@ -312,7 +312,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started with Turborepo](01-getting-started.md)
 - [Next Chapter: Chapter 3: Task Pipelines](03-task-pipelines.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/turborepo-tutorial/03-task-pipelines.md b/tutorials/turborepo-tutorial/03-task-pipelines.md
index bff9cccc..de5d270a 100644
--- a/tutorials/turborepo-tutorial/03-task-pipelines.md
+++ b/tutorials/turborepo-tutorial/03-task-pipelines.md
@@ -717,7 +717,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Workspace Configuration](02-workspace-configuration.md)
 - [Next Chapter: Chapter 4: Caching Strategies](04-caching-strategies.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/turborepo-tutorial/04-caching-strategies.md b/tutorials/turborepo-tutorial/04-caching-strategies.md
index 27d26e18..dc76aa06 100644
--- a/tutorials/turborepo-tutorial/04-caching-strategies.md
+++ b/tutorials/turborepo-tutorial/04-caching-strategies.md
@@ -556,7 +556,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Task Pipelines](03-task-pipelines.md)
 - [Next Chapter: Chapter 5: Remote Caching](05-remote-caching.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/turborepo-tutorial/05-remote-caching.md b/tutorials/turborepo-tutorial/05-remote-caching.md
index fb0b31ab..4e46d2ac 100644
--- a/tutorials/turborepo-tutorial/05-remote-caching.md
+++ b/tutorials/turborepo-tutorial/05-remote-caching.md
@@ -621,7 +621,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Caching Strategies](04-caching-strategies.md)
 - [Next Chapter: Chapter 6: Dependency Management](06-dependency-management.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/turborepo-tutorial/06-dependency-management.md b/tutorials/turborepo-tutorial/06-dependency-management.md
index 7e1bcc0e..6fd79103 100644
--- a/tutorials/turborepo-tutorial/06-dependency-management.md
+++ b/tutorials/turborepo-tutorial/06-dependency-management.md
@@ -646,7 +646,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Remote Caching](05-remote-caching.md)
 - [Next Chapter: Chapter 7: CI/CD Integration](07-cicd-integration.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/turborepo-tutorial/07-cicd-integration.md b/tutorials/turborepo-tutorial/07-cicd-integration.md
index 045ec7c1..2c2f09dd 100644
--- a/tutorials/turborepo-tutorial/07-cicd-integration.md
+++ b/tutorials/turborepo-tutorial/07-cicd-integration.md
@@ -846,7 +846,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Dependency Management](06-dependency-management.md)
 - [Next Chapter: Chapter 8: Performance Optimization](08-performance-optimization.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/turborepo-tutorial/08-performance-optimization.md b/tutorials/turborepo-tutorial/08-performance-optimization.md
index 02445a9c..5277cb49 100644
--- a/tutorials/turborepo-tutorial/08-performance-optimization.md
+++ b/tutorials/turborepo-tutorial/08-performance-optimization.md
@@ -812,7 +812,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: CI/CD Integration](07-cicd-integration.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/turborepo-tutorial/index.md b/tutorials/turborepo-tutorial/README.md
similarity index 100%
rename from tutorials/turborepo-tutorial/index.md
rename to tutorials/turborepo-tutorial/README.md
diff --git a/tutorials/use-mcp-tutorial/01-getting-started-and-archived-context.md b/tutorials/use-mcp-tutorial/01-getting-started-and-archived-context.md
index 6df6ce8f..d43ce04e 100644
--- a/tutorials/use-mcp-tutorial/01-getting-started-and-archived-context.md
+++ b/tutorials/use-mcp-tutorial/01-getting-started-and-archived-context.md
@@ -640,7 +640,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Hook Architecture and Connection Lifecycle](02-hook-architecture-and-connection-lifecycle.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/use-mcp-tutorial/02-hook-architecture-and-connection-lifecycle.md b/tutorials/use-mcp-tutorial/02-hook-architecture-and-connection-lifecycle.md
index aef159cd..039d39d8 100644
--- a/tutorials/use-mcp-tutorial/02-hook-architecture-and-connection-lifecycle.md
+++ b/tutorials/use-mcp-tutorial/02-hook-architecture-and-connection-lifecycle.md
@@ -637,7 +637,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started and Archived Context](01-getting-started-and-archived-context.md)
 - [Next Chapter: Chapter 3: Authentication, OAuth Callback, and Storage](03-authentication-oauth-callback-and-storage.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/use-mcp-tutorial/03-authentication-oauth-callback-and-storage.md b/tutorials/use-mcp-tutorial/03-authentication-oauth-callback-and-storage.md
index 0ed46968..98f2a9e8 100644
--- a/tutorials/use-mcp-tutorial/03-authentication-oauth-callback-and-storage.md
+++ b/tutorials/use-mcp-tutorial/03-authentication-oauth-callback-and-storage.md
@@ -635,7 +635,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Hook Architecture and Connection Lifecycle](02-hook-architecture-and-connection-lifecycle.md)
 - [Next Chapter: Chapter 4: Tools, Resources, Prompts, and Client Operations](04-tools-resources-prompts-and-client-operations.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/use-mcp-tutorial/04-tools-resources-prompts-and-client-operations.md b/tutorials/use-mcp-tutorial/04-tools-resources-prompts-and-client-operations.md
index 1a0a354b..1346e5ae 100644
--- a/tutorials/use-mcp-tutorial/04-tools-resources-prompts-and-client-operations.md
+++ b/tutorials/use-mcp-tutorial/04-tools-resources-prompts-and-client-operations.md
@@ -636,7 +636,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Authentication, OAuth Callback, and Storage](03-authentication-oauth-callback-and-storage.md)
 - [Next Chapter: Chapter 5: Transport, Retry, and Reconnect Strategy](05-transport-retry-and-reconnect-strategy.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/use-mcp-tutorial/05-transport-retry-and-reconnect-strategy.md b/tutorials/use-mcp-tutorial/05-transport-retry-and-reconnect-strategy.md
index 36d528de..c6c132c5 100644
--- a/tutorials/use-mcp-tutorial/05-transport-retry-and-reconnect-strategy.md
+++ b/tutorials/use-mcp-tutorial/05-transport-retry-and-reconnect-strategy.md
@@ -635,7 +635,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Tools, Resources, Prompts, and Client Operations](04-tools-resources-prompts-and-client-operations.md)
 - [Next Chapter: Chapter 6: React Integration Patterns: Chat UI and Inspector](06-react-integration-patterns-chat-ui-and-inspector.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/use-mcp-tutorial/06-react-integration-patterns-chat-ui-and-inspector.md b/tutorials/use-mcp-tutorial/06-react-integration-patterns-chat-ui-and-inspector.md
index bd631cb2..e4378fe8 100644
--- a/tutorials/use-mcp-tutorial/06-react-integration-patterns-chat-ui-and-inspector.md
+++ b/tutorials/use-mcp-tutorial/06-react-integration-patterns-chat-ui-and-inspector.md
@@ -636,7 +636,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Transport, Retry, and Reconnect Strategy](05-transport-retry-and-reconnect-strategy.md)
 - [Next Chapter: Chapter 7: Testing, Debugging, and Integration Servers](07-testing-debugging-and-integration-servers.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/use-mcp-tutorial/07-testing-debugging-and-integration-servers.md b/tutorials/use-mcp-tutorial/07-testing-debugging-and-integration-servers.md
index 5746be92..4f064efe 100644
--- a/tutorials/use-mcp-tutorial/07-testing-debugging-and-integration-servers.md
+++ b/tutorials/use-mcp-tutorial/07-testing-debugging-and-integration-servers.md
@@ -635,7 +635,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: React Integration Patterns: Chat UI and Inspector](06-react-integration-patterns-chat-ui-and-inspector.md)
 - [Next Chapter: Chapter 8: Maintenance Risk, Migration, and Production Guidance](08-maintenance-risk-migration-and-production-guidance.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/use-mcp-tutorial/08-maintenance-risk-migration-and-production-guidance.md b/tutorials/use-mcp-tutorial/08-maintenance-risk-migration-and-production-guidance.md
index 6a5ebbb4..4fed3e17 100644
--- a/tutorials/use-mcp-tutorial/08-maintenance-risk-migration-and-production-guidance.md
+++ b/tutorials/use-mcp-tutorial/08-maintenance-risk-migration-and-production-guidance.md
@@ -38,7 +38,7 @@ This chapter covers long-term operations for teams relying on an archived upstre
 
 You now have a pragmatic operating and migration strategy for `use-mcp` deployments.
 
-Return to the [use-mcp Tutorial index](index.md).
+Return to the [use-mcp Tutorial index](README.md).
 
 ## Depth Expansion Playbook
 
@@ -638,7 +638,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Testing, Debugging, and Integration Servers](07-testing-debugging-and-integration-servers.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/use-mcp-tutorial/index.md b/tutorials/use-mcp-tutorial/README.md
similarity index 100%
rename from tutorials/use-mcp-tutorial/index.md
rename to tutorials/use-mcp-tutorial/README.md
diff --git a/tutorials/vercel-ai-tutorial/01-getting-started.md b/tutorials/vercel-ai-tutorial/01-getting-started.md
index c4bc9747..0cc78c75 100644
--- a/tutorials/vercel-ai-tutorial/01-getting-started.md
+++ b/tutorials/vercel-ai-tutorial/01-getting-started.md
@@ -625,7 +625,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Text Generation](02-text-generation.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/vercel-ai-tutorial/02-text-generation.md b/tutorials/vercel-ai-tutorial/02-text-generation.md
index a9aff7af..ff262cbe 100644
--- a/tutorials/vercel-ai-tutorial/02-text-generation.md
+++ b/tutorials/vercel-ai-tutorial/02-text-generation.md
@@ -634,7 +634,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started with Vercel AI](01-getting-started.md)
 - [Next Chapter: Chapter 3: Streaming Responses](03-streaming-responses.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/vercel-ai-tutorial/03-streaming-responses.md b/tutorials/vercel-ai-tutorial/03-streaming-responses.md
index bd2fb0d1..7062c1c2 100644
--- a/tutorials/vercel-ai-tutorial/03-streaming-responses.md
+++ b/tutorials/vercel-ai-tutorial/03-streaming-responses.md
@@ -717,7 +717,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Text Generation](02-text-generation.md)
 - [Next Chapter: Chapter 4: Function Calling](04-function-calling.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/vercel-ai-tutorial/04-function-calling.md b/tutorials/vercel-ai-tutorial/04-function-calling.md
index 821f4838..66b367f1 100644
--- a/tutorials/vercel-ai-tutorial/04-function-calling.md
+++ b/tutorials/vercel-ai-tutorial/04-function-calling.md
@@ -634,7 +634,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Streaming Responses](03-streaming-responses.md)
 - [Next Chapter: Chapter 5: Structured Outputs](05-structured-outputs.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/vercel-ai-tutorial/05-structured-outputs.md b/tutorials/vercel-ai-tutorial/05-structured-outputs.md
index be208c97..828d2d9b 100644
--- a/tutorials/vercel-ai-tutorial/05-structured-outputs.md
+++ b/tutorials/vercel-ai-tutorial/05-structured-outputs.md
@@ -723,7 +723,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Function Calling](04-function-calling.md)
 - [Next Chapter: Chapter 6: React Integration](06-react-integration.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/vercel-ai-tutorial/06-react-integration.md b/tutorials/vercel-ai-tutorial/06-react-integration.md
index 3b7505a7..cdf07c41 100644
--- a/tutorials/vercel-ai-tutorial/06-react-integration.md
+++ b/tutorials/vercel-ai-tutorial/06-react-integration.md
@@ -930,7 +930,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Structured Outputs](05-structured-outputs.md)
 - [Next Chapter: Chapter 7: Next.js Applications](07-nextjs-applications.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/vercel-ai-tutorial/07-nextjs-applications.md b/tutorials/vercel-ai-tutorial/07-nextjs-applications.md
index dd104142..384f800f 100644
--- a/tutorials/vercel-ai-tutorial/07-nextjs-applications.md
+++ b/tutorials/vercel-ai-tutorial/07-nextjs-applications.md
@@ -1051,7 +1051,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: React Integration](06-react-integration.md)
 - [Next Chapter: Chapter 8: Production Deployment](08-production-deployment.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/vercel-ai-tutorial/08-production-deployment.md b/tutorials/vercel-ai-tutorial/08-production-deployment.md
index 7719cf5b..f06a0a61 100644
--- a/tutorials/vercel-ai-tutorial/08-production-deployment.md
+++ b/tutorials/vercel-ai-tutorial/08-production-deployment.md
@@ -941,7 +941,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Next.js Applications](07-nextjs-applications.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/vercel-ai-tutorial/index.md b/tutorials/vercel-ai-tutorial/README.md
similarity index 100%
rename from tutorials/vercel-ai-tutorial/index.md
rename to tutorials/vercel-ai-tutorial/README.md
diff --git a/tutorials/vibe-kanban-tutorial/01-getting-started.md b/tutorials/vibe-kanban-tutorial/01-getting-started.md
index ed71a07f..8851ac07 100644
--- a/tutorials/vibe-kanban-tutorial/01-getting-started.md
+++ b/tutorials/vibe-kanban-tutorial/01-getting-started.md
@@ -630,7 +630,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Orchestration Architecture](02-orchestration-architecture.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/vibe-kanban-tutorial/02-orchestration-architecture.md b/tutorials/vibe-kanban-tutorial/02-orchestration-architecture.md
index 321c6d25..c05d2b33 100644
--- a/tutorials/vibe-kanban-tutorial/02-orchestration-architecture.md
+++ b/tutorials/vibe-kanban-tutorial/02-orchestration-architecture.md
@@ -629,7 +629,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started](01-getting-started.md)
 - [Next Chapter: Chapter 3: Multi-Agent Execution Strategies](03-multi-agent-execution-strategies.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/vibe-kanban-tutorial/03-multi-agent-execution-strategies.md b/tutorials/vibe-kanban-tutorial/03-multi-agent-execution-strategies.md
index b3fa9937..4e3056de 100644
--- a/tutorials/vibe-kanban-tutorial/03-multi-agent-execution-strategies.md
+++ b/tutorials/vibe-kanban-tutorial/03-multi-agent-execution-strategies.md
@@ -630,7 +630,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Orchestration Architecture](02-orchestration-architecture.md)
 - [Next Chapter: Chapter 4: MCP and Configuration Control](04-mcp-and-configuration-control.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/vibe-kanban-tutorial/04-mcp-and-configuration-control.md b/tutorials/vibe-kanban-tutorial/04-mcp-and-configuration-control.md
index dbe1a910..b111ac5b 100644
--- a/tutorials/vibe-kanban-tutorial/04-mcp-and-configuration-control.md
+++ b/tutorials/vibe-kanban-tutorial/04-mcp-and-configuration-control.md
@@ -631,7 +631,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Multi-Agent Execution Strategies](03-multi-agent-execution-strategies.md)
 - [Next Chapter: Chapter 5: Review and Quality Gates](05-review-and-quality-gates.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/vibe-kanban-tutorial/05-review-and-quality-gates.md b/tutorials/vibe-kanban-tutorial/05-review-and-quality-gates.md
index 894458aa..b5a8318c 100644
--- a/tutorials/vibe-kanban-tutorial/05-review-and-quality-gates.md
+++ b/tutorials/vibe-kanban-tutorial/05-review-and-quality-gates.md
@@ -630,7 +630,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: MCP and Configuration Control](04-mcp-and-configuration-control.md)
 - [Next Chapter: Chapter 6: Remote Access and Self-Hosting](06-remote-access-and-self-hosting.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/vibe-kanban-tutorial/06-remote-access-and-self-hosting.md b/tutorials/vibe-kanban-tutorial/06-remote-access-and-self-hosting.md
index 8916ecdf..d38dd063 100644
--- a/tutorials/vibe-kanban-tutorial/06-remote-access-and-self-hosting.md
+++ b/tutorials/vibe-kanban-tutorial/06-remote-access-and-self-hosting.md
@@ -625,7 +625,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Review and Quality Gates](05-review-and-quality-gates.md)
 - [Next Chapter: Chapter 7: Development and Source Build Workflow](07-development-and-source-build-workflow.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/vibe-kanban-tutorial/07-development-and-source-build-workflow.md b/tutorials/vibe-kanban-tutorial/07-development-and-source-build-workflow.md
index e5b58df3..a0394993 100644
--- a/tutorials/vibe-kanban-tutorial/07-development-and-source-build-workflow.md
+++ b/tutorials/vibe-kanban-tutorial/07-development-and-source-build-workflow.md
@@ -629,7 +629,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Remote Access and Self-Hosting](06-remote-access-and-self-hosting.md)
 - [Next Chapter: Chapter 8: Production Operations and Governance](08-production-operations-and-governance.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/vibe-kanban-tutorial/08-production-operations-and-governance.md b/tutorials/vibe-kanban-tutorial/08-production-operations-and-governance.md
index f84dec83..cbc4dd5f 100644
--- a/tutorials/vibe-kanban-tutorial/08-production-operations-and-governance.md
+++ b/tutorials/vibe-kanban-tutorial/08-production-operations-and-governance.md
@@ -627,7 +627,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Development and Source Build Workflow](07-development-and-source-build-workflow.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/vibe-kanban-tutorial/index.md b/tutorials/vibe-kanban-tutorial/README.md
similarity index 100%
rename from tutorials/vibe-kanban-tutorial/index.md
rename to tutorials/vibe-kanban-tutorial/README.md
diff --git a/tutorials/vibesdk-tutorial/01-getting-started-and-deployment-paths.md b/tutorials/vibesdk-tutorial/01-getting-started-and-deployment-paths.md
index 62187fe9..63df1e05 100644
--- a/tutorials/vibesdk-tutorial/01-getting-started-and-deployment-paths.md
+++ b/tutorials/vibesdk-tutorial/01-getting-started-and-deployment-paths.md
@@ -639,7 +639,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: System Architecture](02-system-architecture.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/vibesdk-tutorial/02-system-architecture.md b/tutorials/vibesdk-tutorial/02-system-architecture.md
index f070ada6..e7f00c54 100644
--- a/tutorials/vibesdk-tutorial/02-system-architecture.md
+++ b/tutorials/vibesdk-tutorial/02-system-architecture.md
@@ -640,7 +640,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started and Deployment Paths](01-getting-started-and-deployment-paths.md)
 - [Next Chapter: Chapter 3: AI Pipeline and Phase Engine](03-ai-pipeline-and-phase-engine.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/vibesdk-tutorial/03-ai-pipeline-and-phase-engine.md b/tutorials/vibesdk-tutorial/03-ai-pipeline-and-phase-engine.md
index 88c2d1d9..2aff57fe 100644
--- a/tutorials/vibesdk-tutorial/03-ai-pipeline-and-phase-engine.md
+++ b/tutorials/vibesdk-tutorial/03-ai-pipeline-and-phase-engine.md
@@ -636,7 +636,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: System Architecture](02-system-architecture.md)
 - [Next Chapter: Chapter 4: Sandbox and Preview Runtime](04-sandbox-and-preview-runtime.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/vibesdk-tutorial/04-sandbox-and-preview-runtime.md b/tutorials/vibesdk-tutorial/04-sandbox-and-preview-runtime.md
index 6a11bea7..23fe58fc 100644
--- a/tutorials/vibesdk-tutorial/04-sandbox-and-preview-runtime.md
+++ b/tutorials/vibesdk-tutorial/04-sandbox-and-preview-runtime.md
@@ -631,7 +631,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: AI Pipeline and Phase Engine](03-ai-pipeline-and-phase-engine.md)
 - [Next Chapter: Chapter 5: Data Layer and Persistence](05-data-layer-and-persistence.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/vibesdk-tutorial/05-data-layer-and-persistence.md b/tutorials/vibesdk-tutorial/05-data-layer-and-persistence.md
index 1d5df11b..4405da53 100644
--- a/tutorials/vibesdk-tutorial/05-data-layer-and-persistence.md
+++ b/tutorials/vibesdk-tutorial/05-data-layer-and-persistence.md
@@ -631,7 +631,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Sandbox and Preview Runtime](04-sandbox-and-preview-runtime.md)
 - [Next Chapter: Chapter 6: API, SDK, and Integrations](06-api-sdk-and-integrations.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/vibesdk-tutorial/06-api-sdk-and-integrations.md b/tutorials/vibesdk-tutorial/06-api-sdk-and-integrations.md
index a7e857b6..90571582 100644
--- a/tutorials/vibesdk-tutorial/06-api-sdk-and-integrations.md
+++ b/tutorials/vibesdk-tutorial/06-api-sdk-and-integrations.md
@@ -636,7 +636,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Data Layer and Persistence](05-data-layer-and-persistence.md)
 - [Next Chapter: Chapter 7: Security, Auth, and Governance](07-security-auth-and-governance.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/vibesdk-tutorial/07-security-auth-and-governance.md b/tutorials/vibesdk-tutorial/07-security-auth-and-governance.md
index 039cd460..f832476d 100644
--- a/tutorials/vibesdk-tutorial/07-security-auth-and-governance.md
+++ b/tutorials/vibesdk-tutorial/07-security-auth-and-governance.md
@@ -627,7 +627,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: API, SDK, and Integrations](06-api-sdk-and-integrations.md)
 - [Next Chapter: Chapter 8: Production Operations and Scaling](08-production-operations-and-scaling.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/vibesdk-tutorial/08-production-operations-and-scaling.md b/tutorials/vibesdk-tutorial/08-production-operations-and-scaling.md
index d7af458a..79756daa 100644
--- a/tutorials/vibesdk-tutorial/08-production-operations-and-scaling.md
+++ b/tutorials/vibesdk-tutorial/08-production-operations-and-scaling.md
@@ -86,7 +86,7 @@ Run these in CI and again for release candidates with production-like bindings.
 
 You now have an operations blueprint for running VibeSDK as a production platform with measurable reliability and governance.
 
-Next: return to the [VibeSDK Tutorial index](index.md).
+Next: return to the [VibeSDK Tutorial index](README.md).
 
 ## Depth Expansion Playbook
 
@@ -633,7 +633,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Security, Auth, and Governance](07-security-auth-and-governance.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/vibesdk-tutorial/index.md b/tutorials/vibesdk-tutorial/README.md
similarity index 100%
rename from tutorials/vibesdk-tutorial/index.md
rename to tutorials/vibesdk-tutorial/README.md
diff --git a/tutorials/vllm-tutorial/01-getting-started.md b/tutorials/vllm-tutorial/01-getting-started.md
index 82cd15b9..0081fd7d 100644
--- a/tutorials/vllm-tutorial/01-getting-started.md
+++ b/tutorials/vllm-tutorial/01-getting-started.md
@@ -597,7 +597,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Model Loading and Management](02-model-loading.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/vllm-tutorial/02-model-loading.md b/tutorials/vllm-tutorial/02-model-loading.md
index 08b9dcaa..269603a5 100644
--- a/tutorials/vllm-tutorial/02-model-loading.md
+++ b/tutorials/vllm-tutorial/02-model-loading.md
@@ -801,7 +801,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started with vLLM](01-getting-started.md)
 - [Next Chapter: Chapter 3: Basic Inference - Text Generation and Sampling](03-basic-inference.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/vllm-tutorial/03-basic-inference.md b/tutorials/vllm-tutorial/03-basic-inference.md
index 9e7c6e27..ca012985 100644
--- a/tutorials/vllm-tutorial/03-basic-inference.md
+++ b/tutorials/vllm-tutorial/03-basic-inference.md
@@ -666,7 +666,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Model Loading and Management](02-model-loading.md)
 - [Next Chapter: Chapter 4: Advanced Features - Streaming, Tool Calling, and Multi-Modal](04-advanced-features.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/vllm-tutorial/04-advanced-features.md b/tutorials/vllm-tutorial/04-advanced-features.md
index 54368e78..4243fcc8 100644
--- a/tutorials/vllm-tutorial/04-advanced-features.md
+++ b/tutorials/vllm-tutorial/04-advanced-features.md
@@ -830,7 +830,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Basic Inference - Text Generation and Sampling](03-basic-inference.md)
 - [Next Chapter: Chapter 5: Performance Optimization - Maximizing Throughput and Efficiency](05-performance-optimization.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/vllm-tutorial/05-performance-optimization.md b/tutorials/vllm-tutorial/05-performance-optimization.md
index 448758d8..d73b2ab5 100644
--- a/tutorials/vllm-tutorial/05-performance-optimization.md
+++ b/tutorials/vllm-tutorial/05-performance-optimization.md
@@ -935,7 +935,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Advanced Features - Streaming, Tool Calling, and Multi-Modal](04-advanced-features.md)
 - [Next Chapter: Chapter 6: Distributed Inference - Scaling Across GPUs and Nodes](06-distributed-inference.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/vllm-tutorial/06-distributed-inference.md b/tutorials/vllm-tutorial/06-distributed-inference.md
index 4c536d4a..965e6681 100644
--- a/tutorials/vllm-tutorial/06-distributed-inference.md
+++ b/tutorials/vllm-tutorial/06-distributed-inference.md
@@ -994,7 +994,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Performance Optimization - Maximizing Throughput and Efficiency](05-performance-optimization.md)
 - [Next Chapter: Chapter 7: Production Deployment - Serving vLLM at Scale](07-production-deployment.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/vllm-tutorial/07-production-deployment.md b/tutorials/vllm-tutorial/07-production-deployment.md
index debcce3f..f68b179c 100644
--- a/tutorials/vllm-tutorial/07-production-deployment.md
+++ b/tutorials/vllm-tutorial/07-production-deployment.md
@@ -1323,7 +1323,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Distributed Inference - Scaling Across GPUs and Nodes](06-distributed-inference.md)
 - [Next Chapter: Chapter 8: Monitoring & Scaling - Production Operations at Scale](08-monitoring-scaling.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/vllm-tutorial/08-monitoring-scaling.md b/tutorials/vllm-tutorial/08-monitoring-scaling.md
index c70a8484..d318a633 100644
--- a/tutorials/vllm-tutorial/08-monitoring-scaling.md
+++ b/tutorials/vllm-tutorial/08-monitoring-scaling.md
@@ -1119,7 +1119,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Production Deployment - Serving vLLM at Scale](07-production-deployment.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/vllm-tutorial/index.md b/tutorials/vllm-tutorial/README.md
similarity index 100%
rename from tutorials/vllm-tutorial/index.md
rename to tutorials/vllm-tutorial/README.md
diff --git a/tutorials/whisper-cpp-tutorial/01-getting-started.md b/tutorials/whisper-cpp-tutorial/01-getting-started.md
index 8fb5c63b..19815b9e 100644
--- a/tutorials/whisper-cpp-tutorial/01-getting-started.md
+++ b/tutorials/whisper-cpp-tutorial/01-getting-started.md
@@ -363,7 +363,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Audio Processing Fundamentals](02-audio-processing.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/whisper-cpp-tutorial/02-audio-processing.md b/tutorials/whisper-cpp-tutorial/02-audio-processing.md
index 364bcaaa..cbd10c11 100644
--- a/tutorials/whisper-cpp-tutorial/02-audio-processing.md
+++ b/tutorials/whisper-cpp-tutorial/02-audio-processing.md
@@ -555,7 +555,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started with Whisper.cpp](01-getting-started.md)
 - [Next Chapter: Chapter 3: Model Architecture & GGML](03-model-architecture.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/whisper-cpp-tutorial/03-model-architecture.md b/tutorials/whisper-cpp-tutorial/03-model-architecture.md
index 6879f2f1..efc5fac4 100644
--- a/tutorials/whisper-cpp-tutorial/03-model-architecture.md
+++ b/tutorials/whisper-cpp-tutorial/03-model-architecture.md
@@ -616,7 +616,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Audio Processing Fundamentals](02-audio-processing.md)
 - [Next Chapter: Chapter 4: Core API & Usage Patterns](04-core-api.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/whisper-cpp-tutorial/04-core-api.md b/tutorials/whisper-cpp-tutorial/04-core-api.md
index b5aff211..e0596e60 100644
--- a/tutorials/whisper-cpp-tutorial/04-core-api.md
+++ b/tutorials/whisper-cpp-tutorial/04-core-api.md
@@ -809,7 +809,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Model Architecture & GGML](03-model-architecture.md)
 - [Next Chapter: Chapter 5: Real-Time Streaming](05-real-time-streaming.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/whisper-cpp-tutorial/05-real-time-streaming.md b/tutorials/whisper-cpp-tutorial/05-real-time-streaming.md
index 8dfbdb91..95c25871 100644
--- a/tutorials/whisper-cpp-tutorial/05-real-time-streaming.md
+++ b/tutorials/whisper-cpp-tutorial/05-real-time-streaming.md
@@ -890,7 +890,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Core API & Usage Patterns](04-core-api.md)
 - [Next Chapter: Chapter 6: Language & Translation](06-language-translation.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/whisper-cpp-tutorial/06-language-translation.md b/tutorials/whisper-cpp-tutorial/06-language-translation.md
index 5409718d..6b579f4e 100644
--- a/tutorials/whisper-cpp-tutorial/06-language-translation.md
+++ b/tutorials/whisper-cpp-tutorial/06-language-translation.md
@@ -829,7 +829,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Real-Time Streaming](05-real-time-streaming.md)
 - [Next Chapter: Chapter 7: Platform Integration](07-platform-integration.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/whisper-cpp-tutorial/07-platform-integration.md b/tutorials/whisper-cpp-tutorial/07-platform-integration.md
index a845e628..befbe41f 100644
--- a/tutorials/whisper-cpp-tutorial/07-platform-integration.md
+++ b/tutorials/whisper-cpp-tutorial/07-platform-integration.md
@@ -918,7 +918,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Language & Translation](06-language-translation.md)
 - [Next Chapter: Chapter 8: Production Deployment](08-deployment-production.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/whisper-cpp-tutorial/08-deployment-production.md b/tutorials/whisper-cpp-tutorial/08-deployment-production.md
index 0c6641dd..c057b1e0 100644
--- a/tutorials/whisper-cpp-tutorial/08-deployment-production.md
+++ b/tutorials/whisper-cpp-tutorial/08-deployment-production.md
@@ -1057,7 +1057,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Platform Integration](07-platform-integration.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/whisper-cpp-tutorial/index.md b/tutorials/whisper-cpp-tutorial/README.md
similarity index 100%
rename from tutorials/whisper-cpp-tutorial/index.md
rename to tutorials/whisper-cpp-tutorial/README.md
diff --git a/tutorials/wshobson-agents-tutorial/01-getting-started.md b/tutorials/wshobson-agents-tutorial/01-getting-started.md
index 4968cde6..5e16469b 100644
--- a/tutorials/wshobson-agents-tutorial/01-getting-started.md
+++ b/tutorials/wshobson-agents-tutorial/01-getting-started.md
@@ -640,7 +640,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Next Chapter: Chapter 2: Marketplace Architecture and Plugin Structure](02-marketplace-architecture-and-plugin-structure.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/wshobson-agents-tutorial/02-marketplace-architecture-and-plugin-structure.md b/tutorials/wshobson-agents-tutorial/02-marketplace-architecture-and-plugin-structure.md
index dd616aa0..e9b801c1 100644
--- a/tutorials/wshobson-agents-tutorial/02-marketplace-architecture-and-plugin-structure.md
+++ b/tutorials/wshobson-agents-tutorial/02-marketplace-architecture-and-plugin-structure.md
@@ -637,7 +637,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 1: Getting Started](01-getting-started.md)
 - [Next Chapter: Chapter 3: Installation and Plugin Selection Strategy](03-installation-and-plugin-selection-strategy.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/wshobson-agents-tutorial/03-installation-and-plugin-selection-strategy.md b/tutorials/wshobson-agents-tutorial/03-installation-and-plugin-selection-strategy.md
index f47f3d22..d1d1a6f2 100644
--- a/tutorials/wshobson-agents-tutorial/03-installation-and-plugin-selection-strategy.md
+++ b/tutorials/wshobson-agents-tutorial/03-installation-and-plugin-selection-strategy.md
@@ -634,7 +634,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 2: Marketplace Architecture and Plugin Structure](02-marketplace-architecture-and-plugin-structure.md)
 - [Next Chapter: Chapter 4: Commands, Natural Language, and Workflow Orchestration](04-commands-natural-language-and-workflow-orchestration.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/wshobson-agents-tutorial/04-commands-natural-language-and-workflow-orchestration.md b/tutorials/wshobson-agents-tutorial/04-commands-natural-language-and-workflow-orchestration.md
index bc8cf786..cf685ea1 100644
--- a/tutorials/wshobson-agents-tutorial/04-commands-natural-language-and-workflow-orchestration.md
+++ b/tutorials/wshobson-agents-tutorial/04-commands-natural-language-and-workflow-orchestration.md
@@ -634,7 +634,7 @@ Suggested trace strategy:
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 3: Installation and Plugin Selection Strategy](03-installation-and-plugin-selection-strategy.md)
 - [Next Chapter: Chapter 5: Agents, Skills, and Model Tier Strategy](05-agents-skills-and-model-tier-strategy.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/wshobson-agents-tutorial/05-agents-skills-and-model-tier-strategy.md b/tutorials/wshobson-agents-tutorial/05-agents-skills-and-model-tier-strategy.md
index 0e31bd0d..79e5b648 100644
--- a/tutorials/wshobson-agents-tutorial/05-agents-skills-and-model-tier-strategy.md
+++ b/tutorials/wshobson-agents-tutorial/05-agents-skills-and-model-tier-strategy.md
@@ -634,7 +634,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 4: Commands, Natural Language, and Workflow Orchestration](04-commands-natural-language-and-workflow-orchestration.md)
 - [Next Chapter: Chapter 6: Multi-Agent Team Patterns and Production Workflows](06-multi-agent-team-patterns-and-production-workflows.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/wshobson-agents-tutorial/06-multi-agent-team-patterns-and-production-workflows.md b/tutorials/wshobson-agents-tutorial/06-multi-agent-team-patterns-and-production-workflows.md
index 0fa37abe..357cf6c0 100644
--- a/tutorials/wshobson-agents-tutorial/06-multi-agent-team-patterns-and-production-workflows.md
+++ b/tutorials/wshobson-agents-tutorial/06-multi-agent-team-patterns-and-production-workflows.md
@@ -638,7 +638,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 5: Agents, Skills, and Model Tier Strategy](05-agents-skills-and-model-tier-strategy.md)
 - [Next Chapter: Chapter 7: Governance, Safety, and Operational Best Practices](07-governance-safety-and-operational-best-practices.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/wshobson-agents-tutorial/07-governance-safety-and-operational-best-practices.md b/tutorials/wshobson-agents-tutorial/07-governance-safety-and-operational-best-practices.md
index e3fc50bb..dc470aa2 100644
--- a/tutorials/wshobson-agents-tutorial/07-governance-safety-and-operational-best-practices.md
+++ b/tutorials/wshobson-agents-tutorial/07-governance-safety-and-operational-best-practices.md
@@ -632,7 +632,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 6: Multi-Agent Team Patterns and Production Workflows](06-multi-agent-team-patterns-and-production-workflows.md)
 - [Next Chapter: Chapter 8: Contribution Workflow and Plugin Authoring Patterns](08-contribution-workflow-and-plugin-authoring-patterns.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
diff --git a/tutorials/wshobson-agents-tutorial/08-contribution-workflow-and-plugin-authoring-patterns.md b/tutorials/wshobson-agents-tutorial/08-contribution-workflow-and-plugin-authoring-patterns.md
index 44e30b84..1aaa231f 100644
--- a/tutorials/wshobson-agents-tutorial/08-contribution-workflow-and-plugin-authoring-patterns.md
+++ b/tutorials/wshobson-agents-tutorial/08-contribution-workflow-and-plugin-authoring-patterns.md
@@ -637,7 +637,7 @@ Use the following upstream sources to verify implementation details while readin
 
 ## Chapter Connections
 
-- [Tutorial Index](index.md)
+- [Tutorial Index](README.md)
 - [Previous Chapter: Chapter 7: Governance, Safety, and Operational Best Practices](07-governance-safety-and-operational-best-practices.md)
 - [Main Catalog](../../README.md#-tutorial-catalog)
 - [A-Z Tutorial Directory](../../discoverability/tutorial-directory.md)
diff --git a/tutorials/wshobson-agents-tutorial/index.md b/tutorials/wshobson-agents-tutorial/README.md
similarity index 100%
rename from tutorials/wshobson-agents-tutorial/index.md
rename to tutorials/wshobson-agents-tutorial/README.md