Package Exports

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (devflow-kit) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

DevFlow - Agentic Development Toolkit

A comprehensive collection of Claude Code commands and configurations designed to enhance developer workflows when working with AI coding assistants.

Installation

# Run with npx (recommended - no global install needed)
npx devflow-kit init

That's it! DevFlow is now installed and ready to use in Claude Code.

What's Included

📊 Slash Commands

Command	Purpose	When to Use
`/catch-up`	Smart summaries for starting new sessions with status validation	Starting a session
`/research [topic]`	Comprehensive pre-implementation research and planning	Before implementing features
`/devlog`	Development log for comprehensive session documentation	Ending a session
`/plan-next-steps`	Extract actionable next steps from current discussion	After planning discussion
`/debug [issue]`	Systematic debugging with issue-specific investigation	When troubleshooting
`/pre-commit`	Review uncommitted changes using specialized sub-agents	Before committing
`/commit`	Intelligent atomic commit creation with safety checks	When ready to commit
`/pre-pr`	Comprehensive branch review for PR readiness	Before creating PR
`/release`	Automated release workflow with version management and publishing	Creating a new release

🤖 Sub-Agents

Sub-Agent	Specialty	Purpose
`audit-security`	Security Analysis	Expert vulnerability detection and security code review
`audit-performance`	Performance	Optimization and bottleneck detection
`audit-architecture`	Architecture	Design pattern analysis and code structure review
`audit-tests`	Testing	Test quality, coverage, and effectiveness analysis (surgical execution)
`audit-complexity`	Complexity	Code complexity and maintainability assessment
`audit-dependencies`	Dependencies	Dependency management and security analysis
`audit-database`	Database	Database design and optimization review
`audit-documentation`	Documentation	Docs-code alignment, API accuracy, comment quality
`catch-up`	Context Restoration	Project status and context restoration with validation
`commit`	Git Operations	Intelligent commit creation with safety checks
`research`	Implementation Planning	Pre-implementation research, approach analysis, and planning
`release`	Release Automation	Project-agnostic release workflow with version management

How Sub-Agents Work:

Specialized AI assistants with deep expertise in specific domains
Separate context windows for focused analysis
Can be invoked explicitly or automatically by orchestrator commands
Restricted tool access appropriate to their domain

Invoking Sub-Agents:

# Explicit invocation
"Use the audit-security sub-agent to analyze this authentication code"

# Automatic delegation (Claude Code decides which sub-agent to use)
"Review this code for security issues"

📊 Smart Statusline

Real-time project context display showing:

Current model and session duration
Git branch and uncommitted changes indicator
Session cost tracking
Project context
Zero configuration - works immediately after installation

🔒 Security & Token Optimization

DevFlow automatically creates a comprehensive .claudeignore file at your git repository root to:

Protect Sensitive Data:

Environment files (.env, .env.*, .envrc)
Credentials & keys (*.key, *.pem, SSH keys)
Cloud configs (.aws/, .gcp/, .azure/)
Package tokens (.npmrc, .pypirc)
Database files (*.sql, *.db)

Optimize Token Usage:

Dependencies (node_modules/, vendor/, venv/)
Build artifacts (dist/, build/, .next/)
IDE files (.vscode/, .idea/)
Lock files (package-lock.json, yarn.lock)
Media and binaries

Covers patterns for all major languages and operating systems.

Development Workflow

Starting a Session

/catch-up - Review what was done previously
Check statusline for current model, git state, duration
Review recommended next actions

During Development

/research [topic] - Research implementation approaches before coding
/pre-commit - Review changes before committing
/commit - Create intelligent atomic commits
Invoke audit sub-agents as needed

Ending a Session

/devlog - Document decisions and state
/pre-pr - Review branch before creating PR
/commit - Final commits with validation

Creating a Release

/pre-pr - Comprehensive branch review
/release - Automated release workflow
- Detects project type (Node.js, Rust, Python, Go, etc.)
- Analyzes commits and suggests version bump
- Generates changelog from git history
- Builds and tests before publishing
- Creates git tags and platform releases
Verify package in registry

When Things Go Wrong

Check git log and recent commits
/debug [issue description] - Structured debugging
Revert changes using git
Document lessons learned

CLI Commands

Command	Purpose	Options
`devflow init`	Initialize DevFlow for Claude Code	`--skip-docs` - Skip creating `.docs/` structure
`devflow uninstall`	Remove DevFlow from Claude Code	`--keep-docs` - Keep `.docs/` directory

What devflow init does:

Installs commands to ~/.claude/commands/devflow/
Installs sub-agents to ~/.claude/agents/devflow/
Installs scripts to ~/.devflow/scripts/
Updates ~/.claude/settings.json (statusline and model)
Creates .claudeignore at git repository root
Creates .docs/ structure for project documentation

First Run:

devflow init
/devlog      # Document your current project state
/catch-up    # Get oriented with the project

Advanced Usage

Custom Audit Rules

# Extend sub-agents for project-specific patterns
echo "Check for exposed API keys in config files" >> ~/.claude/agents/devflow/audit-security.md

Team Usage

# Share session documentation with team
/devlog
git add .docs/status/
git commit -m "Session status: completed user auth feature"

Integration Examples

/research "add JWT authentication"  # Research before implementing
/pre-commit    # Review uncommitted changes
/commit        # Create atomic commits
/pre-pr        # Branch review before PR
/release       # Automated release workflow
/debug "TypeError in auth module"  # Debug specific issue

Philosophy

Modern development increasingly involves AI agents that can read, write, and modify code autonomously. DevFlow provides:

Trust but Verify - Tools to catch AI agent mistakes
Context Preservation - Memory across long-term projects
Quality Gates - Automated checks for AI changes
Developer Empowerment - Enhance human judgment, not replace it

Building from Source

# Clone and build
git clone https://github.com/dean0x/devflow.git
cd devflow
npm install
npm run build

# Test locally
node dist/cli.js init

# Watch mode for development
npm run dev

Project Structure:

src/
├── cli/                   # CLI source code (TypeScript)
│   ├── commands/           # init.ts, uninstall.ts
│   └── cli.ts             # CLI entry point
└── claude/                # Claude Code configuration
    ├── agents/devflow/     # Sub-agent definitions (.md)
    ├── commands/devflow/   # Slash command definitions (.md)
    ├── scripts/            # statusline.sh
    └── settings.json       # Claude Code settings

Support

Check installed command documentation
Review .docs/status/ for recent sessions
Use /debug [issue] for systematic troubleshooting
Report issues at https://github.com/dean0x/devflow/issues

License

MIT