build-with-wordpress/.github/workflows/developer-docs-agent.yml at d9e9ccaa98bb6dc5270cc2e2d123280c659a8e8c · Automattic/build-with-wordpress · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
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
      run_kind: ${{ github.event_name == 'workflow_dispatch' && 'bootstrap' || 'maintenance' }}
      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 install --frozen-lockfile",
          "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.

        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.

        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