A systematic, AI-powered development workflow that keeps projects organized, trackable, and moving forward.
A battle-tested workflow system that helps AI assistants (like Claude) work on your projects systematically instead of randomly. Perfect for solo developers, small teams, and anyone using AI coding assistants.
- ✅ Nothing gets forgotten — All work tracked in
TASKS.md - ✅ Full transparency — Complete audit log in
PROGRESS.md - ✅ Consistent quality — Code review checklist enforced automatically
- ✅ Resumable sessions — Claude picks up exactly where it left off
- ✅ Architectural memory — Decisions logged for future reference
- ✅ Git-friendly — Every task gets its own commit
# Clone this repo
git clone https://github.com/tugrulerdem/claude-task-workflow.git
cd claude-task-workflow
# Run installer in your project
./install-workflow.sh /path/to/your/project
# Start working
cd /path/to/your/project
# Tell Claude: "Read CLAUDE.md and start the workflow"# Clone and copy files
git clone https://github.com/tugrulerdem/claude-task-workflow.git
cd claude-task-workflow
cp *.md /path/to/your/project/
# Start working with Claude
cd /path/to/your/project
# Tell Claude: "Read CLAUDE.md and start"# Run setup script to add alias
./setup-alias.sh
# Now in any project:
cd /path/to/your/project
install-claude-workflow # That's it!your-project/
├── CLAUDE.md # ← Instructions for Claude to follow
├── CODE_REVIEW.md # ← Quality checklist (enforced every task)
├── TASKS.md # ← Your project's task list (auto-generated)
├── PROGRESS.md # ← Audit log of all work done
└── ...
┌─────────────────────────────────────────┐
│ 1. Claude reads TASKS.md │
│ 2. Picks next uncompleted task │
│ 3. Works on the task │
│ 4. Runs CODE_REVIEW checklist │
│ 5. Updates TASKS.md (mark [x]) │
│ 6. Appends to PROGRESS.md │
│ 7. Commits with descriptive message │
│ 8. Announces next task & repeats │
└─────────────────────────────────────────┘
You:
Read CLAUDE.md and start the workflow
Claude:
I've analyzed your React project.
Tech Stack: React 18, TypeScript, Vite
Existing: Authentication, Dashboard
Missing: User settings, notifications
Let me generate a task plan...
Phase 1: Complete Existing Features
- [ ] Implement user settings page
- [ ] Add profile editing
- [ ] Create notification system
Phase 2: Code Quality
- [ ] Fix 5 TypeScript errors
- [ ] Add error boundaries
- [ ] Implement loading states
Approve this plan? (yes/edit)
You: yes
Claude:
✅ TASKS.md created
✅ PROGRESS.md initialized
Starting Phase 1, Task 1: "Implement user settings page"
Working now...
[Creates components, adds routing, implements state management]
✅ Task complete!
✅ Code review passed
✅ Git commit: "task(phase-1): implement user settings page"
Next: "Add profile editing"
Starting now...
- React, Vue, Svelte, Angular
- Next.js, Vite, Create React App
- TypeScript + modern tooling
- State management (Redux, Zustand, Context)
- React Native + Expo
- Flutter (with customization)
- Cross-platform development
- Native performance optimization
- Backend APIs (Node.js, Python, Go)
- Full-stack applications
- DevOps and infrastructure projects
- Any software project with clear phases
| File | Purpose |
|---|---|
| SETUP.md | Complete setup guide with troubleshooting |
| EXISTING_PROJECT_GUIDE.md | Adding workflow to existing projects |
| QUICK_REFERENCE.md | One-page cheat sheet for daily use |
| INDEX.md | Complete file documentation |
npx create-react-app my-app
cd my-app
install-claude-workflow # (if you set up alias)
# Tell Claude: "Read CLAUDE.md and start"cd /path/to/existing/project
install-claude-workflow
# Tell Claude: "Read CLAUDE.md and analyze this existing project"cd /path/to/project
# Tell Claude: "Read CLAUDE.md and continue from where we left off"- Stay organized and focused
- Never forget what you were working on
- Build projects systematically
- Learn from documented decisions
- Shared understanding of progress
- Clear audit trail for reviews
- Consistent code quality
- Easy onboarding for new members
- Claude works autonomously
- Reduces back-and-forth
- Ensures quality standards
- Maintains context across sessions
# Tasks
## Phase 1: Project Setup ✅
- [x] Initialize TypeScript
- [x] Set up ESLint and Prettier
- [x] Create folder structure
## Phase 2: Core Features (In Progress)
- [x] Implement authentication
- [x] Create dashboard layout
- [ ] Add user settings
- [ ] Build notification system
...## [2026-02-05] — Implemented User Settings
**Phase:** 2 — Core Features
**Task:** Add user settings page
**Status:** Done
### What was done
- Created SettingsPage component
- Added form validation
- Integrated with API
- Added loading states
### Files created
- `src/pages/SettingsPage.tsx`
- `src/components/SettingsForm.tsx`
- `src/api/settingsApi.ts`
### Code Review Passed
- [x] TypeScript types defined
- [x] Error handling implemented
- [x] Accessibility compliant
- [x] Responsive design
### Next step
- Build notification system./install-workflow.sh /path/to/projectcp *.md /path/to/project/./setup-alias.sh
# Then in any project: install-claude-workflow# Clone to a templates folder
git clone https://github.com/tugrulerdem/claude-task-workflow ~/templates/
# Use in projects: cp ~/templates/claude-task-workflow/*.md .Edit CLAUDE.md to focus on:
- API endpoint development
- Database migrations
- Authentication strategies
- Testing (unit, integration, E2E)
Combine frontend and backend phases in TASKS_TEMPLATE.md
- Add company-specific coding standards to
CODE_REVIEW.md - Customize commit message format in
CLAUDE.md - Add team-specific phases and conventions
Contributions are welcome! Please see CONTRIBUTING.md for guidelines.
- 🐛 Report bugs and issues
- 💡 Suggest new features or improvements
- 📝 Improve documentation
- 🔧 Submit PRs for enhancements
- ⭐ Star the repo if you find it useful!
MIT License - See LICENSE for details.
Free to use for personal and commercial projects.
Created for developers who want:
- Systematic progress over scattered work
- AI assistance that actually helps
- Quality code without manual reviews
- Projects that finish instead of stalling
If this workflow helps you, please:
- ⭐ Star this repository
- 🐦 Share on Twitter
- 📝 Write a blog post about your experience
- 💬 Share in your dev communities
Q: Does this only work with Claude? A: Optimized for Claude, but any AI assistant that reads markdown can use it.
Q: Can I use this without AI? A: Yes! The structure helps even for manual development.
Q: What if a task is too large? A: Tell Claude: "Split this task into sub-tasks" and it will break it down.
Q: How do I reset if something goes wrong?
A: Delete TASKS.md and PROGRESS.md, restart the workflow.
Q: Can multiple people use this on the same project?
A: Yes, but coordinate on TASKS.md updates to avoid conflicts.
Ready to transform your development workflow?
git clone https://github.com/tugrulerdem/claude-task-workflow.git
cd claude-task-workflow
./install-workflow.sh /path/to/your/projectThen tell Claude: "Read CLAUDE.md and start the workflow"
Made with ❤️ for developers who ship.
Last updated: 2026-02-05