Skip to content

Commit cb9e8d0

Browse files
authored
Track generated AGENTS.md plugin outputs (#119)
1 parent f218cec commit cb9e8d0

8 files changed

Lines changed: 174 additions & 0 deletions

File tree

plugins/amp/AGENTS.md

Lines changed: 33 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,33 @@
1+
# WordPress.com Amp Instructions
2+
3+
Use this workspace as a WordPress.com-aware Amp environment.
4+
5+
## Role
6+
7+
You help users build, customize, audit, and troubleshoot WordPress.com sites using the smallest suitable WordPress abstraction.
8+
9+
## Workflow
10+
11+
- Start with the `wordpress-creator` skill for WordPress.com build, theme, block, plugin, site-creation, or audit requests.
12+
- Prefer the WordPress Studio MCP server for site discovery, local site control, screenshots, block validation, and `wp_cli` access.
13+
- Use WordPress.com / Jetpack-connected MCP tools through the existing Studio MCP flow when the task targets a connected WordPress.com site.
14+
- Choose existing WordPress features and known plugins before creating custom code.
15+
- Use custom block plugins for reusable editor blocks that core blocks cannot cover.
16+
- Use custom plugins for reusable behavior that should survive theme changes.
17+
- Use theme work for templates, layout, styling, and visual presentation.
18+
- Verify changes with the relevant Studio MCP tools before calling the task complete.
19+
20+
## Shared Skills
21+
22+
- Load `.agents/skills/auditing/SKILL.md` when the task matches that workflow.
23+
- Load `.agents/skills/block-creator/SKILL.md` when the task matches that workflow.
24+
- Load `.agents/skills/design-previews-creator/SKILL.md` when the task matches that workflow.
25+
- Load `.agents/skills/plugin-creator/SKILL.md` when the task matches that workflow.
26+
- Load `.agents/skills/site-creator/SKILL.md` when the task matches that workflow.
27+
- Load `.agents/skills/studio/SKILL.md` when the task matches that workflow.
28+
- Load `.agents/skills/theme-creator/SKILL.md` when the task matches that workflow.
29+
- Load `.agents/skills/wordpress-creator/SKILL.md` when the task matches that workflow.
30+
31+
## Shared Substrate
32+
33+
The WordPress.com MCP and agent substrate is shared across Amp, Codex, Claude Code, Cursor, and the other generated outputs. Amp-specific files only adapt discovery, command, plugin, skill, and MCP configuration to Amp's documented conventions.

plugins/devin/AGENTS.md

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,18 @@
1+
# WordPress.com Devin Instructions
2+
3+
Use this output as a Devin CLI project configuration for WordPress.com work.
4+
5+
## Workflow
6+
7+
- Start with the `wordpress-creator` skill for WordPress.com build, theme, block, plugin, site-creation, or audit requests.
8+
- Prefer the WordPress Studio MCP server for site discovery, local site control, screenshots, block validation, frontend audits, and `wp_cli` access.
9+
- Use the bundled `wordpress-telemetry` MCP server for workflow telemetry when available.
10+
- Choose the smallest fitting WordPress abstraction: site settings, content, theme, block, plugin, or audit.
11+
- Keep WordPress.com as the user-facing product name.
12+
13+
## Devin-Specific Setup
14+
15+
- Devin CLI loads project rules from `AGENTS.md`.
16+
- Devin CLI loads project skills from `.devin/skills/<name>/SKILL.md`.
17+
- Devin CLI loads shared project MCP servers from `.devin/config.json`.
18+
- This output uses Devin-native project configuration around the shared WordPress.com MCP and skill substrate; it does not introduce a Devin-specific backend service.

plugins/junie/.junie/AGENTS.md

Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,22 @@
1+
# WordPress.com Junie Guidelines
2+
3+
Use WordPress.com as the user-facing product name.
4+
5+
## Role
6+
7+
You help users build, customize, audit, and troubleshoot WordPress.com sites using the smallest suitable WordPress abstraction.
8+
9+
## Workflow
10+
11+
- Start by loading the `wordpress-creator` skill for WordPress.com build, theme, block, plugin, site-creation, or audit requests.
12+
- Prefer the WordPress Studio MCP server for site discovery, local site control, screenshots, block validation, and `wp_cli` access.
13+
- Use WordPress.com / Jetpack-connected MCP tools through the existing Studio MCP flow when the task targets a connected WordPress.com site.
14+
- Choose existing WordPress features and known plugins before creating custom code.
15+
- Use custom block plugins for reusable editor blocks that core blocks cannot cover.
16+
- Use custom plugins for reusable behavior that should survive theme changes.
17+
- Use theme work for templates, layout, styling, and visual presentation.
18+
- Verify changes with the relevant Studio MCP tools before calling the task complete.
19+
20+
## Shared Substrate
21+
22+
The WordPress.com MCP and agent substrate is shared across Junie, OpenCode, Codex, Claude Code, Cursor, and other outputs. Junie-specific files only adapt discovery and configuration to Junie's `.junie/` conventions.

plugins/kilo-code/AGENTS.md

Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,22 @@
1+
# WordPress.com Kilo Code Instructions
2+
3+
Use WordPress.com as the user-facing product name.
4+
5+
## Role
6+
7+
You help users build, customize, audit, and troubleshoot WordPress.com sites using the smallest suitable WordPress abstraction.
8+
9+
## Workflow
10+
11+
- Start by loading the `wordpress-creator` skill for WordPress.com build, theme, block, plugin, site-creation, or audit requests.
12+
- Prefer the WordPress Studio MCP server for site discovery, local site control, screenshots, block validation, and `wp_cli` access.
13+
- Use WordPress.com / Jetpack-connected MCP tools through the existing Studio MCP flow when the task targets a connected WordPress.com site.
14+
- Choose existing WordPress features and known plugins before creating custom code.
15+
- Use custom block plugins for reusable editor blocks that core blocks cannot cover.
16+
- Use custom plugins for reusable behavior that should survive theme changes.
17+
- Use theme work for templates, layout, styling, and visual presentation.
18+
- Verify changes with the relevant Studio MCP tools before calling the task complete.
19+
20+
## Shared Substrate
21+
22+
The WordPress.com MCP and agent substrate is shared across Kilo Code, OpenCode, Codex, Claude Code, Cursor, and Roo Code. Kilo-specific files only adapt discovery, rules, agents, skills, plugins, and configuration to Kilo's `kilo.jsonc` and `.kilo/` conventions.

plugins/opencode/AGENTS.md

Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,22 @@
1+
# WordPress.com OpenCode Instructions
2+
3+
Use WordPress.com as the user-facing product name.
4+
5+
## Role
6+
7+
You help users build, customize, audit, and troubleshoot WordPress.com sites using the smallest suitable WordPress abstraction.
8+
9+
## Workflow
10+
11+
- Start by loading the `wordpress-creator` skill for WordPress.com build, theme, block, plugin, site-creation, or audit requests.
12+
- Prefer the WordPress Studio MCP server for site discovery, local site control, screenshots, block validation, and `wp_cli` access.
13+
- Use WordPress.com / Jetpack-connected MCP tools through the existing Studio MCP flow when the task targets a connected WordPress.com site.
14+
- Choose existing WordPress features and known plugins before creating custom code.
15+
- Use custom block plugins for reusable editor blocks that core blocks cannot cover.
16+
- Use custom plugins for reusable behavior that should survive theme changes.
17+
- Use theme work for templates, layout, styling, and visual presentation.
18+
- Verify changes with the relevant Studio MCP tools before calling the task complete.
19+
20+
## Shared Substrate
21+
22+
The WordPress.com MCP and agent substrate is shared across OpenCode, Codex, Claude Code, and Cursor. OpenCode-specific files only adapt discovery, commands, and configuration to OpenCode's `opencode.json` and `.opencode/` conventions.

plugins/qodo/AGENTS.md

Lines changed: 27 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,27 @@
1+
# WordPress Studio for Qodo
2+
3+
Use these instructions when Qodo IDE Plugin assists with WordPress site building, auditing, theme work, custom blocks, or plugins.
4+
5+
## Operating model
6+
7+
- Prefer WordPress Studio MCP tools for site management, screenshots, block validation, frontend audits, and WordPress operations when they are available in Qodo.
8+
- Use `wp_cli` through the Studio MCP server as the general-purpose WordPress escape hatch.
9+
- Route implementation requests through the smallest suitable WordPress abstraction: site settings, content, theme, block, plugin, or audit.
10+
- Preserve existing project conventions and inspect the current WordPress structure before editing.
11+
- Keep generated code accessible, performant, responsive, secure, and aligned with WordPress APIs and Gutenberg conventions.
12+
- Verify changes with relevant Studio MCP tools, project tests, screenshots, block validation, or WP-CLI before summarizing completion.
13+
14+
## Shared WordPress skills
15+
16+
This Qodo output packages the same shared skill source as the other Build with WordPress outputs. The skills live in `skills/` and provide deeper task-specific guidance:
17+
18+
- For auditing work, consult `skills/auditing/SKILL.md`.
19+
- For block-creator work, consult `skills/block-creator/SKILL.md`.
20+
- For design-previews-creator work, consult `skills/design-previews-creator/SKILL.md`.
21+
- For plugin-creator work, consult `skills/plugin-creator/SKILL.md`.
22+
- For site-creator work, consult `skills/site-creator/SKILL.md`.
23+
- For studio work, consult `skills/studio/SKILL.md`.
24+
- For theme-creator work, consult `skills/theme-creator/SKILL.md`.
25+
- For wordpress-creator work, consult `skills/wordpress-creator/SKILL.md`.
26+
27+
When a task maps to one of those skills, use the relevant `skills/<name>/SKILL.md` file as the detailed playbook. Start with `skills/wordpress-creator/SKILL.md` for broad WordPress implementation requests.

plugins/roo-code/AGENTS.md

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
# WordPress.com Roo Code Agent Rules
2+
3+
This output packages the shared Build with WordPress skills for Roo Code.
4+
5+
- Roo-specific files live in `.roo/`: workspace rules in `.roo/rules/` and MCP configuration in `.roo/mcp.json`.
6+
- Shared WordPress.com behavior lives in `skills/` and the existing WordPress Studio MCP flow.
7+
- Do not create a new WordPress backend service for Roo Code. Connect Roo to the existing `studio mcp` server and bundled `wordpress-telemetry` server.
8+
- Use the exact product name WordPress.com in user-facing text.

plugins/zed/AGENTS.md

Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,22 @@
1+
# WordPress.com Zed Instructions
2+
3+
Use WordPress.com as the user-facing product name.
4+
5+
## Role
6+
7+
You help users build, customize, audit, and troubleshoot WordPress.com sites using the smallest suitable WordPress abstraction.
8+
9+
## Workflow
10+
11+
- Start by loading the `wordpress-creator` skill for WordPress.com build, theme, block, plugin, site-creation, or audit requests.
12+
- Prefer the WordPress Studio MCP server for site discovery, local site control, screenshots, block validation, and `wp_cli` access.
13+
- Use WordPress.com / Jetpack-connected MCP tools through the existing Studio MCP flow when the task targets a connected WordPress.com site.
14+
- Choose existing WordPress features and known plugins before creating custom code.
15+
- Use custom block plugins for reusable editor blocks that core blocks cannot cover.
16+
- Use custom plugins for reusable behavior that should survive theme changes.
17+
- Use theme work for templates, layout, styling, and visual presentation.
18+
- Verify changes with the relevant Studio MCP tools before calling the task complete.
19+
20+
## Shared Substrate
21+
22+
The WordPress.com MCP and agent substrate is shared across Zed, OpenCode, Codex, Claude Code, Cursor, Gemini, Copilot, and Roo Code. Zed-specific files only adapt discovery and MCP configuration to Zed's native `AGENTS.md`, `.agents/skills/`, and `.zed/settings.json` conventions.

0 commit comments

Comments
 (0)