اقعد معايا شوية — هنمشي على الـ 66 أمر بتوع Spec Kit واحد واحد: كل أمر بيعمل إيه، إمتى تستخدمه، وليه مهم.

GitHub Spec Kit — الشيت الكامل 📋

تعالى اقعد جنبي كده. مش هحكيلك نظريات — ده الشيت اللي تطبعه وتعلّقه جنب الشاشة، وكل ما تتوه في نص الشغل تبص عليه ثانية وترجع تكمّل. لو عايز الحكاية الكاملة من الأول، دي في المقال المفصل — هنا إحنا في المرجع السريع بس.

ده الشيت اللي تطبعه وتعلّقه جنب الشاشة. مش هتضطر ترجع للـ docs تاني — كل أمر بيعمل إيه، إمتى تستخدمه، وليه مهم، كل حاجة هنا.

قبل أي حاجة، بص على الخريطة دي. دي الرحلة كلها في نظرة واحدة — احفظ الرموز اللي تحتها لأنك هتشوفها في كل جدول جاي:

text

 الرحلة الكاملة:
 ┌──────────────────────────────────────────────────────────────────────────┐
 │ 0.Setup → 1.Constitution → 2.Specify → 3.Plan → 4.Tasks                 │
 │         → 5.Implement → 6.QA & Review → 7.Ship → 8.Maintenance          │
 │                                                                          │
 │ 🖥️ Terminal = specify CLI commands  │  🤖 Agent = /speckit.* slash cmds  │
 │ ❌ Built-in = بدون extension       │  ✅ Extension = يحتاج تثبيت        │
 └──────────────────────────────────────────────────────────────────────────┘

Section📦 التثبيت والإعداد

أول خطوة في أي حاجة: نركّب الأداة. البلوك ده فيه كل اللي هتحتاجه من أول التثبيت لحد تثبيت الـ extensions — انسخ والصق وخلاص:

bash

# التثبيت (مرة واحدة — الطريقة المفضّلة)
uvtoolinstallspecify-cli--fromgit+https://github.com/github/spec-kit.git

# تحقق من التثبيت
specify--version
specifycheck

# تهيئة مشروع جديد
specifyinitmy-project--integrationclaude

# تهيئة في مشروع موجود
specifyinit.--integrationcopilot

# تثبيت أي extension من الـ community
specifyextensionadd<short-name>--fromhttps://github.com/<owner>/<repo>/archive/refs/heads/main.zip

# بحث عن extensions متاحة
specifyextensionsearch

أوامر Spec Kit

➜ ~ npx github-spec-kit init

✓ Initialized in .github/spec-kit/

➜ ~ npx github-spec-kit generate

✓ Generated 5 spec files

➜ ~ npx github-spec-kit validate

✓ All specs valid

➜ ~⏎ نفّذ · ⌫ امسح

⚠️ مهم: الـ built-in extensions الوحيدة اللي بتتثبّت بالاسم بدون --from هي الـ git extension. كل الـ community extensions بتحتاج --from <zip-url>.

النقطة دي بالذات ناس كتير بتقع فيها — تكتب specify extension add review وتستغرب إنه مش شغال. افتكرها: community يعني --from.

Section🔄 الترتيب المقترح — Greenfield (مشروع جديد)

طيب، ركّبنا. دلوقتي السؤال الطبيعي: أبدأ منين وأمشي إزاي؟ لو مشروعك جديد من الصفر، ده الترتيب اللي تمشي عليه بالظبط — العلامة ✅ يعني "متتخطاهوش"، وكلمة (اختياري) يعني حسب مزاجك ومشروعك:

text

[Phase 0] specify init . --integration claude
specifycheck
specifyextensionaddreview,security-review,qa,ship,...
[Phase 1] /speckit.constitution "Security-first. TDD. TTFB < 200ms."
/speckit-red-team(اختياري—هاجمالـconstitution)
[Phase 2] /speckit.specify "Feature description"
/speckit.clarify(إزالةالغموض)
/speckit-critique(اختياري—dual-lensreview)
/speckit.checklist(اختياري—qualityvalidation)
[Phase 3] /speckit.plan "Vite + SQLite + vanilla JS"
/speckit-blueprint(اختياري—خريطةالكودقبلالتنفيذ)
/speckit-version-guard(اختياري—تحققمنالـdependencies)
[Phase 4] /speckit.tasks
/speckit.analyze(✅ضروريقبلimplementدايماً)
/speckit.taskstoissues(اختياري—ربطبـGitHubIssues)
[Phase 5] /speckit.implement
/speckit-checkpoint(اختياري—commitsمنظّمة)
[Phase 6] /speckit-verify            (✅ ضروري)
/speckit-verify-tasks(✅ضروري)
/speckit-review(اختياري—codereview)
/speckit-security-review(اختياري—securityaudit)
/speckit-qa(اختياري—acceptancetesting)
[Phase 7] /speckit-status
/speckit-ship(اختياري—releasepipeline)

Section🔄 الترتيب المقترح — Brownfield (مشروع موجود)

تقوللي "بس أنا عندي codebase قديم مليان كود"؟ أقولك — في مسار مخصوص ليك. الفرق الأساسي: قبل ما تكتب أي spec جديد، لازم الأول تفهم اللي موجود (repoindex + brownfield)، وبعد أي تعديل تتأكد إنك ما كسرتش حاجة:

text

[Phase 0] specify init . --integration copilot
specifyextensionaddbrownfield,repoindex,verify,reconcile,...
[Phase 1] /speckit-repoindex          (افهم الكود الموجود)
/speckit-brownfield(عملreverse-engineeringللـmodules)
/speckit.constitution(حدّدقواعدالمشروع)
[Phase 2] /speckit-brownfield "Reverse-engineer the auth module"
/speckit-brownfield"Reverse-engineer the API layer"
...(كرّرلكلmoduleرئيسي)
[Phase 3] /speckit.plan               (لو بتضيف feature جديدة)
[Phase 4] /speckit.tasks + /speckit.analyze
[Phase 5] /speckit.implement
[Phase 6] /speckit-review
/speckit-security-review
/speckit-spectest(اعملtestsمنالـspecs)
/speckit-verify
/speckit-reconcile(تحققمنالـconsistency)
[Phase 7] /speckit-checkpoint
/speckit-ship
[Phase 8] /speckit-bugfix             (لأي bug جديد)
/speckit-ripple(بعدأيتعديل)
/speckit-verify(تحققإنالتعديلماكسرشحاجة)

SectionPhase 0 — الإعداد 🖥️ Terminal

خد نفس. دلوقتي هنمشي phase بـ phase، وكل جدول فيهم مرجعك السريع. الـ phase دي كلها أوامر terminal — يعني specify مش /speckit — ودي اللي بتجهّز الأرض قبل ما الـ agent يلمس أي حاجة:

الأمر	بيعمل إيه بالظبط	إمتى تستخدمه	ليه مهم
`specify init <name>`	بينشئ مشروع جديد بالكامل: بيـ create الـ `.specify/` directory، بيـ generate templates، بيـ setup الـ agent integration	أول مرة — مشروع جديد	من غيره مش هتكون عندك بنية SDD خالص
`specify init . --integration <agent>`	بينشئ الـ SDD structure في مشروع موجود مع الـ agent integration المناسب	في مشروع موجود	بيتكامل مع الـ AI agent بتاعك من أول يوم
`specify check`	بيعمل audit للـ environment: بيتأكد إن Python, Git, uv كلهم شغالين وبتأكد إن الـ dependencies متوفرة	بعد التثبيت أو في أي وقت	لو حاجة ناقصة هتكتشفها هنا مش في وسط الـ workflow
`specify --version`	بيطّلع إصدار الـ CLI والـ system info	أي وقت	عشان تتأكد إنك شغّال الـ official build
`specify self`	بيعمل check و upgrade للـ CLI نفسه	للتحديث	عشان تبقى على أحدث إصدار
`specify extension search`	بيعرض قائمة بكل الـ extensions المتاحة	قبل التثبيت	عشان تعرف إيه المتاح قبل ما تختار
`specify extension add <n> --from <url>`	بيثبّت extension من community	بعد init	كل extension بتـ add capability جديدة
`specify extension remove <n>`	بيحذف extension وملفاته	لإزالة extension	تنظيف
`specify preset search`	بيعرض قائمة بالـ presets المتاحة	قبل استخدام presets	الـ presets بتغيّر شكل الـ specs
`specify preset add <n>`	بيثبّت preset templates	لتعديل شكل الـ specs	تخصيص الـ output format
`specify integration list`	بيعرض كل الـ AI agents المدعومة (30+)	قبل init	عشان تشوف هل الـ agent بتاعك مدعوم
`specify workflow run <name>`	بيشتغل workflow كامل بالترتيب	لتشغيل دورة كاملة	لو عايز تـ automate الـ phases

ليه الجدول ده مهم؟ لأن 90% من مشاكل "الأداة مش شغالة" بتتحل بـ specify check قبل ما تدوّر في أي حتة تانية.

SectionPhase 1 — الـ Constitution 🏛️

دي احفظها زي اسمك: الـ constitution هو أول حاجة تكتبها وآخر حاجة تكسرها. ده مش ملف docs عادي — ده القانون اللي كل أمر بعد كده هيقرأه تلقائياً قبل ما يتحرك:

الأمر	بيعمل إيه بالظبط	إمتى	ليه مهم	الـ Output
`/speckit.constitution`	بيـ generate `constitution.md` اللي بيـ encode القواعد الأساسية للمشروع: tech stack, testing mandates, compliance	أول المشروع أو تغيير قواعد	ده الـ hard gate اللي بيـ enforce الـ quality في كل phase — من غيره الـ AI مش هيعرف constraints	`.specify/memory/constitution.md`
`/speckit-red-team`	بيعمل adversarial review للـ constitution أو الـ plan — بيحاول يلاقي gaps و weaknesses	بعد constitution أو plan	بيشوف إن الـ constitution ممكن يـ bypass من غير ما حد يلاحظ	findings report (بدون auto-edit)
`/speckit-brownfield`	بيعمل reverse-engineering للـ modules في مشروع موجود — بيـ generate specs أولية	بداية مشروع موجود	لو عندك codebase موجود ومش عندك specs، ده بيـ bootstrap العملية	specs أولية لكل module
`/speckit-repoindex`	بيعمل index شامل للـ repo كله — بيـ create خريطة للـ codebase	مشروع موجود — مرة واحدة	عشان الـ AI يفهم الـ structure من أول مرة	`.specify/repo-index.md`

مثال عملي:

bash

/speckit.constitutionSecurity-first.TDDmandatory.TTFB<200ms.

ده بيعمل constitution بيـ enforce: security-first approach, TDD mandatory, و TTFB أقل من 200ms. كل command جوا الـ Spec Kit هيقرأ ده تلقائياً.

والـ extensions اللي هتحتاجها في الـ phase دي:

bash

specifyextensionaddred-team--fromhttps://github.com/ashbrener/spec-kit-red-team/archive/refs/heads/main.zip
specifyextensionaddbrownfield--fromhttps://github.com/Quratulain-bilal/spec-kit-brownfield/archive/refs/heads/main.zip
specifyextensionaddrepoindex--fromhttps://github.com/liuyiyu/spec-kit-repoindex/archive/refs/heads/main.zip

SectionPhase 2 — الـ Specify 📝

فاكر لما قلتلك إن الـ spec هو الأساس؟ هنا بيتكتب. والغلطة اللي الكل بيعملها في الـ phase دي إنه يستعجل — تعالى نشوف الأوامر الأول وبعدين أقولك القاعدة الذهبية:

الأمر	بيعمل إيه بالظبط	إمتى تستخدمه	ليه مهم	الـ Output
`/speckit.specify`	بيـ generate `spec.md` بالـ user stories و acceptance criteria — بيركز على إيه وليه مش إزاي	كل feature جديدة	ده الـ foundation — من غير spec مكتوب، كل حاجة بعد كده هتبقى guesswork	`specs/<feature>/spec.md`
`/speckit.clarify`	بيـ identify الـ ambiguities في الـ spec ويـ quiz الـ developer — يسجل الإجابات في الـ spec	بعد specify، قبل plan	بيـ eliminate الـ guesswork — الـ AI مش لازم يـ guess	يحدّث `spec.md`
`/speckit-critique`	بيعمل dual-lens review للـ spec — بيـ review من زاويتين مختلفتين	بعد specify	بيشوف حاجات الـ developer ممكن يكون غفل عنها	critique-report.md
`/speckit-spec-validate`	بيعمل comprehension quiz و gate — بيتأكد إن الـ AI فهم الـ spec صح	بعد clarify، قبل implement	بيمنع الـ AI يـ implement حاجة فهمها غلط	comprehension quiz + gate
`/speckit.checklist`	بيـ generate validation checklist — "unit tests for English"	بعد specify	بيـ ensure إن الـ requirements complete, clear, consistent	`checklist.md`
`/speckit-whatif`	بيعمل impact analysis لو فكّرت تغيّر requirements	قبل تغيير requirements	بيمنعك تعمل تغيير بيكسر حاجات تانية	impact analysis
`/speckit-scope`	بيقدّر حجم الجهد المطلوب	بعد specify	عشان تعرف هل الـ feature ده كبير ولا صغير	scope-report.md
`/speckit-memory-loader`	بيحمّل `.specify/memory/` تلقائياً — constitution و context	تلقائياً قبل كل command	بيـ ensure إن الـ AI عنده كل الـ context	بيحمّل context

القاعدة الذهبية في specify: قول إيه وليه — متقولش إزاي. الـ agent هيفكّر في التقنية. لو حطيت "React + Node" في الـ spec وهيكن ممكن يـ implement بـ Vue + Python، الـ spec هيبقى outdated.

bash

specifyextensionaddcritique--fromhttps://github.com/arunt14/spec-kit-critique/archive/refs/heads/main.zip
specifyextensionaddspec-validate--fromhttps://github.com/aeltayeb/spec-kit-spec-validate/archive/refs/heads/main.zip
specifyextensionaddwhatif--fromhttps://github.com/DevAbdullah90/spec-kit-whatif/archive/refs/heads/main.zip
specifyextensionaddscope--fromhttps://github.com/Quratulain-bilal/spec-kit-scope-/archive/refs/heads/main.zip
specifyextensionaddmemory-loader--fromhttps://github.com/KevinBrown5280/spec-kit-memory-loader/archive/refs/heads/main.zip

SectionPhase 3 — الـ Plan 🗺️

هنا بس — وهنا بس — بنبدأ نتكلم تقنية. الـ spec قال "إيه"، الـ plan بيقول "إزاي": الـ stack، الـ data models، الـ contracts، كله بيتحدد في اللحظة دي:

الأمر	بيعمل إيه بالظبط	إمتى تستخدمه	ليه مهم	الـ Output
`/speckit.plan`	بيـ synthesize technical architecture من الـ spec — بيـ define data models, API contracts, file structures	بعد spec — حدّد الـ tech stack	هنا بننتقل من "إيه" لـ "إزاي" — الـ plan هو الـ blueprint التقني	`plan.md` + `data-model.md` + `contracts/`
`/speckit-blueprint`	بيـ generate class diagrams و file layout — خريطة الكود قبل التنفيذ	بعد plan، قبل implement	عشان تشوف الـ structure قبل ما يـ implement	`blueprint.md` (class diagrams + file layout)
`/speckit-version-guard`	بيتحقق إن الـ dependencies متوافقة مع بعض ومع الـ constitution	بعد plan	لو في conflict بين الـ deps، ده بيكتشفه بدري	version-report.md
`/speckit-diagram`	بيـ generate Mermaid diagrams للـ architecture visualization	بعد plan/tasks	visual aid عشان تفهم الـ structure	Mermaid diagrams
`/speckit-red-team`	بيعمل adversarial review للـ plan — بيحاول يلاقي weaknesses	بعد plan	بيشوف إن الـ plan ممكن يكون فيه gaps	findings report

عشان تعرف بالظبط إيه اللي هيطلعلك، ده شكل الـ output كامل:

الـ output الكامل لـ /speckit.plan:

text

specs/<feature>/
├── plan.md           ← الخطة التقنية
├── data-model.md     ← الـ schema
├── contracts/
│   ├── api-spec.json ← API contracts
│   └── signalr-spec.md
├── research.md
└── quickstart.md

bash

specifyextensionaddblueprint--fromhttps://github.com/chordpli/spec-kit-blueprint/archive/refs/heads/main.zip
specifyextensionaddversion-guard--fromhttps://github.com/KevinBrown5280/spec-kit-version-guard/archive/refs/heads/main.zip
specifyextensionadddiagram--fromhttps://github.com/Quratulain-bilal/spec-kit-diagram-/archive/refs/heads/main.zip

SectionPhase 4 — الـ Tasks 🧩

الـ plan جاهز؟ حلو. دلوقتي بنقطّعه لقطع صغيرة الـ agent يقدر ينفّذها واحدة واحدة. وخلّي بالك من /speckit.analyze — ده أهم أمر في الجدول ده كله:

الأمر	بيعمل إيه بالظبط	إمتى تستخدمه	ليه مهم	الـ Output
`/speckit.tasks`	بيـ generate `tasks.md` بالـ dependencies و `[P]` parallel markers — بيـ organize الـ implementation في logical sequence	بعد plan	عشان الـ AI يعرف يـ implement بالترتيب الصح — infrastructure قبل UI	`tasks.md` بـ dependencies + `[P]` parallel markers
`/speckit.analyze`	بيعمل consistency check بين الـ spec, plan, و tasks — بيـ detect constitutional violations	بعد tasks، قبل implement دايماً	غلطة consistency هنا بتتصلح في 2 دقيقة — بعد implement بتاخد ساعة. ده الـ safety gate	analysis.md — consistency check
`/speckit.taskstoissues`	بيحول الـ tasks لـ GitHub Issues	بعد tasks	عشان تـ track الشغل على GitHub	GitHub Issues (remote)
`/speckit-jira`	بيحول الـ tasks لـ Jira Epic → Stories → Sub-tasks	بعد tasks	لو شغال بـ Jira	Jira Epic → Stories → Sub-tasks
`/speckit-maqa-linear`	بيحول الـ tasks لـ Linear issues	MAQA workflow	لو شغال بـ Linear	Linear issues
`/speckit-maqa-trello`	بيحول الـ tasks لـ Trello board	MAQA workflow	لو شغال بـ Trello	Trello board
`/speckit-maqa-azure-devops`	بيحول الـ tasks لـ Azure DevOps work items	MAQA workflow	لو شغال بـ Azure DevOps	Azure DevOps work items

bash

specifyextensionaddjira--fromhttps://github.com/mbachorik/spec-kit-jira/archive/refs/heads/main.zip

⚠️ لازم: /speckit.analyze قبل /speckit.implement دايماً. ده الـ safety gate اللي بيمنعك تـ implement على أساس خاطئ.

SectionPhase 5 — الـ Implement 🚀

وصلنا للحتة اللي الكل مستنيها — الكود نفسه. المفارقة؟ لو عملت الـ phases اللي فاتت صح، دي أسهل phase في الرحلة كلها:

الأمر	بيعمل إيه بالظبط	إمتى تستخدمه	ليه مهم	الـ Output
`/speckit.implement`	بيـ direct الـ agent يبني الكود task-by-task — بيـ mark الـ tasks كـ complete وبيـ proactively resolve الـ issues	بعد tasks + analyze	ده الـ phase اللي بيـ build الـ code فعلاً	source code + `tasks.md` محدّث بـ ✅
`/speckit-checkpoint`	بيعمل git commits منظّمة أثناء implement — مش commit ضخم واحد	تلقائياً أثناء implement	commits منظّمة = rollback سهل = تاريخ واضح	git commits منظّمة
`/speckit-worktree`	بيعمل isolated git worktree للـ parallel feature development	parallel feature development	عشان تـ work على features متعددة في parallel من غير conflicts	git worktrees معزولة
`/speckit-worktrees`	بيعمل sibling/nested worktrees لعدة agents في parallel	عدة agents في parallel	لو شغال بـ multiple AI agents على نفس المشروع	sibling/nested worktrees
`/speckit-conduct`	بيـ delegate phases لـ sub-agents — كل agent يـ implement phase معينة	لو الـ context window كبير	عشان تـ parallelize الـ implementation	يفوّض phases لـ sub-agents

bash

specifyextensionaddcheckpoint--fromhttps://github.com/aaronrsun/spec-kit-checkpoint/archive/refs/heads/main.zip
specifyextensionaddworktree--fromhttps://github.com/Quratulain-bilal/spec-kit-worktree/archive/refs/heads/main.zip
specifyextensionaddworktrees--fromhttps://github.com/dango85/spec-kit-worktree-parallel/archive/refs/heads/main.zip
specifyextensionaddconduct--fromhttps://github.com/twbrandon7/spec-kit-conduct-ext/archive/refs/heads/main.zip

SectionPhase 6 — الـ QA & Review 🧪

الـ agent قالك "خلّصت"؟ متصدقوش على طول. الـ phase دي هي اللي بتفرّق بين كود شغال فعلاً وكود شكله شغال.

اتنين ضروريين، الباقي اختياري — بس الاختياري مش معناه مش مهم:

الأمر	بيعمل إيه بالظبط	الأولوية	ليه مهم
`/speckit-verify`	بيتحقق إن الكود بيطابق كل requirement في الـ spec — ده الـ gate الأساسي	✅ ضروري	لو الكود مش مطابق للـ spec، الكود مش جاهز — point.
`/speckit-verify-tasks`	بيـ detect "phantom completions" — الـ AI قال "خلّصت" بس الكود مش موجود فعلاً	✅ ضروري	الـ AI بيقول "خلّصت" وهو ما عملش — اكتشفه هنا قبل الـ production
`/speckit-review`	6 agents متخصصة بيراجعو من 6 زوايا: code quality, comments, tests, errors, types, simplification	🔶 مهم	مش مجرد linting — ده review شامل من 6 perspectives مختلفة
`/speckit-staff-review`	مراجعة بمستوى senior engineer	🔶 مهم	للـ high-stakes implementations اللي محتاجة عين خبيرة
`/speckit-security-review`	OWASP top 10, injection, auth, data exposure	🔶 مهم	الأمان مش luxury — ده بيكتشف ثغرات انت ممكن متشوفهاش
`/speckit-qa`	browser/CLI acceptance testing ضد الـ spec criteria	🔶 اختياري	تأكد إن الـ feature شغال زي الـ spec بيقول
`/speckit-spectest`	بيـ map الـ tests للـ requirements — يكشف untested areas	🔶 اختياري	يطّلع الـ gaps في الـ testing — حاجات نسيت تـ coverها
`/speckit-ripple`	side effects analysis في 9 domains	🔶 مهم بعد أي تعديل	أي تعديل ليه side effects — ده بيكتشفها قبل ما تـ merge
`/speckit-cleanup`	scout rule: يصلح الصغير، يسجّل الكبير	🔶 اختياري	نظافة الكود — يـ fix الـ small stuff ويسجل الـ big stuff لـ later
`/speckit-fix-findings`	auto-fix نتايج الـ review	🔶 اختياري	بيصلح اللي يقدر يصلحه تلقائياً عشان توفر وقت
`/speckit-reconcile`	لو الكود حاد عن الـ spec، يحدّث الـ spec	🔶 اختياري	أحياناً الكود هو الصح والـ spec يحتاج تعديل — ده بيعمل alignment

bash

specifyextensionaddverify--fromhttps://github.com/ismaelJimenez/spec-kit-verify/archive/refs/heads/main.zip
specifyextensionaddverify-tasks--fromhttps://github.com/datastone-inc/spec-kit-verify-tasks/archive/refs/heads/main.zip
specifyextensionaddreview--fromhttps://github.com/ismaelJimenez/spec-kit-review/archive/refs/heads/main.zip
specifyextensionaddstaff-review--fromhttps://github.com/arunt14/spec-kit-staff-review/archive/refs/heads/main.zip
specifyextensionaddsecurity-review--fromhttps://github.com/DyanGalih/spec-kit-security-review/archive/refs/heads/main.zip
specifyextensionaddqa--fromhttps://github.com/ismaelJimenez/spec-kit-qa/archive/refs/heads/main.zip
specifyextensionaddspectest--fromhttps://github.com/Quratulain-bilal/spec-kit-spectest/archive/refs/heads/main.zip
specifyextensionaddripple--fromhttps://github.com/chordpli/spec-kit-ripple/archive/refs/heads/main.zip
specifyextensionaddcleanup--fromhttps://github.com/dsrednicki/spec-kit-cleanup/archive/refs/heads/main.zip
specifyextensionaddreconcile--fromhttps://github.com/stn1slv/spec-kit-reconcile/archive/refs/heads/main.zip

SectionPhase 7 — الـ Ship 🚢

كل حاجة خضرا؟ يبقى وقت الشحن. الـ phase دي بتحوّل "الكود خلص" لـ "الـ release طلع" — من غير شغل يدوي:

الأمر	بيعمل إيه بالظبط	إمتى	ليه مهم	الـ Output
`/speckit-status`	بيعرض dashboard بحالة المشروع كلها: specs, tasks, tests, coverage	قبل ship — تحقق إن كل حاجة green	عشان تشوف هل كل حاجة جاهزة قبل ما تـ ship	console dashboard
`/speckit-ci-guard`	بيمنع merge لو specs ناقصة في الـ CI pipeline	في الـ CI pipeline تلقائياً	بيـ enforce إن أي PR لازم يكون عنده spec	يمنع merge لو specs ناقصة
`/speckit-pr-bridge`	بيـ generate PR description تلقائية من الـ specs	بعد implement، عند عمل PR	بيكتب PR description من الـ spec عشان محدش ينسى	PR description تلقائية
`/speckit-confluence`	بيـ publish specs على Confluence	بعد finalize specs	عشان الـ team يشوف الـ docs في مكان مركزي	Confluence page
`/speckit-ship`	بيعمل CHANGELOG + release PR + git tags	لما كل حاجة جاهزة	الـ release automation — مش لازم تعمل manual	CHANGELOG + release PR + git tags
`/speckit-retrospective`	بيعمل retrospective + درجة adherence	بعد كل feature	عشان تتعلم وتحسّن الـ process للمرة الجاية	retrospective.md + درجة adherence
`/speckit-memory-hub`	بيحفظ الدروس المستفادة في `.specify/memory/`	بعد ship	الـ lessons learned مش بتضيع — بتتسجل للـ features الجاية	`.specify/memory/` محدّث

bash

specifyextensionaddstatus--fromhttps://github.com/KhawarHabibKhan/spec-kit-status/archive/refs/heads/main.zip
specifyextensionaddci-guard--fromhttps://github.com/Quratulain-bilal/spec-kit-ci-guard/archive/refs/heads/main.zip
specifyextensionaddpr-bridge--fromhttps://github.com/Quratulain-bilal/spec-kit-pr-bridge-/archive/refs/heads/main.zip
specifyextensionaddship--fromhttps://github.com/arunt14/spec-kit-ship/archive/refs/heads/main.zip
specifyextensionaddretrospective--fromhttps://github.com/emi-dm/spec-kit-retrospective/archive/refs/heads/main.zip
specifyextensionaddmemory-md--fromhttps://github.com/DyanGalih/spec-kit-memory-hub/archive/refs/heads/main.zip

SectionPhase 8 — الـ Maintenance 🔧

وشحنّا. خلصنا؟ لأ طبعاً — الـ software بيعيش وبيتغيّر، والـ phase دي هي اللي بتخلّي الـ specs تفضل عايشة معاه بدل ما تموت في drawer:

الأمر	بيعمل إيه بالظبط	إمتى تستخدمه	ليه مهم
`/speckit-doctor`	بيعمل periodic health check للمشروع كله	periodic health check	زي الـ checkup السنوي — بيكتشف مشاكل قبل ما تكبر
`/speckit-status`	بيعرض dashboard بحالة المشروع	daily check	نظرة سريعة على فين حاجاتك
`/speckit-sync`	بيـ detect إن الـ specs حادّت عن الكود	detect spec-code drift	الـ drift بيحصل بمرور الوقت — ده بيكتشفه
`/speckit-bugfix`	بيعمل structured bug fix workflow — spec-aware remediation	أي bug جديد	مش مجرد fix — ده fix بيـ maintain spec compliance
`/speckit-fixit`	بيعمل quick targeted fix	quick targeted fix	لما محتاج fix سريع بس عايزه يكون structured
`/speckit-iterate`	بيعدّل الـ spec أثناء الـ implementation	تعديل spec mid-implementation	لما الـ reality بيختلف عن الـ spec أثناء التنفيذ
`/speckit-refine`	بيغيّر الـ requirements ويـ cascade التعديلات	تغيير requirements + cascade	كل تعديل بيـ cascade في الـ tasks والـ code
`/speckit-memory-hub audit`	بينظّف الـ memory القديم	تنظيف memory قديم	الـ memory بتتراكم — ده بيـ clean اللي مش محتاج

bash

specifyextensionadddoctor--fromhttps://github.com/KhawarHabibKhan/spec-kit-doctor/archive/refs/heads/main.zip
specifyextensionaddsync--fromhttps://github.com/bgervin/spec-kit-sync/archive/refs/heads/main.zip
specifyextensionaddbugfix--fromhttps://github.com/Quratulain-bilal/spec-kit-bugfix/archive/refs/heads/main.zip
specifyextensionadditerate--fromhttps://github.com/imviancagrace/spec-kit-iterate/archive/refs/heads/main.zip
specifyextensionaddrefine--fromhttps://github.com/Quratulain-bilal/spec-kit-refine/archive/refs/heads/main.zip

Section🎯 دليل القرار السريع

تايه ومش عارف تبدأ منين؟ دوّر على الموقف بتاعك في العمود الشمال، وامشي:

سيناريو	ابدأ من هنا
مشروع جديد من الصفر	Phase 0 → Phase 1 → Phase 2 → ...
مشروع موجود، عايز تطبّق SDD	Phase 0 (مع brownfield + repoindex) → Phase 1
constitution جاهز، بتبدأ feature جديدة	Phase 2 (specify)
spec كتبته، جاهز للـ plan	Phase 3
plan جاهز، محتاج تنظّم الشغل	Phase 4 (tasks)
tasks جاهزة، وقت الكود	Phase 5 (implement)
كود خلص، محتاج quality check	Phase 6 (QA)
كل الـ tests اجتازت	Phase 7 (ship)
bug اتبلّغ	Phase 8 → bugfix → verify → ripple
requirements اتغيّرت في النص	iterate → refine → tasks → implement
مش عارف فين حاجاتك	`/speckit-status` → اقرأ الـ dashboard

Section🏗️ ملفات المشروع بعد `specify init`

عايز تعرف إيه اللي اتحط في مشروعك بالظبط بعد الـ init؟ دي الخريطة كاملة — بص عليها مرة واحدة وهتعرف كل ملف جاي منين:

text

my-project/
├── .specify/
│   ├── memory/constitution.md      ← قواعد المشروع
│   ├── templates/
│   │   ├── spec-template.md
│   │   ├── plan-template.md
│   │   └── tasks-template.md
│   ├── templates/overrides/        ← أعلى priority
│   ├── presets/                    ← preset templates
│   ├── extensions/                 ← installed extensions
│   └── features/
│       └── 001-feature-name/
│           ├── spec.md             ← من /speckit.specify
│           ├── plan.md             ← من /speckit.plan
│           ├── tasks.md            ← من /speckit.tasks
│           ├── data-model.md
│           ├── contracts/
│           │   ├── api-spec.json
│           │   └── signalr-spec.md
│           ├── research.md
│           ├── checklist.md
│           ├── blueprint.md
│           └── analysis.md
├── CLAUDE.md     ← أو KIMI.md / COPILOT.md حسب الـ integration
├── .gitignore
└── src/          ← الكود (بيتعمل من /speckit.implement)

ولو عدّلت template وسألت نفسك "مين بيكسب لو في أكتر من نسخة؟" — الإجابة هنا:

Template Resolution Order (الأعلى بيكسب):

text

1. .specify/templates/overrides/    ← project-local (أعلى priority)
2. .specify/presets/templates/      ← presets
3. .specify/extensions/templates/   ← extensions
4. .specify/templates/              ← spec kit core (أقل priority)

Section🤖 الـ Integrations المدعومة (30+)

شغال بأنهي agent؟ مش مهم — Spec Kit بيتكلم مع الكل تقريباً. اختار سطرك من هنا:

bash

specifyinit.--integrationclaude# Claude Code → CLAUDE.md
specifyinit.--integrationcopilot# GitHub Copilot → .github/copilot/
specifyinit.--integrationgemini# Gemini CLI → GEMINI.md
specifyinit.--integrationcodex# Codex CLI → CODEX.md
specifyinit.--integrationcursor-agent# Cursor → .cursor/rules/
specifyinit.--integrationcline# Cline → .clinerules
specifyinit.--integrationroo# Roo Code → .roorules
specifyinit.--integrationwindsurf# Windsurf → .windsurf/rules/
specifyinit.--integrationhermes# Hermes → HERMES.md
specifyinit.--integrationkimi# Kimi Code → KIMI.md
specifyinit.--integrationkiro-cli# Kiro → KIRO.md
specifyinit.--integrationforge# Forge → FORGE.md
specifyinit.--integrationopencode# opencode → OPENCODE.md
specifyinit.--integrationqwen# Qwen Code → QWEN.md

# لو الـ agent بتاعك مش في القائمة:
specifyinit.--integrationgeneric--integration-options="--commands-dir .myagent/cmds"

# Skills mode (لـ agents بتدعمها):
specifyinit.--integrationcodex--integration-options="--skills"

# عرض كل الـ integrations:
specifyintegrationlist

Section🛡️ قواعد مهمة

لو مش هتفتكر من الشيت ده غير جدول واحد، خليه ده. دي القواعد اللي لو كسرتها هتدفع تمنها وقت و debugging:

القاعدة	التفاصيل	ليه
متقولش tech stack في `/speckit.specify`	بس قول إيه وليه — الـ plan هو المكان الصح للتقنية	الـ spec لازم يبقى technology-agnostic عشان يعيش طويل
`/speckit.analyze` قبل implement دايماً	الـ consistency check بيوفّر ساعات debugging	غلطة هنا بتتصلح في 2 دقيقة — بعد implement بتاخد ساعة
الـ constitution مش اختياري	بيمشي مع كل command ومش لازم تتذكر تحطه	بيتقرأ تلقائياً مع كل slash command
`[P]` markers في tasks.md	بيحدد الـ tasks اللي ممكن تتنفّذ بالـ parallel	بيـ speed up الـ implementation
Community extensions بتحتاج `--from`	مش ممكن تقول `specify extension add review` بس	الـ built-in الوحيد هو git extension
`/speckit-verify-tasks` ضروري	الـ AI بيقول "خلّصت" وهو ما عملش — اكتشفه هنا	phantom completions مش هتكتشفها من غيره
كل feature = branch جديد	اختياري بس best practice	بيـ isolate الـ changes

Section⚙️ Brownfield Golden Rule

وقبل ما أسيبك — لو شغال على كود موجود، دي الـ 7 خطوات اللي تمشيها قبل وبعد أي تعديل. احفظها زي اسمك:

text

قبل ما تعدّل أي كود موجود:
  1. /speckit-status          ← اعرف فين حاجاتك دلوقتي
  2. اقرأ spec.md للـ module  ← افهم الـ contract
  3. عدّل الكود
  4. /speckit-verify          ← هل كسرت الـ contract؟
  5. /speckit-ripple          ← أي side effects؟
  6. /speckit-spectest        ← الـ tests لسه aligned؟
  7. /speckit-reconcile       ← consistency check أخير

Section📎 المراجع

GitHub Spec Kit Repository
Spec Kit Documentation
Integrations Reference
المقال المفصل — الدليل الشامل لـ GitHub Spec Kit

الشيت ده جزء من سلسلة Agentic AI على Learn-in-Depth Journal.

GitHub Spec Kit — الشيت الكامل: 66 أمر، كل أمر بتعمل إيه وإمتى وليه

GitHub Spec Kit — الشيت الكامل 📋

Section📦 التثبيت والإعداد

Section🔄 الترتيب المقترح — Greenfield (مشروع جديد)

Section🔄 الترتيب المقترح — Brownfield (مشروع موجود)

SectionPhase 0 — الإعداد 🖥️ Terminal

SectionPhase 1 — الـ Constitution 🏛️

SectionPhase 2 — الـ Specify 📝

SectionPhase 3 — الـ Plan 🗺️

SectionPhase 4 — الـ Tasks 🧩

SectionPhase 5 — الـ Implement 🚀

SectionPhase 6 — الـ QA & Review 🧪

SectionPhase 7 — الـ Ship 🚢

SectionPhase 8 — الـ Maintenance 🔧

Section🎯 دليل القرار السريع

Section🏗️ ملفات المشروع بعد `specify init`

Section🤖 الـ Integrations المدعومة (30+)

Section🛡️ قواعد مهمة

Section⚙️ Brownfield Golden Rule

Section📎 المراجع

قيّمه عجبك؟ المقال ده

Comments

فهرس المقال

GitHub Spec Kit — الشيت الكامل: 66 أمر، كل أمر بتعمل إيه وإمتى وليه

GitHub Spec Kit — الشيت الكامل 📋

Section📦 التثبيت والإعداد

Section🔄 الترتيب المقترح — Greenfield (مشروع جديد)

Section🔄 الترتيب المقترح — Brownfield (مشروع موجود)

SectionPhase 0 — الإعداد 🖥️ Terminal

SectionPhase 1 — الـ Constitution 🏛️

SectionPhase 2 — الـ Specify 📝

SectionPhase 3 — الـ Plan 🗺️

SectionPhase 4 — الـ Tasks 🧩

SectionPhase 5 — الـ Implement 🚀

SectionPhase 6 — الـ QA & Review 🧪

SectionPhase 7 — الـ Ship 🚢

SectionPhase 8 — الـ Maintenance 🔧

Section🎯 دليل القرار السريع

Section🏗️ ملفات المشروع بعد specify init

Section🤖 الـ Integrations المدعومة (30+)

Section🛡️ قواعد مهمة

Section⚙️ Brownfield Golden Rule

Section📎 المراجع

قيّمه عجبك؟ المقال ده

Comments

فهرس المقال

Section🏗️ ملفات المشروع بعد `specify init`