From a8d0e90a12b49f793b695a36d2bb6d73419c1118 Mon Sep 17 00:00:00 2001 From: Jimisola Laursen Date: Mon, 22 Jun 2026 18:11:53 +0200 Subject: [PATCH 1/3] fix(claude): commit .claude/settings.json to auto-enable reqstool plugins The reqstool@reqstool-ai and reqstool-openspec@reqstool-ai plugins were never installed for this repo's checkout path, since .claude/ was blanket-gitignored and the marketplace/enabledPlugins config that reqstool-client commits was never added here. Mirrors reqstool-client's .gitignore/.claude/settings.json pattern so a fresh clone gets both plugins auto-enabled. Signed-off-by: Jimisola Laursen --- .claude/settings.json | 15 +++++++++++++++ .gitignore | 3 ++- 2 files changed, 17 insertions(+), 1 deletion(-) create mode 100644 .claude/settings.json diff --git a/.claude/settings.json b/.claude/settings.json new file mode 100644 index 0000000..876c06b --- /dev/null +++ b/.claude/settings.json @@ -0,0 +1,15 @@ +{ + "extraKnownMarketplaces": { + "reqstool-ai": { + "source": { + "source": "github", + "repo": "reqstool/reqstool-ai" + }, + "autoUpdate": true + } + }, + "enabledPlugins": { + "reqstool@reqstool-ai": true, + "reqstool-openspec@reqstool-ai": true + } +} diff --git a/.gitignore b/.gitignore index 1c7c3d1..670f108 100644 --- a/.gitignore +++ b/.gitignore @@ -45,4 +45,5 @@ buildNumber.properties ### VisualStudioCode ### .vscode/* -.claude/ +.claude/* +!.claude/settings.json From 69e7e7eea1728a4542b49a151f84a0275cb2135c Mon Sep 17 00:00:00 2001 From: Jimisola Laursen Date: Mon, 22 Jun 2026 18:34:51 +0200 Subject: [PATCH 2/3] docs(contributing): note openspec update for opsx commands/skills Generated tool scaffolding (.claude/commands/opsx/, .claude/skills/ openspec-*) is intentionally not committed (same convention as reqstool-client#416) -- contributors using Claude Code need to regenerate it locally after cloning. Signed-off-by: Jimisola Laursen --- CONTRIBUTING.md | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index d5ecba2..de978a1 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -16,6 +16,14 @@ git clone https://github.com/reqstool/reqstool-java-maven-plugin.git cd reqstool-java-maven-plugin ``` +If using Claude Code, regenerate the `opsx` slash commands and OpenSpec skills +(`.claude/commands/opsx/`, `.claude/skills/openspec-*`) after cloning — they're +CLI-generated tool scaffolding, not committed to the repo: + +```bash +openspec update # or: openspec init --tools claude --force +``` + ## Build & Test ```bash From 06619194a3d7141dada64e0b49fec0d35b86fa13 Mon Sep 17 00:00:00 2001 From: Jimisola Laursen Date: Tue, 23 Jun 2026 17:38:56 +0200 Subject: [PATCH 3/3] docs(contributing): document reqstool/openspec CLI prerequisites Neither CLI was documented as a prerequisite anywhere. Also notes the Claude Code marketplace/plugin prompt contributors will see on first open, now that .claude/settings.json enables it by default. Signed-off-by: Jimisola Laursen --- CONTRIBUTING.md | 12 +++++++++--- 1 file changed, 9 insertions(+), 3 deletions(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index de978a1..cced6c0 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -8,6 +8,8 @@ For DCO sign-off, commit conventions, and code review process, see the organizat - Java 21+ - Maven 3.9+ +- [reqstool](https://github.com/reqstool/reqstool-client) (`pipx install reqstool`) +- [OpenSpec](https://github.com/Fission-AI/OpenSpec) (`npm install -g @fission-ai/openspec`) ## Setup @@ -16,9 +18,13 @@ git clone https://github.com/reqstool/reqstool-java-maven-plugin.git cd reqstool-java-maven-plugin ``` -If using Claude Code, regenerate the `opsx` slash commands and OpenSpec skills -(`.claude/commands/opsx/`, `.claude/skills/openspec-*`) after cloning — they're -CLI-generated tool scaffolding, not committed to the repo: +If using Claude Code, opening this repo will prompt you to confirm adding the `reqstool-ai` +marketplace and enabling the `reqstool`/`reqstool-openspec` plugins (configured in +`.claude/settings.json`) — accept the prompt. + +Then regenerate the `opsx` slash commands and OpenSpec skills +(`.claude/commands/opsx/`, `.claude/skills/openspec-*`) — they're CLI-generated tool scaffolding, +not committed to the repo: ```bash openspec update # or: openspec init --tools claude --force