Examples

Three agents.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 agents.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.3",
    "generatedAt": "2026-05-12T08:30:00.000Z",
    "by": { "name": "vreko", "version": "0.3.0" },
    "fileIndex": {
      "packages/contracts/src/index.ts": {
        "fragility": 0.81,
        "aiModificationCount": 6,
        "humanModificationCount": 34
      },
      "apps/api/src/middleware/auth.ts": {
        "fragility": 0.74,
        "aiModificationCount": 2,
        "humanModificationCount": 18
      },
      "apps/web/src/app/dashboard/page.tsx": {
        "fragility": 0.22,
        "aiModificationCount": 14,
        "humanModificationCount": 8
      }
    },
    "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
  }
}

Repository: Synthesized from real Python package structure

A Python library project with a single installable package, pytest tests, and type annotations. The agents.workspace.json is minimal; the generator has fewer signals for a Python project compared to a TypeScript monorepo (no lockfile-based framework detection, smaller file index). The manual section carries more weight here.

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

{
  "manual": {
    "description": "Pure Python library for structured data validation. No runtime dependencies.",
    "techStack": ["Python 3.11+", "pytest", "mypy", "Hatch"],
    "conventions": [
      "All public APIs are type-annotated: mypy strict mode enforced in CI",
      "No dependencies beyond the standard library",
      "Tests in tests/ mirror the src/ structure"
    ],
    "fragileFiles": [
      {
        "path": "src/mylib/validators.py",
        "reason": "Core validation logic. Changes break compatibility with all downstream users."
      }
    ]
  },
  "generated": {
    "specVersion": "0.3",
    "generatedAt": "2026-04-15T11:00:00.000Z",
    "by": { "name": "vreko", "version": "0.3.0" },
    "fileIndex": {
      "src/mylib/validators.py": {
        "fragility": 0.68,
        "aiModificationCount": 3,
        "humanModificationCount": 22
      },
      "src/mylib/__init__.py": {
        "fragility": 0.45,
        "aiModificationCount": 1,
        "humanModificationCount": 6
      }
    },
    "frameworkManifest": [
      {
        "name": "pytest",
        "version": "8.1.2",
        "confidence": 1.0
      }
    ]
  },
  "agents": {
    "toolAgentFiles": [],
    "referencedAgentFiles": ["AGENTS.md"],
    "primaryAgentFile": "AGENTS.md"
  },
  "health": {
    "intelligenceState": "OBSERVING",
    "observationCount": 312,
    "averageFragility": 0.28,
    "fragileFileCount": 1,
    "confidence": 0.61,
    "bootstrapOverride": 0.18
  }
}

Repository: Synthesized from real polyglot project structure

A repository containing both a Rust CLI tool and a TypeScript web frontend. The agents.workspace.json shows how the spec accommodates multiple languages under a single root. The frameworkManifest lists frameworks from both language ecosystems. Fragility scores reflect that Rust source files have lower AI modification rates; the generator observed fewer AI sessions touching Rust files.

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

{
  "manual": {
    "description": "Polyglot project: Rust CLI tool + TypeScript web frontend. The CLI handles data processing; the web frontend is the user interface.",
    "techStack": ["Rust", "TypeScript", "React", "Vite", "Cargo workspaces"],
    "conventions": [
      "CLI: error handling via anyhow; no panics in library code",
      "Web: all data fetching in React Query hooks, no ad-hoc fetch() calls in components",
      "Shared JSON schema in schema/ used by both Rust (serde) and TypeScript (zod)"
    ],
    "fragileFiles": [
      {
        "path": "schema/event.json",
        "reason": "Shared JSON schema. Rust and TypeScript consumers must update in lockstep."
      }
    ],
    "coChangePatterns": [
      {
        "files": ["schema/event.json", "src/cli/src/event.rs", "web/src/types/event.ts"],
        "note": "Schema changes require simultaneous Rust and TypeScript type updates."
      }
    ]
  },
  "generated": {
    "specVersion": "0.3",
    "generatedAt": "2026-05-01T09:00:00.000Z",
    "by": { "name": "vreko", "version": "0.3.0" },
    "fileIndex": {
      "schema/event.json": {
        "fragility": 0.88,
        "aiModificationCount": 1,
        "humanModificationCount": 14
      },
      "src/cli/src/event.rs": {
        "fragility": 0.71,
        "aiModificationCount": 0,
        "humanModificationCount": 14
      },
      "web/src/components/EventList.tsx": {
        "fragility": 0.19,
        "aiModificationCount": 8,
        "humanModificationCount": 4
      }
    },
    "frameworkManifest": [
      {
        "name": "React",
        "version": "19.1.0",
        "confidence": 1.0
      },
      {
        "name": "Vite",
        "version": "6.3.2",
        "confidence": 1.0
      },
      {
        "name": "Rust",
        "version": "1.87.0",
        "confidence": 0.95
      }
    ]
  },
  "agents": {
    "toolAgentFiles": [".cursorrules", "copilot-instructions.md"],
    "referencedAgentFiles": ["AGENTS.md"],
    "primaryAgentFile": "AGENTS.md"
  },
  "health": {
    "intelligenceState": "CONFIDENT",
    "observationCount": 1104,
    "averageFragility": 0.33,
    "fragileFileCount": 2,
    "confidence": 0.87,
    "bootstrapOverride": 0.0
  }
}