Instruksi tetap

Perintah tetap memberi agen Anda wewenang operasional permanen untuk program yang ditentukan. Alih-alih memberikan instruksi tugas individual setiap kali, Anda mendefinisikan program dengan cakupan, pemicu, dan aturan eskalasi yang jelas - lalu agen mengeksekusinya secara otonom dalam batas tersebut.

Inilah perbedaan antara memberi tahu asisten Anda "kirim laporan mingguan" setiap Jumat vs. memberi wewenang tetap: "Kamu bertanggung jawab atas laporan mingguan. Susun setiap Jumat, kirim, dan eskalasikan hanya jika ada sesuatu yang terlihat salah."

# Mengapa perintah tetap

Tanpa perintah tetap:

• Anda harus memberi prompt kepada agen untuk setiap tugas
• Agen diam tanpa aktivitas di antara permintaan
• Pekerjaan rutin terlupakan atau tertunda
• Anda menjadi hambatan

Dengan perintah tetap:

• Agen mengeksekusi secara otonom dalam batas yang ditentukan
• Pekerjaan rutin berjalan sesuai jadwal tanpa prompt
• Anda hanya terlibat untuk pengecualian dan persetujuan
• Agen mengisi waktu idle secara produktif

# Cara kerjanya

Perintah tetap didefinisikan dalam file ruang kerja agen Anda. Pendekatan yang disarankan adalah memasukkannya langsung di AGENTS.md (yang disuntikkan otomatis setiap sesi) agar agen selalu memilikinya dalam konteks. Untuk konfigurasi yang lebih besar, Anda juga dapat menempatkannya dalam file khusus seperti standing-orders.md dan merujuknya dari AGENTS.md.

Setiap program menentukan:

1. Cakupan - apa yang boleh dilakukan agen
2. Pemicu - kapan harus mengeksekusi (jadwal, peristiwa, atau kondisi)
3. Gerbang persetujuan - apa yang memerlukan persetujuan manusia sebelum bertindak
4. Aturan eskalasi - kapan harus berhenti dan meminta bantuan

Agen memuat instruksi ini setiap sesi melalui file bootstrap ruang kerja (lihat Ruang Kerja Agen untuk daftar lengkap file yang disuntikkan otomatis) dan mengeksekusinya, dikombinasikan dengan tugas Cron untuk penegakan berbasis waktu.

# Anatomi perintah tetap

## Program: Weekly Status Report

**Authority:** Compile data, generate report, deliver to stakeholders
**Trigger:** Every Friday at 4 PM (enforced via cron job)
**Approval gate:** None for standard reports. Flag anomalies for human review.
**Escalation:** If data source is unavailable or metrics look unusual (>2σ from norm)

### Execution steps

1. Pull metrics from configured sources
2. Compare to prior week and targets
3. Generate report in Reports/weekly/YYYY-MM-DD.md
4. Deliver summary via configured channel
5. Log completion to Agent/Logs/

### What NOT to do

- Do not send reports to external parties
- Do not modify source data
- Do not skip delivery if metrics look bad - report accurately

# Perintah tetap ditambah tugas Cron

Perintah tetap mendefinisikan apa yang boleh dilakukan agen. Tugas Cron mendefinisikan kapan itu terjadi. Keduanya bekerja bersama:

Standing Order: "You own the daily inbox triage"
    ↓
Cron Job (8 AM daily): "Execute inbox triage per standing orders"
    ↓
Agent: Reads standing orders → executes steps → reports results

Prompt tugas Cron sebaiknya merujuk ke perintah tetap, bukan menggandakannya:

openclaw cron add \
  --name daily-inbox-triage \
  --cron "0 8 * * 1-5" \
  --tz America/New_York \
  --timeout-seconds 300 \
  --announce \
  --channel bluebubbles \
  --to "+1XXXXXXXXXX" \
  --message "Execute daily inbox triage per standing orders. Check mail for new alerts. Parse, categorize, and persist each item. Report summary to owner. Escalate unknowns."

# Contoh

# Contoh 1: konten dan media sosial (siklus mingguan)

## Program: Content & Social Media

**Authority:** Draft content, schedule posts, compile engagement reports
**Approval gate:** All posts require owner review for first 30 days, then standing approval
**Trigger:** Weekly cycle (Monday review → mid-week drafts → Friday brief)

### Weekly cycle

- **Monday:** Review platform metrics and audience engagement
- **Tuesday-Thursday:** Draft social posts, create blog content
- **Friday:** Compile weekly marketing brief → deliver to owner

### Content rules

- Voice must match the brand (see SOUL.md or brand voice guide)
- Never identify as AI in public-facing content
- Include metrics when available
- Focus on value to audience, not self-promotion

# Contoh 2: operasi keuangan (dipicu peristiwa)

## Program: Financial Processing

**Authority:** Process transaction data, generate reports, send summaries
**Approval gate:** None for analysis. Recommendations require owner approval.
**Trigger:** New data file detected OR scheduled monthly cycle

### When new data arrives

1. Detect new file in designated input directory
2. Parse and categorize all transactions
3. Compare against budget targets
4. Flag: unusual items, threshold breaches, new recurring charges
5. Generate report in designated output directory
6. Deliver summary to owner via configured channel

### Escalation rules

- Single item > $500: immediate alert
- Category > budget by 20%: flag in report
- Unrecognizable transaction: ask owner for categorization
- Failed processing after 2 retries: report failure, do not guess

# Contoh 3: pemantauan dan peringatan (berkelanjutan)

## Program: System Monitoring

**Authority:** Check system health, restart services, send alerts
**Approval gate:** Restart services automatically. Escalate if restart fails twice.
**Trigger:** Every heartbeat cycle

### Checks

- Service health endpoints responding
- Disk space above threshold
- Pending tasks not stale (>24 hours)
- Delivery channels operational

### Response matrix

| Condition        | Action                   | Escalate?                |
| ---------------- | ------------------------ | ------------------------ |
| Service down     | Restart automatically    | Only if restart fails 2x |
| Disk space < 10% | Alert owner              | Yes                      |
| Stale task > 24h | Remind owner             | No                       |
| Channel offline  | Log and retry next cycle | If offline > 2 hours     |

# Pola eksekusi-verifikasi-laporan

Perintah tetap bekerja paling baik saat dikombinasikan dengan disiplin eksekusi yang ketat. Setiap tugas dalam perintah tetap harus mengikuti loop ini:

1. Eksekusi - Lakukan pekerjaan sebenarnya (jangan hanya mengakui instruksi)
2. Verifikasi - Konfirmasi hasilnya benar (file ada, pesan terkirim, data terurai)
3. Laporan - Beri tahu pemilik apa yang sudah dilakukan dan apa yang sudah diverifikasi

### Execution rules

- Every task follows Execute-Verify-Report. No exceptions.
- "I'll do that" is not execution. Do it, then report.
- "Done" without verification is not acceptable. Prove it.
- If execution fails: retry once with adjusted approach.
- If still fails: report failure with diagnosis. Never silently fail.
- Never retry indefinitely - 3 attempts max, then escalate.

Pola ini mencegah mode kegagalan agen yang paling umum: mengakui tugas tanpa menyelesaikannya.

# Arsitektur multi-program

Untuk agen yang mengelola beberapa area, susun perintah tetap sebagai program terpisah dengan batas yang jelas:

## Program 1: [Domain A] (Weekly)

...

## Program 2: [Domain B] (Monthly + On-Demand)

...

## Program 3: [Domain C] (As-Needed)

...

## Escalation Rules (All Programs)

- [Common escalation criteria]
- [Approval gates that apply across programs]

Setiap program harus memiliki:

• Irama pemicu sendiri (mingguan, bulanan, digerakkan peristiwa, berkelanjutan)
• Gerbang persetujuan sendiri (beberapa program memerlukan pengawasan lebih banyak daripada yang lain)
• Batas yang jelas (agen harus tahu di mana satu program berakhir dan program lain dimulai)

# Praktik terbaik

# Lakukan

• Mulai dengan wewenang sempit dan perluas saat kepercayaan terbentuk
• Definisikan gerbang persetujuan eksplisit untuk tindakan berisiko tinggi
• Sertakan bagian "Yang TIDAK boleh dilakukan" - batas sama pentingnya dengan izin
• Kombinasikan dengan tugas Cron untuk eksekusi berbasis waktu yang andal
• Tinjau log agen setiap minggu untuk memverifikasi perintah tetap diikuti
• Perbarui perintah tetap saat kebutuhan Anda berkembang - dokumen ini bersifat hidup

# Hindari

• Memberikan wewenang luas pada hari pertama ("lakukan apa pun yang menurutmu terbaik")
• Melewatkan aturan eskalasi - setiap program memerlukan klausul "kapan berhenti dan bertanya"
• Menganggap agen akan mengingat instruksi verbal - letakkan semuanya di file
• Mencampur area dalam satu program - pisahkan program untuk domain yang berbeda
• Lupa menegakkan dengan tugas Cron - perintah tetap tanpa pemicu menjadi sekadar saran

# Terkait

• Otomatisasi dan tugas: semua mekanisme otomatisasi secara ringkas.
• Tugas Cron: penegakan jadwal untuk perintah tetap.
• Hook: skrip berbasis peristiwa untuk peristiwa siklus hidup agen.
• Webhook: pemicu peristiwa HTTP masuk.
• Ruang kerja agen: tempat perintah tetap berada, termasuk daftar lengkap file bootstrap yang disuntikkan otomatis (AGENTS.md, SOUL.md, dll.).