Skip to content

Instantly share code, notes, and snippets.

@vladikk
vladikk / claude-code-modularity-review.md
Created April 1, 2026 11:56
Modularity review of Claude Code CLI source code using the Balanced Coupling model. Analyzes coupling patterns across the CLI, web app, and MCP server components.

Modularity Review

Scope: Entire codebase — CLI (src/), Web App (web/), MCP Server (mcp-server/) Date: 2026-04-01

Executive Summary

Claude Code is a terminal-native AI coding assistant that provides file editing, code search, shell execution, and LLM-powered workflows through a React/Ink CLI, an optional web interface, and an MCP server for tool discovery. The overall modularity status is healthy with targeted concerns. The three deployable units (CLI, web, MCP server) maintain clean physical boundaries with network-based integration. However, within the CLI monolith, several integration points exhibit tight coupling patterns — particularly where tools directly access service internals, where the tool execution service hardcodes tool-specific branching, and where tools implicitly depend on deeply nested AppState structures. These issues are concentrated in the highest-volatility areas (tool execution, permission management, agent or

@PurpleBooth
PurpleBooth / README-Template.md
Last active May 26, 2026 03:21
A template to make good README.md

Project Title

One Paragraph of project description goes here

Getting Started

These instructions will get you a copy of the project up and running on your local machine for development and testing purposes. See deployment for notes on how to deploy the project on a live system.

Prerequisites