Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.qredence.ai/llms.txt

Use this file to discover all available pages before exploring further.

This page records the accepted adaptive-workspace contract for Fleet Pi. It defines the canonical durable state, the manifest and section boundaries, and the non-canonical projection layer that may accelerate queries but never replaces files.

​
Canonical boundary

agent-workspace/ is the canonical durable adaptive state.
  • Durable memory, skills, plans, evals, and artifacts remain path-backed files.
  • Workspace-installed Pi resources and policy material follow the same rule: reviewable files win over caches, rows, or hidden runtime state.
  • scratch/ is non-canonical temporary space. It can hold disposable working files, but it is not durable adaptive memory.
  • agent-workspace/indexes/ stores non-canonical projection data. Projection rows may accelerate search, health, provenance, or query flows, but canonical files still decide what Fleet Pi knows.

​
Accepted workspace shape

The accepted contract centers on a manifest plus named section families: 
agent-workspace/
├── manifest.json
├── instructions/
├── memory/
├── plans/
├── skills/
├── evals/
├── artifacts/
├── scratch/
├── pi/
├── policies/
└── indexes/
agent-workspace/manifest.json describes the workspace shape and the versioned policy of the adaptive layer. Bootstrap may seed missing artifacts later, but the names and semantics of the sections above are fixed.

​
Section families

SectionPurpose
instructions/Durable orientation and operational guidance that survives sessions
memory/Durable project knowledge, daily notes, and research
plans/Explicit execution plans and backlog state
skills/Repo-local agent skills and supporting examples/evals
evals/Checklists, scorecards, and regression-oriented evaluation material
artifacts/Durable reports, datasets, traces, and reusable outputs
scratch/Temporary working files only
policies/Durable policy and safety artifacts for the workspace
indexes/Projection / query state only — never canonical

​
Workspace-installed Pi resources

The canonical home for chat-installed Pi resources is inside agent-workspace/pi/:
  • agent-workspace/pi/skills
  • agent-workspace/pi/prompts
  • agent-workspace/pi/extensions
  • agent-workspace/pi/packages
These directories stay canonical because the installed resource itself is a reviewable file or directory in the repository.

​
.pi/settings.json compatibility bridge

.pi/settings.json remains the compatibility bridge between the Pi runtime and workspace-native resources. It may point Pi at agent-workspace/pi/*, but it does not replace the workspace as the durable store.

​
Non-regression rules

  • Never promote indexes/ rows above canonical files.
  • Never treat session state as durable memory.
  • Never write durable memory outside of the section families above.
  • Bootstrap, health, indexing, and query surfaces must remain projections — they read canonical files, they do not replace them.

Agent workspace

Human-facing tour of what lives in agent-workspace/.

Architecture

How the workspace, web app, and Pi runtime fit together.