# Workspace knowledge

Workspace knowledge keeps a fact useful after one task has finished. It is for information that should be found again, such as a company decision, a person detail or a site fact. Each entry carries provenance so readers can see where it came from.

## Choose the right place

Use a task for work in progress and task-specific facts. Use workspace knowledge for facts that should be reusable across work. Do not copy a fact into several places just to make it visible; link the work to the knowledge instead.

An agent reads and writes durable workspace knowledge through `manage_knowledge`. Task facts are separate: ask the agent to use `manage_task` when the fact belongs to one task.

## Add a fact with its source

State the fact clearly and include a source that someone can check. If the fact changes, update it with the new evidence. If it is no longer true, retire it instead of silently leaving it to mislead the next reader.

## A prompt to try

```
Search workspace knowledge for the current site access arrangements. Show the source and date for each match. Do not change anything.
```

```
Draft a knowledge entry for this approved decision. Include the decision, source, date and any review point. Show me the draft before saving it.
```

## Review facts when evidence changes

Knowledge is useful because it can be trusted. Recheck it when its source changes or its validity date arrives. Keep the evidence with the entry so an agent can report what it knows and where that knowledge came from.

## Connected records

Forge can record a link between related workspace things, such as a task and its document, a person and a site, or a form response and the work it supports. These links help an agent and a reader follow the related records without treating every nearby item as connected.

Connections only show what has actually been recorded. They do not prove that every file, task or person with a similar name belongs together. Check the linked record and its source before relying on it for a decision.

```
Show the records linked to this task and explain the relationship recorded for each one. Do not create or change links.
```

See [Tasks: keep a job together](/help/tasks) and [Skills](/help/skills).