weed

Resolve divergences between Allium behavioral specification files and implementation code.

10|6|Updated Feb 8, 2026
One-click install
npx skills add https://github.com/juxt/claude-plugins --skill weed-juxt
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: weed
Source: https://github.com/juxt/claude-plugins/tree/main/plugins/allium/skills/weed
Command: npx skills add https://github.com/juxt/claude-plugins --skill weed-juxt

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill solves the problem of Allium behavioral specifications diverging from their corresponding implementation code, which leads to outdated documentation, unexpected system behavior, and wasted debugging time when documented behavior does not match actual code functionality.

Core Features & Use Cases

  • Three alignment modes: Run check-only divergence reports, update specs to match implementation, or update implementation to match specs based on your needs.
  • Process-level validation: Goes beyond line-by-line comparison to validate state transition reachability, external trigger coverage, invariant enforcement, and undeclared state changes in code.
  • Use Case: A team using Allium to specify e-commerce order processing workflows can use this Skill to audit if implemented order state transitions, cancellation logic, and payment triggers match the documented spec, catching gaps before they cause customer-facing issues.

Quick Start

Use the weed skill to check all divergences between the order-processing.allium spec and the src/order_processor.clj implementation files.

Frequently Asked Questions about weed

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check if my Allium behavioral specification has drifted from the implementation code?

To check for Allium spec drift, run a check-only divergence report against your implementation code. This identifies misaligned state transitions, missing trigger coverage, and unenforced invariants without modifying any files.

What is the best way to align Allium specs with code when documented behavior is outdated?

The best way to align outdated Allium specs with code is to update the specification files to match the current implementation. This synchronizes documented behavior with actual state transitions and trigger coverage in the codebase.

Can I automatically update implementation code to match an Allium behavioral specification?

Yes, you can update implementation code to match an Allium behavioral specification. This mode modifies the code to enforce documented state transitions, external triggers, and invariants defined in the spec.

Does Allium spec alignment validate state machine reachability and trigger coverage?

Yes, Allium spec alignment validates process-level state machine reachability, external trigger coverage, and invariant enforcement. It detects undeclared state changes in code rather than relying solely on line-by-line text comparison.

When should I use a spec alignment tool instead of manual code auditing for Allium files?

Use a spec alignment tool for Allium files when you need to validate complex process-level behaviors like state transition reachability and invariant enforcement, which manual line-by-line code auditing easily misses.

Why does my Allium specification show unexpected system behavior during state transitions?

Unexpected system behavior during state transitions occurs when Allium specifications diverge from implementation code. Running a divergence report detects undeclared state changes and missing external trigger coverage causing the mismatch.