This is a Claude Code plugin - a collection of production-ready agents, skills, hooks, commands, rules, and MCP configurations. The project provides battle-tested workflows for software development using Claude Code. The project is organized into several core components: Follow the formats in CONTRIBUTING.md: - Agents: Markdown with frontmatter (name, description, tools, model) - Skills: Clear sections (When to Use, How It Works, Examples) - Commands: Markdown with description frontmatter - Hooks: JSON with matcher and hooks array File naming: lowercase…
Behavioral guidelines to reduce common LLM coding mistakes. Merge with project-specific instructions as needed. Tradeoff: These guidelines bias toward caution over speed. For trivial tasks, use judgment. Don't assume. Don't…
Todo-list discipline. When working through a multi-step plan, mark each task complete individually as you finish it. Do not batch-complete at the end. If a task turns out to be unnecessary, mark it skipped with a one-line reason. Think before heavy actions. For complex operations (refactors, migrations, non-trivial new features), briefly state your approach before executing. This lets the user course-correct cheaply instead of mid-flight. Dedicated tools over Bash. Prefer Read, Edit, Write, Glob, Grep over shell equivalents (cat, sed,…
UI UX Pro Max is an AI-powered design intelligence toolkit providing searchable databases of UI styles, color palettes, font pairings, chart types, and UX guidelines. It works as a skill/workflow for AI coding assistants (Claude Code, Windsurf, Cursor, etc.). Domain search: - product - Product type recommendations (SaaS, e-commerce, portfolio) - style - UI styles (glassmorphism, minimalism, brutalism) + AI prompts and CSS keywords - typography - Font pairings with Google Fonts imports - color - Color palettes by product…
This repository is a ready-to-use environment that makes Claude Code good at website design. When you (Claude) do any UI, web page, landing page, component, or visual-polish work in a project that uses this stack, follow the workflow below. It combines a knowledge layer (what to build), a taste layer (making it distinctive), and a feedback layer (actually seeing the rendered result and fixing it). 1. PLAN with data — ui-ux-pro-max. Before writing markup, get a concrete design system. Run…
Browser-Use is an async python >= 3.11 library that implements AI browser driver abilities using LLMs + CDP (Chrome DevTools Protocol). The core architecture enables AI agents to autonomously navigate web pages, interact with elements, and complete complex tasks by processing HTML and making LLM-driven decisions. The library follows an event-driven architecture with several key components: BrowserSession uses a bubus event bus to coordinate watchdog services: - DownloadsWatchdog: Handles PDF auto-download and file management - PopupsWatchdog: Manages JavaScript dialogs and…
Repository routing: do not continue Browse product work here. Source of truth is JuliusBrussee/caveman-browse, local checkout /Users/julb/Desktop/GitHub/caveman-browse. This directory is a consumer copy; edit only for pinned integration, migration/removal, or…
Detect a payload's type → route to a safety-classed compressor → count the token reduction → store the original for recovery. The stable four-call API (Compress/Retrieve/Detect/Stats) is what the proxy,…
The consumer top-of-funnel: a toggle that, on ChatGPT / Claude / Gemini, prepends the caveman skill directive to each message you send and re-fires the send, so the AI replies…
Declarative routing recipes for AI SDKs/frameworks: each recipe is the one-line base-URL shape that points a framework at the byte-safe gateway, with {{baseURL}} (gateway origin) and {{app}} (the /w/<app> attribution…
A thin stdio JSON-RPC adapter exposing the compression engine as five MCP tools to any host (Claude Code, Cursor, …). It owns only the MCP framing; all compression is the…
Durable, cross-session memory: remember / recall / supersede / history / forget. A local SQLite store holds the raw memories (the source of truth); recall ranks them with deterministic BM25…
A base-URL-swap reverse proxy: match → authenticate → inspect → byte-safe transform → upstream → meter. Single-operator, BYOK, zero cloud dependencies. It shares its provider adapters with the managed gateway…
Compress MCP/OpenAI tool definitions before they fill the context window. A thin Go wrapper over the engine's toolschema compressor: it drops annotation metadata (examples, titles, $comment, $schema) and reduces free-text…
The consent-gated half of caveman learn. The analyzer (the Go proxy) measures where an agent's tokens go and writes a ranked plan; this skill is what an agent loads to…
A file Claude Code reads at the start of every session. It holds the commands, conventions and warnings the agent needs for this project.
Where does it go?
At the repository root. Claude Code also reads CLAUDE.md files in subdirectories when it works there.
What should it contain?
Build and test commands, the project's layout, conventions that aren't obvious from the code, and mistakes to avoid. Short files tend to work better than long ones.
CLAUDE.md or AGENTS.md?
Claude Code reads CLAUDE.md; most other agents read AGENTS.md. Many projects keep one and point the other at it.
affaan-mCLAUDE.md
