From wicked-garden
Keep documentation in sync with code changes. Detect stale docs, identify drift between code and docs, and suggest updates when code changes. Use when: "check doc freshness", "sync docs", "docs out of date", "update docs after refactor", "docs drift", "docs out of sync"
npx claudepluginhub mikeparcewski/wicked-garden --plugin wicked-gardenThis skill uses the workspace's default tool permissions.
Keep documentation fresh by detecting when code changes have made docs stale.
Provides Ktor server patterns for routing DSL, plugins (auth, CORS, serialization), Koin DI, WebSockets, services, and testApplication testing.
Conducts multi-source web research with firecrawl and exa MCPs: searches, scrapes pages, synthesizes cited reports. For deep dives, competitive analysis, tech evaluations, or due diligence.
Provides demand forecasting, safety stock optimization, replenishment planning, and promotional lift estimation for multi-location retailers managing 300-800 SKUs.
Keep documentation fresh by detecting when code changes have made docs stale.
Maintain documentation accuracy:
| Command | Purpose |
|---|---|
/wicked-garden:engineering:sync | Check all documentation freshness |
/wicked-garden:engineering:sync [path] | Check specific path |
/wicked-garden:engineering:sync --fix | Auto-update where possible |
# Check all documentation
/wicked-garden:engineering:sync
# Check specific directory
/wicked-garden:engineering:sync src/api
# Auto-fix simple issues
/wicked-garden:engineering:sync --fix
Compare file timestamps (code modified after docs = STALE). Compare function signatures (code vs docs = DRIFT). Validate API specs against code (path/method mismatches = DRIFT).
STALE - Documentation older than code:
DRIFT - Documentation doesn't match code:
MISSING - Documentation incomplete:
OUTDATED - Referenced deprecated code:
# Documentation Sync Report
## Summary
- Issues found: 7
- STALE: 3
- DRIFT: 2
- MISSING: 2
## Issues
### DRIFT: docs/api/users.md
**Issue:** Function signature changed
**Code:**
```typescript
function createUser(data: UserInput, options?: CreateOptions)
Docs:
### createUser(data: UserInput)
Suggestion:
Add documentation for options parameter
Priority: HIGH
## Auto-Fix Capabilities
Can auto-fix simple type changes, timestamps, and link updates.
Cannot auto-fix parameter descriptions, behavior changes, or examples (requires human review).
## Integration
Use **wicked-garden:search** to find docs. **wicked-crew** auto-checks after build.
Native TaskCreate (with `metadata.event_type="task"`) tracks doc updates. Git hooks check on commit.
## Events
- `[docs:stale:warning]` - Stale documentation found
- `[docs:drift:warning]` - Documentation drift detected
- `[docs:missing:warning]` - Missing documentation found
- `[docs:synced:success]` - Documentation synchronized
## Configuration
```yaml
sync:
max_staleness_days: 30 # Warn if docs unchanged for 30 days
check_signatures: true # Compare function signatures
check_types: true # Compare type definitions
check_openapi: true # Validate OpenAPI against code
auto_fix: false # Auto-fix simple issues