[1.9] Port use_npx_openspec hook and hook-test

[dimuon]

Summary

• Port the stack provider hook that rewrites a bare openspec to npx openspec, plus make hook-test.
• Cursor loads it from .cursor/hooks.json. Claude Code loads the same script and leaves Bash calls unchanged, because the rewrite only handles tool_name Shell.

Relates to elastic/cp-hosted-team#4371.

Test plan

• make hook-test (8 tests)
• make help shows hook-test

Made with Cursor

[Copilot]

Copilot review overview

🟡 Changes recommended

The regex can mutate quoted text while missing real multiline OpenSpec invocations.

Review effort: Balanced
Findings: 1

Open (1)

• Regex misidentifies shell command boundaries · New

What changed in this PR

Adds agent hooks that rewrite bare openspec shell invocations to npx openspec.

Changes:

• Adds Cursor and agent hook configuration.
• Implements and tests the command-rewriting hook.
• Adds make hook-test and updates workflow documentation.

File	Description
.agents/​hooks/​use_npx_openspec.js	Implements hook rewriting.
.agents/​hooks/​use_npx_openspec.test.mjs	Adds eight hook tests.
.agents/​hooks.json	Registers the agent hook.
.agents/​settings.json	Configures Claude Code loading.
.cursor/​hooks.json	Registers the Cursor hook.
build/​Makefile.test	Adds hook-test.
dev-docs/​high-level/​development-workflow.md	Documents hook usage and testing.
dev-docs/​high-level/​openspec-workflows.md	Documents agent-specific behavior.

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

[Copilot]

Copilot review overview

🟢 Approval recommended

The hook integration, tests, Make target, and documentation are internally consistent with no unresolved correctness issues.

Review effort: Balanced
Findings: None

Resolved since last review (1)

• Regex misidentifies shell command boundaries