KRI Agent Harness

This repository composes deterministic, self-contained AGENTS.md and paired CLAUDE.md files for repositories under the KRI development workspace.

Requirements

  • Windows PowerShell 5.1 or newer
  • Node.js 20 or newer

The committed dist bundle contains runtime dependencies. npm install is needed only when changing or rebuilding the harness source.

Commands

Run commands from this repository root:

.\scripts\agent-harness.cmd list
.\scripts\agent-harness.cmd plan --project kri-contact-front
.\scripts\agent-harness.cmd plan --contract kri-common
.\scripts\agent-harness.cmd verify --project kri-contact-front
.\scripts\agent-harness.cmd verify --contract kri-common
.\scripts\agent-harness.cmd compose --project kri-contact-front
.\scripts\agent-harness.cmd compose --contract kri-common
.\scripts\agent-harness.cmd register --project kri-contact-front --path _KriContact/contact-front
.\scripts\agent-harness.cmd register --project new-service --path ____Project/new-service --shared

The .cmd launcher invokes the PowerShell wrapper with a process-scoped execution-policy bypass. It does not change the user or machine execution policy. When local scripts are already allowed, scripts\agent-harness.ps1 may be called directly.

plan, verify, and list are read-only. compose writes only generated AGENTS.md and CLAUDE.md. register writes workspace.local.yml by default; register --shared writes workspace.yml. No command performs Git, database, deployment, or network operations.

Use --contract <contract-id> to select the registered provider first and then only registered consumers of that contract, ordered by project ID. Use --all only when every registered project is intentionally in scope. --project, --contract, and --all are mutually exclusive.

Workspace Files

  • workspace.yml contains shared relative project registrations and is committed.
  • workspace.local.yml contains machine-local registrations and is ignored by Git.
  • workspace.local.example.yml documents the local format.
  • Project paths are relative to workspace_root and may not escape it.

Repository Inputs

Each managed repository owns:

  • .agent/profile.yml
  • .agent/project.md
  • .agent/consumer.md when it provides a shared contract

Edit source inputs, run plan, obtain the required approval, then run compose. Use verify to detect stale generated output.

Development

On Windows PowerShell, use npm.cmd because the npm.ps1 shim may be blocked by execution policy:

npm.cmd install
npm.cmd run verify

Workspace Verification

Run a read-only verification of every shared and local project registration from the existing multi-repository workspace:

npm.cmd run verify:workspace

This command uses the committed runtime bundle and does not compose documents, update Git repositories, or access the network.

To retain a local UTF-8 log for the same verification:

npm.cmd run verify:scheduled

Install or remove the weekday Windows scheduled task with:

npm.cmd run schedule:install
npm.cmd run schedule:uninstall

See docs/local-scheduling.md for scheduling, log retention, and failure handling.

Description
No description provided
Readme 1.3 MiB
Languages
TypeScript 66.1%
JavaScript 23%
PowerShell 10.7%
Batchfile 0.2%