BotShelf Vampire BOTSHELF VAMPIRE Register

Library · Team · CrewAI · doc-review

AI Team crewai Documentation Untested multi-agent free

Doc Review — CrewAI

Review docs for clarity, broken promises, and missing prerequisites before publish. (CrewAI multi-agent Python sketch for one job.)

Id: crewai/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

AI Team for CrewAI. Review docs for clarity, broken promises, and missing prerequisites before publish. (CrewAI multi-agent Python sketch for one job.)

How this runtime fits

This CrewAI sketch is a AI Team implementation typed as AI Team in the catalog. Where roles coordinate, it is fair to call it an agent team or multi-agent system — not a swarm.

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

What it does

Review docs for clarity, broken promises, and missing prerequisites before publish. (CrewAI multi-agent Python sketch for one job.)

Who for

Builders working on Documentation jobs who can run CrewAI themselves.

Works with

Need to run

How to use

  1. Create a venv; install CrewAI (pin versions yourself).
  2. Configure a local OpenAI-compatible base URL when possible.
  3. Save crew_doc_review.py and run: python crew_doc_review.py
  4. Replace PASTE_EXAMPLE_IN with your real input.
  5. Read Pass/Fail gate output before trusting the draft.

Limitations

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.

# crew_doc_review.py — Doc Review (CrewAI)
# Safety: local/OpenAI-compatible endpoint preferred. No keys in source.
# pip install crewai  (pin versions yourself)

from crewai import Agent, Task, Crew, Process

SYSTEM = """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"""

GOAL = "Review docs for clarity, broken promises, and missing prerequisites before publish."

lead = Agent(
    role="Doc Review lead",
    goal=GOAL,
    backstory="Local BotShelf operator. One job, then stop. No spend. No destructive tools.",
    allow_delegation=False,
    verbose=False,
)

reviewer = Agent(
    role="Quality gate",
    goal="Check the lead output against the required sections; list gaps only.",
    backstory="Pedantic reviewer. Does not invent facts.",
    allow_delegation=False,
    verbose=False,
)

produce = Task(
    description=(
        "Follow SYSTEM strictly.\n\nSYSTEM:\n" + SYSTEM +
        "\n\nUSER INPUT:\n{user_input}"
    ),
    expected_output="Complete Doc Review structured result.",
    agent=lead,
)

gate = Task(
    description=(
        "Verify the previous result has all required sections. "
        "Return Pass/Fail + missing sections. Do not rewrite creatively."
    ),
    expected_output="Pass/Fail and gap list.",
    agent=reviewer,
)

crew = Crew(
    agents=[lead, reviewer],
    tasks=[produce, gate],
    process=Process.sequential,
)

def run(user_input: str) -> str:
    return str(crew.kickoff(inputs={"user_input": user_input}))

if __name__ == "__main__":
    print(run("PASTE_EXAMPLE_IN"))
Doc draft:
# Fork a team
1. Click Fork
2. Edit
3. We auto-publish to production
Prereq: none
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

Two-agent crew (produce + gate). Keep tools disabled unless you add read-only tools on purpose.

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

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

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

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