Skip to content

vt-v-start

VMS session starter. Scans all work sources (intake pipeline, human actions, CWP state, review dates, git branch) and shows a prioritized summary of what to work on next. Run at the start of any IMS work session.

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

VMS Session Start

Run this at the beginning of any IMS work session to see what needs attention.

Process

  1. Determine paths:
  2. Vault root: the vault/ directory inside the V004 Handbuch repo
  3. Repo root: the V004 Handbuch repo root (contains .content-state.yaml)

  4. Default: REPOS_ROOT/03-VisiTrans/V004-VisiTrans Handbuch -dev

  5. Run the scanner: 

    python3 <skill_dir>/scripts/start_scanner.py "<vault_root>" "<repo_root>" --markdown
    If --verbose was passed as skill argument, also run with default JSON output and include individual item details.

  6. Present the scanner output directly — it produces a formatted status table and recommended actions.

  7. After presenting, ask the user which action they want to take. Offer the recommended actions as choices.

What the Scanner Checks

Source What Where
Git branch In-flight feature branch, commits ahead of main, open PR git commands in repo root
Intake: aktiv Approved vorschlaege being executed vault/aufgaben/aktiv/
Intake: bewertung Evaluated vorschlaege awaiting ISB decision vault/aufgaben/bewertung/
Intake: eingang New untriaged vorschlaege vault/aufgaben/eingang/
Human actions Pending manual decisions (HA-01..HA-05) .content-state.yaml
Overdue reviews Files with review_date in the past All vault *.md files
CWPs In-progress content work packages .content-state.yaml

Priority Order

The scanner applies this priority logic (P0 = most urgent):

Priority Condition Why
P0 Feature branch with commits, no PR Finish in-flight work first
P1 Items in aktiv/ Approved work already underway
P2 Items in bewertung/ ISB decision unblocks next steps
P3 Items in eingang/ Untriaged items need evaluation
P4 Pending human actions Require human decision
P5 Overdue review dates Compliance obligation
P6 CWPs in progress Partially done content work
P7 All clear Nothing actionable — suggest seeding new ideas

Integration

After presenting the status, hand off to the appropriate skill:

Situation Skill
Untriaged intake items /vt-v-intake evaluate --all then /vt-v-intake triage
Items awaiting ISB decision /vt-v-intake triage
Active approved items /vt-v-interview (interactive) or /vt-v-write (batch)
Pending human actions /vt-v-cwp human
Overdue reviews /vt-v-audit
In-progress CWPs /vt-v-cwp status
All clear /vt-v-intake seed or /vt-v-plan

Vault Paths

  • Vault root: <repo_root>/vault
  • Intake subfolders: vault/aufgaben/{eingang,bewertung,aktiv,archiv}/
  • State file: <repo_root>/.content-state.yaml
  • Triage dashboard: vault/dashboards/vorschlaege-triage.md