@deimoscloud/coreai 0.1.8 → 0.1.10

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 (196) hide show
  1. package/dist/cli/index.js +5 -0
  2. package/dist/cli/index.js.map +1 -1
  3. package/dist/index.js +3 -1
  4. package/dist/index.js.map +1 -1
  5. package/package.json +6 -1
  6. package/.prettierrc +0 -9
  7. package/AGENT_SPEC.md +0 -347
  8. package/ARCHITECTURE.md +0 -547
  9. package/DRAFT_PRD.md +0 -1440
  10. package/IMPLEMENTATION_PLAN.md +0 -256
  11. package/PRODUCT.md +0 -473
  12. package/WORKFLOWS.md +0 -295
  13. package/commands/core/check-inbox.md +0 -34
  14. package/commands/core/delegate.md +0 -30
  15. package/commands/core/git-commit.md +0 -144
  16. package/commands/core/pr-create.md +0 -193
  17. package/commands/core/review.md +0 -56
  18. package/commands/core/sprint-status.md +0 -65
  19. package/commands/optional/docs-update.md +0 -200
  20. package/commands/optional/jira-create.md +0 -200
  21. package/commands/optional/jira-transition.md +0 -184
  22. package/commands/optional/worktree-cleanup.md +0 -167
  23. package/commands/optional/worktree-setup.md +0 -110
  24. package/eslint.config.js +0 -29
  25. package/jest.config.js +0 -22
  26. package/knowledge-library/README.md +0 -118
  27. package/knowledge-library/android-engineer/context/current.txt +0 -42
  28. package/knowledge-library/android-engineer/control/decisions.txt +0 -9
  29. package/knowledge-library/android-engineer/control/dependencies.txt +0 -19
  30. package/knowledge-library/android-engineer/control/objectives.txt +0 -26
  31. package/knowledge-library/android-engineer/history/.gitkeep +0 -0
  32. package/knowledge-library/android-engineer/inbox/processed/.gitkeep +0 -0
  33. package/knowledge-library/android-engineer/outbox/.gitkeep +0 -0
  34. package/knowledge-library/android-engineer/tech/.gitkeep +0 -0
  35. package/knowledge-library/architecture.txt +0 -61
  36. package/knowledge-library/backend-engineer/context/current.txt +0 -42
  37. package/knowledge-library/backend-engineer/control/decisions.txt +0 -9
  38. package/knowledge-library/backend-engineer/control/dependencies.txt +0 -19
  39. package/knowledge-library/backend-engineer/control/objectives.txt +0 -26
  40. package/knowledge-library/backend-engineer/history/.gitkeep +0 -0
  41. package/knowledge-library/backend-engineer/inbox/processed/.gitkeep +0 -0
  42. package/knowledge-library/backend-engineer/outbox/.gitkeep +0 -0
  43. package/knowledge-library/backend-engineer/tech/.gitkeep +0 -0
  44. package/knowledge-library/context.txt +0 -52
  45. package/knowledge-library/devops-engineer/context/current.txt +0 -42
  46. package/knowledge-library/devops-engineer/control/decisions.txt +0 -9
  47. package/knowledge-library/devops-engineer/control/dependencies.txt +0 -19
  48. package/knowledge-library/devops-engineer/control/objectives.txt +0 -26
  49. package/knowledge-library/devops-engineer/history/.gitkeep +0 -0
  50. package/knowledge-library/devops-engineer/inbox/processed/.gitkeep +0 -0
  51. package/knowledge-library/devops-engineer/outbox/.gitkeep +0 -0
  52. package/knowledge-library/devops-engineer/tech/.gitkeep +0 -0
  53. package/knowledge-library/engineering-manager/context/current.txt +0 -40
  54. package/knowledge-library/engineering-manager/control/decisions.txt +0 -9
  55. package/knowledge-library/engineering-manager/control/objectives.txt +0 -27
  56. package/knowledge-library/engineering-manager/history/.gitkeep +0 -0
  57. package/knowledge-library/engineering-manager/inbox/processed/.gitkeep +0 -0
  58. package/knowledge-library/engineering-manager/outbox/.gitkeep +0 -0
  59. package/knowledge-library/engineering-manager/tech/.gitkeep +0 -0
  60. package/knowledge-library/prd.txt +0 -81
  61. package/knowledge-library/product-manager/context/current.txt +0 -42
  62. package/knowledge-library/product-manager/control/decisions.txt +0 -9
  63. package/knowledge-library/product-manager/control/dependencies.txt +0 -19
  64. package/knowledge-library/product-manager/control/objectives.txt +0 -26
  65. package/knowledge-library/product-manager/history/.gitkeep +0 -0
  66. package/knowledge-library/product-manager/inbox/processed/.gitkeep +0 -0
  67. package/knowledge-library/product-manager/outbox/.gitkeep +0 -0
  68. package/knowledge-library/product-manager/tech/.gitkeep +0 -0
  69. package/knowledge-library/qa-engineer/context/current.txt +0 -42
  70. package/knowledge-library/qa-engineer/control/decisions.txt +0 -9
  71. package/knowledge-library/qa-engineer/control/dependencies.txt +0 -19
  72. package/knowledge-library/qa-engineer/control/objectives.txt +0 -26
  73. package/knowledge-library/qa-engineer/history/.gitkeep +0 -0
  74. package/knowledge-library/qa-engineer/inbox/processed/.gitkeep +0 -0
  75. package/knowledge-library/qa-engineer/outbox/.gitkeep +0 -0
  76. package/knowledge-library/qa-engineer/tech/.gitkeep +0 -0
  77. package/knowledge-library/security-engineer/context/current.txt +0 -42
  78. package/knowledge-library/security-engineer/control/decisions.txt +0 -9
  79. package/knowledge-library/security-engineer/control/dependencies.txt +0 -19
  80. package/knowledge-library/security-engineer/control/objectives.txt +0 -26
  81. package/knowledge-library/security-engineer/history/.gitkeep +0 -0
  82. package/knowledge-library/security-engineer/inbox/processed/.gitkeep +0 -0
  83. package/knowledge-library/security-engineer/outbox/.gitkeep +0 -0
  84. package/knowledge-library/security-engineer/tech/.gitkeep +0 -0
  85. package/knowledge-library/solutions-architect/context/current.txt +0 -42
  86. package/knowledge-library/solutions-architect/control/decisions.txt +0 -9
  87. package/knowledge-library/solutions-architect/control/dependencies.txt +0 -19
  88. package/knowledge-library/solutions-architect/control/objectives.txt +0 -26
  89. package/knowledge-library/solutions-architect/history/.gitkeep +0 -0
  90. package/knowledge-library/solutions-architect/inbox/processed/.gitkeep +0 -0
  91. package/knowledge-library/solutions-architect/outbox/.gitkeep +0 -0
  92. package/knowledge-library/solutions-architect/tech/.gitkeep +0 -0
  93. package/knowledge-library/wearos-engineer/context/current.txt +0 -42
  94. package/knowledge-library/wearos-engineer/control/decisions.txt +0 -9
  95. package/knowledge-library/wearos-engineer/control/dependencies.txt +0 -19
  96. package/knowledge-library/wearos-engineer/control/objectives.txt +0 -26
  97. package/knowledge-library/wearos-engineer/history/.gitkeep +0 -0
  98. package/knowledge-library/wearos-engineer/inbox/processed/.gitkeep +0 -0
  99. package/knowledge-library/wearos-engineer/outbox/.gitkeep +0 -0
  100. package/knowledge-library/wearos-engineer/tech/.gitkeep +0 -0
  101. package/scripts/add-agent.sh +0 -323
  102. package/scripts/install.sh +0 -354
  103. package/src/adapters/factory.test.ts +0 -386
  104. package/src/adapters/factory.ts +0 -305
  105. package/src/adapters/index.ts +0 -113
  106. package/src/adapters/interfaces.ts +0 -268
  107. package/src/adapters/mcp/client.test.ts +0 -130
  108. package/src/adapters/mcp/client.ts +0 -451
  109. package/src/adapters/mcp/discovery.test.ts +0 -315
  110. package/src/adapters/mcp/discovery.ts +0 -340
  111. package/src/adapters/mcp/index.ts +0 -66
  112. package/src/adapters/mcp/mapper.test.ts +0 -218
  113. package/src/adapters/mcp/mapper.ts +0 -536
  114. package/src/adapters/mcp/registry.test.ts +0 -433
  115. package/src/adapters/mcp/registry.ts +0 -550
  116. package/src/adapters/mcp/types.ts +0 -258
  117. package/src/adapters/native/filesystem.test.ts +0 -350
  118. package/src/adapters/native/filesystem.ts +0 -393
  119. package/src/adapters/native/github.test.ts +0 -173
  120. package/src/adapters/native/github.ts +0 -627
  121. package/src/adapters/native/index.ts +0 -22
  122. package/src/adapters/native/selector.test.ts +0 -224
  123. package/src/adapters/native/selector.ts +0 -150
  124. package/src/adapters/types.ts +0 -270
  125. package/src/agents/compiler.test.ts +0 -399
  126. package/src/agents/compiler.ts +0 -422
  127. package/src/agents/index.ts +0 -37
  128. package/src/agents/loader.test.ts +0 -319
  129. package/src/agents/loader.ts +0 -143
  130. package/src/agents/resolver.test.ts +0 -282
  131. package/src/agents/resolver.ts +0 -262
  132. package/src/agents/types.ts +0 -97
  133. package/src/cache/index.ts +0 -38
  134. package/src/cache/interfaces.ts +0 -283
  135. package/src/cache/manager.test.ts +0 -266
  136. package/src/cache/manager.ts +0 -388
  137. package/src/cache/provider.test.ts +0 -485
  138. package/src/cache/provider.ts +0 -745
  139. package/src/cache/types.test.ts +0 -192
  140. package/src/cache/types.ts +0 -313
  141. package/src/cli/commands/build.test.ts +0 -248
  142. package/src/cli/commands/build.ts +0 -284
  143. package/src/cli/commands/cache.test.ts +0 -221
  144. package/src/cli/commands/cache.ts +0 -229
  145. package/src/cli/commands/index.ts +0 -63
  146. package/src/cli/commands/init.test.ts +0 -173
  147. package/src/cli/commands/init.ts +0 -296
  148. package/src/cli/commands/skills.test.ts +0 -272
  149. package/src/cli/commands/skills.ts +0 -348
  150. package/src/cli/commands/status.test.ts +0 -392
  151. package/src/cli/commands/status.ts +0 -332
  152. package/src/cli/commands/sync.test.ts +0 -213
  153. package/src/cli/commands/sync.ts +0 -251
  154. package/src/cli/commands/validate.test.ts +0 -216
  155. package/src/cli/commands/validate.ts +0 -340
  156. package/src/cli/index.test.ts +0 -190
  157. package/src/cli/index.ts +0 -493
  158. package/src/commands/context.test.ts +0 -163
  159. package/src/commands/context.ts +0 -111
  160. package/src/commands/index.ts +0 -56
  161. package/src/commands/loader.test.ts +0 -273
  162. package/src/commands/loader.ts +0 -355
  163. package/src/commands/registry.test.ts +0 -384
  164. package/src/commands/registry.ts +0 -248
  165. package/src/commands/runner.test.ts +0 -297
  166. package/src/commands/runner.ts +0 -222
  167. package/src/commands/types.ts +0 -361
  168. package/src/config/index.ts +0 -19
  169. package/src/config/loader.test.ts +0 -262
  170. package/src/config/loader.ts +0 -188
  171. package/src/config/types.ts +0 -154
  172. package/src/context/index.ts +0 -14
  173. package/src/context/loader.test.ts +0 -334
  174. package/src/context/loader.ts +0 -357
  175. package/src/index.test.ts +0 -13
  176. package/src/index.ts +0 -268
  177. package/src/knowledge-library/index.ts +0 -44
  178. package/src/knowledge-library/manager.test.ts +0 -536
  179. package/src/knowledge-library/manager.ts +0 -804
  180. package/src/knowledge-library/types.ts +0 -432
  181. package/src/skills/generator.test.ts +0 -602
  182. package/src/skills/generator.ts +0 -491
  183. package/src/skills/index.ts +0 -27
  184. package/src/skills/templates.ts +0 -520
  185. package/src/skills/types.ts +0 -251
  186. package/templates/completion-report.md +0 -72
  187. package/templates/feedback.md +0 -56
  188. package/templates/project-files/CLAUDE.md.template +0 -109
  189. package/templates/project-files/coreai.json.example +0 -47
  190. package/templates/project-files/mcp.json.template +0 -20
  191. package/templates/review-complete.md +0 -64
  192. package/templates/review-request.md +0 -67
  193. package/templates/task-assignment.md +0 -51
  194. package/tsconfig.build.json +0 -4
  195. package/tsconfig.json +0 -26
  196. package/tsup.config.ts +0 -23
@@ -1,56 +0,0 @@
1
- ---
2
- description: Request PR review from agents using inbox-based delegation
3
- argument-hint: PR #<number> by <agent-name(s)>
4
- ---
5
-
6
- # PR Review Request
7
-
8
- You are the Engineering Manager. Assign this review: **$ARGUMENTS**
9
-
10
- ## CRITICAL RULES - READ FIRST
11
-
12
- 1. **DO NOT USE THE TASK TOOL** - You must NOT invoke agents directly
13
- 2. **USE INBOX FILES ONLY** - Write review requests to agent inbox directories
14
- 3. **TELL USER TO INVOKE** - End your response telling the user which agent(s) to invoke
15
-
16
- ## Review Delegation Steps
17
-
18
- 1. Get PR details: `gh pr view <number>`
19
- 2. Identify the Jira ticket from PR title/body
20
- 3. For EACH reviewer agent:
21
- - Write review request to `/KnowledgeLibrary/[agent-name]/inbox/YYYYMMDD_HHMM-engineering-manager-review-PR-XX.md`
22
- - Include: PR number, PR URL, what to review, workflow reference
23
- 4. Save copies to your outbox
24
- 5. End with instructions for the user to invoke each reviewer
25
-
26
- ## Review Request Template
27
-
28
- ```markdown
29
- ## PR Review Request
30
- **From:** engineering-manager
31
- **Date:** [date]
32
- **PR:** #[number] - [title]
33
- **PR URL:** https://github.com/{{GITHUB_REPO}}/pull/[number]
34
-
35
- ### Review Focus
36
- - [Architecture alignment / Security / Test coverage - based on agent role]
37
-
38
- ### Workflow Requirements
39
- Follow Code Review workflow in WORKFLOWS.md:
40
- 1. Review the PR thoroughly
41
- 2. Post your review as a GitHub PR comment using `gh pr comment`
42
- 3. State APPROVED or CHANGES_REQUESTED with your decision
43
- 4. Send summary to my inbox
44
- ```
45
-
46
- ## End Your Response With
47
-
48
- ```
49
- ---
50
- **Next Action Required:**
51
- Please invoke the reviewers:
52
- - `@solutions-architect check your inbox and review PR #XX`
53
- - `@security-engineer check your inbox and review PR #XX`
54
- ```
55
-
56
- Now proceed with the review delegation.
@@ -1,65 +0,0 @@
1
- ---
2
- description: Review current sprint progress and status (EM only)
3
- argument-hint: [optional: sprint number or "current"]
4
- ---
5
-
6
- # Sprint Status Review
7
-
8
- You are the Engineering Manager. Review the current sprint status and provide a summary.
9
-
10
- ## Steps
11
-
12
- 1. **Check Jira for current sprint:**
13
- ```
14
- Search: project = {{JIRA_PROJECT}} AND sprint in openSprints()
15
- ```
16
-
17
- 2. **Gather ticket status:**
18
- - Count tickets by status (Backlog, In Progress, In Review, Done)
19
- - Identify any blocked tickets
20
- - Check for overdue items
21
-
22
- 3. **Check agent inboxes for pending work:**
23
- - `/KnowledgeLibrary/*/inbox/` - any unprocessed tasks?
24
- - Are there completion summaries in your inbox you haven't processed?
25
-
26
- 4. **Review open PRs:**
27
- ```
28
- gh pr list --state open
29
- ```
30
-
31
- 5. **Provide summary report:**
32
-
33
- ```markdown
34
- ## Sprint Status Report
35
- **Date:** [today]
36
- **Sprint:** [sprint name/number]
37
-
38
- ### Ticket Summary
39
- | Status | Count | Tickets |
40
- |--------|-------|---------|
41
- | Done | X | {{JIRA_PROJECT}}-XX, {{JIRA_PROJECT}}-YY |
42
- | In Review | X | {{JIRA_PROJECT}}-XX |
43
- | In Progress | X | {{JIRA_PROJECT}}-XX |
44
- | Blocked | X | {{JIRA_PROJECT}}-XX (reason) |
45
- | Backlog | X | {{JIRA_PROJECT}}-XX |
46
-
47
- ### Open PRs
48
- - PR #XX - [title] - [status: awaiting review/changes requested/approved]
49
-
50
- ### Pending Agent Work
51
- - [agent]: [pending task or "inbox clear"]
52
-
53
- ### Blockers & Risks
54
- - [Any blockers or risks to sprint completion]
55
-
56
- ### Recommended Actions
57
- 1. [Action item]
58
- 2. [Action item]
59
- ```
60
-
61
- ## Additional Context
62
-
63
- $ARGUMENTS
64
-
65
- Now review the sprint status.
@@ -1,200 +0,0 @@
1
- ---
2
- description: Use when updating documentation, adding to Confluence, documenting changes, updating local docs, or keeping documentation in sync. Handles both Confluence pages and local /docs files.
3
- argument-hint: <what to document> [where]
4
- ---
5
-
6
- # Documentation Update
7
-
8
- You are documenting: **$ARGUMENTS**
9
-
10
- ## Documentation Locations
11
-
12
- | Location | Content Type | When to Update |
13
- |----------|--------------|----------------|
14
- | **Confluence** | Architecture, PRD, standards, guides | Major decisions, feature specs, process changes |
15
- | **Local /docs** | Technical workflows, setup guides | Development process, CI/CD, environment setup |
16
- | **Code comments** | Implementation details | Complex logic, non-obvious code |
17
- | **README files** | Module overviews | New modules, significant changes |
18
-
19
- ## Confluence Pages (Primary)
20
-
21
- ### Update via Atlassian MCP
22
-
23
- #### Read Current Page
24
-
25
- ```
26
- mcp__atlassian__getConfluencePage
27
- Page ID: <page-id>
28
- ```
29
-
30
- #### Update Page
31
-
32
- ```
33
- mcp__atlassian__updateConfluencePage
34
- Page ID: <page-id>
35
- Title: <page title>
36
- Content: <updated content in Confluence storage format>
37
- ```
38
-
39
- #### Create New Page
40
-
41
- ```
42
- mcp__atlassian__createConfluencePage
43
- Space Key: {{CONFLUENCE_SPACE}}
44
- Title: <page title>
45
- Content: <content in Confluence storage format>
46
- Parent Page ID: <parent-id> (optional)
47
- ```
48
-
49
- ### Confluence Content Format
50
-
51
- Confluence uses storage format (HTML-like). Common patterns:
52
-
53
- ```html
54
- <h2>Section Title</h2>
55
- <p>Paragraph text.</p>
56
-
57
- <ul>
58
- <li>Bullet point 1</li>
59
- <li>Bullet point 2</li>
60
- </ul>
61
-
62
- <ac:structured-macro ac:name="code">
63
- <ac:parameter ac:name="language">kotlin</ac:parameter>
64
- <ac:plain-text-body><![CDATA[
65
- // code here
66
- ]]></ac:plain-text-body>
67
- </ac:structured-macro>
68
-
69
- <ac:structured-macro ac:name="info">
70
- <ac:rich-text-body>
71
- <p>Info box content</p>
72
- </ac:rich-text-body>
73
- </ac:structured-macro>
74
- ```
75
-
76
- ## Local Documentation (/docs)
77
-
78
- ### Update Local Docs
79
-
80
- Use the Edit tool to update existing documentation:
81
-
82
- ```
83
- Edit file: {{PROJECT_ROOT}}/docs/[filename].md
84
- ```
85
-
86
- ### Documentation Template
87
-
88
- ```markdown
89
- # [Title]
90
-
91
- **Last Updated:** [YYYY-MM-DD]
92
- **Author:** [agent-name]
93
-
94
- ## Overview
95
-
96
- [Brief description of what this document covers]
97
-
98
- ## [Main Section]
99
-
100
- [Content]
101
-
102
- ### [Subsection]
103
-
104
- [Content]
105
-
106
- ## Related Documentation
107
-
108
- - [Link to related doc 1]
109
- - [Link to related doc 2]
110
-
111
- ---
112
-
113
- **Questions?** File a Jira ticket with component "Documentation".
114
- ```
115
-
116
- ## Keep Documentation in Sync
117
-
118
- When updating documentation, ensure both locations are updated:
119
-
120
- ### Architecture Changes
121
-
122
- 1. Update Confluence Architecture page (primary)
123
- 2. Update `/KnowledgeLibrary/architecture.txt` (local cache)
124
-
125
- ### Process Changes
126
-
127
- 1. Update Confluence Development page (primary)
128
- 2. Update `/docs/DEVELOPMENT_WORKFLOW.md` (local reference)
129
-
130
- ### PRD Changes
131
-
132
- 1. Update Confluence Product page (primary)
133
- 2. Update `/KnowledgeLibrary/prd.txt` (local cache)
134
-
135
- ## What to Document
136
-
137
- ### Always Document
138
-
139
- - Architecture decisions and rationale
140
- - New modules or significant refactors
141
- - API changes or new endpoints
142
- - Configuration changes
143
- - Process changes
144
- - Breaking changes
145
-
146
- ### Document When Significant
147
-
148
- - Bug fixes with non-obvious solutions
149
- - Performance optimizations
150
- - Security considerations
151
- - Integration details
152
-
153
- ### Skip Documentation For
154
-
155
- - Minor bug fixes
156
- - Code formatting changes
157
- - Dependency version bumps (unless breaking)
158
- - Internal refactors with no API changes
159
-
160
- ## Documentation Checklist
161
-
162
- Before completing documentation update:
163
-
164
- - [ ] Content is accurate and up-to-date
165
- - [ ] Examples are working and tested
166
- - [ ] Links are valid
167
- - [ ] Code snippets are correct
168
- - [ ] Related docs are cross-referenced
169
- - [ ] Both Confluence and local docs updated (if applicable)
170
-
171
- ## Error Handling
172
-
173
- **If Confluence MCP is unavailable:**
174
- 1. Update local documentation first
175
- 2. Note in completion report: "Confluence update pending - please sync manually"
176
- 3. Create a task to sync Confluence later
177
-
178
- **If page doesn't exist:**
179
- 1. Create new page with `mcp__atlassian__createConfluencePage`
180
- 2. Or create local doc and note Confluence page needs creation
181
-
182
- ## Completion
183
-
184
- After documentation update, report:
185
- ```
186
- Documentation Updated
187
-
188
- Updated:
189
- - [Confluence page name] (URL)
190
- - [Local file path]
191
-
192
- Changes:
193
- - [Summary of what was documented]
194
-
195
- Sync Status:
196
- - Confluence: [Updated/Pending]
197
- - Local docs: [Updated/N/A]
198
- ```
199
-
200
- Now proceed with the documentation update.
@@ -1,200 +0,0 @@
1
- ---
2
- description: Use when creating a Jira ticket, adding a new task to backlog, reporting a bug, or creating a feature request. Ensures tickets have all required fields and follow the standard template.
3
- argument-hint: <type> <title> [description]
4
- ---
5
-
6
- # Create Jira Ticket
7
-
8
- You are creating a Jira ticket for: **$ARGUMENTS**
9
-
10
- ## Ticket Types
11
-
12
- | Type | Use For |
13
- |------|---------|
14
- | **Story** | New user-facing features |
15
- | **Task** | Technical work, refactoring, infrastructure |
16
- | **Bug** | Defects, issues, broken functionality |
17
- | **Spike** | Research, investigation, prototyping |
18
- | **Improvement** | Enhancements to existing features |
19
-
20
- ## Required Fields
21
-
22
- Every ticket MUST have:
23
-
24
- 1. **Summary** - Clear, concise title
25
- 2. **Type** - Story, Task, Bug, Spike, or Improvement
26
- 3. **Description** - What needs to be done and why
27
- 4. **Acceptance Criteria** - Definition of done (checklist)
28
- 5. **Priority** - P0 (Critical), P1 (High), P2 (Medium), P3 (Low)
29
- 6. **Labels** - Relevant labels
30
-
31
- ## Create Ticket via Atlassian MCP
32
-
33
- ### Using MCP
34
-
35
- ```
36
- mcp__atlassian__createJiraIssue
37
-
38
- Project: {{JIRA_PROJECT}}
39
- Issue Type: <Story|Task|Bug|Spike|Improvement>
40
- Summary: <Clear title>
41
- Description: <Detailed description>
42
- Priority: <P0|P1|P2|P3>
43
- Labels: <comma-separated labels>
44
- ```
45
-
46
- ### Description Template
47
-
48
- ```markdown
49
- ## Overview
50
- [Brief description of what needs to be done]
51
-
52
- ## Background
53
- [Why this is needed, context, related tickets]
54
-
55
- ## Requirements
56
- - [Requirement 1]
57
- - [Requirement 2]
58
-
59
- ## Acceptance Criteria
60
- - [ ] [Criterion 1]
61
- - [ ] [Criterion 2]
62
- - [ ] [Criterion 3]
63
- - [ ] Unit tests written and passing
64
- - [ ] Code reviewed and approved
65
-
66
- ## Technical Notes
67
- [Any technical considerations, constraints, or suggestions]
68
-
69
- ## References
70
- - [Links to PRD, design docs, related tickets]
71
- ```
72
-
73
- ## Ticket Templates by Type
74
-
75
- ### Story Template
76
-
77
- ```markdown
78
- ## User Story
79
- As a [user type], I want [functionality] so that [benefit].
80
-
81
- ## Background
82
- [Context and motivation]
83
-
84
- ## Acceptance Criteria
85
- - [ ] [User-visible outcome 1]
86
- - [ ] [User-visible outcome 2]
87
- - [ ] Unit tests written
88
- - [ ] Manual testing completed
89
-
90
- ## Design
91
- [Link to UI mockups if applicable]
92
- ```
93
-
94
- ### Bug Template
95
-
96
- ```markdown
97
- ## Bug Description
98
- [Clear description of the bug]
99
-
100
- ## Steps to Reproduce
101
- 1. [Step 1]
102
- 2. [Step 2]
103
- 3. [Step 3]
104
-
105
- ## Expected Behavior
106
- [What should happen]
107
-
108
- ## Actual Behavior
109
- [What actually happens]
110
-
111
- ## Environment
112
- - Device: [e.g., device type]
113
- - OS Version: [e.g., version]
114
- - App Version: [e.g., 1.0.0]
115
-
116
- ## Acceptance Criteria
117
- - [ ] Bug is fixed
118
- - [ ] Regression test added
119
- - [ ] Verified on affected device
120
- ```
121
-
122
- ### Task Template
123
-
124
- ```markdown
125
- ## Task Description
126
- [What needs to be done]
127
-
128
- ## Background
129
- [Why this task is needed]
130
-
131
- ## Scope
132
- - [Item 1]
133
- - [Item 2]
134
-
135
- ## Out of Scope
136
- - [Item that is NOT part of this task]
137
-
138
- ## Acceptance Criteria
139
- - [ ] [Deliverable 1]
140
- - [ ] [Deliverable 2]
141
- - [ ] Documentation updated (if applicable)
142
- ```
143
-
144
- ## Priority Guidelines
145
-
146
- | Priority | Criteria | Response |
147
- |----------|----------|----------|
148
- | **P0** | Production down, data loss, security issue | Immediate |
149
- | **P1** | Major feature broken, blocking release | This sprint |
150
- | **P2** | Important but not blocking | Next sprint |
151
- | **P3** | Nice to have, minor improvements | Backlog |
152
-
153
- ## Local Fallback
154
-
155
- If Atlassian MCP is unavailable, create a local ticket file:
156
-
157
- **Path:** `/KnowledgeLibrary/tickets/backlog/{{JIRA_PROJECT}}-XXX-[short-description].md`
158
-
159
- ```markdown
160
- # [{{JIRA_PROJECT}}-XXX] [Title]
161
-
162
- ## Metadata
163
- - **Status:** Backlog
164
- - **Priority:** [P0|P1|P2|P3]
165
- - **Type:** [Story|Task|Bug|Spike|Improvement]
166
- - **Created By:** [agent-name]
167
- - **Created Date:** [YYYY-MM-DD]
168
- - **Labels:** [comma-separated]
169
-
170
- ## Description
171
- [Full description]
172
-
173
- ## Acceptance Criteria
174
- - [ ] [Criterion 1]
175
- - [ ] [Criterion 2]
176
-
177
- ## References
178
- - [Links]
179
- ```
180
-
181
- ## Completion
182
-
183
- After ticket creation, report:
184
- ```
185
- Jira Ticket Created
186
-
187
- Ticket: {{JIRA_PROJECT}}-XXX
188
- Title: [Summary]
189
- Type: [Type]
190
- Priority: [Priority]
191
- Status: Backlog
192
-
193
- URL: {{JIRA_URL}}/browse/{{JIRA_PROJECT}}-XXX
194
-
195
- Next Steps:
196
- - Ticket is in Backlog, ready for sprint planning
197
- - Use /delegate to assign when ready
198
- ```
199
-
200
- Now proceed with ticket creation.
@@ -1,184 +0,0 @@
1
- ---
2
- description: Use when updating a Jira ticket status, moving a ticket to a different state, marking a ticket as done, starting work on a ticket, or putting a ticket in review. Handles status transitions with proper comments.
3
- argument-hint: TICKET-XX to <status>
4
- ---
5
-
6
- # Jira Ticket Transition
7
-
8
- You are transitioning: **$ARGUMENTS**
9
-
10
- ## Valid Status Transitions
11
-
12
- ```
13
- Backlog → To Do → In Progress → In Review → Done
14
-
15
- Blocked
16
-
17
- In Progress
18
- ```
19
-
20
- | From | To | When |
21
- |------|-----|------|
22
- | Backlog | To Do | Sprint planning, ticket prioritized |
23
- | To Do | In Progress | Work begins on ticket |
24
- | In Progress | In Review | PR created |
25
- | In Progress | Blocked | Dependency or blocker identified |
26
- | Blocked | In Progress | Blocker resolved |
27
- | In Review | In Progress | PR feedback requires changes |
28
- | In Review | Done | PR merged, work complete |
29
-
30
- ## Transition via Atlassian MCP
31
-
32
- ### Get Current Status First
33
-
34
- ```
35
- mcp__atlassian__getJiraIssue
36
- Issue Key: {{JIRA_PROJECT}}-XX
37
- ```
38
-
39
- ### Transition Ticket
40
-
41
- ```
42
- mcp__atlassian__transitionJiraIssue
43
- Issue Key: {{JIRA_PROJECT}}-XX
44
- Transition: <target status>
45
- ```
46
-
47
- ### Add Transition Comment
48
-
49
- ```
50
- mcp__atlassian__addCommentToJiraIssue
51
- Issue Key: {{JIRA_PROJECT}}-XX
52
- Comment: <transition comment>
53
- ```
54
-
55
- ## Required Comments by Transition
56
-
57
- ### To Do → In Progress
58
-
59
- ```
60
- Starting work on this ticket.
61
- Assigned to: @[agent-name]
62
- Branch: feature/{{JIRA_PROJECT}}-XX-[description]
63
- ```
64
-
65
- ### In Progress → In Review
66
-
67
- ```
68
- PR created: <PR URL>
69
-
70
- Changes implemented:
71
- - [Change 1]
72
- - [Change 2]
73
-
74
- Ready for code review.
75
- ```
76
-
77
- ### In Progress → Blocked
78
-
79
- ```
80
- BLOCKED: [Reason for block]
81
-
82
- Blocking issue: [Description or ticket reference]
83
- Required to unblock: [What needs to happen]
84
- ```
85
-
86
- ### Blocked → In Progress
87
-
88
- ```
89
- Blocker resolved: [How it was resolved]
90
- Resuming work.
91
- ```
92
-
93
- ### In Review → In Progress
94
-
95
- ```
96
- Addressing review feedback:
97
- - [Feedback item 1]
98
- - [Feedback item 2]
99
-
100
- Will update PR when changes are complete.
101
- ```
102
-
103
- ### In Review → Done
104
-
105
- ```
106
- PR merged: [Merge commit SHA or PR URL]
107
-
108
- Acceptance criteria verified:
109
- - [x] [Criterion 1]
110
- - [x] [Criterion 2]
111
-
112
- Ticket complete.
113
- ```
114
-
115
- ## Workflow Integration
116
-
117
- This skill integrates with the workflow defined in `WORKFLOWS.md`:
118
-
119
- | Workflow State | Jira Status |
120
- |----------------|-------------|
121
- | BACKLOG | Backlog |
122
- | ASSIGNED | In Progress |
123
- | BRANCH_CREATED | In Progress |
124
- | IMPLEMENTING | In Progress |
125
- | PR_CREATED | In Review |
126
- | IN_REVIEW | In Review |
127
- | APPROVED | In Review |
128
- | MERGED | Done |
129
- | VERIFIED | Done |
130
- | DONE | Done |
131
-
132
- ## Validation
133
-
134
- Before transitioning, verify:
135
-
136
- ### To "In Progress"
137
- - [ ] Ticket has clear acceptance criteria
138
- - [ ] No blocking dependencies
139
- - [ ] Agent is ready to begin work
140
-
141
- ### To "In Review"
142
- - [ ] PR exists and is linked
143
- - [ ] All commits pushed
144
- - [ ] CI checks passing (or will pass)
145
-
146
- ### To "Done"
147
- - [ ] PR is merged
148
- - [ ] Acceptance criteria met
149
- - [ ] No open review comments
150
-
151
- ### To "Blocked"
152
- - [ ] Blocker is clearly documented
153
- - [ ] Blocking ticket/issue referenced if applicable
154
-
155
- ## Error Handling
156
-
157
- **If transition fails:**
158
- 1. Check current ticket status
159
- 2. Verify the transition is valid from current status
160
- 3. Some transitions may require specific permissions
161
-
162
- **If MCP is unavailable:**
163
- Report to user:
164
- ```
165
- Unable to transition ticket via MCP.
166
- Please manually update {{JIRA_PROJECT}}-XX to [status] in Jira.
167
- Add comment: [suggested comment]
168
- ```
169
-
170
- ## Completion
171
-
172
- After transition, report:
173
- ```
174
- Jira Ticket Transitioned
175
-
176
- Ticket: {{JIRA_PROJECT}}-XX
177
- Previous Status: [old status]
178
- New Status: [new status]
179
- Comment Added: Yes
180
-
181
- URL: {{JIRA_URL}}/browse/{{JIRA_PROJECT}}-XX
182
- ```
183
-
184
- Now proceed with the ticket transition.