Skip to content

vt-v-draft

Step 3 of the VMS CWP workflow. Routes between interactive (interview) and batch (write) drafting modes. Tracks per-file progress, writes checkpoints at batch boundaries, and supports session resume after /clear. Use with --cwp CWP-NN.

Plugin: vms
Category: Other
Command: /vt-v-draft

VMS Content Draft — Step 3 of 5

This skill is the drafting step in the numbered CWP workflow. It routes to either interactive interview mode or batch write mode, tracks per-file progress in .content-state.yaml, and writes checkpoints to enable session resume.

Process

Entry

  1. Display step banner: 

    ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 Step 3 of 5 — DRAFT              CWP-NN
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  2. Read .content-state.yaml for the CWP's file_progress map.

  3. Check for checkpoint: Read .cwp-checkpoint.yaml — if it exists and matches the CWP:

  4. Display: "Checkpoint found. Resuming from file M/N (last: [filename])."
  5. Offer: "Resume from checkpoint? (Ja / Nein, von vorne)"

  6. If resume: set batch_cursor from checkpoint

  7. Soft gate check: Read .cwp-plan-gate.yaml

  8. If missing: warn "Plan gate not found. Run Step 2 (/vt-v-plan --cwp CWP-NN) first."
  9. Allow override: "Trotzdem fortfahren? (Ja / Nein)"

  10. If CWP mismatch: warn but allow

  11. Show progress summary: 

    CWP-06: ISO 27001 A.7 Physische (14 files, batch 14)
─────────────────────────────────────────
Pending:    7 files
Drafted:    5 files
Reviewed:   2 files
Approved:   0 files
Escalated:  0 files
─────────────────────────────────────────

  12. Ask mode:

    Wie moechtest du die verbleibenden Dateien bearbeiten? - Interaktiv — Q&A pro Datei (/vt-v-interview) - Batch — Automatische Anreicherung (/vt-v-write)

Interactive Mode (via /vt-v-interview)

  1. Filter file_progress to status: pending files
  2. Present the first pending file:

    "Datei 1/7: vault/ISMSI/04/A.7.1.md — skeleton (0.8 KB)"

  3. Invoke /vt-v-interview with the file path
  4. After the interview completes and file is written:
  5. Update file_progress[file].status: drafted
  6. Update file_progress[file].drafted_at: <timestamp>
  7. Increment progress.files_written
  8. Checkpoint check — after every 5 files:
  9. Write .cwp-checkpoint.yaml with current position
  10. Display: 
    Checkpoint gespeichert (5/14 Dateien).
Bei grossen CWPs empfehlen wir /clear und dann
/vt-v-draft --cwp CWP-06 zum Fortsetzen.
  11. Ask: "Weiter mit der naechsten Datei? (Ja / Pause)"
  12. Present next pending file and repeat
  13. When user pauses or all files done → go to Exit

Batch Mode (via /vt-v-write)

  1. Filter file_progress to status: pending files
  2. Group files into batches using the CWP's batch_size
  3. For each batch: a. Invoke /vt-v-write with the batch file paths b. After each file write:
    • Update file_progress[file].status: drafted
    • Update file_progress[file].drafted_at: <timestamp>
    • Update file_progress[file].batch: <batch_number>
    • Increment progress.files_written c. After batch completes:
    • Run /vt-v-audit --changed to validate the batch
    • Write .cwp-checkpoint.yaml
    • Display batch summary and audit results d. Ask: "Naechsten Batch starten? (Ja / Pause)"
  4. When user pauses or all batches done → go to Exit

Exit

  1. Update .content-state.yaml:
  2. Set phase: draft (if not already)
  3. Update progress.files_written count
  4. Show final progress summary
  5. If all files drafted: 
    Alle 14 Dateien entworfen.
Next → Step 4: /vt-v-review --cwp CWP-NN
  6. If paused (files remaining):
  7. Write .cwp-checkpoint.yaml with current position 
    Fortschritt gespeichert (7/14 Dateien).
Zum Fortsetzen: /vt-v-draft --cwp CWP-NN

Checkpoint Schema

Written to V004 repo root as .cwp-checkpoint.yaml. See references/gate-schemas.md for full schema.

Key fields: - cwp — CWP ID - step — always 3 for this skill - phase — always draft - batch_cursor — index of next unprocessed file - files_processed / files_remaining - next_command — /vt-v-draft --cwp CWP-NN

When to Recommend /clear

  • After 5 files in interactive mode (each interview consumes significant context)
  • After each batch in batch mode
  • When CWP has >20 total files (context will fill during one session)

Integration

What Skill
Previous step Step 2: /vt-v-plan --cwp CWP-NN
Interactive drafting /vt-v-interview (invoked with file path)
Batch drafting /vt-v-write (invoked with file paths)
Post-batch validation /vt-v-audit --changed
Next step Step 4: /vt-v-review --cwp CWP-NN
Session resume /vt-v-start detects checkpoint as P0