How long does the integration take?

Change one base URL in an OpenAI-compatible client, or install the Python or TypeScript SDK; the quickstart routes a first request in a few minutes.

Will this lock us into another vendor?

No. The router is Apache-2.0 open source, your provider keys stay yours, and the API is OpenAI-compatible, so leaving is a change of base URL.

What happens when a provider fails?

The router falls back to the next model your policy allows and records the fallback in the trace, so an outage costs a retry, not an incident.

maintenance-agent-rules - Prompt

Name: maintenance-agent-rules
Author: andiupn

Prompt file imported from andiupn/andy-universal-agent-rules (.windsurf/workflows/maintenance-agent-rules.md). Copyright stays with the author.

🔧 Workflow: Maintenance Agent Rules System

Workflow untuk menjaga agent rules system tetap optimal.

📋 Kapan Dijalankan

Jalankan workflow ini:

✅ Setelah menambah banyak knowledge entries baru
✅ Sebelum sharing project ke tim lain
✅ Setiap 1-2 minggu untuk maintenance rutin
✅ Setelah update besar pada scripts

🎯 Step-by-Step Maintenance

1. Validate Index Integrity

python scripts/validate-index.py --report

Expected: No orphaned entries, no unindexed files.

Jika ada error: Jalankan dengan --fix:

python scripts/validate-index.py --fix

2. Sync Statistics

python scripts/sync-agents-stats.py

Expected: AGENTS.md up-to-date dengan actual counts.

3. Update Environment

python scripts/detect-environment.py

Expected: environment.json ter-update dengan info terbaru.

4. Create Backup

python scripts/backup-memory.py

Expected: New backup file di _backups/ folder.

5. Test Search Functionality

# Test basic search
python scripts/search-knowledge.py oracle --limit 3

# Test category filter
python scripts/search-knowledge.py mysql --category gotchas

# Test tags filter
python scripts/search-knowledge.py --tags critical database

Expected: Results ditemukan dengan score relevance.

6. Review Gotchas

Buka dan review semua gotchas:

ls .agent/memory/entries/gotchas/

Check:

Semua gotchas masih relevan?
Ada yang perlu di-update?
Ada yang bisa di-archive?

7. Check Multi-Editor Files

Pastikan semua editor support files tersedia:

ls .github/copilot-instructions.md
ls .cursor/rules.md
ls .kiro/rules.md

Expected: Semua file ada dan isinya sinkron dengan AGENTS.md.

8. Performance Benchmark (Optional)

# Gunakan benchmark script (lebih akurat)
python scripts/benchmark-scripts.py

Expected: Semua scripts < 500ms (biasanya 90-215ms).

9. Integrate New Knowledge to AGENTS.md ⭐ NEW

Cek apakah ada knowledge baru yang perlu di-integrate ke AGENTS.md:

# Cek knowledge terbaru (list files by date)
Get-ChildItem .agent/memory/entries -Recurse -File | Sort-Object LastWriteTime -Descending | Select-Object -First 10 Name, LastWriteTime

# Atau search dengan query spesifik
python scripts/search-knowledge.py mcp --limit 5

# Cari yang belum di-integrate
Get-ChildItem .agent/memory/entries/gotchas/
Get-ChildItem .agent/memory/entries/patterns/
Get-ChildItem .agent/memory/entries/decisions/

Review dan integrate jika ada:

Gotchas baru → tambah ke section "Critical Gotchas"
MCP patterns → tambah ke section "MCP Servers"
Database knowledge → tambah ke section "Database Performance"
Decisions penting → buat section baru jika perlu

Key files to check:

entries/gotchas/*.md           → AGENTS.md Critical Gotchas
entries/patterns/mcp-*.md      → AGENTS.md MCP Servers
entries/decisions/*.md         → AGENTS.md relevant sections
entries/context/database-*.md  → AGENTS.md Database Performance

10. Update AGENTS.md Manual Sections

Pastikan sections di AGENTS.md masih akurat:

# Review AGENTS.md
head -100 AGENTS.md

Check:

MCP Servers section up-to-date?
Database Performance benchmarks current?
Connection info masih valid?
Project structure accurate?

11. Update Documentation Files ⭐ NEW

Sync statistik di documentation files dengan actual counts:

# Cek actual counts dari index.json
python -c "import json; d=json.load(open('.agent/memory/index.json')); print(f\"Total: {d['totalEntries']}\"); [print(f\"  {k}: {v['count']}\") for k,v in d['categories'].items()]"

Files yang perlu di-update secara MANUAL:

File	Section yang perlu di-update
`.agent/README.md`	Struktur folder (line 9-18), Tabel kategori (line 63-69)
`.agent/context/project-context.json`	`lastUpdated`, `lastSession` section
`.agent/workflows/maintenance-agent-rules.md`	Footer stats (last lines)

Checklist:

.agent/README.md entries count = actual?
project-context.json lastSession date = hari ini?
Workflow footer stats = actual counts?

Note: sync-agents-stats.py hanya update AGENTS.md, documentation files lain perlu manual update.

12. AGENTS.md Content Audit ⭐ NEW (2026-01-04)

Cek konsistensi dan kualitas content AGENTS.md:

# Cek duplicate content
grep -n "Get user info" AGENTS.md | head -5

# Cek broken characters
grep -n "�" AGENTS.md

# Cek outdated dates
grep -n "benchmark 20" AGENTS.md

Checklist:

Tidak ada duplicate code blocks?
Tidak ada broken emoji/characters?
Semua dates masih relevan?
Header stats (line 4) sudah benar?

13. Scripts Folder Audit ⭐ NEW (2026-01-04)

Cek apakah semua scripts masih relevan:

# List scripts
ls scripts/*.py scripts/*.ps1

# Check for legacy/unused scripts
# Move to _archive/scripts_legacy/ jika tidak dipakai

Checklist:

Semua scripts masih digunakan?
Tidak ada hardcoded stats di scripts?
README.md di scripts/ masih akurat?

14. SSOT Compliance Check ⭐ NEW (2026-01-04)

Pastikan stats hanya ada di AGENTS.md line 4 (Single Source of Truth):

# Search for hardcoded entry counts di seluruh project
grep -r "entries" README.md PROJECT_STRUCTURE.md | grep -E "[0-9]+ entries"

# Harus return empty atau hanya "See AGENTS.md"

SSOT Rules:

✅ Stats di AGENTS.md line 4 (auto-synced via script)
✅ Other files reference ke "See AGENTS.md"
❌ TIDAK boleh ada hardcoded stats di README.md, PROJECT_STRUCTURE.md

📊 Maintenance Checklist

[ ] Step 1: validate-index.py --report    ✅ No errors
[ ] Step 2: sync-agents-stats.py          ✅ Stats synced
[ ] Step 3: detect-environment.py         ✅ Env updated
[ ] Step 4: backup-memory.py              ✅ Backup created
[ ] Step 5: Test search functionality     ✅ Results found
[ ] Step 6: Review gotchas                ✅ All relevant
[ ] Step 7: Check multi-editor files      ✅ All present
[ ] Step 8: Performance benchmark         ✅ All < 500ms
[ ] Step 9: Integrate new knowledge       ✅ AGENTS.md updated
[ ] Step 10: Update manual sections       ✅ All accurate
[ ] Step 11: Update documentation files   ✅ All synced
[ ] Step 12: AGENTS.md content audit      ✅ No issues
[ ] Step 13: Scripts folder audit         ✅ All relevant
[ ] Step 14: SSOT compliance check        ✅ No hardcoded stats

🚨 Troubleshooting

Index Error

python scripts/validate-index.py --fix

Stats Out of Sync

python scripts/sync-agents-stats.py

Missing Editor File

# Copy dari AGENTS.md summary
cat AGENTS.md | head -50

Slow Performance

Check jumlah entries (target: < 100)
Arsipkan old entries ke _archive/
Clear unused backups

💡 Best Practices

Backup before major changes - Selalu backup sebelum edit besar
Validate after adding entries - Run validate setelah batch add
Keep gotchas updated - Review dan update gotchas berkala
Monitor performance - Benchmark jika terasa lambat
Sync stats regularly - Pastikan AGENTS.md akurat

📅 Recommended Schedule

Frequency	Tasks
Daily	Save new learnings
Weekly	Validate + Sync stats
Monthly	Full maintenance + Backup
Quarterly	Review & archive old entries

Created: 2025-12-22
Last Updated: 2026-01-04
Stats: See AGENTS.md (auto-synced)

# 🔧 Workflow: Maintenance Agent Rules System > Workflow untuk menjaga agent rules system tetap optimal. --- ## 📋 Kapan Dijalankan Jalankan workflow ini: - ✅ Setelah menambah banyak knowledge entries baru - ✅ Sebelum sharing project ke tim lain - ✅ Setiap 1-2 minggu untuk maintenance rutin - ✅ Setelah update besar pada scripts --- ## 🎯 Step-by-Step Maintenance ### 1. **Validate Index Integrity** ```bash python scripts/validate-index.py --report ``` **Expected:** No orphaned entries, no unindexed files. **Jika ada error:** Jalankan dengan `--fix`: ```bash python scripts/validate-index.py --fix ``` --- ### 2. **Sync Statistics** ```bash python scripts/sync-agents-stats.py ``` **Expected:** AGENTS.md up-to-date dengan actual counts. --- ### 3. **Update Environment** ```bash python scripts/detect-environment.py ``` **Expected:** `environment.json` ter-update dengan info terbaru. --- ### 4. **Create Backup** ```bash python scripts/backup-memory.py ``` **Expected:** New backup file di `_backups/` folder. --- ### 5. **Test Search Functionality** ```bash # Test basic search python scripts/search-knowledge.py oracle --limit 3 # Test category filter python scripts/search-knowledge.py mysql --category gotchas # Test tags filter python scripts/search-knowledge.py --tags critical database ``` **Expected:** Results ditemukan dengan score relevance. --- ### 6. **Review Gotchas** Buka dan review semua gotchas: ```bash ls .agent/memory/entries/gotchas/ ``` **Check:** - [ ] Semua gotchas masih relevan? - [ ] Ada yang perlu di-update? - [ ] Ada yang bisa di-archive? --- ### 7. **Check Multi-Editor Files** Pastikan semua editor support files tersedia: ```bash ls .github/copilot-instructions.md ls .cursor/rules.md ls .kiro/rules.md ``` **Expected:** Semua file ada dan isinya sinkron dengan AGENTS.md. --- ### 8. **Performance Benchmark (Optional)** ```bash # Gunakan benchmark script (lebih akurat) python scripts/benchmark-scripts.py ``` **Expected:** Semua scripts < 500ms (biasanya 90-215ms). --- ### 9. **Integrate New Knowledge to AGENTS.md** ⭐ NEW Cek apakah ada knowledge baru yang perlu di-integrate ke AGENTS.md: ```bash # Cek knowledge terbaru (list files by date) Get-ChildItem .agent/memory/entries -Recurse -File | Sort-Object LastWriteTime -Descending | Select-Object -First 10 Name, LastWriteTime # Atau search dengan query spesifik python scripts/search-knowledge.py mcp --limit 5 # Cari yang belum di-integrate Get-ChildItem .agent/memory/entries/gotchas/ Get-ChildItem .agent/memory/entries/patterns/ Get-ChildItem .agent/memory/entries/decisions/ ``` **Review dan integrate jika ada:** - [ ] Gotchas baru → tambah ke section "Critical Gotchas" - [ ] MCP patterns → tambah ke section "MCP Servers" - [ ] Database knowledge → tambah ke section "Database Performance" - [ ] Decisions penting → buat section baru jika perlu **Key files to check:** ``` entries/gotchas/*.md → AGENTS.md Critical Gotchas entries/patterns/mcp-*.md → AGENTS.md MCP Servers entries/decisions/*.md → AGENTS.md relevant sections entries/context/database-*.md → AGENTS.md Database Performance ``` --- ### 10. **Update AGENTS.md Manual Sections** Pastikan sections di AGENTS.md masih akurat: ```bash # Review AGENTS.md head -100 AGENTS.md ``` **Check:** - [ ] MCP Servers section up-to-date? - [ ] Database Performance benchmarks current? - [ ] Connection info masih valid? - [ ] Project structure accurate? --- ### 11. **Update Documentation Files** ⭐ NEW Sync statistik di documentation files dengan actual counts: ```bash # Cek actual counts dari index.json python -c "import json; d=json.load(open('.agent/memory/index.json')); print(f\"Total: {d['totalEntries']}\"); [print(f\" {k}: {v['count']}\") for k,v in d['categories'].items()]" ``` **Files yang perlu di-update secara MANUAL:** | File | Section yang perlu di-update | |------|------------------------------| | `.agent/README.md` | Struktur folder (line 9-18), Tabel kategori (line 63-69) | | `.agent/context/project-context.json` | `lastUpdated`, `lastSession` section | | `.agent/workflows/maintenance-agent-rules.md` | Footer stats (last lines) | **Checklist:** - [ ] `.agent/README.md` entries count = actual? - [ ] `project-context.json` lastSession date = hari ini? - [ ] Workflow footer stats = actual counts? > **Note:** `sync-agents-stats.py` hanya update AGENTS.md, documentation files lain perlu manual update. --- ### 12. **AGENTS.md Content Audit** ⭐ NEW (2026-01-04) Cek konsistensi dan kualitas content AGENTS.md: ```bash # Cek duplicate content grep -n "Get user info" AGENTS.md | head -5 # Cek broken characters grep -n "�" AGENTS.md # Cek outdated dates grep -n "benchmark 20" AGENTS.md ``` **Checklist:** - [ ] Tidak ada duplicate code blocks? - [ ] Tidak ada broken emoji/characters? - [ ] Semua dates masih relevan? - [ ] Header stats (line 4) sudah benar? --- ### 13. **Scripts Folder Audit** ⭐ NEW (2026-01-04) Cek apakah semua scripts masih relevan: ```bash # List scripts ls scripts/*.py scripts/*.ps1 # Check for legacy/unused scripts # Move to _archive/scripts_legacy/ jika tidak dipakai ``` **Checklist:** - [ ] Semua scripts masih digunakan? - [ ] Tidak ada hardcoded stats di scripts? - [ ] README.md di scripts/ masih akurat? --- ### 14. **SSOT Compliance Check** ⭐ NEW (2026-01-04) Pastikan stats hanya ada di AGENTS.md line 4 (Single Source of Truth): ```bash # Search for hardcoded entry counts di seluruh project grep -r "entries" README.md PROJECT_STRUCTURE.md | grep -E "[0-9]+ entries" # Harus return empty atau hanya "See AGENTS.md" ``` **SSOT Rules:** - ✅ Stats di AGENTS.md line 4 (auto-synced via script) - ✅ Other files reference ke "See AGENTS.md" - ❌ TIDAK boleh ada hardcoded stats di README.md, PROJECT_STRUCTURE.md --- ## 📊 Maintenance Checklist ``` [ ] Step 1: validate-index.py --report ✅ No errors [ ] Step 2: sync-agents-stats.py ✅ Stats synced [ ] Step 3: detect-environment.py ✅ Env updated [ ] Step 4: backup-memory.py ✅ Backup created [ ] Step 5: Test search functionality ✅ Results found [ ] Step 6: Review gotchas ✅ All relevant [ ] Step 7: Check multi-editor files ✅ All present [ ] Step 8: Performance benchmark ✅ All < 500ms [ ] Step 9: Integrate new knowledge ✅ AGENTS.md updated [ ] Step 10: Update manual sections ✅ All accurate [ ] Step 11: Update documentation files ✅ All synced [ ] Step 12: AGENTS.md content audit ✅ No issues [ ] Step 13: Scripts folder audit ✅ All relevant [ ] Step 14: SSOT compliance check ✅ No hardcoded stats ``` --- ## 🚨 Troubleshooting ### Index Error ```bash python scripts/validate-index.py --fix ``` ### Stats Out of Sync ```bash python scripts/sync-agents-stats.py ``` ### Missing Editor File ```bash # Copy dari AGENTS.md summary cat AGENTS.md | head -50 ``` ### Slow Performance - Check jumlah entries (target: < 100) - Arsipkan old entries ke `_archive/` - Clear unused backups --- ## 💡 Best Practices 1. **Backup before major changes** - Selalu backup sebelum edit besar 2. **Validate after adding entries** - Run validate setelah batch add 3. **Keep gotchas updated** - Review dan update gotchas berkala 4. **Monitor performance** - Benchmark jika terasa lambat 5. **Sync stats regularly** - Pastikan AGENTS.md akurat --- ## 📅 Recommended Schedule | Frequency | Tasks | |-----------|-------| | Daily | Save new learnings | | Weekly | Validate + Sync stats | | Monthly | Full maintenance + Backup | | Quarterly | Review & archive old entries | --- *Created: 2025-12-22* *Last Updated: 2026-01-04* *Stats: See AGENTS.md (auto-synced)*

{ "prompt": "# 🔧 Workflow: Maintenance Agent Rules System\r\n\r\n> Workflow untuk menjaga agent rules system tetap optimal.\r\n\r\n---\r\n\r\n## 📋 Kapan Dijalankan\r\n\r\nJalankan workflow ini:\r\n- ✅ Setelah menambah banyak knowledge entries baru\r\n- ✅ Sebelum sharing project ke tim lain\r\n- ✅ Setiap 1-2 minggu untuk maintenance rutin\r\n- ✅ Setelah update besar pada scripts\r\n\r\n---\r\n\r\n## 🎯 Step-by-Step Maintenance\r\n\r\n### 1. **Validate Index Integrity**\r\n\r\n```bash\r\npython scripts/validate-index.py --report\r\n```\r\n\r\n**Expected:** No orphaned entries, no unindexed files.\r\n\r\n**Jika ada error:** Jalankan dengan `--fix`:\r\n```bash\r\npython scripts/validate-index.py --fix\r\n```\r\n\r\n---\r\n\r\n### 2. **Sync Statistics**\r\n\r\n```bash\r\npython scripts/sync-agents-stats.py\r\n```\r\n\r\n**Expected:** AGENTS.md up-to-date dengan actual counts.\r\n\r\n---\r\n\r\n### 3. **Update Environment**\r\n\r\n```bash\r\npython scripts/detect-environment.py\r\n```\r\n\r\n**Expected:** `environment.json` ter-update dengan info terbaru.\r\n\r\n---\r\n\r\n### 4. **Create Backup**\r\n\r\n```bash\r\npython scripts/backup-memory.py\r\n```\r\n\r\n**Expected:** New backup file di `_backups/` folder.\r\n\r\n---\r\n\r\n### 5. **Test Search Functionality**\r\n\r\n```bash\r\n# Test basic search\r\npython scripts/search-knowledge.py oracle --limit 3\r\n\r\n# Test category filter\r\npython scripts/search-knowledge.py mysql --category gotchas\r\n\r\n# Test tags filter\r\npython scripts/search-knowledge.py --tags critical database\r\n```\r\n\r\n**Expected:** Results ditemukan dengan score relevance.\r\n\r\n---\r\n\r\n### 6. **Review Gotchas**\r\n\r\nBuka dan review semua gotchas:\r\n\r\n```bash\r\nls .agent/memory/entries/gotchas/\r\n```\r\n\r\n**Check:**\r\n- [ ] Semua gotchas masih relevan?\r\n- [ ] Ada yang perlu di-update?\r\n- [ ] Ada yang bisa di-archive?\r\n\r\n---\r\n\r\n### 7. **Check Multi-Editor Files**\r\n\r\nPastikan semua editor support files tersedia:\r\n\r\n```bash\r\nls .github/copilot-instructions.md\r\nls .cursor/rules.md\r\nls .kiro/rules.md\r\n```\r\n\r\n**Expected:** Semua file ada dan isinya sinkron dengan AGENTS.md.\r\n\r\n---\r\n\r\n### 8. **Performance Benchmark (Optional)**\r\n\r\n```bash\r\n# Gunakan benchmark script (lebih akurat)\r\npython scripts/benchmark-scripts.py\r\n```\r\n\r\n**Expected:** Semua scripts < 500ms (biasanya 90-215ms).\r\n\r\n---\r\n\r\n### 9. **Integrate New Knowledge to AGENTS.md** ⭐ NEW\r\n\r\nCek apakah ada knowledge baru yang perlu di-integrate ke AGENTS.md:\r\n\r\n```bash\r\n# Cek knowledge terbaru (list files by date)\r\nGet-ChildItem .agent/memory/entries -Recurse -File | Sort-Object LastWriteTime -Descending | Select-Object -First 10 Name, LastWriteTime\r\n\r\n# Atau search dengan query spesifik\r\npython scripts/search-knowledge.py mcp --limit 5\r\n\r\n# Cari yang belum di-integrate\r\nGet-ChildItem .agent/memory/entries/gotchas/\r\nGet-ChildItem .agent/memory/entries/patterns/\r\nGet-ChildItem .agent/memory/entries/decisions/\r\n```\r\n\r\n**Review dan integrate jika ada:**\r\n- [ ] Gotchas baru → tambah ke section \"Critical Gotchas\"\r\n- [ ] MCP patterns → tambah ke section \"MCP Servers\"\r\n- [ ] Database knowledge → tambah ke section \"Database Performance\"\r\n- [ ] Decisions penting → buat section baru jika perlu\r\n\r\n**Key files to check:**\r\n```\r\nentries/gotchas/*.md → AGENTS.md Critical Gotchas\r\nentries/patterns/mcp-*.md → AGENTS.md MCP Servers\r\nentries/decisions/*.md → AGENTS.md relevant sections\r\nentries/context/database-*.md → AGENTS.md Database Performance\r\n```\r\n\r\n---\r\n\r\n### 10. **Update AGENTS.md Manual Sections**\r\n\r\nPastikan sections di AGENTS.md masih akurat:\r\n\r\n```bash\r\n# Review AGENTS.md\r\nhead -100 AGENTS.md\r\n```\r\n\r\n**Check:**\r\n- [ ] MCP Servers section up-to-date?\r\n- [ ] Database Performance benchmarks current?\r\n- [ ] Connection info masih valid?\r\n- [ ] Project structure accurate?\r\n\r\n---\r\n\r\n### 11. **Update Documentation Files** ⭐ NEW\r\n\r\nSync statistik di documentation files dengan actual counts:\r\n\r\n```bash\r\n# Cek actual counts dari index.json\r\npython -c \"import json; d=json.load(open('.agent/memory/index.json')); print(f\\\"Total: {d['totalEntries']}\\\"); [print(f\\\" {k}: {v['count']}\\\") for k,v in d['categories'].items()]\"\r\n```\r\n\r\n**Files yang perlu di-update secara MANUAL:**\r\n\r\n| File | Section yang perlu di-update |\r\n|------|------------------------------|\r\n| `.agent/README.md` | Struktur folder (line 9-18), Tabel kategori (line 63-69) |\r\n| `.agent/context/project-context.json` | `lastUpdated`, `lastSession` section |\r\n| `.agent/workflows/maintenance-agent-rules.md` | Footer stats (last lines) |\r\n\r\n**Checklist:**\r\n- [ ] `.agent/README.md` entries count = actual?\r\n- [ ] `project-context.json` lastSession date = hari ini?\r\n- [ ] Workflow footer stats = actual counts?\r\n\r\n> **Note:** `sync-agents-stats.py` hanya update AGENTS.md, documentation files lain perlu manual update.\r\n\r\n---\r\n\r\n### 12. **AGENTS.md Content Audit** ⭐ NEW (2026-01-04)\r\n\r\nCek konsistensi dan kualitas content AGENTS.md:\r\n\r\n```bash\r\n# Cek duplicate content\r\ngrep -n \"Get user info\" AGENTS.md | head -5\r\n\r\n# Cek broken characters\r\ngrep -n \"�\" AGENTS.md\r\n\r\n# Cek outdated dates\r\ngrep -n \"benchmark 20\" AGENTS.md\r\n```\r\n\r\n**Checklist:**\r\n- [ ] Tidak ada duplicate code blocks?\r\n- [ ] Tidak ada broken emoji/characters?\r\n- [ ] Semua dates masih relevan?\r\n- [ ] Header stats (line 4) sudah benar?\r\n\r\n---\r\n\r\n### 13. **Scripts Folder Audit** ⭐ NEW (2026-01-04)\r\n\r\nCek apakah semua scripts masih relevan:\r\n\r\n```bash\r\n# List scripts\r\nls scripts/*.py scripts/*.ps1\r\n\r\n# Check for legacy/unused scripts\r\n# Move to _archive/scripts_legacy/ jika tidak dipakai\r\n```\r\n\r\n**Checklist:**\r\n- [ ] Semua scripts masih digunakan?\r\n- [ ] Tidak ada hardcoded stats di scripts?\r\n- [ ] README.md di scripts/ masih akurat?\r\n\r\n---\r\n\r\n### 14. **SSOT Compliance Check** ⭐ NEW (2026-01-04)\r\n\r\nPastikan stats hanya ada di AGENTS.md line 4 (Single Source of Truth):\r\n\r\n```bash\r\n# Search for hardcoded entry counts di seluruh project\r\ngrep -r \"entries\" README.md PROJECT_STRUCTURE.md | grep -E \"[0-9]+ entries\"\r\n\r\n# Harus return empty atau hanya \"See AGENTS.md\"\r\n```\r\n\r\n**SSOT Rules:**\r\n- ✅ Stats di AGENTS.md line 4 (auto-synced via script)\r\n- ✅ Other files reference ke \"See AGENTS.md\"\r\n- ❌ TIDAK boleh ada hardcoded stats di README.md, PROJECT_STRUCTURE.md\r\n\r\n---\r\n\r\n## 📊 Maintenance Checklist\r\n\r\n```\r\n[ ] Step 1: validate-index.py --report ✅ No errors\r\n[ ] Step 2: sync-agents-stats.py ✅ Stats synced\r\n[ ] Step 3: detect-environment.py ✅ Env updated\r\n[ ] Step 4: backup-memory.py ✅ Backup created\r\n[ ] Step 5: Test search functionality ✅ Results found\r\n[ ] Step 6: Review gotchas ✅ All relevant\r\n[ ] Step 7: Check multi-editor files ✅ All present\r\n[ ] Step 8: Performance benchmark ✅ All < 500ms\r\n[ ] Step 9: Integrate new knowledge ✅ AGENTS.md updated\r\n[ ] Step 10: Update manual sections ✅ All accurate\r\n[ ] Step 11: Update documentation files ✅ All synced\r\n[ ] Step 12: AGENTS.md content audit ✅ No issues\r\n[ ] Step 13: Scripts folder audit ✅ All relevant\r\n[ ] Step 14: SSOT compliance check ✅ No hardcoded stats\r\n```\r\n\r\n---\r\n\r\n## 🚨 Troubleshooting\r\n\r\n### Index Error\r\n```bash\r\npython scripts/validate-index.py --fix\r\n```\r\n\r\n### Stats Out of Sync\r\n```bash\r\npython scripts/sync-agents-stats.py\r\n```\r\n\r\n### Missing Editor File\r\n```bash\r\n# Copy dari AGENTS.md summary\r\ncat AGENTS.md | head -50\r\n```\r\n\r\n### Slow Performance\r\n- Check jumlah entries (target: < 100)\r\n- Arsipkan old entries ke `_archive/`\r\n- Clear unused backups\r\n\r\n---\r\n\r\n## 💡 Best Practices\r\n\r\n1. **Backup before major changes** - Selalu backup sebelum edit besar\r\n2. **Validate after adding entries** - Run validate setelah batch add\r\n3. **Keep gotchas updated** - Review dan update gotchas berkala\r\n4. **Monitor performance** - Benchmark jika terasa lambat\r\n5. **Sync stats regularly** - Pastikan AGENTS.md akurat\r\n\r\n---\r\n\r\n## 📅 Recommended Schedule\r\n\r\n| Frequency | Tasks |\r\n|-----------|-------|\r\n| Daily | Save new learnings |\r\n| Weekly | Validate + Sync stats |\r\n| Monthly | Full maintenance + Backup |\r\n| Quarterly | Review & archive old entries |\r\n\r\n---\r\n\r\n*Created: 2025-12-22* \r\n*Last Updated: 2026-01-04* \r\n*Stats: See AGENTS.md (auto-synced)*", "variables": [], "notes": "maintenance-agent-rules", "metadata": { "source": { "provider": "github-windsurf-workflows", "repository": "https://github.com/andiupn/andy-universal-agent-rules", "path": ".windsurf/workflows/maintenance-agent-rules.md", "ref": "61f0ac0b9633ab9ca9aea2b06111d167d56bd9c1", "url": "https://github.com/andiupn/andy-universal-agent-rules/blob/61f0ac0b9633ab9ca9aea2b06111d167d56bd9c1/.windsurf/workflows/maintenance-agent-rules.md", "key": "andiupn/andy-universal-agent-rules/.windsurf/workflows/maintenance-agent-rules.md" } } }

maintenance-agent-rules

About

🔧 Workflow: Maintenance Agent Rules System

📋 Kapan Dijalankan

🎯 Step-by-Step Maintenance

1. Validate Index Integrity

2. Sync Statistics

3. Update Environment

4. Create Backup

5. Test Search Functionality

6. Review Gotchas

7. Check Multi-Editor Files

8. Performance Benchmark (Optional)

9. Integrate New Knowledge to AGENTS.md ⭐ NEW

10. Update AGENTS.md Manual Sections

11. Update Documentation Files ⭐ NEW

12. AGENTS.md Content Audit ⭐ NEW (2026-01-04)

13. Scripts Folder Audit ⭐ NEW (2026-01-04)

14. SSOT Compliance Check ⭐ NEW (2026-01-04)

📊 Maintenance Checklist

🚨 Troubleshooting

Index Error

Stats Out of Sync

Missing Editor File

Slow Performance

💡 Best Practices

📅 Recommended Schedule

Install maintenance-agent-rules and it becomes one more candidate the router can pick - when it fits.

What it costs to adopt - in engineering time.

One base URL

No vendor lock-in

Failover built in

Use it

Manifest

Reviews