Skip to content
workspace.json
Blog

Examples

Three workspace.json examples: a TypeScript monorepo, a Python single-package project, and a polyglot repository. Each is synthesized from real open-source repository structures and labeled as such.

Repository: Synthesized from real TypeScript monorepo structure

A large TypeScript monorepo with multiple packages and apps, pnpm workspaces, and mixed runtime targets. The workspace.json reflects a steady-state workspace with behavioral observation data: high observation count, several fragile files identified from real churn patterns.

Notable: the frameworkManifest shows multiple frameworks because the monorepo contains both Next.js (web app) and Hono (API). The agents section references both .cursorrules and AGENTS.md. The coChangePatterns reflect real co-change patterns observed over months of development.

Synthesized from real monorepo structure. Plausible real-world data, not sourced from a specific repository.

{
  "manual": {
    "description": "TypeScript monorepo for a developer tooling platform: web dashboard, API server, and shared packages.",
    "techStack": ["TypeScript", "Next.js 15", "Hono", "PostgreSQL", "Drizzle ORM", "pnpm workspaces"],
    "conventions": [
      "Named exports only: no default exports across any package",
      "All server-side errors throw typed AppError instances; catch only at route boundary",
      "Packages are not pre-built in dev: import from source via tsconfig paths"
    ],
    "fragileFiles": [
      {
        "path": "packages/contracts/src/index.ts",
        "reason": "Shared type definitions. Changes cascade to all consumers: API, web, CLI, packages."
      },
      {
        "path": "apps/api/src/middleware/auth.ts",
        "reason": "Authentication middleware. High blast radius: all authenticated routes depend on this."
      }
    ],
    "coChangePatterns": [
      {
        "files": ["packages/contracts/src/user.ts", "apps/api/src/routes/users.ts", "apps/web/src/app/users/page.tsx"],
        "note": "User schema changes require simultaneous updates across API route and web page."
      }
    ]
  },
  "generated": {
    "specVersion": "0.4",
    "generatedAt": "2026-06-02T08:30:00.000Z",
    "by": { "name": "agents-audit", "version": "0.4.1" },
    "fragility": [
      {
        "file": "packages/contracts/src/index.ts",
        "changeCount": 40,
        "revertCount": 3,
        "revertRate": 0.075,
        "fragilityScore": 0.81,
        "excluded": false
      },
      {
        "file": "apps/api/src/middleware/auth.ts",
        "changeCount": 20,
        "revertCount": 2,
        "revertRate": 0.1,
        "fragilityScore": 0.74,
        "excluded": false
      },
      {
        "file": "apps/web/src/app/dashboard/page.tsx",
        "changeCount": 22,
        "revertCount": 1,
        "revertRate": 0.045,
        "fragilityScore": 0.22,
        "excluded": false
      }
    ],
    "coChange": [
      {
        "files": ["packages/contracts/src/user.ts", "apps/api/src/routes/users.ts", "apps/web/src/app/users/page.tsx"],
        "rate": 0.88,
        "occurrences": 22,
        "generated": false
      },
      {
        "files": ["package.json", "pnpm-lock.yaml"],
        "rate": 0.97,
        "occurrences": 58,
        "generated": true
      }
    ],
    "frameworkManifest": [
      {
        "name": "Next.js",
        "version": "15.3.1",
        "confidence": 1.0
      },
      {
        "name": "Hono",
        "version": "4.7.4",
        "confidence": 1.0
      },
      {
        "name": "Drizzle ORM",
        "version": "0.40.1",
        "confidence": 0.95
      }
    ]
  },
  "agents": {
    "toolAgentFiles": [".cursorrules"],
    "referencedAgentFiles": ["AGENTS.md"],
    "primaryAgentFile": "AGENTS.md"
  },
  "health": {
    "intelligenceState": "CONFIDENT",
    "observationCount": 2841,
    "averageFragility": 0.21,
    "fragileFileCount": 4,
    "confidence": 0.94,
    "bootstrapOverride": 0.0,
    "workflowFragility": 0.29,
    "codebaseHealth": 0.81,
    "changeVolatility": 0.24
  }
}