Neutral runtime setup

Nunneri Runtime Contract to stateful agent workflows

This interactive guide shows how one provider-neutral contract becomes LangGraph, CrewAI, AutoGen, and Semantic Kernel exports while preserving human approval gates and project context.

Select provider context

Provider-neutral assets

Install repo instructions

Provider files stay at the consuming repository root while assets remain under provider folders.

./install.sh --provider claude --project --context-only --dry-run
./install.sh --provider codex --project --context-only --dry-run
./install.sh --provider gemini --project --context-only --dry-run

Provider-specific overrides

Claude, Codex, and Gemini can each receive native guidance without changing the neutral workflow contract.

assets/context/repo-agent-instructions.md
dist/claude/CLAUDE.md
dist/codex/AGENTS.md
dist/gemini/GEMINI.md

Neutral contract is the shared export layer

Runtime adapters consume dist/nunneri-runtime/ instead of reading provider-specific files.

python3 scripts/build_adapters.py
cat dist/nunneri-runtime/workflows/triage-nine-phase.json
cat dist/nunneri-runtime/context/repo-agent-instructions.json
P1
Intake
Problem and scope
P2
Context Load
Repo context
P3
Classification
Code, config, runtime, docs
P4
Evidence Collection
Commands and failures
P5
Root Cause Analysis
Cause and plan
P6
gate_1
Approve RCA and fix plan
P7
Test-First Fix
Checks before change
P8
Validation
Run checks
P9
gate_2
Approve release impact
gate_1

Approve the root cause analysis and fix plan before implementation?

A LangGraph runtime pauses here with interrupt/resume. Rejection cancels downstream work.
{
  "id": "gate_1",
  "type": "human_approval",
  "approval": {
    "actions": ["approve", "reject"],
    "on_reject": "cancel"
  }
}
LangGraph
Graph JSON with checkpointed interrupts and approval gates.
CrewAI
Agent and flow manifests derived from the same contract.
AutoGen
AgentChat/Core style specs for orchestration experiments.
Semantic Kernel
Agent and orchestration manifests with approval metadata.
./install.sh --runtime nunneri-runtime --project --dry-run --skip-build
./install.sh --runtime langgraph --project --dry-run --skip-build
./install.sh --runtime crewai --project --dry-run --skip-build

Contract and Studio checks

python3 scripts/check_runtime_contract.py
python3 scripts/check_graph_studio_contract.py
python3 scripts/check_langgraph_exports.py

Consumer example checks

python3 scripts/check_runtime_examples.py
python3 examples/runtime-contract-consumer/consume_runtime_contract.py \
  --workflow dist/nunneri-runtime/workflows/triage-nine-phase.json