Merge pull request #22 from Automattic/add-developer-docs-flow

Add developer docs maintenance workflow

Author: chubes4

.github/workflows/developer-docs-agent.yml

@@ -0,0 +1,69 @@
+name: Build With WordPress Developer Docs Agent
+
+on:
+  workflow_dispatch:
+  push:
+    branches:
+      - trunk
+
+permissions:
+  contents: write
+  pull-requests: write
+  issues: write
+
+concurrency:
+  group: developer-docs-agent-${{ github.ref }}
+  cancel-in-progress: false
+
+jobs:
+  developer-docs-agent:
+    name: Maintain Developer Docs
+    uses: Automattic/docs-agent/.github/workflows/maintain-docs.yml@main
+    with:
+      audience: technical
+      base_ref: trunk
+      docs_branch: docs-agent/build-with-wordpress-developer-docs
+      writable_paths: README.md,docs/**,plugins/**/README.md
+      context_repositories: |
+        [
+          {
+            "repo": "Automattic/studio",
+            "ref": "trunk",
+            "alias": "studio",
+            "paths": [
+              "apps/cli/ai/tools/**",
+              "apps/cli/ai/system-prompt.ts",
+              "apps/cli/commands/mcp.ts",
+              "eval/promptfoo.config.yaml"
+            ]
+          },
+          {
+            "repo": "WordPress/agent-skills",
+            "ref": "trunk",
+            "alias": "wordpress-agent-skills",
+            "paths": [
+              "skills/**",
+              "docs/packaging.md",
+              ".github/workflows/ai-skill-maintenance.yml"
+            ]
+          }
+        ]
+      verification_commands: |
+        [
+          "pnpm build",
+          "pnpm verify"
+        ]
+      drift_checks: |
+        [
+          {
+            "command": "git diff --exit-code",
+            "description": "Generated package outputs are committed after build"
+          }
+        ]
+      prompt: |
+        Maintain developer-facing documentation for Build with WordPress after source changes land on the base branch.
+
+        For the first manual bootstrap run, create or improve the initial developer documentation structure if the repository does not already have one. For push-triggered merge checks, make the smallest source-grounded documentation update needed for newly merged code or finish with no changes when documentation is current.
+
+        Cover the repository purpose, package layout, generated plugin artifacts, build and verification commands, skill packaging, Studio integration points, and contributor workflows. Use the read-only context aliases `studio` and `wordpress-agent-skills` only as source evidence for integration behavior.
+    secrets: inherit