منصوبے کے بارے میں

Worktrail ایک ٹاسک آرکیسٹریشن سسٹم ہے جسے spec-format-agnostic ہونے کے لیے ڈیزائن کیا گیا ہے، جو git worktrees میں parallel execution، deterministic route classification، اور work-queue handoff کو ممکن بناتا ہے۔ اسے `developer-kit` Claude Code پلگ ان مارکیٹ پلیس سے نکالا گیا ہے تاکہ `TaskSource` اڈاپٹر انٹرفیس کے ذریعے کسی بھی ٹاسک فارمیٹ کے ساتھ کسی بھی ہارنس (harness) کے ذریعے استعمال کیا جا سکے۔ یہ سسٹم متعدد ٹاسک فارمیٹس کو سمجھتا ہے بشمول DevKit ٹاسک فائلیں، OpenSpec تبدیلیاں، اور GitHub Spec Kit فیچر ٹاسکس۔ اس میں ایک سیشن میں ایک بار استعمال ہونے والا Stop hook شامل ہے جو ٹھوس کام کے بعد غیر معمولی اگلے قدم کے آئیڈیاز کو محفوظ کرتا ہے۔ خود مختار آپریشن کے کلیدی فیچرز: - `worktrail-drain` ورک کیو کو بغیر کسی نگرانی کے چلاتا ہے، جو headless one-shot executions (Claude, Codex, یا OpenCode) کو فعال کرتا ہے جو کیو شدہ بریفس (briefs) کا دعویٰ کرتے ہیں، کام کرتے ہیں، اور PRs کھولتے ہیں۔ - Intake triage pre-pass: فعال تبدیلیوں کے مقابلے میں انٹیک بریفس کا جائزہ لیتا ہے، فیصلے تجویز کرتا ہے (مثلاً، fold-into-change, propose-change)، اور منظور شدہ اقدامات لاگو کرتا ہے (ڈیفالٹ طور پر بند)۔ - Backlog seeding: پلاننگ بیک لاگ (مثلاً، `needs-tasks` مرحلے میں specs) کو کیو بریفس میں تبدیل کرتا ہے (ڈیفالٹ طور پر آن)، جس میں deterministic اور deduplicated سیڈنگ شامل ہے۔ - Human decision queue: جب کسی پروڈکٹ فیصلے کی ضرورت ہوتی ہے، تو یہ ایک منظم ریکارڈ فائل کرتا ہے اور `worktrail-decision` کمانڈز یا فائل ایڈٹس کے ذریعے انسانی ان پٹ کا انتظار کرتا ہے۔ - Operator configuration: ٹارگٹ اور ٹیر (tier) تعریفات کے لیے `~/.worktrail/routing.yaml` کا استعمال کرتا ہے، جو ڈرین آپریشنز کے دوران پرووائیڈر/ماڈل کے انتخاب کو کنٹرول کرتے ہیں۔ - Resumable state handling: تعطل شدہ حالتوں (مثلاً، بجٹ ختم ہونا، verify-pending) کی تلاش کرتا ہے اور ان سے بحال ہوتا ہے۔ یہ سسٹم `worktrail-check-provider-commands` بھی فراہم کرتا ہے تاکہ تصدیق کے بغیر CLI پارسرز کے خلاف تیار کردہ کمانڈز کی توثیق کی جا سکے۔