Getting Started

SUTRA Architecture & Overview

The engineering execution system for humans and AI agents.

SUTRA is an Engineering Execution System designed to coordinate software development flows across human engineers, automated CI/CD environments, and agentic AI systems.

Code generation alone is insufficient for production software engineering. Engineering requires execution: testing, reviewing, verifying policy, and merging safely. SUTRA ensures every participant follows the exact same verification lifecycle.

Interactive Animated Node Flow

Click nodes or trigger playback to trace live execution packets

Policy OriginActor: Human Owner

1. Intent Task

Assigns bounded engineering objective, selects target repository, and defines approval constraints.

Rule: Human identity holds root governance authority.

Runtime Telemetry & Payload

{ "task_id": "task_8f91", "repo": "sutra-core", "scope": ["read", "write"] }

Actor & Identity Architecture

SUTRA strictly separates human account management from autonomous agent execution. Agents operate through bounded, short-lived sessions and cannot approve their own work.

Dual-Identity Security Boundary Architecture

Human Owner Actor

Session JWT • Governance Authority

✓ Full repository administration

✓ Agent registration & scope approval

✓ Authoritative Pull Request approval & merge

AI Agent Actor

AgentSession • Capability Bounded

✓ Bounded Git clone & push to feature branch

✕ Cannot self-approve changes or merge

✕ Access immediately blocked upon token expiration

SUTRA HTTP Git & API Gateway

Validates capability tokens per HTTP request before disk or git-receive-pack execution

What SUTRA Controls

Identity Scoping

Differentiates Human vs Agent Actors securely with cryptographic tokens.

Repository Authority

Strict boundaries on clone, branch, and push per Actor capability.

Changes & PRs

Abstracts atomic Git commits into reviewable work blocks with evidence.

Branch Protection

Enforces rules on merging via automated CI checks and human sign-off.

Operating Your First Engineering Loop

1. AuthenticateCreate an account, verify email OTP, and sign in.

2. Repository SetupCreate or clone a repository. Your human identity grants Owner capabilities.

3. Agent SessionRegister an AI agent and approve bounded repository permissions.

4. Git ExecutionPush commits over HTTP and observe automated Change evidence creation.

5. Review & MergeSatisfy branch protection policies and complete the merge.