@dedesfr/prompter 0.8.16 → 0.8.17

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # CHANGELOG
 
+## [0.8.17] - 2026-05-05
+
+### 🔄 Changed
+- **sph-generator Skill**: Refined the quotation workflow to support richer service proposals and cleaner cost tables
+  - Expanded service-mode prompts to collect project background, executive summary, scope, deliverables, and warranty details
+  - Switched services pricing to a work-package format with duration and lump-sum cost, with tax and payment terms moved into notes
+  - Reworked the Indonesian and English templates to better fit formal service proposal documents and Pandoc-friendly output
+
 ## [0.8.16] - 2026-05-05
 
 ### 🔄 Changed

package/dist/cli/index.js

@@ -16,7 +16,7 @@ const program = new Command();
 program
     .name('prompter')
     .description('Enhance prompts directly in your AI coding workflow')
-    .version('0.8.16');
+    .version('0.8.17');
 program
     .command('init')
     .description('Initialize Prompter in your project')

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@dedesfr/prompter",
-    "version": "0.8.16",
+    "version": "0.8.17",
     "description": "Enhance prompts directly in your AI coding workflow",
     "type": "module",
     "main": "dist/index.js",

package/skills/sph-generator/SKILL.md

@@ -63,31 +63,34 @@ Collect what you need to fill the template. Don't over-interrogate — ask for t
 
 | Field | Indonesian label | English label |
 |---|---|---|
-| Scope of work | Lingkup Pekerjaan | Scope of Work |
-| Deliverables | Hasil Pekerjaan / Deliverables | Deliverables |
-| Phases / milestones | Tahapan & Termin | Phases & Milestones |
-| Project duration | Estimasi Durasi Proyek | Project Timeline |
-| Revisions | Jumlah Revisi | Revision Rounds |
-| Assumptions | Asumsi | Assumptions |
-| Exclusions | Pengecualian / Di Luar Lingkup | Exclusions / Out of Scope |
+| Project background | Latar Belakang Proyek | Project Background |
+| Executive summary | Ringkasan Eksekutif | Executive Summary |
+| Product type, users, platform, tech stack | Tipe Produk, Pengguna, Platform, Teknologi | Product Type, Users, Platform, Tech |
+| Pain points / challenges | Tantangan / Masalah yang Diselesaikan | Pain Points / Challenges |
+| Solution overview | Solusi Sistem | Solution Overview |
+| Scope of work | Scope of Work | Scope of Work |
+| Project deliverables | Project Deliverables | Project Deliverables |
+| Payment terms (termin) | Termin Pembayaran | Payment Milestones |
+| Warranty | Garansi | Warranty |
 
 If the user supplies only some of these, fill the rest with sensible placeholders (e.g., `[Nama Klien]`, `[YYYY-MM-DD]`) so the document is still usable as a draft.
 
-### 3. Build the line items table
+### 3. Build the cost table
 
-Each item line has: **No. | Deskripsi | Qty | Satuan | Harga Satuan | Subtotal**.
+**Goods mode** — each row: `No. | Deskripsi | Qty | Satuan | Harga Satuan | Subtotal`. Compute subtotals, PPN, and grand total inline.
 
-Calculate:
-- `Subtotal per line = Qty × Harga Satuan`
-- `Subtotal keseluruhan = Σ subtotal per line`
-- `PPN = Subtotal × tax_rate` (default 11% for Indonesia; 0 if user says "tanpa PPN" or for non-ID English-language quotes unless specified)
-- `Total = Subtotal + PPN - Diskon (jika ada)`
+**Services mode** — each row: `No. | Deskripsi Pekerjaan | Waktu | Biaya (IDR)`. This reflects how service work is scoped — by effort/duration, not unit price. Rules:
+- "Waktu" = duration, e.g. `10 Hari Kerja`, `2 Minggu`
+- "Biaya" = lump sum for that work package
+- Grand total row: `**TOTAL INVESTASI** | | **X Hari Kerja** | **Rp X**`
+- PPN / tax goes in the **Keterangan** below the table (not as a separate table row) — common practice in Indonesian service proposals. State whether price is inclusive or exclusive of tax.
+- Termin pembayaran also goes in Keterangan as a numbered list: DP %, mid %, final %
 
 Format currency cleanly:
-- IDR → `Rp 1.500.000` (titik sebagai pemisah ribuan, tanpa desimal)
-- USD/EUR → `$1,500.00` / `€1,500.00`
+- IDR → `Rp 90.000.000` (titik sebagai pemisah ribuan, tanpa desimal)
+- USD/EUR → `$90,000.00` / `€90,000.00`
 
-Do the arithmetic yourself and double-check the totals before writing the file. A wrong total in a price quote is the most embarrassing failure mode of this skill.
+Verify the total before writing. Also verify that payment termin percentages add up to 100%.
 
 ### 4. Write the Markdown file
 
@@ -240,212 +243,222 @@ Sincerely,
 
 ## Template — Bahasa Indonesia (Services / Jasa)
 
-Use this for jasa pembuatan website, aplikasi, desain interior, branding, konsultasi, event, dll. Strukturnya menambah Lingkup, Tahapan & Termin, Asumsi, dan Pengecualian — bagian-bagian yang biasanya jadi sumber dispute kalau tidak ditulis eksplisit di awal.
+Use this for jasa pembuatan website/aplikasi, desain interior, branding, konsultasi, event organizer, dll. Struktur ini mengikuti format proposal penawaran jasa yang umum digunakan di Indonesia — lengkap dengan latar belakang, executive summary, pain points, solusi, scope, deliverables, dan tabel biaya berbasis waktu pengerjaan.
+
+Sections yang bersifat opsional (ditandai `[opsional]`) boleh dihilangkan kalau konteks proyek tidak relevan — misalnya, "Technical Architecture" tidak perlu ada untuk proyek desain interior.
 
 ```markdown
-# SURAT PENAWARAN HARGA
+**Proposal Penawaran Harga Jasa {{nama_perusahaan_pengirim}}**
 
-**Nomor:** {{nomor_surat}}
-**Tanggal:** {{tanggal}}
-**Perihal:** Penawaran Jasa {{nama_proyek}}
+**{{nama_proyek}}**
 
----
+No: {{nomor_surat}}     **{{kota_pengirim}}, {{tanggal}}**
 
 **Kepada Yth.**
-{{nama_penerima}}
-{{jabatan_penerima}}
-{{nama_perusahaan_penerima}}
-{{alamat_penerima}}
+{{nama_divisi_penerima}}
+**{{nama_perusahaan_penerima}}**
 
 ---
 
+**{{nama_proyek}}**
+
+**Latar Belakang Proyek**
+
 Dengan hormat,
 
-Menindaklanjuti {{konteks_singkat_diskusi}}, bersama ini **{{nama_perusahaan_pengirim}}** dengan senang hati menyampaikan penawaran untuk **{{nama_proyek}}** sebagai berikut.
+{{paragraf_latar_belakang_proyek}}
 
-## 1. Lingkup Pekerjaan
+**Ringkasan Eksekutif & Sekilas Pandang**
 
-{{ringkasan_proyek_1_paragraf}}
+{{paragraf_ringkasan_eksekutif}}
 
-**Hasil pekerjaan (deliverables) yang akan kami serahkan:**
+- **Tipe Produk:** {{tipe_produk}}
+- **Pengguna:** {{segmen_pengguna}}
+- **Platform:** {{platform}}
+- **Teknologi:** {{teknologi_utama}}
 
-- {{deliverable_1}}
-- {{deliverable_2}}
-- {{deliverable_3}}
+**Tantangan yang Diselesaikan**
 
-## 2. Tahapan & Termin Pembayaran
+- {{tantangan_1}}
+- {{tantangan_2}}
+- {{tantangan_3}}
 
-| Tahap | Deskripsi | Durasi | Termin |
-|------:|-----------|:------:|-------:|
-| 1     | {{tahap_1_nama}} — {{tahap_1_desc}} | {{tahap_1_durasi}} | {{tahap_1_termin}} |
-| 2     | {{tahap_2_nama}} — {{tahap_2_desc}} | {{tahap_2_durasi}} | {{tahap_2_termin}} |
-| 3     | {{tahap_3_nama}} — {{tahap_3_desc}} | {{tahap_3_durasi}} | {{tahap_3_termin}} |
+**Solusi Sistem Kami**
 
-**Estimasi total durasi proyek:** {{durasi_total}} hari kerja sejak DP diterima.
+{{paragraf_solusi}}
 
-## 3. Rincian Biaya
+**Ruang Lingkup Pekerjaan**
 
-| No. | Item / Komponen | Qty | Satuan | Harga Satuan | Subtotal |
-|----:|-----------------|----:|:------:|-------------:|---------:|
-| 1   | {{item_1}} | {{qty_1}} | {{satuan_1}} | {{harga_1}} | {{subtotal_1}} |
-| 2   | {{item_2}} | {{qty_2}} | {{satuan_2}} | {{harga_2}} | {{subtotal_2}} |
+1. **{{modul_1_nama}}**
+   - {{modul_1_fitur_1}}
+   - {{modul_1_fitur_2}}
+2. **{{modul_2_nama}}**
+   - {{modul_2_fitur_1}}
+   - {{modul_2_fitur_2}}
+3. **{{modul_3_nama}}**
+   - {{modul_3_fitur_1}}
+   - {{modul_3_fitur_2}}
 
-|  | **Subtotal** | **{{subtotal_total}}** |
-|--|--:|--:|
-|  | PPN (11%) | {{ppn}} |
-|  | Diskon | {{diskon}} |
-|  | **Total** | **{{total}}** |
+**Arsitektur Teknis** [opsional — hapus untuk proyek non-teknis]
 
-*Terbilang: {{total_terbilang}} rupiah.*
+{{paragraf_arsitektur_teknis}}
 
-## 4. Revisi
+**Deliverable Proyek**
 
-Penawaran ini sudah termasuk **{{jumlah_revisi}}** putaran revisi major per tahap. Revisi tambahan di luar kuota dikenakan biaya **{{biaya_revisi_tambahan}}** per putaran atau dapat digabungkan ke putaran berikutnya tanpa biaya jika belum melebihi kuota.
+- {{deliverable_1}}
+- {{deliverable_2}}
+- {{deliverable_3}}
 
-## 5. Asumsi
+**Struktur Biaya Proyek**
 
-Penawaran ini disusun dengan asumsi berikut. Jika asumsi tidak terpenuhi, lingkup dan biaya dapat ditinjau kembali.
+Berikut adalah estimasi investasi untuk pengembangan dan implementasi **{{nama_proyek}}**:
 
-- {{asumsi_1}}
-- {{asumsi_2}}
-- {{asumsi_3}}
+| **No** | **Deskripsi Pekerjaan** | **Waktu** | **Biaya (IDR)** |
+|-------:|-------------------------|:---------:|----------------:|
+| 1 | **{{paket_1_nama}}** *{{paket_1_deskripsi_singkat}}* | {{paket_1_waktu}} | {{paket_1_biaya}} |
+| 2 | **{{paket_2_nama}}** *{{paket_2_deskripsi_singkat}}* | {{paket_2_waktu}} | {{paket_2_biaya}} |
+| 3 | **{{paket_3_nama}}** *{{paket_3_deskripsi_singkat}}* | {{paket_3_waktu}} | {{paket_3_biaya}} |
+| **TOTAL INVESTASI** | | **{{total_waktu}}** | **{{total_biaya}}** |
 
-## 6. Pengecualian (Di Luar Lingkup)
+Keterangan:
 
-Hal-hal berikut **tidak termasuk** dalam penawaran ini, dan dapat ditambahkan sebagai pekerjaan terpisah bila dibutuhkan:
+1. Biaya yang diajukan {{status_pajak}} *(contoh: "tidak termasuk Pajak (PPN 11%)" atau "sudah termasuk PPN 11%")*
+2. Termin pembayaran:
+   1. Termin ke-1: {{termin_1_persen}}% sebagai DP
+   2. Termin ke-2: {{termin_2_persen}}% {{termin_2_kondisi}}
+   3. Termin ke-3: {{termin_3_persen}}% {{termin_3_kondisi}}
 
-- {{pengecualian_1}}
-- {{pengecualian_2}}
-- {{pengecualian_3}}
+**Garansi**
 
-## 7. Syarat dan Ketentuan
+{{paragraf_intro_garansi_singkat}}
 
-1. **Masa Berlaku Penawaran:** {{masa_berlaku}} sejak tanggal surat ini.
-2. **Syarat Pembayaran:** mengikuti termin per tahap pada bagian 2; pembayaran via transfer bank.
-3. **Tanggal Mulai:** pekerjaan dimulai paling lambat {{lead_time_mulai}} setelah DP & dokumen kebutuhan diterima.
-4. **Hak Cipta & Source File:** {{ketentuan_ipr}}.
-5. **Garansi / Masa Pemeliharaan:** {{garansi}} setelah serah terima akhir.
-6. **Force majeure** dan keterlambatan akibat keterlambatan respons klien akan menggeser timeline secara proporsional.
+1. {{ketentuan_garansi_1}}
+2. {{ketentuan_garansi_2}}
+3. {{ketentuan_garansi_3}}
+4. Perubahan dan/atau penambahan di luar lingkup yang tertera akan didiskusikan biaya dan waktunya secara terpisah.
 
-## Penutup
+**Penutup**
 
-Demikian penawaran ini kami sampaikan. Kami siap mendiskusikan penyesuaian lingkup, tahapan, maupun anggaran agar sesuai dengan kebutuhan {{nama_perusahaan_penerima}}.
+{{paragraf_penutup}}
 
-Atas perhatian dan kepercayaannya, kami ucapkan terima kasih.
+Demikian surat penawaran ini kami sampaikan. Kami sangat menantikan kesempatan untuk berdiskusi lebih lanjut.
 
-Hormat kami,
-**{{nama_perusahaan_pengirim}}**
+Hormat Kami,
 
 <br><br><br>
 
 **{{nama_penanda_tangan}}**
-{{jabatan_penanda_tangan}}
-{{kontak_penanda_tangan}}
+[{{jabatan_penanda_tangan}}]
 ```
 
 ---
 
 ## Template — English (Services)
 
-Use this for service-based engagements (web/app development, interior design, branding, consulting, etc.).
+Same structure as the Indonesian services template, adapted for English-language proposals.
 
 ```markdown
-# PRICE QUOTATION
+**Service Proposal — {{sender_company}}**
 
-**Reference No.:** {{ref_no}}
-**Date:** {{date}}
-**Subject:** Service Proposal — {{project_name}}
+**{{project_name}}**
 
----
+Ref: {{ref_no}} &nbsp;&nbsp;&nbsp; **{{sender_city}}, {{date}}**
 
 **To:**
-{{recipient_name}}
-{{recipient_title}}
-{{recipient_company}}
-{{recipient_address}}
+{{recipient_division}}
+**{{recipient_company}}**
 
 ---
 
-Dear {{recipient_salutation}},
+**{{project_name}}**
 
-Following {{brief_context}}, **{{sender_company}}** is pleased to submit the following proposal for **{{project_name}}**.
+**Project Background**
 
-## 1. Scope of Work
+Dear Sir/Madam,
 
-{{project_summary_paragraph}}
+{{project_background_paragraph}}
 
-**Deliverables:**
+**Executive Summary**
 
-- {{deliverable_1}}
-- {{deliverable_2}}
-- {{deliverable_3}}
+{{executive_summary_paragraph}}
 
-## 2. Phases & Payment Milestones
+- **Product Type:** {{product_type}}
+- **Users:** {{user_segments}}
+- **Platform:** {{platform}}
+- **Technology:** {{key_technologies}}
 
-| Phase | Description | Duration | Payment |
-|------:|-------------|:--------:|--------:|
-| 1     | {{phase_1_name}} — {{phase_1_desc}} | {{phase_1_duration}} | {{phase_1_payment}} |
-| 2     | {{phase_2_name}} — {{phase_2_desc}} | {{phase_2_duration}} | {{phase_2_payment}} |
-| 3     | {{phase_3_name}} — {{phase_3_desc}} | {{phase_3_duration}} | {{phase_3_payment}} |
+**Challenges We Address**
 
-**Estimated total duration:** {{total_duration}} working days from receipt of down payment.
+- {{challenge_1}}
+- {{challenge_2}}
+- {{challenge_3}}
 
-## 3. Cost Breakdown
+**Our Solution**
 
-| No. | Item / Component | Qty | Unit | Unit Price | Subtotal |
-|----:|------------------|----:|:----:|-----------:|---------:|
-| 1   | {{item_1}} | {{qty_1}} | {{unit_1}} | {{price_1}} | {{subtotal_1}} |
-| 2   | {{item_2}} | {{qty_2}} | {{unit_2}} | {{price_2}} | {{subtotal_2}} |
+{{solution_overview_paragraph}}
 
-|  | **Subtotal** | **{{subtotal_total}}** |
-|--|--:|--:|
-|  | Tax / VAT ({{tax_rate}}%) | {{tax}} |
-|  | Discount | {{discount}} |
-|  | **Total** | **{{total}}** |
+**Scope of Work**
 
-## 4. Revisions
+1. **{{module_1_name}}**
+   - {{module_1_feature_1}}
+   - {{module_1_feature_2}}
+2. **{{module_2_name}}**
+   - {{module_2_feature_1}}
+   - {{module_2_feature_2}}
+3. **{{module_3_name}}**
+   - {{module_3_feature_1}}
+   - {{module_3_feature_2}}
 
-This quotation includes **{{revision_rounds}}** rounds of major revision per phase. Additional revisions beyond this quota are billed at **{{additional_revision_fee}}** per round, or may be carried over to a later phase at no cost if the quota has not been exhausted.
+**Technical Architecture** [optional — remove for non-technical projects]
 
-## 5. Assumptions
+{{technical_architecture_paragraph}}
 
-This proposal assumes the following. If any assumption does not hold, the scope and pricing may be revisited.
+**Project Deliverables**
 
-- {{assumption_1}}
-- {{assumption_2}}
-- {{assumption_3}}
+- {{deliverable_1}}
+- {{deliverable_2}}
+- {{deliverable_3}}
 
-## 6. Exclusions (Out of Scope)
+**Project Cost Structure**
 
-The following items are **not included** and can be quoted separately if required:
+The following is the estimated investment for the development and implementation of **{{project_name}}**:
 
-- {{exclusion_1}}
-- {{exclusion_2}}
-- {{exclusion_3}}
+| **No** | **Work Package** | **Duration** | **Cost (IDR)** |
+|-------:|------------------|:------------:|---------------:|
+| 1 | **{{package_1_name}}** *{{package_1_short_desc}}* | {{package_1_duration}} | {{package_1_cost}} |
+| 2 | **{{package_2_name}}** *{{package_2_short_desc}}* | {{package_2_duration}} | {{package_2_cost}} |
+| 3 | **{{package_3_name}}** *{{package_3_short_desc}}* | {{package_3_duration}} | {{package_3_cost}} |
+| **TOTAL INVESTMENT** | | **{{total_duration}}** | **{{total_cost}}** |
 
-## 7. Terms and Conditions
+Notes:
 
-1. **Quotation Validity:** {{validity}} from the date of this letter.
-2. **Payment Terms:** per phase as detailed in section 2; payable via bank transfer.
-3. **Project Start:** work begins no later than {{start_lead_time}} after DP and requirements documents are received.
-4. **IP & Source Files:** {{ipr_terms}}.
-5. **Warranty / Maintenance:** {{warranty}} after final handover.
-6. Force majeure and delays caused by late client response will shift the timeline proportionally.
+1. Quoted prices {{tax_status}} *(e.g. "exclude VAT (11%)" or "include VAT (11%)")*
+2. Payment milestones:
+   1. Milestone 1: {{milestone_1_pct}}% as down payment
+   2. Milestone 2: {{milestone_2_pct}}% {{milestone_2_condition}}
+   3. Milestone 3: {{milestone_3_pct}}% {{milestone_3_condition}}
 
-## Closing
+**Warranty**
+
+{{warranty_intro_sentence}}
+
+1. {{warranty_term_1}}
+2. {{warranty_term_2}}
+3. {{warranty_term_3}}
+4. Any changes or additions outside the defined scope will be discussed and agreed upon separately in terms of cost and timeline.
+
+**Closing Remarks**
 
-We hope this proposal aligns with your needs and we are open to adjusting scope, phases, or budget to fit {{recipient_company}}'s priorities.
+{{closing_paragraph}}
 
-Thank you for your kind consideration.
+We look forward to the opportunity to discuss this proposal further.
 
 Sincerely,
-**{{sender_company}}**
 
 <br><br><br>
 
 **{{signatory_name}}**
-{{signatory_title}}
-{{signatory_contact}}
+[{{signatory_title}}]
 ```
 
 ---
@@ -456,7 +469,7 @@ A few small choices in the templates above keep conversion smooth:
 
 - **No raw HTML except `<br>`** — most converters handle line breaks but choke on arbitrary tags. Three `<br>` for signature space is the safest portable trick.
 - **GFM tables only** — no merged cells, no colspan tricks. If you need more complex layouts in `.docx`, post-process there.
-- **No emoji or icons in headings** — they sometimes get stripped or mis-rendered in PDF engines without proper fonts.
+- **No emoji anywhere** — this is a formal business document. No emoji in headings, bullets, or body text. Use bold labels instead of icons.
 - **Use `**bold**` and `*italic*`** — avoid `__` and `_` underscores around words containing numbers/IDs (Pandoc occasionally treats them as subscripts in some modes).
 - **Currency formatting is plain text**, not a code block — code blocks survive conversion but render in monospace, which looks wrong in a formal letter.
 
@@ -468,5 +481,8 @@ If the user later asks for a fancier visual layout, that's a `.docx` template /
 - **Don't forget the tax assumption.** In Indonesia, PPN is 11% as of 2026. If the quote is for an export client or the user explicitly says "tanpa PPN", set tax to 0 and remove the line.
 - **Match the language end-to-end.** Don't mix "Subtotal" headings in English with "Hormat kami" in Indonesian. Pick one and commit.
 - **Verify arithmetic.** Recompute totals once before writing the file. This is the single biggest failure mode for quotation documents.
-- **Untuk services mode**, jangan biarkan "Lingkup Pekerjaan" jadi paragraf hampa berisi marketing speak. Tulis deliverables sebagai daftar konkret yang bisa dicentang ("3 halaman desain landing page final dalam Figma" — bukan "desain web yang menarik dan modern"). Vague scope = endless revisions.
-- **Tahapan harus konsisten dengan termin.** Jumlah persentase termin (DP + per tahap + pelunasan) wajib = 100%. Cek ulang sebelum menulis file.
+- **Scope of Work harus konkret.** Tulis fitur/modul sebagai daftar yang bisa dicentang ("Sistem RBAC dengan 3 role: Admin, Editor, Viewer" — bukan "manajemen pengguna yang canggih"). Scope yang ambigu = revisi tak berujung.
+- **Deliverables ≠ Scope.** Scope = apa yang dikerjakan. Deliverables = apa yang diserahkan ke klien (dokumen, source code, akun staging, manual book, dll). Keduanya harus ada di template jasa.
+- **Tabel biaya jasa pakai kolom Waktu + Biaya, bukan Qty/Satuan/Harga Satuan.** Jangan campur format tabel goods ke services — tampilannya janggal dan tidak sesuai ekspektasi klien.
+- **Persentase termin harus = 100%.** Cek DP% + mid% + final% sebelum menulis file.
+- **Warranty jangan salin-tempel generik.** Sesuaikan dengan jenis proyek: "bugfix selama perusahaan berdiri" cocok untuk software; untuk desain interior mungkin lebih relevan "garansi revisi minor 30 hari setelah serah terima".

package/src/cli/index.ts

@@ -18,7 +18,7 @@ const program = new Command();
 program
   .name('prompter')
   .description('Enhance prompts directly in your AI coding workflow')
-  .version('0.8.16');
+  .version('0.8.17');
 
 program
   .command('init')