From 325630d1025d3669df79566e852566bb8f90cffe Mon Sep 17 00:00:00 2001 From: William Jacoby Date: Sun, 1 Nov 2026 20:02:45 -0600 Subject: [PATCH 1/2] phpbb-development-topics: require the update gallery and check each forum Update posts end with a dated docs/update/YYYY-MM-DD/ screenshot gallery, prepared with the draft and pinned to its commit. The skill didn't say so, and a Contact Admin update went out without one. Also: an extension can have a development topic on more than one forum; reread a shared draft for each forum; look up each forum's disclosure rules in memory before drafting; check a post's ID and author before editing it, since team accounts can edit other members' posts; and check the gallery images load after posting. Co-Authored-By: Claude Opus 5.5 --- phpbb-development-topics/SKILL.md | 16 +++++++++++++--- 1 file changed, 13 insertions(+), 3 deletions(-) diff --git a/phpbb-development-topics/SKILL.md b/phpbb-development-topics/SKILL.md index 9a2fbb2..e443179 100644 --- a/phpbb-development-topics/SKILL.md +++ b/phpbb-development-topics/SKILL.md @@ -20,6 +20,8 @@ Search the topic-creation memory for the project/repository and purpose before c - If no usable record exists, search the relevant forum for an existing current-maintainer development topic. No memory hit does not prove that no topic exists. If lookup is inconclusive, resolve that uncertainty before creating a duplicate. - For an adopted extension, distinguish the previous maintainer's historical topic from the current-maintainer development topic. When the user requests a new maintainer topic, leave the historical topic untouched. Describe the actual maintenance relationship accurately; do not call an adopted project a fork without evidence. +An extension can have a current-maintainer development topic on more than one forum, such as the maintainers' own board and phpBB.com. Check each forum the project announces on, and update every one of its topics in the same way. + Use a verified existing current-maintainer topic for updates. Do not open a new topic for each release. Keep extension-specific names, IDs, URLs, ownership history, and created-topic records in project records or the configured persistent memory, not hard-coded into this reusable skill. ## Announcement means the development topic's first post @@ -35,6 +37,14 @@ Keep two `.bbcode.txt` files in the release-drafts directory, `repo-releases//docs/update/...`) rather than a branch, so the post keeps showing the same images if later commits change or move them. That commit must be pushed before the post goes up, so the images load. If an update has nothing visible to show, ask the user before posting it without a gallery. + +### One draft, several forums + +When the same update goes to more than one forum, reread the draft for each one. Change only wording that would be wrong there, such as "in this topic" for something that happened on another forum, and show the user each changed line for approval. + Use stock phpBB BBCode and the supported `[c]` inline-code tag. Validate tag balancing, links, and claims against current source and verified releases. Do not claim an unpublished release is available. Present drafts in four-backtick fences when displaying their complete text in chat. ### Required Community section @@ -48,7 +58,7 @@ Always include the phpBB Modders forum and Discord links in every forum announce Check that both destinations and their links survive the rendered preview before posting. Follow a newer user-supplied community destination if the user changes these links. Do not automatically add community promotion to an ordinary CDB support reply or post an announcement without the required wording approval. -Follow the user's current attribution/disclosure rules. Obtain approval for the complete public wording, including its closing line, before posting or editing. Retain approval already given for unchanged text; a maintainer correction must carry through the draft and actual post. Never infer permission to send from a release publication alone. +Follow the user's current attribution/disclosure rules. Before drafting, look them up in the agent's persistent memory and instructions for each forum the post will go to, since they can differ between forums and between first posts and replies (for example, a closing note naming the AI assistant that wrote a reply), and apply them to every post written for the user. Obtain approval for the complete public wording, including its closing line, before posting or editing. Retain approval already given for unchanged text; a maintainer correction must carry through the draft and actual post. Never infer permission to send from a release publication alone. ## Create a new topic @@ -64,9 +74,9 @@ Only after duplicate checks and posting authorization: For the verified current-maintainer development topic: -1. Replace its first post with the latest approved complete announcement. +1. Replace its first post with the latest approved complete announcement. Open the edit form from that post's own ID and check its author first: a moderator or team account can edit other members' posts, so a wrong post ID would overwrite someone else's text. 2. Post the approved update as a **new reply in that same topic**. -3. Verify both live results and provide their direct URLs in chat. Do not create a separate update topic. +3. Verify both live results, including that the update's gallery images load, and provide their direct URLs in chat. Do not create a separate update topic. If only one action succeeds, report it precisely. Check the live topic before retrying to avoid duplicate replies. From 9180a072079bed0716808462a6c2b629e6615bc3 Mon Sep 17 00:00:00 2001 From: William Jacoby Date: Sun, 1 Nov 2026 20:15:05 -0600 Subject: [PATCH 2/2] phpbb-development-topics: give update posts an AI Disclosure section The announcement already had one; update posts didn't. Each update now says which AI assistant did which of its changes, testing, screenshots and wording, checked against the commits, and keeps any forum-specific closing note. Co-Authored-By: Claude Opus 5.5 --- phpbb-development-topics/SKILL.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/phpbb-development-topics/SKILL.md b/phpbb-development-topics/SKILL.md index e443179..c3a347a 100644 --- a/phpbb-development-topics/SKILL.md +++ b/phpbb-development-topics/SKILL.md @@ -41,6 +41,10 @@ Keep two `.bbcode.txt` files in the release-drafts directory, `repo-releases//docs/update/...`) rather than a branch, so the post keeps showing the same images if later commits change or move them. That commit must be pushed before the post goes up, so the images load. If an update has nothing visible to show, ask the user before posting it without a gallery. +### AI disclosure in both posts + +The announcement and every update post each carry an **AI Disclosure** section, in the same heading style as the post's other sections. In an update, it covers only that update: say which AI assistant did which of its changes, testing, screenshots and post wording, named plainly ("Claude wrote…", "Codex tested…"). Check the commits or pull requests before crediting an assistant; a change with no AI co-author or note is not credited to one. Put it after the development-build notice and before the Thanks and License sections. It does not replace a forum's own closing note when the user's rules ask for one. + ### One draft, several forums When the same update goes to more than one forum, reread the draft for each one. Change only wording that would be wrong there, such as "in this topic" for something that happened on another forum, and show the user each changed line for approval.