v2.0.0 — Language-Agnostic Skills, Quality Gate, 45% Token Reduction

Highlights

Major rewrite. All 18 workflow skills are now language-agnostic, compressed, and integrated with a quality gate system.

Language-Agnostic Skills

Skills detect project.language and project.type from .claude/workflows.yml and adapt automatically. No hardcoded Kotlin/Android patterns.

Quality Gate

• During implementation: .claude/rules/<language>.md loaded — all DO/DON'T directives followed
• Before PR creation: .claude/reviews/general-checklist.md + language-specific checklist — High/Critical items self-checked

45% Token Reduction

Skills compressed from ~4,600 to ~2,500 total lines. CLAUDE.md injection: 35 → 7 lines.

Shared Orchestration Rules

Single _orchestration/RULES.md replaces duplicated logic in start/resume. Covers phase outputs, state tracking, chaining, pausing, and error recovery. Includes 27-row Details Guide for phase content.

Correct Slash Commands

All commands use Claude Code auto-discovery format: /new-feature, /hotfix, /brainstorm (not /workflow:new-feature).

---

Breaking Changes

• install.sh and upgrade.sh removed — use npx claude-dev-workflows init / upgrade
• 4 unused spec templates removed
• specs config replaced with quality config
• learn skill uses markdown instead of JSON
• Commands changed from /workflow:<name> to /<name>

What's New

• _orchestration/RULES.md — centralized orchestration rules
• general-checklist.md always installed
• tests/validate-workflows.js — 359 end-to-end tests
• Workflow chaining implemented via Rule 6

Stats

34 files changed, +2,051 / -5,488 (net -3,437 lines)
Skills: 4,600 → 2,500 lines (45% reduction)
CLAUDE.md injection: 35 → 7 lines (80% reduction)
Tests: 359/359 passing (Android + iOS)

Install / Upgrade

npx claude-dev-workflows@2.0.0 init --type android
npx claude-dev-workflows@2.0.0 upgrade --type swift --team ios

Supported Languages

Rules + checklists for: Kotlin, Compose, TypeScript, React, Python, Swift, Go. General checklist applies to all.

v1.4.0

What's New

/start — Single Entry Point

New /start skill shows all available workflows in a categorized menu. Checks for active/paused workflows first, then lets you pick what to do.

/resume — Workflow Recovery

New /resume skill reads .workflows/current-state.md, shows your progress, and continues from where you left off. Handles paused workflows, stale state, and edge cases.

State Tracking in Every Workflow

All 10 phased skills now include a Workflow State Protocol that:

• Creates .workflows/current-state.md at workflow start
• Updates it at every phase transition (phase, status, timestamp, notes)
• Tracks completed steps as checkboxes
• Saves specs/decisions to .workflows/specs/
• Archives to .workflows/history/ on completion

Brainstorm Skip Fix

Skills now read workflows.<skill>.require_brainstorm from .claude/workflows.yml. Previously they only checked the --skip-brainstorm CLI flag, causing brainstorming to always be skipped.

Install / Upgrade

npx claude-dev-workflows@1.4.0 init --type android --team android
npx claude-dev-workflows@latest upgrade --type android --team android

Full Changelog: v1.3.1...v1.4.0

v1.3.1

What's New

Session Recovery on Context Clear

The CLAUDE.md injection now includes Session Start instructions that tell Claude to check for active workflows at every session start. When you clear context mid-workflow, Claude automatically detects and offers to resume.

How It Works

1. You're in the middle of /new-feature → Claude tracks state in .workflows/current-state.md
2. You clear context (new session)
3. Claude reads CLAUDE.md → checks state file → reports: "Active workflow at IMPLEMENT phase. Resume?"

Install / Upgrade

# Fresh install
npx claude-dev-workflows@1.3.1 init --type android --team android

# Upgrade existing
npx claude-dev-workflows@latest upgrade --type android --team android

Full Changelog: v1.3.0...v1.3.1

v1.3.0

What's New

Flat Skills — Claude Code Auto-Discovery

Skills now install directly into .claude/skills/<name>/SKILL.md. Claude Code auto-discovers them as slash commands — no registration or .claude/commands/ duplication needed.

npx claude-dev-workflows@1.3.0 init --type android --team android

Safe Upgrades with Manifest

A .core-skills manifest tracks which skills came from core. Upgrades only replace those, preserving your custom and team skills.

npx claude-dev-workflows@latest upgrade --type android --team android

Breaking Changes from v1.2.0

• Skills no longer install into .claude/skills/_core/ or .claude/skills/_team/ — everything is flat in .claude/skills/
• .claude/commands/workflow/ is no longer created — Claude Code discovers skills directly
• Re-run init to migrate existing installations

Available Teams

4 built-in teams: android, ios, frontend, backend

Full Changelog: v1.1.1...v1.3.0

v1.1.1

What's New

npm Package Distribution

Install with a single command — no git clone needed:

npx claude-dev-workflows init --type android --team android

Team-Specific Skill Injection

• --team flag for install/upgrade
• Three-tier skill resolution: project > team > core
• 4 built-in teams: android, ios, frontend, backend
• Teams can inject custom skills, rules, and review checklists

7 Critical Bug Fixes

• Fixed review checklist filename mismatch
• Fixed missing compose.md/react.md in install rule mappings
• Fixed config schema mismatch in new-project skill
• Fixed wrong config key references in new-feature skill
• Fixed hotfix skill grep using wrong key name
• Fixed chain config path mismatch
• Fixed phase naming inconsistency (VERIFY-COMPAT)

Other

• Removed examples/ directory (superseded by teams/)
• Updated README with team setup guide and npm installation

Full Changelog: v1.0.0...v1.1.1