feat: Add project-agnostic release automation workflow

[dean0x]

Summary

Introduces /release command and release sub-agent for automated, safe, and professional release management across any programming language or ecosystem.

Key Features

Universal Project Detection

• Auto-detects Node.js, Rust, Python, Go, Ruby, PHP, Java (Maven/Gradle), Swift projects
• Falls back to generic VERSION file + git tags for unknown projects
• Adapts build, test, and publish commands to detected ecosystem

Intelligent Version Management

• Analyzes commits since last release using conventional commit patterns
• Suggests patch/minor/major bump based on detected changes
• Supports custom version strings (e.g., 2.0.0-beta.1)
• Updates version files appropriate to project type

Auto-Generated Changelogs

• Extracts changes from git commit history
• Categorizes as Added/Fixed/Changed based on commit type
• Prepends to existing CHANGELOG.md or creates new one
• Maintains Keep a Changelog format

Built-In Safety Checks

• ✅ Verifies clean working directory before starting
• ✅ Runs build command (if configured)
• ✅ Runs tests before allowing release
• ✅ Provides rollback instructions if anything fails
• ✅ Multi-step user confirmations before permanent actions

Multi-Step Workflow

1. User runs /release and specifies bump type
2. Agent detects project type and current version
3. Analyzes commits since last release
4. Generates changelog entry
5. Updates version files
6. Runs build and tests
7. STOP - Shows preview and waits for confirmation
8. Commits version bump
9. Pushes to remote
10. STOP - Asks before publishing to public registry
11. Publishes package
12. Creates git tag
13. Creates GitHub/GitLab release
14. Shows final summary with links

Supported Ecosystems

Ecosystem	Version File	Build	Test	Publish
Node.js	package.json	npm run build	npm test	npm publish
Rust	Cargo.toml	cargo build --release	cargo test	cargo publish
Python	pyproject.toml/setup.py	python -m build	pytest	twine upload
Go	git tags	go build	go test	git tags only
Ruby	*.gemspec	gem build	rake test	gem push
PHP	composer.json	-	phpunit	composer publish
Java/Maven	pom.xml	mvn package	mvn test	mvn deploy
Java/Gradle	build.gradle	gradle build	gradle test	gradle publish
Swift	git tags	swift build	swift test	git tags only
Generic	VERSION file	-	-	manual

Platform Integration

• Creates GitHub releases via gh CLI (if available)
• Creates GitLab releases via glab CLI (if available)
• Includes changelog in release notes
• Links to commits, tags, and package registry

Documentation Changes

• Added /release command to commands table
• Added release sub-agent to sub-agents table
• Created "Creating a Release" workflow section
• Added to integration examples

Files Changed

• src/claude/agents/devflow/release.md - New sub-agent (26KB, comprehensive)
• src/claude/commands/devflow/release.md - New command (7KB, orchestration)
• README.md - Documentation updates

Testing

• ✅ Built successfully with npm run build
• ✅ Installed locally with node dist/cli.js init
• ✅ Verified files installed correctly
• ✅ Verified file contents and frontmatter

Next Steps

After merging:

• Test release workflow on a sample project
• Consider dogfooding by using /release for next DevFlow release
• Gather feedback on supported ecosystems
• Add more project types if needed (Elixir, Clojure, etc.)

Notes

This is a workflow agent (like research and commit) that coordinates a complex multi-step process. The agent is designed to be extremely cautious with multiple confirmation points before any permanent/public actions.

🤖 Generated with Claude Code