Add /docs/ai/cli-for-agents/: the agent-friendly Pulumi CLI story

[jkodroff]

Split out of #20454.

Problem

The agent-friendly CLI story exists today only as one sentence in the /docs/ai/ overview blurb, linking into /docs/iac/cli/:

The Pulumi CLI is designed for them: run any command with npx pulumi, perform one-shot resource operations with pulumi do, and parse structured --json output.

After #20454 moves the ten Neo pages under /docs/ai/neo/, the /docs/ai/ overview's direct children are just Agent Skills and MCP server — thin for a section meant to carry "using Pulumi in the AI world," and unbalanced against the Neo subtree.

Proposal

Add content/docs/ai/cli-for-agents/ as a direct child of ai-home at weight: 10 (after skills w=5 and mcp-server w=8).

Suggested coverage:

• npx pulumi — no install step, which is what makes the CLI reachable for an agent in a fresh sandbox
• pulumi do — one-shot resource operations without a full program
• Structured --json output — parseable results rather than scraped human-readable text
• Why the preview/plan model matters for agents: every change is verifiable before it lands
• Cross-links to Agent Skills, the MCP server, and agent accounts

Should stay community-centric per the AGENTS.md AI positioning rule — this page is about any agent driving the Pulumi CLI, not about Neo.

Notes

• Deliberately not linked from the new /docs/ai/neo/ intro page, so no link breaks if this is never written.
• Mostly a synthesis/pointer page over existing /docs/iac/cli/ content rather than net-new product documentation.

🤖 Generated with Claude Code