Перейти до основного вмісту

Меню команд

Перейдіть на сторінку або пошукайте в каталозі

ШІ-інструменти та скрипти

Decision Trail: чому ваш проєкт такий, який він є, з доказами

Для розробників і керівників команд: дайте агенту журнал git, тікети, записи про рішення та протоколи зустрічей і отримайте датовану хронологію рішень проєкту, де кожна причина процитована з джерела або позначена як припущення чи невідома. خط زمني لقرارات مشروعك مع دليل كل قرار، بالإنجليزي أو بالعربي.

$15.00

Що ви отримаєте: 1 файл · 106.99 KB · ZIP

Переглянути варіанти купівлі

Опис товару

English

For developers and team leads who join a project and ask: why is it like this?

Give your agent the project's history: a git log, ticket exports, decision records, meeting notes. You get back a dated timeline of the decisions that shaped the project, each with its reason and the exact place in the sources that backs it.

What you get each run

  • timeline.html: one printable page. The events in date order, the decisions standing out, and the threads that connect them (for example "Where the data lives").
  • decisions.md: the same decisions as Markdown, for a wiki or an onboarding handbook.
  • decisions.json: each decision with what was decided, when, why, who, the alternatives, what it replaced and what was seen later.
  • events.json: every dated event, pointing at its exact place in the raw source.

Every reason is labelled

  • Stated: a word-for-word quote from a source, with the event it came from.
  • Inferred: the agent's own reading of the timing and the evidence, said plainly as a reading.
  • Unknown: no source gives a reason. It is carried as an open question for the team.

Evidence, checked by script

A bundled Python script (standard library, read-only, no network calls) builds the event list from the raw files. A checker then verifies every quote letter for letter against its source and every link between a decision and its events. The agent fixes and checks again until no FIX is left.

What it reads

A git log export (the agent runs git; the scripts never do), ticket exports as CSV or JSON (Jira, Linear, GitLab, GitHub issues), ADR or RFC Markdown files, meeting notes, and chat exports as text. Author email addresses are left out of the git export on purpose.

Honest about its limits

A trail holds only what was written down. History that never reached a commit, a ticket or a note is not in it, and the trail lists what the sources do not cover. The checker verifies evidence links, not whether the story is complete. Decisions are described without blame, and people appear only as the sources name them.

Ask it questions afterwards

"Why did we drop the PDF export?" The agent answers from the trail with the decision, its date and its events, and says so when the sources give no reason.

Arabic

The timeline and the decisions can be written in Arabic with a right-to-left page. Quotes stay in the language of their source, and hashes and file names stay as they are.

In the download: SKILL.md, the scripts, references (sources, the decisions format, reading history, Arabic notes), and a complete example so you can see the output before you buy: fourteen months of a fictional project (53 commits, 11 tickets, 3 decision records, meeting notes) and the English and Arabic trails made from it.

بالعربي

للمبرمجين وقادة الفرق الذين ينضمون إلى مشروع ويسألون: لماذا هو هكذا؟

أعطِ وكيلك تاريخ المشروع: سجل git، وتصدير التذاكر، وسجلات القرار، ومحاضر الاجتماعات. تستلم خطًا زمنيًا مؤرَّخًا للقرارات التي صنعت المشروع، وكل قرار معه سببه والموضع الدقيق في المصادر الذي يسنده.

ماذا تستلم في كل مرة

  • صفحة timeline.html: صفحة واحدة قابلة للطباعة فيها الأحداث بترتيب التاريخ، والقرارات بارزة، والخيوط التي تربط بينها.
  • ملف decisions.md: القرارات نفسها بصيغة Markdown، لويكي الفريق أو دليل المنضمين الجدد.
  • ملف decisions.json: كل قرار مع ما تقرر، ومتى، ولماذا، ومن، والبدائل، وما الذي حلّ محله، وما ظهر لاحقًا.
  • ملف events.json: كل حدث مؤرَّخ مع موضعه الدقيق في المصدر الخام.

كل سبب له وصف

  • مذكور: اقتباس حرفي من مصدر، مع الحدث الذي جاء منه.
  • مستنتج: قراءة الوكيل للتوقيت والأدلة، ومكتوب بوضوح أنها قراءة.
  • غير معروف: لا يذكر أي مصدر سببًا، فيبقى سؤالًا مفتوحًا للفريق.

أدلة يدققها سكربت

سكربت بايثون مرفق (يقرأ فقط، بلا اتصال بالشبكة) يبني قائمة الأحداث من الملفات الخام. ثم أداة فحص تطابق كل اقتباس حرفًا بحرف مع مصدره وكل رابط بين قرار وأحداثه. يصلح الوكيل ويعيد الفحص حتى لا يبقى أي FIX.

ماذا يقرأ

تصدير سجل git (الوكيل يشغّل git، والسكربتات لا تشغّله)، وتصدير التذاكر بصيغة CSV أو JSON، وملفات ADR أو RFC، ومحاضر الاجتماعات، وتصدير المحادثات كنص. وعناوين بريد المؤلفين تُترك خارج تصدير git عمدًا.

صادق في حدوده

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

اسأله بعد ذلك

«لماذا تخلّينا عن تصدير PDF؟» يجيب الوكيل من السجل بالقرار وتاريخه وأحداثه، ويقول ذلك صراحة إذا لم تذكر المصادر سببًا.

العربية

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

داخل الملف: ملف SKILL.md، والسكربتات، والمراجع، ومثال كامل لترى النتيجة قبل الشراء: أربعة عشر شهرًا من مشروع خيالي (53 إيداعًا، و11 تذكرة، و3 سجلات قرار، ومحاضر اجتماعات) والسجلان الإنجليزي والعربي المصنوعان منه.

Questions / أسئلة

What does it need from me? / ماذا يحتاج مني؟

Text exports of the project's history: a git log (the agent exports it), tickets as CSV or JSON, ADR files, meeting notes, chat exports. Take what exists; it works with only some of them. تصدير نصي لتاريخ المشروع، ويعمل بما هو موجود منه.

Does it make up reasons? / هل يخترع أسبابًا؟

No. A stated reason is a word-for-word quote that the checker verifies against the source. A reading is labelled inferred, and a missing reason is labelled unknown. لا، السبب المذكور اقتباس حرفي تتحقق منه أداة الفحص.

Does it connect to Jira, GitHub or Slack? / هل يتصل بـ Jira أو GitHub أو Slack؟

No. The scripts read files and make no network calls. You export the tickets or chats yourself and put them in the sources folder. لا، يقرأ ملفات تصدّرها أنت.

Will it blame people? / هل يلوم أشخاصًا؟

No. Decisions are described, not people's competence, and people appear only as the sources name them. Author email addresses are left out of the git export. لا، يصف القرارات لا الأشخاص.

Is the trail the full story? / هل السجل هو القصة الكاملة؟

No, and it never says so. It holds what was written down and lists what the sources do not cover. لا، يحمل ما كُتب فقط ويذكر ما لا تغطيه المصادر.

Can I update it later? / هل أحدّثه لاحقًا؟

Yes. Add a new export or a dated note and build again; event ids are kept, so existing citations still point at the right place. نعم، أضف مصدرًا جديدًا وأعد البناء.

Can it be in Arabic? / هل يكون بالعربي؟

Yes, as an added option: an Arabic timeline with a right-to-left page. Quotes stay in the language of their source. نعم، والاقتباسات تبقى بلغة مصدرها.

Що ви отримаєте

1 файл · 106.99 KB

  • decision-trail-1.0.0.zipZIP · 106.99 KB
ЛіцензіяКомерційне використання дозволено
Перевірка пакетаПройдено

Getly відкрив завантажені файли й не знайшов нічого, що завадило б їх відкрити. Це не антивірусна перевірка і не оцінка якості.

Опубліковано13 лист. 2026 р.
Розмір файлу106.99 KB
Формат файлуZIP
Версіяv1.0

Теги

project historydecision logadronboardingtimelinegit historydocumentationarabicai agent skill
R
RR HH

Поширені запитання

Чи отримаю я доступ одразу?

Так. Це цифровий товар: ви можете завантажити його одразу після оплати, просто зі своєї бібліотеки.

Чи можна використовувати його в комерційних проєктах?

Так. Комерційне використання дозволено: користуйтеся в особистому бізнесі та в тому, що продаєте. Ви не можете перепродавати чи поширювати сам файл.

Яка у вас політика повернення коштів?

Ви можете запросити повернення коштів протягом 30 дн. Якщо щось не так, подайте запит зі свого замовлення, і команда Getly його розгляне.

Які формати та розміри файлів я отримаю?

Ви завантажите 1 файл - ZIP - загалом 106.99 KB.

Чи отримую я безкоштовні оновлення?

Так: коли продавець випускає нову версію, ви можете повторно завантажити свіжі файли зі своєї бібліотеки безкоштовно. Останні оновлення дивіться в журналі змін.

Ціна

$15.00