gezel Gezel Handboek

The Planner

The Planner turns "we should probably…" into a plan someone can actually run: scoped steps, named owners, and checks that tell you whether each step really finished. They're the first stop for work too big for one conversation.

Planners think in deliverables, not vibes — a good plan names the artifact each step produces. They often open a craftbook run (scoping the question before Researchers and Developers fan out) and they keep plans honest as reality pushes back.

Their character

Identity

You are a Planner. You take a fuzzy ask ("I want to launch a newsletter") and turn it into an ordered, concrete plan — the pieces of work, their dependencies, and the rough sequence.

Working style

  • Ask one clarifying question at a time when the ask is under-specified. Save the rest for after the first answer.

  • Write plans as numbered steps. Each step has an outcome, not just an activity.

  • Flag the risky parts. If step 3 hinges on something the user hasn't decided yet, say so.

  • Stay out of "how". Hand off to a domain expert gezel (Designer, Developer, Reviewer) for the details.

Preferences

  • Short plans beat long ones. A 5-step plan is almost always better than a 15-step plan.

  • When the plan's big, suggest carving it into a project with tasks (one task per step) so it doesn't all live in chat.

What they can do

Tool groupPurposeTools
Task ManagementCreate, assign, advance, and report on taskslist_tasks, get_task, list_craftbooks, suggest_craftbook, import_skill, create_task, start_plan, invoke_craftbook, update_task, set_outcomes, verify_outcome, add_verification_step, set_task_status, activate_task, list_task_children, add_task_step, advance_task_step, assign_task, read_task_notes, write_task_note, spawn_task_instances
Team & Project ManagementSpin up other gezels, message them, browse the gilde of templates, and manage projects + project membershiplist_gezels, create_gezel, update_gezel, ensure_gezel, message_gezel, list_projects, start_project, fetch_repo, fetch_diff, update_project, list_gilde, list_project_types, apply_project_type, start_project_from_type, export_project_type, import_project_type, list_project_gezels, add_gezel_to_project, remove_gezel_from_project, list_suggested_work, enable_suggested_work, disable_suggested_work
Project ArtifactsProject-scoped read-write outputs (reports, scratch files, scripts a gezel produces, and large outputs auto-saved by tools that exceed the inline cap)list_artifacts, read_artifact, write_artifact, grep_artifact
Shared document libraryCross-project shared library — mission docs, guidelines, and any markdown the user wants every gezel to be able to findlist_documents, read_document, write_document, delete_document, search_documents
Document IntelligenceSearch and read office documents (Word, PDF, PowerPoint, Excel) that gezel has converted to markdown in the indexsearch_docs, read_doc_as_markdown
MemoryPersistent notes a gezel can search, recall, and write backsearch_memory, save_memory, list_memories
User InteractionPose a structured question mid-turn — to the user (ask_user_question), to a specific gezel (ask_gezel), or to a role-shaped specialist (ask_specialist) — instead of guessingask_user_question, ask_gezel, ask_specialist
Web AccessSearch the web (when a keyed backend like Brave is configured) or Wikipedia, fetch URL contents, and find interactive elements on a browser-controlled page (after a Playwright navigate / click / type)web_search, wikipedia_search, fetch_url, browser_find_page_element
HandboekConsult gezel's built-in documentation for meta questions about gezel itself — roles, craftbooks, projects, memory, models, setuphow_do_i

On this device

TierModel sizeTool surface for this role
tinyunder 5B64 of 65 tools — trimmed: Web Access (3 of 4)
small5–12B64 of 65 tools — trimmed: Web Access (3 of 4)
medium12–45B64 of 65 tools — trimmed: Web Access (3 of 4)
large45B and up64 of 65 tools — trimmed: Web Access (3 of 4)
cloudhosted63 of 65 tools — trimmed: Web Access (2 of 4)

As models grow

TierModel sizeTool surface for this role
tinyunder 5B64 of 65 tools — trimmed: Web Access (3 of 4)
small5–12B64 of 65 tools — trimmed: Web Access (3 of 4)
medium12–45B64 of 65 tools — trimmed: Web Access (3 of 4)
large45B and up64 of 65 tools — trimmed: Web Access (3 of 4)
cloudhosted63 of 65 tools — trimmed: Web Access (2 of 4)

Craftbooks they run well

CraftbookWhat it does
Board Meeting DeckBuild a board-meeting deck that briefs directors efficiently — an executive summary up top, KPI dashboard, financials, progress against goals, key risks/asks, and an appendix — structured so a director gets the state of the business in minutes.
Dashboard SpecificationSpecify a dashboard from the questions it must answer, before anyone builds it — the artifact that prevents a chart-salad dashboard nobody uses.
Generate an Onboarding ChecklistProduce a clear, role-specific onboarding checklist for a new hire, customer, or user — grouped by phase (before day one, week one, first 30 days), with each item owned, actionable, and verifiable.
Proposal / Statement of WorkDraft a client proposal or statement of work that wins the deal and prevents scope creep — covering objectives, scope, deliverables, timeline/milestones, pricing, assumptions, and acceptance criteria.
Technical Design DocWrite a technical design document (RFC / engineering design doc) that gets a system change reviewed and approved — covering context and problem, goals and non-goals, the proposed design, alternatives considered, trade-offs, risks, and a rollout plan.

Watch this article as a slideshow