Move trajectory storage under .agentworkforce

.gitignore

@@ -31,5 +31,6 @@ npm-debug.log*
 # Trajectories - don't commit active work
 .relay
 trail-viewer/.build
+.agentworkforce/trajectories/active/
 .trajectories/active/
 .agent-relay/

AGENTS.md

@@ -84,7 +84,7 @@ trail complete --summary "Added JWT auth with refresh tokens" --confidence 0.85
 
 After completing work, compact the finished trajectory or merged PR into a
 durable summary. When the compacted summary is sufficient, discard the raw
-source trajectories so `.trajectories/index.json` and list output stay focused:
+source trajectories so `.agentworkforce/trajectories/index.json` and list output stay focused:
 
 ```bash
 trail compact --discard-sources

IMPLEMENTATION-PROPOSAL.md

@@ -81,8 +81,8 @@ What does using agent-trajectories look like day-to-day?
   │  └───────────────────────────────────────────────────────────────┘    │
   │                                                                       │
   │  ✓ Trajectory completed                                               │
-  │  ✓ Exported to .trajectories/traj_a1b2c3.json                        │
-  │  ✓ Summary written to .trajectories/traj_a1b2c3.md                   │
+  │  ✓ Exported to .agentworkforce/trajectories/traj_a1b2c3.json                        │
+  │  ✓ Summary written to .agentworkforce/trajectories/traj_a1b2c3.md                   │
   └──────────────────────────────────────────────────────────────────────┘
          │
          ▼
@@ -618,7 +618,7 @@ agent-trajectories/
 ### Option A: File System Only
 
 ```
-.trajectories/
+.agentworkforce/trajectories/
 ├── active/
 │   └── traj_abc123/
 │       └── trajectory.json
@@ -687,7 +687,7 @@ CREATE VIRTUAL TABLE trajectories_fts USING fts5(
 ### Option C: SQLite + Files (Hybrid)
 
 ```
-.trajectories/
+.agentworkforce/trajectories/
 ├── trajectories.db           # SQLite index + search
 ├── data/
 │   ├── traj_abc123.json      # Full trajectory data
@@ -1305,7 +1305,7 @@ This is the recommended path—a progressive architecture that works for a solo
 │                                                                          │
 │  SOLO DEV (Day 1)                                                        │
 │  ├── npm install agent-trajectories                                      │
-│  ├── File storage (.trajectories/ in repo)                               │
+│  ├── File storage (.agentworkforce/trajectories/ in repo)                               │
 │  ├── CLI: start, status, complete, export                                │
 │  └── Zero config, works immediately                                      │
 │                                                                          │

PROPOSAL-trajectories.md

@@ -1095,7 +1095,7 @@ project/
 ├── src/
 ├── .beads/
 │   └── issues.jsonl
-├── .trajectories/
+├── .agentworkforce/trajectories/
 │   ├── index.json              # Index of all trajectories
 │   ├── bd-123.json             # Full trajectory
 │   ├── bd-123.summary.md       # Human-readable summary
@@ -1129,15 +1129,15 @@ Trajectories support multiple storage backends:
 
 | Backend | Use Case | Notes |
 |---------|----------|-------|
-| **File system** | Default, git-friendly | `.trajectories/` in repo |
+| **File system** | Default, git-friendly | `.agentworkforce/trajectories/` in repo |
 | **SQLite** | Local indexing, search | Same DB as messages |
 | **PostgreSQL** | Multi-user, cloud | Shared team access |
 | **S3/GCS** | Archive, large teams | Cold storage for old trajectories |
 
 ### File System (Default)
 
 ```
-.trajectories/
+.agentworkforce/trajectories/
 ├── index.json                    # Quick lookup index
 ├── active/                       # In-progress trajectories
 │   └── traj_abc123.json
@@ -1480,7 +1480,7 @@ git notes add -m "$(agent-relay trajectory export abc123 --format summary)" abc1
 
 ### Phase 1: Foundation
 - Define trajectory JSON schema (v1)
-- File-based storage (`.trajectories/` directory)
+- File-based storage (`.agentworkforce/trajectories/` directory)
 - CLI: `trajectory new`, `trajectory status`, `trajectory complete`
 - Manual capture via `[[TRAJECTORY:*]]` blocks
 
@@ -1511,7 +1511,7 @@ git notes add -m "$(agent-relay trajectory export abc123 --format summary)" abc1
 
 ## Open Questions
 
-1. **Storage location:** `.trajectories/` in repo vs external database?
+1. **Storage location:** `.agentworkforce/trajectories/` in repo vs external database?
    - In-repo: Versioned with code, but bloats repo
    - External: Scalable, but requires infra
 

README.md

@@ -21,7 +21,7 @@ A **trajectory** is the complete story of agent work on a task:
 Works with any task system: Beads, Linear, Jira, GitHub Issues, or standalone. Trajectories are a universal format—like Markdown for documentation.
 
 ### Multiple Storage Backends
-- **File system** (default) - `.trajectories/` directory, git-friendly
+- **File system** (default) - `.agentworkforce/trajectories/` directory, git-friendly
 - **SQLite** - Local indexing and search
 - **PostgreSQL/S3** - For teams and archival
 
@@ -145,15 +145,15 @@ Use `--discard-sources` when the compacted summary should replace the raw source
       - name: Compact trajectories
         run: |
           PR_COMMITS=$(git log ${{ github.event.pull_request.base.sha }}..${{ github.event.pull_request.head.sha }} --format=%H | paste -sd, -)
-          OUTPUT=".trajectories/compacted/pr-${{ github.event.pull_request.number }}.json"
+          OUTPUT=".agentworkforce/trajectories/compacted/pr-${{ github.event.pull_request.number }}.json"
           if [ -n "$PR_COMMITS" ]; then
             npx agent-trajectories compact --commits "$PR_COMMITS" --output "$OUTPUT" --discard-sources
           else
             npx agent-trajectories compact --pr ${{ github.event.pull_request.number }} --output "$OUTPUT" --discard-sources
           fi
       - name: Commit compacted trajectories
         run: |
-          git add .trajectories/ || true
+          git add .agentworkforce/trajectories/ || true
           git diff --cached --quiet || \
             (git commit -m "chore: compact trajectories for PR #${{ github.event.pull_request.number }}" && git push)
 ```
@@ -463,7 +463,7 @@ The client manages trajectories with persistent storage.
 ```typescript
 const client = new TrajectoryClient({
   defaultAgent: 'my-agent',    // Default agent name
-  dataDir: '.trajectories',     // Storage directory
+  dataDir: '.',                // Base directory; stores under .agentworkforce/trajectories
   autoSave: true,               // Auto-save after operations
 });
 
@@ -542,7 +542,7 @@ const t = TrajectoryBuilder.create('Task')
 This project is in early development. See [PROPOSAL-trajectories.md](./PROPOSAL-trajectories.md) for the full design document.
 
 **v1.0 (current)**
-- [x] File-based storage (`.trajectories/`)
+- [x] File-based storage (`.agentworkforce/trajectories/`)
 - [x] Core CLI commands (`start`, `decision`, `complete`, `list`, `show`, `export`)
 - [x] Agent Trace spec compliance (`.trace.json` generation)
 - [x] Multi-agent participation tracking

biome.json

@@ -30,6 +30,7 @@
       ".openskills",
       ".claude",
       ".agent-relay",
+      ".agentworkforce",
       ".trajectories"
     ]
   }

docs/architecture/core.md

@@ -301,8 +301,8 @@ Trajectory files should be created with restrictive permissions:
 
 Recommend users add to `.gitignore`:
 ```
-.trajectories/active/    # Don't commit in-progress work
-.trajectories/**/*.env   # Any env files
+.agentworkforce/trajectories/active/    # Don't commit in-progress work
+.agentworkforce/trajectories/**/*.env   # Any env files
 ```
 
 ---
@@ -334,7 +334,7 @@ Warn users if trajectory exceeds reasonable size:
 ## Directory Structure
 
 ```
-.trajectories/
+.agentworkforce/trajectories/
 ├── active/                 # In-progress trajectories
 │   └── traj_abc123/
 │       └── trajectory.json

docs/architecture/memory-integration.md

@@ -19,7 +19,7 @@ Each AI coding tool maintains its own isolated context:
 Trajectories and the workspace provide tool-agnostic project memory:
 
 ```
-.trajectories/           # What happened (work history)
+.agentworkforce/trajectories/           # What happened (work history)
 ├── active/              # Current work
 └── completed/           # Past work with full reasoning
 

docs/architecture/web-viewer.md

@@ -9,7 +9,7 @@ A lightweight local web interface for humans to browse and read trajectories in
 1. **Zero external dependencies** - No cloud services, runs entirely local
 2. **Instant startup** - `traj view` opens browser immediately
 3. **No build step** - Works without webpack/vite in dev
-4. **Offline-first** - All data from local `.trajectories/`
+4. **Offline-first** - All data from local `.agentworkforce/trajectories/`
 
 ## Architecture Options
 
@@ -207,7 +207,7 @@ workspace.query({
 
 ## Questions to Resolve
 
-1. **Workspace location**: `.agent-workspace/` vs inside `.trajectories/workspace/`?
+1. **Workspace location**: `.agent-workspace/` vs inside `.agentworkforce/trajectories/workspace/`?
 2. **Knowledge format**: Markdown files vs JSON?
 3. **Pattern templates**: How to make patterns executable/reusable?
 4. **Multi-repo**: How does workspace work across repos?

package.json

@@ -48,9 +48,7 @@
     "type": "git",
     "url": "https://github.com/AgentWorkforce/trajectories"
   },
-  "files": [
-    "dist"
-  ],
+  "files": ["dist"],
   "engines": {
     "node": ">=20.0.0"
   },

scripts/benchmark-compaction.ts

@@ -4,7 +4,7 @@
  *
  * Records a deliberately noisy trajectory (3 chapters, 5+ decisions, 10+
  * findings, 15+ low-significance noise events) using the default
- * TrajectoryClient storage (always `<cwd>/.trajectories/`). The caller is
+ * TrajectoryClient storage (always `<cwd>/.agentworkforce/trajectories/`). The caller is
  * expected to `cd` into an isolated directory before invoking this script.
  *
  * Reads TRAJECTORIES_WORKFLOW_ID from the environment and forwards it to
@@ -69,7 +69,7 @@ async function main(): Promise<void> {
   // ---------- Chapter 2: Implementation ----------
   await session.chapter("Implementation", "benchmark-agent");
   await session.finding(
-    "TrajectoryClient defaults storage to <cwd>/.trajectories",
+    "TrajectoryClient defaults storage to <cwd>/.agentworkforce/trajectories",
   );
   await session.finding("Session API is fully chainable and auto-saves");
   await session.finding("addEvent accepts arbitrary significance levels");
@@ -80,7 +80,9 @@ async function main(): Promise<void> {
   await session.event("thinking", "Will reuse default storage path", {
     significance: "low",
   });
-  await session.event("tool_call", "ls .trajectories", { significance: "low" });
+  await session.event("tool_call", "ls .agentworkforce/trajectories", {
+    significance: "low",
+  });
   await session.event("tool_result", "active/ completed/", {
     significance: "low",
   });

src/cli/commands/compact.ts

@@ -32,7 +32,11 @@ import {
 import { serializeForLLM } from "../../compact/serializer.js";
 import { generateRandomId } from "../../core/id.js";
 import type { Decision, Trajectory } from "../../core/types.js";
-import { FileStorage, getSearchPaths } from "../../storage/file.js";
+import {
+  FileStorage,
+  getDefaultTrajectoryDataDir,
+  getSearchPaths,
+} from "../../storage/file.js";
 
 /**
  * A group of related decisions
@@ -840,7 +844,8 @@ function getDefaultOutputPath(
   compacted: CompactedTrajectory,
   workflowId?: string,
 ): string {
-  const trajDir = process.env.TRAJECTORIES_DATA_DIR || ".trajectories";
+  const trajDir =
+    process.env.TRAJECTORIES_DATA_DIR || getDefaultTrajectoryDataDir();
   const compactedDir = join(trajDir, "compacted");
 
   if (!existsSync(compactedDir)) {

src/cli/commands/complete.ts

@@ -13,7 +13,10 @@ import {
 } from "../../core/trailers.js";
 import { completeTrajectory } from "../../core/trajectory.js";
 import type { TraceRecord, Trajectory } from "../../core/types.js";
-import { FileStorage } from "../../storage/file.js";
+import {
+  FileStorage,
+  getDefaultTrajectoryDataDir,
+} from "../../storage/file.js";
 
 /**
  * Save trace file alongside the trajectory
@@ -24,7 +27,7 @@ async function saveTraceFile(
 ): Promise<void> {
   // Determine trajectory file location based on status
   const dataDir = process.env.TRAJECTORIES_DATA_DIR;
-  const baseDir = dataDir ? dataDir : join(process.cwd(), ".trajectories");
+  const baseDir = dataDir ? dataDir : getDefaultTrajectoryDataDir();
   const completedDir = join(baseDir, "completed");
 
   const date = new Date(trajectory.completedAt ?? trajectory.startedAt);

src/cli/commands/doctor.ts

@@ -4,7 +4,7 @@
  * Diagnose and (optionally) repair trajectory files that fail to load.
  * Reconcile silently skips bad files so the CLI keeps working; doctor
  * surfaces the path + first validation error for each one and can move
- * them into `.trajectories/invalid/` so reconcile stops complaining.
+ * them into `.agentworkforce/trajectories/invalid/` so reconcile stops complaining.
  */
 
 import type { Command } from "commander";
@@ -18,7 +18,7 @@ export function registerDoctorCommand(program: Command): void {
     )
     .option(
       "--quarantine",
-      "Move invalid files to .trajectories/invalid/ so reconcile stops scanning them",
+      "Move invalid files to .agentworkforce/trajectories/invalid/ so reconcile stops scanning them",
     )
     .action(async (opts: { quarantine?: boolean }) => {
       const storage = new FileStorage();
@@ -41,7 +41,7 @@ export function registerDoctorCommand(program: Command): void {
 
       if (!opts.quarantine) {
         console.log(
-          "\nRun `trail doctor --quarantine` to move these files into .trajectories/invalid/.",
+          "\nRun `trail doctor --quarantine` to move these files into .agentworkforce/trajectories/invalid/.",
         );
         return;
       }

src/cli/commands/export.ts

@@ -9,7 +9,10 @@ import type { Command } from "commander";
 import { exportToJSON } from "../../export/json.js";
 import { exportToMarkdown } from "../../export/markdown.js";
 import { exportToTimeline } from "../../export/timeline.js";
-import { FileStorage } from "../../storage/file.js";
+import {
+  FileStorage,
+  getDefaultTrajectoryDataDir,
+} from "../../storage/file.js";
 import { generateTrajectoryHtml } from "../../web/generator.js";
 
 export function registerExportCommand(program: Command): void {
@@ -72,7 +75,10 @@ export function registerExportCommand(program: Command): void {
         }
       } else if (options.open && options.format === "html") {
         // Write to temp location and open
-        const outputDir = join(process.cwd(), ".trajectories", "html");
+        const outputDir = join(
+          process.env.TRAJECTORIES_DATA_DIR ?? getDefaultTrajectoryDataDir(),
+          "html",
+        );
         await mkdir(outputDir, { recursive: true });
         const filePath = join(outputDir, `${trajectory.id}.html`);
         await writeFile(filePath, output, "utf-8");

src/compact/config.ts

@@ -1,6 +1,9 @@
 import { existsSync, readFileSync } from "node:fs";
 import { join } from "node:path";
-import { getSearchPaths } from "../storage/file.js";
+import {
+  getDefaultTrajectoryDataDir,
+  getSearchPaths,
+} from "../storage/file.js";
 
 export interface CompactionConfig {
   provider: string;
@@ -88,7 +91,7 @@ function loadFileConfig(): Partial<CompactionConfig> {
 
 function getPrimaryConfigDir(): string {
   const searchPaths = getSearchPaths();
-  return searchPaths[0] ?? join(process.cwd(), ".trajectories");
+  return searchPaths[0] ?? getDefaultTrajectoryDataDir();
 }
 
 function readStringEnv(name: string): string | undefined {

src/core/trailers.ts

@@ -186,7 +186,7 @@ if [ "$COMMIT_SOURCE" = "merge" ] || [ "$COMMIT_SOURCE" = "squash" ] || [ "$COMM
 fi
 
 # Find the trajectories data directory
-TRAJ_DIR="\${TRAJECTORIES_DATA_DIR:-\$(git rev-parse --show-toplevel)/.trajectories}"
+TRAJ_DIR="\${TRAJECTORIES_DATA_DIR:-\$(git rev-parse --show-toplevel)/.agentworkforce/trajectories}"
 ACTIVE_DIR="$TRAJ_DIR/active"
 
 # Check if there's an active trajectory

src/index.ts

@@ -77,7 +77,12 @@ export type {
 } from "./core/types.js";
 
 // Storage
-export { FileStorage } from "./storage/file.js";
+export {
+  DEFAULT_TRAJECTORY_DATA_DIR,
+  LEGACY_TRAJECTORY_DATA_DIR,
+  FileStorage,
+  getDefaultTrajectoryDataDir,
+} from "./storage/file.js";
 export type { StorageAdapter, StorageConfig } from "./storage/interface.js";
 
 // Export

src/sdk/client.ts

@@ -223,7 +223,7 @@ export async function compactWorkflow(
 export interface TrajectoryClientOptions {
   /** Storage adapter to use. Defaults to FileStorage. */
   storage?: StorageAdapter;
-  /** Base directory for file storage. Defaults to .trajectories */
+  /** Base directory for default file storage. Stores under .agentworkforce/trajectories. */
   dataDir?: string;
   /** Default agent name to use when not specified */
   defaultAgent?: string;