Semantic documentation standard for Python with context-aware docstring keys
Strict Marketplace
Themed Marketplace Availability
This plugin is not yet in any themed marketplace. To install it, you'll need to add it from GitHub directly.
Installation
Choose your preferred installation method below
A marketplace is a collection of plugins. Every plugin gets an auto-generated marketplace JSON for individual installation, plus inclusion in category and themed collections. Add a marketplace once (step 1), then install any plugin from it (step 2).
From All Plugins
Recommended
One-time setup for access to all plugins
When to use: If you plan to install multiple plugins now or later
A semantic documentation standard for Python that clarifies Responsibility, Context, and Intent —
designed both as a readable specification and as a Claude Code plugin.
What is Semantic Docstrings?
Semantic Docstrings is a documentation standard that extends traditional Python docstrings with a semantic layer.
It introduces one-word keys (e.g., Responsibility, Context, Role, Boundaries, Architecture, Should, Entry)
that capture why code exists, not just what it does.
This repository serves a dual purpose:
Specification: Readable guides and examples for adopting Semantic Docstrings in your projects.
Claude Code Plugin: Installable into Claude Code to encourage, enforce and autocomplete this documentation style.
Use the extended keys in your Python docstrings (with type hints in signatures, not inside the docstring body):
def process_message(payload: dict) -> str:
"""
Responsibility:
First line of defense for input validation.
Context:
Payload comes from an untrusted external API.
Enforces that `text` is mandatory, IDs optional.
Args:
payload: Untrusted API input.
Returns:
Extracted user message.
Raises:
ValueError: If `text` key is missing.
"""
As a Claude Code Plugin
Once installed, you can use Semantic Docstrings in three ways:
Option 1: Slash Commands (Recommended for Sessions)
Load semantic docstring context for your current session:
