Vibetags Usage

VibeTags Usage Guide

VibeTags is a compile-time Java annotation processor that generates AI platform-specific guardrail files from source annotations. Zero runtime overhead — all annotations have RetentionPolicy.SOURCE.

Quick Setup

1. Add the dependency

Maven (provided scope — compile-only):

<dependency>
    <groupId>se.deversity.vibetags</groupId>
    <artifactId>vibetags-processor</artifactId>
    <version>1.0.0-RC1</version>
    <scope>provided</scope>
</dependency>

Gradle:

compileOnly 'se.deversity.vibetags:vibetags-processor:1.0.0-RC1'
annotationProcessor 'se.deversity.vibetags:vibetags-processor:1.0.0-RC1'

2. Opt in to AI platforms (file-presence model)

VibeTags never creates files — it only updates files that already exist. Create empty placeholder files for each platform you want to support:

touch CLAUDE.md .claudeignore              # Claude / Claude Code
touch .cursorrules .cursorignore           # Cursor (traditional)
mkdir -p .cursor/rules                     # Cursor (granular per-class rules)
mkdir -p .trae/rules                       # Trae (granular per-class rules)
mkdir -p .roo/rules                        # Roo Code (per-class rules)
touch CONVENTIONS.md .aiderignore          # Aider
touch QWEN.md .qwenignore                  # Qwen
touch .aiexclude gemini_instructions.md GEMINI.md  # Gemini
touch AGENTS.md                            # Codex CLI
mkdir -p .github && touch .github/copilot-instructions.md .copilotignore  # Copilot
touch llms.txt llms-full.txt               # Windsurf Cascade / llms.txt standard
touch .windsurfrules                       # Windsurf IDE (traditional)
mkdir -p .windsurf/rules                   # Windsurf IDE (granular per-class rules)
touch .rules                               # Zed Editor
mkdir -p .cody && touch .cody/config.json .codyignore  # Sourcegraph Cody
touch .supermavenignore                    # Supermaven
mkdir -p .continue/rules                   # Continue (granular per-class rules)
mkdir -p .tabnine/guidelines               # Tabnine (granular per-class rules)
mkdir -p .amazonq/rules                    # Amazon Q (granular per-class rules)
mkdir -p .ai/rules                         # Universal AI standard (granular)
mkdir -p .pearai/rules                     # PearAI (granular per-class rules)
touch .mentatconfig.json                   # Mentat
touch sweep.yaml                           # Sweep (GitHub App)
touch .plandex.yaml                        # Plandex
touch .doubleignore                        # Double.bot
mkdir -p .interpreter/profiles && touch .interpreter/profiles/vibetags.yaml  # Open Interpreter
touch .codeiumignore                       # Codeium
touch GEMINI.md                            # Gemini (official markdown)
touch .antigravityignore                   # Antigravity AI
touch .clinerules                          # Cline AI assistant
mkdir -p .junie && touch .junie/guidelines.md  # JetBrains Junie
mkdir -p .kiro/steering                    # Amazon Kiro (granular per-class rules)
touch DESIGN.md                            # AI design agents (Cursor, Claude, Copilot, etc.)

To remove a platform: delete its file — VibeTags will never recreate it.

3. Annotate your Java code

import se.deversity.vibetags.annotations.*;

4. Compile — guardrails are generated automatically

mvn clean compile   # or: gradle clean build

Annotations Reference

@AILocked — Protect critical code from modification

Use on: class, method, field

@AILocked(reason = "Tied to legacy database schema v2.3. Any change breaks production payment flow.")
public interface PaymentProcessor {
    String processPayment(double amount, String currency, String merchantId);
}

When to use: legacy integrations, compliance-regulated code (PCI-DSS, HIPAA), algorithms that took months to stabilize.

@AIContext — Guide AI behavior for a class or method

Use on: class, method

@AIContext(
    focus = "Optimize for memory usage over CPU speed",
    avoids = "java.util.regex, String.split(), StringBuilder in loops"
)
public class StringParser { ... }

Use focus to tell AI what to optimize for; use avoids to list libraries, patterns, or constructs it should not introduce.

@AIDraft — Request an AI implementation

Use on: class, method

@AIDraft(instructions = "Implement email sending via SMTP and push notifications via FCM. Include retry logic and rate limiting.")
public class NotificationService {
    public void sendNotification(String userId, String message) {
        // AI implements this
    }
}

Tip: @AIDraft and @AILocked on the same element produce a compile-time warning — they are contradictory.

@AIAudit — Require continuous security auditing

Use on: class, method

@AIAudit(checkFor = {"SQL Injection", "Thread Safety issues", "Path Traversal"})
public class DatabaseConnector { ... }

Every time an AI tool modifies tagged code it must explicitly state it audited the changes for each listed vulnerability.

Common values for checkFor: "SQL Injection", "XSS", "CSRF", "Command Injection", "Thread Safety issues", "Insecure Deserialization", "Authentication Bypass".

Empty checkFor array produces a compile-time warning and is ignored.

@AIIgnore — Exclude from AI context entirely

Use on: class, method, field

@AIIgnore(reason = "Auto-generated at build time. Manual edits are overwritten on every build.")
public class GeneratedMetadata { ... }

Unlike @AILocked (visible but immutable), @AIIgnore tells AI to treat the element as if it does not exist. Use for: generated code, deprecated scaffolding, internal plumbing.

@AIPrivacy — Protect PII fields and methods

Use on: class, method, field

public class UserRepository {
    @AIPrivacy(reason = "GDPR - never log or include in error messages, test fixtures, or mock data")
    private final String email;

    @AIPrivacy(reason = "PCI-DSS - must not appear in logs, console output, or external API calls")
    private final String creditCardToken;
}

AI remains aware the element exists (for code assistance) but must never reproduce its runtime values in logs, suggestions, test fixtures, mock data, or external API calls.

Using @AIPrivacy together with @AIIgnore on the same element produces a compile-time warning (redundant — @AIIgnore already excludes the element).

@AICore — Mark sensitive core logic

Use on: class, method, field

@AICore(
    sensitivity = "Critical",
    note = "Core transaction engine. Well-tested. Changes require user approval."
)
public class TransactionEngine { ... }

Use sensitivity (default "High") to indicate impact level, and note to provide specific warnings. AI will treat changes with extreme caution and must not refactor without explicit approval.

@AIPerformance — Enforce complexity constraints

Use on: class, method

@AIPerformance(
    constraint = "Must maintain O(1) time complexity. No heap allocations."
)
public class FastBuffer { ... }

Informs AI that logic is on a hot-path and suboptimal complexity is unacceptable. AI must reason about time and space complexity before proposing changes.

@AIContract — Freeze a public API signature

Use on: class, method

@AIContract(reason = "Signature locked by OpenAPI v2 contract. checkout-service and mobile-app bind to this exact signature. A type change is a breaking API change.")
@AIPerformance(constraint = "Must complete in <5ms p99. Called on every cart update.")
public double calculatePrice(String productId, int quantity, String customerId) {
    // Internal logic may be freely changed
}

Tells AI: the method name, parameter types, parameter order, return type, and checked exceptions are frozen. Internal logic may be refactored freely. Use when:

• The method signature is pinned by an OpenAPI / AsyncAPI contract
• Other services bind to it via generated clients or message schemas
• Changing the signature requires a major-version bump and migration coordination

Unlike @AILocked (which prohibits all changes), @AIContract explicitly invites AI to improve internal logic — it only protects the public surface.

Compile-time warnings:

• @AIContract + @AIDraft on the same element — contradictory (signature is frozen, but @AIDraft implies the element still needs implementing)
• @AIContract + @AILocked on the same element — overlapping intent (@AILocked already prohibits all changes; consider using only @AILocked if no changes at all are intended)

@AITestDriven — Enforce a test-driven workflow

Use on: class, method

@AITestDriven(
    framework = {AITestDriven.Framework.JUNIT_5, AITestDriven.Framework.MOCKITO},
    coverageGoal = 90,
    mockPolicy = "Always mock external APIs and database calls",
    testLocation = "src/test/java/com/example/OrderServiceTest.java"
)
public class OrderService { ... }

Enforces a strict Red-Green-Refactor workflow: AI must include the corresponding test code in the same response as any proposed change. A change without matching tests is treated as incomplete.

Compile-time warnings:

• @AITestDriven + @AIIgnore on the same element — contradictory (@AIIgnore excludes the element from AI context entirely; @AITestDriven cannot enforce test coverage on an ignored element)
• @AITestDriven + @AILocked on the same element — contradictory (@AILocked prohibits all modifications; @AITestDriven permits changes only when tests are updated — consider using only @AILocked if no changes at all are intended)
• @AITestDriven with coverageGoal outside 0–100 — invalid value

@AIThreadSafe — Preserve a thread-safety strategy

Use on: class, method

@AIThreadSafe(
    strategy = AIThreadSafe.Strategy.LOCK_FREE,
    note = "All mutations go through ConcurrentHashMap; never introduce a synchronized block on the cache map."
)
public class SessionCache { ... }

Declares an existing thread-safety design that AI must not silently break. Different from @AIAudit(checkFor = "Thread Safety") (which asks the AI to look for new bugs).

Strategies: SYNCHRONIZED, LOCK_FREE, IMMUTABLE, THREAD_LOCAL, OTHER. Default SYNCHRONIZED.

When to use: caches and registries shared across threads, atomics-backed counters, singletons guarded by a named lock, per-thread context held in ThreadLocal.

@AIImmutable — Declare a class immutable

Use on: class

@AIImmutable(note = "Used by every test runner; safe to share across threads without copies.")
public final class AsyncTestConfig {
    private final int timeoutMs;
    public AsyncTestConfig(int timeoutMs) { this.timeoutMs = timeoutMs; }
}

Declares the type immutable so AI assistants will not introduce setters, mutating methods, or non-final fields. The processor warns at compile time when an @AIImmutable class declares a non-final, non-static instance field.

When to use: value objects, config holders, snapshots passed across thread boundaries, cache keys.

Compile-time warnings:

• @AIImmutable on a type with a non-final, non-static instance field — violates the immutability declaration
• @AIThreadSafe(IMMUTABLE) + @AIImmutable on the same type — redundant (@AIImmutable already implies thread-safety)

@AIDeprecated — Route callers toward a replacement

Use on: class, method, field

@AIDeprecated(
    replacedBy = "com.example.payment.PaymentProcessor",
    migrationGuide = "Switch callers to PaymentProcessor.charge(). The new API uses Money instead of double.",
    deadline = "v2.0 (2026-Q4)"
)
public class OldPaymentApi { ... }

Richer than Java's @Deprecated. Where @AILocked preserves an element, @AIDeprecated actively routes AI toward killing it — the AI is told to suggest migrating callers rather than extending the deprecated element.

When to use: legacy APIs being phased out, modules behind a sunset flag, methods kept only for backwards compatibility while callers migrate.

Compile-time warnings:

• @AIDeprecated + @AILocked on the same element — contradictory (locked preserves; deprecated routes callers away)

@AIObservability — Protect instrumentation

Use on: class, method

@AIObservability(
    metrics = {"orders.placed.total", "orders.placed.failed"},
    traces  = {"order.place"},
    logs    = {"OrderPlaced", "OrderPlacementFailed"},
    note    = "Watched by the Orders SLO dashboard."
)
public void recordOrderPlaced(String orderId, boolean success) { ... }

Marks code whose metrics, trace spans, or log statements downstream dashboards/alerts depend on. AI assistants must not silently remove or rename the listed instrumentation.

When to use: SLO emitters, audit-log writers, request handlers whose latency histograms feed an SLA, background workers whose failure metrics page on-call.

Compile-time warnings:

• @AIObservability with no metrics, traces, or logs — no-op (nothing to preserve)

@AIRegulation — Tie code to a compliance clause

Use on: class, method, field

@AIRegulation(
    standard = "GDPR",
    clause = "Art. 17",
    description = "Right to erasure — when invoked, deletes ALL PII for the given user across every connected store."
)
public class GdprService { ... }

Ties code to a specific regulatory clause (GDPR, PCI-DSS, HIPAA, SOX, …). Stronger than @AIAudit because it names the exact article — AI assistants must document compliance impact for every change and must not weaken the requirement.

When to use: GDPR Art. 17 / Art. 20 implementations, PCI-DSS card-handling code, HIPAA-protected PHI read/write paths, SOX-relevant financial reporting and audit-log writers.

Compile-time warnings:

• @AIRegulation with a blank standard — required attribute missing

@AIArchitecture — Enforce architectural layer boundaries

Use on: class

@AIArchitecture(
    belongsTo = "domain",
    cannotReference = {"infrastructure", "web"}
)
public class OrderService { ... }

Declares which architectural layer this class belongs to and which layers it must never import from. AI must not introduce references to forbidden layers — e.g., a domain class importing a JPA repository or an HTTP controller.

@AILegacyBridge — Protect compatibility bridges from modernization

Use on: class, method

@AILegacyBridge
public class LegacyPaymentAdapter {
    // Works around a quirk in the v1 payment provider SDK — must not be "cleaned up"
    public String formatAmount(double amount) { ... }
}

Marks code that exists solely to bridge to a legacy or upstream system with known quirks or bugs. AI must not modernize the structure, apply new patterns, or remove the "ugly" parts — they exist for a reason. Internal business logic may still be changed.

When to use: SDK adapter shims, workarounds for upstream library bugs, compatibility wrappers kept alive for old API clients.

@AIStrictClasspath — Prevent dynamic loading and reflection hacks

Use on: class, method

@AIStrictClasspath
public class DataParser {
    // Must only use JDK and existing compile-time classpath — no runtime class loading
}

Prohibits AI from introducing dynamic class loading, custom ClassLoaders, runtime reflection tricks, or execution of dynamically constructed code. All dependencies must be resolvable at compile time from the existing classpath.

When to use: security-sensitive execution environments, GraalVM native-image targets, OSGi modules, any code that must be fully AOT-analyzable.

@AIInternationalized — Prohibit hardcoded user-facing strings

Use on: class, method

@AIInternationalized
public class NotificationTemplateRenderer {
    // All user-visible text must come from message bundles — never hardcoded
}

Instructs AI that all user-visible text (labels, messages, error strings, button text) must be resolved through the project's i18n framework (e.g., MessageSource, ResourceBundle, gettext). AI must never introduce hardcoded string literals for anything a user would see.

When to use: UI components, REST error responses, email templates, notification services — any code whose output reaches end users.

@AIPublicAPI — Preserve backward compatibility

Use on: class, method

@AIPublicAPI
public class ProductSearchClient {
    public List<Product> search(String query, int maxResults) { ... }
}

Declares that this element is part of a public API surface. All AI changes must be additive and backward-compatible — renaming methods, changing parameter types, or altering serialization formats is forbidden. Internal implementation may be improved freely.

Unlike @AIContract (which freezes one specific signature), @AIPublicAPI applies the backward-compatibility rule to the entire class.

When to use: SDK entry points, REST controller response shapes, message schema classes, library interfaces consumed by third parties.

@AISchemaSafe — Prevent destructive schema changes

Use on: class, field

@AISchemaSafe
@Entity
public class UserEntity {
    @Column(name = "email", nullable = false)
    private String email;
}

Instructs AI that this class or field maps to persistent storage (database, message schema, serialization format). Destructive changes — dropping columns, renaming fields, changing types — are forbidden without explicit backward-compatible migrations. AI must propose additive-only changes.

When to use: JPA/Hibernate entities, Avro/Protobuf schema classes, JSON serialization DTOs, Flyway-managed tables.

@AIStrictExceptions — Enforce precise error handling

Use on: class, method

@AIStrictExceptions
public class PaymentGatewayClient {
    public Receipt charge(Money amount) throws PaymentDeclinedException { ... }
}

Prohibits AI from catching or throwing Exception, Throwable, or other overly broad types. All exceptions must be specific, well-named, and carry descriptive messages with preserved stack traces. Silent catch blocks (catch (Exception e) {}) are also forbidden.

When to use: external integrations, retry boundaries, error-handling layers, code that feeds into structured logging or alerting.

@AIStrictTypes — Require precise domain types

Use on: class, method, field

@AIStrictTypes
public class PricingCalculator {
    // Use BigDecimal for money, Instant/ZonedDateTime for time — never double or String
    public BigDecimal calculateDiscount(Money basePrice, Percentage rate) { ... }
}

Instructs AI to avoid loose types (Object, raw collections, Map<String, Object>, double for currency, String for dates) and instead use well-defined, type-safe domain models or strongly-typed transfer objects.

When to use: financial calculations, time/date handling, any domain model where type safety prevents silent data corruption.

@AIParallelTests — Enforce test isolation for concurrent execution

Use on: class, method

@AIParallelTests
public class OrderServiceTest {
    // Tests must not share mutable state or bind to fixed ports
}

Instructs AI that any generated or modified tests for this element must be safe for parallel execution. Forbidden: shared mutable static state, fixed port bindings, database rows with hard-coded IDs, execution-order dependencies. Each test must be fully self-contained.

When to use: test classes run under JUnit 5 parallel execution, @Isolated test suites, any test module with forkCount > 1 in Maven Surefire.

@AIIdempotent — Declare an operation must be idempotent

Use on: class, method

@AIIdempotent(reason = "Called by the retry scheduler — multiple invocations must produce the same result.")
public void processOrder(String orderId) {
    // Must tolerate repeated calls without double-processing
}

Declares that the annotated operation is expected to be idempotent. AI must not introduce side effects that cause repeated calls to produce different results (e.g., double-inserts, repeated external API calls without deduplication, counter increments on every call).

When to use: retry handlers, message consumers, webhook processors, payment captures, any operation exposed to at-least-once delivery.

Compile-time warnings:

• @AIIdempotent + @AIDraft on the same element — contradictory (idempotent declares a stable contract while draft marks the element as unfinished)

@AIFeatureFlag — Mark code gated behind a feature flag

Use on: class, method, field

@AIFeatureFlag(flag = "checkout.new-flow", defaultValue = false)
public void processNewCheckout(Cart cart) {
    // Only active when the 'checkout.new-flow' flag is enabled
}

Tells AI that the annotated element is gated behind a runtime feature flag. AI must preserve the flag check and must never assume the flag is always active (or always inactive). Removing the conditional guard, inlining the true branch, or hardcoding the default is forbidden.

When to use: A/B experiments, gradual rollouts, kill switches, beta features, dark launches.

Compile-time warnings:

• @AIFeatureFlag + @AILocked on the same element — contradictory (locked freezes code while feature flag implies conditional execution)
• @AIFeatureFlag with blank flag — no-op; the flag key is unspecified

@AISecure — Mark security-critical code

Use on: class, method

@AISecure(aspect = "authentication")
public class JwtTokenValidator {
    // Any change here must be reviewed for security implications
    public boolean validate(String token) { ... }
}

Declares that the annotated element implements a security-critical concern (e.g., authentication, encryption, authorization, session management, input sanitization). AI must not weaken security properties and must explicitly flag any proposed change for security review.

When to use: JWT/OAuth token handling, cryptographic operations, authorization checks, session management, input validation against injection attacks, any code whose weakening would create a security vulnerability.

Compile-time warnings:

• @AISecure with blank aspect — advisory; consider specifying the security concern (e.g. "authentication", "encryption")
• @AISecure + @AIIgnore on the same element — contradictory; @AIIgnore hides the element but @AISecure requires AI visibility for security review

@AICallersOnly — Restrict allowed invoking callers

Use on: class, method

@AICallersOnly({"com.example.service.PricingService", "com.example.payment.PaymentProcessor"})
public static void executeSecureDatabaseWipe() { ... }

Restricts which packages or classes are permitted to invoke this method or class. Enforced by the compiler/processor to prevent AI from introducing illegal architectural bypasses.

@AISandboxOnly — Restrict to mock or sandbox environments

Use on: class, method

@AISandboxOnly
public class SandboxTestHelper { ... }

Restricts the target element strictly to sandbox, dev, or mock/test environments. Prevents the AI from importing or referencing sandbox utilities in production pathways.

Compile-time warnings:

• @AISandboxOnly + @AIDomainModel on the same element — contradictory (sandbox mocks should not be subjected to framework-free domain model constraints)

@AIMemoryBudget — Enforce strict allocation policies

Use on: class, method

@AIMemoryBudget(AIMemoryBudget.AllocationPolicy.ZERO_ALLOCATION)
public static int calculateFastFibonacci(int n) { ... }

Restricts heap allocations, autoboxing, or object instantiation inside high-performance critical sections.

Allocation Policies: ZERO_ALLOCATION, NO_AUTOBOXING, NO_NEW_OBJECTS.

@AIPure — Mark side-effect-free pure mathematical functions

Use on: method

@AIPure
public static int add(int a, int b) { return a + b; }

Declares that a method is a pure mathematical function. Must be deterministic (same input leads to same output) and have zero side effects.

@AIDomainModel — Enforce Domain-Driven Design boundaries

Use on: class

@AIDomainModel(allow = {"java.math.BigDecimal"})
public class ImmutableProductPrice { ... }

Enforces DDD boundaries by preventing external/framework imports. The compiler will scan and block any imports from Spring, JPA/Hibernate, Jackson, etc. unless explicitly whitelisted.

@AIExtensible — Mark open-closed polymorphic extension hooks

Use on: class

@AIExtensible(AIExtensible.Strategy.STRATEGY_PATTERN)
public interface TaxCalculatorStrategy { ... }

Signals that a class or interface must be extended using polymorphic designs (Open-Closed Principle). Prompts the AI to introduce strategy or visitor patterns rather than accumulating massive conditional/switch statements.

Strategies: STRATEGY_PATTERN, VISITOR_PATTERN, FACTORY.

@AIInputSanitized — Enforce input parameter sanitization

Use on: parameter, field

public static void executeDatabaseQuery(
        @AIInputSanitized({AIInputSanitized.SanitizerType.SQL_INJECTION}) String sqlRawInput) { ... }

Enforces sanitization pipelines on input parameters or fields before they reach queries, HTML renderers, or files.

Sanitizer Types: SQL_INJECTION, XSS, PATH_TRAVERSAL, LDAP.

@AISecureLogging — Mask sensitive variables in log statements

Use on: field, parameter

public static void registerUserSession(
        String username,
        @AISecureLogging(AISecureLogging.MaskingPolicy.HASH) String passwordRaw) { ... }

Protects sensitive variables from being logged directly or leaked in console outputs.

Masking Policies: OMIT, HASH, MASK_CREDIT_CARD, MASK_EMAIL.

Compile-time warnings:

• @AISecureLogging + @AIIgnore on the same element — redundant (@AIIgnore already completely excludes the element)

@AIExplain — Require Chain-of-Thought mathematical/architectural explanations

Use on: class, method

@AIExplain(AIExplain.ComplexityLevel.HIGH)
public static double runComplexMatrixMath(double[][] a, double[][] b) { ... }

Enforces step-by-step mathematical/architectural Chain-of-Thought (CoT) explanations of any modifications.

Complexity Levels: HIGH, MEDIUM, LOW.

@AIPrototype — Declare rapid disposable spikes

Use on: class

@AIPrototype
public class DraftKafkaIntegrationSpike { ... }

Declares a rapid framework prototype. Relaxes standard strict quality rules (e.g. required i18n, coverage) within the class, but prevents it from leaking into stable production code.

@AISunset — Ultra-strict api sunset deprecation guardrail

Use on: class, method, field

@AISunset(replacement = PricingService.class, jira = "DEBT-742")
public static double deprecatedLegacyCalculatePrice(double basePrice) { ... }

AI models are strictly prohibited from adding any new references/calls to elements annotated with @AISunset.

Compile-time warnings:

• @AISunset + @AIDraft on the same element — contradictory (sunset elements must not be actively drafted or expanded)
• @AISunset with blank jira — missing required JIRA issue key warning

@AITemporary — Warn or block expired temporary logic and hotfixes

Use on: class, method

@AITemporary(expiresOn = "2028-12-31", reason = "Hotfix workaround until upstream updates their API.")
public static void temporaryUpstreamBypass() { ... }

Hard stop for hotfixes, temporary stubs, or quick hacks. Warns or fails compilation once the local clock date exceeds the expiration date.

Compile-time warnings:

• @AITemporary with a blank expiresOn — missing required expiration date
• @AITemporary with an invalid expiresOn format (not YYYY-MM-DD)
• @AITemporary where local date is after expiresOn — expired logic warning

Annotation Combinations

Granular Rules

When the granular rule directories exist, VibeTags generates one rule file per annotated class instead of a single monolithic config file. Each rule file is automatically scoped to its class (e.g., **/OrderService.java). Orphaned files for classes that lose their annotations are cleaned up automatically.

Enable by creating the directories:

mkdir -p .cursor/rules .windsurf/rules .trae/rules .roo/rules
mkdir -p .continue/rules .tabnine/guidelines .amazonq/rules .ai/rules .pearai/rules
mkdir -p .kiro/steering

Advanced Configuration

Processor options (Maven)

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-compiler-plugin</artifactId>
    <configuration>
        <compilerArgs>
            <!-- Set project name in llms.txt / llms-full.txt H1 -->
            <arg>-Avibetags.project=MyProjectName</arg>
            <!-- Custom log path (relative to project root or absolute) -->
            <arg>-Avibetags.log.path=logs/vibetags.log</arg>
            <!-- Log level: TRACE, DEBUG, INFO, WARN, ERROR, OFF -->
            <arg>-Avibetags.log.level=DEBUG</arg>
            <!-- Override output root directory -->
            <arg>-Avibetags.root=/path/to/output</arg>
        </compilerArgs>
    </configuration>
</plugin>

Processor options (Gradle)

tasks.withType(JavaCompile) {
    options.compilerArgs += [
        '-Avibetags.project=MyProjectName',
        '-Avibetags.log.path=logs/vibetags.log',
        '-Avibetags.log.level=DEBUG'
    ]
}

Diagnosing Issues

…(truncated)