Main Pieces
Contexity organizes project knowledge into distinct layers, each serving a specific role in the context pipeline.Normal Agent Flow
Every Contexity-assisted task follows a predictable lifecycle. Your host (the AI agent’s execution environment) drives each step.1
Start run
Start a Contexity run with the user task. This opens a ledger entry and anchors the session to the current project identity.
2
Retrieve pack
Retrieve the task-relevant context pack before broad exploration or any edits. Contexity selects items based on task text, trust state, freshness, and your token budget.
3
Map impact
When a file or route becomes relevant, ask Contexity for upstream and downstream impact. The project intelligence graph surfaces what else is likely to be affected.
4
Detect changes
After edits, Contexity maps changed files through the project graph and flags any context items that may now be stale or in need of review.
5
Close run
Record used context, validation results, unresolved threads, and metrics. The run ledger captures what actually happened so future tasks can build on it.
Why Packs Are Bounded
Context packs are intentionally small. Giving an agent too much context is as harmful as giving it too little — old decisions and noisy notes become hidden instructions that silently steer code in the wrong direction. Contexity selects each pack using:- Current task text
- Task plan hints from the host
- Source-backed project intelligence
- Trust state of each context item
- Freshness state of each context item
- Stale-file and deletion-tombstone checks
- Your configured token budget