Adopt a repo membawa codebase ke 1DesignTool: aplikasi mendaftarkan proyek pada worktree milik aplikasi — branch 1design/<slug> di bawah direktori app-data Anda — sehingga agen mendesain di dalam UI nyata Anda tanpa pernah menulis ke checkout Anda. Inilah jembatan dari "desain sesuatu" ke "desain di dalam milik saya".

Mengadopsi satu

Dari home screen, Open folder… memilih repo dan membuka adopt sheet: ia membaca foldernya, menanyakan apakah akan mendesain di dalamnya, dan pada Design inside this codebase mendaftarkan proyeknya sebagai proyek codebase. Aplikasi membuat worktree — branch 1design/<slug> yang di-checkout di bawah app-data — dan proyek terbuka di atasnya, bukan di checkout Anda.

Adopt sheet — tunjuk ke repo, pilih isolasi worktree

Repo Anda tetap tak tersentuh: tulisan mendarat di worktree aplikasi, bacaan datang dari file nyata Anda lewatnya. Adopt sheet juga menampilkan catatan isolasi — apa itu worktree dan kenapa checkout Anda bukan working copy-nya.

Model worktree

Proyek codebase hidup di 1design/<slug> — branch yang dimiliki aplikasi, di-checkout sebagai worktree di bawah app-data:

Reads — agen melihat UI nyata Anda lewat worktree
Writes — diff turn mendarat di branch, tidak pernah di checkout Anda
Preview — pratinjau aplikasi atas worktree, atau dev server Anda sendiri
Checkout Anda — tidak pernah ditulisi; path yang dikelola host (.1design/, direktori skill) disembunyikan lewat .git/info/exclude, bukan .gitignore Anda

Branch bar di proyek menampilkan lajurnya — 1design/<slug> dari main, jumlah commit di depan, dan file yang diubah turn.

Branch bar — branch worktree, commit di depan, aksi review dan merge

Mendesain di dalam codebase

Setelah diadopsi, ia di-steer seperti proyek apa pun — tapi briefnya tentang UI Anda: "buat header sticky", "tambah layar settings di samping profile". Agen mengedit file nyata lewat worktree; pratinjau menampilkan app berjalan di dev server Anda sendiri atau pratinjau aplikasi.

Gate diff-scoped

Proyek codebase tidak menjalankan gate design kit penuh — repo Anda bukan artefak yang dihasilkan, jadi memeriksanya seperti artefak akan menandai kode yang tidak pernah disentuh turn. Alih-alih, pemeriksaannya diff-scoped: file yang diubah turn diverifikasi (tells.mjs pada diff), dan aksi review di branch bar menampilkan persis apa yang dilakukan turn.

Review dan merge

Saat pekerjaan sebuah turn terlihat benar, Review changes di branch bar menampilkan diff yang dihasilkan turn; Copy merge command atau Merge into main membawa pekerjaan branch kembali ke repo Anda. Discard membuang state worktree. main di checkout Anda yang di-merge — worktree adalah sandbox-nya.

Build dan Sketch mode

Proyek codebase membawa dua mode ekstra di atas live preview:

Build mode — edit UI app yang berjalan secara visual, dan perubahannya menulis kembali ke kode (lihat Build mode)
Sketch mode — sketsa .1d yang dipetakan ke komponen (lihat Sketch mode)

Direct mode

Model worktree adalah default karena ia yang aman — aplikasi menulis ke branch-nya sendiri di bawah app-data, tidak pernah ke checkout Anda. Direct mode — alternatif di adopt sheet — mengarahkan proyek ke checkout Anda sendiri; agen mengedit file nyata di tempatnya. Ia lebih cepat tapi pekerjaannya mendarat di working copy Anda, jadi default worktree ada karena suatu alasan.

Apa yang dikuasainya

Mendesain di dalam app nyata Anda — layar yang sudah ada, direstyling
Feature work — layar atau alur baru, di tempatnya
UI pass — pass visual seluruh-app, di-diff
Onboarding ke codebase — agen membaca repo yang harus ia huni

Catatan isolasi

Worktree ada supaya pekerjaan agen tidak bisa menyentuh checkout Anda sampai Anda merge — root proyek yang terdaftar adalah branch aplikasi, baca dan tulis lewatnya, dan file yang dikelola host yang dibutuhkan proyek disembunyikan lewat .git/info/exclude sehingga git status Anda tetap bersih. Biayanya satu langkah: saat pekerjaannya benar, Anda merge branch-nya.

Tip: Pertahankan worktree sampai merge-nya bersih — menghapus branch sebelum pekerjaan terkonfirmasi menghilangkan diff-nya. Tombol merge menjadikannya satu aksi; review sebelum mengkliknya.

Adopsi repo kode