Inkitt Builds a One-Shot PR Creator with Resumable Agent Orchestration

The Agi Letkiewicz Tanner Lead Engineer at Inkitt, described it as

Event-driven orchestrator that coordinates short-lived agent containers rather than relying on a fixed pipeline.

Individual stages handle specification, implementation, verification, CI failure repair, and merge conflict resolution. The orchestrator persists each run in a database, allowing execution to resume from its recorded state.

Inkitt’s one-shot PR creator architecture (Source: Inkitt Blog Post )

The orchestrator separates decision-making from side effects. Its core transition function maps the current run state and incoming event to the next action without directly accessing a database, network, or language model. The orchestrator retains credentials for external systems, while agent containers receive short-lived repository tokens and model credentials. They cannot directly access Slack or Linear credentials, cloud identities, or arbitrary network connections. A separate check inspects the actual Git diff to ensure changes do not touch restricted paths.

Inkitt limits automation to changes within predefined boundaries. The workflow rejects tasks involving database migrations, schema or shared contract changes, CI and container build configuration, authentication, payment code, or package additions and updates. Verification, CI repair, and merge conflict resolution each have a maximum of two attempts. Duplicate webhook deliveries are handled through deduplication and conditional database writes, applying the principle of idempotent operations to workflows that may retry or receive repeated events. For CI completion, the orchestrator queries GitHub to determine whether all relevant jobs have finished instead of treating every job event as completion of the entire workflow.

Tanner wrote, describing the implementation challenges around idempotency, locking, retry budgets, and permissions.

The design shares some safeguards with other coding agents but uses a different orchestration model. GitHub Copilot’s cloud agent also restricts agent permissions and requires human review before merging, while SWE-agent focuses on solving repository issues through a model-driven interface for browsing, editing, and executing code. Inkitt’s account emphasizes persistent workflow state, bounded retries, and centralized control of external actions.

Human approval remains part of Inkitt’s process. The system opens draft PRs, cannot bypass branch protection or merge its own changes, and notifies requesters when CI passes and the changes reach staging. A person must mark a PR ready for review and manage reviewer requests and approval. For larger tasks, Inkitt also maintains a local version that keeps a human involved in the development process.

Equal Experts helps organizations harness AI, modernize technology, and build better software through expert engineering, collaboration, and innovative delivery practices. Learn more.