Tell agents to use --autoapprove when a config apply only creates infrastructure

[devin-ai-integration]

Summary

Agents following the project config workflow applied without --autoapprove, so every stack run for brand-new infrastructure stalled at a manual approval gate — an unnecessary human round trip when nothing existing is being modified or destroyed.

The agent-facing guidance (start-here.mdx agent workflow, project-config-file.mdx "Apply the changes" step and Agent tips) now says: pass --autoapprove when the apply only creates new environments/module instances, and omit it when the change modifies, replaces, or removes existing infrastructure so a human reviews the Terraform plan.

# creating things
ravion project config apply <project-id> --file ravion.yaml --autoapprove
# touching existing infrastructure
ravion project config apply <project-id> --file ravion.yaml

Link to Devin session: https://app.devin.ai/sessions/a33d999f0ee54a79b8c57d6ca1b83287
Requested by: @flybayer

Greptile Summary

The PR updates agent-facing project-config guidance to use --autoapprove for changes that only create infrastructure while retaining manual Terraform-plan approval for changes affecting existing resources.

• Adds create-only autoapproval guidance to the project config apply workflow.
• Aligns the required agent workflow, helpful hints, and start-here checklist with that policy.

Confidence Score: 5/5

The documentation-only change appears safe to merge, with no concrete actionable defects identified.

The updated guidance consistently limits automatic approval to create-only applies and retains manual review for modifications, replacements, and removals of existing infrastructure.

Important Files Changed

Filename	Overview
config-as-code/project-config-file.mdx	Clarifies when agents should use --autoapprove and preserves the separate manual and automatic stack-run follow-up flows.
start-here.mdx	Adds a concise version of the create-only autoapproval policy to the introductory agent workflow.

_{Reviews (1): Last reviewed commit: "Tell agents to pass --autoapprove when a..." | Re-trigger Greptile}

[mintlify]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated (UTC)
Ravion	🟢 Ready	View Preview	Aug 18, 2026, 11:52 PM

[devin-ai-integration]

🤖 Devin AI Engineer

I'll be helping with this pull request! Here's what you should know:

✅ I will automatically:

• Address comments on this PR. Add '(aside)' to your comment to have me ignore it.
• Look at CI failures and help fix them

Note: I can only respond to comments from users who have write access to this repository.

⚙️ Control Options:

• Disable automatic comment, CI, and merge conflict monitoring