مین مواد پر جائیں

پرامپٹ ہسٹری ریکارڈز (PHRs)

📖 مکمل ترقیاتی تاریخ​

کتاب کی ترقی کے دوران کلود کوڈ کے ساتھ ہر بات چیت کو پرامپٹ ہسٹری ریکارڈز (PHRs) کے طور پر دستاویز کیا گیا ہے۔ یہ ریکارڈز اس کتاب کی تعمیر کے طریقہ کار میں مکمل شفافیت فراہم کرتے ہیں۔

کل PHRs: 17 (اور شمار جاری ہے!)

🎯 PHR کیا ہے؟​

ایک پرامپٹ ہسٹری ریکارڈ درج ذیل کو قید کرتا ہے:

  • صارف کی ان پٹ: مکمل پرامپٹ یا کمانڈ
  • اے آئی کا جواب: اہم فیصلے اور اقدامات
  • فائلز میں تبدیلی: کیا بنایا گیا یا تبدیل کیا گیا
  • نتیجہ: کامیابی کے معیار اور نتائج
  • مرحلہ: ورک فلو کا کون سا حصہ (spec/plan/tasks/implement)

PHRs کیوں اہم ہیں:

  • ✅ دوبارہ تخلیق کرنے کی صلاحیت: کوئی بھی عمل کو دوبارہ تخلیق کر سکتا ہے
  • ✅ سیکھنا: دیکھیں کہ اے آئی مدد سے ترقی کیسے کام کرتی ہے
  • ✅ آڈٹ کرنے کی صلاحیت: فیصلوں کا مکمل ریکارڈ
  • ✅ تعاون: نئے شراکت دار سیاق و سباق کو سمجھتے ہیں
  • ✅ معیار: یقینی بنائیں کہ عمل درست طور پر پیروی کی گئی

📚 باب کے مطابق PHRs​

باب 1: فزیکل اے آئی کا تعارف​

کل: 9 PHRs | حالت: ✅ مکمل

IDعنوانمرحلہتاریخلنک
001ابتدائی باب کی spec بنائیںSpec2025-11-28View
002ابتدائی باب کی منصوبہ بندیPlan2025-11-28View
003ابتدائی باب کے کامTasks2025-11-28View
004ابتدائی باب کا MVP نافذ کریںImplement2025-11-28View
005ابتدائی باب کا US2 نافذ کریںImplement2025-11-28View
006ابتدائی باب کا US3 نافذ کریںImplement2025-11-28View
007ابتدائی باب کا US4 نافذ کریںImplement2025-11-28View
008امتحانات کا مرحلہ7 نافذ کریںImplement2025-11-28View
009آخری تصدیق کا مرحلہ8 پالش کریںImplement2025-11-28View

اہم نکات:

  • مکمل /sp.specify → /sp.plan → /sp.tasks → /sp.implement سائیکل
  • 8 نافذ مراحل (MVP → US2 → US3 → US4 → امتحانات → پالش)
  • نتیجہ: 1975 لائنوں کا جامع تعارفی باب
  • تمام قبولیت کے معیار پورے ہوئے

اہم سیکھ:

  • ماڈیولر صارف کہانیاں (US1-US4) تدریجی نافذ کرنے کو ممکن بناتی ہیں
  • پالش کے مرحلے نے فارمیٹنگ کی ناہمواریوں کو پکڑا
  • تصدیقی رپورٹ آئین کی تعمیل کی تصدیق کرتی ہے

متعلقہ ADRs:

باب 2: ROS 2 کی بنیادی باتیں​

کل: 3 PHRs | حالت: 🟡 22% مکمل (صرف بنیاد)

IDعنوانمرحلہتاریخلنک
001ros2 کی بنیادی باتوں کی spec بنائیںSpec2025-11-28View
002ros2 کی بنیادی باتوں کے کامTasks2025-11-28View
003ros2 کی بنیادی باتوں کی بنیاد نافذ کریںImplement2025-11-29View

اہم نکات:

  • 65 کام تیار کیے گئے (14 مکمل، 51 باقی)
  • بنیادی مواد مکمل: اہداف، جائزہ، ڈایاگرامز، کوئز، ٹربل شوٹنگ
  • 4 لیبز کی منصوبہ بندی (P1: Pub/Sub, P2: Services/Actions, P3: Parameters/Launch, P4: Transforms)
  • TODO.md باقی کام کو شفافیت سے ٹریک کرتا ہے

جو کچھ مکمل ہوا:

  • ✅ سیکھنے کے اہداف (5 پیمائشی مقاصد)
  • ✅ ROS 2 گراف آرکیٹیکچر کے ساتھ تصوراتی جائزہ
  • ✅ مواصلاتی پیٹرنز کا فلوچارٹ (Mermaid)
  • ✅ نوڈ لائف سائیکل ڈایاگرام (Mermaid)
  • ✅ ٹربل شوٹنگ گائیڈ (10 عام غلطیاں)
  • ✅ 10 تصوراتی سوالات کے ساتھ کوئز
  • ✅ 20+ ROS 2 اصطلاحات کے ساتھ گلوسری

جو باقی ہے:

  • ⏳ لیب P1: Pub/Sub (publisher_node.py, subscriber_node.py, launch file)
  • ⏳ لیب P2: Services & Actions (IK server, pick/place action server)
  • ⏳ لیب P3: Parameters & Launch (configurable nodes, multi-node systems)
  • ⏳ لیب P4: Transforms (broadcaster, listener, humanoid tf2 tree)
  • ⏳ امتحانی روبرکس اور جواب کی چابیاں

متعلقہ ADRs:

باب 3: سمولیشن ماحول​

کل: 3 PHRs | حالت: 🚧 منصوبہ بندی (عمل درآمد کا انتظار)

IDعنوانمرحلہتاریخلنک
001باب 3 سمولیشن کی specSpec2025-11-28View
002باب 3 سمولیشن کی منصوبہ بندیPlan2025-11-28View
003باب 3 سمولیشن کے کامTasks2025-11-28View

تیار ہے: /sp.implement جب وقت اجازت دے

منصوبہ بندی شدہ مواد:

  • Gazebo Classic کی ترتیب اور دنیا کی ڈیزائن
  • Unity ML-Agents کا انضمام
  • NVIDIA Isaac Sim کی بنیادی باتیں
  • کراس پلیٹ فارم سمولیشن حکمت عملیاں

متعلقہ ADRs:

باب 4: ادراکی نظام​

کل: 1 PHR | حالت: 🚧 صرف Spec

IDعنوانمرحلہتاریخلنک
001باب 4 ادراکی specSpec2025-11-28View

اگلے مراحل: /sp.plan → /sp.tasks → /sp.implement

عمومی / انفراسٹرکچر​

کل: 1 PHR

IDعنوانمرحلہتاریخلنک
001باب1 کی ترتیب کے لیے گٹ کمٹعمومی2025-11-28View

📊 PHR اعداد و شمار​

مرحلہ کے لحاظ سے​

  • Spec: 4 PHRs (23.5%)
  • Plan: 2 PHRs (11.8%)
  • Tasks: 3 PHRs (17.6%)
  • Implement: 7 PHRs (41.2%)
  • عمومی: 1 PHR (5.9%)

باب کے لحاظ سے​

  • باب 1: 9 PHRs (مکمل ورک فلو)
  • باب 2: 3 PHRs (جزوی ورک فلو)
  • باب 3: 3 PHRs (Spec → Plan → Tasks)
  • باب 4: 1 PHR (صرف Spec)
  • عمومی: 1 PHR (انفراسٹرکچر)

مکملیت کی شرح​

  • مکمل ورک فلو والے باب: 1/10 (10%)
  • Specs والے باب: 4/10 (40%)
  • Plans والے باب: 3/10 (30%)
  • Tasks والے باب: 3/10 (30%)
  • نافذ کردہ باب: 2/10 (20% - باب 1 مکمل، باب 2 جزوی)

🔍 PHR کو کیسے پڑھیں​

ہر PHR اس ڈھانچے کی پیروی کرتا ہے:

---
id: 004
title: "Implement intro chapter MVP"
stage: implement
date: 2025-11-28
surface: agent
model: claude-sonnet-4-5
feature: 001-intro-physical-ai
branch: 001-intro-physical-ai
command: /sp.implement
labels: ["mvp", "chapter1", "foundation"]
links:
  spec: specs/001-intro-physical-ai/spec.md
  ticket: null
  adr: null
  pr: null
files:
  - chapters/01-introduction-physical-ai/README.md
  - chapters/01-introduction-physical-ai/assets/glossary.md
tests:
  - Manual validation against acceptance criteria
---

## Prompt
User requested: "Implement the MVP for Chapter 1 (US1: Foundation)"

## Response
[Detailed implementation steps...]

## Outcome
✅ Success
- Created comprehensive README.md (1500+ lines)
- Added glossary with 25+ terms
- All acceptance criteria met

اہم فیلڈز:

  • ID: خصوصیت کے اندر تسلسلی نمبر
  • مرحلہ: ورک فلو کا کون سا حصہ (spec/plan/tasks/implement)
  • خصوصیت: کون سا باب یا جزو
  • فائلز: کیا بنایا/تبدیل کیا گیا
  • نتیجہ: کامیابی/ناکامی اور تفصیلات

🎯 PHR بہترین عملیات​

شراکت داروں کے لیے​

  1. شروع کرنے سے پہلے PHRs پڑھیں: سمجھیں کہ کیا کیا گیا ہ