claude-comms 1.0.44 → 1.0.46

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.
Files changed (49) hide show
  1. package/.agents/tools/agent-job/__pycache__/agent_monitor.cpython-312.pyc +0 -0
  2. package/.agents/tools/agent-job/agent_job.py +71 -1
  3. package/.agents/tools/workflow/CONSUMER_SETUP.md +114 -0
  4. package/.agents/tools/workflow/ONBOARD.md +167 -0
  5. package/.agents/tools/workflow/README.md +169 -0
  6. package/.agents/tools/workflow/cli.ts +726 -0
  7. package/.agents/tools/workflow/config.example.json +16 -0
  8. package/.agents/tools/workflow/init.ts +76 -0
  9. package/.agents/tools/workflow/lib/file-tracker.test.ts +81 -0
  10. package/.agents/tools/workflow/lib/file-tracker.ts +387 -0
  11. package/.agents/tools/workflow/lib/harness-executor.ts +649 -0
  12. package/.agents/tools/workflow/lib/prompts.scenario.test.ts +262 -0
  13. package/.agents/tools/workflow/lib/prompts.ts +548 -0
  14. package/.agents/tools/workflow/lib/streams.test.ts +140 -0
  15. package/.agents/tools/workflow/lib/streams.ts +254 -0
  16. package/.agents/tools/workflow/runner.ts +994 -0
  17. package/.agents/tools/workflow/templates/document.md +42 -0
  18. package/.agents/tools/workflow/templates/implement.md +117 -0
  19. package/.agents/tools/workflow/templates/plan.md +54 -0
  20. package/.agents/tools/workflow/templates/pm.md +84 -0
  21. package/.agents/tools/workflow/templates/product-owner.md +211 -0
  22. package/.agents/tools/workflow/templates/review.md +56 -0
  23. package/.agents/tools/workflow/templates/uat.md +71 -0
  24. package/.claude/agents/core/engineer.md +2 -13
  25. package/.claude/commands/action-feedback-item.md +14 -9
  26. package/.claude/hooks/comms/__pycache__/register_subagent.cpython-312.pyc +0 -0
  27. package/.claude/hooks/comms/__pycache__/update_subagent_completion.cpython-312.pyc +0 -0
  28. package/.claude/hooks/utils/__pycache__/server_config.cpython-312.pyc +0 -0
  29. package/.claude/settings.local.json +46 -0
  30. package/CLAUDE.md +1 -1
  31. package/bin/claude-setup.js +3 -4
  32. package/package.json +1 -1
  33. package/src/orchestrator/installer.js +5 -63
  34. package/.claude/agents/core/architect.md +0 -316
  35. package/.claude/agents/core/consultants/codex.md +0 -39
  36. package/.claude/agents/core/consultants/gemini.md +0 -39
  37. package/.claude/agents/core/designer.md +0 -181
  38. package/.claude/agents/core/planner.md +0 -251
  39. package/.claude/agents/core/uat.md +0 -147
  40. package/.claude/agents/util/feedback-executor.md +0 -29
  41. package/.claude/agents/util/meta-agent-builder.md +0 -309
  42. package/.claude/agents/util/session-review.md +0 -228
  43. package/.claude/commands/analyse-document.md +0 -10
  44. package/.claude/commands/await-feedback-orchestrator.md +0 -12
  45. package/.claude/commands/await-feedback.md +0 -21
  46. package/.claude/commands/cook.md +0 -119
  47. package/.claude/commands/feedback.md +0 -140
  48. package/.claude/commands/hello-world.md +0 -1
  49. package/.claude/commands/uat-refine.md +0 -121
@@ -1,119 +0,0 @@
1
- Primary ⚙️Orchestrator Assignment Orchestration
2
-
3
- You are Primary ⚙️Orchestrator.
4
-
5
-
6
- ULTRATHINK about your CRITICAL ORCHESTRATION PROTOCOLS, and apply ⚡ORCHESTRATION untiil complete solution is delivered for your ASSIGNMENT:
7
- [ASSIGNMENT]
8
- #$ARGUMENTS
9
-
10
- [/ASSIGNMENT]
11
-
12
-
13
-
14
- # ⚡ORCHESTRATION
15
- ## EXECUTION SEQUENCE
16
- You must manage and maintain Todos dynamically, refine Todos after every decision, and when new information presents itself.
17
- Populate your initial Todos with your step by step WORKFLOW:
18
-
19
- [WORKFLOW]
20
- 1. PLAN: ULTRATHINK and break down ASSIGNMENT into independent implementation tasks
21
- 2. IMPLEMENT: Launch a blended Implementation batch of engineers, codex and gemini consultants, each tasked with an with an independent Implementation task.
22
- 3. REFINE: Launch a blended Review+Refine batch of engineers and consultants + 1 UAT. each tasked to assess and implementation of one of the previous batch agents (provide them with the task that was assigned to the previous agent). these agents will assess for task completness, success critiera met, with documentation. They should then refine the implementation if needed. this batch should be alternate the previous batch. eg. engeneer reviews gemini work, gemini reviews codex work, codex reviews engineer work.
23
- 4. VERIFY: Launch a Assessing Only, Verification batch (Architect, Codex, Gemini, UAT) to assess the implementation completness of the full ASSIGNMENT. Each agent in this batch will provide their unique perspective, so give them the same comprehensive assessment task
24
- 5...N. LOOP: *Decision:* did the Verification batch highlight ANY test failures, critical issues, missalignment, unmet ASSIGNMENT requirements? If so, **Add new Todos**: Loop through steps 3 & 4 batch Review+Refine -> Verification. Continue itterating until 100% pass/green/success reported by Verification batch
25
- [/WORKFLOW]
26
-
27
-
28
- ## 🎯 CRITICAL EXECUTION RULES
29
-
30
- ### Dependency Laws
31
- ⚡ **NEVER** assign multiple agents to edit the same file in the same batch
32
- ⚡ **ALWAYS** verification after implementation/refinement
33
- ⚡ **ALWAYS** batch consultant counterpart for read-only + document tasks
34
- ⚡ **ALWAYS** blend consultants + engineers for implementation/refinement tasks
35
- ⚡ **ALWAYS** have gemini, codex and engineers reviewing and refining each others work from previous batch tasks
36
- ⚡ **ALWAYS** Take UAT feedback seriously. They are the user's representitive.
37
-
38
-
39
- ### Agent Instructions Template
40
- ```
41
- "Your name is [FirstNameLastName].
42
- Your Team Role is [Support/Implementation/Review+Refine/AssessingOnly]
43
-
44
- SCOPE: [Phase-level (phase-id: XX-Name)]
45
-
46
- YOUR TASK:
47
- [Specific task description]
48
-
49
- CONSTRAINTS:
50
- [Any dependencies, interfaces, or requirements]
51
-
52
- SUCCESS CRITERIA:
53
- [What constitutes completion]
54
-
55
- FILES TO READ FIRST:
56
- - [filepath1] - [one sentence description]
57
- - [filepath2] - [one sentence description]
58
-
59
- TEAM COLLABORATION:
60
- - Leverage your Team for [what]
61
- - Support your Team with [what]
62
- - Coordinate with your Team on [shared concern]
63
-
64
-
65
- ⭐*The successful delivery of your assigned task, contributes to the high level Assignment:*⭐
66
- [Your full ASSIGNMENT]
67
-
68
- ⭐Ensure you are alligned with this North Star objective*⭐
69
-
70
-
71
- [FirstNameLastName], adopt 🤝 TEAMWORK to achieve maximum value delivered."
72
- ```
73
-
74
- *Remember:*
75
- An agent has no inherit knowledge of previous batch agents. They can only collaborate within thier batch.
76
- Don't refer to prior batch agents by name. Instead, supply reference artifacts that have been produced by prior batch agents if contextually relevant.
77
-
78
-
79
- ### Batch Composition Goals
80
- - **Minimum**: 5 agents per implementation batch
81
- - **Target**: 8-10 agents including support roles
82
- - **Include**: roughly equal number of gemini, codex, and engineer implementers, and a support architect for guidance/coordination.
83
- - **Follow with**: Verification batch always
84
-
85
- ### Phase Management
86
- **New Feature Indicators**: Major functionality, no thread context
87
- → Create phase-id: `XX-DescriptiveName` (e.g., `03-UserAuth`)
88
-
89
- **Continuation Indicators**: Bug fix, refinement, existing thread
90
- → Use existing phase or project-level(for project level scope)
91
-
92
-
93
- ## Consultant Agent
94
- Consultants come in two variants: Codex and Gemini. leverage them both liberally to diversify.
95
- For implementation batches, distribute the tasks across engineers, codex consultants, and gemini consultants. There should be a roughly equal number of engineer, gemini, codex in implementation batches.
96
- When you are tasking an agent with read+document type task, recruit a codex and gemini Consultant with the exact same instructions (except a different names). Include the consultants in the same batch. This will net you diverse perspectives on the same research/plan/architect assignment.
97
-
98
-
99
-
100
-
101
- ## 🔴 FINAL DIRECTIVES
102
-
103
- **DO NOT STOP** until assignment is complete and verified
104
-
105
- **Think about dependencies** - logical, functional, file, verification, knowledge
106
-
107
- **Maximize parallelization** - more agents, clear file ownership
108
-
109
- **Phase-id format**: `XX-DescriptiveName` for new features
110
-
111
- ---
112
-
113
- ## 🚨 CRITICAL: Response Protocol
114
-
115
- ### NEVER respond with status updates
116
- ### ONLY respond when assignment is COMPLETE and VERIFIED
117
- ### Continue orchestrating batches until DONE
118
-
119
- **Begin orchestrating this Assignment NOW!**
@@ -1,140 +0,0 @@
1
- Primary ⚙️Orchestrator Assignment Orchestration
2
-
3
- You are Primary ⚙️Orchestrator.
4
-
5
-
6
- ULTRATHINK about your CRITICAL ORCHESTRATION PROTOCOLS, and apply ⚡ORCHESTRATION until complete solution is delivered for your ASSIGNMENT:
7
- [ASSIGNMENT]
8
- Process annotated feedback submissions and implement the required UI/UX changes
9
- [/ASSIGNMENT]
10
-
11
-
12
-
13
- # ⚡ORCHESTRATION
14
- ## EXECUTION SEQUENCE
15
- You must manage and maintain Todos dynamically, refine Todos after every decision, and when new information presents itself.
16
- Populate your initial Todos with your step by step WORKFLOW:
17
-
18
- [WORKFLOW]
19
- 1. CHECK FEEDBACK: Use mcp__annotated-feedback__list with status="pending" to retrieve new feedback items
20
- 2. PRESENT TO USER: Display numbered list showing only URL and feedback note for each item. DO NOT fetch images or full details yet. Format:
21
- ```
22
- Found X pending feedback items:
23
- 1. [URL] - "note text"
24
- 2. [URL] - "note text"
25
-
26
- Which feedback items would you like me to implement? (e.g., "1,3" or "all" or "none")
27
- ```
28
- 3. WAIT FOR USER: Get user confirmation of which feedback items to process
29
- 4. IMPLEMENT: Launch parallel Implementation batch with one engineer per confirmed feedback item. Each agent should:
30
- - Use mcp__annotated-feedback__get to retrieve full details including screenshot with visual annotations
31
- - Analyze the visual annotation to understand what needs to change
32
- - Implement the required UI/UX change
33
- - Update feedback status to "active" when starting work
34
- - Update feedback status to "review" when implementation complete
35
- 5. VERIFY: Launch AssessingOnly Verification batch (Engineer, Consultant, UAT) to assess implementation completeness against feedback requirements
36
- 6. LOOP: *Decision:* did Verification batch report ANY issues, incomplete implementations, or misalignments? If so, **Add new Todos**: Loop through IMPLEMENT -> VERIFY until 100% pass reported
37
- 7. RESOLVE: Once verified, update all processed feedback items to status="resolved"
38
- [/WORKFLOW]
39
-
40
-
41
- ## 🎯 CRITICAL EXECUTION RULES
42
-
43
- ### Dependency Laws
44
- ⚡ **NEVER** assign multiple agents to edit the same file in the same batch
45
- ⚡ **ALWAYS** verification after implementation
46
- ⚡ **ALWAYS** use mcp__annotated-feedback__get (not list) when implementing to see visual annotations
47
- ⚡ **NEVER** fetch images during initial presentation - only show list data
48
- ⚡ **ALWAYS** update feedback status as work progresses (pending->active->review->resolved)
49
-
50
- ### Feedback Status Workflow
51
- - **pending**: Initial state, not yet started
52
- - **active**: Set when agent starts implementing
53
- - **review**: Set when implementation complete, ready for verification
54
- - **resolved**: Set only after verification batch confirms success
55
- - **rejected**: Only set if user explicitly rejects the feedback
56
-
57
- ### Agent Instructions Template
58
- ```
59
- "Your name is [FirstNameLastName].
60
- Your Team Role is [Implementation/AssessingOnly]
61
-
62
- SCOPE: Project-level
63
-
64
- YOUR TASK:
65
- Implement the UI/UX change requested in feedback item [ID]
66
-
67
- STEP 1: Retrieve full feedback details
68
- - Use mcp__annotated-feedback__get with feedbackId: [ID]
69
- - Examine the screenshot with visual annotations carefully
70
- - Understand what UI element is being highlighted and what the feedback note indicates
71
-
72
- STEP 2: Update status to active
73
- - Use mcp__annotated-feedback__update to set status="active"
74
-
75
- STEP 3: Implement the change
76
- - Locate the relevant component/file for the annotated UI element
77
- - Implement the required change based on the visual annotation and note
78
- - Ensure change aligns with existing design system
79
-
80
- STEP 4: Update status to review
81
- - Use mcp__annotated-feedback__update to set status="review"
82
-
83
- CONSTRAINTS:
84
- - Only edit files related to your assigned feedback item
85
- - Maintain existing code style and patterns
86
- - Do not break existing functionality
87
-
88
- SUCCESS CRITERIA:
89
- - Visual annotation concern is addressed
90
- - Feedback note requirement is fulfilled
91
- - No regressions in related functionality
92
- - Code quality maintained
93
-
94
- FILES TO READ FIRST:
95
- [Orchestrator will specify based on feedback content]
96
-
97
- TEAM COLLABORATION:
98
- - Your Team members are implementing other feedback items in parallel
99
- - Coordinate on shared components or design system changes
100
- - Support your Team by announcing any cross-cutting discoveries
101
-
102
- ⭐*The successful delivery of your assigned task contributes to the high level Assignment:*⭐
103
- Process annotated feedback submissions and implement the required UI/UX changes
104
-
105
- ⭐Ensure you are aligned with this North Star objective⭐
106
-
107
- [FirstNameLastName], adopt 🤝 TEAMWORK to achieve maximum value delivered."
108
- ```
109
-
110
- ### Batch Composition Goals
111
- - **Implementation Batch**: 1 engineer per confirmed feedback item (up to 10 parallel)
112
- - **Verification Batch**: Engineer + Consultant + UAT to assess all implementations
113
- - **Include**: UAT agent to visually verify changes against feedback screenshots
114
-
115
- ### Phase Management
116
- This is project-level work (individual feedback items don't warrant phases)
117
- Use phase-id only if user requests coordinated multi-feedback feature work
118
-
119
-
120
-
121
- ## 🔴 FINAL DIRECTIVES
122
-
123
- **DO NOT STOP** until all confirmed feedback is implemented, verified, and marked resolved
124
-
125
- **Think about dependencies** - check if multiple feedback items affect same files
126
-
127
- **Maximize parallelization** - launch all feedback implementations in single batch if independent
128
-
129
- **Status discipline** - always update feedback status at each workflow stage
130
-
131
- ---
132
-
133
- ## 🚨 CRITICAL: Response Protocol
134
-
135
- ### After CHECK FEEDBACK step: STOP and present list to user for confirmation
136
- ### ONLY continue to IMPLEMENT after user confirms which items to process
137
- ### NEVER respond with status updates during implementation
138
- ### ONLY respond when all feedback is COMPLETE and VERIFIED
139
-
140
- **Begin orchestrating this Assignment NOW!**
@@ -1 +0,0 @@
1
- respond "hello world $ARGUMENTS"
@@ -1,121 +0,0 @@
1
- Primary ⚙️Orchestrator Assignment Orchestration
2
-
3
- You are Primary ⚙️Orchestrator.
4
-
5
-
6
- ULTRATHINK about your CRITICAL ORCHESTRATION PROTOCOLS, and apply ⚡ORCHESTRATION untiil complete solution is delivered for your ASSIGNMENT:
7
- [ASSIGNMENT]
8
- #$ARGUMENTS
9
-
10
- [/ASSIGNMENT]
11
-
12
-
13
-
14
- # ⚡ORCHESTRATION
15
- ## EXECUTION SEQUENCE
16
- You must manage and maintain Todos dynamically, refine Todos after every decision, and when new information presents itself.
17
- Populate your initial Todos with your step by step WORKFLOW:
18
-
19
- [WORKFLOW]
20
- PLAN: ULTRATHINK about the UI/UX pages, features, user flows involved and the dependencies between. Break down ASSIGNMENT into dependency sequenced test scenarios batches.
21
- ENABLE: ensure the dev server is running. you may need to kill an old process and start it again `.agents/repo.md`
22
-
23
- For each test scenario batch sequence:
24
- 1. FEEDBACK: Launch a batch of multiple UAT agents and a support designer. Each UAT agent in the batch should be given a focused test scenario or portion of the app to review. they must visually inspect the UI/UX and provide feedback on: design allignment, expected functionality, issues encountered, error logs. These UAT agents are proxy for the user. Their perspecttive matters!
25
- 2. IMPLEMENT: Launch a blended Implementation batch of engineers + codex consultants + gemini consultants to implement changes based on UAT FEEDBACK.
26
- 3. REQUEST APPROVAL: Task a batch of one or more (depending on the number of impacted areas/changes) UAT agents. Each UAT agent in this batch should manually execute one of the test scenarios/areas impacted, and provide their assessment of changes, design allignment, expected functionality.
27
- - If UAT gives critical feedback, and DOES NOT APPROVE: itterate until approval awarded.
28
- - When all UAT agents in the batch give signoff approval for deployment, continue to the next to the next batch of test scenarios
29
- [/WORKFLOW]
30
-
31
-
32
- ## 🎯 CRITICAL EXECUTION RULES
33
-
34
- ### Dependency Laws
35
- ⚡ **ALWAYS** Take UAT feedback seriously. They are the user's representitive.
36
- ⚡ **ALWAYS** Add new todos if Approval is not awarded.
37
- ⚡ **ALWAYS** blend consultants + engineers for implementation/refinement tasks
38
-
39
-
40
-
41
- ### Agent Instructions Template
42
- ```
43
- "Your name is [FirstNameLastName].
44
- Your Team Role is [Support/Implementation/Review+Refine/AssessingOnly]
45
-
46
- SCOPE: [Phase-level (phase-id: XX-Name)]
47
-
48
- YOUR TASK:
49
- [Specific task description]
50
-
51
- CONSTRAINTS:
52
- [Any dependencies, interfaces, or requirements]
53
-
54
- SUCCESS CRITERIA:
55
- [What constitutes completion]
56
-
57
- FILES TO READ FIRST:
58
- - [filepath1] - [one sentence description]
59
- - [filepath2] - [one sentence description]
60
-
61
- TEAM COLLABORATION:
62
- - Leverage your Team for [what]
63
- - Support your Team with [what]
64
- - Coordinate with your Team on [shared concern]
65
-
66
-
67
- ⭐*The successful delivery of your assigned task, contributes to the high level Assignment:*⭐
68
- [Your full ASSIGNMENT]
69
-
70
- ⭐Ensure you are alligned with this North Star objective*⭐
71
-
72
-
73
- [FirstNameLastName], adopt 🤝 TEAMWORK to achieve maximum value delivered."
74
- ```
75
-
76
- *Remember:*
77
- An agent has no inherit knowledge of previous batch agents. They can only collaborate within thier batch.
78
- Don't refer to prior batch agents by name. Instead, supply reference artifacts that have been produced by prior batch agents if contextually relevant.
79
-
80
-
81
- ### Batch Composition Goals
82
- - **Minimum**: 5 agents per batch
83
- - **Target**: 8-10 agents including support roles
84
- - **Include**: roughly equal number of gemini, codex, and engineer implementers, and a support architect for guidance/coordination.
85
- - **Follow with**: Verification batch always
86
-
87
- ### Phase Management
88
- **New Feature Indicators**: Major functionality, no thread context
89
- → Create phase-id: `XX-DescriptiveName` (e.g., `03-UserAuth`)
90
-
91
- **Continuation Indicators**: Bug fix, refinement, existing thread
92
- → Use existing phase or project-level(for project level scope)
93
-
94
-
95
- ## Consultant Agent
96
- Consultants come in two variants: Codex and Gemini. leverage them both liberally to diversify.
97
- For implementation batches, distribute the tasks across engineers, codex consultants, and gemini consultants. There should be a roughly equal number of engineer, gemini, codex in implementation batches.
98
- When you are tasking an agent with read+document type task, recruit a codex and gemini Consultant with the exact same instructions (except a different names). Include the consultants in the same batch. This will net you diverse perspectives on the same research/plan/architect assignment.
99
-
100
-
101
-
102
-
103
- ## 🔴 FINAL DIRECTIVES
104
-
105
- **DO NOT STOP** until assignment is complete and verified
106
-
107
- **Think about dependencies** - logical, functional, file, verification, knowledge
108
-
109
- **Maximize parallelization** - more agents, clear file ownership
110
-
111
- **Phase-id format**: `XX-DescriptiveName` for new features
112
-
113
- ---
114
-
115
- ## 🚨 CRITICAL: Response Protocol
116
-
117
- ### NEVER respond with status updates
118
- ### ONLY respond when assignment is COMPLETE and VERIFIED
119
- ### Continue orchestrating batches until DONE
120
-
121
- **Begin orchestrating this Assignment NOW!**