صفحه ۱۸ از ۴۹، پروژه‌های عملی
پروژه 02. خوانا کردن پروژه برای ایجنت و از سرگیری کار از جایی که رها شده بود
درس‌های مرتبط: درس 03. تبدیل مخزن به یگانه منبع حقیقت · درس 04. تقسیم دستورالعمل‌ها میان چند فایل فایل‌های الگو: templates/
کاری که انجام می‌دهید#
قابلیت «خوانایی» را به مخزن بیفزایید تا یک ایجنت جدید بتواند به سرعت ساختار پروژه را درک کند، از پیشرفت فعلی مطلع شود و کار را از سر بگیرد. به طور مشخص: پیاده‌سازی وارد کردن سند، نمای جزئیات سند، و ماندگارسازی محلی که در طول دو نشست تکمیل می‌شوند.
شما آن را دو بار از روی دایرکتوری‌های موجود در مخزن اجرا می‌کنید: بار اول با فضای کاری مقدماتی‌تر starter/ و بدون session-handoff.md، بار دوم در برابر ساختار solution/ که دارای ARCHITECTURE.md، PRODUCT.md و session-handoff.md گسترش‌یافته است.
ابزارها#
- Claude Code یا Codex
- Git
- Node.js + Electron
سازوکار هارنس#
فضای کاری خوانا برای ایجنت + فایل‌های وضعیت ماندگار
استفاده از پروژه‌های موجود در مخزن#
مسیر مخزن: projects/project-02/
| دایرکتوری | شامل چه مواردی است | آنچه باید مقایسه شود |
|---|---|---|
starter/ |
کد پروژه 01 به همراه وارد کردن سند، نمای جزئیات و ماندگارسازی ناقص. مستندات وجود دارند اما عمداً مختصرتر هستند، و هیچ session-handoff.md وجود ندارد. |
میزان بازکشف و تکرار کاوشی که نشست دوم ایجنت انجام می‌دهد. |
solution/ |
همان برش تکمیل‌شده، با مستندات گسترش‌یافته تحت projects/project-02/solution/ (به همراه feature_list.json و session-handoff.md). |
اینکه آیا یک نشست تازه می‌تواند بدون زمینه شفاهی کار را از وضعیت مخزن از سر بگیرد. |
ویژگی‌های محصول عبارتند از وارد کردن سند، بارگذاری کامل محتوا/جزئیات سند، و ماندگارسازی در طول راه‌اندازی مجدد. ویژگی هارنس همان فضای کاری خوانا برای تحویل کار است.