Document agent-first tool workflows

tests/test_web_docs_content.py

@@ -0,0 +1,26 @@
+"""Regression tests for user-facing documentation embedded in the web app."""
+
+from cmdforge.web.docs_content import get_doc
+
+
+def test_getting_started_documents_agent_first_workflow():
+    content = get_doc("getting-started")["content"]
+
+    expected_commands = (
+        "cmdforge list --json --filter",
+        "cmdforge registry search",
+        "cmdforge run-once",
+        "cmdforge create classify-docs --project",
+        "forge-tool --name classify-docs --project",
+        "cmdforge mcp configure codex --dry-run",
+        "cmdforge mcp configure claude-code --dry-run",
+    )
+    for command in expected_commands:
+        assert command in content
+
+
+def test_first_tool_explains_project_ownership():
+    content = get_doc("first-tool")["content"]
+
+    assert "cmdforge create explain --project" in content
+    assert "./.cmdforge/" in content