claude-world

workflow

8
2
# Install this skill:
npx skills add claude-world/director-mode-lite --skill "workflow"

Install specific skill from multi-skill repository

# Description

Complete 5-step development workflow

# SKILL.md


name: workflow
description: Complete 5-step development workflow
user-invocable: true


Development Workflow

A structured approach to software development that emphasizes understanding, minimal implementation, testing, documentation, and clean commits.


Overview

Step 1: Focus Problem    β†’ Understand before coding
Step 2: Prevent Overdev  β†’ Only build what's needed (YAGNI)
Step 3: Test First       β†’ Red-Green-Refactor
Step 4: Document         β†’ Keep it clear and current
Step 5: Smart Commit     β†’ Conventional Commits

Step 1: Focus Problem (/focus-problem)

Goal: Thoroughly understand the problem before writing code.

Checklist

  • [ ] What is the user need? (Who / What / Why)
  • [ ] What defines success? (How to verify completion?)
  • [ ] What are the boundaries? (What NOT to do?)
  • [ ] What files/modules are affected?
  • [ ] Is there existing similar functionality?

Use Explore Agent

Task(subagent_type="Explore", model="haiku", prompt="""
Explore the codebase for: [feature name] (thoroughness: medium)
Find related files, similar implementations, and test patterns.
""")

Step 2: Prevent Overdev

Goal: Ensure minimal viable implementation (YAGNI principle).

Red Flags

"We might need this later..." β†’ Don't build it now
"Just in case..." β†’ YAGNI
"Let's make it generic..." β†’ Solve current problem only
"We should create a framework..." β†’ Write concrete implementation

Checklist

  • [ ] Is there immediate need for this?
  • [ ] Is this over-abstracted?
  • [ ] Can this be simpler?
  • [ ] Are we adding unnecessary dependencies?

Step 3: Test First (/test-first)

Goal: Strict TDD (Red-Green-Refactor).

Red Phase (Write Failing Test)

  • [ ] Write a test for expected behavior
  • [ ] Run test, confirm it fails
  • [ ] Failure message clearly indicates the issue

Green Phase (Minimal Implementation)

  • [ ] Write minimum code to pass test
  • [ ] Don't optimize yet
  • [ ] Run test, confirm it passes

Refactor Phase

  • [ ] Clean up code (keep tests passing)
  • [ ] Remove duplication
  • [ ] Improve naming
  • [ ] Simplify logic

Step 4: Document

Goal: Ensure code is understandable.

Checklist

  • [ ] README describes purpose and usage
  • [ ] Public APIs have docstrings
  • [ ] Complex logic has comments explaining "why"
  • [ ] No obvious-comment clutter

Step 5: Smart Commit (/smart-commit)

Goal: Clean version history with Conventional Commits.

Format

<type>(<scope>): <description>

Types

  • feat - New feature
  • fix - Bug fix
  • docs - Documentation
  • test - Tests
  • refactor - Code restructure

Quick Start

# Run full workflow
/workflow

# Or individual steps
/focus-problem "implement user login"
/test-first
/smart-commit

Skill Purpose
/focus-problem Step 1: Problem analysis
/test-first Step 3: TDD cycle
/smart-commit Step 5: Create commit
/plan Break down complex tasks

# Supported AI Coding Agents

This skill is compatible with the SKILL.md standard and works with all major AI coding agents:

Learn more about the SKILL.md standard and how to use these skills with your preferred AI coding agent.