القائمة
Build the pnpm monorepo correctly respecting inter-package dependencies. Use when building, verifying changes, or troubleshooting build failures.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Plan and execute code changes using a spec-driven workflow with structured documents. Use when making non-trivial changes (multi-file, multi-step, or behavior-impacting) that need structured planning before implementation. Not for trivial single-file edits.
Create and manage changesets for versioning with @changesets/cli. Use when making changes that need a changelog entry, preparing a release, or managing package versions.
Diagnose and fix failed benchmark runs. Use when a benchmark run fails, scores are unexpected, judges show errors, or traces are incomplete.
Write and run tests using Node.js built-in test runner (node:test) with .mjs files. Use when creating new tests, debugging test failures, or understanding test infrastructure.
Understand the vanilla JS web-report app structure, patterns, and contribution guidelines. Use when modifying the UI, adding new views, or fixing frontend bugs.
Add a new AI coding agent adapter so it can participate in benchmarks. Use when integrating any new CLI-based coding tool (Cursor-like, Copilot alternative, open-source agent, etc.) into the adapter system.
| name | monorepo-build |
| description | Build the pnpm monorepo correctly respecting inter-package dependencies. Use when building, verifying changes, or troubleshooting build failures. |
This is a pnpm workspace monorepo with 8 packages. Build order matters.
core (no deps)
├── adapters
├── judges
├── report
├── taskpacks
└── trace
│
runner → adapters + core + judges + taskpacks + trace
│
cli → adapters + core + report + runner + taskpacks
Build order: core → {adapters, judges, report, taskpacks, trace} → runner → cli
# Build everything (recommended - respects dependency order)
pnpm build
# Build a single package and its deps
pnpm --filter @agentarena/core build
# Build a specific package only (no dep resolution)
pnpm --filter @agentarena/cli --workspace-concurrency=1 build
# Watch mode for development
# (Configure individually per package if needed)
| Changed package | Must also rebuild | Verify with |
|---|---|---|
core | Everything | pnpm build && pnpm test |
adapters | runner, cli | pnpm --filter @agentarena/runner build |
judges | runner | pnpm --filter @agentarena/runner build |
report | cli | pnpm --filter @agentarena/cli build |
taskpacks | runner, cli | pnpm --filter @agentarena/runner build |
trace | runner | pnpm --filter @agentarena/runner build |
runner | cli | pnpm build |
cli | none (leaf) | pnpm --filter @agentarena/cli build |
| Error | Likely cause |
|---|---|
Cannot find module '@agentarena/...' | Dependent package not built yet. Run pnpm build from root. |
| Type errors referencing another package | That package's dist is stale. Rebuild it. |
tsconfig.tsbuildinfo conflicts | Delete **/tsconfig.tsbuildinfo and rebuild. |
| Build succeeds but tests fail | Tests import from dist/. Run pnpm build first. |
packages/<name>/ with package.json, tsconfig.json, src/.package.json, set name to @agentarena/<name>.@agentarena/* packages..changeset/config.json if it should be versioned.pnpm install then pnpm build.pnpm build succeeds from root (not just the changed package).tsconfig.tsbuildinfo files in the diff.