ruflo-docs

Reviewed at commit 13af5f1

Caution: Its skills pre-approve Bash and have Claude run the unpinned npm package @claude-flow/cli@latest through npx, so each new version runs without asking.

Documentation generation, API docs (JSDoc/TSDoc/OpenAPI), and drift detection — drives the `document` background worker via hooks_worker-dispatch; uses Haiku…

Made by
ruvnet
What we checked

Blocks tool calls that would save a doc-related memory entry or start the document worker while the text contains what looks like a key, token or password, and adds /docs-mod for status, a secret check on pasted text and a docs/ folder listing. Its slash command, agent and skills instruct Claude to run an npm package for documentation generation.

Review details

Static review of the source at the pinned commit; not run. Delta review of the changes since 87d8687; the rest carries over from the review at that commit. The only change is a repository field added to plugin.json; no code, hook or prompt changed. Hooks: session.start (registers /docs-mod, reads $.session.root, writes .claude-flow/docs-mod/status.json in the project), tool.call (only when guard is on, the default; denies memory_store calls whose key or namespace looks like docs and hooks_worker-dispatch calls mentioning document if the input matches secret patterns, otherwise passes through) and command.run for docs-mod (status, scan <text>, docs listing via $.fs.list('docs') showing file counts and the newest name, and $.tool.list). Secret screening is local regex matching; findings are names only. No network or process calls in the module. The prompt files (command ruflo-docs, agent docs-writer, skills api-docs and doc-gen) tell Claude to run npx @claude-flow/cli@latest hooks worker dispatch and hooks post-task (unpinned latest download from npm, not reviewed) and to store notes via ruflo-core memory tools; the skills declare allowed-tools Bash(npx *), which pre-approves any npx command, and doc-gen suggests a CronCreate job every two hours. These need the separate ruflo-core MCP server, which is not part of this plugin. scripts/smoke.sh is a dev script the hooks do not load and was not read.

What it uses
  • Reads your prompts: no
  • Sees tool calls: yes
  • Blocks or changes tool calls: yes
  • Reads or writes files: yes
  • Runs programs on your machine: no
  • Calls the model (uses tokens): no
  • Sends data over the network: no
  • Stores data: yes
  • Shows something on screen: yes
Hooked events

Documentation generation, API docs (JSDoc/TSDoc/OpenAPI), and drift detection — drives the `document` background worker via hooks_worker-dispatch; uses Haiku model for cost-efficient docs work

Made this mod? Add a badge to your README

modsforClaude badge for ruflo-docs

Paste this into your README. The badge says reviewed once the current version has been reviewed, and links readers to this page.

[![Listed on modsforClaude](https://modsforclaude.com/badge/ruflo-docs.svg)](https://modsforclaude.com/mods/ruflo-docs/)

← All mods