super-dev CLAUDE.md

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Project Overview

Super Dev is a Python CLI tool (v2.4.0) that orchestrates AI-driven development pipelines inside host environments (e.g., Claude Code). It provides governance, quality gates, and audit artifacts for commercial-grade software delivery. It is NOT an independent AI agent — it's a governance layer that runs inside a host's coding environment.

Build & Development Commands

# Install in development mode (requires Python 3.10+)
pip install -e ".[dev]"

# Run the CLI
super-dev

# Linting & formatting
ruff check super_dev/              # lint
ruff check --fix super_dev/        # auto-fix lint issues
black super_dev/ --check           # check formatting
black super_dev/                   # apply formatting

# Type checking
mypy super_dev/

# Run all tests
pytest

# Run a single test file
pytest tests/unit/test_workflow.py

# Run a specific test
pytest tests/unit/test_workflow.py::test_function_name -v

# Run with coverage
pytest --cov=super_dev

Code Style

• Line length: 100 (configured in both ruff and black)
• Target Python: 3.10+
• Ruff rules: E, F, I, N, W, UP (E501 ignored)
• All imports must be sorted (ruff I rule)

Architecture

Core Pipeline (super_dev/)

The CLI entry point is super_dev/cli.py (~6k lines), built as a large class composed via mixins:

• cli_parser_mixin.py — argparse command definitions
• cli_analysis_mixin.py — analysis subcommands
• cli_governance_mixin.py — governance/enforcement subcommands
• cli_host_ops_mixin.py — host tool operations
• cli_experience_mixin.py — UX enhancements
• cli_deploy_runtime_mixin.py — deployment/runtime commands
• cli_release_quality_mixin.py — release & quality commands
• cli_spec_mixin.py — spec management commands

Pipeline Orchestration (super_dev/orchestrator/)

• engine.py — main pipeline engine driving phase transitions
• governance.py — governance policy enforcement during pipeline
• knowledge.py / knowledge_pusher.py — knowledge injection into pipeline stages
• quality.py — quality gate evaluation
• contracts.py — pipeline contract definitions