managing-documentation | development-rules | ClaudePluginHub

Skill

Community

managing-documentation

From development-rules

3

Description

Documentation generation workflows: ADR creation, skill generation, rule generation. Provides templates and processes for technical documentation. Triggers: ADR, documentation, architecture decision, rulify, skill generation, MADR.

AI Summary

Generates documentation workflows for ADRs, skills, and rules with templates and processes.

Install

1

Add the repository(one-time)

$

/plugin marketplace add thkt/claude-config

2

Install the plugin

$

/plugin install complete-workflow-system@thkt-development-workflows

Tool Access

This skill is limited to using the following tools:

ReadWriteGrepGlobEdit

Supporting Assets

View in Repository

references/adr-workflow.md

references/rulify-workflow.md

Skill Content

Managing Documentation

Documentation generation workflows for ADRs, skills, and rules.

Purpose

Centralize documentation workflow patterns that were embedded in individual commands. Commands become thin orchestrators that reference this skill for documentation logic.

Workflow References

Workflow	Reference	Command
ADR Creation	@./references/adr-workflow.md	/adr
Rulify	@./references/rulify-workflow.md	/rulify

Quick Reference

ADR (Architecture Decision Record)

MADR format (Markdown Any Decision Record):

# ADR-NNNN: [Title]

## Status

Proposed | Accepted | Deprecated | Superseded

## Context

[What is the issue?]

## Decision

[What is the decision?]

## Consequences

[What are the results?]

ADR Numbering

Location: ~/.claude/adr/
Format: ADR-NNNN-title.md
Next number: Auto-detected from existing files

Rulify Flow

ADR (decision) → Rule (enforcement) → CLAUDE.md (integration)

1. Read ADR content
2. Extract enforceable rules
3. Generate rule file in rules/
4. Update CLAUDE.md references

Documentation Guidelines

Principle	Application
Clarity > Completeness	Apply Occam's Razor
EN/JP Sync	Both versions must match
No Circular Refs	Max 3 levels deep
Mermaid > ASCII	Use Mermaid diagrams

Templates

ADR Template

~/.claude/templates/adr/madr-template.md

Rule Template

~/.claude/templates/rules/rule-template.md

References

Principles (rules/)

@../../rules/guidelines/DOCUMENTATION_RULES.md - Documentation guidelines
@../../rules/guidelines/JP_EN_TRANSLATION_RULES.md - Translation rules

Related Skills

creating-adrs - ADR creation fundamentals

Used by Commands

/adr - ADR creation
/rulify - Rule generation from ADR

Links

GitHub Stats

0 forks

Updated 13 hours ago

Similar Skills

Command Development

This skill should be used when the user asks to "create a slash command", "add a command", "write a custom command", "define command arguments", "use command frontmatter", "organize commands", "create command with file references", "interactive command", "use AskUserQuestion in command", or needs guidance on slash command structure, YAML frontmatter fields, dynamic arguments, bash execution in commands, user interaction patterns, or command development best practices for Claude Code.

54.7k

Agent Development

This skill should be used when the user asks to "create an agent", "add an agent", "write a subagent", "agent frontmatter", "when to use description", "agent examples", "agent tools", "agent colors", "autonomous agent", or needs guidance on agent structure, system prompts, triggering conditions, or agent development best practices for Claude Code plugins.

54.7k

Hook Development

This skill should be used when the user asks to "create a hook", "add a PreToolUse/PostToolUse/Stop hook", "validate tool use", "implement prompt-based hooks", "use ${CLAUDE_PLUGIN_ROOT}", "set up event-driven automation", "block dangerous commands", or mentions hook events (PreToolUse, PostToolUse, Stop, SubagentStop, SessionStart, SessionEnd, UserPromptSubmit, PreCompact, Notification). Provides comprehensive guidance for creating and implementing Claude Code plugin hooks with focus on advanced prompt-based hooks API.

54.7k