Skills
.Work. You
Rest

v-model-retrofit

Community

Retrofit V-model traceability for brownfield code

Software Engineering#code-quality#traceability#brownfield#retrofit#architecture-notes#v-model
Authorpkuppens
Version1.0.0
Installs0

System Documentation

What problem does it solve?

Brownfield codebases often lack V-model traceability, making changes risky and hard to audit. This skill provides two modes to retrofit traceability without a big-bang rewrite.

Core Features & Use Cases

  • Mode A — Explicit retrofit: Triggered by a dedicated issue; backfill traceability for a named scope; apply pairing sub-skills inside that scope; prefer small PRs; when inferring intent from legacy behavior, mark as human-reviewed.
  • Mode B — Touch-driven (incremental): Triggered by ordinary bugfix or feature work; optional label retrofit:incremental; map changes to acceptance criteria; add tests; document ADRs if needed; avoid large changes.
  • Relation to architecture Retrofitting: Architecture retrofitting mode answers what is; v-model-retrofit adds how we verify and links evidence to issues and artefacts.

Quick Start

Define the retrofit scope and initiate explicit V-model retrofit to backfill traceability in the target module.

Dependency Matrix

Required Modules

None required

Components

Standard package

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: v-model-retrofit
Download link: https://github.com/pkuppens/pkuppens/archive/main.zip#v-model-retrofit

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.