repo-context-kit

Compact deterministic repository runtime for AI coding agents.

repo-context-kit is MCP-native first: MCP transport + runtime/v1 JSON state + minimal CLI fallback.

Primary interfaces:

1. MCP (rck-mcp)
2. runtime/v1 JSON (.aidw/runtime/*.json)
3. minimal CLI (rck)

It provides bounded repository context, runtime task state, verification framing, and confirmation-gated execution for AI coding agents.

MCP

rck-mcp --root <repo>

The MCP server is read-only by default. Write, test, and external-side-effect tiers require explicit opt-in and still honor the confirmation gate.

Runtime

JSON is the source of truth:

• .aidw/runtime/task.json
• .aidw/runtime/context.json
• .aidw/runtime/execution.json
• .aidw/runtime/verification.json

Markdown is a readable view only.

Usage

Default workflow:

rck init
rck scan
rck doctor
rck check
rck task prompt <taskId>
# human implementation
rck task checklist <taskId>
rck task pr <taskId>
rck scan --check
rck check --strict

Preflight for local or CI usage:

rck scan --check
rck check --strict

• scan --check verifies generated context and runtime JSON freshness.
• check --strict evaluates governance signals without writing files.
• scan --auto is a managed refresh mode for gated/MCP flows. It is not the default human workflow.
• doctor explains setup, freshness, and PDGL readiness when something feels off.

Command reference:

rck init
rck init --dry-run
rck init --force
rck init --force --update-agent-files
rck scan [--check]
rck scan --auto
rck doctor
rck install-status
rck version --paths
rck context brief
rck context next-task
rck context workset <taskId>
rck task prompt <taskId>
rck task checklist <taskId>
rck task pr <taskId>
rck gate status
rck gate reset
rck gate confirm task <taskId>
rck gate confirm task <taskId> --ttl-minutes <n> --json
rck gate confirm tests <taskId>
rck gate confirm tests <taskId> --json
rck gate run-test <taskId> --token <token>
rck gate run-test <taskId> --token <token> --json
rck check [--explain]
rck check [--strict | --warn-only]
rck metrics

Use rck <command> --help for command-specific options.