From d91e0ea6fdc41ecdae67d9706a7726a4983ae276 Mon Sep 17 00:00:00 2001 From: Bryan Helmkamp Date: Thu, 5 Mar 2026 16:53:53 -0500 Subject: [PATCH] Restructure Getting Started docs: add Introduction, rename Overview to Why Arc, add Models placeholder - Add Introduction page with four card links (Why Arc, Quick Start, Workflows, Agents) - Rename Overview to Why Arc with updated frontmatter - Add rendered SVG workflow graph to Why Arc page - Add Core Concepts > Models placeholder page - Remove getting-started/workflows page Co-Authored-By: Claude Opus 4.6 --- docs/core-concepts/models.mdx | 5 + docs/docs.json | 9 +- docs/getting-started/introduction.mdx | 37 ++++++++ .../{overview.mdx => why-arc.mdx} | 10 +- docs/getting-started/workflows.mdx | 5 - docs/images/plan-implement-workflow.svg | 94 +++++++++++++++++++ 6 files changed, 148 insertions(+), 12 deletions(-) create mode 100644 docs/core-concepts/models.mdx create mode 100644 docs/getting-started/introduction.mdx rename docs/getting-started/{overview.mdx => why-arc.mdx} (94%) delete mode 100644 docs/getting-started/workflows.mdx create mode 100644 docs/images/plan-implement-workflow.svg diff --git a/docs/core-concepts/models.mdx b/docs/core-concepts/models.mdx new file mode 100644 index 000000000..24178f339 --- /dev/null +++ b/docs/core-concepts/models.mdx @@ -0,0 +1,5 @@ +--- +title: "Models" +description: "How Arc routes tasks to LLM models and providers" +--- + diff --git a/docs/docs.json b/docs/docs.json index 9197a8942..c0df8a3c8 100644 --- a/docs/docs.json +++ b/docs/docs.json @@ -17,9 +17,9 @@ "group": "Getting Started", "icon": "rocket", "pages": [ - "getting-started/overview", - "getting-started/quick-start", - "getting-started/workflows" + "getting-started/introduction", + "getting-started/why-arc", + "getting-started/quick-start" ] }, { @@ -28,7 +28,8 @@ "pages": [ "core-concepts/how-arc-works", "core-concepts/workflows", - "core-concepts/agents" + "core-concepts/agents", + "core-concepts/models" ] }, { diff --git a/docs/getting-started/introduction.mdx b/docs/getting-started/introduction.mdx new file mode 100644 index 000000000..7fe7fc8c3 --- /dev/null +++ b/docs/getting-started/introduction.mdx @@ -0,0 +1,37 @@ +--- +title: "Introduction" +description: "Arc is the software factory for small teams of expert engineers" +--- + +Arc replaces the prompt-wait-review loop with version-controlled workflow graphs that orchestrate AI agents, shell commands, and human decisions into repeatable, long-horizon coding processes. + + + + The problems Arc solves for AI-assisted software teams. + + + Install Arc and run your first workflow in minutes. + + + Learn how workflow graphs orchestrate agents, commands, and human gates. + + + Understand how Arc configures and runs LLM agents within workflows. + + diff --git a/docs/getting-started/overview.mdx b/docs/getting-started/why-arc.mdx similarity index 94% rename from docs/getting-started/overview.mdx rename to docs/getting-started/why-arc.mdx index 5a0d18ed7..d9fac0a8f 100644 --- a/docs/getting-started/overview.mdx +++ b/docs/getting-started/why-arc.mdx @@ -1,6 +1,6 @@ --- -title: "Overview" -description: "Why Arc?" +title: "Why Arc?" +description: "The problems Arc solves for AI-assisted software teams" --- Arc is the software factory for small teams of expert engineers. It replaces the prompt-wait-review loop with version-controlled workflow graphs that orchestrate AI agents, shell commands, and human decisions into repeatable, long-horizon coding processes. @@ -42,7 +42,11 @@ Arc gives you a deterministic harness around non-deterministic AI. You define ** ## What a workflow looks like -Workflows are defined in Graphviz DOT, a simple graph description language: +Workflows are defined in Graphviz DOT, a simple graph description language. Here's a plan-approve-implement workflow and its DOT source: + + + Plan-Implement workflow graph + ```dot digraph PlanImplement { diff --git a/docs/getting-started/workflows.mdx b/docs/getting-started/workflows.mdx deleted file mode 100644 index 474cc9e58..000000000 --- a/docs/getting-started/workflows.mdx +++ /dev/null @@ -1,5 +0,0 @@ ---- -title: "Workflows" -description: "Introduction to Arc workflows" ---- - diff --git a/docs/images/plan-implement-workflow.svg b/docs/images/plan-implement-workflow.svg new file mode 100644 index 000000000..af99708dd --- /dev/null +++ b/docs/images/plan-implement-workflow.svg @@ -0,0 +1,94 @@ + + + + + + +PlanImplement + + +start + + + + + +Start + + + +plan + +Plan + + + +start->plan + + + + + +exit + + + + + +Exit + + + +approve + +Approve Plan + + + +plan->approve + + + + + +approve->plan + + +Revise + + + +implement + +Implement + + + +approve->implement + + +Approve + + + +simplify + +Simplify + + + +implement->simplify + + + + + +simplify->exit + + + + +