Doc Review — n8n

Review docs for clarity, broken promises, and missing prerequisites before publish. (n8n workflow recipe (Manual Trigger → LLM → output).)

Id: n8n/doc-review · Slug: doc-review · Status: Untested · Untested on this machine — recipe reviewed for safety (no secrets, no destructive commands, no auto-spend). Mark tested after you run it locally.

What is this

Workflow for n8n. Review docs for clarity, broken promises, and missing prerequisites before publish. (n8n workflow recipe (Manual Trigger → LLM → output).)

How this runtime fits

This n8n implementation is primarily an AI workflow / agentic workflow for the parent AI Team. Call it a multi-agent workflow only when the graph actually splits agent-like steps.

Parent AI Team: doc-review · What is an AI Team?

What it does

Review docs for clarity, broken promises, and missing prerequisites before publish. (n8n workflow recipe (Manual Trigger → LLM → output).)

Who for

Builders working on Documentation jobs who can run n8n themselves.

Need to run

You will run this locally or on infra you control.
No production credentials in prompts or committed files.
n8n instance you control
Optional local LLM HTTP endpoint

How to use

In n8n: Import from File → workflow.json (or recreate nodes from the sketch).
Add your local LLM credential/HTTP node in place of the placeholder.
Paste the full system prompt into the LLM node.
Execute once with Example in as input. Inspect output; no schedule yet.

Limitations

Not a substitute for professional legal, medical, or investment advice.
Outputs can be wrong; human review required before publish or spend.
Stage-1 Library items are free recipes — marketplace ready-to-use teams remain separate.
Do not attach billing cloud LLM nodes without a human budget check.

Test status

Status: Untested · Untested on this machine — recipe reviewed for safety (no secrets, no destructive commands, no auto-spend). Mark tested after you run it locally.

Files

workflow.json — Importable n8n workflow sketch
README.md — Safe import notes

Full prompt / config / code

# n8n Recipe — Doc Review

## Full system prompt (put in your LLM node)
You are a documentation reviewer. Goal: ship-ready clarity check.

RULES:
- Flag broken promises, missing prerequisites, and unsafe copy-paste.
- Do not invent product features.
- Prefer concrete edits over vague “improve clarity”.

OUTPUT:
1) Pass/fail for publish
2) Blockers
3) Line-level edit suggestions
4) Prerequisites still missing

## workflow.json
```json
{
  "name": "BotShelf Library \u2014 Doc Review",
  "nodes": [
    {
      "parameters": {},
      "id": "1",
      "name": "Manual Trigger",
      "type": "n8n-nodes-base.manualTrigger",
      "typeVersion": 1,
      "position": [
        0,
        0
      ]
    },
    {
      "parameters": {
        "values": {
          "string": [
            {
              "name": "system",
              "value": "You are a documentation reviewer. Goal: ship-ready clarity check.\n\nRULES:\n- Flag broken promises, missing prerequisites, and unsafe copy-paste.\n- Do not invent product features.\n- Prefer concrete edits over vague \u201cimprove clarity\u201d.\n\nOUTPUT:\n1) Pass/fail for publish\n2) Blockers\n3) Line-level edit suggestions\n4) Prerequisites still missing\u2026"
            },
            {
              "name": "user_input",
              "value": "={{$json.input}}"
            }
          ]
        }
      },
      "id": "2",
      "name": "Prepare Prompt",
      "type": "n8n-nodes-base.set",
      "typeVersion": 3,
      "position": [
        260,
        0
      ]
    },
    {
      "parameters": {
        "notice": "Attach your own local LLM node (Ollama/LM Studio HTTP). Do not enable billing cloud nodes without a human budget check."
      },
      "id": "3",
      "name": "LLM Placeholder",
      "type": "n8n-nodes-base.noOp",
      "typeVersion": 1,
      "position": [
        520,
        0
      ]
    }
  ],
  "connections": {
    "Manual Trigger": {
      "main": [
        [
          {
            "node": "Prepare Prompt",
            "type": "main",
            "index": 0
          }
        ]
      ]
    },
    "Prepare Prompt": {
      "main": [
        [
          {
            "node": "LLM Placeholder",
            "type": "main",
            "index": 0
          }
        ]
      ]
    }
  },
  "meta": {
    "botshelf_job": "doc-review",
    "safety": "manual-trigger-only"
  }
}
```

## README safety
- Trigger is Manual only (no cron spend loops in stage 1).
- Replace LLM Placeholder with a local HTTP node to Ollama/LM Studio when ready.
- Do not store API keys in the workflow JSON committed to git; use n8n credentials store.
- No shell nodes that delete files or push to production.

Example in

Doc draft:
# Fork a team
1. Click Fork
2. Edit
3. We auto-publish to production
Prereq: none

Example out

Publish: fail
Blockers: step 3 claims auto-publish — unsafe/untrue for this shelf
Edits: replace with review queue language; add register prereq if required
Missing: what Fork does not do

Model / runtime notes

Stage-1 recipe is manual-trigger only. Add schedules only after you confirm cost controls.

Canonical Team

Parent: doc-review · implementation_id: n8n/doc-review

GitHub source

teams/doc-review/n8n · commit eb87e8e049fdf9908e438305ff827c7b617505b5 · license: free-use-at-own-risk

Structural check: PASS · env: structural (structural only — does not set Verified)

Related Library items

Related marketplace Team pages

Soft thematic links only — not identity merges. Marketplace Teams ≠ Library AI Team records.

Doc Draft Gate (marketplace Team page — separate entity)
Claude Docs (marketplace Team page — separate entity)