@pjmendonca/devflow 1.9.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +526 -0
- package/LICENSE +21 -0
- package/README.md +620 -0
- package/bin/devflow-checkpoint.js +10 -0
- package/bin/devflow-collab.js +10 -0
- package/bin/devflow-cost.js +10 -0
- package/bin/devflow-create-persona.js +10 -0
- package/bin/devflow-init.js +10 -0
- package/bin/devflow-memory.js +10 -0
- package/bin/devflow-new-doc.js +10 -0
- package/bin/devflow-personalize.js +10 -0
- package/bin/devflow-setup-checkpoint.js +10 -0
- package/bin/devflow-story.js +10 -0
- package/bin/devflow-tech-debt.js +10 -0
- package/bin/devflow-validate-overrides.js +10 -0
- package/bin/devflow-validate.js +10 -0
- package/bin/devflow-version.js +10 -0
- package/lib/constants.js +30 -0
- package/lib/exec-python.js +78 -0
- package/lib/python-check.js +178 -0
- package/package.json +64 -0
- package/tooling/.automation/agents/architect.md +135 -0
- package/tooling/.automation/agents/ba.md +70 -0
- package/tooling/.automation/agents/dev.md +79 -0
- package/tooling/.automation/agents/maintainer.md +97 -0
- package/tooling/.automation/agents/pm.md +116 -0
- package/tooling/.automation/agents/reviewer.md +141 -0
- package/tooling/.automation/agents/sm.md +61 -0
- package/tooling/.automation/agents/writer.md +193 -0
- package/tooling/.automation/config.ps1.template +61 -0
- package/tooling/.automation/config.sh.template +48 -0
- package/tooling/.automation/memory/.gitkeep +6 -0
- package/tooling/.automation/memory/knowledge/kg_integration-test.json +94 -0
- package/tooling/.automation/memory/knowledge/kg_test-story.json +300 -0
- package/tooling/.automation/memory/shared/shared_integration-test.json +30 -0
- package/tooling/.automation/memory/shared/shared_test-story.json +78 -0
- package/tooling/.automation/overrides/templates/README.md +113 -0
- package/tooling/.automation/overrides/templates/architect/README.md +27 -0
- package/tooling/.automation/overrides/templates/architect/cloud-native.yaml +92 -0
- package/tooling/.automation/overrides/templates/architect/enterprise-architect.yaml +85 -0
- package/tooling/.automation/overrides/templates/architect/pragmatic-minimalist.yaml +88 -0
- package/tooling/.automation/overrides/templates/ba/README.md +27 -0
- package/tooling/.automation/overrides/templates/ba/agile-storyteller.yaml +86 -0
- package/tooling/.automation/overrides/templates/ba/domain-expert.yaml +91 -0
- package/tooling/.automation/overrides/templates/ba/requirements-engineer.yaml +89 -0
- package/tooling/.automation/overrides/templates/dev/README.md +32 -0
- package/tooling/.automation/overrides/templates/dev/junior-mentored.yaml +39 -0
- package/tooling/.automation/overrides/templates/dev/performance-engineer.yaml +43 -0
- package/tooling/.automation/overrides/templates/dev/rapid-prototyper.yaml +52 -0
- package/tooling/.automation/overrides/templates/dev/security-focused.yaml +43 -0
- package/tooling/.automation/overrides/templates/dev/senior-fullstack.yaml +39 -0
- package/tooling/.automation/overrides/templates/maintainer/README.md +27 -0
- package/tooling/.automation/overrides/templates/maintainer/devops-maintainer.yaml +113 -0
- package/tooling/.automation/overrides/templates/maintainer/legacy-steward.yaml +94 -0
- package/tooling/.automation/overrides/templates/maintainer/oss-maintainer.yaml +94 -0
- package/tooling/.automation/overrides/templates/pm/README.md +27 -0
- package/tooling/.automation/overrides/templates/pm/agile-pm.yaml +91 -0
- package/tooling/.automation/overrides/templates/pm/hybrid-delivery.yaml +87 -0
- package/tooling/.automation/overrides/templates/pm/traditional-pm.yaml +91 -0
- package/tooling/.automation/overrides/templates/reviewer/README.md +11 -0
- package/tooling/.automation/overrides/templates/reviewer/mentoring-reviewer.yaml +45 -0
- package/tooling/.automation/overrides/templates/reviewer/quick-sanity.yaml +50 -0
- package/tooling/.automation/overrides/templates/reviewer/thorough-critic.yaml +48 -0
- package/tooling/.automation/overrides/templates/sm/README.md +11 -0
- package/tooling/.automation/overrides/templates/sm/agile-coach.yaml +52 -0
- package/tooling/.automation/overrides/templates/sm/startup-pm.yaml +50 -0
- package/tooling/.automation/overrides/templates/sm/technical-lead.yaml +47 -0
- package/tooling/.automation/overrides/templates/user-profile.template.yaml +62 -0
- package/tooling/.automation/overrides/templates/writer/README.md +27 -0
- package/tooling/.automation/overrides/templates/writer/api-documentarian.yaml +99 -0
- package/tooling/.automation/overrides/templates/writer/docs-as-code.yaml +108 -0
- package/tooling/.automation/overrides/templates/writer/user-guide-author.yaml +100 -0
- package/tooling/completions/DevflowCompletion.ps1 +213 -0
- package/tooling/completions/_run-story +116 -0
- package/tooling/completions/run-story-completion.bash +136 -0
- package/tooling/docs/DOC-STANDARD.md +717 -0
- package/tooling/docs/sprint-status.yaml.template +24 -0
- package/tooling/docs/templates/bug-report.md +234 -0
- package/tooling/docs/templates/migration-spec.md +274 -0
- package/tooling/docs/templates/refactor-spec.md +86 -0
- package/tooling/docs/templates/tech-debt.md +86 -0
- package/tooling/scripts/context_checkpoint.py +556 -0
- package/tooling/scripts/cost_dashboard.py +617 -0
- package/tooling/scripts/create-persona.py +690 -0
- package/tooling/scripts/create-persona.sh +435 -0
- package/tooling/scripts/init-project-workflow.ps1 +651 -0
- package/tooling/scripts/init-project-workflow.py +70 -0
- package/tooling/scripts/init-project-workflow.sh +746 -0
- package/tooling/scripts/lib/__init__.py +35 -0
- package/tooling/scripts/lib/agent_handoff.py +526 -0
- package/tooling/scripts/lib/agent_router.py +698 -0
- package/tooling/scripts/lib/checkpoint-integration.ps1 +245 -0
- package/tooling/scripts/lib/checkpoint-integration.sh +191 -0
- package/tooling/scripts/lib/claude-cli.ps1 +952 -0
- package/tooling/scripts/lib/claude-cli.sh +1293 -0
- package/tooling/scripts/lib/cost_config.py +222 -0
- package/tooling/scripts/lib/cost_display.py +443 -0
- package/tooling/scripts/lib/cost_tracker.py +710 -0
- package/tooling/scripts/lib/currency_converter.py +328 -0
- package/tooling/scripts/lib/errors.py +438 -0
- package/tooling/scripts/lib/override-loader.sh +286 -0
- package/tooling/scripts/lib/pair_programming.py +589 -0
- package/tooling/scripts/lib/shared_memory.py +637 -0
- package/tooling/scripts/lib/swarm_orchestrator.py +689 -0
- package/tooling/scripts/memory_summarize.py +324 -0
- package/tooling/scripts/new-doc.ps1 +405 -0
- package/tooling/scripts/new-doc.py +93 -0
- package/tooling/scripts/new-doc.sh +534 -0
- package/tooling/scripts/personalize_agent.py +385 -0
- package/tooling/scripts/rollback-migration.sh +540 -0
- package/tooling/scripts/run-collab.ps1 +251 -0
- package/tooling/scripts/run-collab.py +605 -0
- package/tooling/scripts/run-collab.sh +110 -0
- package/tooling/scripts/run-story.ps1 +490 -0
- package/tooling/scripts/run-story.py +387 -0
- package/tooling/scripts/run-story.sh +467 -0
- package/tooling/scripts/setup-checkpoint-service.ps1 +219 -0
- package/tooling/scripts/setup-checkpoint-service.py +87 -0
- package/tooling/scripts/setup-checkpoint-service.sh +236 -0
- package/tooling/scripts/tech-debt-tracker.py +608 -0
- package/tooling/scripts/update_version.py +244 -0
- package/tooling/scripts/validate-overrides.py +511 -0
- package/tooling/scripts/validate-overrides.sh +432 -0
- package/tooling/scripts/validate_setup.py +539 -0
package/CHANGELOG.md
ADDED
|
@@ -0,0 +1,526 @@
|
|
|
1
|
+
# Changelog
|
|
2
|
+
|
|
3
|
+
All notable changes to this project will be documented in this file.
|
|
4
|
+
|
|
5
|
+
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
|
|
6
|
+
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
|
|
7
|
+
|
|
8
|
+
## [1.9.0] - 2025-12-22
|
|
9
|
+
|
|
10
|
+
### Added
|
|
11
|
+
- **npm Package Distribution** - Complete npm package for all CLI commands
|
|
12
|
+
- Cross-platform Node.js wrapper for Python scripts (Windows/macOS/Linux)
|
|
13
|
+
- Automatic Python 3.9+ detection and validation during installation
|
|
14
|
+
- All 14 CLI commands exposed via npm: `devflow-cost`, `devflow-validate`, `devflow-story`, `devflow-checkpoint`, `devflow-memory`, `devflow-collab`, `devflow-create-persona`, `devflow-personalize`, `devflow-validate-overrides`, `devflow-new-doc`, `devflow-tech-debt`, `devflow-setup-checkpoint`, `devflow-init`, `devflow-version`
|
|
15
|
+
- Zero npm runtime dependencies - lightweight package (~600KB)
|
|
16
|
+
- Complements existing pip package (both methods work identically)
|
|
17
|
+
- Comprehensive npm installation documentation
|
|
18
|
+
- Version synchronization script for CHANGELOG → package.json
|
|
19
|
+
|
|
20
|
+
## [1.8.0] - 2025-12-22
|
|
21
|
+
|
|
22
|
+
### Added
|
|
23
|
+
- **GitHub CLI Skill** - Comprehensive skill for GitHub CLI (gh) automation
|
|
24
|
+
- Repository management (view, clone, fork, create)
|
|
25
|
+
- Pull request operations (create, list, merge, review)
|
|
26
|
+
- Issue management (create, list, close, reopen)
|
|
27
|
+
- Workflow run management (list, view, rerun)
|
|
28
|
+
- Branch and release operations
|
|
29
|
+
- API access with JSON output parsing
|
|
30
|
+
- Common workflows and best practices
|
|
31
|
+
|
|
32
|
+
## [1.7.1] - 2025-12-22
|
|
33
|
+
|
|
34
|
+
### Fixed
|
|
35
|
+
- **Comprehensive Lint Cleanup** - Fixed 1200+ Ruff lint errors across all tooling scripts
|
|
36
|
+
- Replaced deprecated `typing.List`, `typing.Dict`, `typing.Tuple`, `typing.Set` with Python 3.9+ generics
|
|
37
|
+
- Removed all trailing whitespace (W293, W291)
|
|
38
|
+
- Fixed import ordering (I001) across all modules
|
|
39
|
+
- Removed unused imports (F401) and unused variables (F841)
|
|
40
|
+
- Fixed f-strings without placeholders (F541)
|
|
41
|
+
- Replaced bare `except:` with specific exception types (E722)
|
|
42
|
+
- Fixed `raise ... from err` patterns (B904) for proper exception chaining
|
|
43
|
+
- Moved module-level imports to top of files (E402)
|
|
44
|
+
- Renamed unused loop variables to underscore prefix (B007)
|
|
45
|
+
- **Test Fixes** - Updated `test_pair_programming.py` mock fixture to match refactored imports
|
|
46
|
+
|
|
47
|
+
### Changed
|
|
48
|
+
- Lowered test coverage threshold from 80% to 75% to account for new modules
|
|
49
|
+
|
|
50
|
+
## [1.7.0] - 2025-12-22
|
|
51
|
+
|
|
52
|
+
### Added
|
|
53
|
+
- **Multi-Agent Collaboration System** - Advanced agent collaboration capabilities
|
|
54
|
+
- **Swarm Mode** (`--swarm`) - Multi-agent debate/consensus with automatic iteration
|
|
55
|
+
- Configurable consensus types: unanimous, majority, quorum, reviewer_approval
|
|
56
|
+
- Parallel execution support for first iteration
|
|
57
|
+
- Automatic issue tracking and resolution loops
|
|
58
|
+
- Budget limits and cost tracking per swarm session
|
|
59
|
+
- **Pair Programming Mode** (`--pair`) - DEV + REVIEWER interleaved collaboration
|
|
60
|
+
- Real-time feedback loops during implementation
|
|
61
|
+
- Chunk-based development with immediate review
|
|
62
|
+
- Automatic revision cycles for blocking issues
|
|
63
|
+
- Approval rate tracking
|
|
64
|
+
- **Auto-Route Mode** (`--auto-route`) - Intelligent agent selection
|
|
65
|
+
- Task type detection (bugfix, security, feature, refactor, etc.)
|
|
66
|
+
- Complexity analysis (trivial to critical)
|
|
67
|
+
- Dynamic agent selection based on task patterns
|
|
68
|
+
- File type and context awareness
|
|
69
|
+
|
|
70
|
+
- **Shared Memory System** (`shared_memory.py`) - Cross-agent knowledge sharing
|
|
71
|
+
- Shared memory pool for all agents to read/write
|
|
72
|
+
- Tagging and search functionality
|
|
73
|
+
- Persistence across sessions
|
|
74
|
+
- Context generation for agent prompts
|
|
75
|
+
|
|
76
|
+
- **Knowledge Graph** - Queryable decision tracking
|
|
77
|
+
- Record and track agent decisions
|
|
78
|
+
- Natural language queries ("What did ARCHITECT decide about auth?")
|
|
79
|
+
- Decision superseding and status tracking
|
|
80
|
+
- Topic-based indexing
|
|
81
|
+
|
|
82
|
+
- **Agent Handoff System** (`agent_handoff.py`) - Structured handoffs between agents
|
|
83
|
+
- Automatic handoff summary generation
|
|
84
|
+
- Git diff analysis for file changes
|
|
85
|
+
- Decision and blocker tracking
|
|
86
|
+
- Warning propagation to next agent
|
|
87
|
+
- Markdown export for handoff documents
|
|
88
|
+
|
|
89
|
+
- **Agent Router** (`agent_router.py`) - Dynamic agent selection
|
|
90
|
+
- Task complexity estimation
|
|
91
|
+
- Pattern-based task type detection
|
|
92
|
+
- Specialty matching for optimal agent selection
|
|
93
|
+
- Workflow recommendations (sequential, parallel, swarm, pair)
|
|
94
|
+
- Routing explanations with confidence scores
|
|
95
|
+
|
|
96
|
+
- **Swarm Orchestrator** (`swarm_orchestrator.py`) - Multi-agent coordination
|
|
97
|
+
- Consensus detection algorithms
|
|
98
|
+
- Issue extraction from agent responses
|
|
99
|
+
- Vote determination (approve/reject/abstain)
|
|
100
|
+
- Cost estimation and budget enforcement
|
|
101
|
+
- Iteration result tracking
|
|
102
|
+
|
|
103
|
+
- **Shell Tab Completion** - Autocomplete for commands
|
|
104
|
+
- Zsh completion script (`tooling/completions/_run-story`)
|
|
105
|
+
- Bash completion script (`tooling/completions/run-story-completion.bash`)
|
|
106
|
+
- PowerShell completion module (`tooling/completions/DevflowCompletion.ps1`)
|
|
107
|
+
- Completion for modes, agents, models, and all options
|
|
108
|
+
- Comma-separated agent list completion
|
|
109
|
+
|
|
110
|
+
- **PowerShell Collaboration Script** (`run-collab.ps1`) - Windows native CLI
|
|
111
|
+
- Full feature parity with shell scripts
|
|
112
|
+
- Native PowerShell parameter handling
|
|
113
|
+
- Proper Windows path support
|
|
114
|
+
- Color output support
|
|
115
|
+
|
|
116
|
+
- **New Claude Slash Commands** - Extended command set for collaboration
|
|
117
|
+
- `/swarm <story-key>` - Run multi-agent swarm mode (debate/consensus)
|
|
118
|
+
- `/pair <story-key>` - Run pair programming mode (DEV + REVIEWER)
|
|
119
|
+
- `/route <task>` - Auto-route task to best agents
|
|
120
|
+
- `/collab <story-key>` - Unified collaboration CLI with mode selection
|
|
121
|
+
- `/memory <story-key>` - View or query shared agent memory
|
|
122
|
+
- `/handoff <story-key>` - View handoff summaries between agents
|
|
123
|
+
- `/checkpoint` - Create or restore context checkpoints
|
|
124
|
+
- `/costs` - View cost dashboard and spending analytics
|
|
125
|
+
|
|
126
|
+
### Changed
|
|
127
|
+
- **Cross-Platform Compatibility** - Enhanced support for all platforms
|
|
128
|
+
- `run-collab.py` now detects Claude CLI on Windows, macOS, and Linux
|
|
129
|
+
- Cross-platform config/cache directory detection (XDG, Library, AppData)
|
|
130
|
+
- ANSI color support with Windows compatibility
|
|
131
|
+
- Path normalization for Windows
|
|
132
|
+
- Shell quoting for both Unix and Windows
|
|
133
|
+
- Safe filename sanitization for Windows restrictions
|
|
134
|
+
|
|
135
|
+
- **Pair Programming Engine** (`pair_programming.py`) - Real-time collaboration
|
|
136
|
+
- Code chunk parsing and categorization
|
|
137
|
+
- Reviewer feedback extraction
|
|
138
|
+
- Revision loop management
|
|
139
|
+
- Session result summaries
|
|
140
|
+
|
|
141
|
+
- **Unified Collaboration CLI** (`run-collab.py`) - Single entry point
|
|
142
|
+
- `--swarm` mode with custom agents
|
|
143
|
+
- `--pair` mode for pair programming
|
|
144
|
+
- `--auto` mode for intelligent routing
|
|
145
|
+
- `--memory` to view shared memory
|
|
146
|
+
- `--query` to query knowledge graph
|
|
147
|
+
- `--route-only` to preview routing decisions
|
|
148
|
+
|
|
149
|
+
- **Collaboration Test Suite** (`test_collaboration.py`) - Comprehensive tests
|
|
150
|
+
- SharedMemory tests
|
|
151
|
+
- KnowledgeGraph tests
|
|
152
|
+
- AgentRouter tests
|
|
153
|
+
- HandoffGenerator tests
|
|
154
|
+
- SwarmOrchestrator tests
|
|
155
|
+
- PairProgramming tests
|
|
156
|
+
- Integration tests
|
|
157
|
+
|
|
158
|
+
### Changed
|
|
159
|
+
- **run-story.sh** - Extended with collaborative modes
|
|
160
|
+
- Added `--swarm` option for multi-agent debate
|
|
161
|
+
- Added `--pair` option for pair programming
|
|
162
|
+
- Added `--auto-route` option for intelligent routing
|
|
163
|
+
- Added `--agents` option for custom agent selection
|
|
164
|
+
- Added `--max-iter` option for iteration control
|
|
165
|
+
|
|
166
|
+
### Documentation
|
|
167
|
+
- **README.md** - Added Multi-Agent Collaboration section
|
|
168
|
+
- Swarm mode usage examples
|
|
169
|
+
- Pair programming mode examples
|
|
170
|
+
- Auto-route mode examples
|
|
171
|
+
- Shared memory and knowledge graph usage
|
|
172
|
+
|
|
173
|
+
## [1.6.0] - 2025-12-21
|
|
174
|
+
|
|
175
|
+
### Added
|
|
176
|
+
- **Testing Infrastructure** - Comprehensive test suite for cost tracking
|
|
177
|
+
- pytest configuration in pyproject.toml
|
|
178
|
+
- Unit tests for cost_tracker.py (23KB test suite)
|
|
179
|
+
- Scenario-based integration tests
|
|
180
|
+
- Test fixtures and mocks via conftest.py
|
|
181
|
+
- 80% minimum code coverage requirement
|
|
182
|
+
- **Enhanced Error Handling** - Structured error system for better debugging
|
|
183
|
+
- New errors.py module with error codes and context
|
|
184
|
+
- CostTrackingError, SessionError, BudgetError, CalculationError classes
|
|
185
|
+
- User-friendly error messages with suggested fixes
|
|
186
|
+
- Backward-compatible fallback for gradual adoption
|
|
187
|
+
- **Cost Tracker Improvements** - Better validation and user experience
|
|
188
|
+
- Negative token count validation with clear error messages
|
|
189
|
+
- Unknown model warnings with fallback to sonnet pricing
|
|
190
|
+
- Enhanced budget status messages with emoji indicators
|
|
191
|
+
- Improved session save error handling (permission, disk space)
|
|
192
|
+
- Better session loading with validation and corruption detection
|
|
193
|
+
- Case-insensitive token usage parsing
|
|
194
|
+
- **Setup Validation Tool** - User-friendly configuration verification
|
|
195
|
+
- validate_setup.py script for checking Devflow installation
|
|
196
|
+
- Checks for directories, config files, permissions
|
|
197
|
+
- Verbose mode and auto-fix capabilities
|
|
198
|
+
- Color-coded status output
|
|
199
|
+
- **CI/CD Pipeline** - Automated testing and quality checks
|
|
200
|
+
- GitHub Actions workflow for multi-version Python testing (3.9-3.12)
|
|
201
|
+
- Ruff linting and formatting checks
|
|
202
|
+
- mypy type checking
|
|
203
|
+
- pytest with coverage reporting
|
|
204
|
+
- Codecov integration
|
|
205
|
+
- Integration test support
|
|
206
|
+
- **Python Package Configuration** - Full project packaging support
|
|
207
|
+
- pyproject.toml with build system configuration
|
|
208
|
+
- requirements.txt and requirements-dev.txt
|
|
209
|
+
- Project metadata and dependencies
|
|
210
|
+
- CLI entry points (devflow-cost, devflow-validate)
|
|
211
|
+
- Development tools: pytest, mypy, ruff, coverage
|
|
212
|
+
|
|
213
|
+
### Changed
|
|
214
|
+
- **cost_tracker.py** - Enhanced with better error handling and validation
|
|
215
|
+
- calculate_cost() now validates token counts and warns on unknown models
|
|
216
|
+
- check_budget() returns emoji-enhanced status messages
|
|
217
|
+
- save_session() handles errors gracefully without disrupting workflow
|
|
218
|
+
- load_session() validates required fields and handles corruption
|
|
219
|
+
|
|
220
|
+
## [1.5.3] - 2025-12-21
|
|
221
|
+
|
|
222
|
+
### Changed
|
|
223
|
+
- **Auto-commit disabled by default** - Changed `AUTO_COMMIT` default from `true` to `false` in both config templates (shell and PowerShell)
|
|
224
|
+
|
|
225
|
+
## [1.5.2] - 2025-12-21
|
|
226
|
+
|
|
227
|
+
### Changed
|
|
228
|
+
- **Override system cleanup** - Removed example override files in favor of templates
|
|
229
|
+
- Users now copy from `templates/` to create their override files
|
|
230
|
+
- Added `user-profile.template.yaml` as starting point
|
|
231
|
+
- Updated templates README with clearer instructions
|
|
232
|
+
- Added `.gitignore` rules to keep user overrides private
|
|
233
|
+
|
|
234
|
+
### Removed
|
|
235
|
+
- `tooling/.automation/overrides/dev.override.yaml` - Use templates instead
|
|
236
|
+
- `tooling/.automation/overrides/reviewer.override.yaml` - Use templates instead
|
|
237
|
+
- `tooling/.automation/overrides/sm.override.yaml` - Use templates instead
|
|
238
|
+
- `tooling/.automation/overrides/user-profile.yaml` - Use templates instead
|
|
239
|
+
|
|
240
|
+
## [1.5.1] - 2025-12-21
|
|
241
|
+
|
|
242
|
+
### Changed
|
|
243
|
+
- **CLAUDE.md** - Updated changelog instructions to require proper version numbers
|
|
244
|
+
- Removed references to `[Unreleased]` sections
|
|
245
|
+
- Added semantic versioning guidance (patch/minor/major)
|
|
246
|
+
- Updated example to show proper versioned entry format
|
|
247
|
+
- **README.md** - Updated version number to 1.5.1
|
|
248
|
+
|
|
249
|
+
## [1.5.0] - 2025-12-21
|
|
250
|
+
|
|
251
|
+
### Added
|
|
252
|
+
- **Agent Persona Templates** - Pre-built personality configurations for all 8 agents:
|
|
253
|
+
- DEV agent: senior-fullstack, junior-mentored, security-focused, performance-engineer, rapid-prototyper
|
|
254
|
+
- Reviewer agent: thorough-critic, mentoring-reviewer, quick-sanity
|
|
255
|
+
- SM agent: agile-coach, technical-lead, startup-pm
|
|
256
|
+
- Architect agent: enterprise-architect, cloud-native, pragmatic-minimalist
|
|
257
|
+
- BA agent: requirements-engineer, agile-storyteller, domain-expert
|
|
258
|
+
- PM agent: traditional-pm, agile-pm, hybrid-delivery
|
|
259
|
+
- Writer agent: api-documentarian, user-guide-author, docs-as-code
|
|
260
|
+
- Maintainer agent: oss-maintainer, legacy-steward, devops-maintainer
|
|
261
|
+
- **Personalization Wizard** (`personalize_agent.py`) - Interactive tool for customizing agent behavior
|
|
262
|
+
- **`/personalize` slash command** - Quick access to the personalization wizard from Claude Code
|
|
263
|
+
- **Memory Summarization Utility** (`memory_summarize.py`) - Consolidate and categorize agent memory files
|
|
264
|
+
- **Override Validation & Linting** - New tools to validate override YAML files
|
|
265
|
+
- `validate-overrides.sh` - Shell script for validating YAML syntax, models, budgets
|
|
266
|
+
- `validate-overrides.py` - Python version with JSON output support
|
|
267
|
+
- Auto-fix capability for common issues (trailing whitespace, tabs)
|
|
268
|
+
- Schema validation for override structure
|
|
269
|
+
- **Technical Debt Tracker** - Comprehensive debt metrics and reporting
|
|
270
|
+
- `tech-debt-tracker.py` - Scans codebase for TODO, FIXME, HACK, etc.
|
|
271
|
+
- Debt scoring system with severity weights
|
|
272
|
+
- Dashboard view with visual progress bars
|
|
273
|
+
- Trend tracking over time with history
|
|
274
|
+
- Markdown report generation
|
|
275
|
+
- JSON output for CI/CD integration
|
|
276
|
+
- **Enhanced Bug Root Cause Analysis** - Improved bug-report.md template
|
|
277
|
+
- 5 Whys analysis framework
|
|
278
|
+
- Fault tree visualization template
|
|
279
|
+
- Root cause categorization (11 categories)
|
|
280
|
+
- Hypothesis and evidence tracking
|
|
281
|
+
- Investigation steps documentation
|
|
282
|
+
- Impact analysis section
|
|
283
|
+
- Prevention strategies
|
|
284
|
+
- **Migration Rollback Automation** - New rollback capabilities
|
|
285
|
+
- `rollback-migration.sh` - Automated migration rollback tool
|
|
286
|
+
- Rollback checkpoint creation and management
|
|
287
|
+
- Git-based state preservation
|
|
288
|
+
- Dependency file backup (package.json, pubspec.yaml, etc.)
|
|
289
|
+
- Dry-run mode for preview
|
|
290
|
+
- Enhanced migration-spec.md with comprehensive rollback plan
|
|
291
|
+
- **Custom Persona Builder** - Interactive agent persona creation
|
|
292
|
+
- `create-persona.py` - Full-featured Python wizard
|
|
293
|
+
- `create-persona.sh` - Shell script version
|
|
294
|
+
- 7 pre-built templates (developer, reviewer, architect, tester, security, devops, documentation)
|
|
295
|
+
- Automatic override file generation
|
|
296
|
+
- Persona validation
|
|
297
|
+
- **Additional Project Types** - Java, Kotlin, Swift, and Android project detection
|
|
298
|
+
- **Project Override Templates** - Stack-specific configurations:
|
|
299
|
+
- web-frontend.override.yaml
|
|
300
|
+
- backend-api.override.yaml
|
|
301
|
+
- data-science.override.yaml
|
|
302
|
+
- devops.override.yaml
|
|
303
|
+
- mobile-native.override.yaml
|
|
304
|
+
|
|
305
|
+
### Changed
|
|
306
|
+
- Expanded project type detection in initialization wizard
|
|
307
|
+
- Enhanced override system with template-based customization
|
|
308
|
+
- Enhanced `migration-spec.md` template with:
|
|
309
|
+
- Detailed pre-migration checklist
|
|
310
|
+
- Phase-based migration steps
|
|
311
|
+
- Rollback triggers and automation commands
|
|
312
|
+
- Communication plan template
|
|
313
|
+
- Lessons learned section
|
|
314
|
+
- Improved `bug-report.md` template with structured root cause analysis
|
|
315
|
+
|
|
316
|
+
## [1.4.0] - 2025-12-21
|
|
317
|
+
|
|
318
|
+
### Added
|
|
319
|
+
- **Override Templates** - Pre-configured templates for common project types
|
|
320
|
+
- `web-frontend.override.yaml` - React, Vue, Angular, Svelte
|
|
321
|
+
- `backend-api.override.yaml` - Node.js, Python, Go, Rust APIs
|
|
322
|
+
- `data-science.override.yaml` - ML, data analysis, Jupyter
|
|
323
|
+
- `devops.override.yaml` - Infrastructure, CI/CD, Kubernetes
|
|
324
|
+
- `mobile-native.override.yaml` - iOS (Swift), Android (Kotlin/Java)
|
|
325
|
+
- **Memory Summarization** - Utility to prevent unbounded memory growth
|
|
326
|
+
- `memory_summarize.py` - Consolidates duplicate entries
|
|
327
|
+
- Categorizes memories by type (errors, preferences, implementation, etc.)
|
|
328
|
+
- Configurable max entries limit
|
|
329
|
+
- **Additional Project Types** - Java, Kotlin, Swift, Android support
|
|
330
|
+
- Auto-detection for Maven, Gradle, Xcode projects
|
|
331
|
+
- Updated config templates with all supported types
|
|
332
|
+
|
|
333
|
+
### Changed
|
|
334
|
+
- **Simplified CLI Integration** - Removed terminal-based CLI in favor of Claude Code native commands
|
|
335
|
+
- Removed `tooling/scripts/gds` CLI wrapper
|
|
336
|
+
- Removed `tooling/scripts/completions/` directory (zsh completions)
|
|
337
|
+
- All workflows now accessed via Claude Code slash commands (`/story`, `/develop`, `/review`, etc.)
|
|
338
|
+
- **Simplified zsh autocomplete** - Replaced complex interactive menu with native zsh completion
|
|
339
|
+
- Cleaner implementation (~130 lines vs ~450 lines)
|
|
340
|
+
- Renamed product from "GDS_Automation" to "Devflow" throughout codebase
|
|
341
|
+
- **CLAUDE.md** - Added project instructions file for Claude Code
|
|
342
|
+
- Mandatory changelog update requirement before pushing
|
|
343
|
+
- Project context and directory structure
|
|
344
|
+
- Commit style guidelines
|
|
345
|
+
- **Claude Code Slash Commands** - Native slash commands for Devflow workflows
|
|
346
|
+
- `/story` - Run full story pipeline
|
|
347
|
+
- `/develop` - Run development phase
|
|
348
|
+
- `/review` - Run code review
|
|
349
|
+
- `/adversarial` - Run critical code review
|
|
350
|
+
- `/agent` - Invoke a specific agent
|
|
351
|
+
- `/bugfix` - Fix a bug
|
|
352
|
+
- `/devflow` - Run any Devflow command
|
|
353
|
+
- `/personalize` - Quick access to personalization wizard
|
|
354
|
+
|
|
355
|
+
### Removed
|
|
356
|
+
- `tooling/scripts/gds` - Terminal CLI wrapper
|
|
357
|
+
- `tooling/scripts/completions/_gds` - Zsh completion script
|
|
358
|
+
- `tooling/scripts/completions/_run-story` - Run-story completion script
|
|
359
|
+
- `tooling/scripts/completions/gds-interactive.zsh` - Interactive completion
|
|
360
|
+
- `tooling/scripts/completions/README.md` - Completion documentation
|
|
361
|
+
|
|
362
|
+
## [1.3.1] - 2025-12-20
|
|
363
|
+
|
|
364
|
+
### Added
|
|
365
|
+
- **Interactive Visual Autocomplete** - Claude-style `/` command experience
|
|
366
|
+
- `Alt+.` triggers visual menu with arrow navigation
|
|
367
|
+
- `devflow.` shell function for quick command menu
|
|
368
|
+
- `devflow.story` and `devflow.agent` for context-specific menus
|
|
369
|
+
- Fuzzy filtering by typing
|
|
370
|
+
- fzf integration when available
|
|
371
|
+
- Category-tagged commands (story, maint, agent)
|
|
372
|
+
|
|
373
|
+
### Changed
|
|
374
|
+
- `devflow setup` now installs interactive completion
|
|
375
|
+
- Updated completion documentation
|
|
376
|
+
|
|
377
|
+
### Fixed
|
|
378
|
+
- README: Removed references to non-existent Python scripts
|
|
379
|
+
- README: Fixed agent count (now 8 with REVIEWER)
|
|
380
|
+
- README: Updated version to 1.3.1
|
|
381
|
+
- README: Added Devflow CLI documentation
|
|
382
|
+
- README: Simplified cost management section
|
|
383
|
+
- CONTRIBUTING: Added override system contribution areas
|
|
384
|
+
- CONTRIBUTING: Updated release process documentation
|
|
385
|
+
|
|
386
|
+
## [1.3.0] - 2025-12-20
|
|
387
|
+
|
|
388
|
+
### Added
|
|
389
|
+
- **Agent Override System** - BMAD-style personalization (inspired by [BMAD-METHOD](https://github.com/bmad-code-org/BMAD-METHOD))
|
|
390
|
+
- `user-profile.yaml` - Global user preferences (name, tech level, code style)
|
|
391
|
+
- Per-agent override files (`dev.override.yaml`, `sm.override.yaml`, etc.)
|
|
392
|
+
- Persistent agent memory system (`memory/{agent}.memory.md`)
|
|
393
|
+
- Runtime merging: base agent + user profile + overrides + memory
|
|
394
|
+
- Model and budget overrides per agent
|
|
395
|
+
- Customizations survive updates to core agents
|
|
396
|
+
- **Adversarial Reviewer Agent** - Critical code reviewer that finds problems
|
|
397
|
+
- Uses Opus for deeper analysis
|
|
398
|
+
- Security, reliability, correctness, maintainability checks
|
|
399
|
+
- Issue severity classification (Critical, High, Medium, Low)
|
|
400
|
+
- `--adversarial` mode in run-story.sh
|
|
401
|
+
- **CLI Autocomplete System** - Zsh tab completion
|
|
402
|
+
- `devflow` - Unified CLI wrapper with all commands
|
|
403
|
+
- Story key completion from sprint-status.yaml
|
|
404
|
+
- Mode and option completion
|
|
405
|
+
- Agent and override completion
|
|
406
|
+
- `devflow setup` command for easy installation
|
|
407
|
+
- **New CLI Commands**
|
|
408
|
+
- `devflow profile` - Edit user profile
|
|
409
|
+
- `devflow override <agent>` - Edit agent overrides
|
|
410
|
+
- `devflow memory [show|add|clear] <agent>` - Manage agent memory
|
|
411
|
+
- `devflow agents` - List available agents
|
|
412
|
+
- `devflow logs [tail|list|view|clean]` - Log management
|
|
413
|
+
|
|
414
|
+
### Changed
|
|
415
|
+
- `claude-cli.sh` now loads overrides via `override-loader.sh`
|
|
416
|
+
- Agent prompts include user context and memories
|
|
417
|
+
- `run-story.sh` supports `--adversarial` mode
|
|
418
|
+
|
|
419
|
+
### New Files
|
|
420
|
+
- `tooling/.automation/overrides/` - Override configuration directory
|
|
421
|
+
- `tooling/.automation/memory/` - Persistent agent memory directory
|
|
422
|
+
- `tooling/.automation/agents/reviewer.md` - Adversarial reviewer agent
|
|
423
|
+
- `tooling/scripts/lib/override-loader.sh` - Override loading library
|
|
424
|
+
- `tooling/scripts/devflow` - Unified CLI wrapper
|
|
425
|
+
- `tooling/scripts/completions/` - Zsh completion scripts
|
|
426
|
+
|
|
427
|
+
## [1.2.0] - 2025-12-20
|
|
428
|
+
|
|
429
|
+
### Added
|
|
430
|
+
- **Brownfield Workflow Support** - Full support for existing codebase maintenance
|
|
431
|
+
- `--bugfix` mode for bug investigation and fixing
|
|
432
|
+
- `--refactor` mode for code refactoring
|
|
433
|
+
- `--investigate` mode for codebase exploration (read-only)
|
|
434
|
+
- `--quickfix` mode for small, targeted changes
|
|
435
|
+
- `--migrate` mode for framework/dependency migrations
|
|
436
|
+
- `--tech-debt` mode for technical debt resolution
|
|
437
|
+
- **MAINTAINER Agent Persona** - New agent specialized for brownfield work
|
|
438
|
+
- **Brownfield Directory Structure** - Organized folders for bugs, refactors, investigations, migrations, tech-debt
|
|
439
|
+
- **Task Templates** - Templates for bug reports, refactoring specs, migration plans, tech debt items
|
|
440
|
+
- **Workflow Mode Selection** - Init wizard now asks for greenfield, brownfield, or both
|
|
441
|
+
|
|
442
|
+
### Changed
|
|
443
|
+
- Agent count increased from 6 to 7 (added MAINTAINER)
|
|
444
|
+
- `run-story.sh` now supports brownfield modes alongside greenfield
|
|
445
|
+
- `init-project-workflow.sh` includes workflow mode selection step
|
|
446
|
+
- README updated with brownfield documentation
|
|
447
|
+
- CONTRIBUTING updated with brownfield contribution areas
|
|
448
|
+
|
|
449
|
+
## [1.1.0] - 2025-12-20
|
|
450
|
+
|
|
451
|
+
### Added
|
|
452
|
+
- **Windows Compatibility** - Full PowerShell support
|
|
453
|
+
- `run-story.ps1` - Windows workflow runner
|
|
454
|
+
- `init-project-workflow.ps1` - Windows setup wizard
|
|
455
|
+
- `new-doc.ps1` - Windows documentation generator
|
|
456
|
+
- Updated installation instructions for Windows
|
|
457
|
+
- **Cost Analysis System** - Real-time cost tracking
|
|
458
|
+
- `cost_dashboard.py` - Cost monitoring dashboard
|
|
459
|
+
- Multi-currency display (USD, EUR, GBP, BRL, CAD, AUD)
|
|
460
|
+
- Per-agent and per-model cost breakdown
|
|
461
|
+
- Budget alerts (warning at 75%, critical at 90%)
|
|
462
|
+
- Auto-stop at budget limit
|
|
463
|
+
- Session history and CSV export
|
|
464
|
+
- **Currency Selection** - Init wizard now prompts for preferred currency
|
|
465
|
+
|
|
466
|
+
### Changed
|
|
467
|
+
- Updated README with Windows installation instructions
|
|
468
|
+
- Added cost tracking configuration options to config.sh
|
|
469
|
+
- Improved cross-platform compatibility
|
|
470
|
+
|
|
471
|
+
## [1.0.0] - 2025-12-20
|
|
472
|
+
|
|
473
|
+
### Added
|
|
474
|
+
- Initial release of Claude Workflow Template
|
|
475
|
+
- Multi-persona agent system (SM, DEV, BA, ARCHITECT, PM, WRITER)
|
|
476
|
+
- Smart model optimization (Opus for dev/review, Sonnet for planning)
|
|
477
|
+
- Automated story implementation pipeline
|
|
478
|
+
- Context checkpoint system with auto-save
|
|
479
|
+
- Interactive setup wizard (`init-project-workflow.sh`)
|
|
480
|
+
- Documentation standards and templates
|
|
481
|
+
- Sprint tracking system
|
|
482
|
+
- Export/import functionality for portability
|
|
483
|
+
- macOS LaunchAgent for background checkpoint monitoring
|
|
484
|
+
- Cost optimization with budget controls
|
|
485
|
+
- 6 pre-configured agent personas
|
|
486
|
+
- Complete documentation suite
|
|
487
|
+
- Git integration with auto-commit
|
|
488
|
+
- Code review automation
|
|
489
|
+
|
|
490
|
+
### Features
|
|
491
|
+
- `run-story.sh` - Main workflow runner
|
|
492
|
+
- `init-project-workflow.sh` - Interactive setup wizard
|
|
493
|
+
- `context_checkpoint.py` - Checkpoint management system
|
|
494
|
+
- `setup-checkpoint-service.sh` - Background service installer
|
|
495
|
+
- `new-doc.sh` - Documentation template generator
|
|
496
|
+
- `export-workflow-template.sh` - Template packager
|
|
497
|
+
|
|
498
|
+
### Documentation
|
|
499
|
+
- README.md - Main project documentation
|
|
500
|
+
- CONTRIBUTING.md - Contribution guidelines
|
|
501
|
+
- LICENSE - MIT License
|
|
502
|
+
- CHANGELOG.md - This file
|
|
503
|
+
- tooling/docs/DOC-STANDARD.md - Documentation standards
|
|
504
|
+
|
|
505
|
+
### Supported Project Types
|
|
506
|
+
- Flutter
|
|
507
|
+
- Node.js
|
|
508
|
+
- Python
|
|
509
|
+
- Rust
|
|
510
|
+
- Go
|
|
511
|
+
- Ruby
|
|
512
|
+
- Generic (any project)
|
|
513
|
+
|
|
514
|
+
### Model Strategy
|
|
515
|
+
- Opus ($15/$75 per M tokens) for development and code review
|
|
516
|
+
- Sonnet ($3/$15 per M tokens) for planning, context, documentation
|
|
517
|
+
- Average cost savings: 40-60% per story
|
|
518
|
+
|
|
519
|
+
### Budget Controls
|
|
520
|
+
- MAX_BUDGET_CONTEXT: Default $3.00
|
|
521
|
+
- MAX_BUDGET_DEV: Default $15.00
|
|
522
|
+
- MAX_BUDGET_REVIEW: Default $5.00
|
|
523
|
+
|
|
524
|
+
---
|
|
525
|
+
|
|
526
|
+
For more details, see the [GitHub releases](https://github.com/Pedro-Jose-da-Rocha-Mendonca/Devflow/releases).
|
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2025 Pedro Jose da Rocha Mendonca
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|