docs-agent

WS Claude Marketplace

A curated registry of Claude Code plugins, agents, and tools built by ws.agency.

Available Plugins

Plugin	Description	Commands
docs-agent	Comprehensive documentation suite (Diátaxis, ADRs, changelogs, style guide)	/docs, /adr, /contributing, /architecture, /release-notes, /changelog
ws-commit-commands	Git workflows for Gitea using tea CLI	/ws-commit, /ws-commit-push-pr, /ws-clean-gone
ws-jira-enhancer	Transform task descriptions into Jira tickets	/ws-jira-enhancer
ws-claude-sync	Sync Claude contexts across machines via GitHub	/ws-sync-setup, /ws-sync, /ws-sync-pull, /ws-sync-push, /ws-sync-full, /ws-sync-status
ws-clamp	Move, archive, and manage Claude projects	/clamp-move, /clamp-inspect, /clamp-maintain, /clamp-archive

Prerequisites

• Claude Code CLI
• Git
• tea CLI (required for ws-commit-commands) — brew install tea
• Python 3 (required for ws-claude-sync)

Installation

# Add the marketplace (one-time setup)
claude plugin marketplace add [email protected]:wsagency/WS-Claude-marketplace.git

# Install individual plugins
claude plugin install docs-agent@ws-marketplace
claude plugin install ws-commit-commands@ws-marketplace
claude plugin install ws-jira-enhancer@ws-marketplace
claude plugin install ws-claude-sync@ws-marketplace
claude plugin install ws-clamp@ws-marketplace

# List available plugins
claude plugin marketplace list

# Update marketplace
claude plugin marketplace update ws-marketplace

# Uninstall a plugin
claude plugin uninstall docs-agent@ws-marketplace

Plugin Details

docs-agent

Comprehensive documentation generation suite covering the full docs-as-code lifecycle: Diátaxis framework docs, Keep a Changelog, Architecture Decision Records (MADR v4.0.0), CONTRIBUTING.md, ARCHITECTURE.md, release notes, Conventional Commits, style guide enforcement, and TSDoc/GraphQL API reference.

Commands:

• /docs — Generate a complete documentation suite following Diátaxis
• /docs-tutorial — Create a learning-oriented tutorial
• /docs-howto — Create a task-oriented how-to guide
• /docs-explanation — Write an understanding-oriented explanation
• /docs-reference — Generate API or technical reference documentation
• /adr — Create an Architecture Decision Record (MADR v4.0.0)
• /contributing — Generate CONTRIBUTING.md from project analysis
• /architecture — Generate ARCHITECTURE.md (matklad pattern)
• /release-notes — Generate user-facing release notes (Linear style)
• /changelog — Generate or update CHANGELOG.md from git history
• /changelog-entry — Add a single entry to CHANGELOG.md

Agents: docs-architect, tutorial-writer, api-documenter, changelog-analyzer, adr-writer, contributing-generator, architecture-documenter, release-notes-writer

Skills (knowledge bases): diataxis, keep-a-changelog, conventional-commits, style-guide, adr

Auto-Applying Documentation Skills

To make Claude Code automatically enforce documentation standards on your projects, add the following to your project's .claude/CLAUDE.md:

# Documentation Standards

Always apply these docs-agent standards when working on this project:

- **Commits**: Follow Conventional Commits format (`type(scope): description`)
- **Code changes**: Update CHANGELOG.md for user-facing changes
- **New features**: Check if an ADR is needed in docs/decisions/
- **TypeScript**: Use TSDoc comments on all public APIs
- **GraphQL**: Add descriptions to every type, field, and argument in the schema
- **Writing**: Follow Google style guide (active voice, present tense, second person)
- **Definition of done**: Documentation must ship with the feature

Available commands: /docs, /adr, /contributing, /architecture, /release-notes, /changelog

For hard enforcement, add hooks to .claude/settings.json:

{
  "hooks": {
    "Stop": [
      {
        "hooks": [
          {
            "type": "agent",
            "prompt": "Before stopping, verify: 1) Commit messages follow Conventional Commits. 2) CHANGELOG.md updated if user-facing changes were made. 3) Documentation updated for new/changed features. If anything is missing, return {\"ok\": false, \"reason\": \"what's missing\"}.",
            "timeout": 60
          }
        ]
      }
    ]
  }
}

ws-commit-commands

Git workflow commands for Gitea using tea CLI — commit, push, and create pull requests.