A structured workflow management system for Claude Code that standardizes development processes through reusable command macros.

This repository provides a framework for consistent AI-assisted development using Claude Code. It establishes:

• Standard development workflows
• Consistent coding practices
• Automated task management
• Integration with Linear for task tracking

Located in .claude/commands/, these markdown files serve as Claude Code macros:

• context_prime.md - Initializes Claude with project guidelines at the start of each session
• work_task.md - Implements the standard development workflow for tasks

Located in docs/agent_guidelines/, these files establish project standards:

• BRANCHING_STRATEGY.md - Git workflow based on GitFlow with defined branch types and naming conventions
• CODING_STANDARDS.md - Python style guide, formatting rules, naming conventions, and best practices
• LOGGING_GUIDE.md - Logging configuration, usage patterns, and best practices for effective logging

BRANCHING_STRATEGY.md

• Defines main branches (main, develop) and supporting branches (feature/*, release/*, hotfix/*)
• Outlines workflow for feature development, release preparation, and hotfix processes
• Establishes naming conventions and merging rules for each branch type

CODING_STANDARDS.md

• Specifies Python style guide following PEP 8
• Defines formatting tools (black) and linting requirements (flake8)
• Establishes naming conventions for modules, classes, functions, and variables
• Provides guidelines for imports, error handling, and testing
• Includes specific guidelines for LLM agent collaboration

LOGGING_GUIDE.md

• Details logging configuration through config.yml and environment variables
• Explains console and file logging setup with rotation policies
• Provides code examples for proper logger initialization and usage
• Outlines best practices for effective logging

1. Start a new session:

   /context_prime
   

   This loads all guidelines from docs/agent_guidelines/ into Claude's context.

2. Work on a task:

   /work_task LIN-123
   

   This retrieves the specified Linear task and follows the standardized workflow:

   • Task analysis
   • Implementation planning
   • Human review checkpoints
   • Implementation
   • Final review

• Consistency: Standardized approach to development tasks
• Efficiency: Reduced context-setting overhead
• Quality: Built-in review checkpoints
• Documentation: Self-documenting workflows

See docs/agent_guidelines/CODING_STANDARDS.md for contribution guidelines.