mvandermeulen

Claude-SPARC Automated Development System For Claude Code

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

Overview

The SPARC Automated Development System (claude-sparc.sh) is a comprehensive, agentic workflow for automated software development using the SPARC methodology (Specification, Pseudocode, Architecture, Refinement, Completion). This system leverages Claude Code's built-in tools for parallel task orchestration, comprehensive research, and Test-Driven Development.

Features

mvandermeulen

CLAUDE.md - Universal Development Principles

This document contains universal development principles and practices for AI assistants working on any project. These principles are derived from battle-tested practices and represent a philosophy of clear, honest, and systematic development.

Required Tools and Research Methods

1. Mandatory MCP Tool Usage

BEFORE ANY ACTION, you MUST use these tools. Tool names use double underscores between segments.

mvandermeulen

Claude Code Hooks for working with uv

by Glenn Matlin / glennmatlin on all socials

Installation

1. Download and copy all files in this gist to ~/.claude/
2. Move the .py files to ~/.claude/hooks
3. Restart Claude Code.

mvandermeulen

#!/usr/bin/env zsh
# Multi-project worktree manager with Claude support
# 
# ASSUMPTIONS & SETUP:
# - Your git projects live in: ~/projects/
# - Worktrees will be created in: ~/projects/worktrees/<project>/<branch>
# - New branches will be named: <your-username>/<feature-name>
#
# DIRECTORY STRUCTURE EXAMPLE:
# ~/projects/

mvandermeulen

System Prompt: Architectural Principles to Code By

Use rg tool to search for files efficiently

Core Principles

1. Clean, Simple, Maintainable Code
   • Favor readability over cleverness
   • Prioritize simplicity in design

• Write code that future developers can easily understand

mvandermeulen

#!/usr/bin/env bash

set -euo pipefail

issue=$1

~/.claude/local/claude \
  "Start working on issue #$issue
- Keep an open mind. Feel free to reconsider the proposed approach
- Use context7 for updated docs

mvandermeulen

Claude Code + Serena MCP Auto-Wrapper

Zero-configuration automatic Serena MCP server management for Claude Code

Transparently starts exactly one Serena instance per project with unique ports. No per-project setup required!

✨ Features

• Zero Configuration: Just run claude - Serena starts automatically
• Per-Project Isolation: Each project gets its own Serena instance on unique ports (9000+)

mvandermeulen

Claude Code + Serena MCP Auto-Wrapper

Zero-configuration automatic Serena MCP server management for Claude Code

Transparently starts exactly one Serena instance per project with unique ports. No per-project setup required!

✨ Features

• Zero Configuration: Just run claude - Serena starts automatically
• Per-Project Isolation: Each project gets its own Serena instance on unique ports (9000+)

mvandermeulen

#!/bin/bash

# Claude Python Project Bootstrap Script
# Creates a new Python project configured for Claude TDD + Scrumban workflow

set -e  # Exit on any error

# Colors for output
RED='\033[0;31m'
GREEN='\033[0;32m'

mvandermeulen

name	description
Direct Dev	Concise, critical, no-nonsense responses for software development

You are Claude Code with a direct, development-focused communication style.

Core Communication Rules

Be Direct: Cut straight to the point. No preambles, pleasantries, or buffer language.