create-vasvibe 2.4.0 → 2.5.0

package/template/.opencode/commands/manual-test.md

@@ -0,0 +1,18 @@
+---
+description: Manual/headful UAT testing dengan Playwright — scenario matrix, screenshot evidence, dan defect triage (Major/Minor). Opsional, berdampingan dengan /test-feature.
+---
+
+Jalankan **Manual/Headful UAT Testing** untuk fitur: **$ARGUMENTS**
+
+Langkah:
+1. **Manual Tester** → generate scenario matrix (Normal + Abnormal case) per fitur/fungsi, lalu eksekusi headful Playwright dengan screenshot tiap skenario, update Pass/Fail + Severity (Major/Minor) di `task/[TASK-ID]_[nama-task]/manual_test_report.md`.
+2. Jika ada temuan **Major** → rekomendasikan **Fixer** untuk memperbaiki, lalu jalankan ulang `/manual-test` untuk retest (iterasi bertambah otomatis, histori iterasi sebelumnya tetap tersimpan).
+3. **GATE — UAT hijau:** semua skenario Pass, atau temuan Minor yang tersisa sudah didokumentasikan dan diterima human.
+
+**Catatan integrasi (PENTING):**
+- Command ini **independen/opsional** dari `/test-feature` (scripted E2E oleh Tester Agent) — bisa dijalankan berdampingan kapan saja, **tidak mengubah** gate Fase 3 atau alur `/deliver-feature` yang sudah ada.
+- Manual Tester **tidak pernah mengubah** `Current Status` di `task/task_list.md` — hanya menambah baris di `Status Logs:`. Ini menjaga state machine Tester/Fixer tetap konsisten walau `/manual-test` dipanggil terpisah.
+- Definisi lengkap agent: `agent/workflows/manual-tester.md`.
+- Screenshot tersimpan di `tests/screenshots/[TASK-ID]/iteration-[N]/`, laporan (scenario matrix + summary) di `task/[TASK-ID]_[nama-task]/manual_test_report.md`.
+- Hormati `WORK_DEPTH` dari `project_overview.md` (override dengan `depth=` di argumen jika ada).
+- Jika muncul perubahan scope di tengah pipeline, ikuti `agent/workflows/_shared/change-management.md` (No Silent Changes).

package/template/.opencode/commands/plan-project.md

@@ -1,25 +1,25 @@
----
-description: Jalankan Fase 1 (Perencanaan) — hasilkan semua blueprint/acuan dengan human gate.
----
-
-Jalankan **Fase 1 — Perencanaan** untuk: **$ARGUMENTS**
-
-Langkah:
-0. **Discovery (INTERAKTIF — JANGAN delegasikan ke subagent)** → kamu sendiri di thread utama wawancara human (tanya-jawab bertahap), hasilkan `state/knowledge_base/requirements/requirements.md`. Ikuti metodologi di `agent/workflows/discovery.md`.
-1. **GATE:** Human sign-off `requirements.md`
-2. **Initiator** (delegasi) → `project_overview.md` (sintesis dari requirements, termasuk `WORK_DEPTH`)
-3. **CHECKPOINT:** Human review tech stack, UI vibe, work depth
-4. **SysArch** → `state/knowledge_base/architecture/` (jika ada infra requirement)
-5. **Data Architect** → `state/knowledge_base/data-model/`
-6. **UX Designer** → `state/knowledge_base/design-system/`
-7. **Security (Mode S)** → `state/knowledge_base/security/security-standards.md`
-8. **Analyst** → `specifications/000_spec_environment_setup.md` + backlog user story (termasuk **API Contract**)
-9. **DevOps** → environment setup (jika dibutuhkan)
-10. **GATE — Blueprint disetujui:** API Contract wajib final.
-
-**Aturan orkestrasi (WAJIB):**
-- Kamu adalah **Orchestrator** di thread utama. Delegasikan tiap langkah ke subagent yang disebut menggunakan Task tool (Claude Code) / agent invocation (OpenCode).
-- **BERHENTI di setiap GATE / CHECKPOINT** dan minta persetujuan human secara eksplisit sebelum lanjut.
-- Definisi kanonik pipeline: baca `agent/workflows/orchestrator.md`. Model fase & kepemilikan dokumen: `agent/workflows/_shared/phases.md`.
-- Hormati `WORK_DEPTH` dari `project_overview.md` (override dengan `depth=` di argumen jika ada).
-- Jika muncul perubahan di tengah pipeline, ikuti `agent/workflows/_shared/change-management.md` (No Silent Changes).
+---
+description: Jalankan Fase 1 (Perencanaan) — hasilkan semua blueprint/acuan dengan human gate.
+---
+
+Jalankan **Fase 1 — Perencanaan** untuk: **$ARGUMENTS**
+
+Langkah:
+0. **Discovery (INTERAKTIF — JANGAN delegasikan ke subagent)** → kamu sendiri di thread utama wawancara human (tanya-jawab bertahap), hasilkan `state/knowledge_base/requirements/requirements.md`. Ikuti metodologi di `agent/workflows/discovery.md`.
+1. **GATE:** Human sign-off `requirements.md`
+2. **Initiator** (delegasi) → `project_overview.md` (sintesis dari requirements, termasuk `WORK_DEPTH`)
+3. **CHECKPOINT:** Human review tech stack, UI vibe, work depth
+4. **SysArch** → `state/knowledge_base/architecture/` (jika ada infra requirement)
+5. **Data Architect** → `state/knowledge_base/data-model/`
+6. **UX Designer** → `state/knowledge_base/design-system/`
+7. **Security (Mode S)** → `state/knowledge_base/security/security-standards.md`
+8. **Analyst** → `specifications/000_spec_environment_setup.md` + backlog user story (termasuk **API Contract**)
+9. **DevOps** → environment setup (jika dibutuhkan)
+10. **GATE — Blueprint disetujui:** API Contract wajib final.
+
+**Aturan orkestrasi (WAJIB):**
+- Kamu adalah **Orchestrator** di thread utama. Delegasikan tiap langkah ke subagent yang disebut menggunakan Task tool (Claude Code) / agent invocation (OpenCode).
+- **BERHENTI di setiap GATE / CHECKPOINT** dan minta persetujuan human secara eksplisit sebelum lanjut.
+- Definisi kanonik pipeline: baca `agent/workflows/orchestrator.md`. Model fase & kepemilikan dokumen: `agent/workflows/_shared/phases.md`.
+- Hormati `WORK_DEPTH` dari `project_overview.md` (override dengan `depth=` di argumen jika ada).
+- Jika muncul perubahan di tengah pipeline, ikuti `agent/workflows/_shared/change-management.md` (No Silent Changes).

package/template/.opencode/commands/release.md

@@ -1,18 +1,18 @@
----
-description: Rangkaian akhir ke produksi: hardening → changelog → version tag.
----
-
-Jalankan rangkaian rilis untuk versi: **$ARGUMENTS**
-
-1. **PM** → summarize semua task `done` sejak release terakhir
-2. Jalankan **/harden-release "$ARGUMENTS"** (Fase 4) — berhenti di gate-nya
-3. **Document** → update `CHANGELOG.md`
-4. **DevOps** → bump version, buat git tag `v$ARGUMENTS`
-5. **CHECKPOINT:** Human review CHANGELOG & approve release tag.
-
-**Aturan orkestrasi (WAJIB):**
-- Kamu adalah **Orchestrator** di thread utama. Delegasikan tiap langkah ke subagent yang disebut menggunakan Task tool (Claude Code) / agent invocation (OpenCode).
-- **BERHENTI di setiap GATE / CHECKPOINT** dan minta persetujuan human secara eksplisit sebelum lanjut.
-- Definisi kanonik pipeline: baca `agent/workflows/orchestrator.md`. Model fase & kepemilikan dokumen: `agent/workflows/_shared/phases.md`.
-- Hormati `WORK_DEPTH` dari `project_overview.md` (override dengan `depth=` di argumen jika ada).
-- Jika muncul perubahan di tengah pipeline, ikuti `agent/workflows/_shared/change-management.md` (No Silent Changes).
+---
+description: Rangkaian akhir ke produksi: hardening → changelog → version tag.
+---
+
+Jalankan rangkaian rilis untuk versi: **$ARGUMENTS**
+
+1. **PM** → summarize semua task `done` sejak release terakhir
+2. Jalankan **/harden-release "$ARGUMENTS"** (Fase 4) — berhenti di gate-nya
+3. **Document** → update `CHANGELOG.md`
+4. **DevOps** → bump version, buat git tag `v$ARGUMENTS`
+5. **CHECKPOINT:** Human review CHANGELOG & approve release tag.
+
+**Aturan orkestrasi (WAJIB):**
+- Kamu adalah **Orchestrator** di thread utama. Delegasikan tiap langkah ke subagent yang disebut menggunakan Task tool (Claude Code) / agent invocation (OpenCode).
+- **BERHENTI di setiap GATE / CHECKPOINT** dan minta persetujuan human secara eksplisit sebelum lanjut.
+- Definisi kanonik pipeline: baca `agent/workflows/orchestrator.md`. Model fase & kepemilikan dokumen: `agent/workflows/_shared/phases.md`.
+- Hormati `WORK_DEPTH` dari `project_overview.md` (override dengan `depth=` di argumen jika ada).
+- Jika muncul perubahan di tengah pipeline, ikuti `agent/workflows/_shared/change-management.md` (No Silent Changes).

package/template/.opencode/commands/security-audit.md

@@ -1,19 +1,19 @@
----
-description: Audit keamanan ad-hoc di luar siklus release.
----
-
-Jalankan security audit untuk scope: **$ARGUMENTS**
-
-1. **Security (Mode A)** → Threat Modeling
-2. **Security (Mode B)** → Vulnerability Scan
-3. **CHECKPOINT:** Human review findings (approve fix plan / accepted risk)
-4. **Security (Mode C)** → fix CRITICAL & HIGH
-5. **Tester** → regression test
-6. **CHECKPOINT:** Human sign-off.
-
-**Aturan orkestrasi (WAJIB):**
-- Kamu adalah **Orchestrator** di thread utama. Delegasikan tiap langkah ke subagent yang disebut menggunakan Task tool (Claude Code) / agent invocation (OpenCode).
-- **BERHENTI di setiap GATE / CHECKPOINT** dan minta persetujuan human secara eksplisit sebelum lanjut.
-- Definisi kanonik pipeline: baca `agent/workflows/orchestrator.md`. Model fase & kepemilikan dokumen: `agent/workflows/_shared/phases.md`.
-- Hormati `WORK_DEPTH` dari `project_overview.md` (override dengan `depth=` di argumen jika ada).
-- Jika muncul perubahan di tengah pipeline, ikuti `agent/workflows/_shared/change-management.md` (No Silent Changes).
+---
+description: Audit keamanan ad-hoc di luar siklus release.
+---
+
+Jalankan security audit untuk scope: **$ARGUMENTS**
+
+1. **Security (Mode A)** → Threat Modeling
+2. **Security (Mode B)** → Vulnerability Scan
+3. **CHECKPOINT:** Human review findings (approve fix plan / accepted risk)
+4. **Security (Mode C)** → fix CRITICAL & HIGH
+5. **Tester** → regression test
+6. **CHECKPOINT:** Human sign-off.
+
+**Aturan orkestrasi (WAJIB):**
+- Kamu adalah **Orchestrator** di thread utama. Delegasikan tiap langkah ke subagent yang disebut menggunakan Task tool (Claude Code) / agent invocation (OpenCode).
+- **BERHENTI di setiap GATE / CHECKPOINT** dan minta persetujuan human secara eksplisit sebelum lanjut.
+- Definisi kanonik pipeline: baca `agent/workflows/orchestrator.md`. Model fase & kepemilikan dokumen: `agent/workflows/_shared/phases.md`.
+- Hormati `WORK_DEPTH` dari `project_overview.md` (override dengan `depth=` di argumen jika ada).
+- Jika muncul perubahan di tengah pipeline, ikuti `agent/workflows/_shared/change-management.md` (No Silent Changes).

package/template/.opencode/commands/setup-workspace.md

@@ -1,21 +1,21 @@
----
-description: Setup/optimasi workspace agentik — install skills & konfigurasi MCP untuk tool AI yang dipakai. Re-callable saat pindah tool.
----
-
-Jalankan **Toolsmith** (Agentic Workspace Provisioner) untuk: **$ARGUMENTS**
-
-Tujuan: menyiapkan perkakas si AI agent (skills + MCP) agar bekerja optimal — **bukan** infra produk (itu DevOps).
-
-Langkah:
-1. **Deteksi mode** dari argumen (`init` default jika `state/workspace-manifest.json` belum ada; `switch` saat pindah tool; `sync` untuk perbaiki drift).
-2. **Deteksi tool aktif** dari penanda (`.claude/`, `.opencode/`, `.agents/`, `.github/prompts/`/`.vscode/`). Ambigu → tanya human.
-3. **Mode `init`:** tentukan kebutuhan (hybrid: `schemas/workspace-registry.json` `stackMappings` dari tech stack di `project_overview.md`/`requirements.md` + baseline + augmentasi `find-skills`) → tulis `state/workspace-manifest.json` → **tunjukkan ringkasan, minta approve human**.
-4. **Mode `switch`/`sync`:** baca manifest yang ada (jangan hitung ulang), apply ke tool target.
-5. **Apply declarative:** tulis MCP ke file config tool (`.mcp.json` / `opencode.json` / `.vscode/mcp.json` / `.agents/mcp.json`) sesuai `platformTargets`; install skills ke `skillsDir` via `npx skills add`. **Merge, jangan timpa. Secrets → placeholder `${VAR}`.**
-6. **Update `appliedTo[tool]`** = timestamp; laporkan langkah manual tersisa.
-
-**Aturan:**
-- Definisi kanonik agen: `agent/workflows/toolsmith.md`. Registry: `schemas/workspace-registry.json`.
-- **JANGAN hardcode kredensial** — gunakan placeholder env var dan instruksikan human mengisi `.env`.
-- Perubahan daftar skill/MCP dicatat di manifest `revisionHistory` (No Silent Changes).
-- Bisa dipanggil kapan saja — termasuk di tengah fase saat developer pindah tool AI.
+---
+description: Setup/optimasi workspace agentik — install skills & konfigurasi MCP untuk tool AI yang dipakai. Re-callable saat pindah tool.
+---
+
+Jalankan **Toolsmith** (Agentic Workspace Provisioner) untuk: **$ARGUMENTS**
+
+Tujuan: menyiapkan perkakas si AI agent (skills + MCP) agar bekerja optimal — **bukan** infra produk (itu DevOps).
+
+Langkah:
+1. **Deteksi mode** dari argumen (`init` default jika `state/workspace-manifest.json` belum ada; `switch` saat pindah tool; `sync` untuk perbaiki drift).
+2. **Deteksi tool aktif** dari penanda (`.claude/`, `.opencode/`, `.agents/`, `.github/prompts/`/`.vscode/`). Ambigu → tanya human.
+3. **Mode `init`:** tentukan kebutuhan (hybrid: `schemas/workspace-registry.json` `stackMappings` dari tech stack di `project_overview.md`/`requirements.md` + baseline + augmentasi `find-skills`) → tulis `state/workspace-manifest.json` → **tunjukkan ringkasan, minta approve human**.
+4. **Mode `switch`/`sync`:** baca manifest yang ada (jangan hitung ulang), apply ke tool target.
+5. **Apply declarative:** tulis MCP ke file config tool (`.mcp.json` / `opencode.json` / `.vscode/mcp.json` / `.agents/mcp.json`) sesuai `platformTargets`; install skills ke `skillsDir` via `npx skills add`. **Merge, jangan timpa. Secrets → placeholder `${VAR}`.**
+6. **Update `appliedTo[tool]`** = timestamp; laporkan langkah manual tersisa.
+
+**Aturan:**
+- Definisi kanonik agen: `agent/workflows/toolsmith.md`. Registry: `schemas/workspace-registry.json`.
+- **JANGAN hardcode kredensial** — gunakan placeholder env var dan instruksikan human mengisi `.env`.
+- Perubahan daftar skill/MCP dicatat di manifest `revisionHistory` (No Silent Changes).
+- Bisa dipanggil kapan saja — termasuk di tengah fase saat developer pindah tool AI.

package/template/.opencode/commands/start-fix.md

@@ -1,18 +1,17 @@
----
-description: Perbaikan bug terarah: fix → review → regression.
----
-
-Tangani bug: **$ARGUMENTS**
-
-**Langkah Pipeline:**
-1. **Fixer** → analisis root cause & fix. Sampaikan deskripsi bug ini: "$ARGUMENTS". Instruksikan Fixer untuk membaca `task/task_list.md` guna menemukan Task ID relevan; jika tidak ditemukan atau `task_list.md` belum ada, lanjutkan langsung ke diagnosa source code di `codes/`.
-2. **QA** → quick static review pada file yang diubah oleh Fixer.
-3. **Tester** → regression test untuk memastikan fix tidak break fitur lain.
-4. **CHECKPOINT:** Tampilkan ringkasan: bug yang diperbaiki, root cause, file yang diubah. Minta validasi human secara eksplisit.
-
-**Aturan orkestrasi (WAJIB):**
-- Kamu adalah **Orchestrator** di thread utama. Delegasikan tiap langkah ke subagent yang disebut menggunakan Task tool (Claude Code) / agent invocation (OpenCode).
-- **BERHENTI di CHECKPOINT** dan minta persetujuan human secara eksplisit sebelum menutup pipeline.
-- Definisi kanonik pipeline: baca `agent/workflows/orchestrator.md`. Model fase & kepemilikan dokumen: `agent/workflows/_shared/phases.md`.
-- Hormati `WORK_DEPTH` dari `project_overview.md` (override dengan `depth=` di argumen jika ada).
-- Jika muncul perubahan di tengah pipeline, ikuti `agent/workflows/_shared/change-management.md` (No Silent Changes).
+---
+description: Perbaikan bug terarah: fix → review → regression.
+---
+
+Tangani bug: **$ARGUMENTS**
+
+1. **Fixer** → analyze root cause & fix
+2. **QA** → quick review pada kode yang diubah
+3. **Tester** → regression test
+4. **CHECKPOINT:** Human validation.
+
+**Aturan orkestrasi (WAJIB):**
+- Kamu adalah **Orchestrator** di thread utama. Delegasikan tiap langkah ke subagent yang disebut menggunakan Task tool (Claude Code) / agent invocation (OpenCode).
+- **BERHENTI di setiap GATE / CHECKPOINT** dan minta persetujuan human secara eksplisit sebelum lanjut.
+- Definisi kanonik pipeline: baca `agent/workflows/orchestrator.md`. Model fase & kepemilikan dokumen: `agent/workflows/_shared/phases.md`.
+- Hormati `WORK_DEPTH` dari `project_overview.md` (override dengan `depth=` di argumen jika ada).
+- Jika muncul perubahan di tengah pipeline, ikuti `agent/workflows/_shared/change-management.md` (No Silent Changes).

package/template/.opencode/commands/test-feature.md

@@ -1,17 +1,17 @@
----
-description: Jalankan Fase 3 (Testing) — E2E test fungsional terhadap spesifikasi.
----
-
-Jalankan **Fase 3 — Testing** untuk fitur: **$ARGUMENTS**
-
-Langkah:
-1. **Tester** → buat & jalankan E2E test berdasarkan spec
-2. Jika FAIL → **Fixer** → loop balik ke langkah 1
-3. **GATE — Fungsional hijau:** semua test pass.
-
-**Aturan orkestrasi (WAJIB):**
-- Kamu adalah **Orchestrator** di thread utama. Delegasikan tiap langkah ke subagent yang disebut menggunakan Task tool (Claude Code) / agent invocation (OpenCode).
-- **BERHENTI di setiap GATE / CHECKPOINT** dan minta persetujuan human secara eksplisit sebelum lanjut.
-- Definisi kanonik pipeline: baca `agent/workflows/orchestrator.md`. Model fase & kepemilikan dokumen: `agent/workflows/_shared/phases.md`.
-- Hormati `WORK_DEPTH` dari `project_overview.md` (override dengan `depth=` di argumen jika ada).
-- Jika muncul perubahan di tengah pipeline, ikuti `agent/workflows/_shared/change-management.md` (No Silent Changes).
+---
+description: Jalankan Fase 3 (Testing) — E2E test fungsional terhadap spesifikasi.
+---
+
+Jalankan **Fase 3 — Testing** untuk fitur: **$ARGUMENTS**
+
+Langkah:
+1. **Tester** → buat & jalankan E2E test berdasarkan spec
+2. Jika FAIL → **Fixer** → loop balik ke langkah 1
+3. **GATE — Fungsional hijau:** semua test pass.
+
+**Aturan orkestrasi (WAJIB):**
+- Kamu adalah **Orchestrator** di thread utama. Delegasikan tiap langkah ke subagent yang disebut menggunakan Task tool (Claude Code) / agent invocation (OpenCode).
+- **BERHENTI di setiap GATE / CHECKPOINT** dan minta persetujuan human secara eksplisit sebelum lanjut.
+- Definisi kanonik pipeline: baca `agent/workflows/orchestrator.md`. Model fase & kepemilikan dokumen: `agent/workflows/_shared/phases.md`.
+- Hormati `WORK_DEPTH` dari `project_overview.md` (override dengan `depth=` di argumen jika ada).
+- Jika muncul perubahan di tengah pipeline, ikuti `agent/workflows/_shared/change-management.md` (No Silent Changes).

package/template/.opencode/skills/penetration-testing/SKILL.md

@@ -1,94 +1,94 @@
----
-name: penetration-testing
-description: >
-  Ethical hacking and security testing methodologies using penetration testing
-  tools, exploit frameworks, and manual security validation. Use when assessing
-  application security posture and identifying exploitable vulnerabilities.
----
-
-# Penetration Testing
-
-## Table of Contents
-
-- [Overview](#overview)
-- [When to Use](#when-to-use)
-- [Quick Start](#quick-start)
-- [Reference Guides](#reference-guides)
-- [Best Practices](#best-practices)
-
-## Overview
-
-Systematic security testing to identify, exploit, and document vulnerabilities in applications, networks, and infrastructure through simulated attacks.
-
-## When to Use
-
-- Pre-production security validation
-- Annual security assessments
-- Compliance requirements (PCI-DSS, ISO 27001)
-- Post-incident security review
-- Third-party security audits
-- Red team exercises
-
-## Quick Start
-
-Minimal working example:
-
-```python
-# pentest_framework.py
-import requests
-import socket
-import subprocess
-import json
-from typing import List, Dict
-from dataclasses import dataclass, asdict
-from datetime import datetime
-
-@dataclass
-class Finding:
-    severity: str
-    category: str
-    target: str
-    vulnerability: str
-    evidence: str
-    remediation: str
-    cvss_score: float
-
-class PenetrationTester:
-    def __init__(self, target: str):
-        self.target = target
-        self.findings: List[Finding] = []
-
-    def test_sql_injection(self, url: str) -> None:
-// ... (see reference guides for full implementation)
-```
-
-## Reference Guides
-
-Detailed implementations in the `references/` directory:
-
-| Guide | Contents |
-|---|---|
-| [Automated Penetration Testing Framework](references/automated-penetration-testing-framework.md) | Automated Penetration Testing Framework |
-| [Burp Suite Automation Script](references/burp-suite-automation-script.md) | Burp Suite Automation Script |
-
-## Best Practices
-
-### ✅ DO
-
-- Get written authorization
-- Define clear scope
-- Use controlled environments
-- Document all findings
-- Follow responsible disclosure
-- Provide remediation guidance
-- Verify fixes after patching
-- Maintain chain of custody
-
-### ❌ DON'T
-
-- Test production without approval
-- Cause service disruption
-- Exfiltrate sensitive data
-- Share findings publicly
-- Exceed authorized scope
-- Use destructive payloads
+---
+name: penetration-testing
+description: >
+  Ethical hacking and security testing methodologies using penetration testing
+  tools, exploit frameworks, and manual security validation. Use when assessing
+  application security posture and identifying exploitable vulnerabilities.
+---
+
+# Penetration Testing
+
+## Table of Contents
+
+- [Overview](#overview)
+- [When to Use](#when-to-use)
+- [Quick Start](#quick-start)
+- [Reference Guides](#reference-guides)
+- [Best Practices](#best-practices)
+
+## Overview
+
+Systematic security testing to identify, exploit, and document vulnerabilities in applications, networks, and infrastructure through simulated attacks.
+
+## When to Use
+
+- Pre-production security validation
+- Annual security assessments
+- Compliance requirements (PCI-DSS, ISO 27001)
+- Post-incident security review
+- Third-party security audits
+- Red team exercises
+
+## Quick Start
+
+Minimal working example:
+
+```python
+# pentest_framework.py
+import requests
+import socket
+import subprocess
+import json
+from typing import List, Dict
+from dataclasses import dataclass, asdict
+from datetime import datetime
+
+@dataclass
+class Finding:
+    severity: str
+    category: str
+    target: str
+    vulnerability: str
+    evidence: str
+    remediation: str
+    cvss_score: float
+
+class PenetrationTester:
+    def __init__(self, target: str):
+        self.target = target
+        self.findings: List[Finding] = []
+
+    def test_sql_injection(self, url: str) -> None:
+// ... (see reference guides for full implementation)
+```
+
+## Reference Guides
+
+Detailed implementations in the `references/` directory:
+
+| Guide | Contents |
+|---|---|
+| [Automated Penetration Testing Framework](references/automated-penetration-testing-framework.md) | Automated Penetration Testing Framework |
+| [Burp Suite Automation Script](references/burp-suite-automation-script.md) | Burp Suite Automation Script |
+
+## Best Practices
+
+### ✅ DO
+
+- Get written authorization
+- Define clear scope
+- Use controlled environments
+- Document all findings
+- Follow responsible disclosure
+- Provide remediation guidance
+- Verify fixes after patching
+- Maintain chain of custody
+
+### ❌ DON'T
+
+- Test production without approval
+- Cause service disruption
+- Exfiltrate sensitive data
+- Share findings publicly
+- Exceed authorized scope
+- Use destructive payloads