dotclaude - Agentic Programming Flow for Claude Code

February 23, 2026 ยท View on GitHub

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]

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
  1. 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/
  1. 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

SkillDescription
/gh-issueCreate a GitHub issue with codebase research and implementation details
/start-working-on-issueImplement an issue end-to-end: branch, code, tests, PR
/review-pr-commentsAddress PR feedback and update the pull request
/commitCreate git commits using Conventional Commits format
/create-prCreate a pull request with quality checks
/create-branchGenerate and create a properly named feature branch
/fix-ciDiagnose and fix CI/CD pipeline failures
/merge-to-stagingMerge current branch into staging with conflict resolution
/slack-pr-recapGenerate a Slack recap message for a PR
/create-skillInteractive guide for creating new Claude skills

Testing & Reference

SkillDescription
/testing-guideTest writing patterns, mocking strategies, and test data templates
/test-coverage-improveAnalyze and improve test coverage targeting 80%+
/ui-patternsDashboard 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

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