Artefacts

The Artefact Library

Where every artefact in your workspace lives — filterable, searchable, grouped by collection, and inspectable down to per-version history.

The Artefact Library is the home for every artefact in your workspace — across every playbook, every company you can see, and every collection you've set up. Open it from the sidebar's Artefacts entry. This page is the canonical look-up for finding what you need fast.

Video walkthrough — coming soon

How the Library is organised

There are three layers of organisation, from coarse to fine:

Collections

A grouping you assign artefacts to. Collections appear as headed sections in the Library so related artefacts cluster visually.

Filters

Narrow the visible set by kind, category, status, or collection. Filters compose — kind and status, etc.

Search

Keyword search across titles and metadata; semantic search across content (when enabled by your workspace).

Detail pane

Click any artefact to open a detail pane with the body, the metadata, and a version history drawer.

The filters, in detail

Filter What it does Useful for
Kind Show only managed / derived / generated / referenced. Finding the AI-generated set vs the human-managed set.
Category Show only decisions / actions / questions / risks / deliverables / strategy / policy / vision. Reviewing all open risks; auditing decisions.
Status Show only artefacts at a particular point in the lifecycle (draft → archived). Cleaning up drafts; reviewing what's awaiting confirmation.
Collection Restrict to one collection (including "Unorganized"). Working inside a single playbook's body of work.

Filters compose, so a query like "show me all proposed decisions in the Northwind collection" is a three-filter set away.

Collections, including "Unorganized"

Collections are how you keep the Library navigable as it grows. Some come from Gleo automatically:

  • Per-playbook collections — every playbook has its own collection (Playbook: ) so its artefacts cluster together.
  • Custom collections — you can create your own for cross-playbook bodies of work (e.g. Quarterly strategy, Active client engagements).
  • Unorganized — the collection artefacts land in if you don't assign them anywhere.

"Unorganized" is a real collection. Anything you don't explicitly file ends up there. A growing Unorganized list is the signal that your team is creating artefacts faster than they're filing them — assign them to a collection (it's a one-click change from the detail pane) to keep this list short.

Searching the Library

Two search modes, side-by-side in the Library's search bar:

  • Keyword search — matches against artefact titles and metadata. Always available.
  • Semantic search — matches against the content of artefacts using embeddings, so a query like "concerns about delivery timeline" finds artefacts that don't literally use those words. Available when your organisation has the semantic-search feature enabled.

Semantic search is especially useful for the long tail — finding the relevant decision from six months ago when you can't remember exactly what it was called.

The detail pane

Click any artefact in the Library to open it. The detail pane has three parts:

  • Body — the artefact's content (or a preview, if it's an external pointer).
  • Metadata — kind, category, content mode, status, collection, owner, and timestamps.
  • Version history drawer — every prior version, with the ability to inspect each one.

The version history drawer is where the lifecycle becomes visible: each promote, each new version, each supersede shows up as a row. See Statuses and versioning for the full lifecycle.

Creating a new artefact

The New artefact button in the Library top-bar opens the create flow. The full walkthrough — picking kind, category, and content mode — is in Creating an artefact.

Walkthrough

  1. 1

    Open the Library

    Sidebar → Artefacts. Scan the collection headers; the largest collections will probably be your most active playbooks.

  2. 2

    Filter to what you want

    For example: kind = managed, status = active. The Library re-renders to show only artefacts that match.

  3. 3

    Search

    Type a keyword in the search bar. If semantic search is enabled, also try a more conceptual query — "decisions about pricing" — to surface artefacts you wouldn't find with keywords alone.

  4. 4

    Open the detail pane

    Click an artefact. Read the body, check the metadata, and open the version history drawer to see the history of changes.

Tips & pitfalls

Filter, don't scroll. Once your Library has more than a screen of content, switching to the filters is faster than scrolling. The combination of kind + status alone usually narrows things by 80%.

Use semantic search for "I'm sure we discussed this once". It's the highest-leverage way to find old context that you can't quite remember the exact words for.

Related pages