A Şirketi

Üç Claude Code ajanı, bir bekçi, bir dağıtıcı — kapalı bir döngü. Telefonundan bota bir link atarsın;
bir ajan iddiaları kaynağına kadar doğrular, zincir devralır, yayına hazır bir paket çıkar ve orada durur:
yayın düğmesi insanda.

Bu bir iskelettir, bir ürün değil. Klonla, .env'i doldur, kendi takımlarını yaz.

Üç takım

Her takım takimlar/<takim>/ altında aynı dört dosyayla yaşar: takim.md (kim ve ne yapar),
kurallar.md (neye göre), defter.md (ne öğrendi), durum.json (nerede). Her ajan koşuya aynı
sırayla başlar: ANAYASA.md → sirket/AJAN-KIMLIGI.md → takimlar/<takim>/kurallar.md →
takim.md → yetenekleri (skills/<ad>/SKILL.md).

Döngü

   sen                                bin/telegram_dinle.py
  Telegram'a X linki  ───────────────►  (long-poll; mesaj düştüğü an)
                                                  │
                                       gelen/*.json + kuyruk: x-<update_id>
                                                  │  mesai içiyse hemen koştur
                                                  │  (dışındaysa sabah dağıtıcı alır)
                                      ┌───────────▼───────────┐
                                      │  bin/kos.py x-icerik  │
                                      │  claude -p (sonnet)   │
                                      │  tweet_cek + arama    │
                                      │  ✅/🟡/⛔ tablosu      │
                                      └───────────┬───────────┘
                                                  │ Stop hook
                                      ┌───────────▼───────────┐
                                      │  bin/bekci.py         │
                                      │  ön kontrol (LLM yok) │
                                      │  + ayrı kafa denetimi │
                                      └─────┬───────────┬─────┘
                                       red  │           │ kabul
                                   düzeltmeye           │
                                    (en fazla 2)        ▼
                                                  durum.json
                                             kuyruk: x-<id> tamam
                                                        │
                                          bin/dagitici.py — zincir
                                                        │
                            twitter-icerik kuyruğu: aci-<id> bekliyor
                                                        │
                    tavanlar: mesai 09:00-23:00 · koşu 2 USD / 15 dk ·
                    takım günde 4 koşu · şirket günde 10 USD (bin/ayar.py)
                                                        │
                                      bin/kos.py twitter-icerik
                                                        │
                                    cikti/<tarih>-<slug>/article.html
                                                        │
                                                       sen
                                                 (yayın düğmesi)

youtube-analiz aynı iskelette ayrı kulvarda döner: pazartesi sabahı bin/gunluk.py --sabah
kuyruğa yt-<hafta> maddesini düşürür → Apify → veri/*.json → kaynaklı rapor.

Kurulum — 6 adım

Komut komut ayrıntılı hâli: KURULUM.md

1. git clone … && cd a-sirketi · cp .env.example .env — anahtarları doldur (aşağıdaki tablo)
2. python3 bin/ayar.py ve python3 -m unittest discover -s tests — iskelet ayakta mı
3. ANAYASA.md'yi oku — beş madde, şirketin değişmez çerçevesi; istersen kendi maddelerini yaz
4. Takımları tanı (takimlar/*/takim.md), sonra python3 bin/agents_uret.py ile
   .claude/agents/<takim>.md dosyalarını üret
5. Döngüyü kapat: python3 bin/kos.py x-icerik --kuru → Telegram'a link →
   python3 bin/telegram_oku.py --isle → python3 bin/kos.py x-icerik → python3 bin/dagitici.py
6. Sürekli çalıştır: python3 bin/telegram_dinle.py (olay tetiği) + python3 bin/zamanla.py --kur (sabah/akşam)

Anahtarlar (.env)

.env.example'ı kopyalayıp doldurursun; .env .gitignore'un ilk satırındadır, git'e girmez.

Komutlar

python3 bin/ayar.py                          # mesai penceresi, tavanlar, kanal, .env var mı
python3 bin/agents_uret.py [--check]         # takim.md → .claude/agents/<takim>.md (--check: sapma varsa 1)
python3 bin/kos.py <takim>                   # bir takımı bir kez koştur
python3 bin/kos.py <takim> --kuru            # claude çağırmadan akışı ve kurulan istemi bas
python3 bin/kos.py <takim> --zorla           # mesai dışında elle koştur
python3 bin/dagitici.py --kuru               # zinciri ve tetik kararlarını bas, hiçbir şey başlatma
python3 bin/dagitici.py                      # zinciri kur, uygun takımları koştur
python3 bin/bekci.py --dogrudan <takim> [kosu.md]   # hook dışından denetle, kararı JSON bas
python3 bin/telegram_oku.py --chat-id-bul | --son 5 | --isle
python3 bin/telegram_dinle.py [--bir-kez]    # olay tetiği: mesaj düştüğü an x-icerik koşar
python3 bin/gunluk.py --sabah [--kuru] | --aksam    # sabah dağıtıcı + rapor, akşam denetim
python3 bin/zamanla.py --kuru | --kur | --durum | --kaldir   # launchd tetikleri (macOS)
#   saatli tetik: macOS launchd · Linux cron (docs/02-dongu.md) · Windows WSL — kos.py POSIX fcntl kilidi kullanır
python3 bin/tweet_cek.py <x-linki>
python3 bin/youtube_analiz_cek.py --son-7g --yorum 50
python3 bin/kapak_uret.py "<başlık>" cikti/kapak.png
bin/takim-olustur.sh <yeni-takim>            # iskeletten yeni takım (dört dosya)
python3 -m unittest discover -s tests        # reponun kendi testleri

Neden böyle

• Ajan kim olduğunu bilir. Koşu isteminin ve .claude/agents/<takim>.md dosyasının ilk satırı
  şudur: "Sen x-icerik ajanısın. A Şirketi'nde bir çalışansın ve bir yapay zekâ ajanısın.
  Mesleğin: …" — meslek takim.md'deki description alanıdır. Gerisini sirket/AJAN-KIMLIGI.md
  anlatır: hafızası yok, patron kim, bekçi kim, dağıtıcı ne yapar, neyi asla yapmaz.
• Yetenek dosyaları. Bir işin nasıl yapılacağı her koşuda baştan anlatılmaz; skills/<ad>/SKILL.md
  bir kez yazılır, ajan sadece ilgili adımda okur. Hangi takımın hangi yeteneği var:
  takim.md frontmatter'ındaki skills: [...] alanı; katalog sirket/YETENEKLER.md.
  Her yeteneğin sonunda ## Öğrenilenler var — ajan koşuda aldığı veriyle kendini geliştirir.
• Tek iskelet. Dört dosya her takımda aynı yerde; yeni takım açmak bin/takim-olustur.sh ile
  kopyala-yapıştır.
• Kural dosyada, kodda değil. Ne yapılacağı takim.md'de, neye göre yapılacağı kurallar.md'de,
  zincir bin/dagitici.py'deki ZINCIR tablosunda. Kod yalnızca sürücüdür.
• Bekçi ayrı süreçte. Üretenin kendi kendini onaylaması yasak. Denetim Stop hook'ta, ayrı süreçte,
  tercihen ayrı model ailesinde. İlk katman LLM'siz ön kontroldür: koşu kaydında anahtar, token ya da
  e-posta deseni varsa karar doğrudan red.
• Tetik saat değil, olay. x-icerik'i başlatan şey bir zamanlayıcı değil, bota düşen mesaj
  (bin/telegram_dinle.py). Saatli tetik yalnız sabah dağıtıcıyı ve akşam denetimi koşturur.
• Tavan her yerde. Para, süre, koşu sayısı ve mesai penceresi tek dosyada (bin/ayar.py);
  tavana çarpan koşu sessiz ölmez, durum.json'a yazar.
• Yayın insanda. Şirket taslağa kadar gider, orada durur.

Belgeler

Lisans

MIT — bkz. LICENSE.