Sham Bus Agent Prompt Library

هذه المكتبة ليست مكتبة product prompts عامة. هذه مكتبة agent playbooks موجهة لوكلاء البرمجة والتحليل مثل Codex وClaude وGemini حتى يعملوا داخل منظومة شام باص بشكل صحيح، ويطوّروا الكود فعلاً بدل أن يعطوا نصائح عامة فقط.

Purpose

The library is designed to improve the Sham Bus codebase itself:

• complete missing features
• harden operator and admin workflows
• extract shared core logic safely
• audit the ecosystem against repo truth
• reduce flaky CI and skip-driven tests
• keep docs synchronized with implementation

Canonical Registry

The typed source of truth lives in @shambus/config/agent-prompts.

It currently ships:

• 57 agent prompt records
• 19 workflow families
• 3 tuned variants per workflow:
  • codex
  • claude
  • gemini

Layout

• Authoring Standard
• Execution Rules
• Audits And Planning
• Implementation And Refactors
• Reliability And Quality
• Docs And Operations
• Partner Architecture
• Evaluation And Testing
• Coverage Matrix

Core Principles

1. Every prompt is Sham Bus-specific, not generic software advice.
2. Every prompt assumes the agent must read the repo before deciding.
3. Every prompt includes verification expectations and stop conditions.
4. Shared packages, migrations, docs, and app surfaces are all part of the working system.
5. Docs updates are required when implementation changes behavior.