[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6ACZ58HRBZAY0EM8NTBSMZB":3,"skill-same:01M6ACZ58HRBZAY0EM8NTBSMZB":986},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":23,"publishedAt":29,"linkOnly":30,"markdownContent":31,"markdownBody":32,"frontMatter":33,"refName":36,"commitSha":37,"skillDirectory":38,"forksCount":39,"repositoryHtmlUrl":40,"repositoryHomepageUrl":41,"ownerHtmlUrl":42,"ownerBlogUrl":43,"ownerDescription":6,"updatedAt":44,"install":45,"resources":57},"01M6ACZ58HRBZAY0EM8NTBSMZB","new-plugin",null,"Develop a new SkyWalking Java agent plugin — instrumentation, interceptor, tracing\u002Fmeter, tests, and all boilerplate","apache\u002Fskywalking-java","apache","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F47359?v=4","01M6AC83E6K4FDKK7HZ8WNMQKE","The Apache Software Foundation","01M6ACYZ6PKW201HRNNKQAZBTR",928,"Apache-2.0","https:\u002F\u002Fgithub.com\u002Fapache\u002Fskywalking-java\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fnew-plugin\u002FSKILL.md",[18],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000023","Skill与智能体开发","SCENARIO","使用场景",[24,25,26,27,28],"plugin","new plugin","skywalking","java","tracing","2026-11-10 10:12:30",false,"---\nname: new-plugin\ndescription: Develop a new SkyWalking Java agent plugin — instrumentation, interceptor, tracing\u002Fmeter, tests, and all boilerplate\nuser-invocable: true\nallowed-tools: Read, Write, Edit, Glob, Grep, Bash, Agent\n---\n\n# SkyWalking Java Agent Plugin Development\n\nDevelop a new plugin for the Apache SkyWalking Java Agent. Ask the user what library\u002Fframework to instrument and what to observe (tracing, metrics, or both), then generate all required files.\n\n## Step 0 - Gather Requirements\n\nAsk the user:\n1. **Target library\u002Fframework** and version range (e.g., \"Jedis 3.x-4.x\", \"Spring Kafka 2.7+\")\n2. **Observation type**: tracing plugin, meter plugin, or both\n3. **Plugin category**: SDK plugin (default), bootstrap plugin, or optional plugin\n4. **Span type needed**: Entry (server\u002Fconsumer), Exit (client\u002Fproducer), Local (internal), or combination\n\nIf the user already provided this info, skip asking.\n\n## Step 1 - Understand the Library and Identify Interception Points\n\nThis is the most critical step. Do NOT jump to picking method names. Follow these phases in order.\n\n### Phase 1: Understand How the Library Is Used\n\nRead the target library's documentation, quickstart guides, or sample code. Understand the **user-facing API** — how developers create clients, make calls, and handle responses. This tells you:\n- What objects are long-lived (clients, connections, pools) vs. per-request (requests, commands)\n- Where configuration lives (server address, credentials, timeouts)\n- Whether the library is sync, async, or reactive\n- Whether it uses callbacks, futures, or blocking calls\n\nExample thought process for a Redis client:\n```\nUser creates: RedisClient client = RedisClient.create(\"redis:\u002F\u002Flocalhost:6379\");\nUser connects: StatefulRedisConnection conn = client.connect();\nUser executes: conn.sync().get(\"key\");  \u002F\u002F or conn.async().get(\"key\")\n```\nThis tells you: connection holds the server address, commands are executed on the connection.\n\n### Phase 2: Trace the Execution Flow\n\nStarting from the user-facing API, trace inward through the library source code to understand the execution workflow:\n1. What happens when the user calls the API method?\n2. Where does the request object get built?\n3. Where is the actual network I\u002FO or dispatch?\n4. Where is the response available?\n5. For RPC\u002FMQ: where are headers\u002Fmetadata accessible for inject\u002Fextract?\n\n**Key question at each point:** What data is directly accessible as method arguments, return values, or fields on `this`? You want interception points where you can read the data you need **without reflection**.\n\n### Phase 3: Choose Interception Points\n\nPick interception points based on these principles:\n\n**Principle 1: Data accessibility without reflection.**\nChoose methods where the information you need (peer address, operation name, request\u002Fresponse details, headers for inject\u002Fextract) is directly available as method arguments, return values, or accessible through the `this` object's public API. **Never use reflection to read private fields.** If the data is not accessible at one method, look at a different point in the execution flow.\n\nIf the target class is **package-private** (e.g., `final class` without `public`), you cannot import or cast to it. **Same-package helper classes do NOT work** because the agent and application use different classloaders — Java treats them as different runtime packages even with the same package name (`IllegalAccessError`). Use `setAccessible` reflection to call public methods:\n```java\ntry {\n    java.lang.reflect.Method method = objInst.getClass().getMethod(\"publicMethodName\");\n    method.setAccessible(true);  \u002F\u002F Required for package-private class\n    Object result = method.invoke(objInst);\n} catch (Exception e) {\n    LOGGER.warn(\"Failed to access method\", e);\n}\n```\n\n**Principle 2: Use `EnhancedInstance` dynamic field to propagate context inside the library.**\nThis is the primary mechanism for passing data between interception points. The agent adds a dynamic field to every enhanced class via `EnhancedInstance`. Use it to:\n- Store server address (peer) at connection\u002Fclient creation time, retrieve it at command execution time\n- Store request info at request-build time, retrieve it at send time\n- Pass span references from the initiating method to the completion callback\n\n**Do NOT use `Map` or other caches to store per-instance context.** Always use the dynamic field on the relevant `EnhancedInstance`. Maps introduce memory leaks, concurrency issues, and are slower than the direct field access that `EnhancedInstance` provides.\n\n**Principle 3: Intercept the minimal set of methods.**\nPrefer one well-chosen interception point over many surface-level ones. If a library has 20 command methods that all flow through a single `dispatch()` method internally, intercept `dispatch()` — not all 20.\n\n**Principle 4: Pick points where you can do inject\u002Fextract for cross-process propagation.**\nFor RPC\u002FHTTP\u002FMQ plugins, you need to inject trace context into outgoing requests (ExitSpan) or extract from incoming requests (EntrySpan). The interception point MUST be where headers\u002Fmetadata are writable (inject) or readable (extract). If headers are not accessible at the execution method, look for:\n- A request builder\u002Fdecorator stage where headers can be added\n- A channel\u002Ftransport layer where metadata is attached\n- A message properties object accessible from the method arguments\n\n**Principle 5: Consider the span lifecycle across threads.**\nIf the library dispatches work asynchronously:\n- Identify where the work is submitted (original thread) and where the result arrives (callback\u002Ffuture thread)\n- You may need interception points in both threads\n- Use `EnhancedInstance` dynamic field on the task\u002Fcallback\u002Ffuture object to carry the span or `ContextSnapshot` across the thread boundary\n- Use `prepareForAsync()` \u002F `asyncFinish()` if the span must stay open across threads\n\n### Phase 4: Map Out the Interception Plan\n\nBefore writing code, create a clear plan listing:\n\n| Target Class | Method\u002FConstructor | What to Do | Data Available |\n|---|---|---|---|\n| `XxxClient` | constructor | Store peer address in dynamic field | host, port from args |\n| `XxxConnection` | `execute(Command)` | Create ExitSpan, inject carrier into command headers | command name, peer from dynamic field |\n| `XxxResponseHandler` | `onComplete(Response)` | Set response tags, stop span or asyncFinish | status code, error from args |\n\nFor each interception point, verify:\n- [ ] The data I need is readable from method args, `this`, or `EnhancedInstance` dynamic field — no reflection needed\n- [ ] For inject: I can write headers\u002Fmetadata through a public API on a method argument\n- [ ] For extract: I can read headers\u002Fmetadata through a public API on a method argument\n- [ ] The `this` object (or a method argument) will be enhanced as `EnhancedInstance`, so I can use the dynamic field\n\n### Choosing Span Type\n\n| Scenario | Span Type | Requires |\n|----------|-----------|----------|\n| Receiving requests (HTTP server, MQ consumer, RPC provider) | EntrySpan | Extract ContextCarrier from incoming headers |\n| Making outgoing calls (HTTP client, DB, cache, MQ producer, RPC consumer) | ExitSpan | Peer address; inject ContextCarrier into outgoing headers (for RPC\u002FHTTP\u002FMQ) |\n| Internal processing (annotation-driven, local logic) | LocalSpan | Nothing extra |\n\n### For Meter Plugins\n\nMeter plugins follow the same understand-then-intercept process, but the goal is to find objects that expose numeric state:\n- **Gauges**: Intercept the creation of pool\u002Fexecutor\u002Fconnection-manager objects. Register a `MeterFactory.gauge()` with a supplier lambda that calls the object's own getter methods (e.g., `pool.getActiveCount()`). Store the gauge reference in the dynamic field if needed.\n- **Counters**: Intercept execution methods and call `counter.increment()` on each invocation.\n- **Histograms**: Intercept methods where duration or size is computable (measure between before\u002Fafter, or read from response).\n\n### Check Existing Plugins for Reference\n\nBefore writing a new plugin, check if a similar library already has a plugin:\n```\napm-sniffer\u002Fapm-sdk-plugin\u002F          # 70+ standard plugins\napm-sniffer\u002Foptional-plugins\u002F         # Optional plugins\napm-sniffer\u002Fbootstrap-plugins\u002F        # JDK-level plugins\n```\n\nSimilar libraries often share execution patterns. Study how an existing plugin for a similar library solved the same problems — especially how it chains dynamic fields across multiple interception points and where it does inject\u002Fextract.\n\n### Verify Against Actual Source Code — Never Speculate\n\n**This applies to both new plugin development AND extending existing plugins to newer library versions.**\n\nWhen assessing whether a plugin works with a new library version, or when choosing interception points for a new plugin, you MUST read the **actual source code** of the target library at the specific version. Do NOT rely on:\n- Version number assumptions (\"it's still 4.x so it should be compatible\")\n- Changelog summaries (they don't list every internal class rename or method removal)\n- General knowledge about the library's public API (plugins intercept internal classes, which change without notice)\n\n**What to verify for each intercepted class\u002Fmethod:**\n1. Does the target class still exist at the exact FQCN? (internal classes get renamed, extracted, or removed between minor versions)\n2. Does the intercepted method still exist with a compatible signature? (parameters may be added\u002Fremoved\u002Freordered)\n3. Do the witness classes still correctly distinguish versions? (a witness class that exists in both old and new versions won't prevent the plugin from loading on an incompatible version)\n4. Do the runtime APIs called by the interceptor still exist? (e.g., calling `cluster.getDescription()` will crash if that method was removed, even if the plugin loaded successfully)\n\n**How to verify — clone the library source locally:**\n```bash\n# Clone specific version tag to \u002Ftmp for easy source code inspection\ncd \u002Ftmp && git clone --depth 1 --branch {tag} https:\u002F\u002Fgithub.com\u002F{org}\u002F{repo}.git {local-name}\n\n# Examples:\ngit clone --depth 1 --branch r4.9.0 https:\u002F\u002Fgithub.com\u002Fmongodb\u002Fmongo-java-driver.git mongo-4.9\ngit clone --depth 1 --branch v2.4.13.RELEASE https:\u002F\u002Fgithub.com\u002Fspring-projects\u002Fspring-kafka.git spring-kafka-2.4\n\n# Then grep\u002Fread the actual source files to check class\u002Fmethod existence\ngrep -rn \"getFilter\\|getWriteRequests\" \u002Ftmp\u002Fmongo-4.9\u002Fdriver-core\u002Fsrc\u002Fmain\u002Fcom\u002Fmongodb\u002Finternal\u002Foperation\u002F\n```\n\nThis is faster and more reliable than fetching individual files via raw GitHub URLs. You can `grep`, `diff` between versions, and trace the full execution path.\n\n**Also check for import-time class loading failures:**\nIf a plugin helper class (not just the instrumentation class) imports a library class that was removed, the entire helper class will fail to load with `NoClassDefFoundError` at runtime. This silently breaks ALL functionality in that helper — not just the code paths using the removed class. Verify that every `import` statement in plugin support classes resolves to an existing class in the target version.\n\n**Real examples of why this matters:**\n- MongoDB driver 4.9 removed `InsertOperation`, `DeleteOperation`, `UpdateOperation` — `MongoOperationHelper` imported all three, causing the entire class to fail loading with `NoClassDefFoundError`, silently losing ALL `db.bind_vars` tags even for operations that still exist (like `FindOperation`, `AggregateOperation`)\n- MongoDB driver 4.11 removed `Cluster.getDescription()` — the plugin loads (witness classes pass) but crashes at runtime with `NoSuchMethodError`\n- Feign 12.2 moved `ReflectiveFeign$BuildTemplateByResolvingArgs` to `RequestTemplateFactoryResolver$BuildTemplateByResolvingArgs` — the path variable interception silently stops working\n- MariaDB 3.0 renamed every JDBC wrapper class (`MariaDbConnection` → `Connection`) — none of the plugin's `byName` matchers match anything\n\n**When extending `support-version.list` to add newer versions:**\nBefore adding a version, verify that every class and method the plugin intercepts still exists in that version's source. A plugin test passing does not mean everything works — it only means the test scenario's specific code path exercised the intercepted methods. Missing interception points may go undetected if the test doesn't cover them.\n\n## Step 2 - Create Plugin Module\n\n### Directory Structure\n\n**SDK plugin** (most common):\n```\napm-sniffer\u002Fapm-sdk-plugin\u002F{framework}-{version}-plugin\u002F\n  pom.xml\n  src\u002Fmain\u002Fjava\u002Forg\u002Fapache\u002Fskywalking\u002Fapm\u002Fplugin\u002F{framework}\u002Fv{N}\u002F\n    define\u002F\n      {Target}Instrumentation.java          # One per target class\n    {Target}Interceptor.java                # One per interception concern\n    {Target}ConstructorInterceptor.java     # If intercepting constructors\n    {PluginName}PluginConfig.java           # If plugin needs configuration\n  src\u002Fmain\u002Fresources\u002F\n    skywalking-plugin.def                   # Plugin registration\n  src\u002Ftest\u002Fjava\u002Forg\u002Fapache\u002Fskywalking\u002Fapm\u002Fplugin\u002F{framework}\u002Fv{N}\u002F\n    {Target}InterceptorTest.java            # Unit tests\n```\n\n**Bootstrap plugin** (for JDK classes):\n```\napm-sniffer\u002Fbootstrap-plugins\u002F{name}-plugin\u002F\n  (same structure, but instrumentation class overrides isBootstrapInstrumentation)\n```\n\n**Optional plugin**:\n```\napm-sniffer\u002Foptional-plugins\u002F{name}-plugin\u002F\n  (same structure as SDK plugin)\n```\n\n### pom.xml Template\n\n```xml\n\u003C?xml version=\"1.0\" encoding=\"UTF-8\"?>\n\u003Cproject xmlns=\"http:\u002F\u002Fmaven.apache.org\u002FPOM\u002F4.0.0\"\n         xmlns:xsi=\"http:\u002F\u002Fwww.w3.org\u002F2001\u002FXMLSchema-instance\"\n         xsi:schemaLocation=\"http:\u002F\u002Fmaven.apache.org\u002FPOM\u002F4.0.0 http:\u002F\u002Fmaven.apache.org\u002Fxsd\u002Fmaven-4.0.0.xsd\">\n    \u003CmodelVersion>4.0.0\u003C\u002FmodelVersion>\n\n    \u003Cparent>\n        \u003CgroupId>org.apache.skywalking\u003C\u002FgroupId>\n        \u003CartifactId>apm-sdk-plugin\u003C\u002FartifactId>  \u003C!-- or bootstrap-plugins \u002F optional-plugins -->\n        \u003Cversion>${revision}\u003C\u002Fversion>\n    \u003C\u002Fparent>\n\n    \u003CartifactId>{framework}-{version}-plugin\u003C\u002FartifactId>\n    \u003Cpackaging>jar\u003C\u002Fpackaging>\n\n    \u003Cproperties>\n        \u003Ctarget-library.version>X.Y.Z\u003C\u002Ftarget-library.version>\n    \u003C\u002Fproperties>\n\n    \u003Cdependencies>\n        \u003C!-- Target library - MUST be provided scope -->\n        \u003Cdependency>\n            \u003CgroupId>com.example\u003C\u002FgroupId>\n            \u003CartifactId>target-library\u003C\u002FartifactId>\n            \u003Cversion>${target-library.version}\u003C\u002Fversion>\n            \u003Cscope>provided\u003C\u002Fscope>\n        \u003C\u002Fdependency>\n    \u003C\u002Fdependencies>\n\u003C\u002Fproject>\n```\n\n**CRITICAL dependency rules:**\n- Target library: **always `provided` scope** (supplied by the application at runtime)\n- `apm-agent-core`: inherited from parent POM as `provided`\n- `apm-util`: inherited from parent POM as `provided`\n- Never bundle target library classes into the plugin JAR\n- If the plugin needs a 3rd-party utility not already in agent-core, discuss with maintainers first\n\n**CRITICAL compiler level rule:**\n- Do NOT set `maven.compiler.release` or `maven.compiler.source\u002Ftarget` unless the plugin source code itself uses JDK 9+ language features (e.g., `var`, records, sealed classes, `java.net.http.HttpClient`).\n- A `provided`-scope dependency targeting a higher JDK (e.g., Spring AI requires JDK 17+) does NOT require raising the compiler level — the plugin only references the library's API at compile time.\n- Bootstrap plugins like `jdk-httpclient-plugin` (which uses JDK 11 `HttpClient` API directly in plugin source code) legitimately need a higher compiler target. SDK plugins and optional plugins generally should not.\n\n### Register in Parent POM\n\nAdd the new module to the parent `pom.xml`:\n```xml\n\u003Cmodules>\n    ...\n    \u003Cmodule>{framework}-{version}-plugin\u003C\u002Fmodule>\n\u003C\u002Fmodules>\n```\n\n## Step 3 - Implement Instrumentation Class (V2 API)\n\n**ALWAYS use V2 API for new plugins.** V1 is legacy.\n\n### Import Rules (Enforced by Checkstyle)\n\nPlugins may ONLY import from:\n- `java.*` - Java standard library\n- `org.apache.skywalking.*` - SkyWalking modules\n- `net.bytebuddy.*` - ByteBuddy (for matchers in instrumentation classes)\n\n**No other 3rd-party imports are allowed in instrumentation\u002Factivation files.** This is enforced by `apm-checkstyle\u002FimportControl.xml`. Interceptor classes CAN reference target library classes (they're loaded after the target library).\n\n### Class Matching\n\n**CRITICAL: NEVER use `.class` references in instrumentation definitions.** Always use string literals.\n\n```java\n\u002F\u002F WRONG - breaks agent if class doesn't exist at runtime\nbyName(SomeThirdPartyClass.class.getName())\ntakesArgument(0, SomeThirdPartyClass.class)\n\n\u002F\u002F CORRECT - safe string literals\nbyName(\"com.example.SomeThirdPartyClass\")\ntakesArgumentWithType(0, \"com.example.SomeThirdPartyClass\")\n```\n\nAvailable ClassMatch types (from `org.apache.skywalking.apm.agent.core.plugin.match`):\n\n| Matcher | Usage | Performance |\n|---------|-------|-------------|\n| `NameMatch.byName(String)` | Exact class name | Best (HashMap lookup) |\n| `MultiClassNameMatch.byMultiClassMatch(String...)` | Multiple exact names | Good |\n| `HierarchyMatch.byHierarchyMatch(String...)` | Implements interface \u002F extends class | Expensive - avoid unless necessary |\n| `ClassAnnotationMatch.byClassAnnotationMatch(String...)` | Has annotation(s) | Moderate |\n| `MethodAnnotationMatch.byMethodAnnotationMatch(String...)` | Has method with annotation | Moderate |\n| `PrefixMatch.nameStartsWith(String...)` | Class name prefix | Moderate |\n| `RegexMatch.byRegexMatch(String...)` | Regex on class name | Expensive |\n| `LogicalMatchOperation.and(match1, match2)` | AND composition | Depends on operands |\n| `LogicalMatchOperation.or(match1, match2)` | OR composition | Depends on operands |\n\n**Prefer `NameMatch.byName()` whenever possible.** It uses a fast HashMap lookup. All other matchers require linear scanning.\n\n### Method Matching (ByteBuddy ElementMatcher API)\n\nCommon matchers from `net.bytebuddy.matcher.ElementMatchers`:\n\n```java\n\u002F\u002F By name\nnamed(\"methodName\")\n\n\u002F\u002F By argument count\ntakesArguments(2)\ntakesArguments(0)  \u002F\u002F no-arg methods\n\n\u002F\u002F By argument type (use SkyWalking's helper - string-based, safe)\nimport static org.apache.skywalking.apm.agent.core.plugin.bytebuddy.ArgumentTypeNameMatch.takesArgumentWithType;\ntakesArgumentWithType(0, \"com.example.SomeType\")  \u002F\u002F arg at index 0\n\n\u002F\u002F By return type (SkyWalking helper)\nimport static org.apache.skywalking.apm.agent.core.plugin.bytebuddy.ReturnTypeNameMatch.returnsWithType;\nreturnsWithType(\"java.util.List\")\n\n\u002F\u002F By annotation (SkyWalking helper - string-based)\nimport static org.apache.skywalking.apm.agent.core.plugin.bytebuddy.AnnotationTypeNameMatch.isAnnotatedWithType;\nisAnnotatedWithType(\"org.springframework.web.bind.annotation.RequestMapping\")\n\n\u002F\u002F Visibility\nisPublic()\nisPrivate()\n\n\u002F\u002F Composition\nnamed(\"execute\").and(takesArguments(1))\nnamed(\"method1\").or(named(\"method2\"))\nnot(isDeclaredBy(Object.class))\n\n\u002F\u002F Match any (use sparingly)\nany()\n```\n\n### Instrumentation Template - Instance Methods\n\n```java\npackage org.apache.skywalking.apm.plugin.xxx.define;\n\nimport net.bytebuddy.description.method.MethodDescription;\nimport net.bytebuddy.matcher.ElementMatcher;\nimport org.apache.skywalking.apm.agent.core.plugin.interceptor.ConstructorInterceptPoint;\nimport org.apache.skywalking.apm.agent.core.plugin.interceptor.v2.InstanceMethodsInterceptV2Point;\nimport org.apache.skywalking.apm.agent.core.plugin.interceptor.enhance.v2.ClassInstanceMethodsEnhancePluginDefineV2;\nimport org.apache.skywalking.apm.agent.core.plugin.match.ClassMatch;\nimport org.apache.skywalking.apm.agent.core.plugin.match.NameMatch;\n\nimport static net.bytebuddy.matcher.ElementMatchers.named;\n\npublic class XxxInstrumentation extends ClassInstanceMethodsEnhancePluginDefineV2 {\n\n    private static final String ENHANCE_CLASS = \"com.example.TargetClass\";\n    private static final String INTERCEPTOR_CLASS = \"org.apache.skywalking.apm.plugin.xxx.XxxInterceptor\";\n\n    @Override\n    protected ClassMatch enhanceClass() {\n        return NameMatch.byName(ENHANCE_CLASS);\n    }\n\n    @Override\n    public ConstructorInterceptPoint[] getConstructorsInterceptPoints() {\n        return null;  \u002F\u002F null or empty array if not intercepting constructors\n    }\n\n    @Override\n    public InstanceMethodsInterceptV2Point[] getInstanceMethodsInterceptV2Points() {\n        return new InstanceMethodsInterceptV2Point[] {\n            new InstanceMethodsInterceptV2Point() {\n                @Override\n                public ElementMatcher\u003CMethodDescription> getMethodsMatcher() {\n                    return named(\"targetMethod\");\n                }\n\n                @Override\n                public String getMethodsInterceptorV2() {\n                    return INTERCEPTOR_CLASS;\n                }\n\n                @Override\n                public boolean isOverrideArgs() {\n                    return false;\n                }\n            }\n        };\n    }\n}\n```\n\n### Instrumentation Template - Static Methods\n\n```java\nimport org.apache.skywalking.apm.agent.core.plugin.interceptor.StaticMethodsInterceptPoint;\nimport org.apache.skywalking.apm.agent.core.plugin.interceptor.enhance.v2.ClassStaticMethodsEnhancePluginDefineV2;\n\npublic class XxxStaticInstrumentation extends ClassStaticMethodsEnhancePluginDefineV2 {\n    @Override\n    public StaticMethodsInterceptPoint[] getStaticMethodsInterceptPoints() {\n        return new StaticMethodsInterceptPoint[] {\n            new StaticMethodsInterceptPoint() {\n                @Override\n                public ElementMatcher\u003CMethodDescription> getMethodsMatcher() {\n                    return named(\"factoryMethod\").and(takesArguments(2));\n                }\n\n                @Override\n                public String getMethodsInterceptor() {\n                    return INTERCEPTOR_CLASS;\n                }\n\n                @Override\n                public boolean isOverrideArgs() {\n                    return false;\n                }\n            }\n        };\n    }\n\n    @Override\n    protected ClassMatch enhanceClass() {\n        return NameMatch.byName(ENHANCE_CLASS);\n    }\n}\n```\n\n### Instrumentation Template - Both Instance + Static Methods\n\nExtend `ClassEnhancePluginDefineV2` and implement all four methods:\n- `enhanceClass()`\n- `getConstructorsInterceptPoints()`\n- `getInstanceMethodsInterceptV2Points()`\n- `getStaticMethodsInterceptPoints()`\n\n### Matching Interface\u002FAbstract Class Implementations\n\nUse `HierarchyMatch` when you need to intercept all implementations of an interface:\n\n```java\nimport org.apache.skywalking.apm.agent.core.plugin.match.HierarchyMatch;\n\n@Override\nprotected ClassMatch enhanceClass() {\n    return HierarchyMatch.byHierarchyMatch(\"com.example.SomeInterface\");\n}\n```\n\n**When to use HierarchyMatch:**\n- The library has an interface\u002Fabstract class with multiple implementations\n- You cannot enumerate all implementation class names\n- Example: intercepting all `javax.servlet.Servlet` implementations\n\n**Performance warning:** HierarchyMatch checks every loaded class against the hierarchy. Prefer `NameMatch` or `MultiClassNameMatch` if you know the concrete class names.\n\n**Combining with other matchers:**\n```java\nimport org.apache.skywalking.apm.agent.core.plugin.match.logical.LogicalMatchOperation;\n\n@Override\nprotected ClassMatch enhanceClass() {\n    return LogicalMatchOperation.and(\n        PrefixMatch.nameStartsWith(\"com.example\"),\n        HierarchyMatch.byHierarchyMatch(\"java.lang.Runnable\")\n    );\n}\n```\n\n### Witness Classes for Version Detection\n\nOverride `witnessClasses()` or `witnessMethods()` to activate the plugin only for specific library versions:\n\n```java\n@Override\nprotected String[] witnessClasses() {\n    \u002F\u002F Plugin only loads if this class exists in the application\n    return new String[] {\"com.example.VersionSpecificClass\"};\n}\n\n@Override\nprotected List\u003CWitnessMethod> witnessMethods() {\n    return Collections.singletonList(\n        new WitnessMethod(\"com.example.SomeClass\", ElementMatchers.named(\"methodAddedInV2\"))\n    );\n}\n```\n\n### Bootstrap Plugin Override\n\nFor bootstrap plugins (instrumenting JDK classes), add:\n```java\n@Override\npublic boolean isBootstrapInstrumentation() {\n    return true;\n}\n```\n\n**Bootstrap plugin rules:**\n- Only for JDK core classes (java.*, javax.*, sun.*)\n- Minimal interception scope (performance-critical paths)\n- Extra care with class loading (bootstrap classloader visibility)\n- Test with `runningMode: with_bootstrap`\n\n## Step 4 - Implement Interceptor Class (V2 API)\n\n### Available Interceptor Interfaces\n\n| Interface | Use Case |\n|-----------|----------|\n| `InstanceMethodsAroundInterceptorV2` | Instance method interception |\n| `StaticMethodsAroundInterceptorV2` | Static method interception |\n| `InstanceConstructorInterceptor` | Constructor interception (shared V1\u002FV2) |\n\n### Core APIs Available in Interceptors\n\n**ContextManager** - Central tracing API (ThreadLocal-based):\n\n**CRITICAL threading rule:** All span lifecycle APIs (`createEntrySpan`, `createExitSpan`, `createLocalSpan`, `activeSpan`, `stopSpan`) operate on a **per-thread context via ThreadLocal**. By default, `createXxxSpan` and `stopSpan` MUST be called in the **same thread**. There are only two ways to work across threads:\n1. **`ContextSnapshot` (capture\u002Fcontinued)** — snapshot the context in thread A, then `continued()` in thread B to link a NEW span in thread B back to the parent trace. Each thread manages its own span lifecycle independently.\n2. **Async mode (`prepareForAsync`\u002F`asyncFinish`)** — keeps a single span alive beyond the creating thread. Call `prepareForAsync()` in the original thread (before `stopSpan`), then `asyncFinish()` from any thread when the async work completes. Between `prepareForAsync` and `asyncFinish`, you may call tag\u002Flog\u002Ferror on the span from any thread, but you must NOT call `ContextManager.stopSpan()` for that span again.\n\n```java\nimport org.apache.skywalking.apm.agent.core.context.ContextManager;\n\n\u002F\u002F Create spans (must stopSpan in the SAME thread, unless async mode)\nAbstractSpan span = ContextManager.createEntrySpan(operationName, contextCarrier);\nAbstractSpan span = ContextManager.createLocalSpan(operationName);\nAbstractSpan span = ContextManager.createExitSpan(operationName, contextCarrier, remotePeer);\nAbstractSpan span = ContextManager.createExitSpan(operationName, remotePeer);\n\n\u002F\u002F Span lifecycle (same thread as create, unless async mode)\nContextManager.activeSpan();      \u002F\u002F Get current span in THIS thread\nContextManager.stopSpan();        \u002F\u002F Stop current span in THIS thread\nContextManager.isActive();        \u002F\u002F Check if context exists in THIS thread\n\n\u002F\u002F Cross-process propagation (inject\u002Fextract ContextCarrier into headers\u002Fmetadata)\nContextManager.inject(carrier);   \u002F\u002F Inject into outgoing carrier\nContextManager.extract(carrier);  \u002F\u002F Extract from incoming carrier\n\n\u002F\u002F Cross-thread propagation (ContextSnapshot — link spans across threads)\nContextManager.capture();         \u002F\u002F Capture snapshot in originating thread\nContextManager.continued(snapshot); \u002F\u002F Continue from snapshot in receiving thread\n\n\u002F\u002F Trace metadata\nContextManager.getGlobalTraceId();\nContextManager.getSegmentId();\nContextManager.getSpanId();\n```\n\n**AbstractSpan** - Span configuration:\n```java\nspan.setComponent(ComponentsDefine.YOUR_COMPONENT);  \u002F\u002F Required for Entry\u002FExit\nspan.setLayer(SpanLayer.HTTP);                        \u002F\u002F Required for Entry\u002FExit\nspan.setOperationName(\"GET:\u002Fapi\u002Fusers\");\nspan.setPeer(\"host:port\");                            \u002F\u002F Required for Exit spans\n\n\u002F\u002F Tags\nspan.tag(Tags.URL, url);\nspan.tag(Tags.HTTP_RESPONSE_STATUS_CODE, statusCode);\nspan.tag(Tags.DB_TYPE, \"sql\");\nspan.tag(Tags.DB_STATEMENT, sql);\nspan.tag(Tags.ofKey(\"custom.key\"), value);\n\n\u002F\u002F Error handling\nspan.errorOccurred();\nspan.log(throwable);\n\n\u002F\u002F Async support\nspan.prepareForAsync();  \u002F\u002F Must call in original thread\nspan.asyncFinish();      \u002F\u002F Call in async thread when done\n```\n\n**SpanLayer** values: `DB`, `RPC_FRAMEWORK`, `HTTP`, `MQ`, `CACHE`, `GEN_AI`\n\n**Standard Tags** (from `org.apache.skywalking.apm.agent.core.context.tag.Tags`):\n\n| Tag                 | Constant                         | Purpose                  |\n|---------------------|----------------------------------|--------------------------|\n| `url`               | `Tags.URL`                       | Request URL              |\n| `http.status_code`  | `Tags.HTTP_RESPONSE_STATUS_CODE` | HTTP status (IntegerTag) |\n| `http.method`       | `Tags.HTTP.METHOD`               | HTTP method              |\n| `db.type`           | `Tags.DB_TYPE`                   | Database type            |\n| `db.instance`       | `Tags.DB_INSTANCE`               | Database name            |\n| `db.statement`      | `Tags.DB_STATEMENT`              | SQL\u002Fquery                |\n| `db.bind_variables` | `Tags.DB_BIND_VARIABLES`         | Bound params             |\n| `mq.queue`          | `Tags.MQ_QUEUE`                  | Queue name               |\n| `mq.topic`          | `Tags.MQ_TOPIC`                  | Topic name               |\n| `mq.broker`         | `Tags.MQ_BROKER`                 | Broker address           |\n| `cache.type`        | `Tags.CACHE_TYPE`                | Cache type               |\n| `cache.op`          | `Tags.CACHE_OP`                  | \"read\" or \"write\"        |\n| `cache.cmd`         | `Tags.CACHE_CMD`                 | Cache command            |\n| `cache.key`         | `Tags.CACHE_KEY`                 | Cache key                |\n| Custom              | `Tags.ofKey(\"key\")`              | Any custom tag           |\n\n**EnhancedInstance** - Dynamic field for cross-interceptor data:\n```java\n\u002F\u002F Store data (e.g., in constructor interceptor)\nobjInst.setSkyWalkingDynamicField(connectionInfo);\n\n\u002F\u002F Retrieve data (e.g., in method interceptor)\nConnectionInfo info = (ConnectionInfo) objInst.getSkyWalkingDynamicField();\n```\n\n**Logging** - Agent-internal logging (NOT application logging):\n```java\nimport org.apache.skywalking.apm.agent.core.logging.api.ILog;\nimport org.apache.skywalking.apm.agent.core.logging.api.LogManager;\n\nprivate static final ILog LOGGER = LogManager.getLogger(MyInterceptor.class);\nLOGGER.info(\"message: {}\", value);\nLOGGER.error(\"error\", throwable);\n```\n\n**MeterFactory** - For meter plugins:\n```java\nimport org.apache.skywalking.apm.toolkit.meter.MeterFactory;\nimport org.apache.skywalking.apm.toolkit.meter.Counter;\nimport org.apache.skywalking.apm.toolkit.meter.Gauge;\nimport org.apache.skywalking.apm.toolkit.meter.Histogram;\n\nCounter counter = MeterFactory.counter(\"metric_name\")\n    .tag(\"key\", \"value\")\n    .mode(Counter.Mode.INCREMENT)\n    .build();\ncounter.increment(1.0);\n\nGauge gauge = MeterFactory.gauge(\"metric_name\", () -> pool.getActiveCount())\n    .tag(\"pool_name\", name)\n    .build();\n\nHistogram histogram = MeterFactory.histogram(\"metric_name\")\n    .steps(Arrays.asList(10.0, 50.0, 100.0, 500.0))\n    .minValue(0)\n    .build();\nhistogram.addValue(latencyMs);\n```\n\n### Interceptor Template - ExitSpan (Client\u002FProducer)\n\n```java\npackage org.apache.skywalking.apm.plugin.xxx;\n\nimport java.lang.reflect.Method;\nimport org.apache.skywalking.apm.agent.core.context.CarrierItem;\nimport org.apache.skywalking.apm.agent.core.context.ContextCarrier;\nimport org.apache.skywalking.apm.agent.core.context.ContextManager;\nimport org.apache.skywalking.apm.agent.core.context.tag.Tags;\nimport org.apache.skywalking.apm.agent.core.context.trace.AbstractSpan;\nimport org.apache.skywalking.apm.agent.core.context.trace.SpanLayer;\nimport org.apache.skywalking.apm.agent.core.plugin.interceptor.enhance.EnhancedInstance;\nimport org.apache.skywalking.apm.agent.core.plugin.interceptor.enhance.v2.InstanceMethodsAroundInterceptorV2;\nimport org.apache.skywalking.apm.agent.core.plugin.interceptor.enhance.v2.MethodInvocationContext;\nimport org.apache.skywalking.apm.network.trace.component.ComponentsDefine;\n\npublic class XxxClientInterceptor implements InstanceMethodsAroundInterceptorV2 {\n\n    @Override\n    public void beforeMethod(EnhancedInstance objInst, Method method, Object[] allArguments,\n                             Class\u003C?>[] argumentsTypes, MethodInvocationContext context) throws Throwable {\n        \u002F\u002F 1. Build peer address from stored connection info\n        String remotePeer = (String) objInst.getSkyWalkingDynamicField();\n\n        \u002F\u002F 2. Create ExitSpan with ContextCarrier for cross-process propagation\n        ContextCarrier contextCarrier = new ContextCarrier();\n        AbstractSpan span = ContextManager.createExitSpan(\"operation\u002Fname\", contextCarrier, remotePeer);\n        span.setComponent(ComponentsDefine.YOUR_COMPONENT);\n        SpanLayer.asHttp(span);  \u002F\u002F or asDB, asMQ, asRPCFramework, asCache\n\n        \u002F\u002F 3. Inject trace context into outgoing request headers\n        \u002F\u002F The request object is typically one of the method arguments\n        CarrierItem next = contextCarrier.items();\n        while (next.hasNext()) {\n            next = next.next();\n            \u002F\u002F Set header on the outgoing request:\n            \u002F\u002F request.setHeader(next.getHeadKey(), next.getHeadValue());\n        }\n\n        \u002F\u002F 4. Set tags\n        Tags.URL.set(span, url);\n\n        \u002F\u002F 5. Store span in context for afterMethod\n        context.setContext(span);\n    }\n\n    @Override\n    public Object afterMethod(EnhancedInstance objInst, Method method, Object[] allArguments,\n                              Class\u003C?>[] argumentsTypes, Object ret, MethodInvocationContext context) throws Throwable {\n        \u002F\u002F Check response status, set tags\u002Ferrors\n        AbstractSpan span = (AbstractSpan) context.getContext();\n        \u002F\u002F Example: Tags.HTTP_RESPONSE_STATUS_CODE.set(span, statusCode);\n        \u002F\u002F if (statusCode >= 400) span.errorOccurred();\n\n        ContextManager.stopSpan();\n        return ret;\n    }\n\n    @Override\n    public void handleMethodException(EnhancedInstance objInst, Method method, Object[] allArguments,\n                                      Class\u003C?>[] argumentsTypes, Throwable t, MethodInvocationContext context) {\n        ContextManager.activeSpan().log(t);\n        ContextManager.activeSpan().errorOccurred();\n    }\n}\n```\n\n### Interceptor Template - EntrySpan (Server\u002FConsumer)\n\n```java\npublic class XxxServerInterceptor implements InstanceMethodsAroundInterceptorV2 {\n\n    @Override\n    public void beforeMethod(EnhancedInstance objInst, Method method, Object[] allArguments,\n                             Class\u003C?>[] argumentsTypes, MethodInvocationContext context) throws Throwable {\n        \u002F\u002F 1. Extract trace context from incoming request headers\n        ContextCarrier contextCarrier = new ContextCarrier();\n        CarrierItem next = contextCarrier.items();\n        while (next.hasNext()) {\n            next = next.next();\n            \u002F\u002F Read header from incoming request:\n            \u002F\u002F next.setHeadValue(request.getHeader(next.getHeadKey()));\n        }\n\n        \u002F\u002F 2. Create EntrySpan (extracts context automatically)\n        AbstractSpan span = ContextManager.createEntrySpan(\"operation\u002Fname\", contextCarrier);\n        span.setComponent(ComponentsDefine.YOUR_COMPONENT);\n        SpanLayer.asHttp(span);  \u002F\u002F or asMQ, asRPCFramework\n        span.setPeer(clientAddress);  \u002F\u002F Optional: client address\n\n        context.setContext(span);\n    }\n\n    @Override\n    public Object afterMethod(EnhancedInstance objInst, Method method, Object[] allArguments,\n                              Class\u003C?>[] argumentsTypes, Object ret, MethodInvocationContext context) throws Throwable {\n        ContextManager.stopSpan();\n        return ret;\n    }\n\n    @Override\n    public void handleMethodException(EnhancedInstance objInst, Method method, Object[] allArguments,\n                                      Class\u003C?>[] argumentsTypes, Throwable t, MethodInvocationContext context) {\n        ContextManager.activeSpan().log(t);\n        ContextManager.activeSpan().errorOccurred();\n    }\n}\n```\n\n### Interceptor Template - Constructor (Store Connection Info)\n\n```java\nimport org.apache.skywalking.apm.agent.core.plugin.interceptor.enhance.InstanceConstructorInterceptor;\n\npublic class XxxConstructorInterceptor implements InstanceConstructorInterceptor {\n\n    @Override\n    public void onConstruct(EnhancedInstance objInst, Object[] allArguments) {\n        \u002F\u002F Store connection info for later use by method interceptors\n        String host = (String) allArguments[0];\n        int port = (int) allArguments[1];\n        objInst.setSkyWalkingDynamicField(host + \":\" + port);\n    }\n}\n```\n\n### Cross-Thread Context Propagation (ContextSnapshot)\n\nUse `ContextSnapshot` when the library dispatches work to another thread and you want the new thread's spans to be linked to the parent trace. Each thread creates and stops its OWN spans — the snapshot only provides the link.\n\n```java\n\u002F\u002F Thread A (originating thread) — create span, capture snapshot, stop span (all same thread)\n@Override\npublic void beforeMethod(..., MethodInvocationContext context) {\n    AbstractSpan span = ContextManager.createLocalSpan(\"async\u002Fdispatch\");\n    \u002F\u002F Capture context snapshot BEFORE handing off to another thread\n    ContextSnapshot snapshot = ContextManager.capture();\n    \u002F\u002F Store snapshot on the task object via EnhancedInstance dynamic field\n    ((EnhancedInstance) allArguments[0]).setSkyWalkingDynamicField(snapshot);\n    ContextManager.stopSpan();  \u002F\u002F Stop span in THIS thread (same thread as create)\n}\n\n\u002F\u002F Thread B (receiving thread) — create its OWN span, link to parent via continued()\n@Override\npublic void beforeMethod(EnhancedInstance objInst, ...) {\n    ContextSnapshot snapshot = (ContextSnapshot) objInst.getSkyWalkingDynamicField();\n    if (snapshot != null) {\n        AbstractSpan span = ContextManager.createLocalSpan(\"async\u002Fexecute\");\n        ContextManager.continued(snapshot);  \u002F\u002F Link this span to the parent trace\n    }\n}\n\n@Override\npublic Object afterMethod(...) {\n    if (ContextManager.isActive()) {\n        ContextManager.stopSpan();  \u002F\u002F Stop span in THIS thread (same thread as create)\n    }\n    return ret;\n}\n```\n\n### Async Span Pattern (prepareForAsync \u002F asyncFinish)\n\nUse this when a **single span** needs to stay open across thread boundaries — e.g., an ExitSpan created before an async call, finished when the callback fires in another thread. The key difference from ContextSnapshot: here one span lives across threads instead of each thread having its own span.\n\n```java\n\u002F\u002F Thread A — create span, mark async, stop context (all same thread)\n@Override\npublic void beforeMethod(..., MethodInvocationContext context) {\n    AbstractSpan span = ContextManager.createExitSpan(\"async\u002Fcall\", remotePeer);\n    span.setComponent(ComponentsDefine.YOUR_COMPONENT);\n    SpanLayer.asHttp(span);\n\n    span.prepareForAsync();       \u002F\u002F Mark: this span will finish in another thread\n    ContextManager.stopSpan();    \u002F\u002F Detach from THIS thread's context (required, same thread as create)\n\n    \u002F\u002F Store span reference on the callback object's dynamic field\n    ((EnhancedInstance) callback).setSkyWalkingDynamicField(span);\n}\n\n\u002F\u002F Thread B (callback\u002Fcompletion handler) — finish the async span\n@Override\npublic void beforeMethod(EnhancedInstance objInst, ...) {\n    AbstractSpan span = (AbstractSpan) objInst.getSkyWalkingDynamicField();\n    if (span != null) {\n        \u002F\u002F Add response info to the span (tag\u002Flog\u002Ferror are thread-safe after prepareForAsync)\n        span.tag(Tags.HTTP_RESPONSE_STATUS_CODE, statusCode);\n        if (isError) span.errorOccurred();\n        span.asyncFinish();  \u002F\u002F Must match prepareForAsync count\n    }\n}\n```\n\n### Plugin Configuration (Optional)\n\n```java\nimport org.apache.skywalking.apm.agent.core.boot.PluginConfig;\n\npublic class XxxPluginConfig {\n    public static class Plugin {\n        @PluginConfig(root = XxxPluginConfig.class)\n        public static class Xxx {\n            \u002F\u002F Config key: plugin.xxx.trace_param\n            public static boolean TRACE_PARAM = false;\n            \u002F\u002F Config key: plugin.xxx.max_length\n            public static int MAX_LENGTH = 256;\n        }\n    }\n}\n```\n\n## Step 5 - Register Plugin\n\nCreate `src\u002Fmain\u002Fresources\u002Fskywalking-plugin.def`:\n```\nplugin-name=org.apache.skywalking.apm.plugin.xxx.define.XxxInstrumentation\nplugin-name=org.apache.skywalking.apm.plugin.xxx.define.XxxOtherInstrumentation\n```\n\nFormat: `{plugin-id}={fully.qualified.InstrumentationClassName}` (one line per instrumentation class, all sharing the same plugin-id prefix).\n\n## Step 6 - Write Unit Tests\n\n### Test Setup Pattern\n\n```java\nimport org.junit.Before;\nimport org.junit.Rule;\nimport org.junit.Test;\nimport org.junit.runner.RunWith;\nimport org.mockito.Mock;\nimport org.mockito.junit.MockitoJUnit;\nimport org.mockito.junit.MockitoRule;\nimport org.apache.skywalking.apm.agent.core.plugin.interceptor.enhance.EnhancedInstance;\nimport org.apache.skywalking.apm.agent.test.tools.AgentServiceRule;\nimport org.apache.skywalking.apm.agent.test.tools.SegmentStorage;\nimport org.apache.skywalking.apm.agent.test.tools.SegmentStoragePoint;\nimport org.apache.skywalking.apm.agent.test.tools.TracingSegmentRunner;\n\n@RunWith(TracingSegmentRunner.class)\npublic class XxxInterceptorTest {\n\n    @SegmentStoragePoint\n    private SegmentStorage segmentStorage;\n\n    @Rule\n    public AgentServiceRule agentServiceRule = new AgentServiceRule();\n\n    @Rule\n    public MockitoRule rule = MockitoJUnit.rule();\n\n    @Mock\n    private EnhancedInstance enhancedInstance;\n\n    private XxxInterceptor interceptor;\n\n    @Before\n    public void setUp() {\n        interceptor = new XxxInterceptor();\n        \u002F\u002F Setup mocks\n    }\n\n    @Test\n    public void testNormalRequest() throws Throwable {\n        \u002F\u002F Arrange\n        Object[] allArguments = new Object[] { \u002F* mock args *\u002F };\n        Class[] argumentsTypes = new Class[] { \u002F* arg types *\u002F };\n\n        \u002F\u002F Act\n        interceptor.beforeMethod(enhancedInstance, null, allArguments, argumentsTypes, null);\n        interceptor.afterMethod(enhancedInstance, null, allArguments, argumentsTypes, mockResponse, null);\n\n        \u002F\u002F Assert spans\n        assertThat(segmentStorage.getTraceSegments().size(), is(1));\n        TraceSegment segment = segmentStorage.getTraceSegments().get(0);\n        List\u003CAbstractTracingSpan> spans = SegmentHelper.getSpans(segment);\n        assertThat(spans.size(), is(1));\n        \u002F\u002F Verify span properties...\n    }\n}\n```\n\n## Step 7 - Write E2E Plugin Tests\n\n### Test Scenario Structure\n\n```\ntest\u002Fplugin\u002Fscenarios\u002F{framework}-{version}-scenario\u002F\n  bin\u002Fstartup.sh\n  config\u002FexpectedData.yaml\n  src\u002Fmain\u002Fjava\u002Forg\u002Fapache\u002Fskywalking\u002Fapm\u002Ftestcase\u002F{framework}\u002F\n    controller\u002FCaseController.java    # HTTP endpoints\n  pom.xml\n  configuration.yml\n  support-version.list\n```\n\n**When copying an existing scenario to create a new one**, update the scenario name in ALL of these files:\n- `pom.xml` — `artifactId`, `name`, `finalName`\n- `src\u002Fmain\u002Fassembly\u002Fassembly.xml` — JAR filename reference\n- `bin\u002Fstartup.sh` — JAR filename in java -jar command\n- `config\u002FexpectedData.yaml` — `serviceName` field AND `parentService` in refs (but NOT URL paths — those are the app context path)\n- `support-version.list` — new versions\n- For JDK 17+ scenarios: update `compiler.version` to `17`, `spring.boot.version` to `3.x`, change `javax.annotation` imports to `jakarta.annotation` in Java source\n- Add the scenario to the appropriate CI workflow (`plugins-test.*.yaml` for JDK 8, `plugins-jdk17-test.*.yaml` for JDK 17)\n\n### configuration.yml\n\n```yaml\ntype: jvm\nentryService: http:\u002F\u002Flocalhost:8080\u002F{scenario-name}\u002Fcase\u002F{endpoint}\nhealthCheck: http:\u002F\u002Flocalhost:8080\u002F{scenario-name}\u002Fcase\u002FhealthCheck\nstartScript: .\u002Fbin\u002Fstartup.sh\nenvironment: []\ndependencies: {}\n```\n\n### expectedData.yaml for Tracing\n\n```yaml\nsegmentItems:\n  - serviceName: {scenario-name}\n    segmentSize: ge 1\n    segments:\n      - segmentId: not null\n        spans:\n          - operationName: your\u002Foperation\n            parentSpanId: -1\n            spanId: 0\n            spanLayer: Http           # Http, DB, RPCFramework, MQ, CACHE\n            spanType: Exit            # Entry, Exit, Local\n            startTime: nq 0\n            endTime: nq 0\n            componentId: 2            # Must match ComponentsDefine ID\n            isError: false\n            peer: 'host:port'\n            skipAnalysis: 'false'\n            tags:\n              - {key: url, value: not null}\n              - {key: http.method, value: GET}\n            logs: []\n            refs: []\n```\n\n### expectedData.yaml for Meters\n\n```yaml\nmeterItems:\n  - serviceName: {scenario-name}\n    meterSize: ge 1\n    meters:\n      - meterId:\n          name: your_counter_name\n          tags:\n            - {name: tag_key, value: tag_value}\n        singleValue: gt 0\n```\n\n### Assertion Operators\n\n| Operator | Meaning |\n|----------|---------|\n| `eq VALUE` | Equals |\n| `nq VALUE` | Not equals |\n| `ge VALUE` | Greater or equal |\n| `gt VALUE` | Greater than |\n| `not null` | Must be present |\n| `null` | Must be absent |\n\n### Running Tests\n\n```bash\nbash .\u002Ftest\u002Fplugin\u002Frun.sh -f {scenario-name}\nbash .\u002Ftest\u002Fplugin\u002Frun.sh --debug {scenario-name}  # Save actualData.yaml for debugging\n```\n\n**IMPORTANT: Run E2E test scenarios ONE AT A TIME.** Multiple scenarios use the same Docker ports (8080, etc.) and will conflict if run in parallel. Always wait for one scenario to finish before starting the next.\n\n## Step 8 - Shading (Package Relocation)\n\nPlugins automatically inherit ByteBuddy shading from the parent POM:\n```xml\n\u003Crelocation>\n    \u003Cpattern>net.bytebuddy\u003C\u002Fpattern>\n    \u003CshadedPattern>org.apache.skywalking.apm.dependencies.net.bytebuddy\u003C\u002FshadedPattern>\n\u003C\u002Frelocation>\n```\n\nThe agent-core module handles shading of all core dependencies:\n- `com.google.*` -> `org.apache.skywalking.apm.dependencies.com.google.*`\n- `io.grpc.*` -> `org.apache.skywalking.apm.dependencies.io.grpc.*`\n- `io.netty.*` -> `org.apache.skywalking.apm.dependencies.io.netty.*`\n- `org.slf4j.*` -> `org.apache.skywalking.apm.dependencies.org.slf4j.*`\n\n**Plugins should NOT add their own shade configurations** unless they need to bundle a library not in agent-core (rare, requires maintainer approval). If a plugin needs a reporter-level dependency, see `optional-reporter-plugins\u002Fkafka-reporter-plugin\u002Fpom.xml` for the pattern.\n\n## Step 9 - Code Style Checklist\n\nBefore submitting:\n- [ ] No `System.out.println` (use `ILog` from `LogManager`)\n- [ ] No `@author` tags (ASF policy)\n- [ ] No Chinese characters in source\n- [ ] No tab characters (use 4 spaces)\n- [ ] No star imports (`import xxx.*`)\n- [ ] No unused imports\n- [ ] `@Override` on all overridden methods\n- [ ] Apache 2.0 license header on all source files\n- [ ] File length under 3000 lines\n- [ ] Constants in `UPPER_SNAKE_CASE`\n- [ ] Types in `PascalCase`, variables in `camelCase`\n- [ ] Imports only from `java.*`, `org.apache.skywalking.*`, `net.bytebuddy.*` (in instrumentation files)\n- [ ] Target library dependencies in `provided` scope\n- [ ] No unnecessary `maven.compiler.release` or `maven.compiler.source\u002Ftarget` (only set if plugin source uses JDK 9+ language features)\n- [ ] Using V2 API for new plugins\n- [ ] String literals (not `.class` references) in instrumentation definitions\n- [ ] `skywalking-plugin.def` registered\n- [ ] Module added to parent POM\n\n## Step 10 - Update Documentation\n\nAfter verifying the plugin works (locally or via CI), update these documentation files:\n\n**1. `docs\u002Fen\u002Fsetup\u002Fservice-agent\u002Fjava-agent\u002FSupported-list.md`**\nUpdate the version range for the relevant entry. Format example:\n```\n  * [MongoDB Java Driver](https:\u002F\u002Fgithub.com\u002Fmongodb\u002Fmongo-java-driver) 2.13-2.14, 3.4.0-3.12.7, 4.0.0-4.10.2\n```\nFor new plugins, add a new bullet under the appropriate category.\n\n**2. `CHANGES.md`**\nAdd a changelog entry under the current unreleased version section. Format:\n```\n* Extend {plugin-name} plugin to support {library} {version-range}.\n```\nOr for new plugins:\n```\n* Add {framework} {version} plugin.\n```\n\n**3. `test\u002Fplugin\u002Fscenarios\u002F{scenario}\u002Fsupport-version.list`**\nAdd verified versions. Only include the **latest patch version for each minor version** — do not list every patch release.\n\nThe version list supports **extra Maven properties** per version line using comma-separated `key=value` pairs:\n```\n# Simple version (default pom properties)\n2.3.10.RELEASE\n\n# Version with overridden Maven properties\n2.7.14,spring.boot.version=2.5.15\n2.8.11,spring.boot.version=2.7.18\n3.1.4,spring.boot.version=3.2.12\n```\n\nThis is useful when different framework versions need different dependency versions (e.g., spring-kafka minor versions require matching Spring Boot versions). The extra properties are passed as `-D` flags to Maven during the scenario build.\n\n**IMPORTANT:** Maven `-D` overrides work for `\u003Cproperties>` and direct `\u003Cversion>${prop}` references, but do NOT override BOM versions resolved via `\u003CdependencyManagement>` imports. If a BOM version needs to change, set the default in the pom to the highest needed version, not the lowest.\n\n**Spring Boot \u002F Spring Kafka compatibility mapping** (for reference):\n- spring-kafka 2.3-2.6 → Spring Boot 2.3 (default)\n- spring-kafka 2.7 → Spring Boot 2.5 (2.6+ autoconfigure requires `CommonErrorHandler` from spring-kafka 2.8)\n- spring-kafka 2.8-2.9 → Spring Boot 2.7\n- spring-kafka 3.0 → Spring Boot 3.0\n- spring-kafka 3.1-3.3 → Spring Boot 3.2 (requires Spring Framework 6.1)\n\n**This step is mandatory.** Documentation updates are part of the PR requirements.\n\n## Quick Reference - Plugin Type Decision Tree\n\n```\nIs the target a JDK core class (java.*, sun.*)?\n  YES -> Bootstrap plugin (isBootstrapInstrumentation = true)\n  NO  -> Is it commonly used and should be auto-activated?\n           YES -> SDK plugin (apm-sdk-plugin\u002F)\n           NO  -> Optional plugin (optional-plugins\u002F)\n\nWhat span type?\n  Receiving requests (HTTP server, MQ consumer, RPC provider) -> EntrySpan\n  Making outgoing calls (HTTP client, DB, cache, MQ producer) -> ExitSpan\n  Internal processing (annotation, local logic)               -> LocalSpan\n\nNeed cross-process propagation?\n  YES -> Use ContextCarrier (inject on exit, extract on entry)\n  NO  -> No carrier needed\n\nNeed cross-thread propagation?\n  YES -> Use ContextSnapshot (capture + continued) OR prepareForAsync\u002FasyncFinish\n  NO  -> Standard span lifecycle\n\nNeed metrics without traces?\n  YES -> Meter plugin (Counter\u002FGauge\u002FHistogram via MeterFactory)\n\nNeed both traces and metrics?\n  YES -> Separate interceptors or combine in same interceptor\n```","# SkyWalking Java Agent Plugin Development\n\nDevelop a new plugin for the Apache SkyWalking Java Agent. Ask the user what library\u002Fframework to instrument and what to observe (tracing, metrics, or both), then generate all required files.\n\n## Step 0 - Gather Requirements\n\nAsk the user:\n1. **Target library\u002Fframework** and version range (e.g., \"Jedis 3.x-4.x\", \"Spring Kafka 2.7+\")\n2. **Observation type**: tracing plugin, meter plugin, or both\n3. **Plugin category**: SDK plugin (default), bootstrap plugin, or optional plugin\n4. **Span type needed**: Entry (server\u002Fconsumer), Exit (client\u002Fproducer), Local (internal), or combination\n\nIf the user already provided this info, skip asking.\n\n## Step 1 - Understand the Library and Identify Interception Points\n\nThis is the most critical step. Do NOT jump to picking method names. Follow these phases in order.\n\n### Phase 1: Understand How the Library Is Used\n\nRead the target library's documentation, quickstart guides, or sample code. Understand the **user-facing API** — how developers create clients, make calls, and handle responses. This tells you:\n- What objects are long-lived (clients, connections, pools) vs. per-request (requests, commands)\n- Where configuration lives (server address, credentials, timeouts)\n- Whether the library is sync, async, or reactive\n- Whether it uses callbacks, futures, or blocking calls\n\nExample thought process for a Redis client:\n```\nUser creates: RedisClient client = RedisClient.create(\"redis:\u002F\u002Flocalhost:6379\");\nUser connects: StatefulRedisConnection conn = client.connect();\nUser executes: conn.sync().get(\"key\");  \u002F\u002F or conn.async().get(\"key\")\n```\nThis tells you: connection holds the server address, commands are executed on the connection.\n\n### Phase 2: Trace the Execution Flow\n\nStarting from the user-facing API, trace inward through the library source code to understand the execution workflow:\n1. What happens when the user calls the API method?\n2. Where does the request object get built?\n3. Where is the actual network I\u002FO or dispatch?\n4. Where is the response available?\n5. For RPC\u002FMQ: where are headers\u002Fmetadata accessible for inject\u002Fextract?\n\n**Key question at each point:** What data is directly accessible as method arguments, return values, or fields on `this`? You want interception points where you can read the data you need **without reflection**.\n\n### Phase 3: Choose Interception Points\n\nPick interception points based on these principles:\n\n**Principle 1: Data accessibility without reflection.**\nChoose methods where the information you need (peer address, operation name, request\u002Fresponse details, headers for inject\u002Fextract) is directly available as method arguments, return values, or accessible through the `this` object's public API. **Never use reflection to read private fields.** If the data is not accessible at one method, look at a different point in the execution flow.\n\nIf the target class is **package-private** (e.g., `final class` without `public`), you cannot import or cast to it. **Same-package helper classes do NOT work** because the agent and application use different classloaders — Java treats them as different runtime packages even with the same package name (`IllegalAccessError`). Use `setAccessible` reflection to call public methods:\n```java\ntry {\n    java.lang.reflect.Method method = objInst.getClass().getMethod(\"publicMethodName\");\n    method.setAccessible(true);  \u002F\u002F Required for package-private class\n    Object result = method.invoke(objInst);\n} catch (Exception e) {\n    LOGGER.warn(\"Failed to access method\", e);\n}\n```\n\n**Principle 2: Use `EnhancedInstance` dynamic field to propagate context inside the library.**\nThis is the primary mechanism for passing data between interception points. The agent adds a dynamic field to every enhanced class via `EnhancedInstance`. Use it to:\n- Store server address (peer) at connection\u002Fclient creation time, retrieve it at command execution time\n- Store request info at request-build time, retrieve it at send time\n- Pass span references from the initiating method to the completion callback\n\n**Do NOT use `Map` or other caches to store per-instance context.** Always use the dynamic field on the relevant `EnhancedInstance`. Maps introduce memory leaks, concurrency issues, and are slower than the direct field access that `EnhancedInstance` provides.\n\n**Principle 3: Intercept the minimal set of methods.**\nPrefer one well-chosen interception point over many surface-level ones. If a library has 20 command methods that all flow through a single `dispatch()` method internally, intercept `dispatch()` — not all 20.\n\n**Principle 4: Pick points where you can do inject\u002Fextract for cross-process propagation.**\nFor RPC\u002FHTTP\u002FMQ plugins, you need to inject trace context into outgoing requests (ExitSpan) or extract from incoming requests (EntrySpan). The interception point MUST be where headers\u002Fmetadata are writable (inject) or readable (extract). If headers are not accessible at the execution method, look for:\n- A request builder\u002Fdecorator stage where headers can be added\n- A channel\u002Ftransport layer where metadata is attached\n- A message properties object accessible from the method arguments\n\n**Principle 5: Consider the span lifecycle across threads.**\nIf the library dispatches work asynchronously:\n- Identify where the work is submitted (original thread) and where the result arrives (callback\u002Ffuture thread)\n- You may need interception points in both threads\n- Use `EnhancedInstance` dynamic field on the task\u002Fcallback\u002Ffuture object to carry the span or `ContextSnapshot` across the thread boundary\n- Use `prepareForAsync()` \u002F `asyncFinish()` if the span must stay open across threads\n\n### Phase 4: Map Out the Interception Plan\n\nBefore writing code, create a clear plan listing:\n\n| Target Class | Method\u002FConstructor | What to Do | Data Available |\n|---|---|---|---|\n| `XxxClient` | constructor | Store peer address in dynamic field | host, port from args |\n| `XxxConnection` | `execute(Command)` | Create ExitSpan, inject carrier into command headers | command name, peer from dynamic field |\n| `XxxResponseHandler` | `onComplete(Response)` | Set response tags, stop span or asyncFinish | status code, error from args |\n\nFor each interception point, verify:\n- [ ] The data I need is readable from method args, `this`, or `EnhancedInstance` dynamic field — no reflection needed\n- [ ] For inject: I can write headers\u002Fmetadata through a public API on a method argument\n- [ ] For extract: I can read headers\u002Fmetadata through a public API on a method argument\n- [ ] The `this` object (or a method argument) will be enhanced as `EnhancedInstance`, so I can use the dynamic field\n\n### Choosing Span Type\n\n| Scenario | Span Type | Requires |\n|----------|-----------|----------|\n| Receiving requests (HTTP server, MQ consumer, RPC provider) | EntrySpan | Extract ContextCarrier from incoming headers |\n| Making outgoing calls (HTTP client, DB, cache, MQ producer, RPC consumer) | ExitSpan | Peer address; inject ContextCarrier into outgoing headers (for RPC\u002FHTTP\u002FMQ) |\n| Internal processing (annotation-driven, local logic) | LocalSpan | Nothing extra |\n\n### For Meter Plugins\n\nMeter plugins follow the same understand-then-intercept process, but the goal is to find objects that expose numeric state:\n- **Gauges**: Intercept the creation of pool\u002Fexecutor\u002Fconnection-manager objects. Register a `MeterFactory.gauge()` with a supplier lambda that calls the object's own getter methods (e.g., `pool.getActiveCount()`). Store the gauge reference in the dynamic field if needed.\n- **Counters**: Intercept execution methods and call `counter.increment()` on each invocation.\n- **Histograms**: Intercept methods where duration or size is computable (measure between before\u002Fafter, or read from response).\n\n### Check Existing Plugins for Reference\n\nBefore writing a new plugin, check if a similar library already has a plugin:\n```\napm-sniffer\u002Fapm-sdk-plugin\u002F          # 70+ standard plugins\napm-sniffer\u002Foptional-plugins\u002F         # Optional plugins\napm-sniffer\u002Fbootstrap-plugins\u002F        # JDK-level plugins\n```\n\nSimilar libraries often share execution patterns. Study how an existing plugin for a similar library solved the same problems — especially how it chains dynamic fields across multiple interception points and where it does inject\u002Fextract.\n\n### Verify Against Actual Source Code — Never Speculate\n\n**This applies to both new plugin development AND extending existing plugins to newer library versions.**\n\nWhen assessing whether a plugin works with a new library version, or when choosing interception points for a new plugin, you MUST read the **actual source code** of the target library at the specific version. Do NOT rely on:\n- Version number assumptions (\"it's still 4.x so it should be compatible\")\n- Changelog summaries (they don't list every internal class rename or method removal)\n- General knowledge about the library's public API (plugins intercept internal classes, which change without notice)\n\n**What to verify for each intercepted class\u002Fmethod:**\n1. Does the target class still exist at the exact FQCN? (internal classes get renamed, extracted, or removed between minor versions)\n2. Does the intercepted method still exist with a compatible signature? (parameters may be added\u002Fremoved\u002Freordered)\n3. Do the witness classes still correctly distinguish versions? (a witness class that exists in both old and new versions won't prevent the plugin from loading on an incompatible version)\n4. Do the runtime APIs called by the interceptor still exist? (e.g., calling `cluster.getDescription()` will crash if that method was removed, even if the plugin loaded successfully)\n\n**How to verify — clone the library source locally:**\n```bash\n# Clone specific version tag to \u002Ftmp for easy source code inspection\ncd \u002Ftmp && git clone --depth 1 --branch {tag} https:\u002F\u002Fgithub.com\u002F{org}\u002F{repo}.git {local-name}\n\n# Examples:\ngit clone --depth 1 --branch r4.9.0 https:\u002F\u002Fgithub.com\u002Fmongodb\u002Fmongo-java-driver.git mongo-4.9\ngit clone --depth 1 --branch v2.4.13.RELEASE https:\u002F\u002Fgithub.com\u002Fspring-projects\u002Fspring-kafka.git spring-kafka-2.4\n\n# Then grep\u002Fread the actual source files to check class\u002Fmethod existence\ngrep -rn \"getFilter\\|getWriteRequests\" \u002Ftmp\u002Fmongo-4.9\u002Fdriver-core\u002Fsrc\u002Fmain\u002Fcom\u002Fmongodb\u002Finternal\u002Foperation\u002F\n```\n\nThis is faster and more reliable than fetching individual files via raw GitHub URLs. You can `grep`, `diff` between versions, and trace the full execution path.\n\n**Also check for import-time class loading failures:**\nIf a plugin helper class (not just the instrumentation class) imports a library class that was removed, the entire helper class will fail to load with `NoClassDefFoundError` at runtime. This silently breaks ALL functionality in that helper — not just the code paths using the removed class. Verify that every `import` statement in plugin support classes resolves to an existing class in the target version.\n\n**Real examples of why this matters:**\n- MongoDB driver 4.9 removed `InsertOperation`, `DeleteOperation`, `UpdateOperation` — `MongoOperationHelper` imported all three, causing the entire class to fail loading with `NoClassDefFoundError`, silently losing ALL `db.bind_vars` tags even for operations that still exist (like `FindOperation`, `AggregateOperation`)\n- MongoDB driver 4.11 removed `Cluster.getDescription()` — the plugin loads (witness classes pass) but crashes at runtime with `NoSuchMethodError`\n- Feign 12.2 moved `ReflectiveFeign$BuildTemplateByResolvingArgs` to `RequestTemplateFactoryResolver$BuildTemplateByResolvingArgs` — the path variable interception silently stops working\n- MariaDB 3.0 renamed every JDBC wrapper class (`MariaDbConnection` → `Connection`) — none of the plugin's `byName` matchers match anything\n\n**When extending `support-version.list` to add newer versions:**\nBefore adding a version, verify that every class and method the plugin intercepts still exists in that version's source. A plugin test passing does not mean everything works — it only means the test scenario's specific code path exercised the intercepted methods. Missing interception points may go undetected if the test doesn't cover them.\n\n## Step 2 - Create Plugin Module\n\n### Directory Structure\n\n**SDK plugin** (most common):\n```\napm-sniffer\u002Fapm-sdk-plugin\u002F{framework}-{version}-plugin\u002F\n  pom.xml\n  src\u002Fmain\u002Fjava\u002Forg\u002Fapache\u002Fskywalking\u002Fapm\u002Fplugin\u002F{framework}\u002Fv{N}\u002F\n    define\u002F\n      {Target}Instrumentation.java          # One per target class\n    {Target}Interceptor.java                # One per interception concern\n    {Target}ConstructorInterceptor.java     # If intercepting constructors\n    {PluginName}PluginConfig.java           # If plugin needs configuration\n  src\u002Fmain\u002Fresources\u002F\n    skywalking-plugin.def                   # Plugin registration\n  src\u002Ftest\u002Fjava\u002Forg\u002Fapache\u002Fskywalking\u002Fapm\u002Fplugin\u002F{framework}\u002Fv{N}\u002F\n    {Target}InterceptorTest.java            # Unit tests\n```\n\n**Bootstrap plugin** (for JDK classes):\n```\napm-sniffer\u002Fbootstrap-plugins\u002F{name}-plugin\u002F\n  (same structure, but instrumentation class overrides isBootstrapInstrumentation)\n```\n\n**Optional plugin**:\n```\napm-sniffer\u002Foptional-plugins\u002F{name}-plugin\u002F\n  (same structure as SDK plugin)\n```\n\n### pom.xml Template\n\n```xml\n\u003C?xml version=\"1.0\" encoding=\"UTF-8\"?>\n\u003Cproject xmlns=\"http:\u002F\u002Fmaven.apache.org\u002FPOM\u002F4.0.0\"\n         xmlns:xsi=\"http:\u002F\u002Fwww.w3.org\u002F2001\u002FXMLSchema-instance\"\n         xsi:schemaLocation=\"http:\u002F\u002Fmaven.apache.org\u002FPOM\u002F4.0.0 http:\u002F\u002Fmaven.apache.org\u002Fxsd\u002Fmaven-4.0.0.xsd\">\n    \u003CmodelVersion>4.0.0\u003C\u002FmodelVersion>\n\n    \u003Cparent>\n        \u003CgroupId>org.apache.skywalking\u003C\u002FgroupId>\n        \u003CartifactId>apm-sdk-plugin\u003C\u002FartifactId>  \u003C!-- or bootstrap-plugins \u002F optional-plugins -->\n        \u003Cversion>${revision}\u003C\u002Fversion>\n    \u003C\u002Fparent>\n\n    \u003CartifactId>{framework}-{version}-plugin\u003C\u002FartifactId>\n    \u003Cpackaging>jar\u003C\u002Fpackaging>\n\n    \u003Cproperties>\n        \u003Ctarget-library.version>X.Y.Z\u003C\u002Ftarget-library.version>\n    \u003C\u002Fproperties>\n\n    \u003Cdependencies>\n        \u003C!-- Target library - MUST be provided scope -->\n        \u003Cdependency>\n            \u003CgroupId>com.example\u003C\u002FgroupId>\n            \u003CartifactId>target-library\u003C\u002FartifactId>\n            \u003Cversion>${target-library.version}\u003C\u002Fversion>\n            \u003Cscope>provided\u003C\u002Fscope>\n        \u003C\u002Fdependency>\n    \u003C\u002Fdependencies>\n\u003C\u002Fproject>\n```\n\n**CRITICAL dependency rules:**\n- Target library: **always `provided` scope** (supplied by the application at runtime)\n- `apm-agent-core`: inherited from parent POM as `provided`\n- `apm-util`: inherited from parent POM as `provided`\n- Never bundle target library classes into the plugin JAR\n- If the plugin needs a 3rd-party utility not already in agent-core, discuss with maintainers first\n\n**CRITICAL compiler level rule:**\n- Do NOT set `maven.compiler.release` or `maven.compiler.source\u002Ftarget` unless the plugin source code itself uses JDK 9+ language features (e.g., `var`, records, sealed classes, `java.net.http.HttpClient`).\n- A `provided`-scope dependency targeting a higher JDK (e.g., Spring AI requires JDK 17+) does NOT require raising the compiler level — the plugin only references the library's API at compile time.\n- Bootstrap plugins like `jdk-httpclient-plugin` (which uses JDK 11 `HttpClient` API directly in plugin source code) legitimately need a higher compiler target. SDK plugins and optional plugins generally should not.\n\n### Register in Parent POM\n\nAdd the new module to the parent `pom.xml`:\n```xml\n\u003Cmodules>\n    ...\n    \u003Cmodule>{framework}-{version}-plugin\u003C\u002Fmodule>\n\u003C\u002Fmodules>\n```\n\n## Step 3 - Implement Instrumentation Class (V2 API)\n\n**ALWAYS use V2 API for new plugins.** V1 is legacy.\n\n### Import Rules (Enforced by Checkstyle)\n\nPlugins may ONLY import from:\n- `java.*` - Java standard library\n- `org.apache.skywalking.*` - SkyWalking modules\n- `net.bytebuddy.*` - ByteBuddy (for matchers in instrumentation classes)\n\n**No other 3rd-party imports are allowed in instrumentation\u002Factivation files.** This is enforced by `apm-checkstyle\u002FimportControl.xml`. Interceptor classes CAN reference target library classes (they're loaded after the target library).\n\n### Class Matching\n\n**CRITICAL: NEVER use `.class` references in instrumentation definitions.** Always use string literals.\n\n```java\n\u002F\u002F WRONG - breaks agent if class doesn't exist at runtime\nbyName(SomeThirdPartyClass.class.getName())\ntakesArgument(0, SomeThirdPartyClass.class)\n\n\u002F\u002F CORRECT - safe string literals\nbyName(\"com.example.SomeThirdPartyClass\")\ntakesArgumentWithType(0, \"com.example.SomeThirdPartyClass\")\n```\n\nAvailable ClassMatch types (from `org.apache.skywalking.apm.agent.core.plugin.match`):\n\n| Matcher | Usage | Performance |\n|---------|-------|-------------|\n| `NameMatch.byName(String)` | Exact class name | Best (HashMap lookup) |\n| `MultiClassNameMatch.byMultiClassMatch(String...)` | Multiple exact names | Good |\n| `HierarchyMatch.byHierarchyMatch(String...)` | Implements interface \u002F extends class | Expensive - avoid unless necessary |\n| `ClassAnnotationMatch.byClassAnnotationMatch(String...)` | Has annotation(s) | Moderate |\n| `MethodAnnotationMatch.byMethodAnnotationMatch(String...)` | Has method with annotation | Moderate |\n| `PrefixMatch.nameStartsWith(String...)` | Class name prefix | Moderate |\n| `RegexMatch.byRegexMatch(String...)` | Regex on class name | Expensive |\n| `LogicalMatchOperation.and(match1, match2)` | AND composition | Depends on operands |\n| `LogicalMatchOperation.or(match1, match2)` | OR composition | Depends on operands |\n\n**Prefer `NameMatch.byName()` whenever possible.** It uses a fast HashMap lookup. All other matchers require linear scanning.\n\n### Method Matching (ByteBuddy ElementMatcher API)\n\nCommon matchers from `net.bytebuddy.matcher.ElementMatchers`:\n\n```java\n\u002F\u002F By name\nnamed(\"methodName\")\n\n\u002F\u002F By argument count\ntakesArguments(2)\ntakesArguments(0)  \u002F\u002F no-arg methods\n\n\u002F\u002F By argument type (use SkyWalking's helper - string-based, safe)\nimport static org.apache.skywalking.apm.agent.core.plugin.bytebuddy.ArgumentTypeNameMatch.takesArgumentWithType;\ntakesArgumentWithType(0, \"com.example.SomeType\")  \u002F\u002F arg at index 0\n\n\u002F\u002F By return type (SkyWalking helper)\nimport static org.apache.skywalking.apm.agent.core.plugin.bytebuddy.ReturnTypeNameMatch.returnsWithType;\nreturnsWithType(\"java.util.List\")\n\n\u002F\u002F By annotation (SkyWalking helper - string-based)\nimport static org.apache.skywalking.apm.agent.core.plugin.bytebuddy.AnnotationTypeNameMatch.isAnnotatedWithType;\nisAnnotatedWithType(\"org.springframework.web.bind.annotation.RequestMapping\")\n\n\u002F\u002F Visibility\nisPublic()\nisPrivate()\n\n\u002F\u002F Composition\nnamed(\"execute\").and(takesArguments(1))\nnamed(\"method1\").or(named(\"method2\"))\nnot(isDeclaredBy(Object.class))\n\n\u002F\u002F Match any (use sparingly)\nany()\n```\n\n### Instrumentation Template - Instance Methods\n\n```java\npackage org.apache.skywalking.apm.plugin.xxx.define;\n\nimport net.bytebuddy.description.method.MethodDescription;\nimport net.bytebuddy.matcher.ElementMatcher;\nimport org.apache.skywalking.apm.agent.core.plugin.interceptor.ConstructorInterceptPoint;\nimport org.apache.skywalking.apm.agent.core.plugin.interceptor.v2.InstanceMethodsInterceptV2Point;\nimport org.apache.skywalking.apm.agent.core.plugin.interceptor.enhance.v2.ClassInstanceMethodsEnhancePluginDefineV2;\nimport org.apache.skywalking.apm.agent.core.plugin.match.ClassMatch;\nimport org.apache.skywalking.apm.agent.core.plugin.match.NameMatch;\n\nimport static net.bytebuddy.matcher.ElementMatchers.named;\n\npublic class XxxInstrumentation extends ClassInstanceMethodsEnhancePluginDefineV2 {\n\n    private static final String ENHANCE_CLASS = \"com.example.TargetClass\";\n    private static final String INTERCEPTOR_CLASS = \"org.apache.skywalking.apm.plugin.xxx.XxxInterceptor\";\n\n    @Override\n    protected ClassMatch enhanceClass() {\n        return NameMatch.byName(ENHANCE_CLASS);\n    }\n\n    @Override\n    public ConstructorInterceptPoint[] getConstructorsInterceptPoints() {\n        return null;  \u002F\u002F null or empty array if not intercepting constructors\n    }\n\n    @Override\n    public InstanceMethodsInterceptV2Point[] getInstanceMethodsInterceptV2Points() {\n        return new InstanceMethodsInterceptV2Point[] {\n            new InstanceMethodsInterceptV2Point() {\n                @Override\n                public ElementMatcher\u003CMethodDescription> getMethodsMatcher() {\n                    return named(\"targetMethod\");\n                }\n\n                @Override\n                public String getMethodsInterceptorV2() {\n                    return INTERCEPTOR_CLASS;\n                }\n\n                @Override\n                public boolean isOverrideArgs() {\n                    return false;\n                }\n            }\n        };\n    }\n}\n```\n\n### Instrumentation Template - Static Methods\n\n```java\nimport org.apache.skywalking.apm.agent.core.plugin.interceptor.StaticMethodsInterceptPoint;\nimport org.apache.skywalking.apm.agent.core.plugin.interceptor.enhance.v2.ClassStaticMethodsEnhancePluginDefineV2;\n\npublic class XxxStaticInstrumentation extends ClassStaticMethodsEnhancePluginDefineV2 {\n    @Override\n    public StaticMethodsInterceptPoint[] getStaticMethodsInterceptPoints() {\n        return new StaticMethodsInterceptPoint[] {\n            new StaticMethodsInterceptPoint() {\n                @Override\n                public ElementMatcher\u003CMethodDescription> getMethodsMatcher() {\n                    return named(\"factoryMethod\").and(takesArguments(2));\n                }\n\n                @Override\n                public String getMethodsInterceptor() {\n                    return INTERCEPTOR_CLASS;\n                }\n\n                @Override\n                public boolean isOverrideArgs() {\n                    return false;\n                }\n            }\n        };\n    }\n\n    @Override\n    protected ClassMatch enhanceClass() {\n        return NameMatch.byName(ENHANCE_CLASS);\n    }\n}\n```\n\n### Instrumentation Template - Both Instance + Static Methods\n\nExtend `ClassEnhancePluginDefineV2` and implement all four methods:\n- `enhanceClass()`\n- `getConstructorsInterceptPoints()`\n- `getInstanceMethodsInterceptV2Points()`\n- `getStaticMethodsInterceptPoints()`\n\n### Matching Interface\u002FAbstract Class Implementations\n\nUse `HierarchyMatch` when you need to intercept all implementations of an interface:\n\n```java\nimport org.apache.skywalking.apm.agent.core.plugin.match.HierarchyMatch;\n\n@Override\nprotected ClassMatch enhanceClass() {\n    return HierarchyMatch.byHierarchyMatch(\"com.example.SomeInterface\");\n}\n```\n\n**When to use HierarchyMatch:**\n- The library has an interface\u002Fabstract class with multiple implementations\n- You cannot enumerate all implementation class names\n- Example: intercepting all `javax.servlet.Servlet` implementations\n\n**Performance warning:** HierarchyMatch checks every loaded class against the hierarchy. Prefer `NameMatch` or `MultiClassNameMatch` if you know the concrete class names.\n\n**Combining with other matchers:**\n```java\nimport org.apache.skywalking.apm.agent.core.plugin.match.logical.LogicalMatchOperation;\n\n@Override\nprotected ClassMatch enhanceClass() {\n    return LogicalMatchOperation.and(\n        PrefixMatch.nameStartsWith(\"com.example\"),\n        HierarchyMatch.byHierarchyMatch(\"java.lang.Runnable\")\n    );\n}\n```\n\n### Witness Classes for Version Detection\n\nOverride `witnessClasses()` or `witnessMethods()` to activate the plugin only for specific library versions:\n\n```java\n@Override\nprotected String[] witnessClasses() {\n    \u002F\u002F Plugin only loads if this class exists in the application\n    return new String[] {\"com.example.VersionSpecificClass\"};\n}\n\n@Override\nprotected List\u003CWitnessMethod> witnessMethods() {\n    return Collections.singletonList(\n        new WitnessMethod(\"com.example.SomeClass\", ElementMatchers.named(\"methodAddedInV2\"))\n    );\n}\n```\n\n### Bootstrap Plugin Override\n\nFor bootstrap plugins (instrumenting JDK classes), add:\n```java\n@Override\npublic boolean isBootstrapInstrumentation() {\n    return true;\n}\n```\n\n**Bootstrap plugin rules:**\n- Only for JDK core classes (java.*, javax.*, sun.*)\n- Minimal interception scope (performance-critical paths)\n- Extra care with class loading (bootstrap classloader visibility)\n- Test with `runningMode: with_bootstrap`\n\n## Step 4 - Implement Interceptor Class (V2 API)\n\n### Available Interceptor Interfaces\n\n| Interface | Use Case |\n|-----------|----------|\n| `InstanceMethodsAroundInterceptorV2` | Instance method interception |\n| `StaticMethodsAroundInterceptorV2` | Static method interception |\n| `InstanceConstructorInterceptor` | Constructor interception (shared V1\u002FV2) |\n\n### Core APIs Available in Interceptors\n\n**ContextManager** - Central tracing API (ThreadLocal-based):\n\n**CRITICAL threading rule:** All span lifecycle APIs (`createEntrySpan`, `createExitSpan`, `createLocalSpan`, `activeSpan`, `stopSpan`) operate on a **per-thread context via ThreadLocal**. By default, `createXxxSpan` and `stopSpan` MUST be called in the **same thread**. There are only two ways to work across threads:\n1. **`ContextSnapshot` (capture\u002Fcontinued)** — snapshot the context in thread A, then `continued()` in thread B to link a NEW span in thread B back to the parent trace. Each thread manages its own span lifecycle independently.\n2. **Async mode (`prepareForAsync`\u002F`asyncFinish`)** — keeps a single span alive beyond the creating thread. Call `prepareForAsync()` in the original thread (before `stopSpan`), then `asyncFinish()` from any thread when the async work completes. Between `prepareForAsync` and `asyncFinish`, you may call tag\u002Flog\u002Ferror on the span from any thread, but you must NOT call `ContextManager.stopSpan()` for that span again.\n\n```java\nimport org.apache.skywalking.apm.agent.core.context.ContextManager;\n\n\u002F\u002F Create spans (must stopSpan in the SAME thread, unless async mode)\nAbstractSpan span = ContextManager.createEntrySpan(operationName, contextCarrier);\nAbstractSpan span = ContextManager.createLocalSpan(operationName);\nAbstractSpan span = ContextManager.createExitSpan(operationName, contextCarrier, remotePeer);\nAbstractSpan span = ContextManager.createExitSpan(operationName, remotePeer);\n\n\u002F\u002F Span lifecycle (same thread as create, unless async mode)\nContextManager.activeSpan();      \u002F\u002F Get current span in THIS thread\nContextManager.stopSpan();        \u002F\u002F Stop current span in THIS thread\nContextManager.isActive();        \u002F\u002F Check if context exists in THIS thread\n\n\u002F\u002F Cross-process propagation (inject\u002Fextract ContextCarrier into headers\u002Fmetadata)\nContextManager.inject(carrier);   \u002F\u002F Inject into outgoing carrier\nContextManager.extract(carrier);  \u002F\u002F Extract from incoming carrier\n\n\u002F\u002F Cross-thread propagation (ContextSnapshot — link spans across threads)\nContextManager.capture();         \u002F\u002F Capture snapshot in originating thread\nContextManager.continued(snapshot); \u002F\u002F Continue from snapshot in receiving thread\n\n\u002F\u002F Trace metadata\nContextManager.getGlobalTraceId();\nContextManager.getSegmentId();\nContextManager.getSpanId();\n```\n\n**AbstractSpan** - Span configuration:\n```java\nspan.setComponent(ComponentsDefine.YOUR_COMPONENT);  \u002F\u002F Required for Entry\u002FExit\nspan.setLayer(SpanLayer.HTTP);                        \u002F\u002F Required for Entry\u002FExit\nspan.setOperationName(\"GET:\u002Fapi\u002Fusers\");\nspan.setPeer(\"host:port\");                            \u002F\u002F Required for Exit spans\n\n\u002F\u002F Tags\nspan.tag(Tags.URL, url);\nspan.tag(Tags.HTTP_RESPONSE_STATUS_CODE, statusCode);\nspan.tag(Tags.DB_TYPE, \"sql\");\nspan.tag(Tags.DB_STATEMENT, sql);\nspan.tag(Tags.ofKey(\"custom.key\"), value);\n\n\u002F\u002F Error handling\nspan.errorOccurred();\nspan.log(throwable);\n\n\u002F\u002F Async support\nspan.prepareForAsync();  \u002F\u002F Must call in original thread\nspan.asyncFinish();      \u002F\u002F Call in async thread when done\n```\n\n**SpanLayer** values: `DB`, `RPC_FRAMEWORK`, `HTTP`, `MQ`, `CACHE`, `GEN_AI`\n\n**Standard Tags** (from `org.apache.skywalking.apm.agent.core.context.tag.Tags`):\n\n| Tag                 | Constant                         | Purpose                  |\n|---------------------|----------------------------------|--------------------------|\n| `url`               | `Tags.URL`                       | Request URL              |\n| `http.status_code`  | `Tags.HTTP_RESPONSE_STATUS_CODE` | HTTP status (IntegerTag) |\n| `http.method`       | `Tags.HTTP.METHOD`               | HTTP method              |\n| `db.type`           | `Tags.DB_TYPE`                   | Database type            |\n| `db.instance`       | `Tags.DB_INSTANCE`               | Database name            |\n| `db.statement`      | `Tags.DB_STATEMENT`              | SQL\u002Fquery                |\n| `db.bind_variables` | `Tags.DB_BIND_VARIABLES`         | Bound params             |\n| `mq.queue`          | `Tags.MQ_QUEUE`                  | Queue name               |\n| `mq.topic`          | `Tags.MQ_TOPIC`                  | Topic name               |\n| `mq.broker`         | `Tags.MQ_BROKER`                 | Broker address           |\n| `cache.type`        | `Tags.CACHE_TYPE`                | Cache type               |\n| `cache.op`          | `Tags.CACHE_OP`                  | \"read\" or \"write\"        |\n| `cache.cmd`         | `Tags.CACHE_CMD`                 | Cache command            |\n| `cache.key`         | `Tags.CACHE_KEY`                 | Cache key                |\n| Custom              | `Tags.ofKey(\"key\")`              | Any custom tag           |\n\n**EnhancedInstance** - Dynamic field for cross-interceptor data:\n```java\n\u002F\u002F Store data (e.g., in constructor interceptor)\nobjInst.setSkyWalkingDynamicField(connectionInfo);\n\n\u002F\u002F Retrieve data (e.g., in method interceptor)\nConnectionInfo info = (ConnectionInfo) objInst.getSkyWalkingDynamicField();\n```\n\n**Logging** - Agent-internal logging (NOT application logging):\n```java\nimport org.apache.skywalking.apm.agent.core.logging.api.ILog;\nimport org.apache.skywalking.apm.agent.core.logging.api.LogManager;\n\nprivate static final ILog LOGGER = LogManager.getLogger(MyInterceptor.class);\nLOGGER.info(\"message: {}\", value);\nLOGGER.error(\"error\", throwable);\n```\n\n**MeterFactory** - For meter plugins:\n```java\nimport org.apache.skywalking.apm.toolkit.meter.MeterFactory;\nimport org.apache.skywalking.apm.toolkit.meter.Counter;\nimport org.apache.skywalking.apm.toolkit.meter.Gauge;\nimport org.apache.skywalking.apm.toolkit.meter.Histogram;\n\nCounter counter = MeterFactory.counter(\"metric_name\")\n    .tag(\"key\", \"value\")\n    .mode(Counter.Mode.INCREMENT)\n    .build();\ncounter.increment(1.0);\n\nGauge gauge = MeterFactory.gauge(\"metric_name\", () -> pool.getActiveCount())\n    .tag(\"pool_name\", name)\n    .build();\n\nHistogram histogram = MeterFactory.histogram(\"metric_name\")\n    .steps(Arrays.asList(10.0, 50.0, 100.0, 500.0))\n    .minValue(0)\n    .build();\nhistogram.addValue(latencyMs);\n```\n\n### Interceptor Template - ExitSpan (Client\u002FProducer)\n\n```java\npackage org.apache.skywalking.apm.plugin.xxx;\n\nimport java.lang.reflect.Method;\nimport org.apache.skywalking.apm.agent.core.context.CarrierItem;\nimport org.apache.skywalking.apm.agent.core.context.ContextCarrier;\nimport org.apache.skywalking.apm.agent.core.context.ContextManager;\nimport org.apache.skywalking.apm.agent.core.context.tag.Tags;\nimport org.apache.skywalking.apm.agent.core.context.trace.AbstractSpan;\nimport org.apache.skywalking.apm.agent.core.context.trace.SpanLayer;\nimport org.apache.skywalking.apm.agent.core.plugin.interceptor.enhance.EnhancedInstance;\nimport org.apache.skywalking.apm.agent.core.plugin.interceptor.enhance.v2.InstanceMethodsAroundInterceptorV2;\nimport org.apache.skywalking.apm.agent.core.plugin.interceptor.enhance.v2.MethodInvocationContext;\nimport org.apache.skywalking.apm.network.trace.component.ComponentsDefine;\n\npublic class XxxClientInterceptor implements InstanceMethodsAroundInterceptorV2 {\n\n    @Override\n    public void beforeMethod(EnhancedInstance objInst, Method method, Object[] allArguments,\n                             Class\u003C?>[] argumentsTypes, MethodInvocationContext context) throws Throwable {\n        \u002F\u002F 1. Build peer address from stored connection info\n        String remotePeer = (String) objInst.getSkyWalkingDynamicField();\n\n        \u002F\u002F 2. Create ExitSpan with ContextCarrier for cross-process propagation\n        ContextCarrier contextCarrier = new ContextCarrier();\n        AbstractSpan span = ContextManager.createExitSpan(\"operation\u002Fname\", contextCarrier, remotePeer);\n        span.setComponent(ComponentsDefine.YOUR_COMPONENT);\n        SpanLayer.asHttp(span);  \u002F\u002F or asDB, asMQ, asRPCFramework, asCache\n\n        \u002F\u002F 3. Inject trace context into outgoing request headers\n        \u002F\u002F The request object is typically one of the method arguments\n        CarrierItem next = contextCarrier.items();\n        while (next.hasNext()) {\n            next = next.next();\n            \u002F\u002F Set header on the outgoing request:\n            \u002F\u002F request.setHeader(next.getHeadKey(), next.getHeadValue());\n        }\n\n        \u002F\u002F 4. Set tags\n        Tags.URL.set(span, url);\n\n        \u002F\u002F 5. Store span in context for afterMethod\n        context.setContext(span);\n    }\n\n    @Override\n    public Object afterMethod(EnhancedInstance objInst, Method method, Object[] allArguments,\n                              Class\u003C?>[] argumentsTypes, Object ret, MethodInvocationContext context) throws Throwable {\n        \u002F\u002F Check response status, set tags\u002Ferrors\n        AbstractSpan span = (AbstractSpan) context.getContext();\n        \u002F\u002F Example: Tags.HTTP_RESPONSE_STATUS_CODE.set(span, statusCode);\n        \u002F\u002F if (statusCode >= 400) span.errorOccurred();\n\n        ContextManager.stopSpan();\n        return ret;\n    }\n\n    @Override\n    public void handleMethodException(EnhancedInstance objInst, Method method, Object[] allArguments,\n                                      Class\u003C?>[] argumentsTypes, Throwable t, MethodInvocationContext context) {\n        ContextManager.activeSpan().log(t);\n        ContextManager.activeSpan().errorOccurred();\n    }\n}\n```\n\n### Interceptor Template - EntrySpan (Server\u002FConsumer)\n\n```java\npublic class XxxServerInterceptor implements InstanceMethodsAroundInterceptorV2 {\n\n    @Override\n    public void beforeMethod(EnhancedInstance objInst, Method method, Object[] allArguments,\n                             Class\u003C?>[] argumentsTypes, MethodInvocationContext context) throws Throwable {\n        \u002F\u002F 1. Extract trace context from incoming request headers\n        ContextCarrier contextCarrier = new ContextCarrier();\n        CarrierItem next = contextCarrier.items();\n        while (next.hasNext()) {\n            next = next.next();\n            \u002F\u002F Read header from incoming request:\n            \u002F\u002F next.setHeadValue(request.getHeader(next.getHeadKey()));\n        }\n\n        \u002F\u002F 2. Create EntrySpan (extracts context automatically)\n        AbstractSpan span = ContextManager.createEntrySpan(\"operation\u002Fname\", contextCarrier);\n        span.setComponent(ComponentsDefine.YOUR_COMPONENT);\n        SpanLayer.asHttp(span);  \u002F\u002F or asMQ, asRPCFramework\n        span.setPeer(clientAddress);  \u002F\u002F Optional: client address\n\n        context.setContext(span);\n    }\n\n    @Override\n    public Object afterMethod(EnhancedInstance objInst, Method method, Object[] allArguments,\n                              Class\u003C?>[] argumentsTypes, Object ret, MethodInvocationContext context) throws Throwable {\n        ContextManager.stopSpan();\n        return ret;\n    }\n\n    @Override\n    public void handleMethodException(EnhancedInstance objInst, Method method, Object[] allArguments,\n                                      Class\u003C?>[] argumentsTypes, Throwable t, MethodInvocationContext context) {\n        ContextManager.activeSpan().log(t);\n        ContextManager.activeSpan().errorOccurred();\n    }\n}\n```\n\n### Interceptor Template - Constructor (Store Connection Info)\n\n```java\nimport org.apache.skywalking.apm.agent.core.plugin.interceptor.enhance.InstanceConstructorInterceptor;\n\npublic class XxxConstructorInterceptor implements InstanceConstructorInterceptor {\n\n    @Override\n    public void onConstruct(EnhancedInstance objInst, Object[] allArguments) {\n        \u002F\u002F Store connection info for later use by method interceptors\n        String host = (String) allArguments[0];\n        int port = (int) allArguments[1];\n        objInst.setSkyWalkingDynamicField(host + \":\" + port);\n    }\n}\n```\n\n### Cross-Thread Context Propagation (ContextSnapshot)\n\nUse `ContextSnapshot` when the library dispatches work to another thread and you want the new thread's spans to be linked to the parent trace. Each thread creates and stops its OWN spans — the snapshot only provides the link.\n\n```java\n\u002F\u002F Thread A (originating thread) — create span, capture snapshot, stop span (all same thread)\n@Override\npublic void beforeMethod(..., MethodInvocationContext context) {\n    AbstractSpan span = ContextManager.createLocalSpan(\"async\u002Fdispatch\");\n    \u002F\u002F Capture context snapshot BEFORE handing off to another thread\n    ContextSnapshot snapshot = ContextManager.capture();\n    \u002F\u002F Store snapshot on the task object via EnhancedInstance dynamic field\n    ((EnhancedInstance) allArguments[0]).setSkyWalkingDynamicField(snapshot);\n    ContextManager.stopSpan();  \u002F\u002F Stop span in THIS thread (same thread as create)\n}\n\n\u002F\u002F Thread B (receiving thread) — create its OWN span, link to parent via continued()\n@Override\npublic void beforeMethod(EnhancedInstance objInst, ...) {\n    ContextSnapshot snapshot = (ContextSnapshot) objInst.getSkyWalkingDynamicField();\n    if (snapshot != null) {\n        AbstractSpan span = ContextManager.createLocalSpan(\"async\u002Fexecute\");\n        ContextManager.continued(snapshot);  \u002F\u002F Link this span to the parent trace\n    }\n}\n\n@Override\npublic Object afterMethod(...) {\n    if (ContextManager.isActive()) {\n        ContextManager.stopSpan();  \u002F\u002F Stop span in THIS thread (same thread as create)\n    }\n    return ret;\n}\n```\n\n### Async Span Pattern (prepareForAsync \u002F asyncFinish)\n\nUse this when a **single span** needs to stay open across thread boundaries — e.g., an ExitSpan created before an async call, finished when the callback fires in another thread. The key difference from ContextSnapshot: here one span lives across threads instead of each thread having its own span.\n\n```java\n\u002F\u002F Thread A — create span, mark async, stop context (all same thread)\n@Override\npublic void beforeMethod(..., MethodInvocationContext context) {\n    AbstractSpan span = ContextManager.createExitSpan(\"async\u002Fcall\", remotePeer);\n    span.setComponent(ComponentsDefine.YOUR_COMPONENT);\n    SpanLayer.asHttp(span);\n\n    span.prepareForAsync();       \u002F\u002F Mark: this span will finish in another thread\n    ContextManager.stopSpan();    \u002F\u002F Detach from THIS thread's context (required, same thread as create)\n\n    \u002F\u002F Store span reference on the callback object's dynamic field\n    ((EnhancedInstance) callback).setSkyWalkingDynamicField(span);\n}\n\n\u002F\u002F Thread B (callback\u002Fcompletion handler) — finish the async span\n@Override\npublic void beforeMethod(EnhancedInstance objInst, ...) {\n    AbstractSpan span = (AbstractSpan) objInst.getSkyWalkingDynamicField();\n    if (span != null) {\n        \u002F\u002F Add response info to the span (tag\u002Flog\u002Ferror are thread-safe after prepareForAsync)\n        span.tag(Tags.HTTP_RESPONSE_STATUS_CODE, statusCode);\n        if (isError) span.errorOccurred();\n        span.asyncFinish();  \u002F\u002F Must match prepareForAsync count\n    }\n}\n```\n\n### Plugin Configuration (Optional)\n\n```java\nimport org.apache.skywalking.apm.agent.core.boot.PluginConfig;\n\npublic class XxxPluginConfig {\n    public static class Plugin {\n        @PluginConfig(root = XxxPluginConfig.class)\n        public static class Xxx {\n            \u002F\u002F Config key: plugin.xxx.trace_param\n            public static boolean TRACE_PARAM = false;\n            \u002F\u002F Config key: plugin.xxx.max_length\n            public static int MAX_LENGTH = 256;\n        }\n    }\n}\n```\n\n## Step 5 - Register Plugin\n\nCreate `src\u002Fmain\u002Fresources\u002Fskywalking-plugin.def`:\n```\nplugin-name=org.apache.skywalking.apm.plugin.xxx.define.XxxInstrumentation\nplugin-name=org.apache.skywalking.apm.plugin.xxx.define.XxxOtherInstrumentation\n```\n\nFormat: `{plugin-id}={fully.qualified.InstrumentationClassName}` (one line per instrumentation class, all sharing the same plugin-id prefix).\n\n## Step 6 - Write Unit Tests\n\n### Test Setup Pattern\n\n```java\nimport org.junit.Before;\nimport org.junit.Rule;\nimport org.junit.Test;\nimport org.junit.runner.RunWith;\nimport org.mockito.Mock;\nimport org.mockito.junit.MockitoJUnit;\nimport org.mockito.junit.MockitoRule;\nimport org.apache.skywalking.apm.agent.core.plugin.interceptor.enhance.EnhancedInstance;\nimport org.apache.skywalking.apm.agent.test.tools.AgentServiceRule;\nimport org.apache.skywalking.apm.agent.test.tools.SegmentStorage;\nimport org.apache.skywalking.apm.agent.test.tools.SegmentStoragePoint;\nimport org.apache.skywalking.apm.agent.test.tools.TracingSegmentRunner;\n\n@RunWith(TracingSegmentRunner.class)\npublic class XxxInterceptorTest {\n\n    @SegmentStoragePoint\n    private SegmentStorage segmentStorage;\n\n    @Rule\n    public AgentServiceRule agentServiceRule = new AgentServiceRule();\n\n    @Rule\n    public MockitoRule rule = MockitoJUnit.rule();\n\n    @Mock\n    private EnhancedInstance enhancedInstance;\n\n    private XxxInterceptor interceptor;\n\n    @Before\n    public void setUp() {\n        interceptor = new XxxInterceptor();\n        \u002F\u002F Setup mocks\n    }\n\n    @Test\n    public void testNormalRequest() throws Throwable {\n        \u002F\u002F Arrange\n        Object[] allArguments = new Object[] { \u002F* mock args *\u002F };\n        Class[] argumentsTypes = new Class[] { \u002F* arg types *\u002F };\n\n        \u002F\u002F Act\n        interceptor.beforeMethod(enhancedInstance, null, allArguments, argumentsTypes, null);\n        interceptor.afterMethod(enhancedInstance, null, allArguments, argumentsTypes, mockResponse, null);\n\n        \u002F\u002F Assert spans\n        assertThat(segmentStorage.getTraceSegments().size(), is(1));\n        TraceSegment segment = segmentStorage.getTraceSegments().get(0);\n        List\u003CAbstractTracingSpan> spans = SegmentHelper.getSpans(segment);\n        assertThat(spans.size(), is(1));\n        \u002F\u002F Verify span properties...\n    }\n}\n```\n\n## Step 7 - Write E2E Plugin Tests\n\n### Test Scenario Structure\n\n```\ntest\u002Fplugin\u002Fscenarios\u002F{framework}-{version}-scenario\u002F\n  bin\u002Fstartup.sh\n  config\u002FexpectedData.yaml\n  src\u002Fmain\u002Fjava\u002Forg\u002Fapache\u002Fskywalking\u002Fapm\u002Ftestcase\u002F{framework}\u002F\n    controller\u002FCaseController.java    # HTTP endpoints\n  pom.xml\n  configuration.yml\n  support-version.list\n```\n\n**When copying an existing scenario to create a new one**, update the scenario name in ALL of these files:\n- `pom.xml` — `artifactId`, `name`, `finalName`\n- `src\u002Fmain\u002Fassembly\u002Fassembly.xml` — JAR filename reference\n- `bin\u002Fstartup.sh` — JAR filename in java -jar command\n- `config\u002FexpectedData.yaml` — `serviceName` field AND `parentService` in refs (but NOT URL paths — those are the app context path)\n- `support-version.list` — new versions\n- For JDK 17+ scenarios: update `compiler.version` to `17`, `spring.boot.version` to `3.x`, change `javax.annotation` imports to `jakarta.annotation` in Java source\n- Add the scenario to the appropriate CI workflow (`plugins-test.*.yaml` for JDK 8, `plugins-jdk17-test.*.yaml` for JDK 17)\n\n### configuration.yml\n\n```yaml\ntype: jvm\nentryService: http:\u002F\u002Flocalhost:8080\u002F{scenario-name}\u002Fcase\u002F{endpoint}\nhealthCheck: http:\u002F\u002Flocalhost:8080\u002F{scenario-name}\u002Fcase\u002FhealthCheck\nstartScript: .\u002Fbin\u002Fstartup.sh\nenvironment: []\ndependencies: {}\n```\n\n### expectedData.yaml for Tracing\n\n```yaml\nsegmentItems:\n  - serviceName: {scenario-name}\n    segmentSize: ge 1\n    segments:\n      - segmentId: not null\n        spans:\n          - operationName: your\u002Foperation\n            parentSpanId: -1\n            spanId: 0\n            spanLayer: Http           # Http, DB, RPCFramework, MQ, CACHE\n            spanType: Exit            # Entry, Exit, Local\n            startTime: nq 0\n            endTime: nq 0\n            componentId: 2            # Must match ComponentsDefine ID\n            isError: false\n            peer: 'host:port'\n            skipAnalysis: 'false'\n            tags:\n              - {key: url, value: not null}\n              - {key: http.method, value: GET}\n            logs: []\n            refs: []\n```\n\n### expectedData.yaml for Meters\n\n```yaml\nmeterItems:\n  - serviceName: {scenario-name}\n    meterSize: ge 1\n    meters:\n      - meterId:\n          name: your_counter_name\n          tags:\n            - {name: tag_key, value: tag_value}\n        singleValue: gt 0\n```\n\n### Assertion Operators\n\n| Operator | Meaning |\n|----------|---------|\n| `eq VALUE` | Equals |\n| `nq VALUE` | Not equals |\n| `ge VALUE` | Greater or equal |\n| `gt VALUE` | Greater than |\n| `not null` | Must be present |\n| `null` | Must be absent |\n\n### Running Tests\n\n```bash\nbash .\u002Ftest\u002Fplugin\u002Frun.sh -f {scenario-name}\nbash .\u002Ftest\u002Fplugin\u002Frun.sh --debug {scenario-name}  # Save actualData.yaml for debugging\n```\n\n**IMPORTANT: Run E2E test scenarios ONE AT A TIME.** Multiple scenarios use the same Docker ports (8080, etc.) and will conflict if run in parallel. Always wait for one scenario to finish before starting the next.\n\n## Step 8 - Shading (Package Relocation)\n\nPlugins automatically inherit ByteBuddy shading from the parent POM:\n```xml\n\u003Crelocation>\n    \u003Cpattern>net.bytebuddy\u003C\u002Fpattern>\n    \u003CshadedPattern>org.apache.skywalking.apm.dependencies.net.bytebuddy\u003C\u002FshadedPattern>\n\u003C\u002Frelocation>\n```\n\nThe agent-core module handles shading of all core dependencies:\n- `com.google.*` -> `org.apache.skywalking.apm.dependencies.com.google.*`\n- `io.grpc.*` -> `org.apache.skywalking.apm.dependencies.io.grpc.*`\n- `io.netty.*` -> `org.apache.skywalking.apm.dependencies.io.netty.*`\n- `org.slf4j.*` -> `org.apache.skywalking.apm.dependencies.org.slf4j.*`\n\n**Plugins should NOT add their own shade configurations** unless they need to bundle a library not in agent-core (rare, requires maintainer approval). If a plugin needs a reporter-level dependency, see `optional-reporter-plugins\u002Fkafka-reporter-plugin\u002Fpom.xml` for the pattern.\n\n## Step 9 - Code Style Checklist\n\nBefore submitting:\n- [ ] No `System.out.println` (use `ILog` from `LogManager`)\n- [ ] No `@author` tags (ASF policy)\n- [ ] No Chinese characters in source\n- [ ] No tab characters (use 4 spaces)\n- [ ] No star imports (`import xxx.*`)\n- [ ] No unused imports\n- [ ] `@Override` on all overridden methods\n- [ ] Apache 2.0 license header on all source files\n- [ ] File length under 3000 lines\n- [ ] Constants in `UPPER_SNAKE_CASE`\n- [ ] Types in `PascalCase`, variables in `camelCase`\n- [ ] Imports only from `java.*`, `org.apache.skywalking.*`, `net.bytebuddy.*` (in instrumentation files)\n- [ ] Target library dependencies in `provided` scope\n- [ ] No unnecessary `maven.compiler.release` or `maven.compiler.source\u002Ftarget` (only set if plugin source uses JDK 9+ language features)\n- [ ] Using V2 API for new plugins\n- [ ] String literals (not `.class` references) in instrumentation definitions\n- [ ] `skywalking-plugin.def` registered\n- [ ] Module added to parent POM\n\n## Step 10 - Update Documentation\n\nAfter verifying the plugin works (locally or via CI), update these documentation files:\n\n**1. `docs\u002Fen\u002Fsetup\u002Fservice-agent\u002Fjava-agent\u002FSupported-list.md`**\nUpdate the version range for the relevant entry. Format example:\n```\n  * [MongoDB Java Driver](https:\u002F\u002Fgithub.com\u002Fmongodb\u002Fmongo-java-driver) 2.13-2.14, 3.4.0-3.12.7, 4.0.0-4.10.2\n```\nFor new plugins, add a new bullet under the appropriate category.\n\n**2. `CHANGES.md`**\nAdd a changelog entry under the current unreleased version section. Format:\n```\n* Extend {plugin-name} plugin to support {library} {version-range}.\n```\nOr for new plugins:\n```\n* Add {framework} {version} plugin.\n```\n\n**3. `test\u002Fplugin\u002Fscenarios\u002F{scenario}\u002Fsupport-version.list`**\nAdd verified versions. Only include the **latest patch version for each minor version** — do not list every patch release.\n\nThe version list supports **extra Maven properties** per version line using comma-separated `key=value` pairs:\n```\n# Simple version (default pom properties)\n2.3.10.RELEASE\n\n# Version with overridden Maven properties\n2.7.14,spring.boot.version=2.5.15\n2.8.11,spring.boot.version=2.7.18\n3.1.4,spring.boot.version=3.2.12\n```\n\nThis is useful when different framework versions need different dependency versions (e.g., spring-kafka minor versions require matching Spring Boot versions). The extra properties are passed as `-D` flags to Maven during the scenario build.\n\n**IMPORTANT:** Maven `-D` overrides work for `\u003Cproperties>` and direct `\u003Cversion>${prop}` references, but do NOT override BOM versions resolved via `\u003CdependencyManagement>` imports. If a BOM version needs to change, set the default in the pom to the highest needed version, not the lowest.\n\n**Spring Boot \u002F Spring Kafka compatibility mapping** (for reference):\n- spring-kafka 2.3-2.6 → Spring Boot 2.3 (default)\n- spring-kafka 2.7 → Spring Boot 2.5 (2.6+ autoconfigure requires `CommonErrorHandler` from spring-kafka 2.8)\n- spring-kafka 2.8-2.9 → Spring Boot 2.7\n- spring-kafka 3.0 → Spring Boot 3.0\n- spring-kafka 3.1-3.3 → Spring Boot 3.2 (requires Spring Framework 6.1)\n\n**This step is mandatory.** Documentation updates are part of the PR requirements.\n\n## Quick Reference - Plugin Type Decision Tree\n\n```\nIs the target a JDK core class (java.*, sun.*)?\n  YES -> Bootstrap plugin (isBootstrapInstrumentation = true)\n  NO  -> Is it commonly used and should be auto-activated?\n           YES -> SDK plugin (apm-sdk-plugin\u002F)\n           NO  -> Optional plugin (optional-plugins\u002F)\n\nWhat span type?\n  Receiving requests (HTTP server, MQ consumer, RPC provider) -> EntrySpan\n  Making outgoing calls (HTTP client, DB, cache, MQ producer) -> ExitSpan\n  Internal processing (annotation, local logic)               -> LocalSpan\n\nNeed cross-process propagation?\n  YES -> Use ContextCarrier (inject on exit, extract on entry)\n  NO  -> No carrier needed\n\nNeed cross-thread propagation?\n  YES -> Use ContextSnapshot (capture + continued) OR prepareForAsync\u002FasyncFinish\n  NO  -> Standard span lifecycle\n\nNeed metrics without traces?\n  YES -> Meter plugin (Counter\u002FGauge\u002FHistogram via MeterFactory)\n\nNeed both traces and metrics?\n  YES -> Separate interceptors or combine in same interceptor\n```",{"name":5,"description":7,"allowed-tools":34,"user-invocable":35},"Read, Write, Edit, Glob, Grep, Bash, Agent",true,"main","1716cc51b9c91da8b1324ea915a17b4caa184896",".claude\u002Fskills\u002Fnew-plugin",694,"https:\u002F\u002Fgithub.com\u002Fapache\u002Fskywalking-java","https:\u002F\u002Fskywalking.apache.org\u002F","https:\u002F\u002Fgithub.com\u002Fapache","https:\u002F\u002Fwww.apache.org\u002F","2026-11-03 10:04:05",{"source":8,"skillName":5,"commands":46,"prompt":56,"zipAvailable":35},[47,50,53],{"tool":48,"command":49},"npx","npx skills add apache\u002Fskywalking-java --skill new-plugin",{"tool":51,"command":52},"bunx","bunx skills add apache\u002Fskywalking-java --skill new-plugin",{"tool":54,"command":55},"pnpm","pnpm dlx skills add apache\u002Fskywalking-java --skill new-plugin","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fapache\u002Fskywalking-java\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fnew-plugin\u002FSKILL.md",[58,64,70,74,78,82,86,90,94,100,104,108,112,116,120,124,128,132,136,140,144,148,152,156,160,164,168,172,176,180,184,188,192,196,200,204,208,212,216,220,224,228,232,236,240,244,248,252,256,260,264,268,272,276,280,284,288,292,296,300,304,308,312,316,320,324,328,332,336,340,343,346,349,353,357,361,365,369,372,375,379,382,385,388,391,395,399,403,407,411,414,417,421,424,427,430,433,437,441,445,449,453,456,459,463,466,469,472,475,479,483,487,491,494,497,501,505,508,511,515,519,522,525,529,533,536,539,543,546,549,552,555,558,562,566,570,573,576,579,582,585,588,591,594,597,600,603,606,609,612,615,618,621,624,627,630,633,636,639,642,645,648,652,656,659,663,666,669,672,676,679,682,685,688,691,694,697,700,703,706,709,712,715,718,721,724,727,731,734,737,740,743,746,749,752,756,760,763,766,770,773,776,779,783,786,790,793,796,800,803,806,809,812,815,818,822,825,829,832,835,838,841,845,849,853,857,861,864,868,872,875,879,882,886,890,894,898,902,906,910,913,917,921,924,930,934,938,942,946,950,954,958,962,966,970,974,978,982],{"path":59,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":62,"sourceHtmlUrl":63},".claude-plugin\u002Fplugin.json","REFERENCE","参考文档",648,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002F.claude-plugin\u002Fplugin.json",{"path":65,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":68,"sourceHtmlUrl":69},"assets\u002Ftemplates\u002Fbasic-program.zig","ASSET","资产文件",1103,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Fassets\u002Ftemplates\u002Fbasic-program.zig",{"path":71,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":72,"sourceHtmlUrl":73},"assets\u002Ftemplates\u002Fbuild.zig",1482,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Fassets\u002Ftemplates\u002Fbuild.zig",{"path":75,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":76,"sourceHtmlUrl":77},"assets\u002Ftemplates\u002Fc-interop-module.zig",9635,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Fassets\u002Ftemplates\u002Fc-interop-module.zig",{"path":79,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":80,"sourceHtmlUrl":81},"assets\u002Ftemplates\u002Fcli-application.zig",6261,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Fassets\u002Ftemplates\u002Fcli-application.zig",{"path":83,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":84,"sourceHtmlUrl":85},"assets\u002Ftemplates\u002Fcross-version\u002Fbuild-adaptive.zig",8640,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Fassets\u002Ftemplates\u002Fcross-version\u002Fbuild-adaptive.zig",{"path":87,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":88,"sourceHtmlUrl":89},"assets\u002Ftemplates\u002Flibrary-module.zig",7009,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Fassets\u002Ftemplates\u002Flibrary-module.zig",{"path":91,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":92,"sourceHtmlUrl":93},"assets\u002Ftemplates\u002Ftest.zig",1547,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Fassets\u002Ftemplates\u002Ftest.zig",{"path":95,"resourceType":96,"resourceTypeDesc":97,"sizeBytes":98,"sourceHtmlUrl":99},"examples\u002Fbuild_example\u002Fbuild.zig","OTHER","其他",2742,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Fexamples\u002Fbuild_example\u002Fbuild.zig",{"path":101,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":102,"sourceHtmlUrl":103},"examples\u002Fbuild_example\u002FREADME.md",3720,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Fexamples\u002Fbuild_example\u002FREADME.md",{"path":105,"resourceType":96,"resourceTypeDesc":97,"sizeBytes":106,"sourceHtmlUrl":107},"examples\u002Fbuild_example\u002Fsrc\u002Fmain.zig",4867,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Fexamples\u002Fbuild_example\u002Fsrc\u002Fmain.zig",{"path":109,"resourceType":96,"resourceTypeDesc":97,"sizeBytes":110,"sourceHtmlUrl":111},"examples\u002Fbuild_example\u002Fsrc\u002Fmath_utils.zig",2442,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Fexamples\u002Fbuild_example\u002Fsrc\u002Fmath_utils.zig",{"path":113,"resourceType":96,"resourceTypeDesc":97,"sizeBytes":114,"sourceHtmlUrl":115},"examples\u002Fbuild_example\u002Fsrc\u002Fstring_utils.zig",4313,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Fexamples\u002Fbuild_example\u002Fsrc\u002Fstring_utils.zig",{"path":117,"resourceType":96,"resourceTypeDesc":97,"sizeBytes":118,"sourceHtmlUrl":119},"examples\u002Fc_interop.zig",8185,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Fexamples\u002Fc_interop.zig",{"path":121,"resourceType":96,"resourceTypeDesc":97,"sizeBytes":122,"sourceHtmlUrl":123},"examples\u002Fcomptime_example.zig",10592,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Fexamples\u002Fcomptime_example.zig",{"path":125,"resourceType":96,"resourceTypeDesc":97,"sizeBytes":126,"sourceHtmlUrl":127},"examples\u002Ferror_handling.zig",9606,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Fexamples\u002Ferror_handling.zig",{"path":129,"resourceType":96,"resourceTypeDesc":97,"sizeBytes":130,"sourceHtmlUrl":131},"examples\u002Fmemory_management.zig",8439,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Fexamples\u002Fmemory_management.zig",{"path":133,"resourceType":96,"resourceTypeDesc":97,"sizeBytes":134,"sourceHtmlUrl":135},"examples\u002Fstring_manipulation.zig",5767,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Fexamples\u002Fstring_manipulation.zig",{"path":137,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":138,"sourceHtmlUrl":139},"README.md",9731,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002FREADME.md",{"path":141,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":142,"sourceHtmlUrl":143},"recipes\u002Fbuild-system.md",439260,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Frecipes\u002Fbuild-system.md",{"path":145,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":146,"sourceHtmlUrl":147},"recipes\u002Fc-interop.md",124295,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Frecipes\u002Fc-interop.md",{"path":149,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":150,"sourceHtmlUrl":151},"recipes\u002Fcomptime-metaprogramming.md",714611,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Frecipes\u002Fcomptime-metaprogramming.md",{"path":153,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":154,"sourceHtmlUrl":155},"recipes\u002Fconcurrency.md",128202,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Frecipes\u002Fconcurrency.md",{"path":157,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":158,"sourceHtmlUrl":159},"recipes\u002Fdata-encoding.md",275510,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Frecipes\u002Fdata-encoding.md",{"path":161,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":162,"sourceHtmlUrl":163},"recipes\u002Fdata-structures.md",457456,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Frecipes\u002Fdata-structures.md",{"path":165,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":166,"sourceHtmlUrl":167},"recipes\u002Ffiles-io.md",576942,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Frecipes\u002Ffiles-io.md",{"path":169,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":170,"sourceHtmlUrl":171},"recipes\u002Ffunctions.md",267596,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Frecipes\u002Ffunctions.md",{"path":173,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":174,"sourceHtmlUrl":175},"recipes\u002Ffundamentals.md",298381,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Frecipes\u002Ffundamentals.md",{"path":177,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":178,"sourceHtmlUrl":179},"recipes\u002Fiterators.md",243185,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Frecipes\u002Fiterators.md",{"path":181,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":182,"sourceHtmlUrl":183},"recipes\u002Fmemory-allocators.md",184992,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Frecipes\u002Fmemory-allocators.md",{"path":185,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":186,"sourceHtmlUrl":187},"recipes\u002Fnetworking.md",542211,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Frecipes\u002Fnetworking.md",{"path":189,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":190,"sourceHtmlUrl":191},"recipes\u002Frecipes-index.json",173296,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Frecipes\u002Frecipes-index.json",{"path":193,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":194,"sourceHtmlUrl":195},"recipes\u002Fstrings-text.md",367792,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Frecipes\u002Fstrings-text.md",{"path":197,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":198,"sourceHtmlUrl":199},"recipes\u002Fstructs-objects.md",566195,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Frecipes\u002Fstructs-objects.md",{"path":201,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":202,"sourceHtmlUrl":203},"recipes\u002Ftesting-debugging.md",349914,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Frecipes\u002Ftesting-debugging.md",{"path":205,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":206,"sourceHtmlUrl":207},"recipes\u002Fwebassembly.md",96844,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Frecipes\u002Fwebassembly.md",{"path":209,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":210,"sourceHtmlUrl":211},"references\u002Flatest\u002Farrays-slices.md",14713,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Flatest\u002Farrays-slices.md",{"path":213,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":214,"sourceHtmlUrl":215},"references\u002Flatest\u002Fbuild-system.md",14251,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Flatest\u002Fbuild-system.md",{"path":217,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":218,"sourceHtmlUrl":219},"references\u002Flatest\u002Fc-interop.md",19180,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Flatest\u002Fc-interop.md",{"path":221,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":222,"sourceHtmlUrl":223},"references\u002Flatest\u002Fcomptime.md",27415,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Flatest\u002Fcomptime.md",{"path":225,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":226,"sourceHtmlUrl":227},"references\u002Flatest\u002Fcontrol-flow.md",34077,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Flatest\u002Fcontrol-flow.md",{"path":229,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":230,"sourceHtmlUrl":231},"references\u002Flatest\u002Fcore-language.md",39542,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Flatest\u002Fcore-language.md",{"path":233,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":234,"sourceHtmlUrl":235},"references\u002Flatest\u002Fdata-structures.md",74749,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Flatest\u002Fdata-structures.md",{"path":237,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":238,"sourceHtmlUrl":239},"references\u002Flatest\u002Fenums-unions.md",16408,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Flatest\u002Fenums-unions.md",{"path":241,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":242,"sourceHtmlUrl":243},"references\u002Flatest\u002Ffunctions-errors.md",58033,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Flatest\u002Ffunctions-errors.md",{"path":245,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":246,"sourceHtmlUrl":247},"references\u002Flatest\u002Fio.md",4513,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Flatest\u002Fio.md",{"path":249,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":250,"sourceHtmlUrl":251},"references\u002Flatest\u002Fmemory-management.md",22271,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Flatest\u002Fmemory-management.md",{"path":253,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":254,"sourceHtmlUrl":255},"references\u002Flatest\u002Fpatterns-data-structures.md",29312,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Flatest\u002Fpatterns-data-structures.md",{"path":257,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":258,"sourceHtmlUrl":259},"references\u002Flatest\u002Fpatterns-error-testing.md",31509,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Flatest\u002Fpatterns-error-testing.md",{"path":261,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":262,"sourceHtmlUrl":263},"references\u002Flatest\u002Fpatterns-integration.md",20853,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Flatest\u002Fpatterns-integration.md",{"path":265,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":266,"sourceHtmlUrl":267},"references\u002Flatest\u002Fpatterns-memory-comptime.md",23036,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Flatest\u002Fpatterns-memory-comptime.md",{"path":269,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":270,"sourceHtmlUrl":271},"references\u002Flatest\u002Fpointers-references.md",17334,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Flatest\u002Fpointers-references.md",{"path":273,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":274,"sourceHtmlUrl":275},"references\u002Flatest\u002Fquick-reference.md",9266,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Flatest\u002Fquick-reference.md",{"path":277,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":278,"sourceHtmlUrl":279},"references\u002Flatest\u002Fstdlib-builtins.md",66983,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Flatest\u002Fstdlib-builtins.md",{"path":281,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":282,"sourceHtmlUrl":283},"references\u002Flatest\u002Fstructs-methods.md",22474,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Flatest\u002Fstructs-methods.md",{"path":285,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":286,"sourceHtmlUrl":287},"references\u002Flatest\u002Ftesting-quality.md",56467,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Flatest\u002Ftesting-quality.md",{"path":289,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":290,"sourceHtmlUrl":291},"references\u002Flatest\u002Fversion-differences.md",2602,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Flatest\u002Fversion-differences.md",{"path":293,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":294,"sourceHtmlUrl":295},"references\u002Fv0.10.1\u002Fbuild-system.md",51,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.10.1\u002Fbuild-system.md",{"path":297,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":298,"sourceHtmlUrl":299},"references\u002Fv0.10.1\u002Fc-interop.md",76,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.10.1\u002Fc-interop.md",{"path":301,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":302,"sourceHtmlUrl":303},"references\u002Fv0.10.1\u002Fcomptime.md",84,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.10.1\u002Fcomptime.md",{"path":305,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":306,"sourceHtmlUrl":307},"references\u002Fv0.10.1\u002Fcontrol-flow.md",28540,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.10.1\u002Fcontrol-flow.md",{"path":309,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":310,"sourceHtmlUrl":311},"references\u002Fv0.10.1\u002Fcore-language.md",40362,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.10.1\u002Fcore-language.md",{"path":313,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":314,"sourceHtmlUrl":315},"references\u002Fv0.10.1\u002Fdata-structures.md",60076,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.10.1\u002Fdata-structures.md",{"path":317,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":318,"sourceHtmlUrl":319},"references\u002Fv0.10.1\u002Ffunctions-errors.md",58132,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.10.1\u002Ffunctions-errors.md",{"path":321,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":322,"sourceHtmlUrl":323},"references\u002Fv0.10.1\u002Fmemory-management.md",3566,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.10.1\u002Fmemory-management.md",{"path":325,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":326,"sourceHtmlUrl":327},"references\u002Fv0.10.1\u002Fquick-reference.md",18,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.10.1\u002Fquick-reference.md",{"path":329,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":330,"sourceHtmlUrl":331},"references\u002Fv0.10.1\u002Fstdlib-builtins.md",500,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.10.1\u002Fstdlib-builtins.md",{"path":333,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":334,"sourceHtmlUrl":335},"references\u002Fv0.10.1\u002Ftesting-quality.md",13815,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.10.1\u002Ftesting-quality.md",{"path":337,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":338,"sourceHtmlUrl":339},"references\u002Fv0.10.1\u002Fversion-differences.md",1864,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.10.1\u002Fversion-differences.md",{"path":341,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":294,"sourceHtmlUrl":342},"references\u002Fv0.11.0\u002Fbuild-system.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.11.0\u002Fbuild-system.md",{"path":344,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":298,"sourceHtmlUrl":345},"references\u002Fv0.11.0\u002Fc-interop.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.11.0\u002Fc-interop.md",{"path":347,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":302,"sourceHtmlUrl":348},"references\u002Fv0.11.0\u002Fcomptime.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.11.0\u002Fcomptime.md",{"path":350,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":351,"sourceHtmlUrl":352},"references\u002Fv0.11.0\u002Fcontrol-flow.md",29913,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.11.0\u002Fcontrol-flow.md",{"path":354,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":355,"sourceHtmlUrl":356},"references\u002Fv0.11.0\u002Fcore-language.md",42479,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.11.0\u002Fcore-language.md",{"path":358,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":359,"sourceHtmlUrl":360},"references\u002Fv0.11.0\u002Fdata-structures.md",61828,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.11.0\u002Fdata-structures.md",{"path":362,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":363,"sourceHtmlUrl":364},"references\u002Fv0.11.0\u002Ffunctions-errors.md",63811,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.11.0\u002Ffunctions-errors.md",{"path":366,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":367,"sourceHtmlUrl":368},"references\u002Fv0.11.0\u002Fmemory-management.md",3691,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.11.0\u002Fmemory-management.md",{"path":370,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":326,"sourceHtmlUrl":371},"references\u002Fv0.11.0\u002Fquick-reference.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.11.0\u002Fquick-reference.md",{"path":373,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":330,"sourceHtmlUrl":374},"references\u002Fv0.11.0\u002Fstdlib-builtins.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.11.0\u002Fstdlib-builtins.md",{"path":376,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":377,"sourceHtmlUrl":378},"references\u002Fv0.11.0\u002Ftesting-quality.md",13509,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.11.0\u002Ftesting-quality.md",{"path":380,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":338,"sourceHtmlUrl":381},"references\u002Fv0.11.0\u002Fversion-differences.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.11.0\u002Fversion-differences.md",{"path":383,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":294,"sourceHtmlUrl":384},"references\u002Fv0.12.1\u002Fbuild-system.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.12.1\u002Fbuild-system.md",{"path":386,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":298,"sourceHtmlUrl":387},"references\u002Fv0.12.1\u002Fc-interop.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.12.1\u002Fc-interop.md",{"path":389,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":302,"sourceHtmlUrl":390},"references\u002Fv0.12.1\u002Fcomptime.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.12.1\u002Fcomptime.md",{"path":392,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":393,"sourceHtmlUrl":394},"references\u002Fv0.12.1\u002Fcontrol-flow.md",30089,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.12.1\u002Fcontrol-flow.md",{"path":396,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":397,"sourceHtmlUrl":398},"references\u002Fv0.12.1\u002Fcore-language.md",37065,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.12.1\u002Fcore-language.md",{"path":400,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":401,"sourceHtmlUrl":402},"references\u002Fv0.12.1\u002Fdata-structures.md",66831,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.12.1\u002Fdata-structures.md",{"path":404,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":405,"sourceHtmlUrl":406},"references\u002Fv0.12.1\u002Ffunctions-errors.md",66542,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.12.1\u002Ffunctions-errors.md",{"path":408,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":409,"sourceHtmlUrl":410},"references\u002Fv0.12.1\u002Fmemory-management.md",11306,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.12.1\u002Fmemory-management.md",{"path":412,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":326,"sourceHtmlUrl":413},"references\u002Fv0.12.1\u002Fquick-reference.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.12.1\u002Fquick-reference.md",{"path":415,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":330,"sourceHtmlUrl":416},"references\u002Fv0.12.1\u002Fstdlib-builtins.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.12.1\u002Fstdlib-builtins.md",{"path":418,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":419,"sourceHtmlUrl":420},"references\u002Fv0.12.1\u002Ftesting-quality.md",11502,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.12.1\u002Ftesting-quality.md",{"path":422,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":338,"sourceHtmlUrl":423},"references\u002Fv0.12.1\u002Fversion-differences.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.12.1\u002Fversion-differences.md",{"path":425,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":294,"sourceHtmlUrl":426},"references\u002Fv0.13.0\u002Fbuild-system.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.13.0\u002Fbuild-system.md",{"path":428,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":298,"sourceHtmlUrl":429},"references\u002Fv0.13.0\u002Fc-interop.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.13.0\u002Fc-interop.md",{"path":431,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":302,"sourceHtmlUrl":432},"references\u002Fv0.13.0\u002Fcomptime.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.13.0\u002Fcomptime.md",{"path":434,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":435,"sourceHtmlUrl":436},"references\u002Fv0.13.0\u002Fcontrol-flow.md",30084,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.13.0\u002Fcontrol-flow.md",{"path":438,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":439,"sourceHtmlUrl":440},"references\u002Fv0.13.0\u002Fcore-language.md",36862,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.13.0\u002Fcore-language.md",{"path":442,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":443,"sourceHtmlUrl":444},"references\u002Fv0.13.0\u002Fdata-structures.md",67054,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.13.0\u002Fdata-structures.md",{"path":446,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":447,"sourceHtmlUrl":448},"references\u002Fv0.13.0\u002Ffunctions-errors.md",66191,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.13.0\u002Ffunctions-errors.md",{"path":450,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":451,"sourceHtmlUrl":452},"references\u002Fv0.13.0\u002Fmemory-management.md",11265,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.13.0\u002Fmemory-management.md",{"path":454,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":326,"sourceHtmlUrl":455},"references\u002Fv0.13.0\u002Fquick-reference.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.13.0\u002Fquick-reference.md",{"path":457,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":330,"sourceHtmlUrl":458},"references\u002Fv0.13.0\u002Fstdlib-builtins.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.13.0\u002Fstdlib-builtins.md",{"path":460,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":461,"sourceHtmlUrl":462},"references\u002Fv0.13.0\u002Ftesting-quality.md",11406,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.13.0\u002Ftesting-quality.md",{"path":464,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":338,"sourceHtmlUrl":465},"references\u002Fv0.13.0\u002Fversion-differences.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.13.0\u002Fversion-differences.md",{"path":467,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":294,"sourceHtmlUrl":468},"references\u002Fv0.14.1\u002Fbuild-system.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.14.1\u002Fbuild-system.md",{"path":470,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":298,"sourceHtmlUrl":471},"references\u002Fv0.14.1\u002Fc-interop.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.14.1\u002Fc-interop.md",{"path":473,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":302,"sourceHtmlUrl":474},"references\u002Fv0.14.1\u002Fcomptime.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.14.1\u002Fcomptime.md",{"path":476,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":477,"sourceHtmlUrl":478},"references\u002Fv0.14.1\u002Fcontrol-flow.md",34064,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.14.1\u002Fcontrol-flow.md",{"path":480,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":481,"sourceHtmlUrl":482},"references\u002Fv0.14.1\u002Fcore-language.md",39235,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.14.1\u002Fcore-language.md",{"path":484,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":485,"sourceHtmlUrl":486},"references\u002Fv0.14.1\u002Fdata-structures.md",72598,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.14.1\u002Fdata-structures.md",{"path":488,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":489,"sourceHtmlUrl":490},"references\u002Fv0.14.1\u002Ffunctions-errors.md",57656,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.14.1\u002Ffunctions-errors.md",{"path":492,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":409,"sourceHtmlUrl":493},"references\u002Fv0.14.1\u002Fmemory-management.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.14.1\u002Fmemory-management.md",{"path":495,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":326,"sourceHtmlUrl":496},"references\u002Fv0.14.1\u002Fquick-reference.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.14.1\u002Fquick-reference.md",{"path":498,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":499,"sourceHtmlUrl":500},"references\u002Fv0.14.1\u002Fstdlib-builtins.md",677,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.14.1\u002Fstdlib-builtins.md",{"path":502,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":503,"sourceHtmlUrl":504},"references\u002Fv0.14.1\u002Ftesting-quality.md",11443,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.14.1\u002Ftesting-quality.md",{"path":506,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":338,"sourceHtmlUrl":507},"references\u002Fv0.14.1\u002Fversion-differences.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.14.1\u002Fversion-differences.md",{"path":509,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":210,"sourceHtmlUrl":510},"references\u002Fv0.15.2\u002Farrays-slices.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.15.2\u002Farrays-slices.md",{"path":512,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":513,"sourceHtmlUrl":514},"references\u002Fv0.15.2\u002Fbuild-system.md",14257,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.15.2\u002Fbuild-system.md",{"path":516,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":517,"sourceHtmlUrl":518},"references\u002Fv0.15.2\u002Fc-interop.md",19812,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.15.2\u002Fc-interop.md",{"path":520,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":222,"sourceHtmlUrl":521},"references\u002Fv0.15.2\u002Fcomptime.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.15.2\u002Fcomptime.md",{"path":523,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":226,"sourceHtmlUrl":524},"references\u002Fv0.15.2\u002Fcontrol-flow.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.15.2\u002Fcontrol-flow.md",{"path":526,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":527,"sourceHtmlUrl":528},"references\u002Fv0.15.2\u002Fcore-language.md",39449,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.15.2\u002Fcore-language.md",{"path":530,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":531,"sourceHtmlUrl":532},"references\u002Fv0.15.2\u002Fdata-structures.md",74707,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.15.2\u002Fdata-structures.md",{"path":534,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":238,"sourceHtmlUrl":535},"references\u002Fv0.15.2\u002Fenums-unions.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.15.2\u002Fenums-unions.md",{"path":537,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":242,"sourceHtmlUrl":538},"references\u002Fv0.15.2\u002Ffunctions-errors.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.15.2\u002Ffunctions-errors.md",{"path":540,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":541,"sourceHtmlUrl":542},"references\u002Fv0.15.2\u002Fmemory-management.md",22372,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.15.2\u002Fmemory-management.md",{"path":544,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":254,"sourceHtmlUrl":545},"references\u002Fv0.15.2\u002Fpatterns-data-structures.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.15.2\u002Fpatterns-data-structures.md",{"path":547,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":258,"sourceHtmlUrl":548},"references\u002Fv0.15.2\u002Fpatterns-error-testing.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.15.2\u002Fpatterns-error-testing.md",{"path":550,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":262,"sourceHtmlUrl":551},"references\u002Fv0.15.2\u002Fpatterns-integration.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.15.2\u002Fpatterns-integration.md",{"path":553,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":266,"sourceHtmlUrl":554},"references\u002Fv0.15.2\u002Fpatterns-memory-comptime.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.15.2\u002Fpatterns-memory-comptime.md",{"path":556,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":270,"sourceHtmlUrl":557},"references\u002Fv0.15.2\u002Fpointers-references.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.15.2\u002Fpointers-references.md",{"path":559,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":560,"sourceHtmlUrl":561},"references\u002Fv0.15.2\u002Fquick-reference.md",8991,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.15.2\u002Fquick-reference.md",{"path":563,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":564,"sourceHtmlUrl":565},"references\u002Fv0.15.2\u002Fstdlib-builtins.md",67151,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.15.2\u002Fstdlib-builtins.md",{"path":567,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":568,"sourceHtmlUrl":569},"references\u002Fv0.15.2\u002Fstructs-methods.md",22432,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.15.2\u002Fstructs-methods.md",{"path":571,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":286,"sourceHtmlUrl":572},"references\u002Fv0.15.2\u002Ftesting-quality.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.15.2\u002Ftesting-quality.md",{"path":574,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":338,"sourceHtmlUrl":575},"references\u002Fv0.15.2\u002Fversion-differences.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.15.2\u002Fversion-differences.md",{"path":577,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":210,"sourceHtmlUrl":578},"references\u002Fv0.16.0\u002Farrays-slices.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.16.0\u002Farrays-slices.md",{"path":580,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":214,"sourceHtmlUrl":581},"references\u002Fv0.16.0\u002Fbuild-system.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.16.0\u002Fbuild-system.md",{"path":583,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":218,"sourceHtmlUrl":584},"references\u002Fv0.16.0\u002Fc-interop.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.16.0\u002Fc-interop.md",{"path":586,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":222,"sourceHtmlUrl":587},"references\u002Fv0.16.0\u002Fcomptime.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.16.0\u002Fcomptime.md",{"path":589,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":226,"sourceHtmlUrl":590},"references\u002Fv0.16.0\u002Fcontrol-flow.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.16.0\u002Fcontrol-flow.md",{"path":592,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":230,"sourceHtmlUrl":593},"references\u002Fv0.16.0\u002Fcore-language.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.16.0\u002Fcore-language.md",{"path":595,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":234,"sourceHtmlUrl":596},"references\u002Fv0.16.0\u002Fdata-structures.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.16.0\u002Fdata-structures.md",{"path":598,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":238,"sourceHtmlUrl":599},"references\u002Fv0.16.0\u002Fenums-unions.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.16.0\u002Fenums-unions.md",{"path":601,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":242,"sourceHtmlUrl":602},"references\u002Fv0.16.0\u002Ffunctions-errors.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.16.0\u002Ffunctions-errors.md",{"path":604,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":246,"sourceHtmlUrl":605},"references\u002Fv0.16.0\u002Fio.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.16.0\u002Fio.md",{"path":607,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":250,"sourceHtmlUrl":608},"references\u002Fv0.16.0\u002Fmemory-management.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.16.0\u002Fmemory-management.md",{"path":610,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":254,"sourceHtmlUrl":611},"references\u002Fv0.16.0\u002Fpatterns-data-structures.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.16.0\u002Fpatterns-data-structures.md",{"path":613,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":258,"sourceHtmlUrl":614},"references\u002Fv0.16.0\u002Fpatterns-error-testing.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.16.0\u002Fpatterns-error-testing.md",{"path":616,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":262,"sourceHtmlUrl":617},"references\u002Fv0.16.0\u002Fpatterns-integration.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.16.0\u002Fpatterns-integration.md",{"path":619,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":266,"sourceHtmlUrl":620},"references\u002Fv0.16.0\u002Fpatterns-memory-comptime.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.16.0\u002Fpatterns-memory-comptime.md",{"path":622,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":270,"sourceHtmlUrl":623},"references\u002Fv0.16.0\u002Fpointers-references.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.16.0\u002Fpointers-references.md",{"path":625,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":274,"sourceHtmlUrl":626},"references\u002Fv0.16.0\u002Fquick-reference.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.16.0\u002Fquick-reference.md",{"path":628,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":278,"sourceHtmlUrl":629},"references\u002Fv0.16.0\u002Fstdlib-builtins.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.16.0\u002Fstdlib-builtins.md",{"path":631,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":282,"sourceHtmlUrl":632},"references\u002Fv0.16.0\u002Fstructs-methods.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.16.0\u002Fstructs-methods.md",{"path":634,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":286,"sourceHtmlUrl":635},"references\u002Fv0.16.0\u002Ftesting-quality.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.16.0\u002Ftesting-quality.md",{"path":637,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":290,"sourceHtmlUrl":638},"references\u002Fv0.16.0\u002Fversion-differences.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.16.0\u002Fversion-differences.md",{"path":640,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":294,"sourceHtmlUrl":641},"references\u002Fv0.2.0\u002Fbuild-system.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.2.0\u002Fbuild-system.md",{"path":643,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":298,"sourceHtmlUrl":644},"references\u002Fv0.2.0\u002Fc-interop.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.2.0\u002Fc-interop.md",{"path":646,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":302,"sourceHtmlUrl":647},"references\u002Fv0.2.0\u002Fcomptime.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.2.0\u002Fcomptime.md",{"path":649,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":650,"sourceHtmlUrl":651},"references\u002Fv0.2.0\u002Fcontrol-flow.md",69,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.2.0\u002Fcontrol-flow.md",{"path":653,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":654,"sourceHtmlUrl":655},"references\u002Fv0.2.0\u002Fcore-language.md",919,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.2.0\u002Fcore-language.md",{"path":657,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":650,"sourceHtmlUrl":658},"references\u002Fv0.2.0\u002Fdata-structures.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.2.0\u002Fdata-structures.md",{"path":660,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":661,"sourceHtmlUrl":662},"references\u002Fv0.2.0\u002Ffunctions-errors.md",103,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.2.0\u002Ffunctions-errors.md",{"path":664,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":298,"sourceHtmlUrl":665},"references\u002Fv0.2.0\u002Fmemory-management.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.2.0\u002Fmemory-management.md",{"path":667,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":326,"sourceHtmlUrl":668},"references\u002Fv0.2.0\u002Fquick-reference.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.2.0\u002Fquick-reference.md",{"path":670,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":302,"sourceHtmlUrl":671},"references\u002Fv0.2.0\u002Fstdlib-builtins.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.2.0\u002Fstdlib-builtins.md",{"path":673,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":674,"sourceHtmlUrl":675},"references\u002Fv0.2.0\u002Ftesting-quality.md",94,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.2.0\u002Ftesting-quality.md",{"path":677,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":338,"sourceHtmlUrl":678},"references\u002Fv0.2.0\u002Fversion-differences.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.2.0\u002Fversion-differences.md",{"path":680,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":294,"sourceHtmlUrl":681},"references\u002Fv0.3.0\u002Fbuild-system.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.3.0\u002Fbuild-system.md",{"path":683,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":298,"sourceHtmlUrl":684},"references\u002Fv0.3.0\u002Fc-interop.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.3.0\u002Fc-interop.md",{"path":686,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":302,"sourceHtmlUrl":687},"references\u002Fv0.3.0\u002Fcomptime.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.3.0\u002Fcomptime.md",{"path":689,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":650,"sourceHtmlUrl":690},"references\u002Fv0.3.0\u002Fcontrol-flow.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.3.0\u002Fcontrol-flow.md",{"path":692,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":654,"sourceHtmlUrl":693},"references\u002Fv0.3.0\u002Fcore-language.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.3.0\u002Fcore-language.md",{"path":695,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":650,"sourceHtmlUrl":696},"references\u002Fv0.3.0\u002Fdata-structures.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.3.0\u002Fdata-structures.md",{"path":698,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":661,"sourceHtmlUrl":699},"references\u002Fv0.3.0\u002Ffunctions-errors.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.3.0\u002Ffunctions-errors.md",{"path":701,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":298,"sourceHtmlUrl":702},"references\u002Fv0.3.0\u002Fmemory-management.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.3.0\u002Fmemory-management.md",{"path":704,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":326,"sourceHtmlUrl":705},"references\u002Fv0.3.0\u002Fquick-reference.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.3.0\u002Fquick-reference.md",{"path":707,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":302,"sourceHtmlUrl":708},"references\u002Fv0.3.0\u002Fstdlib-builtins.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.3.0\u002Fstdlib-builtins.md",{"path":710,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":674,"sourceHtmlUrl":711},"references\u002Fv0.3.0\u002Ftesting-quality.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.3.0\u002Ftesting-quality.md",{"path":713,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":338,"sourceHtmlUrl":714},"references\u002Fv0.3.0\u002Fversion-differences.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.3.0\u002Fversion-differences.md",{"path":716,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":294,"sourceHtmlUrl":717},"references\u002Fv0.6.0\u002Fbuild-system.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.6.0\u002Fbuild-system.md",{"path":719,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":298,"sourceHtmlUrl":720},"references\u002Fv0.6.0\u002Fc-interop.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.6.0\u002Fc-interop.md",{"path":722,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":302,"sourceHtmlUrl":723},"references\u002Fv0.6.0\u002Fcomptime.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.6.0\u002Fcomptime.md",{"path":725,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":650,"sourceHtmlUrl":726},"references\u002Fv0.6.0\u002Fcontrol-flow.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.6.0\u002Fcontrol-flow.md",{"path":728,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":729,"sourceHtmlUrl":730},"references\u002Fv0.6.0\u002Fcore-language.md",1258,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.6.0\u002Fcore-language.md",{"path":732,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":650,"sourceHtmlUrl":733},"references\u002Fv0.6.0\u002Fdata-structures.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.6.0\u002Fdata-structures.md",{"path":735,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":661,"sourceHtmlUrl":736},"references\u002Fv0.6.0\u002Ffunctions-errors.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.6.0\u002Ffunctions-errors.md",{"path":738,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":298,"sourceHtmlUrl":739},"references\u002Fv0.6.0\u002Fmemory-management.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.6.0\u002Fmemory-management.md",{"path":741,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":326,"sourceHtmlUrl":742},"references\u002Fv0.6.0\u002Fquick-reference.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.6.0\u002Fquick-reference.md",{"path":744,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":302,"sourceHtmlUrl":745},"references\u002Fv0.6.0\u002Fstdlib-builtins.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.6.0\u002Fstdlib-builtins.md",{"path":747,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":674,"sourceHtmlUrl":748},"references\u002Fv0.6.0\u002Ftesting-quality.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.6.0\u002Ftesting-quality.md",{"path":750,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":338,"sourceHtmlUrl":751},"references\u002Fv0.6.0\u002Fversion-differences.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.6.0\u002Fversion-differences.md",{"path":753,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":754,"sourceHtmlUrl":755},"references\u002Fv0.7.1\u002Fbuild-system.md",3029,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.7.1\u002Fbuild-system.md",{"path":757,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":758,"sourceHtmlUrl":759},"references\u002Fv0.7.1\u002Fc-interop.md",12032,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.7.1\u002Fc-interop.md",{"path":761,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":302,"sourceHtmlUrl":762},"references\u002Fv0.7.1\u002Fcomptime.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.7.1\u002Fcomptime.md",{"path":764,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":650,"sourceHtmlUrl":765},"references\u002Fv0.7.1\u002Fcontrol-flow.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.7.1\u002Fcontrol-flow.md",{"path":767,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":768,"sourceHtmlUrl":769},"references\u002Fv0.7.1\u002Fcore-language.md",1259,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.7.1\u002Fcore-language.md",{"path":771,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":650,"sourceHtmlUrl":772},"references\u002Fv0.7.1\u002Fdata-structures.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.7.1\u002Fdata-structures.md",{"path":774,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":661,"sourceHtmlUrl":775},"references\u002Fv0.7.1\u002Ffunctions-errors.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.7.1\u002Ffunctions-errors.md",{"path":777,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":298,"sourceHtmlUrl":778},"references\u002Fv0.7.1\u002Fmemory-management.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.7.1\u002Fmemory-management.md",{"path":780,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":781,"sourceHtmlUrl":782},"references\u002Fv0.7.1\u002Fquick-reference.md",8903,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.7.1\u002Fquick-reference.md",{"path":784,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":302,"sourceHtmlUrl":785},"references\u002Fv0.7.1\u002Fstdlib-builtins.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.7.1\u002Fstdlib-builtins.md",{"path":787,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":788,"sourceHtmlUrl":789},"references\u002Fv0.7.1\u002Ftesting-quality.md",3906,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.7.1\u002Ftesting-quality.md",{"path":791,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":338,"sourceHtmlUrl":792},"references\u002Fv0.7.1\u002Fversion-differences.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.7.1\u002Fversion-differences.md",{"path":794,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":754,"sourceHtmlUrl":795},"references\u002Fv0.8.1\u002Fbuild-system.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.8.1\u002Fbuild-system.md",{"path":797,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":798,"sourceHtmlUrl":799},"references\u002Fv0.8.1\u002Fc-interop.md",12106,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.8.1\u002Fc-interop.md",{"path":801,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":302,"sourceHtmlUrl":802},"references\u002Fv0.8.1\u002Fcomptime.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.8.1\u002Fcomptime.md",{"path":804,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":650,"sourceHtmlUrl":805},"references\u002Fv0.8.1\u002Fcontrol-flow.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.8.1\u002Fcontrol-flow.md",{"path":807,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":768,"sourceHtmlUrl":808},"references\u002Fv0.8.1\u002Fcore-language.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.8.1\u002Fcore-language.md",{"path":810,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":650,"sourceHtmlUrl":811},"references\u002Fv0.8.1\u002Fdata-structures.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.8.1\u002Fdata-structures.md",{"path":813,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":661,"sourceHtmlUrl":814},"references\u002Fv0.8.1\u002Ffunctions-errors.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.8.1\u002Ffunctions-errors.md",{"path":816,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":298,"sourceHtmlUrl":817},"references\u002Fv0.8.1\u002Fmemory-management.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.8.1\u002Fmemory-management.md",{"path":819,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":820,"sourceHtmlUrl":821},"references\u002Fv0.8.1\u002Fquick-reference.md",9653,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.8.1\u002Fquick-reference.md",{"path":823,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":302,"sourceHtmlUrl":824},"references\u002Fv0.8.1\u002Fstdlib-builtins.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.8.1\u002Fstdlib-builtins.md",{"path":826,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":827,"sourceHtmlUrl":828},"references\u002Fv0.8.1\u002Ftesting-quality.md",5778,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.8.1\u002Ftesting-quality.md",{"path":830,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":338,"sourceHtmlUrl":831},"references\u002Fv0.8.1\u002Fversion-differences.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.8.1\u002Fversion-differences.md",{"path":833,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":294,"sourceHtmlUrl":834},"references\u002Fv0.9.1\u002Fbuild-system.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.9.1\u002Fbuild-system.md",{"path":836,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":298,"sourceHtmlUrl":837},"references\u002Fv0.9.1\u002Fc-interop.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.9.1\u002Fc-interop.md",{"path":839,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":302,"sourceHtmlUrl":840},"references\u002Fv0.9.1\u002Fcomptime.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.9.1\u002Fcomptime.md",{"path":842,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":843,"sourceHtmlUrl":844},"references\u002Fv0.9.1\u002Fcontrol-flow.md",23269,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.9.1\u002Fcontrol-flow.md",{"path":846,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":847,"sourceHtmlUrl":848},"references\u002Fv0.9.1\u002Fcore-language.md",39601,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.9.1\u002Fcore-language.md",{"path":850,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":851,"sourceHtmlUrl":852},"references\u002Fv0.9.1\u002Fdata-structures.md",58680,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.9.1\u002Fdata-structures.md",{"path":854,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":855,"sourceHtmlUrl":856},"references\u002Fv0.9.1\u002Ffunctions-errors.md",50644,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.9.1\u002Ffunctions-errors.md",{"path":858,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":859,"sourceHtmlUrl":860},"references\u002Fv0.9.1\u002Fmemory-management.md",4755,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.9.1\u002Fmemory-management.md",{"path":862,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":326,"sourceHtmlUrl":863},"references\u002Fv0.9.1\u002Fquick-reference.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.9.1\u002Fquick-reference.md",{"path":865,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":866,"sourceHtmlUrl":867},"references\u002Fv0.9.1\u002Fstdlib-builtins.md",499,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.9.1\u002Fstdlib-builtins.md",{"path":869,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":870,"sourceHtmlUrl":871},"references\u002Fv0.9.1\u002Ftesting-quality.md",13954,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.9.1\u002Ftesting-quality.md",{"path":873,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":338,"sourceHtmlUrl":874},"references\u002Fv0.9.1\u002Fversion-differences.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fv0.9.1\u002Fversion-differences.md",{"path":876,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":877,"sourceHtmlUrl":878},"references\u002Fversion-differences.md",40461,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fversion-differences.md",{"path":880,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":513,"sourceHtmlUrl":881},"references\u002Fvmaster\u002Fbuild-system.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fvmaster\u002Fbuild-system.md",{"path":883,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":884,"sourceHtmlUrl":885},"references\u002Fvmaster\u002Fc-interop.md",22826,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fvmaster\u002Fc-interop.md",{"path":887,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":888,"sourceHtmlUrl":889},"references\u002Fvmaster\u002Fcomptime.md",27483,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fvmaster\u002Fcomptime.md",{"path":891,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":892,"sourceHtmlUrl":893},"references\u002Fvmaster\u002Fcontrol-flow.md",34309,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fvmaster\u002Fcontrol-flow.md",{"path":895,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":896,"sourceHtmlUrl":897},"references\u002Fvmaster\u002Fcore-language.md",39708,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fvmaster\u002Fcore-language.md",{"path":899,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":900,"sourceHtmlUrl":901},"references\u002Fvmaster\u002Fdata-structures.md",76761,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fvmaster\u002Fdata-structures.md",{"path":903,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":904,"sourceHtmlUrl":905},"references\u002Fvmaster\u002Ffunctions-errors.md",58853,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fvmaster\u002Ffunctions-errors.md",{"path":907,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":908,"sourceHtmlUrl":909},"references\u002Fvmaster\u002Fmemory-management.md",22647,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fvmaster\u002Fmemory-management.md",{"path":911,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":560,"sourceHtmlUrl":912},"references\u002Fvmaster\u002Fquick-reference.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fvmaster\u002Fquick-reference.md",{"path":914,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":915,"sourceHtmlUrl":916},"references\u002Fvmaster\u002Fstdlib-builtins.md",67620,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fvmaster\u002Fstdlib-builtins.md",{"path":918,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":919,"sourceHtmlUrl":920},"references\u002Fvmaster\u002Ftesting-quality.md",59363,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fvmaster\u002Ftesting-quality.md",{"path":922,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":338,"sourceHtmlUrl":923},"references\u002Fvmaster\u002Fversion-differences.md","https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Freferences\u002Fvmaster\u002Fversion-differences.md",{"path":925,"resourceType":926,"resourceTypeDesc":927,"sizeBytes":928,"sourceHtmlUrl":929},"scripts\u002Fcheck_files.sh","SCRIPT","脚本",1971,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Fscripts\u002Fcheck_files.sh",{"path":931,"resourceType":926,"resourceTypeDesc":927,"sizeBytes":932,"sourceHtmlUrl":933},"scripts\u002Fcode_generator.py",11527,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Fscripts\u002Fcode_generator.py",{"path":935,"resourceType":926,"resourceTypeDesc":927,"sizeBytes":936,"sourceHtmlUrl":937},"scripts\u002Fconsolidator.py",13196,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Fscripts\u002Fconsolidator.py",{"path":939,"resourceType":926,"resourceTypeDesc":927,"sizeBytes":940,"sourceHtmlUrl":941},"scripts\u002Fdetect_version.py",9603,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Fscripts\u002Fdetect_version.py",{"path":943,"resourceType":926,"resourceTypeDesc":927,"sizeBytes":944,"sourceHtmlUrl":945},"scripts\u002Fget_references.py",11917,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Fscripts\u002Fget_references.py",{"path":947,"resourceType":926,"resourceTypeDesc":927,"sizeBytes":948,"sourceHtmlUrl":949},"scripts\u002Finit_skill.py",4989,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Fscripts\u002Finit_skill.py",{"path":951,"resourceType":926,"resourceTypeDesc":927,"sizeBytes":952,"sourceHtmlUrl":953},"scripts\u002Flint_snippets.py",6428,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Fscripts\u002Flint_snippets.py",{"path":955,"resourceType":926,"resourceTypeDesc":927,"sizeBytes":956,"sourceHtmlUrl":957},"scripts\u002Fpackage_skill.py",9819,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Fscripts\u002Fpackage_skill.py",{"path":959,"resourceType":926,"resourceTypeDesc":927,"sizeBytes":960,"sourceHtmlUrl":961},"scripts\u002Fpattern_extractor.py",13697,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Fscripts\u002Fpattern_extractor.py",{"path":963,"resourceType":926,"resourceTypeDesc":927,"sizeBytes":964,"sourceHtmlUrl":965},"scripts\u002Fquery_recipes.py",8596,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Fscripts\u002Fquery_recipes.py",{"path":967,"resourceType":926,"resourceTypeDesc":927,"sizeBytes":968,"sourceHtmlUrl":969},"scripts\u002FREADME.md",3384,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Fscripts\u002FREADME.md",{"path":971,"resourceType":926,"resourceTypeDesc":927,"sizeBytes":972,"sourceHtmlUrl":973},"scripts\u002Fskill_generator.py",15116,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Fscripts\u002Fskill_generator.py",{"path":975,"resourceType":926,"resourceTypeDesc":927,"sizeBytes":976,"sourceHtmlUrl":977},"scripts\u002Fverify_recipes.py",14852,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Fscripts\u002Fverify_recipes.py",{"path":979,"resourceType":926,"resourceTypeDesc":927,"sizeBytes":980,"sourceHtmlUrl":981},"scripts\u002Fversion_updater.py",13523,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Fscripts\u002Fversion_updater.py",{"path":983,"resourceType":926,"resourceTypeDesc":927,"sizeBytes":984,"sourceHtmlUrl":985},"tests\u002Ftest_version_support.py",2730,"https:\u002F\u002Fgithub.com\u002Fbnferguson\u002Fdotfiles\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzig-programming\u002Ftests\u002Ftest_version_support.py",[987],{"skillNo":988,"name":989,"nameZh":6,"description":990,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":991,"categories":992,"keywords":996,"publishedAt":29},"01M6ACZ2CRCD8Y524DAD3ZSCBA","compile","Build the SkyWalking Java agent — full build, skip tests, single module, or plugin test scenarios","https:\u002F\u002Fgithub.com\u002Fapache\u002Fskywalking-java\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fcompile\u002FSKILL.md",[993],{"categoryNo":994,"categoryName":995,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000008","测试与质量",[989,997,24,26,27,998],"test","plugin test"]