By dgalarza
Scaffold your codebase for AI agents by generating AGENTS.md, ARCHITECTURE.md, and docs/ structure with progressive disclosure patterns. Analyzes repo structure via bash recon and git, audits existing docs for coherence, and creates CLAUDE.md symlink for Claude Code compatibility.
npx claudepluginhub dgalarza/claude-code-workflows --plugin agent-readyA 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.
Makes a repo agent-ready: AGENTS.md, boundary tests, CI pipeline, GC scripts — based on OpenAI's harness engineering methodology
Share bugs, ideas, or general feedback.
Audit codebase documentation for accuracy, completeness, and freshness against actual code. Auto-fixes small discrepancies, reports structural changes. Companion to agent-ready.
Refactor bloated AGENTS.md, CLAUDE.md, or similar agent instruction files to follow progressive disclosure principles. Splits monolithic files into organized, linked documentation.
Generate and maintain AGENTS.md, copilot-instructions.md, and other agent rule files
Analyze and enforce best practices for AI coding agent projects. Assess codebase readiness across 8 pillars with /readiness, then scaffold enforcement with /setup: TDD, secret scanning, file size limits, auto-generated docs, and git hooks.
Check how well your repo supports AI coding agents.