project-workflow

Project lifecycle automation with 7 slash commands. Use for idea exploration, project planning, session management, safe releases, or encountering /explore-idea, /plan-project, /plan-feature, /continue-session, /wrap-session, /release, /workflow command errors.

⭐9stars🔀0forks📁View on GitHub🕐Updated Jan 1, 2026⬇️1downloads

When & Why to Use This Skill

The Project Workflow skill for Claude Code provides a comprehensive suite of seven integrated slash commands designed to automate the entire software development lifecycle. By streamlining tasks from initial idea validation and structured planning to session context management and pre-release safety audits, this skill helps developers save 35-55 minutes per project while enforcing industry best practices and maintaining high-quality documentation.

Use Cases

  • New Project Initiation: Use /explore-idea to research tech stacks and validate concepts, followed by /plan-project to automatically generate comprehensive implementation roadmaps and session tracking files.
  • Seamless Session Transitions: Utilize /wrap-session and /continue-session to manage AI context, create git checkpoints, and generate handoff summaries, ensuring no progress is lost between different coding sessions.
  • Agile Feature Integration: Apply /plan-feature to existing projects to automatically update implementation phases and re-index project documentation when new requirements emerge.
  • Automated Release Safety: Execute /release to perform critical pre-flight checks, including secret scanning, documentation validation, and configuration audits before pushing code to GitHub or production environments.
  • Interactive Workflow Guidance: Use the /workflow command as a real-time navigator to determine the next logical step in the development process based on the current project state.
nameproject-workflow
descriptionProject lifecycle automation with 7 slash commands. Use for idea exploration, project planning, session management, safe releases, or encountering /explore-idea, /plan-project, /plan-feature, /continue-session, /wrap-session, /release, /workflow command errors.
Keywordsproject workflow, lifecycle automation, slash commands, planning, session management, release safety, implementation phases
licenseMIT
allowed-tools["Read", "Write", "Edit", "Bash"]

Project Workflow Skill

Complete project lifecycle automation for Claude Code

This skill provides 7 integrated slash commands that automate the entire project lifecycle from initial idea exploration through planning, execution, session management, and release safety checks.

Overview

The project-workflow skill saves 35-55 minutes per project lifecycle by automating repetitive tasks and enforcing best practices for context management, planning documentation, and safe releases.

What This Skill Does

  • Pre-Planning Research - Validate ideas, research tech stacks, manage scope
  • Automated Planning - Generate comprehensive IMPLEMENTATION_PHASES.md with verification criteria
  • Feature Addition - Integrate new features into existing project plans
  • Session Management - Handle context across multiple Claude Code sessions
  • Release Safety - Comprehensive checks before publishing to GitHub
  • Interactive Guidance - Navigate the workflow system with contextual help

Installation

# Add the marketplace
/plugin marketplace add https://github.com/jezweb/claude-skills

# Install project-workflow skill
/plugin install project-workflow@claude-skills

All 7 slash commands will be automatically available in Claude Code.

Manual Installation

# Clone the repository (choose your preferred location)
INSTALL_DIR="${HOME}/claude-skills"  # or your preferred path
git clone https://github.com/jezweb/claude-skills "$INSTALL_DIR"

# Copy commands to your Claude config
cp "$INSTALL_DIR/skills/project-workflow/commands/"*.md ~/.claude/commands/

The 7 Commands

Quick Start (5 Minutes)

New Project from Scratch

/explore-idea → /plan-project → work → /wrap-session → /continue-session

Adding Feature to Existing Project

/plan-feature → wrap/resume cycle

Ready to Release

/release → safety checks → GitHub release

Load references/workflow-examples.md for complete patterns.


1. /explore-idea - Pre-Planning Exploration

Validate ideas through research, challenge assumptions, prevent scope creep. Creates PROJECT_BRIEF.md with validated tech stack. Time saved: 10-15 min Load references/command-explore-idea.md for complete details.

2. /plan-project - Generate Project Planning Docs

Automate planning for NEW projects. Generates IMPLEMENTATION_PHASES.md, SESSION.md, and supporting docs. Time saved: 5-7 min Load references/command-plan-project.md for complete details.

3. /plan-feature - Add Features to Existing Projects

Integrate new features into existing plans. Handles phase renumbering, updates all planning docs. Requires SESSION.md + IMPLEMENTATION_PHASES.md. Time saved: 7-10 min Load references/command-plan-feature.md for complete details.

4. /wrap-session - End-of-Session Checkpoint

Automate session wrap-up. Updates SESSION.md with progress, creates git checkpoint, outputs handoff summary. Time saved: 2-3 min Load references/command-wrap-session.md for complete details.

5. /continue-session - Start-of-Session Context Loading

Seamlessly resume work. Loads SESSION.md context, shows recent commits, displays Next Action, asks permission to continue. Time saved: 1-2 min Load references/command-continue-session.md for complete details.

6. /workflow - Interactive Workflow Guide

Navigate command system with contextual guidance. Shows decision trees, offers to execute appropriate command. Use when unsure which command to use next. Load references/command-workflow.md for complete details.

7. /release - Pre-Release Safety Checks

Comprehensive safety checks before GitHub publishing. Scans secrets, validates docs, checks configs, runs quality checks, offers auto-fix. Time saved: 10-15 min Load references/command-release.md for complete details.


Workflow Patterns

Three main patterns: Full Workflow (with /explore-idea), Quick Workflow (skip exploration), Helper Workflows (standalone commands).

Load references/workflow-examples.md when planning complete project lifecycle.


Integration with Other Skills

The project-workflow skill works seamlessly with:

project-planning Skill

  • /plan-project and /plan-feature invoke this skill automatically
  • Generates IMPLEMENTATION_PHASES.md with proper structure
  • Creates DATABASE_SCHEMA.md, API_ENDPOINTS.md, etc.

project-session-management Skill

  • Provides the SESSION.md protocol used by /wrap-session and /continue-session
  • Defines handoff format and context tracking

Built-in Claude Code Agents

  • /wrap-session uses Task agent to analyze session state
  • /continue-session uses Explore agent to load context
  • /explore-idea uses Explore agent for research

Command Flow

Commands follow project lifecycle phases: Exploration (/explore-idea) → Planning (/plan-project) → Execution (wrap/resume cycle) → Release (/release). Helper command (/workflow) available anytime.

Load references/command-relationships.md when planning optimal command sequence.


Time Savings Breakdown

Command Time Saved Tasks Automated
/explore-idea 10-15 min Research, validation, scope management, tech stack evaluation
/plan-project 5-7 min Planning doc generation, git setup, phase structuring
/plan-feature 7-10 min Feature planning, phase integration, doc updates
/wrap-session 2-3 min SESSION.md updates, git checkpoint, handoff summary
/continue-session 1-2 min Context loading, git history review, next action display
/workflow Instant Navigation, decision trees, command selection
/release 10-15 min Secret scanning, doc validation, build testing, release creation

Total per project lifecycle: 35-55 minutes


Prerequisites

All commands: Claude Code CLI + Git repository (recommended). Planning commands: Existing SESSION.md for /plan-feature. Release: Git commits + remote URL configured.

Load references/setup-prerequisites.md when setting up workflow for first time.


Configuration

Customize planning templates (project-planning skill) and session protocol (project-session-management skill) by installing separately and modifying templates.

Load references/configuration-guide.md when customizing templates or session formats.


Top 5 Common Errors

1. /plan-project: "No project description provided"

Error: Command fails without generating planning docs Fix: Discuss project with Claude first, OR use /explore-idea to create PROJECT_BRIEF.md Prevention: Always provide context before planning

2. /plan-feature: "Prerequisites not met"

Error: Command refuses to run, mentions missing files Fix: Run /plan-project first to create SESSION.md and IMPLEMENTATION_PHASES.md Prevention: Only use /plan-feature on projects initialized with /plan-project

3. /wrap-session: "No git repository found"

Error: Command fails when creating checkpoint commit Fix: Initialize git: git init && git add . && git commit -m "Initial commit" Prevention: Always work in git-initialized projects

4. /continue-session: "SESSION.md not found"

Error: Command cannot load session context Fix: Run /plan-project to create SESSION.md, OR check you're in project root directory Prevention: Always run /wrap-session at end of sessions

5. /release: "Secrets detected"

Error: Release blocked due to potential API key/token leaks Fix: Add sensitive files to .gitignore, remove from git history with filter-branch Prevention: Always gitignore .env files, credentials.json, and similar sensitive files

Load references/troubleshooting-guide.md for complete guide with all error scenarios.


Best Practices

Key practices: Use /explore-idea for validation; plan before implementing; wrap sessions before context full (~150k tokens); always resume with /continue-session; use /plan-feature for new features; run /release on feature branches first.

Load references/best-practices.md for detailed patterns and anti-patterns.


Advanced Usage

Advanced patterns: Parallel feature planning (plan multiple, then prioritize); release workflow with feature branches; continuous session management across multi-day projects; phase reordering and splitting.

Load references/advanced-usage.md for complex workflows and power-user patterns.


When to Load References

Load reference files when working on specific workflow aspects:

Command Reference Files

references/command-explore-idea.md:

  • First time using /explore-idea
  • Need research/validation workflow details
  • Want example conversation flow

references/command-plan-project.md:

  • First time using /plan-project
  • Need to understand generated files
  • Troubleshooting missing planning docs

references/command-plan-feature.md:

  • First time using /plan-feature
  • Getting "prerequisites not met" errors
  • Need to understand phase integration workflow

references/command-wrap-session.md:

  • First time using /wrap-session
  • Need to understand session checkpoint workflow
  • Want to see handoff summary format

references/command-continue-session.md:

  • First time using /continue-session
  • Need to understand context loading workflow
  • Troubleshooting session context issues

references/command-workflow.md:

  • First time using project-workflow skill
  • Need to understand command relationships
  • Building similar interactive guidance systems

references/command-release.md:

  • First time using /release
  • Need to understand release safety phases
  • Troubleshooting release blockers

Workflow & Support Files

references/workflow-examples.md:

  • Planning complete project lifecycle
  • Want full workflow patterns (Full, Quick, Helper)
  • Understanding when to use which workflow

references/command-relationships.md:

  • Understanding command flow and dependencies
  • Planning optimal command sequence
  • Learning how commands integrate

references/setup-prerequisites.md:

  • Setting up workflow for first time
  • Checking if project meets requirements
  • Missing prerequisites errors

references/configuration-guide.md:

  • Customizing planning templates
  • Modifying session protocol format
  • Need to fork and customize skills

references/troubleshooting-guide.md:

  • Encountering errors with commands
  • Debugging workflow issues
  • Complete error catalog with solutions

references/best-practices.md:

  • Optimizing workflow efficiency
  • Learning recommended patterns
  • Avoiding common mistakes

references/advanced-usage.md:

  • Parallel planning workflows
  • Continuous session patterns
  • Complex release workflows
  • Multi-developer coordination

FAQ

Q: Can I use these commands without other skills? A: Yes, but /plan-project and /plan-feature work best with the project-planning skill installed.

Q: Do I need to use all 7 commands? A: No. Use /plan-project + /wrap-session + /continue-session for minimum workflow. Add others as needed.

Q: Can I modify the commands? A: Yes. Commands are .md files. Copy to ~/.claude/commands/ and edit.

Q: What if I don't want to use git? A: Most commands work without git, but /wrap-session, /continue-session, and /release heavily integrate with git.

Q: Can I use this with non-Cloudflare projects? A: Yes. The planning system is framework-agnostic. Works with any tech stack.

Q: How do I see what's in SESSION.md? A: Ask Claude: "show me SESSION.md" or use cat SESSION.md


  • project-planning - Generates IMPLEMENTATION_PHASES.md (used by /plan-project)
  • project-session-management - SESSION.md protocol (used by /wrap-session)
  • github-project-automation - GitHub Actions, issue templates, CI/CD
  • open-source-contributions - Contributing to open source projects

Version History

1.0.0 (2025-11-12)

  • Initial release
  • 7 integrated slash commands
  • Plugin marketplace distribution
  • Command bundling via plugin.json

Support


License

MIT License - See LICENSE file in repository