pkuppens/v-model-retrofit
skills/v-model/v-model-retrofit/SKILL.md
Applies V-model traceability to brownfield codebases via explicit retrofit issues or touch-driven updates during normal work. Use when the system was built without a closed V. Third person.
development
Updated Apr 17, 2026
$ install --global
skillsauthnpx skillsauth add pkuppens/pkuppens v-model-retrofitInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 17, 2026, 7:59 AM6.1s1 file scanned
SKILL.md
- name:
- v-model-retrofit
- description:
- Applies V-model traceability to brownfield codebases via explicit retrofit issues or touch-driven updates during normal work. Use when the system was built without a closed V. Third person.
V-model retrofit (brownfield)
Most code never had a perfect left/right V. This skill defines two modes so agents do not imply a big-bang rewrite.
Mode A — Explicit retrofit
Trigger: User request or a dedicated issue (label retrofit:explicit).
Goal: Backfill traceability for a named scope (module, bounded context, feature area).
Steps:
- Understand as-built state: architecture-document-existing, architecture-consult as needed.
- Scope with issue-work-down; define acceptance criteria for the retrofit (e.g. “ADRs for boundaries X/Y”, “integration tests for API Z”).
- Apply pairing sub-skills (v-model) inside that scope only; prefer small PRs.
- When inferring intent from legacy behaviour, treat conclusions as human-review or human-required — do not silently elevate guesses to requirements. See _meta/human-ai-execution.md.
Mode B — Touch-driven (incremental)
Trigger: Ordinary bugfix or feature work; label retrofit:incremental optional.
Goal: Strengthen the V only for surfaces touched by this change unless the user widens scope.
Steps:
- Map the change to the issue acceptance criteria (issue-acceptance-criteria).
- Add or adjust tests proving the AC for this change (validation-draft, test-write).
- If the change invalidates an undocumented assumption, add the smallest helpful ADR or architecture note (architecture-decisions or consult) — do not document the entire system because one helper changed.
- If the touch reveals a large gap, comment on the issue or open a follow-up; do not silently expand scope.
Relation to architecture Retrofitting
Architecture Retrofitting mode answers what is. v-model-retrofit adds how we verify it and links evidence to issues and artefacts.
Related
- plan — optional V-model note during implementation planning
- v-model-mapping
Related Skills
pkuppens/sync-branch
testing
VerifiedTrustedCommunity
Syncs remote default branch locally (checkout, fetch --prune, pull) and returns to the previous branch when it still exists. Reports stashes and worktrees not yet handled. Use when the user asks to sync main, update default branch, fetch/pull origin, or run /sync-branch.
SKILL.mdUpdated Jun 6, 2026
pkuppens/azure-devops-work-items
tools
VerifiedTrustedCommunity
Creates, queries, updates, and links Azure Boards work items via az boards CLI. Use when filing ADO work items, running WIQL queries, or setting area path, iteration, tags, and assignee.
SKILL.mdUpdated May 29, 2026
pkuppens/azure-devops-repos
tools
VerifiedTrustedCommunity
Creates, reviews, and completes Azure Repos pull requests and branch policies via az repos CLI. Use when opening ADO PRs, setting required reviewers, or configuring build validation policies.
SKILL.mdUpdated May 29, 2026
pkuppens/azure-devops-pipelines
development
VerifiedTrustedCommunity
Guides Azure Pipelines YAML structure, build validation on PRs, and staged deployment with environments and approvals. Use when authoring azure-pipelines.yml or configuring CI/CD on Azure DevOps.
SKILL.mdUpdated May 29, 2026