proagent-documentation

2 events · 4 hooks

Install

Install the plugin

npx claudepluginhub diegouis/provectus-marketplace --plugin proagent-documentation

Want just this hook?

Then install: npx claudepluginhub u/[userId]/[slug]

Risk Indicators

Executes bash commandsModifies files

Source

Defined in hooks/hooks.json

Configuration

{
  "PreToolUse": [
    {
      "hooks": [
        {
          "type": "command",
          "command": "which jq >/dev/null 2>&1 || exit 0; jq -r '.tool_input.command // empty' | { read cmd; if echo \"$cmd\" | grep -qE 'rm -rf.*(docs|documentation|wiki|confluence)|drop.*table.*doc'; then echo 'BLOCK: [proagent-documentation] Destructive operation on documentation directory detected. Aborting — use manual deletion if intentional.' && exit 1; fi; }",
          "timeout": 10
        }
      ],
      "matcher": "Bash"
    },
    {
      "hooks": [
        {
          "type": "command",
          "command": "which jq >/dev/null 2>&1 || exit 0; jq -r '.tool_input.file_path // empty' | { read fp; if [ -f \"$fp\" ] && echo \"$fp\" | grep -qiE '(README|CHANGELOG|CONTRIBUTING|ARCHITECTURE|docs/)\\.md$'; then echo '[proagent-documentation] Warning: overwriting existing documentation file. Review diff before publishing to Confluence.'; fi; }",
          "timeout": 10
        }
      ],
      "matcher": "Write"
    }
  ],
  "PostToolUse": [
    {
      "hooks": [
        {
          "type": "command",
          "command": "which jq >/dev/null 2>&1 || exit 0; jq -r '.tool_input.file_path // empty' | { read fp; if echo \"$fp\" | grep -qiE '\\.(md|rst|adoc|txt)$'; then echo '[proagent-documentation] Documentation file written. Review content for accuracy before publishing to Confluence.'; fi; }",
          "timeout": 5
        }
      ],
      "matcher": "Write"
    },
    {
      "hooks": [
        {
          "type": "command",
          "command": "which jq >/dev/null 2>&1 || exit 0; jq -r '.tool_input.prompt // empty' | { read prompt; if echo \"$prompt\" | grep -qi 'confluence-publisher\\|publish.*confluence\\|create.*confluence'; then echo '[proagent-documentation] Confluence publish completed. Verify the page at your Atlassian site — check formatting, links, and page hierarchy.'; fi; }",
          "timeout": 5
        }
      ],
      "matcher": "Task"
    }
  ]
}

Summary

{
  "riskFlags": {
    "touchesBash": true,
    "matchAllTools": false,
    "touchesFileWrites": true
  },
  "typeStats": {
    "command": 4
  },
  "eventStats": {
    "PreToolUse": 2,
    "PostToolUse": 2
  },
  "originCounts": {
    "absolutePaths": 0,
    "pluginScripts": 0,
    "projectScripts": 0
  },
  "timeoutStats": {
    "commandsWithoutTimeout": 0
  }
}