docs: clarify assistant and documentation paths #647

Work Classification

Both — coordinated library and workspace documentation changes; no API, source-code, script, or notebook changes.

Affected Repositories

• PyAutoLens (primary)
• PyAutoGalaxy
• autolens_workspace
• autogalaxy_workspace

Branch Survey

No affected repository is claimed by another active task.

Suggested branch: feature/assistant-docs-hierarchy

Worktree root: ~/Code/PyAutoLabs-wt/assistant-docs-hierarchy/

Implementation Steps

1. Add product-specific AI Assistant and Human-Readable Documentation and Examples subsection headings beneath Getting Started in PyAutoLens/README.md and PyAutoGalaxy/README.md.
2. Apply equivalent subsections to PyAutoLens/docs/index.md and PyAutoGalaxy/docs/index.md using the appropriate heading depth.
3. Put the AI Assistant directly below the title in both docs/overview/overview_1_start_here.md pages, followed by a distinct human-readable overview section.
4. Reorder and split both docs/overview/overview_2_new_user_guide.md pages into AI Assistant and Human-Readable Guide sections.
5. Add matching subsections to both workspace READMEs and convert the installation and Colab prose into a clean list of choices.
6. Run Markdown consistency checks, git diff --check, and both Sphinx documentation builds.

Key Files

• PyAutoLens/README.md and PyAutoGalaxy/README.md — library onboarding hierarchy.
• PyAutoLens/docs/index.md and PyAutoGalaxy/docs/index.md — RTD landing-page hierarchy.
• PyAutoLens/docs/overview/overview_1_start_here.md and PyAutoGalaxy/docs/overview/overview_1_start_here.md — assistant-first Start Here pages.
• PyAutoLens/docs/overview/overview_2_new_user_guide.md and PyAutoGalaxy/docs/overview/overview_2_new_user_guide.md — split assistant and human-readable guide routes.
• autolens_workspace/README.md and autogalaxy_workspace/README.md — repaired workspace Getting Started layout.

On the README.md page can you use smaller subsection heading to spit PyAutoLens AI Assistant and Human readable docs, or bold font, or something to make them appear a bit more separate and distinct as two options? The PyAutoLens AI Assistant supports conversation agents such as ChatGPT and coding agents such as Claude Code and Codex. You can get started simply by asking it a question about gravitational lensing or describing the task you would like to perform with PyAutoLens. See the assistant for its full scope and instructions.

The following human-readable documentation and examples are also useful for new starters: The formatting and strucutre on autolens_workspace is flat out broken: The following human-readable documentation and examples are also useful for new starters:

You can get set up on your personal computer by following the installation guide on our readthedocs.

Alternatively, you can try PyAutoLens out in a web browser by going to the autolens workspace on Colab. Also for formatting split on readthedocs lensing or describing the task you would like to perform with PyAutoLens. See the assistant for its full scope and instructions.

The rest of this human-readable guide begins with two simple questions to help you find the most appropriate example notebook for your science case. and also have the AI assistant section at the top of the "Start Here" page of each readthedocs