By dgalarza
Audit codebase documentation for accuracy, completeness, and freshness by comparing it to actual code structure. Enable fix mode to automatically resolve small discrepancies and generate reports on structural changes. Supports any language or framework via git integration.
npx claudepluginhub dgalarza/claude-code-workflows --plugin doc-auditA collection of skills, agents, and workflows for Claude Code.
YouTube | Newsletter | Blog
Via npx (skills only):
npx skills add dgalarza/claude-code-workflows --skill "tdd-workflow"
Via Claude marketplace (skills, agents, bundles):
/plugin marketplace add dgalarza/claude-code-workflows
/plugin install tdd-workflow@dgalarza-workflows
See INSTALL.md for full details.
Does your codebase support AI agent work — or fight against it?
The Codebase Readiness plugin scores your repo across 8 dimensions (0-100) and tells you exactly where you stand — framed against teams shipping 1,000+ AI-generated PRs per week.
/plugin install codebase-readiness@dgalarza-workflows
/codebase-readiness
You get a band rating (Agent-Ready → Not Agent-Ready), a concrete improvement roadmap, and an optional saved report to share with your team. Not opinions — evidence gathered from your actual codebase.
Once you have your score, the agent-ready plugin fixes the documentation gaps automatically: CLAUDE.md, ARCHITECTURE.md, and docs/ structure following progressive disclosure patterns.
Learn more → | See the full assessment details | Get the Agent-Ready Codebase Playbook | Want help improving your score?
| Skill | Description |
|---|---|
| Codebase Readiness | Score your repo's readiness for autonomous AI agent work |
| Agent Ready | Fix documentation gaps: scaffold CLAUDE.md, ARCHITECTURE.md, and docs/ |
| TDD Workflow | Test-driven development, one test at a time |
| Conventional Commits | Structured commit messages |
| Parallel Code Review | Multi-agent code reviews |
| Meeting Transcript | Process transcripts into structured notes |
| Gridfinity Planner | 3D printing baseplate planning |
| Agent | Description |
|---|---|
| Cybersecurity Reviewer | Security analysis and threat modeling |
| Bundle | Description |
|---|---|
| Rails Toolkit | Complete Rails workflow with TDD, reviews, Linear integration |
If this helped you, give it a star — it helps others find it.
| Tip | Description |
|---|---|
| Use Worktrees for Parallel Agents | Run multiple Claude Code agents on the same codebase without conflicts |
| Customize Your Status Bar | Configure the status bar to show model, tokens, and more |
| Compact Context Proactively | Keep Claude effective by compacting at the right times |
| Structure Your CLAUDE.md Files | Give Claude the project context it needs |
| Use Subagents for Focused Tasks | Spawn specialized subagents for reviews, research, and more |
| MCP Servers Worth Installing | Linear, Memory, and Sentry integrations |
| Plugins Worth Installing | Claudit configuration auditor and more |
| Skills Worth Installing | Frontend Design, Remotion video creation, and more |
Found a bug? Have a workflow to share? PRs welcome.
MIT
Built by Damian Galarza - Former CTO, 15+ years in software. I make videos about Claude Code and AI development workflows.
Agent-Ready Codebase Assessment — scores your codebase across 8 dimensions and generates an actionable improvement roadmap framed around the Stripe AI benchmark
Share bugs, ideas, or general feedback.
AI-agent readiness auditing for project documentation and workflows. Evaluates whether future Claude Code sessions can understand docs, execute workflows literally, and resume work effectively. Use when onboarding AI agents to a project or ensuring context continuity. Includes three specialized agents: context-auditor (AI-readability), workflow-validator (process executability), handoff-checker (session continuity). Use PROACTIVELY before handing off projects to other AI sessions or team members
Documentation quality, generation, and improvement using Diataxis principles. Pairs with beagle-core for full workflow.
Adversarial multi-agent pipeline for Claude Code. GAN-style loops where generators produce artifacts, discriminators validate them, and feedback drives convergence.
Use this agent when you need to analyze a service or codebase component and create comprehensive documentation in CLAUDE.md files. This agent should be invoked after implementing new services, major refactoring, or when documentation needs updating to reflect the current codebase structure. Examples: <example>Context: The user has just implemented a new authentication service and wants to document it properly. user: 'I just finished implementing the auth service, can you document how it works?' assistant: 'I'll use the codebase-documenter agent to analyze the authentication service and create detailed documentation in CLAUDE.md' <commentary>Since the user has completed a service implementation and needs documentation, use the Task tool to launch the codebase-documenter agent to create comprehensive CLAUDE.md documentation.</commentary></example> <example>Context: The user wants to ensure a newly added API module is properly documented for the team. user: 'We need documentation for the new payment processing API I just added' assistant: 'Let me use the codebase-documenter agent to analyze the payment processing API and create proper documentation' <commentary>The user needs documentation for a new API module, so use the codebase-documenter agent to create CLAUDE.md files with setup instructions and architectural notes.</commentary></example>
Check how well your repo supports AI coding agents.