agentrc AGENTS.md

AgentRC Copilot Instructions

@microsoft/agentrc is a CLI tool (and VS Code extension) that sets up repositories for AI-assisted development. It analyzes repos, generates instruction files, evaluates AI responses, and runs readiness reports.

Architecture

src/                   # CLI entry point and commands
  cli.ts               # Commander program, withGlobalOpts helper
  commands/            # Thin command wrappers (parse args → call services)
  ui/                  # Ink/React TUI components
packages/core/src/     # Shared services and utilities (bundled into dist)
  services/            # analyzer, generator, instructions, readiness, policy, ...
  utils/               # fs, output, logger, repo, pr
plugin/skills/         # Built-in skill markdown files (copied to dist/skills/ on build)
vscode-extension/      # See .github/instructions/vscode-extension.instructions.md

@agentrc/core (in packages/core/) is bundled into the CLI output — it is not an external npm package. Use the @agentrc/core/* path alias for all cross-package imports.

Build & Test

npm run build          # tsup → dist/index.js (ESM, Node 20)
npm run dev            # tsx src/index.ts (run from source)
npm run typecheck      # tsc --noEmit
npm run lint           # eslint
npm test               # vitest run
npm run test:coverage  # vitest run --coverage

Output is ESM ("type": "module"). All node_modules are external except @agentrc/core, @github/copilot-sdk, and vscode-jsonrpc (bundled via noExternal in tsup.config.ts).

SDK shim: tsup.config.ts patches getBundledCliPath() in the Copilot SDK. An identical shim lives in vscode-extension/esbuild.mjs — update both together if SDK internals change.

Command Pattern

Commands in src/commands/ are thin wrappers:

1. Resolve paths and options
2. Call services from @agentrc/core/services/*
3. Write output using the output utilities

Wrap every command action with withGlobalOpts (from src/cli.ts) so --json, --quiet, and --accessible are merged into the options object.