Guides

Append a new section or page only when it does not already exist. If guides_get shows a page with the same title, use guides_update_item instead—do not create duplicates.

guides_append_item

Create a new guide from a top-level GDF 1.0 document (not wrapped in {document:...}). Required: gdf_version "1.0", guide.id, guide.title, assets: [], items[] with unique id+type per item. Page parent_id must reference a section defined earlier. Defaults to draft with ai_readable enabled.

guides_create

Remove one section or page by item_id. Use to delete duplicate pages, outdated sections, or scaffold mistakes. Same as remove_item / delete_item. Call guides_get first to identify the correct item_id.

guides_delete_item

Alias for guides_delete_item. Remove a duplicate or unwanted page/section by item_id from guides_get.

guides_remove_item

Export a single section or page by item id (e.g. item-42).

guides_get_item

Compact structure view: sections, pages, item ids (item-42), and has_content for each. Sections without has_content are empty navigable pages—patch them or avoid creating sections on short guides. Prefer over guides_get when you need item_ids.

guides_outline

List notebooks on the user's account. Start here before editing—find slugs for guides to read or evolve.

guides_catalog

Combine source page markdown into target page, then delete source. Use when consolidating duplicate or overlapping pages.

guides_merge_items

Move a section or page before the start or immediately after another item. Simpler than full reorder when moving one block. Returns success: true and outline (current structure) for verification—use outline in the response before saying Done.

guides_move_item

Read a guide's structure and content (GDF JSON). Each item has id (item-42) and title—use ids with guides_update_item and guides_delete_item. The guide is the artifact you edit.

guides_get