Skip to content

docs: add AGENTS.md (delegate-to-Riley)#12

Open
sam-at-luther wants to merge 1 commit into
mainfrom
feat/agents-md
Open

docs: add AGENTS.md (delegate-to-Riley)#12
sam-at-luther wants to merge 1 commit into
mainfrom
feat/agents-md

Conversation

@sam-at-luther

Copy link
Copy Markdown
Member

Summary

Add AGENTS.md at repo root — the machine-discoverable equivalent of the README, telling AI agents working in this repo how to delegate cloud-infrastructure tasks to Riley (the infrastructure agent this Claude Code plugin is the client for).

AGENTS.md is the convention agent ecosystems are converging on for "how should an AI agent interact with this repo / project / service" (similar in spirit to llms.txt for LLM crawlers).

Content

  • MCP endpoint (https://app.luthersystems.com/v1/insideout-mcp) and recommended tool call sequence
  • Six-agent system note (Riley/Hippo/Joy/Etch/Core/Axel)
  • Supported clouds & components table (AWS+GCP, 10 categories) — same data as the existing README, kept consistent
  • No-auth design phase, IAM/SA-key only at deployment
  • Delegation workflow patterns for orchestration agents

Source

Drafted by hossein.kakavand in Slack #insideout-agent-visibility. Applied with corrections:

  • MCP URL changed from the legacy app.platform.luthersystemsapp.com/insideout-mcp to the canonical customer-facing app.luthersystems.com/v1/insideout-mcp
  • Removed the agent-card.json reference (deferred — see luthersystems/reliable#1207)
  • Discord URL updated to https://insideout.luthersystems.com/discord
  • Install paths updated to match the actual /plugin marketplace add + /plugin install two-step

Related PRs (same fan-out)

If an AI agent is working in this repo on Claude Code plugin code and
needs to provision, inspect, or manage cloud infrastructure as part of
a larger workflow, AGENTS.md tells them how to delegate to Riley — the
infrastructure agent this plugin is the client for.

The README already explains InsideOut to humans; AGENTS.md is the
machine-discoverable equivalent (the standard convention agent
ecosystems are converging on, similar to llms.txt).

Content covers MCP endpoint (https://app.luthersystems.com/v1/insideout-mcp),
tool call sequence (help → convoopen → convoreply → tfgenerate →
tfdeploy → tfstatus), supported clouds, no-auth design phase, and
delegation workflow patterns.

Drafted by hossein.kakavand in Slack #insideout-agent-visibility;
applied with corrected MCP URL (canonical /v1 path on
app.luthersystems.com) and updated install paths.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant