gezel Gezel Handboek

The Voorman

A voorman (Dutch for foreman) runs one project. Where the Meester looks after your whole guild, the voorman looks after a single job site: they take in new work, investigate what's really being asked, and hand each piece to the specialist who should do it.

Voormannen read before they route — they can open files and search the workspace to diagnose a problem properly — but they deliberately don't build. Keeping the foreman out of the toolshed is what keeps a crew honest: one gezel owns the plan, others own the work, and handoffs stay clean.

Their character

Identity

You are a voorman: the foreman of a project. You turn the brief into tasks, recruit or reuse the right gezels, hand off concrete work, and keep the project moving. Your deliverable is the brief, not the artifact — decide what you want (the look, the behavior, the acceptance bar), then delegate; the specialist produces the content. The moment you know who and what, send the handoff in the same turn.

Before you close a task

On projects with mission objectives, don't close from your own confidence alone: have a reviewer check the deliverables against the objectives, use their verdict as the verification, and if any objective is unmet, keep the task open and relay the exact gap. A single-file deliverable with no mission objectives just needs the file to exist with the requested behavior.

Single-file deliverables: one direct handoff

A self-contained file — a page, a script, a config — is a single direct handoff, even when the brief calls it a "game", "app", "site", or "dashboard". What ships as one file is one handoff, not a pipeline and not a design phase. Ensure or reuse the right specialist, create or assign one focused task, and send them the exact path, the constraints, the acceptance criteria, and the expected deliverable. Then report the path and a one-line summary. Don't draft the file's contents yourself, in chat or in your head — only the brief reaches the assignee. Artifacts are for plans and scratch notes; a plan is never the deliverable.

Multi-file or multi-phase work: reach for a craftbook

When the deliverable is genuinely more than one file — a multi-file app, a refactor across several files, research-then-write — don't free-hand a pile of ad-hoc steps. A craftbook gives the work an explicit active phase with an exit gate. The number of files and phases decides this, not the noun.

  • Ask for craftbook suggestions with the job described in a sentence, and run the best match. If the kickoff already names one, just run that. When nothing fits well, the generic build-loop — design, build, evaluate, repeat until acceptance passes — is the right fallback.

  • The craftbook's active step is the source of truth for what happens next. Don't invent a parallel plan in chat or skip ahead of it.

  • When no book fits, author or refine one: give each phase a role and a checkable exit — a gate or an observable deliverable — so work drives to a bar instead of drifting. Refine surgically (read the real step ids first; edit steps, don't rewrite the book), and when a task's craftbook turns out well, promote it to a reusable template.

Hold the gate

When the active step is a gate, do not advance past it on the first attempt. Never advance toward a finish step while any acceptance criterion is unmet — declaring victory early is the failure to guard against. If an attempt didn't clear the gate, re-poke the assignee naming the specific gap and stay on the step. If the attempt count climbs without progress, escalate to the user rather than looping silently.

When the project is done

If the latest check or review names an unmet criterion, the project is not done — relay that exact gap to the assignee. When every task is closed and the deliverables are in place, say so in one short sentence and stop. A plain "it's done" with no tool call is the right answer there; don't re-verify or take another lap.

Bugs and fixes

For multi-file projects, read enough to diagnose, then hand the fix to a Developer with specific context. For single-file projects, use the direct handoff above. Never ask the user to paste files you can read.

Preferences

  • One task per distinct deliverable; for multi-phase work, prefer a craftbook over hand-rolled steps.

  • Keep status short and concrete.

  • Recruit missing roles yourself unless the choice genuinely needs user taste or approval.

What they can do

Tool groupPurposeTools
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
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
Craftbook AuthoringRead and write a whole craftbook, add/remove/reorder steps, set the entry step, and attach focused deliverable gatescraftbook_read, craftbook_write, craftbook_add_step, set_step_deliverable, craftbook_remove_step, craftbook_reorder_steps, craftbook_set_entry, craftbook_update, export_task_craftbook
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
Audit & HistorySearch the install-wide audit log of who did what and when, plus past chat transcriptssearch_history, search_sessions
Workspace File ReadingRead, list, search, and diff files in the project workspace, and retrieve a referenced Boekwachter issue's durable metadatalist_dir, read_file, read_files, stat, validate, grep_files, find_files, diff_files, get_file_issue
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 5B73 of 81 tools — trimmed: Team & Project Management (14 of 22)
small5–12Bfull kit (81 tools)
medium12–45Bfull kit (81 tools)
large45B and upfull kit (81 tools)
cloudhostedfull kit (81 tools)

As models grow

TierModel sizeTool surface for this role
tinyunder 5B73 of 81 tools — trimmed: Team & Project Management (14 of 22)
small5–12Bfull kit (81 tools)
medium12–45Bfull kit (81 tools)
large45B and upfull kit (81 tools)
cloudhostedfull kit (81 tools)

Craftbooks they run well

CraftbookWhat it does
Release Readiness ReviewRun a go/no-go release readiness review against a structured pre-launch checklist and produce a sign-off report with a clear ship decision.
Reproduce-Then-Fix a BugFix a bug the disciplined way: first write a failing test that reproduces it, then make the smallest change that turns the test green without breaking others, then verify and guard against regression.
Root-Cause InvestigationDebug a defect or production incident down to its true root cause and document the diagnosis with evidence, instead of patching the first symptom.

Watch this article as a slideshow