klausify 0.1.7

Claude Code boilerplate generator — scaffolds CLAUDE.md, PR checklists, slash commands, settings, hooks, and CI workflows

klausify

Claude Code boilerplate generator. One command to make any repo Claude Code-ready.

Install

pip install klausify

Requires conventions-cli (installed automatically).

Quick Start

cd your-repo
klausify init

That's it. You'll be prompted for your base branch (auto-detects dev, main, etc.), then klausify generates everything.

What Gets Generated

.claude/
├── CLAUDE.md                    # Repo conventions (via conventions-cli)
├── settings.json                # Tool permissions + deny rules + PreCommit hooks
└── commands/
    ├── pr-review-<repo>.md      # PR review with parallel sub-agents and repo-specific checks
    ├── test.md                  # Write tests for current changes
    ├── fix.md                   # Fix lint/format/type errors
    ├── pr.md                    # Generate a PR description
    ├── commit.md                # Generate a commit message
    ├── debug.md                 # Debug an error with root-cause analysis and a failing test
    ├── implement.md             # Implement a pasted task/ticket/design doc with plan-mode investigation
    ├── refactor.md              # Refactor code while preserving behavior, with test-backed safety net
    ├── new-worktree.md          # Create a git worktree for a task
    └── explain.md               # Explain code or current diff

.github/
└── PULL_REQUEST_TEMPLATE.md     # Only if repo doesn't have one

AGENTS.md                        # Only if repo doesn't have one

.gitignore                       # Appends klausify output exclusions

What each piece does

CLAUDE.md — Auto-detected conventions, architecture, commands, and pitfalls for your repo. This is what Claude Code reads to understand your project.

settings.json — Auto-detects your stack (Python, Node, Go, Rust, Make) and sets tool permissions. Detects sensitive files (.env, *.pem, credentials*) and adds deny rules so Claude can't read them.

Slash commands — Available as /pr-review-<repo>, /test, /fix, /pr, /commit, /debug, /implement, /refactor, /new-worktree, /explain in Claude Code:

Command	What it does	Output
/pr-review-<repo>	Senior-level PR review against your base branch. Small PRs get a single-pass review; larger PRs fan out to parallel sub-agents (correctness, architecture, security, scope) with a validation phase that removes false positives	REVIEW_OUTPUT.md
/test	Writes tests for current changes matching your repo's test patterns. Covers happy path, edge cases, and error paths without over-mocking	—
/fix	Fixes all lint, format, and type errors	—
/pr	Generates a ready-to-paste PR description	pr-description.md
/commit	Generates a commit message from staged changes	—
/debug	Five-phase debug flow: reproduce, diagnose root cause, write a failing test, fix, verify against the full suite	—
/implement <task>	Implements a pasted ticket or design doc. Uses plan mode to investigate and plan before editing, enforces scope rules, and writes failing tests first for bug fixes	—
/refactor <target>	Refactors code while preserving behavior exactly. Requires a passing test baseline, runs tests between every incremental step	—
/new-worktree	Creates a git worktree with a branch named for your task	—
/explain	Explains code or concept; defaults to explaining the current diff	—

PreCommit hooks — Auto-detects your lint/format commands and runs them before each commit.

PR template — A basic PR template, only created if your repo doesn't already have one (checks root, .github/, and docs/).

AGENTS.md — Lightweight instructions for AI agents, only created if one doesn't exist.

.gitignore — Appends pr-description.md and REVIEW_OUTPUT.md so generated outputs don't get committed.

Options

klausify init [OPTIONS]

Options:
  -r, --repo PATH             Target repository (default: current directory)
  -f, --force                 Overwrite existing files
  -b, --base-branch TEXT      Base branch for diffs (default: auto-detect, prompts)
  --skip-enrich               Skip Claude CLI enrichment (faster, no API call)
  --review-template PATH      Use a custom review prompt instead of the default

Custom review template

If your team has a specific review checklist (e.g. domain-specific checks, security requirements), pass it in:

klausify init --review-template path/to/your-review.md

The template will be used as the /pr-review-<repo> slash command instead of the default.

Individual Commands

You can run each step individually:

klausify checklist              # Regenerate review command from CLAUDE.md
klausify commands               # Regenerate slash commands
klausify settings               # Regenerate settings.json
klausify hooks                  # Regenerate hook configs
klausify github                 # Regenerate PR template

All subcommands support --repo, --force, and --base-branch where applicable.

How It Works

1. Runs conventions discover --claude --init to analyze your codebase and generate CLAUDE.md
2. Parses CLAUDE.md to extract conventions, commands, and pitfalls
3. Injects those into the review command template so /pr-review-<repo> checks repo-specific rules
4. Detects your stack from marker files (pyproject.toml, package.json, go.mod, etc.)
5. Sets permissions, deny rules, and hooks based on what it finds
6. Skips anything that already exists (PR template, AGENTS.md) unless --force is used

Claude Code Integration

klausify can be used three ways with Claude Code:

As a CLI (simplest)

pip install klausify
klausify init

As a Claude Code Plugin

Install the plugin directly from GitHub:

/plugin install https://github.com/steph-dove/klausify

This gives you the /klausify-init skill and the MCP server.

As an MCP Server

Add klausify as an MCP server so Claude can invoke it directly:

pip install klausify[mcp]
claude mcp add --transport stdio klausify -- klausify-mcp

Or add to your project's .mcp.json:

{
  "mcpServers": {
    "klausify": {
      "command": "klausify-mcp",
      "env": { "PYTHONUNBUFFERED": "1" }
    }
  }
}

The MCP server exposes these tools: klausify_init, klausify_checklist, klausify_commands, klausify_settings, klausify_status.

Requirements

• Python 3.10+
• conventions-cli >= 1.3.0
• Claude Code CLI (optional, for --init enrichment)
• mcp (optional, for MCP server: pip install klausify[mcp])

Contributing

See CONTRIBUTING.md for contributor guidelines.

License

MIT — see LICENSE for details.

Ownership and Governance

klausify is an open-source project owned and maintained by Dovatech LLC.

Dovatech LLC is a privately held company founded and wholly owned by Stephanie Dover, who is also the original author and lead maintainer of this project.