tasks-workflow-skill

tasks-workflow-init

A Claude Code Skill that bootstraps a complete structured task management workflow for any new code project.

What it does

One-command initialization of:

• CLAUDE.md — AI behavior constitution with RIPER-7 lifecycle (MODE 0-6) and risk grading (L0-L3)
• .tasks/ — Task management directory with version planning guide and risk evaluation framework
• .claude/commands/ — Slash commands for session handoff (/handoff.build, /handoff.exec) and daily reporting (/daily-report)
• .gitignore — Auto-appends handoff.md

Features

• RIPER-7 Lifecycle: 7 modes (Task Confirmation → Research → Innovation → Planning → Execution → Review → Task End) with automatic transitions
• Risk Grading: L0-L3 risk levels with mandatory gates, artifacts, and workflow routing
• Session Handoff: Save and restore context across Claude Code sessions via handoff.md
• Daily Report: Auto-generate work summaries from git logs and conversation history
• Version Planning: Solo-developer progressive planning methodology (PROGRESSIVE-PLAN.md)
• Parameterized: Customizable language, git author, regression commands, and constraints

Installation

Claude Code (recommended)

# Clone to your skills directory
git clone https://github.com/YOUR_USERNAME/tasks-workflow-skill.git ~/.claude/skills/tasks-workflow-init

Manual

Copy the SKILL.md and references/ directory to ~/.claude/skills/tasks-workflow-init/.

Usage

In any new project directory, say one of:

• "init workflow"
• "bootstrap .tasks"
• "初始化任务工作流"

The skill will ask for:

1. Project name (required)
2. Tech stack (required, e.g. "React + TypeScript + Vite")
3. Response language (default: Chinese)
4. Git author (default: from git config)
5. Regression commands (default: pnpm lint && pnpm tsc --noEmit)
6. Custom constraints (optional)

Then it generates all files with your values filled in.

Generated structure

your-project/
├── CLAUDE.md
├── .tasks/
│   ├── VERSION-PLANNING-GUIDE.md
│   ├── task_evaluation_framework.md
│   ├── active/
│   ├── completed/
│   └── suspended/
├── .claude/commands/
│   ├── handoff.build.md
│   ├── handoff.exec.md
│   └── daily-report.md
└── .gitignore

Auto-detection hook (optional)

Add to ~/.claude/settings.json to get prompted when entering an uninitialized project:

{
  "hooks": {
    "UserPromptSubmit": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "if [ ! -d '.tasks' ] && [ -f 'package.json' -o -f 'go.mod' -o -f 'Cargo.toml' -o -f 'pyproject.toml' ]; then echo '⚡ Detected code project without .tasks workflow. Consider running tasks-workflow-init.'; fi"
          }
        ]
      }
    ]
  }
}

License

MIT

Author

junnan.cheng