นำ repo เข้าใช้นำ codebase เข้า 1DesignTool: แอปลงทะเบียนโปรเจกต์บน worktree ที่แอปเป็นเจ้าของ — branch 1design/<slug> ใต้ไดเรกทอรี app-data — ดังนั้น agent ออกแบบใน UI จริงของคุณโดยไม่เขียนลง checkout ของคุณ มันคือสะพาน จาก "ออกแบบของชิ้นหนึ่ง" เป็น "ออกแบบในของของฉัน"

การนำเข้าใช้

จากหน้าจอหลัก Open folder… เลือก repo และเปิดชีต adopt: มันอ่านโฟลเดอร์ ถามว่าจะออกแบบข้างในไหม และเมื่อ Design inside this codebase ลงทะเบียน โปรเจกต์เป็นโปรเจกต์ codebase แอปสร้าง worktree — branch 1design/<slug> ที่ checkout ใต้ app-data — และโปรเจกต์เปิดบนนั้น ไม่ใช่ checkout ของคุณ

ชีต adopt — ชี้ที่ repo เลือกการแยก worktree

Repo ของคุณอยู่เหมือนเดิม: การเขียนลงใน worktree ของแอป การอ่านมาจากไฟล์จริง ของคุณผ่านมัน ชีต adopt ยังแสดงบันทึกการแยก — worktree คืออะไรและทำไม checkout ของคุณไม่ใช่สำเนาทำงาน

โมเดล worktree

โปรเจกต์ codebase อยู่บน 1design/<slug> — branch ที่แอปเป็นเจ้าของ checkout เป็น worktree ใต้ app-data:

อ่าน — agent เห็น UI จริงของคุณผ่าน worktree
เขียน — diff ของเทิร์นลงบน branch ไม่ใช่ checkout ของคุณ
ตัวอย่าง — ตัวอย่างของแอปจาก worktree หรือ dev server ของคุณเอง
Checkout ของคุณ — ไม่เคยเขียนลง; path ที่ host จัดการ (.1design/, ไดเรกทอรี skill) ซ่อนผ่าน .git/info/exclude ไม่ใช่ .gitignore ของคุณ

แถบ branch บนโปรเจกต์แสดงเลน — 1design/<slug> จาก main จำนวน commit ที่นำ และไฟล์ที่เทิร์นเปลี่ยน

แถบ branch — branch worktree commit ที่นำ การกระทำ review และ merge

การออกแบบใน codebase

เมื่อนำเข้าแล้ว มัน steer เหมือนโปรเจกต์อื่น — แต่บรีฟเป็นเรื่อง UI ของคุณ: "ทำให้ header ติดด้านบน" "เพิ่มหน้าจอ settings ข้าง profile" agent แก้ไฟล์จริง ผ่าน worktree; ตัวอย่างแสดงแอปที่รันบน dev server ของคุณเองหรือตัวอย่างของแอป

เกตแบบจำกัด diff

โปรเจกต์ codebase ไม่รันเกต design-kit เต็ม — repo ของคุณไม่ใช่ผลิตภัณฑ์ที่ สร้างขึ้น การตรวจมันเหมือนอย่างนั้นจะฟลักโค้ดที่เทิร์นไม่เคยแตะ แทนที่การตรวจ เป็นจำกัด diff: ไฟล์ที่เทิร์นเปลี่ยนถูกยืนยัน (tells.mjs บน diff) และ การกระทำ review ของแถบ branch แสดงเป๊ะว่าเทิร์นทำอะไร

Review และ merge

เมื่องานเทิร์นดูถูก Review changes ของแถบ branch แสดง diff ที่เทิร์นผลิต; Copy merge command หรือ Merge into main นำงานของ branch กลับ repo ของคุณ Discard ทิ้งสถานะ worktree main ของ checkout ของคุณคือสิ่งที่ merge — worktree คือ sandbox

Build และ Sketch mode

โปรเจกต์ codebase พกสอง mode เสริมเหนือตัวอย่างสด:

Build mode — แก้ UI ของแอปที่รันแบบภาพ และการเปลี่ยนเขียนกลับลงโค้ด (ดู Build mode)
Sketch mode — sketch .1d ที่แปลเป็น component (ดู Sketch mode)

Direct mode

โมเดล worktree เป็นค่าเริ่มต้นเพราะมันปลอดภัย — แอปเขียนลง branch ของมันเอง ใต้ app-data ไม่ใช่ checkout ของคุณ Direct mode — ทางเลือกบนชีต adopt — ชี้โปรเจกต์ที่ checkout ของคุณเอง; agent แก้ไฟล์จริงในที่ มันเร็วกว่าแต่งาน ลงบนสำเนาทำงานของคุณ ค่าเริ่มต้น worktree จึงมีเหตุผล

มันถนัดอะไร

ออกแบบในแอปจริงของคุณ — หน้าจอที่มีอยู่แล้ว แต่งสไตล์ใหม่
งานฟีเจอร์ — หน้าจอหรือ flow ใหม่ ในที่
ผ่าน UI — การผ่านภาพทั้งแอป แยก diff
เข้า codebase — agent อ่าน repo ที่มันต้องอยู่

บันทึกการแยก

worktree มีอยู่เพื่องานของ agent แตะ checkout ของคุณไม่ได้จนกว่าคุณจะ merge — รูทโปรเจกต์ที่ลงทะเบียนคือ branch ของแอป การอ่านและเขียนผ่านมัน และไฟล์ที่ host จัดการที่โปรเจกต์ต้องการซ่อนผ่าน .git/info/exclude เพื่อ git status ของคุณ สะอาด ราคาคือหนึ่งขั้น: เมื่องานถูก คุณ merge branch

Tip: เก็บ worktree จน merge สะอาด — ลบ branch ก่อนงานยืนยันเสีย diff ปุ่ม merge ทำให้เป็นหนึ่งการกระทำ; review ก่อนคลิก

นำ repo เข้ามาใช้