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…
0 upvotes
Log in to upvote or save- Made by
- ruvnet
- Pinned commit
-
13af5f1208960c98832d6d9096a8d7ec45bcdc3e - 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
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
Paste this into your README. The badge says reviewed once the current version has been reviewed, and links readers to this page.
[](https://modsforclaude.com/mods/ruflo-docs/)