From we
Systematic documentation review — validates structure, frontmatter, detects duplicates, checks token efficiency. Use when reviewing documentation quality, validating rules setup, or when user mentions "doc-review", "documentation review".
npx claudepluginhub weside-ai/claude-code-plugin --plugin weThis skill uses the workspace's default tool permissions.
**Role:** Ensures documentation quality across the project.
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.
Role: Ensures documentation quality across the project.
| Layer | Location | When Loaded | Content |
|---|---|---|---|
| CLAUDE.md | Repo roots | Always | Vision, Quick-Ref, Links |
| Rules | .claude/rules/ | Path-filtered | Technical patterns |
| Skills | .claude/skills/ | On invocation | Methodology |
| docs/ | docs/ | Manual/Search | Human-readable details |
/we:doc-review # Full review
/we:doc-review rules # Rules only (frontmatter, paths, size)
/we:doc-review [file.md] # Single file
| Check | Severity |
|---|---|
| Broken links | ISSUE |
| Duplicate content (>50% overlap) | WARNING |
| Stale (>3 months without update) | WARNING |
| Missing metadata (version, date) | INFO |
| Over 500 lines | INFO |
# Path-filtered rule (loads when editing matching files):
---
paths: src/**/*.py
---
# Always-loaded rule (no paths):
---
---
| Check | Severity |
|---|---|
Frontmatter syntax (opening + closing ---) | ISSUE |
| Path pattern resolves to actual files | ISSUE |
| Size within limits (50-400 lines) | WARNING |
| No duplicates with CLAUDE.md | WARNING |
| Check | Severity |
|---|---|
| YAML frontmatter (name, description) | ISSUE |
| name matches directory | ISSUE |
| Description includes trigger words | WARNING |
| Instructions are step-by-step | WARNING |
| Duplicate Type | Resolution |
|---|---|
| Rule ↔ Rule | Keep one, delete other |
| Rule ↔ CLAUDE.md | Keep in Rule, reference from CLAUDE.md |
| Rule ↔ Skill | Keep in Rule, Skill references |
| Skill ↔ Skill | Extract to shared location |
Rules load on EVERY relevant file edit. Keep them:
## Doc-Review Report
**Files Reviewed:** X
**Issues Found:** X (Y Blockers, Z Warnings)
### BLOCKERS
| File | Issue | Fix |
|------|-------|-----|
### WARNINGS
| File | Issue | Suggestion |
|------|-------|------------|
### TOKEN ANALYSIS
| Category | Files | Lines | Est. Tokens |
|----------|-------|-------|-------------|
Is this for Claude Code?
├── NO → docs/ (human reference)
└── YES → What type?
├── Vision/Fundamentals → CLAUDE.md
├── Git/CI/Story workflows → rules/workflows/
├── Stack-specific patterns → rules/stacks/ (with paths:)
├── Quality/Testing → rules/quality/ (with paths:)
├── Methodology for ONE skill → Keep in Skill
└── Overview only → CLAUDE.md