This repository contains descriptions and tooling for a set of best practices using Claude Code. It includes the following.
-
Documentation for how to set up and configure your Claude environment so as to be secure and managed.
-
A documented development workflow based around developing features with regular spec / design / review / sign off iterations.
-
The
devprocplugin, containing skills and agents to support and enforce the workflow via Claude slash commands. -
A Docker container that runs Claude with full permissions, for when you want Claude to work autonomously without sandbox restrictions. The container itself is restricted: no git credentials are configured, and writes on the host are limited to the mounted project directory.
-
Follow docs/setup.md to configure your environment.
-
Follow docs/workflow.md to follow the feature workflow.
-
See docs/capabilities.md for code review and other capabilities.
-
See docs/container.md to run Claude in a container with full permissions.
| Document | What it covers |
|---|---|
| docs/setup.md | Environment setup: sandbox, git hook, sensitive-file deny-list, gh, devproc install, .claudeignore |
| docs/workflow.md | Task-oriented guide: managing features from backlog to completion, including per-feature sign-off criteria and automated spec/design review |
| docs/capabilities.md | Semi-autonomous workflow management, code review, documentation review, and internal docs hygiene |
| docs/container.md | Container mode: running Claude with full permissions in a restricted Docker container |
| devproc/README.md | devproc plugin reference: all skills, agents, and configuration |
| setup-files/README.md | Files copied into place during setup (.claudeignore, git-write hook): destination and purpose |
| tests/README.md | Maintainer test fixtures for the devproc plugin's reviewer agents and the /review-docs skill, kept outside the shipped plugin directory: four suites under tests/devproc/, each with its own README.md, plus a regression harness in tests/devproc/harness/ |
| Plugin | Description |
|---|---|
| devproc | Feature lifecycle, workflow orchestration, code review, documentation review, and internal docs hygiene: spec, design, implement, review, and close features |
Plugins are registered in .claude-plugin/marketplace.json. See CONTRIBUTING.md for contribution guidelines. Each entry names the plugin and points to its source directory. A new plugin needs both an entry here and its own directory with a .claude-plugin/plugin.json manifest.