vibetags: Skill for Claude Code

Add an Annotation to VibeTags

Paths and class names below were derived from the codebase at v1.0.0-RC3 (the NewAnnotationsV5 wave — @AIIdempotent, @AIFeatureFlag, @AISecure — plus commit df01cb8, which fixed BuildFingerprint silently ignoring 12 annotation buckets and is why Step 5 below is not optional). If a path 404s, grep -rln "AISecure" vibetags/src/main/java from the repo root will re-locate every dispatch point this skill lists — @AISecure is the newest full annotation and touches every one of them.

Step 1 — Design the annotation

New file: vibetags-annotations/src/main/java/se/deversity/vibetags/annotations/AIYourName.java.

• @Retention(RetentionPolicy.SOURCE) always — zero runtime cost is a hard invariant of this library; nothing about the annotation may require CLASS or RUNTIME retention.
• @Target({...}) — pick from TYPE, METHOD, FIELD, PARAMETER to match the semantic (e.g. @AIInputSanitized/@AISecureLogging target PARAMETER, FIELD, not TYPE).
• String attributes default to "", never null — every consumption site checks .isBlank()/.isEmpty(), never a null-check.
• Enum-valued attributes get a nested enum inside the @interface with a sensible default constant (see AIThreadSafe.Strategy, AIExtensible.Strategy, AISecureLogging.MaskingPolicy).
• Class-valued attributes (AISunset.replacement) cannot be read below the model seam at all: calling them during annotation processing throws MirroredTypeException. Resolve the value once, in AnnotationCollector.record(...) — the only place the compiler is still in scope — and store it with builder.typeMember("AIYourName.attr", …). Consumption sites then read element.typeMember("AIYourName.attr", "<fallback>"). Copy the AISunset pattern; do not reintroduce a try/catch in a formatter or renderer, since ArchitectureRulesTest forbids javax.lang.model there and the catch would never fire anyway.
• Full Javadoc on the @interface and every attribute — docs/ANNOTATIONS.md's semantics bullet and the vibetags-usage skill's per-annotation section are meant to summarize it, not invent it.