Skip to content

discussion: three kinds of entities — fact, guideline, observation #183

@vinodmut

Description

@vinodmut

Thinking through what kinds of knowledge are worth storing in an entity knowledge base. Three types seem natural:

Factswhat exists. Properties of the environment, tools, or user. Semantic memory.
e.g. "GitHub traffic API requires admin access."

Guidelineshow to act. Rules that steer the agent toward better execution.
e.g. "Read a file before editing it."

Observationswhy something is the way it is. Design rationale and decision context. Useful for explainability — answering "why did we do it this way?" rather than directing future action.
e.g. "Recall and learn logs are kept separate so they can be read independently to diagnose knowledge saturation."

The short version: facts are about what, guidelines are about how, observations are about why.

Interested in whether this taxonomy resonates and what others think about how these should be captured and surfaced differently.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions