Cara Menyediakan Spec Kit dalam Claude Code pada 2026: Spesifikasi Menggantikan Arahan

Apakah yang berlaku kepada pengekodan vibe pada Mei 2026?#

Setahun kemudian, pada 4 Februari 2026, beliau menerbitkan bebenang retrospektif:

Dalam ucapannya di Sequoia Ascent 2026, beliau menyatakannya dengan lebih tepat: “Pengekodan vibe meningkatkan tahap minimum—sejauh mana semua orang boleh melakukan sesuatu dalam perisian. Kejuruteraan agentik mengekalkan tahap maksimum—piawaian kualiti pembangunan profesional.” Di pentas yang sama, beliau mengungkapkan kata-kata yang menjadi sebahagian daripada leksikon industri: “Anda tidak boleh menyebabkan kerentanan atas alasan pengekodan vibe. Anda tetap bertanggungjawab terhadap perisian anda, seperti sebelum ini.”

Dua perkara berlaku serentak. Pada September 2025, GitHub menerbitkan alat Spec Kit—alat itu mengumpulkan 107,000 bintang dalam 8 bulan. Pada Februari 2026, AWS menerbitkan kajian kes terperinci tentang penemuan ubat yang melaporkan “95% logik perniagaan dijana daripada spesifikasi, menjimatkan lebih 80 jam.”

Menjelang akhir Mei 2026, kata sepakat telah terbentuk dalam ruang maklumat berbahasa Inggeris: pengekodan vibe sebagai kaedah kerja ialah tahap pemula. Pembangunan Berpandukan Spesifikasi datang selepas itu. Panduan ini menerangkan cara memasang dan menggunakan pendekatan tersebut.

Apakah Spec Kit dan Pembangunan Berpandukan Spesifikasi?#

Idea teras metodologi ini dirumuskan dalam satu ayat daripada dokumentasi rasmi GitHub:

Dalam amalan, proses ini berlangsung dalam 4 fasa (Spec Kit menambah satu lagi, iaitu fasa sifar—perlembagaan, yang diterangkan di bawah):

1. Specify - tulis spesifikasi tentang perkara yang anda mahukan dalam bahasa semula jadi. APA yang perlu dilakukan dan MENGAPA. Bukan BAGAIMANA.
2. Plan - ejen mengambil spesifikasi itu dan menyediakan pelan teknikal: teknologi yang digunakan, seni bina dan komponen.
3. Tasks - ejen memecahkan pelan itu kepada tugas khusus yang boleh disahkan, berserta kebergantungan.
4. Implement - ejen (atau subejennya) melaksanakan tugas dan menulis kod.

Selepas Implement, versi Spec Kit semasa mempunyai langkah pengesahan bernama Converge: ejen menyemak kod yang telah siap berdasarkan spesifikasi, pelan dan tugas, kemudian menambah apa-apa yang tertinggal ke dalam tasks.md. Jalankan Implement dan Converge berulang kali sehingga Converge memberikan respons “Converged.”

Setiap fasa ialah fail markdown yang berasingan dalam repo. Setiap fasa ialah arahan slash yang berasingan dalam Claude Code: /speckit-specify, /speckit-plan, /speckit-tasks, /speckit-implement, manakala semakannya ialah /speckit-converge. Dokumentasi Spec Kit menulis arahan yang sama dengan titik (/speckit.specify), tetapi dalam Claude Code, Spec Kit memasangnya sebagai skills, dan arahan itu dipanggil menggunakan tanda sempang. Jika berlaku masalah pada mana-mana langkah, edit fail markdown dan jalankan semula fasa seterusnya.

Spec Kit ialah pelaksanaan khusus SDD. Pada Mei 2026, ia sudah mempunyai lebih 30 penyepaduan dengan pelbagai ejen AI. Dalam satu repo, Spec Kit berfungsi dengan cara yang sama menggunakan Claude Code, Cursor, GitHub Copilot, Codex CLI, Windsurf, Qwen, Tabnine, Amazon Q, Gemini, Goose dan sedozen lagi.

Jadi, selepas satu kitaran, repo anda mengandungi bukan sahaja kod, tetapi juga spesifikasi, pelan dan tugasnya. Sebulan kemudian, anda boleh kembali kepada projek itu, membaca spec.md dan memahami perkara yang telah dilakukan serta sebabnya. Ini bukan lagi “pengekodan vibe yang melupakan kewujudan kod”—ini ialah ingatan kerja projek.

Mengapa pengekod vibe yang tidak menulis kod memerlukan ini?#

Spec Kit memformalkan perancangan merentas langkah berasingan dengan 4 arahan slash. Logiknya: asingkan “memikirkannya dengan teliti” daripada “melaksanakannya” supaya kedua-duanya berlaku dalam tetingkap konteks yang berlainan. Setiap peringkat mendapat konteks bersih yang belum dipenuhi kandungan daripada fasa sebelumnya.

Tiga manfaat konkrit untuk pengekod vibe:

• Kebolehramalan. Apabila anda memberitahu ejen “buat borang pendaftaran dengan pengesahan e-mel,” ejen itu meneka 10 butiran sendiri—dan tiga daripadanya berbeza daripada apa yang anda maksudkan. Apabila anda mempunyai spec.md yang mengandungi User Stories, Acceptance Scenarios dan penanda [NEEDS CLARIFICATION] pada setiap perkara yang tidak pasti, tiada apa yang perlu diteka.
• Ingatan projek. Sebulan kemudian, anda tidak akan ingat perkara yang dibincangkan dengan ejen dalam sembang. Tetapi spec.md, plan.md dan tasks.md ada dalam repo, dalam folder specs/###-feature/ bersama kod. Fail-fail itu menunjukkan bukan sahaja perkara yang dilakukan, tetapi juga sebabnya.
• Skala. Untuk ciri yang melibatkan 1-2 fail, perbezaannya hampir tidak ketara. Bagi ciri yang melibatkan 20 fail dan 5 entiti data, perbezaannya ialah antara “menulis semula semuanya selepas 4 jam” dengan “semuanya sudah masuk ke cabang utama selepas 4 jam.” AWS Kiro menunjukkan automasi 95% logik perniagaan daripada spesifikasi dalam projek TargetID.

Ilusi utama pengekodan vibe ialah ia kelihatan lebih pantas pada awalnya. Setengah jam, dan prototaip sudah ada. Tetapi menjelang minggu pertama, prototaip itu rosak, lalu membuangnya menjadi pilihan lebih mudah. Pembangunan Berpandukan Spesifikasi mengambil sedikit masa tambahan pada awalnya (sejam berbanding setengah jam), tetapi seminggu kemudian anda masih bekerja dalam repo yang sama.

Cara memasang Spec Kit dalam Claude Code (4 langkah)#

Langkah 1. Pasang uv. Anda hanya perlu melakukannya sekali; uv akan kekal pada sistem anda.

# macOS / Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# Windows
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Semak sama ada uv telah dipasang:

uv --version

Langkah 2. Pasang Spec Kit. Satu arahan:

uv tool install specify-cli --from git+https://github.com/github/spec-kit.git

Semak:

specify --version

Langkah 3. Mulakan repo. Pergi ke folder projek anda (atau cipta folder baharu) dan jalankan:

specify init --here --integration claude

Bendera --integration claude memilih Claude Code secara langsung. Tanpanya, Spec Kit meminta anda memilih ejen daripada senarai interaktif, dan mungkin juga meminta jenis skrip (untuk macOS dan Linux, biarkannya sebagai sh). Jika folder itu tidak kosong, Spec Kit akan memberi amaran bahawa failnya akan digabungkan dengan fail anda: komit kerja anda dahulu, kemudian jalankan semula arahan dengan bendera --force.

Selepas itu, kandungan berikut akan muncul dalam repo:

.specify/
  memory/
    constitution.md        # peraturan projek, diisi oleh /speckit-constitution
  scripts/
  templates/
    spec-template.md
    plan-template.md
    tasks-template.md
.claude/
  skills/
    speckit-constitution/SKILL.md
    speckit-specify/SKILL.md
    speckit-clarify/SKILL.md
    speckit-plan/SKILL.md
    speckit-checklist/SKILL.md
    speckit-tasks/SKILL.md
    speckit-analyze/SKILL.md
    speckit-implement/SKILL.md
    speckit-converge/SKILL.md
    speckit-taskstoissues/SKILL.md

Langkah 4. Buka Claude Code dan semak arahan slash. Jalankan ini dalam folder yang sama:

claude

Dalam sesi itu, taip /speckit—arahan speckit-* sepatutnya muncul dalam cadangan. Jika tidak, mulakan semula Claude Code supaya ia membaca semula .claude/skills/. Jika anda sudah mempunyai CLAUDE.md di akar projek, Spec Kit tidak mengubahnya—ia berfungsi bersama fail itu, dalam .specify/memory/constitution.md.

Spec Kit juga berfungsi tanpa Claude Code (ia menyokong lebih 30 ejen), tetapi panduan ini khusus tentang persediaan dengan Claude. Jika anda mahu memasang dua alat sekali gus, lihat panduan berasingan tentang menyediakan CLAUDE.md dan Plan Mode dalam Claude Code.

Spec Kit ialah blok binaan pertama dalam “kontrak pekerjaan ejen.” Persediaan lengkap mengandungi ketiga-tiga komponen: klon AI (metodologi anda dalam bentuk Skills dan subagen), Second Brain (struktur business/ yang dirujuk ejen setiap kali), dan kejuruteraan konteks (Spec Kit, Plan Mode, /compact). Inilah tiga tonggak yang tanpanya AI berhalusinasi.

Cara menulis spesifikasi pertama anda (Specify)#

Dalam Claude Code, taip:

/speckit-specify

Kemudian ejen akan meminta penerangan tentang ciri tersebut. Pada langkah ini, gunakan bahasa biasa tanpa jargon teknikal:

I want a registration form in my app. The user enters an email
and password, receives a confirmation email, and after confirming
lands on the dashboard. Confirmation expires after 48 hours. If the
email is still unconfirmed, delete the account within 5 minutes after
that deadline; never delete a confirmed account.

Dalam contoh ilustrasi ini, toleransi pemadaman dijelaskan sebagai 5 minit selepas tarikh akhir 48 jam. Untuk produk sebenar, sahkan toleransi sebelum Plan; tarikh akhir tepat 48 jam memerlukan reka bentuk dan ujian yang menguatkuasakan syarat lebih kuat itu. Ejen akan menyediakan specs/001-registration/spec.md. Buka fail dan lihat struktur seperti ini:

# Feature Specification: User Registration

**Feature Branch**: `001-registration`
**Created**: 2026-05-31
**Status**: Draft
**Input**: User Description: "I want a registration form..."

## User Scenarios & Testing *(mandatory)*

### Primary User Story
As a new user, I want to register an account with email confirmation,
so that I can access the dashboard with a verified identity.

### Acceptance Scenarios
1. **Given** I am on the registration page,
   **When** I submit valid email and password,
   **Then** I receive a confirmation email within 1 minute.
2. **Given** I clicked the confirmation link within 48 hours,
   **When** I land on the dashboard,
   **Then** I see my email confirmed in profile.
3. **Given** I have not confirmed at the 48-hour deadline,
   **When** cleanup runs within the next 5 minutes,
   **Then** my account is deleted and email is freed for re-registration.
4. **Given** my account is just under 48 hours old or already confirmed,
   **When** cleanup runs,
   **Then** the account is not deleted.

## Requirements *(mandatory)*

### Functional Requirements
- **FR-001**: System MUST accept registration via [NEEDS CLARIFICATION:
  email/password only, or also SSO/OAuth?]
- **FR-002**: System MUST send confirmation email within 60 seconds
- **FR-003**: Confirmation MUST expire at 48 hours; the system MUST
  delete still-unconfirmed accounts no later than 5 minutes after that
  deadline and MUST NOT delete confirmed accounts
- **FR-004**: System MUST log all registration attempts for [NEEDS
  CLARIFICATION: how long do we retain logs - 30 days, 90 days, forever?]

### Key Entities
- User: email, password_hash, email_verified_at, created_at, deleted_at
- ConfirmationToken: token, user_id, expires_at, used_at

## Success Criteria *(mandatory)*
- **SC-001**: 95% of confirmation emails delivered within 60 seconds (p95)
- **SC-002**: 0 accidental deletions of confirmed accounts
- **SC-004**: No deletion before 48 hours; every eligible unconfirmed
  account is deleted by age 48 hours 5 minutes under the tested workload
- **SC-003**: Registration completion rate > 60% (from form open to dashboard)

Berikan perhatian kepada penanda [NEEDS CLARIFICATION: ...]. Spec Kit sengaja memasukkannya pada mana-mana bahagian yang tidak mendapat jawapan jelas daripada teks anda. Sebelum beralih ke fasa Plan, anda mesti menjawabnya sendiri dalam spec.md atau jalankan /speckit-clarify, kemudian ejen akan menyemak perkara yang tidak jelas dan mengemukakan soalan dalam dialog.

Dalam Spec Kit, arahan terbina dalam /speckit-clarify menggantikan permintaan lisan “tanya saya soalan.” Kesannya sama: anda tidak beralih kepada Plan sehingga tiada lagi penanda [NEEDS CLARIFICATION] dalam spec.md.

Tidak sepatutnya ada teknologi dalam spec.md. Jangan sebut React, Postgres, Prisma atau Redis. Spesifikasi menerangkan perkara yang dilakukan oleh sistem dari perspektif pengguna dan perniagaan. Timbunan teknologi datang pada fasa seterusnya.

Apakah yang dilakukan Claude dalam fasa Plan?#

Apabila spec.md sudah sedia, jalankan:

/speckit-plan

Jika mahu, sertakan petunjuk teknologi terus dalam arahan:

/speckit-plan Next.js App Router, Prisma, PostgreSQL, Resend for email

Claude membaca tiga sumber: spec.md, CLAUDE.md anda (atau memory/constitution.md), dan kod sedia ada dalam repo. Hasilnya ialah plan.md dengan struktur lebih kurang seperti ini:

# Implementation Plan: User Registration

## Technical Context
- Framework: Next.js 14 App Router
- Database: PostgreSQL via Prisma
- Email: Resend (single transport)
- Validation: Zod schema in shared lib
- Auth: NextAuth.js with credentials provider

## Architecture Decisions

### 1. Token storage
Tokens stored in DB (table ConfirmationToken), not in JWT.
Reason: need server-side revoke on email re-register.

### 2. Email delivery
Async via cron `/api/cron/send-confirmation` triggered immediately
after registration. Retries handled by Resend.

### 3. Auto-delete cron
Run `/api/cron/cleanup-unconfirmed` every minute. Delete rows only where
created_at <= NOW() - INTERVAL '48 hours' AND email_verified_at IS NULL.
The clarified example allows at most 5 minutes of deletion delay.
Verify scheduler lag and completion time against that bound; report
a missed bound as a failure, not a successful daily cleanup.

## Data Model
See data-model.md

## API Contracts
See contracts/
- POST /api/auth/register
- POST /api/auth/confirm
- GET /api/auth/resend-confirmation

## Implementation Phases
1. Database migration (Prisma schema + migration file)
2. API routes (3 endpoints)
3. UI: registration form + confirmation success page
4. Cron jobs (send + cleanup)
5. Email template
6. Integration tests

data-model.md menerangkan entiti dan hubungannya. contracts/ mengandungi rangka kontrak API (sama ada YAML OpenAPI atau jenis permintaan/respons TypeScript). Ini bukan kod—ini ialah niat yang kemudiannya akan ditukarkan Claude menjadi laluan sebenar.

Kelebihan utama fasa Plan ialah konteks yang bersih. Claude tidak cuba mengingati spesifikasi dan pelaksanaan serentak. Ia memikirkan semuanya dahulu, merekodkan keputusan dalam fail, kemudian meneruskan kerja.

Seterusnya, terdapat arahan pilihan /speckit-analyze. Arahan ini dijalankan selepas fasa Tasks dan sebelum Implement: ia menyemak set spec.md + plan.md + tasks.md untuk mencari percanggahan dan memastikan semua keperluan spesifikasi diliputi oleh pelan dan tugas. Arahan ini tidak menyunting fail; ia hanya menghasilkan laporan. Pada asasnya, ini ialah semakan kewarasan rasmi sebelum pelaksanaan.

Cara memecahkan kerja kepada tugas (Tasks)#

Setelah anda mempunyai spec.md dan plan.md, jalankan:

/speckit-tasks

Claude mengembangkan pelan itu menjadi tasks.md:

# Tasks: User Registration

## Phase 1: Database (no dependencies)
- [ ] T-001: Add User model to prisma/schema.prisma (parallel-safe)
- [ ] T-002: Add ConfirmationToken model to prisma/schema.prisma (after T-001)
- [ ] T-003: Generate migration `add-user-registration` (after T-002)

## Phase 2: API contracts (no dependencies)
- [ ] T-004: Create Zod schemas in shared/validation/auth.ts
- [ ] T-005: Define TypeScript types in shared/types/auth.ts (after T-004)

## Phase 3: Routes (depends on Phase 1+2)
- [ ] T-006: Implement POST /api/auth/register
- [ ] T-007: Implement POST /api/auth/confirm
- [ ] T-008: Implement GET /api/auth/resend-confirmation

## Phase 4: UI (parallel with Phase 3)
- [ ] T-009: Build /register page with form
- [ ] T-010: Build /register/confirm/[token] page
- [ ] T-011: Build /register/success page

## Phase 5: Cron + integration (depends on Phase 3+4)
- [ ] T-012: Cron /api/cron/send-confirmation
- [ ] T-013: Cron /api/cron/cleanup-unconfirmed
- [ ] T-014: Email template registration-confirmation.tsx
- [ ] T-015: Integration tests (Playwright), including cleanup just
  before 48h, exactly at 48h, deletion by 48h 5m, delayed-job failure,
  and protection of confirmed accounts

## Notes
- T-001, T-004, T-009-T-011 are parallel-safe (different files)
- T-002 conflicts with T-001 (same file: schema.prisma) - run sequentially
- T-006 needs T-003 (migration applied) and T-005 (types)

Perhatikan penanda parallel-safe dan after T-NNN. Itulah graf kebergantungan yang kemudiannya membolehkan anda menjalankan beberapa fasa secara selari. Seluruh pendekatan pecutan Spec Kit bergantung pada mekanisme ini: sesetengah tugas boleh diserahkan kepada lima sesi Claude Code berbeza pada masa yang sama, manakala tugas lain mesti dilaksanakan mengikut turutan.

Spec Kit melakukan semua ini secara automatik dengan satu arahan sahaja, terus daripada awal.

Arahan pilihan /speckit-taskstoissues mengambil tasks.md dan mencipta GitHub Issues daripada senarai itu, setiap satunya dengan pautan kembali ke spec.md. Ini berguna jika anda bekerja dalam pasukan atau mahu menjejak kemajuan melalui GitHub Projects.

Cara melaksanakan dengan subejen (Implement)#

/speckit-implement

Claude bermula dengan tugas pertama dalam tasks.md. Setiap tugas melalui kitaran ringkas: membaca fail berkaitan, menulis diff, menjalankan ujian dan menandakan [x]. Subejen dipanggil secara automatik apabila perlu: satu untuk semakan kod, satu lagi untuk menjalankan linter, dan satu lagi untuk menyemak regresi.

Dan secara berasingan, tentang peraturan:

Dalam Spec Kit, kitaran ini diformalkan. Anda mempunyai spec.md sebagai sumber kebenaran, plan.md untuk keputusan teknikal, dan tasks.md sebagai senarai semak. Jika Claude tersasar pada mana-mana langkah, anda kembali kepada spesifikasi dan berkata, “Itu tidak selaras dengan FR-003; buat semula.” Tiada arahan panjang yang mengatakan “ingat perkara yang kita bincangkan...” — seluruh sejarah ada dalam fail.

Jika anda telah menghubungkan Aliran Kerja Dinamik dalam Opus 4.8, anda boleh meletakkan Spec Kit dalam mod automasi penuh: satu arahan /speckit-implement sahaja dan Claude menjalankan kerja secara selari, menyatukan hasil dan menyemaknya. Hadnya ialah 1000 subejen pada satu masa. Bagi kebanyakan ciri, 10-30 sudah memadai.

Apabila semua kotak [x] ditandakan dan semakan di bahagian seterusnya memberikan respons “Converged,” anda menyemak PR (atau beberapa PR jika terdapat banyak tugas) lalu menggabungkannya. Artifak—spec.md, plan.md, tasks.md—kekal dalam repo sebagai dokumentasi ciri itu. Setahun kemudian, anda tidak perlu membuat kejuruteraan songsang untuk memahami logiknya daripada kod.

Cara menyemak sama ada ejen tertinggal sesuatu (Converge)#

/speckit-converge

Mula-mula ejen memberikan ringkasan penemuannya berserta tahap keterukan, kemudian salah satu daripada dua hasil. “Converged” bermaksud tiada perkara tertinggal, tasks.md kekal sama bait demi bait, dan anda boleh meneruskan semakan. “Tasks appended” bermaksud perkara yang tertinggal telah ditemui dan ditambah ke bahagian Convergence dalam tasks.md, lalu ejen memberitahu jumlahnya.

Converge tidak menyunting atau memadam kod; satu-satunya penulisannya ialah tugas baharu dalam tasks.md. Jadi, anda boleh menjalankannya tanpa bimbang, tetapi hanya selepas /speckit-implement selesai melaksanakan kandungan tasks.md semasa. Setiap pusingan berikutnya menemui semakin sedikit perkara yang tertinggal.

Apakah perbezaan Spec Kit berbanding CLAUDE.md dan Plan Mode?#

Bandingkan ketiga-tiganya berdasarkan 5 ciri:

Dalam istilah Spec Kit, fail ini ialah .specify/memory/constitution.md. Semasa pemulaan, Spec Kit boleh menggunakan CLAUDE.md sedia ada sebagai asas perlembagaan atau mencipta fail berasingan di sebelahnya. Saya biasanya mengekalkan CLAUDE.md sebagai “kontrak” global (timbunan teknologi, glosari, protokol pelancaran), dan menggunakan perlembagaan Spec Kit untuk peraturan khusus ciri—contohnya, “semua borang disahkan melalui Zod; tiada pemeriksaan manual.”

Hubungan dengan Plan Mode lebih mudah. Plan Mode ialah mod pantas “merancang sebelum menulis kod” dalam satu sesi. Mod ini sesuai untuk perubahan kecil (membaiki pepijat, memfaktor semula fungsi). Untuk ciri besar, Plan Mode kurang sesuai kerana tetingkap konteks dalam satu sesi terlalu kecil untuk pelan 3000 baris—seperti yang saya terangkan secara langsung dalam sesi itu:

Spec Kit ialah alat kejuruteraan konteks yang konkrit. Ia memindahkan “hamparan seni bina” daripada sembang ke dalam fail. Spec.md kekal dalam repo dan setiap sesi Claude baharu membacanya semula—anda tidak perlu mengulang perkara yang sama.

Persediaan untuk projek besar:

1. CLAUDE.md - timbunan teknologi, glosari, perkara yang tidak boleh dilakukan. Fail ini berada di akar.
2. .specify/memory/constitution.md untuk Spec Kit—peraturan khusus bagi aliran kerja ini.
3. specs/001-feature-A/spec.md, plan.md, tasks.md - ciri pertama.
4. specs/002-feature-B/spec.md, plan.md, tasks.md - ciri kedua.
5. Untuk kerja harian, gunakan sama ada /speckit-implement (untuk tugas sedia ada) atau /plan (semakan pantas sebelum perubahan).

Kes dunia sebenar yang manakah berjaya?#

Kes khusus:

• AWS Kiro - ejen penemuan ubat. Dalam catatan blog AWS Industries bertarikh 18 Februari 2026, pasukan itu menerangkan projek TargetID. Tiga pembangun, tiga minggu, satu ejen penemuan ubat. Angka dalam artikel: Kiro menjana lebih 95% kod logik perniagaan, menjimatkan lebih 80 jam pembangunan. Selain itu: “Dokumentasi README yang ditulis Kiro menjimatkan anggaran 8 jam” dan “40% lebih sedikit kitaran arahan pembaikan berulang.”
• Rackspace Technology. Dalam catatan blog AWS yang sama, Rackspace melaporkan: “menyelesaikan kerja yang dianggarkan mengambil masa 52 minggu hanya dalam 3 minggu,” “peningkatan kecekapan sebanyak 90%.” Ini bukan lagi ciri kecil—ini projek perusahaan sepenuhnya.
• Pertumbuhan GitHub Spec Kit. Pada 7 Mei 2026, repo itu mempunyai 93,000 bintang; menjelang 31 Mei, jumlahnya mencapai 107,000. Itu bersamaan +14,000 bintang dalam tiga minggu. Kadar pertumbuhan ini jelas menunjukkan pendekatan tersebut semakin menguasai bahagian pasaran.

Bagi pembaca, ini bermakna pendekatan tersebut bukan teori: pasukan yang serius sudah menggunakannya dalam pengeluaran.

Bilakah Spec Kit TIDAK sesuai?#

Tidak sesuai #1 - suntingan kecil. Jika tugasnya “menamakan semula pemboleh ubah,” “membaiki kesilapan taip dalam teks,” atau “menambah log,” melalui Specify → Plan → Tasks akan mengambil masa lebih lama daripada suntingan itu sendiri. Untuk suntingan kecil, Plan Mode atau arahan langsung dalam Claude Code lebih pantas.

Tidak sesuai #2 - eksperimen langsung. Apabila anda belum tahu apa yang diingini dan perlu “meneroka” antara muka atau memasang prototaip dengan cepat untuk melihat “sama ada ia menjadi,” spesifikasi tidak berguna. Nilainya terletak pada hakikat bahawa anda sedang berimprovisasi. Pada tahap “mencuba sesuatu idea,” pengekodan vibe memang pendekatan yang berkesan, bukannya spesifikasi.

Tidak sesuai #3 - kod legasi dengan keadaan yang rumit. Realiti berubah lebih pantas daripada spesifikasi. Contohnya, pasukan menerangkan kitaran pengebilan dan peraturan cukai, kemudian seminggu selepas itu bahagian Kewangan meminta VAT Eropah—spesifikasi sudah lapuk sebelum keluaran. Apabila logik perniagaan berkembang dengan pantas, mengekalkan spesifikasi menjadi beban.

Risiko tambahan ialah timbulnya rasa kawalan yang palsu: strukturnya kemas, tetapi ejen sering mengabaikan arahan atau, sebaliknya, mengikuti templat secara terlalu literal. Hasilnya ialah kod yang betul dari segi struktur tetapi tidak sesuai dengan repo khusus anda—spesifikasi tidak menjamin bahawa ejen memahaminya seperti yang anda maksudkan.

Pada April 2026, penganalisis industri memberi amaran tentang pendekatan air terjun: menulis spesifikasi besar sebelum kod ialah laluan yang pernah menjerumuskan industri dahulu, pada zaman keperluan 200 halaman. Jurutera berhati-hati terhadap pendekatan ini sejak itu, dan sikap berhati-hati tersebut wajar.

Apa yang patut dilakukan. Saya mencadangkan peraturan mudah: bandingkan saiz ciri dengan masa untuk menulis spesifikasinya. Jika ciri itu mengambil masa kurang daripada 2 jam untuk dilaksanakan, jangan tulis spesifikasi—Plan Mode lebih pantas. Jika ciri itu mengambil masa seminggu, gunakan Spec Kit; penjimatan masa akan membayar balik masa sejam untuk menyediakan spesifikasi sebanyak lima kali ganda. Antara 2 jam dengan seminggu, gunakan pertimbangan anda, walaupun saya sendiri menulis spesifikasi walaupun untuk ciri yang mengambil masa setengah hari kerana artifak dalam repo lebih bernilai daripada 30 minit yang dijimatkan.

Seterusnya: cara menyepadukan Spec Kit ke dalam projek anda?#

Pelan konkrit untuk 7 hari berikutnya:

• Hari 1. Pasang uv dan Spec Kit (5-10 minit). Semak sama ada arahan /speckit-* muncul dalam Claude Code. Jangan cuba menggunakannya pada projek sedia ada—mulakan dengan projek baharu.
• Hari 2. Pilih ciri sebenar yang anda rancang untuk bina. Jalankan /speckit-specify dengan penerangan bebas. Buka spec.md, baca dan jawab setiap [NEEDS CLARIFICATION]. Jangan tergesa-gesa beralih ke Plan.
• Hari 3. Jalankan /speckit-plan dengan petunjuk tentang timbunan teknologi anda. Baca plan.md, khususnya bahagian Architecture Decisions. Jika ada yang tidak sesuai, sunting secara manual.
• Hari 4-5. Jalankan /speckit-tasks, kemudian /speckit-analyze untuk menyemak set spec, plan dan tasks sekali lagi, kemudian /speckit-implement. Perhatikan cara Claude menandakan [x] dalam tasks.md. Claude mungkin tersekat pada sesuatu—itu perkara biasa. Kembali kepada spec.md, jelaskan keperluan itu dan mulakan semula /speckit-implement dengan tugas khusus. Setelah semua tugas ditutup, jalankan /speckit-converge dan ulangi urutan Implement dan Converge sehingga arahan itu memberikan respons “Converged.”
• Hari 6-7. Semak PR (atau beberapa PR). Gabungkannya. Baca spec.md dan plan.md anda—itulah dokumentasi ciri untuk tahun yang akan datang.

Bahan yang saya cadangkan untuk dibaca serentak:

• Cara menyediakan CLAUDE.md pada 2026 - asas kepada perlembagaan Spec Kit.
• Plan Mode dalam Claude Code - alternatif pantas untuk tugas kecil.
• Kejuruteraan konteks pada 2026 - sebab Spec Kit berkesan.
• Skills, Subejen, MCP atau Plugins - perkara yang boleh ditambah pada Spec Kit untuk aliran kerja anda.
• Aliran Kerja Dinamik dalam Claude Code - cara melancarkan banyak subejen serentak untuk fasa Implement.

Aliran kerja konteks lengkap: klon AI + Second Brain + Kejuruteraan Konteks.

Lebih banyak bahan tersedia di Ailoot.