Skip to content

docs: target Auto-Run autonomy updates#1077

Merged
factory-sagar merged 9 commits intomainfrom
docs/autonomy-level-spec-mode
May 2, 2026
Merged

docs: target Auto-Run autonomy updates#1077
factory-sagar merged 9 commits intomainfrom
docs/autonomy-level-spec-mode

Conversation

@TheFactoriousDROID
Copy link
Copy Markdown
Contributor

@TheFactoriousDROID TheFactoriousDROID commented May 2, 2026

What

  • Rewrite the Auto-Run guide as Autonomy Level documentation covering Off, Low, Medium, High, approvals, command policy, and where the control applies.
  • Promote Autonomy Level in the navigation and keep Spec Mode in its original location.
  • Limit related page updates to targeted references in Settings, AGENTS.md, and Spec Mode.

Why

This keeps the PR focused on the Auto-Run to Autonomy Level rename, the page rewrite, and the nav prominence change without carrying unrelated Quickstart, Zed, or Spec Mode rewrites.

Risk / impact

Docs-only. The main risk is inaccurate autonomy or approval guidance.

Testing

  • npx -y mintlify@4.2.529 validate
  • npx -y mintlify@4.2.529 broken-links --check-redirects
  • git diff --check

@mintlify
Copy link
Copy Markdown
Contributor

mintlify Bot commented May 2, 2026

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

Project Status Preview Updated (UTC)
factory 🟢 Ready View Preview May 2, 2026, 1:48 AM

💡 Tip: Enable Workflows to automatically generate PRs for you.

@factory-droid
Copy link
Copy Markdown
Contributor

factory-droid Bot commented May 2, 2026

Droid finished @TheFactoriousDROID's task —— View job


Docs refresh looks coherent overall, but quickstart currently has an extra trailing code fence that will render incorrectly. Fixing that should make the updated navigation and guidance read cleanly.

Comment thread docs/cli/getting-started/quickstart.mdx
Updated the description and references from 'Factory' to 'Droid' in the settings documentation. Remove unflagged settings.
Updated references from 'Factory CLI' to 'Droid CLI' throughout the document.
Removed example workflows and detailed explanations to streamline the documentation. Updated instructions for activating Spec Mode and saving specifications.
Updated the formatting of the writing effective requests section for clarity.
@TheFactoriousDROID TheFactoriousDROID changed the title docs: Update Autonomy Level and Spec Mode docs docs: target Auto-Run autonomy updates May 2, 2026
@TheFactoriousDROID TheFactoriousDROID marked this pull request as ready for review May 2, 2026 19:20
@factory-droid
Copy link
Copy Markdown
Contributor

factory-droid Bot commented May 2, 2026

Droid finished @TheFactoriousDROID's task —— View job


The Autonomy Level rewrite is coherent, but there are a few user-facing inconsistencies to resolve: enterprise org-managed settings still document the old autonomy keys, Windows shortcut guidance conflicts with the documented Mission Control toggle, and Spec Mode’s “Proceed with implementation” wording contradicts the Autonomy Level page. Also, add a small safety warning where --skip-permissions-unsafe is mentioned to reduce risky copy-paste.

Comment thread docs/cli/configuration/settings.mdx
Comment thread docs/cli/user-guides/auto-run.mdx Outdated
Comment thread docs/cli/user-guides/specification-mode.mdx
Comment thread docs/cli/user-guides/auto-run.mdx Outdated
TheFactoriousDROID and others added 2 commits May 2, 2026 12:36
Co-authored-by: factory-droid[bot] <138933559+factory-droid[bot]@users.noreply.github.com>
Co-authored-by: factory-droid[bot] <138933559+factory-droid[bot]@users.noreply.github.com>
Comment thread docs/cli/getting-started/quickstart.mdx Outdated
Comment thread docs/docs.json
@factory-sagar factory-sagar merged commit c874936 into main May 2, 2026
10 checks passed
@factory-sagar factory-sagar deleted the docs/autonomy-level-spec-mode branch May 2, 2026 19:48
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.

2 participants