Revert "Execute developer-docs and skills agents via runtime-agent-full-run (#102)" (#103)

chubes4 · web-flow · commit 2f216e09a68d · 2026-06-28T15:03:45.000-04:00
This reverts commit 05bbdd8. Co-authored-by: Chris Huber <chris.huber@a8c.com>
diff --git a/.github/workflows/developer-docs-agent.yml b/.github/workflows/developer-docs-agent.yml
@@ -2,15 +2,6 @@ name: Build With WordPress Developer Docs Agent
 
 on:
   workflow_dispatch:
-    inputs:
-      docs_agent_ref:
-        description: Ref of Automattic/docs-agent containing the portable bundle.
-        required: false
-        default: main
-      openai_model:
-        description: OpenAI model to use.
-        required: false
-        default: gpt-5.5
   push:
     branches:
       - trunk
@@ -27,68 +18,51 @@ concurrency:
 jobs:
   developer-docs-agent:
     name: Maintain Developer Docs
-    # Execute the technical-docs-agent docs bundle through the runtime-agent-full-run
-    # runner so the agent actually runs and the runner opens a documentation PR.
-    # docs-agent is intentionally runner-neutral (its maintain-docs.yml only builds a
-    # plan), so execution is consumer-owned and we call the executing runner directly.
-    uses: Extra-Chill/homeboy-extensions/.github/workflows/runtime-agent-full-run.yml@main
+    uses: Automattic/docs-agent/.github/workflows/maintain-docs.yml@main
     with:
-      runtime_provider: wp-codebox
-      runtime_ref: main
-      runtime_wordpress_version: '7.0'
-      runtime_profile: datamachine-agent-ci
-      runtime_profiles: |
-        {
-          "datamachine-agent-ci": {
-            "id": "datamachine-agent-ci",
-            "runtime_task_ability": "datamachine/run-agent-bundle",
-            "runtime_bundle_ability": "datamachine/run-agent-bundle",
-            "runtime_workflow_ability": "datamachine/execute-workflow",
-            "ability_requirements": ["datamachine/run-agent-bundle"]
-          }
-        }
-      workload_id: ${{ github.event_name == 'workflow_dispatch' && 'technical-docs-bootstrap-flow' || 'technical-docs-maintenance-flow' }}
-      workload_label: Run technical-docs-agent Data Machine agent
-      target_repo: Automattic/build-with-wordpress
-      provider: openai
-      provider_plugin: |
-        {
-          "repo": "WordPress/ai-provider-for-openai",
-          "ref": "trunk",
-          "register_function": "WordPress\\OpenAiAiProvider\\register_provider",
-          "credentials": {
-            "connectors_ai_openai_api_key": "PROVIDER_SECRET_1"
-          }
-        }
-      runtime_execution: |
+      audience: technical
+      run_kind: ${{ github.event_name == 'workflow_dispatch' && 'bootstrap' || 'maintenance' }}
+      base_ref: trunk
+      docs_branch: docs-agent/build-with-wordpress-developer-docs
+      docs_agent_ref: main
+      writable_paths: README.md,docs/**,plugins/**/README.md
+      bootstrap_contract: |
         {
-          "kind": "bundle",
-          "source": ".ci/docs-agent/bundles/technical-docs-agent",
-          "input": {
-            "flow_slug": "${{ github.event_name == 'workflow_dispatch' && 'technical-docs-bootstrap-flow' || 'technical-docs-maintenance-flow' }}"
-          },
-          "metadata": {
-            "bundle_repo": "https://github.com/Automattic/docs-agent.git",
-            "bundle_ref": "${{ github.event_name == 'workflow_dispatch' && inputs.docs_agent_ref || 'main' }}",
-            "bundle_path_in_repo": "bundles/technical-docs-agent"
-          }
+          "required_paths": [
+            "README.md",
+            "docs/README.md",
+            "docs/architecture.md",
+            "docs/generated-outputs.md",
+            "docs/skills-and-integrations.md",
+            "docs/contributor-workflows.md"
+          ],
+          "required_globs": [
+            {
+              "pattern": "docs/**/*.md",
+              "min": 5
+            }
+          ],
+          "entry_points": [
+            {
+              "path": "README.md",
+              "must_link_to": ["docs/README.md"]
+            },
+            {
+              "path": "docs/README.md",
+              "must_link_to": [
+                "docs/architecture.md",
+                "docs/generated-outputs.md",
+                "docs/skills-and-integrations.md",
+                "docs/contributor-workflows.md"
+              ]
+            }
+          ],
+          "forbidden_phrases": [
+            "future coverage",
+            "deferred",
+            "saved for later"
+          ]
         }
-      prompt: |
-        Maintain developer-facing documentation for Build with WordPress.
-
-        Manual dispatch runs the bootstrap flow and should create or improve the initial developer documentation structure if the repository does not already have one. Push-triggered merge checks run the maintenance flow and should make the smallest source-grounded documentation update needed for newly merged code or finish with no changes when documentation is current.
-
-        Write the developer documentation as repository docs: `docs/README.md` as the index, focused topic pages under `docs/**`, and `plugins/**/README.md` only when a plugin package needs local developer-facing contract notes. For the bootstrap surface, prefer `docs/architecture.md`, `docs/generated-outputs.md`, `docs/skills-and-integrations.md`, and `docs/contributor-workflows.md` as the main topic pages.
-
-        Cover the repository purpose, package layout, generated plugin artifacts, build and verification commands, skill packaging, Studio integration points, and contributor workflows. Document agent/plugin configuration files and generated plugin artifacts from those repository docs and plugin README files. Use the read-only context aliases `studio` and `wordpress-agent-skills` only as source evidence for integration behavior.
-
-        Write the documentation files into the runner-provided workspace and leave publication to the runner; it commits the workspace changes and opens the documentation pull request.
-      model: ${{ github.event_name == 'workflow_dispatch' && inputs.openai_model || 'gpt-5.5' }}
-      max_turns: ${{ github.event_name == 'workflow_dispatch' && 40 || 12 }}
-      step_budget: ${{ github.event_name == 'workflow_dispatch' && 80 || 16 }}
-      time_budget_ms: ${{ github.event_name == 'workflow_dispatch' && 1800000 || 600000 }}
-      runtime_dependencies: Automattic/agents-api@main,Extra-Chill/data-machine@main,Extra-Chill/data-machine-code@main
-      validation_dependencies: Automattic/docs-agent@${{ github.event_name == 'workflow_dispatch' && inputs.docs_agent_ref || 'main' }}
       context_repositories: |
         [
           {
@@ -126,54 +100,12 @@ jobs:
             "description": "Generated package outputs are committed after build"
           }
         ]
-      writable_paths: README.md,docs/**,plugins/**/README.md
-      workspace_contract_checks: >-
-        ${{ github.event_name == 'workflow_dispatch' && '{"paths_exist":[{"path":"README.md"},{"path":"docs/README.md"},{"path":"docs/architecture.md"},{"path":"docs/generated-outputs.md"},{"path":"docs/skills-and-integrations.md"},{"path":"docs/contributor-workflows.md"}],"glob_min_count":[{"glob":"docs/**/*.md","min":5}],"entry_points":[{"path":"README.md","must_link_to":["docs/README.md"]},{"path":"docs/README.md","must_link_to":["docs/architecture.md","docs/generated-outputs.md","docs/skills-and-integrations.md","docs/contributor-workflows.md"]}],"forbidden_phrases":["future coverage","deferred","saved for later"]}' || '{}' }}
-      runner_workspace: |
-        {
-          "enabled": true,
-          "repo": "Automattic/build-with-wordpress",
-          "clone_url": "https://github.com/Automattic/build-with-wordpress.git",
-          "branch": "docs-agent/build-with-wordpress-developer-docs",
-          "branch_prefix": "docs-agent/build-with-wordpress-developer-docs",
-          "from": "origin/trunk",
-          "bootstrap": false
-        }
-      artifact_export_config: |
-        {
-          "pr_title_template": "docs: maintain Build with WordPress developer documentation",
-          "pr_body_template": "## Build with WordPress developer docs\n\nThe technical-docs-agent Data Machine agent (Automattic/docs-agent `bundles/technical-docs-agent`) updated developer-facing documentation in this repository.\n\n- Flow: {task_id}\n- Publication opened by the runtime-agent-full-run runner.\n",
-          "commit_message_template": "docs: maintain developer documentation"
-        }
-      success_requires_pr: ${{ github.event_name == 'workflow_dispatch' }}
-      # All checked-out repos (docs-agent bundle, agents-api, data-machine,
-      # data-machine-code) are public and the target is this same repo, so the
-      # default GITHUB_TOKEN (granted contents/pull-requests: write above) can
-      # read deps and open the docs PR. No Homeboy GitHub App token is required;
-      # the runner falls back to GITHUB_TOKEN when app creds are unavailable.
-      require_homeboy_app_token: false
-      required_abilities: |
-        [
-          "datamachine/import-agent",
-          "datamachine/run-flow",
-          "datamachine/drain-job",
-          "datamachine-code/workspace-worktree-add"
-        ]
-      app_token_repos: Automattic/build-with-wordpress,Automattic/docs-agent
-      allowed_repos: |
-        [
-          "Automattic/build-with-wordpress"
-        ]
-      runtime_output_projections: '{"docs_pr_url":"metadata.engine_data.docs_agent.pr_url"}'
-      callback_data: |
-        {
-          "agent_slug": "technical-docs-agent",
-          "pipeline_slug": "technical-docs-pipeline",
-          "flow_slug": "${{ github.event_name == 'workflow_dispatch' && 'technical-docs-bootstrap-flow' || 'technical-docs-maintenance-flow' }}",
-          "bundle_path": "bundles/technical-docs-agent",
-          "target_repo": "Automattic/build-with-wordpress"
-        }
-      transcript_artifact_name: developer-docs-agent-transcript-${{ github.run_id }}
-      replay_bundle_artifact_name: developer-docs-agent-replay-${{ github.run_id }}
-    secrets:
-      PROVIDER_SECRET_1: ${{ secrets.OPENAI_API_KEY }}
+      prompt: |
+        Maintain developer-facing documentation for Build with WordPress.
+
+        Manual dispatch runs the bootstrap flow and should create or improve the initial developer documentation structure if the repository does not already have one. Push-triggered merge checks run the maintenance flow and should make the smallest source-grounded documentation update needed for newly merged code or finish with no changes when documentation is current.
+
+        Write the developer documentation as repository docs: `docs/README.md` as the index, focused topic pages under `docs/**`, and `plugins/**/README.md` only when a plugin package needs local developer-facing contract notes. For the bootstrap surface, prefer `docs/architecture.md`, `docs/generated-outputs.md`, `docs/skills-and-integrations.md`, and `docs/contributor-workflows.md` as the main topic pages.
+
+        Cover the repository purpose, package layout, generated plugin artifacts, build and verification commands, skill packaging, Studio integration points, and contributor workflows. Document agent/plugin configuration files and generated plugin artifacts from those repository docs and plugin README files. Use the read-only context aliases `studio` and `wordpress-agent-skills` only as source evidence for integration behavior.
+    secrets: inherit
diff --git a/.github/workflows/skills-agent.yml b/.github/workflows/skills-agent.yml
@@ -2,15 +2,6 @@ name: Build With WordPress Skills Agent
 
 on:
   workflow_dispatch:
-    inputs:
-      docs_agent_ref:
-        description: Ref of Automattic/docs-agent containing the portable bundle.
-        required: false
-        default: main
-      openai_model:
-        description: OpenAI model to use.
-        required: false
-        default: gpt-5.5
   schedule:
     - cron: '0 9 * * 1'
 
@@ -19,73 +10,16 @@ permissions:
   pull-requests: write
   issues: write
 
-concurrency:
-  group: skills-agent-${{ github.ref }}
-  cancel-in-progress: false
-
 jobs:
   skills-agent:
     name: Maintain Live Skills
-    # Execute the skills-agent docs bundle through the runtime-agent-full-run runner so
-    # the agent actually runs and the runner opens a skills documentation PR. docs-agent
-    # is intentionally runner-neutral (its maintain-docs.yml only builds a plan), so
-    # execution is consumer-owned and we call the executing runner directly.
-    uses: Extra-Chill/homeboy-extensions/.github/workflows/runtime-agent-full-run.yml@main
+    uses: Automattic/docs-agent/.github/workflows/maintain-docs.yml@main
     with:
-      runtime_provider: wp-codebox
-      runtime_ref: main
-      runtime_wordpress_version: '7.0'
-      runtime_profile: datamachine-agent-ci
-      runtime_profiles: |
-        {
-          "datamachine-agent-ci": {
-            "id": "datamachine-agent-ci",
-            "runtime_task_ability": "datamachine/run-agent-bundle",
-            "runtime_bundle_ability": "datamachine/run-agent-bundle",
-            "runtime_workflow_ability": "datamachine/execute-workflow",
-            "ability_requirements": ["datamachine/run-agent-bundle"]
-          }
-        }
-      workload_id: skills-maintenance-flow
-      workload_label: Run skills-agent Data Machine agent
-      target_repo: Automattic/build-with-wordpress
-      provider: openai
-      provider_plugin: |
-        {
-          "repo": "WordPress/ai-provider-for-openai",
-          "ref": "trunk",
-          "register_function": "WordPress\\OpenAiAiProvider\\register_provider",
-          "credentials": {
-            "connectors_ai_openai_api_key": "PROVIDER_SECRET_1"
-          }
-        }
-      runtime_execution: |
-        {
-          "kind": "bundle",
-          "source": ".ci/docs-agent/bundles/skills-agent",
-          "input": {
-            "flow_slug": "skills-maintenance-flow"
-          },
-          "metadata": {
-            "bundle_repo": "https://github.com/Automattic/docs-agent.git",
-            "bundle_ref": "${{ github.event_name == 'workflow_dispatch' && inputs.docs_agent_ref || 'main' }}",
-            "bundle_path_in_repo": "bundles/skills-agent"
-          }
-        }
-      prompt: |
-        Maintain live agent skill instructions and generated packaged skill outputs for Build with WordPress.
-
-        Run the skills maintenance flow and make the smallest source-grounded skill update needed for newly merged code, or finish with no changes when the skills are current. Edit live skill instructions under `skills/**`, packaged skill outputs under `plugins/**/skills/**`, and `plugins/**/README.md` only when a plugin package needs local developer-facing contract notes.
-
-        Use the read-only context aliases `studio` and `wordpress-agent-skills` only as source evidence for integration and packaging behavior.
-
-        Write the skill changes into the runner-provided workspace and leave publication to the runner; it commits the workspace changes and opens the skills pull request.
-      model: ${{ github.event_name == 'workflow_dispatch' && inputs.openai_model || 'gpt-5.5' }}
-      max_turns: 12
-      step_budget: 16
-      time_budget_ms: 600000
-      runtime_dependencies: Automattic/agents-api@main,Extra-Chill/data-machine@main,Extra-Chill/data-machine-code@main
-      validation_dependencies: Automattic/docs-agent@${{ github.event_name == 'workflow_dispatch' && inputs.docs_agent_ref || 'main' }}
+      audience: skills
+      base_ref: trunk
+      docs_branch: docs-agent/build-with-wordpress-skills
+      docs_agent_ref: main
+      writable_paths: skills/**,plugins/**/skills/**,plugins/**/README.md
       context_repositories: |
         [
           {
@@ -123,49 +57,4 @@ jobs:
             "description": "Generated skill package outputs are committed after build"
           }
         ]
-      writable_paths: skills/**,plugins/**/skills/**,plugins/**/README.md
-      runner_workspace: |
-        {
-          "enabled": true,
-          "repo": "Automattic/build-with-wordpress",
-          "clone_url": "https://github.com/Automattic/build-with-wordpress.git",
-          "branch": "docs-agent/build-with-wordpress-skills",
-          "branch_prefix": "docs-agent/build-with-wordpress-skills",
-          "from": "origin/trunk",
-          "bootstrap": false
-        }
-      artifact_export_config: |
-        {
-          "pr_title_template": "docs: maintain Build with WordPress live skills",
-          "pr_body_template": "## Build with WordPress live skills\n\nThe skills-agent Data Machine agent (Automattic/docs-agent `bundles/skills-agent`) updated live skill instructions and generated packaged skill outputs in this repository.\n\n- Flow: {task_id}\n- Publication opened by the runtime-agent-full-run runner.\n",
-          "commit_message_template": "docs: maintain live skills"
-        }
-      success_requires_pr: false
-      # Public deps + same-repo target → default GITHUB_TOKEN suffices; no
-      # Homeboy GitHub App token required (runner falls back to GITHUB_TOKEN).
-      require_homeboy_app_token: false
-      required_abilities: |
-        [
-          "datamachine/import-agent",
-          "datamachine/run-flow",
-          "datamachine/drain-job",
-          "datamachine-code/workspace-worktree-add"
-        ]
-      app_token_repos: Automattic/build-with-wordpress,Automattic/docs-agent
-      allowed_repos: |
-        [
-          "Automattic/build-with-wordpress"
-        ]
-      runtime_output_projections: '{"docs_pr_url":"metadata.engine_data.docs_agent.pr_url"}'
-      callback_data: |
-        {
-          "agent_slug": "skills-agent",
-          "pipeline_slug": "skills-pipeline",
-          "flow_slug": "skills-maintenance-flow",
-          "bundle_path": "bundles/skills-agent",
-          "target_repo": "Automattic/build-with-wordpress"
-        }
-      transcript_artifact_name: skills-agent-transcript-${{ github.run_id }}
-      replay_bundle_artifact_name: skills-agent-replay-${{ github.run_id }}
-    secrets:
-      PROVIDER_SECRET_1: ${{ secrets.OPENAI_API_KEY }}
+    secrets: inherit
