t1224.9: Update localhost.md and subagent-index.toon — reflect localdev architecture

[marcusquinn]

Update localhost.md and subagent-index.toon to reflect new localdev architecture.

Changes:

• localhost.md: Add legacy notice at top pointing to local-hosting.md as the primary agent
• AGENTS.md: Add Localhost row to progressive disclosure table (local-hosting.md primary, localhost.md legacy reference)
• AGENTS.md: Update Localhost Standards section to reference local-hosting.md
• subagent-index.toon: Add local-hosting|localhost to services/hosting/ entry

Ref #1882

Summary by CodeRabbit

• Documentation
  • Updated hosting documentation to clarify current and legacy reference materials.
  • Enhanced service descriptions and search keywords for hosting-related resources.
  • Added guidance directing users to the appropriate reference documentation for local development setup.

[gemini-code-assist]

Summary of Changes

Hello @marcusquinn, I'm Gemini Code Assist¹! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request updates documentation and configuration files to reflect a significant shift in the local development architecture. The changes aim to deprecate the older localhost.md guide in favor of a new, comprehensive local-hosting.md document, which details the localdev-helper.sh system. This ensures that users are directed to the most current and recommended setup for local development, improving clarity and consistency across the project's documentation.

Highlights

• Documentation Update: Updated localhost.md to clearly mark it as a legacy reference and direct users to the new local-hosting.md for current local development architecture.
• Agent Index Modification: Modified AGENTS.md to include the new local-hosting.md as the primary local development agent and updated the "Localhost Standards" section to reflect this change.
• Subagent Index Integration: Integrated local-hosting and localhost into the services/hosting/ entry in subagent-index.toon to ensure discoverability of both current and legacy local development documentation.

Changelog

• .agents/AGENTS.md
  • Added a new row for "Localhost" in the orchestration agents table, specifying local-hosting.md as primary and localhost.md as a legacy reference.
  • Updated the "Localhost Standards" section to explicitly reference services/hosting/local-hosting.md as the primary guide for .local domains, SSL via Traefik, and mkcert.
• .agents/services/hosting/localhost.md
  • Modified the YAML front matter description to indicate it's a legacy document and points to local-hosting.md.
  • Inserted a prominent blockquote notice at the top of the content, explaining that the file is a legacy reference for the original localhost-helper.sh approach and directs users to local-hosting.md for the current localdev-helper.sh system.
• .agents/subagent-index.toon
  • Updated the services/hosting/ entry by adding local-hosting and localhost to the list of associated keywords and expanded the description to include "local dev".

Activity

• No human activity has been recorded for this pull request yet.

Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature	Command	Description
Code Review	/gemini review	Performs a code review for the current pull request in its current state.
Pull Request Summary	/gemini summary	Provides a summary of the current pull request in its current state.
Comment	@gemini-code-assist	Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help	/gemini help	Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for Github and other Google products, sign up here.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

Footnotes

1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution. ↩

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

---

Walkthrough

These changes consolidate the localhost/local hosting documentation structure by marking localhost.md as legacy, establishing local-hosting.md as the primary reference, and updating agent indexing and discovery metadata to reflect this organizational change.

Changes

Cohort / File(s)	Summary
Documentation & Metadata Updates .agents/AGENTS.md, .agents/services/hosting/localhost.md, .agents/subagent-index.toon	Added Localhost orchestration entry pointing to local-hosting.md as primary reference; marked localhost.md as legacy with forwarding notice; expanded hosting keywords to include local-hosting and localhost for improved discoverability.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~5 minutes

Possibly related issues

• Issue #1882: Directly addresses the same files (AGENTS.md, localhost.md, subagent-index.toon) to consolidate localhost references and establish local-hosting.md as the canonical source.
• Issue #1873: Mirrors the documentation consolidation tasks by creating the local-hosting agent and updating agent indices and legacy references.

Possibly related PRs

• PR #52: Modifies the same hosting documentation files (AGENTS.md and services/hosting/localhost.md) to establish hosting standards and documentation patterns.

Poem

📚 Old docs retire to the archives with grace,
Local-hosting steps forward to take their place,
References updated, keywords aligned,
Legacy marked, new paths defined,
One source of truth, crystal and clean! ✨

🚥 Pre-merge checks | ✅ 3

✅ Passed checks (3 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title directly reflects the main changes: updating localhost.md and subagent-index.toon to align with the new localdev architecture, which matches the file modifications and PR objectives.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch feature/t1224.9

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[github-actions]

🔍 Code Quality Report

�[0;35m[MONITOR]�[0m Code Review Monitoring Report

�[0;34m[INFO]�[0m Latest Quality Status:
SonarCloud: 0 bugs, 0 vulnerabilities, 30 code smells

�[0;34m[INFO]�[0m Recent monitoring activity:
Thu Feb 19 09:31:20 UTC 2026: Code review monitoring started
Thu Feb 19 09:31:20 UTC 2026: SonarCloud - Bugs: 0, Vulnerabilities: 0, Code Smells: 30

📈 Current Quality Metrics

• BUGS: 0
• CODE SMELLS: 30
• VULNERABILITIES: 0

Generated on: Thu Feb 19 09:31:23 UTC 2026

---

Generated by AI DevOps Framework Code Review Monitoring

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud

[gemini-code-assist]

Code Review

This pull request updates documentation to reflect a new local development architecture, marking the old localhost.md as legacy and pointing to the new local-hosting.md. The changes are consistent across AGENTS.md, localhost.md, and subagent-index.toon. I've provided a couple of suggestions to improve formatting consistency and link readability in the markdown files.

[gemini-code-assist]

For better readability and user experience, consider using more descriptive link text instead of just the filename. This helps users understand the link's destination more easily.

Suggested change

	> For new projects, use [`local-hosting.md`](local-hosting.md) which covers the current
	> For new projects, use the [current local hosting guide](local-hosting.md) which covers the current