# Teach the Agent your company's practice

> Capture a preferred material, standard detail or lesson from a finished design, approve it once, and the Agent cites it when it applies.

Status: Available · Level: Everyday · About 5 minutes · Canonical: https://paracrux.com/docs/capture-company-knowledge

## You need

- A design whose design intent, agent instructions or a private library entry records the practice
- Someone who can approve it under their name; that can be you

## You'll come away with

- Capture a practice from a finished design
- Approve it so the Agent can use it
- Revise or revoke it later

## Step by step

1. **Find it.** On a design, open the Design context tab and choose Company knowledge, next to This design and Library.
2. **Propose from a design.** Choose Propose from this design. Pick a Kind (Preferred material, Standard detail or Lesson learned), give a Title, and write the Statement: what to use or do, and why. Optionally say which part classes, tags and limits it applies to. Then tick what to cite: the design intent, agent instructions or a private library entry, as they are now.
3. **Approve it.** A proposal never reaches the Agent. Open it and choose Approve…, read the full statement and its sources, and approve under your name. Only people propose and approve; the Agent cannot.
4. **How the Agent uses it.** When the Agent searches the shared library and an approved entry's title or statement matches, it receives the entry as reference data with its id and version, and is told to cite them. It never overrides your own request or this design's intent.
5. **Keep it current.** Revise… proposes a new version; the current one stays in force until the revision is approved. Revoke… stops the Agent receiving it at once. Each source shows whether the text it cites is current, changed since cited or no longer found.

## Walkthrough

The labels and messages are the app's own. The title, statement, design and names are examples.

- **Company knowledge:** About = Approved entries reach the agent as reference data when its library search matches them, and it cites them by id and version. Only you propose and approve here; the agent cannot. Local to this workspace.; Button = Propose from this design
- Provenance: real-code

- **Propose company knowledge:** Kind = Preferred material; Title = 6082-T6 for machined brackets; Statement = Use 6082-T6 plate for machined brackets up to 20 mm; it machines cleanly and is stocked locally.; Cite = Design intent
- *A proposal never reaches the agent until someone approves it.*
- Provenance: real-code

- **Agent:** Proposed 6082-T6 for machined brackets. It reaches the agent once approved.
- Provenance: real-code

- **Gate:** Once approved, the agent receives this statement as reference data whenever its library search matches it, citing this id and version. It never overrides the user’s own request. You can revoke it later.
- Provenance: real-code

- **Approved · v1:** Provenance = v1 proposed by jsmith 2026-10-01 · approved by J Smith 2026-10-01; Source = Design intent · Brackets / BR-104 rev 3 · current
- Provenance: real-code

## What it won't do

- Entries stay in this workspace on this computer. Nothing is synced to other computers or people.
- Nothing is captured automatically: a person proposes every entry, citing text a design already holds.
- The Agent finds entries by matching words in their title or statement, newest approval first, at most 20 per search.
- Approved entries are reference data. The Agent is told to cite them, but whether it does depends on the model.
- Matching entries go with the conversation to whichever AI connection you use; with a local model they stay on your site.

## Covers

- Company knowledge (Available): Capture a preferred material, standard detail or lesson from a past design, approve it once, and the Agent cites it when it applies. Where: Design context, Company knowledge

## Next

- [Create a simple part from a brief](https://paracrux.com/docs/create-a-simple-part.md): Describe a block with all three sizes and get a checked native part and STEP file. Leave a size out and it asks.