Ataç: Bu Açık Kaynak Çerçevesi ile Tek Kişilik Şirket Nasıl Yönetilir

Paperclip: Tek Kişilik Şirket Çerçevesi

Paperclip, yapay zeka ajanlarını çalışanlar gibi yöneten açık kaynaklı tek kişilik bir şirket çerçevesidir: organizasyon şemaları, bütçeler, kalp atışı planlaması, yönetişim onayları ve eksiksiz bir denetim günlüğü. Tek bir komutla yerel olarak başlatılır. Ajanlarınız işi yapar; siz yönetim kurulu toplantısını yönetirsiniz.

Bugün Apidog'u deneyin

2026'da tek kişilik bir şirket işletmek artık her şeyi kendi başına yapmak anlamına gelmiyor; stratejiye odaklanırken işi yapan bir yapay zeka ajanları ekibini yönetmek anlamına geliyor. Paperclip, bunu gerçeğe dönüştürmek için tasarlanmış açık kaynaklı tek kişilik şirket çerçevesidir. Yalnız kuruculara, yapay zeka ajanları için tek bir kendi kendine barındırılan kontrol panelinde bir organizasyon şeması, bir bütçe sistemi, bir yönetişim katmanı ve bir görev takipçisi sunar. Ajanlarınızın etkileşim kurduğu API'leri tasarlamak, taklit etmek ve test etmek için Apidog'u da kullanıyorsanız, Paperclip bu yığını tamamlar: API sözleşmesi Apidog'a, onu çağıran ajanlar ise Paperclip'e aittir. Bu kılavuz, Paperclip'in tam olarak nasıl çalıştığını ve bugünden itibaren tek kişilik bir operasyona nasıl entegre edileceğini ayrıntılı olarak açıklar.

💡 İlk Paperclip kalp atışınızdan önce Apidog'u (ücretsiz) edinin. Görev açıklamalarına sahte URL'ler ekleyerek ajanların sıfır maliyetle, sıfır sürprizle mükemmel sözleşmelere göre geliştirme yapmasını sağlayın. Daha sonra Apidog testleri bütçe tükenmeden herhangi bir sapmayı yakalarken canlı API'lere geçin.

Paperclip Nedir ve Tek Kişilik Şirket Çerçevesi Apidog Kullanıcıları İçin Neden Önemlidir?

Paperclip sloganı bunu doğrudan ifade ediyor: "Eğer OpenClaw bir çalışansa, Paperclip şirkettir."

Paperclip, yapay zeka ajanları koleksiyonunuzu unvanlar, raporlama hatları, aylık bütçeler ve stratejik hedeflerle yapılandırılmış bir organizasyona dönüştüren bir Node.js sunucusu ve React kullanıcı arayüzüdür. Bir sohbet robotu, bir komut yöneticisi veya bir iş akışı sürükle-bırak aracı değildir. Özerk bir şirket için bir kontrol düzlemidir.

Paperclip Neden Gerekli?

2026'da yapay zeka ajanlarını kullanan çoğu yalnız kurucu bir kaosu yönetiyor. Yirmi Claude Code sekmesi açık. Hangi ajanın hangi dosyaya dokunduğuna dair kayıt yok. Token harcamalarında bir üst sınır yok. Ajanın görevi bitirip bitirmediğini veya bir tamamlamayı sanrılıp sanrılmadığını bilmenin bir yolu yok. Paperclip, ajanlara gerçek bir şirketin çalışanlara davrandığı gibi davranarak tüm bunları düzeltir:

• Organizasyon şeması — ajanların rolleri, unvanları ve bir yöneticisi vardır
• Sorunlar / görevler — her iş durumu, önceliği ve atanan kişisi ile takip edilir
• Hedefler — her görev şirketin misyonuna dayanır, böylece ajanlar her zaman nedenini bilir
• Kalp atışları — ajanlar belirli bir programa göre uyanır, görev gelen kutularını kontrol eder, işi yapar ve rapor verir
• Bütçeler — ajan başına aylık token harcama limitleri; limite ulaştıklarında dururlar
• Yönetişim — ajan işe alımlarını ve büyük stratejik kararları yürütmeden önce onaylarsınız

Ajanlarının çağırdığı API'leri tanımlamak ve taklit etmek için Apidog kullanan ekipler için Paperclip, eksik orkestrasyon katmanını ekler. Apidog, ajana API sözleşmesinin ne olduğunu söyler. Paperclip ise ajana hangi işi yapacağını, ne zaman yapacağını ve ne kadar harcayabileceğini söyler.

Yalnız Kurucular Neden Bu Çerçeveyi Sadece Apidog'a Tercih Ediyor?

Apidog, API tasarımı ve tek başına test etmede olağanüstüdür. Ancak API tasarımı, bir ürünü çalıştırmanın yalnızca bir katmanıdır. Paperclip, çevresel süreçleri yönetir: hedef ayrıştırma, görev atama, ilerleme takibi, maliyet görünürlüğü ve denetim günlüğü. Birlikte, Apidog + Paperclip, insanların yön belirlediği ve yapay zeka ajanlarının uyguladığı bir yazılım şirketi için yalnız bir kurucuya eksiksiz bir işletim sistemi sunar.

Paperclip'in Temel Özellikleri ve Apidog'un Konumu

Kalp Atışları: Apidog Uyumlu Ajan Aktivasyon Döngüsü

Kalp atışı, Paperclip'in temel yürütme ilkelidir. Her kalp atışında, bir ajan:

1. Kimliğini doğrulamak için GET /api/agents/me çağrısı yapar
2. Görev gelen kutusunu okumak için GET /api/companies/:id/issues?status=todo,in_progress çağrısı yapar
3. Üst hedef soy ağacı dahil olmak üzere tam bağlamı almak için GET /api/issues/:id çağrısı yapar
4. İşi yapar (kod yazar, API'leri çağırır, içerik üretir)
5. Durum güncellemesi ve ne yaptığını açıklayan bir yorumla PATCH /api/issues/:id çağrısı yapar

Apidog entegrasyonu bu noktada öne çıkar. Eğer görev harici bir API'yi çağırmayı içeriyorsa (örneğin, haftalık bir rapor oluşturmak için müşteri verilerini çekmek), ajan geliştirme sırasında bir Apidog sahte sunucusuna erişir, ardından tek bir kod satırı değiştirmeden üretimde canlı uç noktaya geçer. Apidog'un istek doğrulama özelliği, API sözleşmesindeki herhangi bir sapmayı, bir ajanın çalışmasını sessizce bozmadan önce yakalar.

Organizasyon Şeması ve Hedef Hiyerarşisi, Apidog API Katmanı Olarak

Paperclip'in hedef hiyerarşisi şirket → ekip → ajan → görev şeklinde ilerler. Bir göreve atanan bir ajan her zaman üst zincirini alır, böylece genç bir ajan bir blog yazısı yazdığını "SEO trafiğini büyütme"nin bir parçası olarak ve bunun da "1 milyon dolarlık Aylık Tekrar Eden Gelir (MRR) elde etme"nin bir parçası olarak bilir. Bu bağlam, ajanların daha geniş hedefin pahasına yerel olarak optimize etmesini engeller.

Bu hiyerarşi içinde Apidog, API spesifikasyon katmanı olarak hizmet verir. Dahili hizmetlerinizi Apidog'da tanımlar, her biri için sahte sunucular yayınlarsınız ve ajanlar görev açıklamalarında bu Apidog uç noktalarına referans verir. API değiştiğinde, Apidog spesifikasyonunu günceller, sahte sunucuyu yeniden oluşturursunuz ve her alt düzey ajan yeni sözleşmeyi otomatik olarak alır.

Apidog İş Akışınızda Kontrolsüz Harcamayı Durduran Bütçe Uygulaması

Paperclip'teki her ajanın bir budgetMonthlyCents alanı vardır. Ajanın spentMonthlyCents değeri bu üst sınıra ulaştığında görev kabul etmeyi durdurur. Hiçbir geçersiz kılma, hiçbir istisna yoktur. Yalın çalışan tek kişilik bir şirket için bu, diğer her şeyi mümkün kılan özelliktir: bir ajana aylık 20 $ bütçe verebilir ve bu bütçeyi asla aşmayacağından emin olabilirsiniz.

Bunu Apidog'un sahte sunucularıyla birleştirdiğinizde, canlı yapay zeka sağlayıcılarına geçmeden önce tüm bir ajan işi sprint'ini sahte sunuculara karşı (sıfır token maliyetiyle) çalıştırabilirsiniz. Prototipleme ücretsizdir; üretim bütçelidir.

Paperclip'i Apidog ile Tek Kişilik Şirket Çerçevesi Olarak Kurma {#setup}

Sıfır Yapılandırmalı Yerel Başlangıç — Apidog Anında Bağlanır

Paperclip'i çalıştırmak için tek komut yeterli:

npx paperclipai onboard --yes

Bu komut; gömülü bir PostgreSQL veritabanı başlatır, ana şifreleme anahtarı oluşturur, tüm veritabanı geçişlerini uygular ve sunucuyu http://localhost:3100 adresinde başlatır. Docker gerekmez, harici hizmete ihtiyaç yoktur.

Çalışmaya başladıktan sonra, kullanıcı arayüzünü açın, bir şirket oluşturun ve ilk hedefinizi tanımlayın:

Build the #1 AI-powered API monitoring tool to $1M MRR.

İlk ajanınızı, örneğin claude_local adaptörünü kullanan bir "Backend Mühendisi" olarak ekleyin:

{
  "adapterType": "claude_local",
  "adapterConfig": {
    "model": "claude-opus-4-6",
    "maxTokens": 4096
  },
  "budgetMonthlyCents": 2000
}

Ajanın görevlerini Apidog sahte sunucunuza yönlendirin. Görev açıklamasında, ajanın bağlam olarak tam API sözleşmesine sahip olması için Apidog koleksiyon URL'sini referans gösterin.

Apidog Sahte Sunucularını Ajan Görevlerine Bağlama

Paperclip'te görev açıklamaları, tam üst bağlam ile zengin Markdown formatındadır. Apidog sahte temel URL'nizi doğrudan gömebilirsiniz:

## Görev: /users uç noktasına sayfalama ekle

**Apidog Sahte Temel URL:** http://localhost:4523/m1/123456/users
**Kabul kriterleri:**
- Uç nokta `page` ve `limit` sorgu parametrelerini kabul eder
- `{ data: [], total: 0, page: 1 }` zarfı döndürür
- Uç durumlar için birim test kapsamı (page=0, limit>100)

Ajan bunu okur, mevcut yanıt şeklini doğrulamak için Apidog sahte sunucusunu çağırır, uygulamayı yazar ve bir yorumla geri rapor verir.

Paperclip Tek Kişilik Şirket Çerçevesinde Apidog ile Ajanları, Görevleri ve Kalp Atışlarını Çalıştırma

Paperclip Apidog Hattı Aracılığıyla Sorunları Yönetme

Paperclip CLI, kullanıcı arayüzünü açmadan görev yaşam döngüsü üzerinde tam kontrol sağlar:

# Bir ajanın yeni bir Apidog tanımlı uç nokta uygulamasını sağlamak için bir görev oluşturun
pnpm paperclipai issue create \
  --company-id <id> \
  --title "Apidog spesifikasyonuna göre POST /webhooks uç noktasını uygula" \
  --description "Apidog koleksiyonuna bakın: http://localhost:4523/..."

# Görev durumunu kontrol edin
pnpm paperclipai issue list --company-id <id> --status in_progress

# Bir ajan takılırsa görevi serbest bırakın
pnpm paperclipai issue release <issue-id>

Her durum değişikliği, değişmez etkinlik günlüğüne kaydedilir, böylece bir göreve hangi ajanın dokunduğunu ve ne söylediğini her zaman tam olarak bilirsiniz.

Apidog Entegre Tek Kişilik Şirket Çerçevesinde Yönetişim ve Onaylar

Paperclip'in yönetişim modeli sizi yönetim kurulu rolüne sokar. Herhangi bir ajan işe alınmadan veya herhangi bir büyük strateji onaylanmadan önce, Paperclip açık onayınızı isteyebilir:

# Bekleyen onayları gözden geçirin
pnpm paperclipai approval list --company-id <id>

# Yeni bir ajan işe alımını onaylayın
pnpm paperclipai approval approve <approval-id> \
  --decision-note "Onaylandı. İlk sprint için Apidog sahte sunucusunu kullanın."

Bu, tek kişilik şirket çerçevesinin bir özerklik felaketine dönüşmesini engeller. Ajanlar önerir; siz karar verirsiniz.

Paperclip + Apidog Tek Kişilik Şirket Çerçevesi Yığınında Test Etme, Yönetişim ve Maliyet Kontrolü

Paperclip Apidog Birim Test Paketini Çalıştırma

Paperclip, Vitest tarafından desteklenen tam bir birim test paketi ve Playwright tarafından desteklenen uçtan uca testlerle birlikte gelir. Bunları çalıştırmak için:

# Tüm birim testlerini çalıştırın
pnpm test:run

# Uçtan uca testleri çalıştırın
pnpm test:e2e

# Sağlık kontrolü — sunucunun ve Apidog sahte sunucusunun erişilebilir olduğunu doğrulayın
curl http://localhost:3100/api/health

Birim test paketi, temel iş mantığını kapsar: sorun durum geçişleri, bütçe uygulaması, kalp atışı çalışma yaşam döngüsü ve ajan kimlik doğrulaması. Yeni bir yapay zeka sağlayıcısını bağlamak için özel bir adaptör eklediğinizde, birim test paketini çalıştırmak, mevcut orkestrasyon davranışının değişmediğini doğrular.

Tek kişilik bir şirket çerçevesinde bu, geleneksel bir ekipten daha önemlidir. Kod inceleyiciniz yoktur. Birim test paketi ve Apidog sözleşme testleriniz sizin güvenlik ağınızdır.

Üç Katmanlı Kalite Yığını: Paperclip + Apidog + Birim Testleri

Yalnız kurucular için pratik bir kalite modeli:

1. Apidog, API sözleşmesini tanımlar ve her gönderimde otomatik sözleşme testleri çalıştırır
2. Paperclip sorunları, Apidog spesifikasyonuna atıfta bulunan kabul kriterleri içerir
3. Birim testleri (Vitest), uygulamanın her ikisiyle de eşleştiğini doğrular

Bu üç katmanlı yaklaşım, yalnız bir kurucunun, beş kişilik bir ekibin toplantılar olmadan akran incelemesinden alacağı kalite güvencesinin aynısını sağlar.

Sonuç

Paperclip, yalnız bir kurucuyu şirkete dönüştüren açık kaynaklı tek kişilik şirket çerçevesidir. Organizasyon şemaları, bütçe kontrolleri, yönetişim, hedef hizalaması, kalp atışı planlaması ve eksiksiz bir denetim izini yapay zeka ajan yönetimine getirir. Hepsi kendi kendine barındırılan, hepsi açık kaynaklı.

API'leri tasarlamak ve test etmek için zaten Apidog kullanan geliştiriciler için Paperclip eklemek yığını tamamlar. Apidog, API'nin ne yaptığını yönetir. Paperclip ise onu kimin, ne zaman, neden ve hangi maliyetle çağırdığını yönetir. Birlikte, ilk günden itibaren üretim düzeyinde bir tek kişilik şirket çerçevesi oluştururlar: Apidog sahte sunucularınız ajan gelişimini destekler, Apidog sözleşme testleriniz ajan çıktısını doğrular ve Paperclip'in yönetişim katmanı, onaylamadığınız hiçbir eylemi hiçbir ajanın gerçekleştirmemesini sağlar.

Başlayın:

• Yerel olarak başlatın: npx paperclipai onboard --yes
• http://localhost:3100 adresindeki kullanıcı arayüzünü açın, bir şirket oluşturun ve ilk hedefinizi tanımlayın
• Aylık 20 $ bütçeli bir ajan ekleyin ve onu Apidog sahte sunucunuza yönlendirin
• İlk üretim kalp atışınızdan önce birim test paketinin geçtiğini doğrulamak için pnpm test:run komutunu çalıştırın
• İlk görevi onaylayın, ajanın çalışmasını izleyin, denetim günlüğünü inceleyin

Tek kişilik şirket artık bir metafor değil. Paperclip ve Apidog ile bir mimaridir.

SSS

Paperclip nedir?

Paperclip, organizasyon şemaları, bütçeler, kalp atışı planlaması ve yönetişim ile yapay zeka ajanlarını orkestra eden açık kaynaklı tek kişilik bir şirket çerçevesidir; bir Node.js sunucusu ve React kullanıcı arayüzüdür. İnsan çalışanlar yerine yapay zeka ajanları ile bir yazılım şirketi çalıştırmak için kontrol düzlemidir.

Paperclip Apidog ile nasıl entegre olur?

Apidog, ajanlarınızın üzerinde çalıştığı API sözleşmelerini tanımlar. Apidog sahte URL'lerini Paperclip görev açıklamalarına gömersiniz, ajanlar geliştirme sırasında bu sahte sunucuları çağırır ve Apidog'un sözleşme testleri nihai uygulamayı doğrular. Paperclip orkestrasyonu, Apidog ise API spesifikasyonunu yönetir.

Paperclip gerçek bir tek kişilik şirket için uygun mu?

Evet. Sıfır yapılandırmalı yerel kurulum (npx paperclipai onboard --yes) hiçbir altyapı gerektirmez. Bütçe limitleri kontrolsüz maliyetleri önler. Kalp atışı sistemi tekrar eden işleri otomatik olarak halleder. Tailscale entegrasyonu, ajanlarınızı telefonunuzdan yönetmenize olanak tanır. Aynı yapılandırmayla yerelden buluta ölçeklenir.

Birim testlerini nasıl çalıştırırım?

Vitest birim test paketi için pnpm test:run komutunu, Playwright uçtan uca testleri için ise pnpm test:e2e komutunu çalıştırın. http://localhost:3100/api/health adresine yapılan bir sağlık kontrolü, sunucunun test etmeden önce doğru çalıştığını doğrular.

Paperclip hangi yapay zeka ajanlarını destekler?

Paperclip; Claude (yerel ve OpenClaw aracılığıyla), Codex, Cursor, Gemini, OpenCode ve HTTP konuşan veya yerel bir süreç olarak çalışan herhangi bir ajanı destekler. Adaptör sistemi açıktır; eğer ajanınız bir kalp atışı alabiliyorsa, işe alınabilir.

Paperclip açık kaynak mı?

Evet. Paperclip MIT lisanslıdır ve github.com/paperclipai/paperclip adresinde aktif olarak sürdürülmektedir. Eklenti SDK'sı, adaptör paketleri ve beceri tanımlamaları, @paperclipai/* altında kapsamlı NPM paketleri olarak yayınlanmaktadır.