From 1e9b9b7566dd373abb82d9a04935f1395db84787 Mon Sep 17 00:00:00 2001 From: Pierre Brisorgueil Date: Mon, 23 Feb 2026 08:12:26 +0100 Subject: [PATCH 1/2] chore(docs): add JSDoc guardrail to always-on guardrails in CLAUDE.md --- CLAUDE.md | 1 + 1 file changed, 1 insertion(+) diff --git a/CLAUDE.md b/CLAUDE.md index 78184aaf2..d404f858c 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -53,6 +53,7 @@ The `.claude/` folder contains embedded settings, skills, and agents that are av - Avoid risky renames or moves of core stack paths used by downstream merges - Keep changes minimal and merge-friendly for downstream projects - Flag security or mergeability risks explicitly in reviews +- Every new or modified function must have a JSDoc header: one-line description, `@param` for each argument, `@returns` for any non-void return value (always include `@returns` for async functions to document the resolved value) ## Available embedded skills From 5a5fbd11a551b0827d5652fba7e02f728fe150fa Mon Sep 17 00:00:00 2001 From: Pierre Brisorgueil Date: Mon, 23 Feb 2026 08:23:34 +0100 Subject: [PATCH 2/2] chore(docs): add pr skill monitor loop entry to ERRORS.md --- ERRORS.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ERRORS.md b/ERRORS.md index 6db89ee8e..bdcf2f0fc 100644 --- a/ERRORS.md +++ b/ERRORS.md @@ -14,4 +14,4 @@ Use this file as a compact memory of recurring AI mistakes. - [2026-02-22] functions: new or modified functions without JSDoc header -> always add JSDoc (description + `@param` for each arg + `@returns` for non-void return values and all async functions) - [2026-02-22] tests: never patch code to pass a test -> if a test is wrong, fix the test; if logic needs refactoring, refactor it - [2026-02-23] pr skill: stopping after `gh pr ready` -> always enter the monitor loop (wait CI → 3min grace → read feedback → iterate) until stop condition is met -- [2026-02-23] pr skill: skipping issue creation when none found -> always create a GitHub issue before opening a PR (`gh issue create --web` or via CLI) \ No newline at end of file +- [2026-02-23] pr skill: skipping issue creation when none found -> always create a GitHub issue before opening a PR (`gh issue create --web` or via CLI)