← → SPACE · HOME/END · N=NOTES

NCGRAutopilot

الطيّار الآلي للمركز الوطني لنظم الموارد الحكومية — نظام يسلّم مشاريع البرمجيات بخطوات واضحة ومتحقَّقة.

ENGINEERING · INITIATIVE · 2026
NCGR.GOV.SA / AUTOPILOT
01 / 05 · Introductionالذكاء اللي يشتغل
قبل ندخل في الحل، نثبت المفاهيم. وش دور النموذج؟ ووش دور العميل الذكي؟
البداية
section · one
3 / 17 — concept 01

وش هو LLM؟
محرّك تفكير لغوي.

النموذج اللغوي الكبير يفهم النص، يحلله، ويصيغ الإجابات والمسودات والاقتراحات.
لكنّه لحاله ما ينفّذ. ما يفتح ملف، ولا يكتب على القرص، ولا يشغّل اختبار.

“LLM = reasoning engine · not a delivery system.”
LLM
analyze() summarize suggest explain draft reason
4 / 17 — concept 02

وش هو AI Agent؟
طبقة تشغيل فوق الـ LLM.

العميل الذكي = نموذج لغوي + سياق + أدوات + مهارات + بوّابات تحقّق.
النموذج يقول: «أتوقع…».
العميل يقول: «قرأت الملف، عدّلت الكود، شغّلت الاختبار — وهذا الدليل».

01
LLM
العقل اللي يفكر
02
Context · Memory
السياق والذاكرة
03
Skills · Playbooks
مهارات جاهزة للتنفيذ
04
Tools · CLI · MCP
أدوات تشغيل فعلية
05
Verification Gates
بوّابات تثبت الجودة
AI AGENT · EXECUTION
5 / 17 — anatomy

سبعة مكونات تصنع عميل ينجز.

كل مكون لحاله ما يكفي، والترتيب بدون تحقق ما يضمن النتيجة. القيمة تظهر يوم تشتغل كلها مع بعض.

01
LLM
عقل التفكير
02
Harness
إطار التشغيل
03
Skills
مهارات جاهزة
00
Agent
العميل
04
CLI
سطر الأوامر
05
MCP
ربط الأدوات
06
Verify
إثبات الجودة
6 / 17 — execution modes

Interactive vs Non-Interactive · طريقتان للتشغيل.

01 · MODE INTERACTIVE حوار خطوة بخطوة · إنسان في كل خطوة
WAITING · HUMAN
اقرأ ملف القصة BE-0001
تم. أبدأ بكتابة الاختبارات؟
نعم، ابدأ.
كتبت أول اختبار. أكمل لبقية الحالات؟
ينتظر تأكيد المستخدم…
~3steps / hour
100%human attention
parallelism
use whenللاستكشاف · للحالات الحساسة · للتعلّم.
02 · MODE NON-INTERACTIVE تنفيذ ذاتي · يمشي بدون توقف
RUNNING · 00:38:14
$ claude -p --dangerously-skip-permissions
read PRD · BE-000142ms
wrote 3 files · 142 lines4.1s
ran tests · 18 passed2.3s
7-gates green · committed11.4s
recorded sprint log0.2s
next story · BE-0002
~180steps / hour
0%human attention
parallelism
use whenللإنتاج · للتسليم المتواصل · للقياس.
الفرق التشغيلي×60 throughput
02 / 05 · Problem Definitionفجوة الإنتاجية
التنفيذ اليدوي يعتمد على سرعة الإنسان وانضباطه. وإذا ما كان معه اختبارات وبوّابات تحقق قوية، تزيد الأخطاء وتطول دورة التسليم.
المشكلة
section · two
8 / 17 — time delta

القصة نفسها:
يوم ونصف أو عشرين دقيقة.

في التنفيذ اليدوي، القصة تمر على قراءة، كتابة، اختبار، إصلاح، ومراجعة، وكل خطوة تعتمد على وقت الإنسان وتركيزه.

NCGR Autopilot يضغط نفس الدورة إلى تنفيذ مستمر: يقرأ، يبني، يختبر، ويتحقق بدون توقف بين الخطوات.

manual cycle1.5d
Read 0.5h
Code 2h
CI 1h
Self-review 0.5h
Wait peer review 4h
Fix 1h
Re-review 1.5h
Merge 0.5h
manual path · autopilot target: ~20m
9 / 17 — cost delta

فرق السرعة يتحول
إلى فرق تكلفة واضح.

إذا القصة اليدوية تمتد إلى يوم ونصف، تكلفتها التشغيلية ترتفع. وإذا ضغطناها إلى نحو عشرين دقيقة مع تحقق آلي، تنخفض تكلفة القصة بشكل كبير.

زمن القصة اليدوي
1.5d
manual cycle
زمن الطيّار الآلي
~20m
agent cycle
تكلفة القصة اليدوية
SAR 2,250
per story
تكلفة القصة آلياً
SAR 12
per story
10 / 17 — equation breaks

مع العملاء الأذكياء،
المعادلة القديمة ما تكفي.

Status Quo · Human team
الفريق البشري فقط
Cycle / Story
~1.5d
Cost / Story
SAR 2,250
Stories / Day
2–4
Throughput
محدود
Verification
يدوي
NCGR Autopilot · Agentic
الطيّار الآلي
Cycle / Story
~20m
Cost / Story
SAR 12
Stories / Day
~40
Throughput
24 / 7
Verification
آلي ثابت
03 / 05 · The Solutionالحل
من الفكرة للتنفيذ: نظام تشغيل يأخذ Sprint Backlog ويسلّم القصص وحدة وحدة.
Deep Dive toNCGR Autopilot
الحل
section · three
12 / 17 — overview

NCGR Autopilot
طيّار آلي للسبرنت.

نظام تشغيل يأخذ Sprint Backlog ويسلّم القصص وحدة وحدة، وكل قصة تمر عبر سبع بوّابات تحقّق. السبرنت يخلص في ساعات، بمهندس واحد، بدل أربعة مهندسين × أسبوعين.

Sprint كامل · مهندس واحد · ساعات معدودة.
PRODUCTION GRADE
~20
MIN / CYCLE
قصص يومياً
~40stories/day
تكلفة القصة
SAR 12per story
13 / 17 — the loop · مخرَج كل خطوة ★

أربع مراحل، تسع خطوات — وكل خطوة تنتج شيئاً ملموساً.

Read
Build
Verify
Record
01 / 09 READ يقرأ القصة
phase · READ
~/sprint-12/BE-0007
prd.json · BE-0007read · 38ms
{
  "id": "BE-0007",
  "title": "تقديم طلب إجازة",
  "as":       "موظف حكومي",
  "want":     "أرفع طلب إجازة من البوابة",
  "so_that":  "يصلني الرد بدون مراجعة يدوية",
  "acceptance": [
    "POST /leave-requests → 201",
    "الإشعار يصل لمدير القسم",
    "رفض التواريخ الماضية"
  ],
  "estimate": "20m"
}
scan workspace · context1.2s
> indexing project context

  ├─ src/api/leave/                NEW
  ├─ src/db/schema/employees.ts    84 LOC
  ├─ src/auth/session.ts           42 LOC
  ├─ src/notify/manager.ts         26 LOC
  └─ tests/setup.ts                18 LOC

 4 anchor files · 312 LOC indexed
 2 conventions detected · zod, vitest
plan · 4 steps before codedraft
1. db/schema/leave_requests       → migration + index
2. POST /api/leave handler        → zod dto + guard
3. notify-manager webhook         → reuse notify/manager
4. tests · 1 happy + 3 edge        → vitest

# plan stored at .agent/plans/BE-0007.md
build · src/api/leave/handler.ts+3 files · 142 LOC
+ export async function createLeaveRequest(req) {
+   const dto = LeaveRequestDto.parse(req.body)
+   await assertEmployeeActive(dto.employeeId)
+   const row = await db.leaveRequests.insert(dto)
+   await notifyManager(row)
+   return Response.json(row, { status: 201 })
+ }

# also: schema + manager hook + dto
vitest · 4 specs0.3s
 creates leave request           124ms
 rejects invalid employee id       38ms
 sends manager notification        96ms
 refuses past dates                41ms

 4 passed  ·  0 failed  ·  0 skipped
seven gates · هل القصة جاهزة؟verify
 [1/7] typecheck
 [2/7] lint
 [3/7] unit tests
 [4/7] integration
! [5/7] coverage 78% (target ≥ 80%)
 [6/7] security scan
 [7/7] build

gate failed · loop back to fix
fix · close coverage gapautofix
! uncovered · createLeaveRequest overlap path
  → add test: rejects overlapping range

 wrote tests/leave-overlap.spec.ts
 coverage 84% (+6)
 re-running 7 gates …

all gates green · loop forward
iteration · record + commitDEMO-0006 ✓
═══════════════════════════════════════════════
  NCGR Autopilot · Iteration 6 · DEMO-0006 done
═══════════════════════════════════════════════
Story     Add EF Core persistence + migrations
Landed    7 DbSets · cascade-delete mappings
          unique indexes · DI extension
          InitialCreate migration · SQLite + PG
Verify    dotnet format ✓  build · 0 warnings ✓
          178 / 178 tests passed (12 new persistence)
Commit    feat(demo): [DEMO-0006] EF Core …
          29 files · +2380 / -11
Next       DEMO-0007 unblocked · app services

Iteration 6 complete · 14 stories remain · looping…
queue · sprint 12restart in 0.2s
 BE-0008   notification dispatcher        ~25m
  BE-0009   leave approval workflow        ~30m
  BE-0010   reporting endpoint             ~20m
  BE-0011   audit trail                    ~15m
  17 more pending · 1 done

# loop continues — no human prompt
14 / 17 — verification

حلقة محكومة ·
سبع بوّابات · بدون تجاوز.

القصة ما تعتبر مكتملة إلا بعد ما تعدّي كل البوابات. هنا الفرق بين «كاتب كود» و«عميل إنتاجي» يقدر الفريق يعتمد عليه.

No gate skipped · no story shipped.
01
Automated Tests
unit · integration · race · fuzz
02
Static Checks
lint · vet · type · format
03
Security Audit
secrets · vulnerabilities · govulncheck
04
Tenant Isolation
cross-org · cross-project · cross-env
05
Audit Trail
progress.txt · git log · request_id
06
Scoped Permissions
actions · grants · break-glass
07
Human Override
review evidence · sign-off
15 / 17 — speed

Sprint كامل في ساعات،
مو أسبوعين.

على افتراض Sprint متوسط من 20 قصة، ومتوسط تنفيذ يقارب ~20 دقيقة لكل قصة.

Traditional · 4 مهندسين
2 weeks
Traditional · مهندس واحد
8 weeks
NCGR Autopilot · واحد + AI
~7 hours
×40
أسرع، والجودة ثابتة.
16 / 17 — demo proposal

الدليل يكون بتجربة
قريبة من واقع NCGR.

نقترح Demo كامل بنمط NCGR Autopilot: نظام .NET 8 + ABP + DDD لإدارة العقارات الحكومية، مع تكامل Keycloak للمصادقة، وواجهة Angular.

Demo objective — من backlog إلى نظام يعمل · backend + frontend + auth + gates
government real estate domain · one execution loop
Domain Model
Real Estate
العقارات الحكومية → المباني → الوحدات والأصول، مع علاقات واضحة وصلاحيات على كل مستوى.
Backend
.NET 8 · ABP
تطبيق مبني بـ DDD وEF Core، مع APIs، طبقات Domain/Application، واختبارات تحقق.
Identity
Keycloak SSO
مصادقة موحدة، أدوار وصلاحيات، وربط الوصول للعقارات الحكومية عبر Keycloak.
Frontend
Angular Portal
واجهة لإدارة العقارات والمباني، مربوطة بالـ APIs والصلاحيات وتجربة استخدام واضحة.
17 / 17 — reference

قاموس المفاهيم.

LLM نموذج لغوي كبير
محرّك تفكير. ما ينفّذ لحاله؛ ينتج نص، يحلل، يقترح، ويصيغ.
AI Agent عميل ذكي
LLM + سياق + أدوات + بوّابات تحقق. ينفّذ ويوثق بالدليل.
Tool Use استخدام الأدوات
قدرة العميل يستدعي أدوات حقيقية أثناء التنفيذ: يقرأ ملف، يشغّل أمر، أو يستدعي API.
Skills Playbooks جاهزة
معرفة قابلة لإعادة الاستخدام تدخل للعميل وقت الحاجة، حسب السياق.
CLI سطر الأوامر
أدوات واضحة ومقروءة آلياً، تعطي العميل تنفيذ مضبوط وقابل للتكرار.
MCP بروتوكول السياق
بروتوكول موحد يربط العميل بأنظمة خارجية بطريقة آمنة وواضحة.
Verification Gates بوّابات التحقّق
فحوصات إلزامية: اختبارات · تدقيق · أمان · توثيق. ما تمر قصة بدونها.
NCGR Autopilot الطيّار الآلي
النظام التشغيلي الكامل: يأخذ Sprint Backlog ويسلّم القصص وحدة وحدة — Sprint كامل في ساعات.
— 2.1 · المفهوم الأول
03 / 17
NCGR.GOV.SA / AUTOPILOT
SPEAKER NOTES · شريحة 03
اسحب للتنقّل · swipe to navigate