claude-codepro  by maxritter

AI code development powered by spec-driven workflows and TDD

Created 2 months ago
352 stars

Top 79.2% on SourcePulse

GitHubView on GitHub
Project Summary

This project provides a professional, containerized development environment for Claude Code (CC), enabling spec-driven workflows, TDD enforcement, persistent memory, and semantic code search. It targets developers seeking a structured and robust approach to building with AI assistants, offering systematic shipping and enhanced code quality through automated hooks and modular rules.

How It Works

Claude CodePro operates within a Dev Container, ensuring consistent tooling and isolation. Its core is a Spec-Driven Development (SDD) workflow managed via slash commands (/plan, /implement, /verify). It leverages a Modular Rules System that loads .md files as project memory, supporting both standard best practices and custom project-specific logic. Enhanced context capabilities include cross-session persistent memory (Claude Mem), local vector store semantic search (Claude Context), real-time web search (Tavily), and AI-powered code context retrieval (Ref). Intelligent hooks automate quality checks, linting, and enforce TDD before code edits.

Quick Start & Requirements

  • Primary Install: Execute curl -fsSL https://raw.githubusercontent.com/maxritter/claude-codepro/v3.2.11/install.sh | bash in your project, then reopen the project in the Dev Container.
  • Prerequisites: Docker Desktop or OrbStack (macOS), VS Code, Cursor, Windsurf, or Antigravity IDE with the Dev Containers extension.
  • Setup: Installation occurs automatically within the isolated Dev Container environment, configuring global tools like Python, qlty, Claude Code, and dotenvx.
  • Links: Website: https://claude-code.pro

Highlighted Details

  • Spec-Driven Workflow: Utilizes commands like /setup, /plan, /implement, and /verify to structure development tasks.
  • TDD Enforcement: A pre-edit hook warns developers if they attempt to modify code without passing tests.
  • Modular Rules System: Automatically loads project memory from .claude/rules/*.md files, allowing for custom, path-specific rules.
  • Persistent Memory & Semantic Search: Integrates multiple AI services for cross-session memory retention and efficient, token-aware code retrieval.
  • Quality Hooks: Post-edit hooks automate code formatting and linting (e.g., ruff, mypy, basedpyright).

Maintenance & Community

The project integrates heavily with numerous other open-source tools and services, including qlty, claude-mem, claude-context, tavily-ai, ruff, and uv, suggesting active maintenance through its dependencies. No direct community links (Discord, Slack) are provided in the README.

Licensing & Compatibility

  • License: AGPL-3.0.
  • Compatibility: The AGPL-3.0 license is a strong copyleft license. Use in commercial or closed-source projects requires careful consideration, as derived works typically must also be licensed under AGPL-3.0.

Limitations & Caveats

The environment strictly requires a Dev Container setup, necessitating Docker or OrbStack. Some IDEs (Cursor, Windsurf, Antigravity) require manual re-execution of the install script post-container start. The AGPL-3.0 license imposes significant obligations regarding source code availability for distributed modifications.

Health Check
Last Commit

2 days ago

Responsiveness

Inactive

Pull Requests (30d)
7
Issues (30d)
0
Star History
219 stars in the last 30 days

Explore Similar Projects

Feedback? Help us improve.