Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .claude/skills/add-sponsor/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -161,6 +161,6 @@ phones and one from `sm` up, such as `h-10 sm:h-15`.

## 6. Commit

Title `chore(sponsor): add <name>`. Follow the `ddev-commit` skill. Manual
Title `chore(sponsor): add <name>`. Follow `/ddev:commit`. Manual
Testing Instructions compare the preview's `/#supporters` and both badge URLs
against https://ddev.com/, and the PR should include the two badge renders.
6 changes: 3 additions & 3 deletions .claude/skills/bump-deps/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -103,7 +103,7 @@ ddev prettier

## 6. Pull request

Write the commit and PR with the `ddev-commit` skill. Title:
Write the commit and PR with `/ddev:commit`. Title:
`build(deps): bump astro from v<old> to v<new>`, plus any other notable major.

- **Short Summary (TL;DR):** which packages moved to a new major, and whether
Expand All @@ -126,8 +126,8 @@ Write the commit and PR with the `ddev-commit` skill. Title:
mobile views: `/blog/markdown-features-demo/`, `/get-started/`,
`/usage-stats/`, site search, the theme toggle, and anything a major touched
(for example `#featured-sponsors` on the demo post after an image library
change). Take the preview URL from the Cloudflare comment, as the
`ddev-commit` skill describes, because Dependabot aliases always collide and
change). Take the preview URL from the Cloudflare comment, as
`AGENTS.md` describes under PR preview, because Dependabot aliases always collide and
get a random suffix.

- **Release/Deployment Notes:** the majors to watch in the Cloudflare build.
135 changes: 0 additions & 135 deletions .claude/skills/ddev-commit/SKILL.md

This file was deleted.

31 changes: 28 additions & 3 deletions AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@ its own.
| Adding or updating a featured sponsor | `.claude/skills/add-sponsor/SKILL.md` |
| Bumping npm dependencies | `.claude/skills/bump-deps/SKILL.md` |
| Accessibility checks with axe-core and Lighthouse | `.claude/skills/a11y-check/SKILL.md` |
| A commit or PR | `.claude/skills/ddev-commit/SKILL.md` |
| A commit or PR | `/ddev:commit`, see Git workflow |
| A comment, in any code file | `.claude/rules/comments.md` |

Fetch files from GitHub through `raw.githubusercontent.com`; a
Expand Down Expand Up @@ -121,5 +121,30 @@ pushes to a remote, even when asked. The maintainer pushes.

Branch names are `YYYYMMDD_<username>_<short_description>`, for example
`20250919_rfay_update_quickstart`. Commit titles follow Conventional Commits,
and the commit body is reused as the PR description; see
`.claude/skills/ddev-commit/SKILL.md` before writing either.
and the commit body is reused as the PR description. Write both with the
`/ddev:commit` skill from [ddev/agent-skills](https://github.com/ddev/agent-skills).
Install it in Claude Code with
`claude plugin install ddev --marketplace ddev/agent-skills`. Without it,
follow the organization patterns linked above.

### PR preview

Manual Testing Instructions link the PR's Cloudflare preview, not a local dev
server, and compare it against the same path on https://ddev.com/. Name the
exact pages and what to look for. Ask where the branch will be pushed, since
the URL differs, and use a `REPLACE_ME`-style placeholder for anything not
known yet:

- `ddev/ddev.com`: `https://<branch-with-dashes>.ddev-com-front-end.pages.dev/`,
with the subdomain cut to 28 characters
- A fork: `https://pr-<number>.ddev-com-fork-previews.pages.dev/`

Once the PR exists, take the real URL from the Cloudflare comment. It differs
from the computed one when the cut alias collides with an earlier branch's,
which gets a random suffix such as `-kgcv`:

```bash
gh pr view <number> --json comments --jq '.comments[].body' \
| grep -oE 'https://[a-z0-9-]+\.ddev-com-(front-end|fork-previews)\.pages\.dev' \
| grep -vE '^https://[0-9a-f]{8}\.' | sort -u
```
Loading