dotclaude - Agentic Programming Flow for Claude Code

Transform your development workflow with AI-powered automation from issue definition to implementation and review.

dotclaude is a Claude Code configuration that enhances Claude Code with reusable skills, creating a complete agentic programming flow - where AI handles the entire development lifecycle from understanding requirements to implementing solutions and addressing review feedback.

The Agentic Programming Flow

Our three-phase workflow automates the entire development process:

graph LR
    A[Define] --> B[Implement] --> C[Review]
    A --> |"/gh-issue"| A1[Research codebase<br/>Understand problem<br/>Create detailed issue]
    B --> |"/start-working-on-issue"| B1[Setup environment<br/>Implement solution<br/>Run tests<br/>Create PR]
    C --> |"/review-pr-comments"| C1[Address feedback<br/>Fix issues<br/>Update PR]

Loading

1. Define (/gh-issue)

Claude researches your codebase, understands the problem context, and creates a comprehensive GitHub issue with implementation details.

2. Implement (/start-working-on-issue)

Claude automatically sets up the development environment, implements the complete solution, runs tests, and creates a pull request - all in one command.

3. Review (/review-pr-comments)

Claude addresses PR review comments, makes requested changes, and updates the pull request until it's ready to merge.

Key Features

• Full Automation: From issue creation to PR merge - Claude handles the entire workflow
• Remote Execution Ready: Designed for implementation on remote machines
• Context-Aware: Claude understands your codebase structure and conventions
• Quality First: Automatic linting, type checking, and test execution
• Git Best Practices: Properly formatted commits with issue references

Prerequisites

• GitHub CLI installed and authenticated (gh auth login)
• Git configured with your credentials
• Claude Code installed

Installation

1. Clone this repository:

git clone https://github.com/heydiga/dotclaude.git
cd dotclaude

2. Copy skills to your Claude configuration directory:

# Create the directory if it doesn't exist
mkdir -p ~/.claude/skills

# Copy all skills
cp -r skills/* ~/.claude/skills/

3. Restart Claude Code or reload your configuration

That's it! The skills are now available in your Claude Code environment.

Usage

Complete Development Cycle Example

# 1. Define a new feature or bug fix
/gh-issue "Add dark mode support to the dashboard"

# 2. Implement the solution (Claude will handle everything)
/start-working-on-issue 123

# 3. Address review feedback
/review-pr-comments 456

Available Skills

Core Workflow

Skill	Description
/gh-issue	Create a GitHub issue with codebase research and implementation details
/start-working-on-issue	Implement an issue end-to-end: branch, code, tests, PR
/review-pr-comments	Address PR feedback and update the pull request
/commit	Create git commits using Conventional Commits format
/create-pr	Create a pull request with quality checks
/create-branch	Generate and create a properly named feature branch
/fix-ci	Diagnose and fix CI/CD pipeline failures
/merge-to-staging	Merge current branch into staging with conflict resolution
/slack-pr-recap	Generate a Slack recap message for a PR
/create-skill	Interactive guide for creating new Claude skills

Testing & Reference

Skill	Description
/testing-guide	Test writing patterns, mocking strategies, and test data templates
/test-coverage-improve	Analyze and improve test coverage targeting 80%+
/ui-patterns	Dashboard UI templates for layouts, loading states, and scroll patterns

Configuration

Customization

Each skill is defined as a markdown file in its own directory under skills/. You can:

• Modify existing skills by editing the SKILL.md files
• Add new skills by creating new directories with SKILL.md files
• Skills use YAML frontmatter for metadata (name, description, optional allowed-tools)

Contributing

We welcome contributions! Here's how you can help:

How to Contribute

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-skill)
3. Make your changes
4. Test your changes in Claude Code
5. Commit your changes (git commit -m 'Add amazing skill')
6. Push to the branch (git push origin feature/amazing-skill)
7. Open a Pull Request

Contribution Guidelines

• Skill Format: Follow the existing structure with YAML frontmatter (name, description, optional allowed-tools)
• Documentation: Update README.md if adding new skills
• Testing: Test skills thoroughly before submitting
• Code Style: Match existing formatting and conventions

Ideas for Contributions

• Additional workflow skills (e.g., /deploy, /rollback)
• Integration with other tools (Jira, Linear, etc.)
• Language-specific skills (Python, Go, Rust workflows)
• Team collaboration features
• Performance optimization skills

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

• Built for Claude Code by heydiga
• Inspired by the need for truly autonomous development workflows
• Infinite thanks to @flype for inspiration with dot-claude
• Thanks to all contributors and the Claude Code community

Links

• Claude Code Documentation
• Report Issues
• heydiga

---

Ready to revolutionize your development workflow? Install dotclaude and let AI handle the implementation details while you focus on what matters - defining great solutions.

Made with love by heydiga