@comfanion/workflow 4.36.46 → 4.36.48
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/README.md +31 -9
- package/package.json +1 -1
- package/src/build-info.json +2 -2
- package/src/opencode/FLOW.yaml +0 -132
package/README.md
CHANGED
|
@@ -21,9 +21,10 @@ The workflow uses specialized AI agents, each with a unique persona and skills:
|
|
|
21
21
|
| 📊 **Analyst** | Sara | Requirements gathering, stakeholder interviews | Planning |
|
|
22
22
|
| 📋 **PM** | Dima | PRD, epics, stories, sprint planning, Jira | Planning → Sprint |
|
|
23
23
|
| 🏗️ **Architect** | Winston | System design, ADRs, coding standards | Planning |
|
|
24
|
-
| 💻 **Dev** | Rick | TDD implementation,
|
|
24
|
+
| 💻 **Dev** | Rick | TDD implementation, story development | Implementation |
|
|
25
25
|
| ⚡ **Coder** | Morty | Quick implementation, bug fixes | Implementation |
|
|
26
|
-
| 🔍 **
|
|
26
|
+
| 🔍 **Reviewer** | Marcus | Security review, bug finding (GPT-5.2 Codex) | Implementation |
|
|
27
|
+
| 🔬 **Researcher** | Kristina | Technical/market/domain research | Any |
|
|
27
28
|
| 🔄 **Change Manager** | Bruce | Documentation changes, impact analysis | Any |
|
|
28
29
|
|
|
29
30
|
### Workflow Pipeline
|
|
@@ -31,9 +32,18 @@ The workflow uses specialized AI agents, each with a unique persona and skills:
|
|
|
31
32
|
```
|
|
32
33
|
Planning: /requirements → /prd → /coding-standards → /architecture
|
|
33
34
|
Sprint: /epics → /stories → /sprint-plan → /jira-sync
|
|
34
|
-
Development: /dev-story
|
|
35
|
+
Development: /dev-story → /review-story (auto) → done
|
|
36
|
+
↑______________| (fix if issues found)
|
|
35
37
|
```
|
|
36
38
|
|
|
39
|
+
### Auto Review
|
|
40
|
+
|
|
41
|
+
After `/dev-story` completes all tasks, `@reviewer` (GPT-5.2 Codex) automatically reviews:
|
|
42
|
+
- **Security** - secrets, injection, auth/authz
|
|
43
|
+
- **Correctness** - AC satisfied, edge cases
|
|
44
|
+
- **Testing** - coverage, quality
|
|
45
|
+
- **Code quality** - architecture, performance
|
|
46
|
+
|
|
37
47
|
### Key Skills
|
|
38
48
|
|
|
39
49
|
- **requirements-gathering** - Extract FR/NFR through interviews
|
|
@@ -127,7 +137,11 @@ npx @comfanion/workflow init
|
|
|
127
137
|
2. **Communication language** - Ukrainian, English, Russian
|
|
128
138
|
3. **Development methodology** - TDD or STUB
|
|
129
139
|
4. **Vectorizer** - Enable semantic search
|
|
130
|
-
5. **
|
|
140
|
+
5. **Embedding model** - Choose speed vs quality:
|
|
141
|
+
- MiniLM-L6 (Fast) - ~10 files/10sec
|
|
142
|
+
- BGE-small (Balanced) - ~9 files/10sec ← default
|
|
143
|
+
- BGE-base (Quality) - ~3 files/10sec
|
|
144
|
+
6. **Jira integration** - Enable/disable
|
|
131
145
|
|
|
132
146
|
**Flags:**
|
|
133
147
|
|
|
@@ -181,11 +195,13 @@ communication_language: "en" # en, uk, ru
|
|
|
181
195
|
# Development
|
|
182
196
|
development:
|
|
183
197
|
methodology: tdd # tdd or stub
|
|
198
|
+
auto_review: true # Auto-invoke @reviewer after /dev-story
|
|
184
199
|
|
|
185
200
|
# Semantic Search
|
|
186
201
|
vectorizer:
|
|
187
202
|
enabled: true
|
|
188
203
|
auto_index: true # Auto-index on startup
|
|
204
|
+
model: "Xenova/bge-small-en-v1.5" # MiniLM, bge-small, bge-base
|
|
189
205
|
debounce_ms: 5000
|
|
190
206
|
indexes:
|
|
191
207
|
code: { enabled: true }
|
|
@@ -212,12 +228,18 @@ jira:
|
|
|
212
228
|
├── config.yaml # Your configuration
|
|
213
229
|
├── FLOW.yaml # Workflow definition
|
|
214
230
|
├── agents/ # AI agent personas
|
|
215
|
-
│ ├── analyst.md # Business Analyst
|
|
216
|
-
│ ├── pm.md # Product Manager
|
|
217
|
-
│ ├── architect.md # Solution Architect
|
|
218
|
-
│
|
|
231
|
+
│ ├── analyst.md # Sara - Business Analyst
|
|
232
|
+
│ ├── pm.md # Dima - Product Manager
|
|
233
|
+
│ ├── architect.md # Winston - Solution Architect
|
|
234
|
+
│ ├── dev.md # Rick - Senior Developer
|
|
235
|
+
│ ├── coder.md # Morty - Fast Coder
|
|
236
|
+
│ ├── reviewer.md # Marcus - Code Reviewer (GPT-5.2 Codex)
|
|
237
|
+
│ ├── researcher.md # Kristina - Researcher
|
|
238
|
+
│ └── change-manager.md # Bruce - Change Manager
|
|
219
239
|
├── skills/ # Knowledge modules (25+)
|
|
220
|
-
├── plugins/ #
|
|
240
|
+
├── plugins/ # Plugins
|
|
241
|
+
│ ├── file-indexer.ts # Auto-indexer on startup
|
|
242
|
+
│ └── custom-compaction.ts # Agent-aware session compaction
|
|
221
243
|
├── vectorizer/ # Semantic search engine
|
|
222
244
|
│ ├── index.js
|
|
223
245
|
│ └── package.json
|
package/package.json
CHANGED
package/src/build-info.json
CHANGED
package/src/opencode/FLOW.yaml
CHANGED
|
@@ -475,138 +475,6 @@ agents:
|
|
|
475
475
|
skills_used:
|
|
476
476
|
- change-management
|
|
477
477
|
|
|
478
|
-
# =============================================================================
|
|
479
|
-
# COMMANDS (Entry Points)
|
|
480
|
-
# =============================================================================
|
|
481
|
-
commands:
|
|
482
|
-
# Planning Commands
|
|
483
|
-
requirements:
|
|
484
|
-
description: Gather FR/NFR requirements
|
|
485
|
-
agent: analyst
|
|
486
|
-
file: commands/requirements.md
|
|
487
|
-
skills_loaded: [requirements-gathering, acceptance-criteria]
|
|
488
|
-
|
|
489
|
-
prd:
|
|
490
|
-
description: Create/edit PRD
|
|
491
|
-
agent: pm
|
|
492
|
-
file: commands/prd.md
|
|
493
|
-
skills_loaded: [prd-writing, acceptance-criteria]
|
|
494
|
-
|
|
495
|
-
coding-standards:
|
|
496
|
-
description: Define coding standards
|
|
497
|
-
agent: architect
|
|
498
|
-
file: commands/coding-standards.md
|
|
499
|
-
skills_loaded: [coding-standards]
|
|
500
|
-
|
|
501
|
-
architecture:
|
|
502
|
-
description: Create/edit architecture
|
|
503
|
-
agent: architect
|
|
504
|
-
file: commands/architecture.md
|
|
505
|
-
skills_loaded: [architecture-design, adr-writing]
|
|
506
|
-
|
|
507
|
-
# Sprint Commands
|
|
508
|
-
epics:
|
|
509
|
-
description: Create epics from PRD
|
|
510
|
-
agent: pm
|
|
511
|
-
file: commands/epics.md
|
|
512
|
-
skills_loaded: [epic-writing, acceptance-criteria]
|
|
513
|
-
|
|
514
|
-
stories:
|
|
515
|
-
description: Create stories for epic
|
|
516
|
-
agent: pm
|
|
517
|
-
file: commands/stories.md
|
|
518
|
-
arguments:
|
|
519
|
-
- name: epic-id
|
|
520
|
-
required: true
|
|
521
|
-
skills_loaded: [story-writing, acceptance-criteria]
|
|
522
|
-
|
|
523
|
-
sprint-plan:
|
|
524
|
-
description: Plan sprints
|
|
525
|
-
agent: pm
|
|
526
|
-
file: commands/sprint-plan.md
|
|
527
|
-
skills_loaded: [sprint-planning]
|
|
528
|
-
|
|
529
|
-
jira-sync:
|
|
530
|
-
description: Sync to Jira
|
|
531
|
-
agent: pm
|
|
532
|
-
file: commands/jira-sync.md
|
|
533
|
-
skills_loaded: [jira-integration]
|
|
534
|
-
|
|
535
|
-
# Implementation Commands
|
|
536
|
-
dev-story:
|
|
537
|
-
description: Implement a story
|
|
538
|
-
agent: dev
|
|
539
|
-
file: commands/dev-story.md
|
|
540
|
-
arguments:
|
|
541
|
-
- name: story-path
|
|
542
|
-
required: false
|
|
543
|
-
skills_loaded: [dev-story, test-design]
|
|
544
|
-
|
|
545
|
-
review-story:
|
|
546
|
-
description: Review completed story (security, quality, correctness)
|
|
547
|
-
agent: reviewer
|
|
548
|
-
file: commands/review-story.md
|
|
549
|
-
arguments:
|
|
550
|
-
- name: story-path
|
|
551
|
-
required: false
|
|
552
|
-
skills_loaded: [code-review]
|
|
553
|
-
auto_invoke:
|
|
554
|
-
when: story_status_review # Auto-invoke when story marked as "review"
|
|
555
|
-
config: development.auto_review # Controlled by config.yaml
|
|
556
|
-
|
|
557
|
-
code-review:
|
|
558
|
-
description: Review implemented code (legacy - use /review-story)
|
|
559
|
-
agent: dev
|
|
560
|
-
file: commands/code-review.md
|
|
561
|
-
arguments:
|
|
562
|
-
- name: story-path
|
|
563
|
-
required: false
|
|
564
|
-
skills_loaded: [code-review]
|
|
565
|
-
|
|
566
|
-
# Utility Commands
|
|
567
|
-
validate:
|
|
568
|
-
description: Validate artifacts
|
|
569
|
-
agent: architect
|
|
570
|
-
file: commands/validate.md
|
|
571
|
-
arguments:
|
|
572
|
-
- name: type
|
|
573
|
-
values: [requirements, prd, architecture, epics, stories, all]
|
|
574
|
-
skills_loaded: [requirements-validation, prd-validation, architecture-validation]
|
|
575
|
-
|
|
576
|
-
workflow-status:
|
|
577
|
-
description: Show workflow status
|
|
578
|
-
agent: pm
|
|
579
|
-
file: commands/workflow-status.md
|
|
580
|
-
|
|
581
|
-
research:
|
|
582
|
-
description: Conduct research
|
|
583
|
-
agent: researcher
|
|
584
|
-
file: commands/research.md
|
|
585
|
-
arguments:
|
|
586
|
-
- name: type
|
|
587
|
-
values: [market, technical, domain, competitive]
|
|
588
|
-
- name: topic
|
|
589
|
-
required: true
|
|
590
|
-
|
|
591
|
-
unit-docs:
|
|
592
|
-
description: Document module/domain/service/feature using Universal Unit format
|
|
593
|
-
agent: architect
|
|
594
|
-
file: commands/unit-docs.md
|
|
595
|
-
arguments:
|
|
596
|
-
- name: unit-type
|
|
597
|
-
values: [module, domain, service, entity, feature]
|
|
598
|
-
- name: unit-name
|
|
599
|
-
required: true
|
|
600
|
-
skills_loaded: [unit-writing]
|
|
601
|
-
|
|
602
|
-
change:
|
|
603
|
-
description: Manage documentation changes
|
|
604
|
-
agent: change-manager
|
|
605
|
-
file: commands/change.md
|
|
606
|
-
arguments:
|
|
607
|
-
- name: action
|
|
608
|
-
values: [propose, review, apply, reject]
|
|
609
|
-
|
|
610
478
|
# =============================================================================
|
|
611
479
|
# ARTIFACTS
|
|
612
480
|
# =============================================================================
|