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:
+
+
+ 
+
```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 @@
+
+
+
+
+