@deimoscloud/coreai 0.1.9 → 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.
- package/dist/cli/index.js +1 -1
- package/dist/cli/index.js.map +1 -1
- package/dist/index.js +1 -1
- package/dist/index.js.map +1 -1
- package/package.json +6 -1
- package/.prettierrc +0 -9
- package/AGENT_SPEC.md +0 -347
- package/ARCHITECTURE.md +0 -547
- package/DRAFT_PRD.md +0 -1440
- package/IMPLEMENTATION_PLAN.md +0 -256
- package/PRODUCT.md +0 -473
- package/WORKFLOWS.md +0 -295
- package/commands/core/check-inbox.md +0 -34
- package/commands/core/delegate.md +0 -30
- package/commands/core/git-commit.md +0 -144
- package/commands/core/pr-create.md +0 -193
- package/commands/core/review.md +0 -56
- package/commands/core/sprint-status.md +0 -65
- package/commands/optional/docs-update.md +0 -200
- package/commands/optional/jira-create.md +0 -200
- package/commands/optional/jira-transition.md +0 -184
- package/commands/optional/worktree-cleanup.md +0 -167
- package/commands/optional/worktree-setup.md +0 -110
- package/eslint.config.js +0 -29
- package/jest.config.js +0 -22
- package/knowledge-library/README.md +0 -118
- package/knowledge-library/android-engineer/context/current.txt +0 -42
- package/knowledge-library/android-engineer/control/decisions.txt +0 -9
- package/knowledge-library/android-engineer/control/dependencies.txt +0 -19
- package/knowledge-library/android-engineer/control/objectives.txt +0 -26
- package/knowledge-library/android-engineer/history/.gitkeep +0 -0
- package/knowledge-library/android-engineer/inbox/processed/.gitkeep +0 -0
- package/knowledge-library/android-engineer/outbox/.gitkeep +0 -0
- package/knowledge-library/android-engineer/tech/.gitkeep +0 -0
- package/knowledge-library/architecture.txt +0 -61
- package/knowledge-library/backend-engineer/context/current.txt +0 -42
- package/knowledge-library/backend-engineer/control/decisions.txt +0 -9
- package/knowledge-library/backend-engineer/control/dependencies.txt +0 -19
- package/knowledge-library/backend-engineer/control/objectives.txt +0 -26
- package/knowledge-library/backend-engineer/history/.gitkeep +0 -0
- package/knowledge-library/backend-engineer/inbox/processed/.gitkeep +0 -0
- package/knowledge-library/backend-engineer/outbox/.gitkeep +0 -0
- package/knowledge-library/backend-engineer/tech/.gitkeep +0 -0
- package/knowledge-library/context.txt +0 -52
- package/knowledge-library/devops-engineer/context/current.txt +0 -42
- package/knowledge-library/devops-engineer/control/decisions.txt +0 -9
- package/knowledge-library/devops-engineer/control/dependencies.txt +0 -19
- package/knowledge-library/devops-engineer/control/objectives.txt +0 -26
- package/knowledge-library/devops-engineer/history/.gitkeep +0 -0
- package/knowledge-library/devops-engineer/inbox/processed/.gitkeep +0 -0
- package/knowledge-library/devops-engineer/outbox/.gitkeep +0 -0
- package/knowledge-library/devops-engineer/tech/.gitkeep +0 -0
- package/knowledge-library/engineering-manager/context/current.txt +0 -40
- package/knowledge-library/engineering-manager/control/decisions.txt +0 -9
- package/knowledge-library/engineering-manager/control/objectives.txt +0 -27
- package/knowledge-library/engineering-manager/history/.gitkeep +0 -0
- package/knowledge-library/engineering-manager/inbox/processed/.gitkeep +0 -0
- package/knowledge-library/engineering-manager/outbox/.gitkeep +0 -0
- package/knowledge-library/engineering-manager/tech/.gitkeep +0 -0
- package/knowledge-library/prd.txt +0 -81
- package/knowledge-library/product-manager/context/current.txt +0 -42
- package/knowledge-library/product-manager/control/decisions.txt +0 -9
- package/knowledge-library/product-manager/control/dependencies.txt +0 -19
- package/knowledge-library/product-manager/control/objectives.txt +0 -26
- package/knowledge-library/product-manager/history/.gitkeep +0 -0
- package/knowledge-library/product-manager/inbox/processed/.gitkeep +0 -0
- package/knowledge-library/product-manager/outbox/.gitkeep +0 -0
- package/knowledge-library/product-manager/tech/.gitkeep +0 -0
- package/knowledge-library/qa-engineer/context/current.txt +0 -42
- package/knowledge-library/qa-engineer/control/decisions.txt +0 -9
- package/knowledge-library/qa-engineer/control/dependencies.txt +0 -19
- package/knowledge-library/qa-engineer/control/objectives.txt +0 -26
- package/knowledge-library/qa-engineer/history/.gitkeep +0 -0
- package/knowledge-library/qa-engineer/inbox/processed/.gitkeep +0 -0
- package/knowledge-library/qa-engineer/outbox/.gitkeep +0 -0
- package/knowledge-library/qa-engineer/tech/.gitkeep +0 -0
- package/knowledge-library/security-engineer/context/current.txt +0 -42
- package/knowledge-library/security-engineer/control/decisions.txt +0 -9
- package/knowledge-library/security-engineer/control/dependencies.txt +0 -19
- package/knowledge-library/security-engineer/control/objectives.txt +0 -26
- package/knowledge-library/security-engineer/history/.gitkeep +0 -0
- package/knowledge-library/security-engineer/inbox/processed/.gitkeep +0 -0
- package/knowledge-library/security-engineer/outbox/.gitkeep +0 -0
- package/knowledge-library/security-engineer/tech/.gitkeep +0 -0
- package/knowledge-library/solutions-architect/context/current.txt +0 -42
- package/knowledge-library/solutions-architect/control/decisions.txt +0 -9
- package/knowledge-library/solutions-architect/control/dependencies.txt +0 -19
- package/knowledge-library/solutions-architect/control/objectives.txt +0 -26
- package/knowledge-library/solutions-architect/history/.gitkeep +0 -0
- package/knowledge-library/solutions-architect/inbox/processed/.gitkeep +0 -0
- package/knowledge-library/solutions-architect/outbox/.gitkeep +0 -0
- package/knowledge-library/solutions-architect/tech/.gitkeep +0 -0
- package/knowledge-library/wearos-engineer/context/current.txt +0 -42
- package/knowledge-library/wearos-engineer/control/decisions.txt +0 -9
- package/knowledge-library/wearos-engineer/control/dependencies.txt +0 -19
- package/knowledge-library/wearos-engineer/control/objectives.txt +0 -26
- package/knowledge-library/wearos-engineer/history/.gitkeep +0 -0
- package/knowledge-library/wearos-engineer/inbox/processed/.gitkeep +0 -0
- package/knowledge-library/wearos-engineer/outbox/.gitkeep +0 -0
- package/knowledge-library/wearos-engineer/tech/.gitkeep +0 -0
- package/scripts/add-agent.sh +0 -323
- package/scripts/install.sh +0 -354
- package/src/adapters/factory.test.ts +0 -386
- package/src/adapters/factory.ts +0 -305
- package/src/adapters/index.ts +0 -113
- package/src/adapters/interfaces.ts +0 -268
- package/src/adapters/mcp/client.test.ts +0 -130
- package/src/adapters/mcp/client.ts +0 -451
- package/src/adapters/mcp/discovery.test.ts +0 -315
- package/src/adapters/mcp/discovery.ts +0 -340
- package/src/adapters/mcp/index.ts +0 -66
- package/src/adapters/mcp/mapper.test.ts +0 -218
- package/src/adapters/mcp/mapper.ts +0 -536
- package/src/adapters/mcp/registry.test.ts +0 -433
- package/src/adapters/mcp/registry.ts +0 -550
- package/src/adapters/mcp/types.ts +0 -258
- package/src/adapters/native/filesystem.test.ts +0 -350
- package/src/adapters/native/filesystem.ts +0 -393
- package/src/adapters/native/github.test.ts +0 -173
- package/src/adapters/native/github.ts +0 -627
- package/src/adapters/native/index.ts +0 -22
- package/src/adapters/native/selector.test.ts +0 -224
- package/src/adapters/native/selector.ts +0 -150
- package/src/adapters/types.ts +0 -270
- package/src/agents/compiler.test.ts +0 -410
- package/src/agents/compiler.ts +0 -424
- package/src/agents/index.ts +0 -37
- package/src/agents/loader.test.ts +0 -319
- package/src/agents/loader.ts +0 -143
- package/src/agents/resolver.test.ts +0 -282
- package/src/agents/resolver.ts +0 -262
- package/src/agents/types.ts +0 -97
- package/src/cache/index.ts +0 -38
- package/src/cache/interfaces.ts +0 -283
- package/src/cache/manager.test.ts +0 -266
- package/src/cache/manager.ts +0 -388
- package/src/cache/provider.test.ts +0 -485
- package/src/cache/provider.ts +0 -745
- package/src/cache/types.test.ts +0 -192
- package/src/cache/types.ts +0 -313
- package/src/cli/commands/build.test.ts +0 -248
- package/src/cli/commands/build.ts +0 -284
- package/src/cli/commands/cache.test.ts +0 -221
- package/src/cli/commands/cache.ts +0 -229
- package/src/cli/commands/index.ts +0 -63
- package/src/cli/commands/init.test.ts +0 -173
- package/src/cli/commands/init.ts +0 -296
- package/src/cli/commands/skills.test.ts +0 -272
- package/src/cli/commands/skills.ts +0 -348
- package/src/cli/commands/status.test.ts +0 -392
- package/src/cli/commands/status.ts +0 -332
- package/src/cli/commands/sync.test.ts +0 -213
- package/src/cli/commands/sync.ts +0 -251
- package/src/cli/commands/validate.test.ts +0 -216
- package/src/cli/commands/validate.ts +0 -340
- package/src/cli/index.test.ts +0 -190
- package/src/cli/index.ts +0 -493
- package/src/commands/context.test.ts +0 -163
- package/src/commands/context.ts +0 -111
- package/src/commands/index.ts +0 -56
- package/src/commands/loader.test.ts +0 -273
- package/src/commands/loader.ts +0 -355
- package/src/commands/registry.test.ts +0 -384
- package/src/commands/registry.ts +0 -248
- package/src/commands/runner.test.ts +0 -297
- package/src/commands/runner.ts +0 -222
- package/src/commands/types.ts +0 -361
- package/src/config/index.ts +0 -19
- package/src/config/loader.test.ts +0 -262
- package/src/config/loader.ts +0 -188
- package/src/config/types.ts +0 -154
- package/src/context/index.ts +0 -14
- package/src/context/loader.test.ts +0 -334
- package/src/context/loader.ts +0 -357
- package/src/index.test.ts +0 -13
- package/src/index.ts +0 -268
- package/src/knowledge-library/index.ts +0 -44
- package/src/knowledge-library/manager.test.ts +0 -536
- package/src/knowledge-library/manager.ts +0 -804
- package/src/knowledge-library/types.ts +0 -432
- package/src/skills/generator.test.ts +0 -602
- package/src/skills/generator.ts +0 -491
- package/src/skills/index.ts +0 -27
- package/src/skills/templates.ts +0 -520
- package/src/skills/types.ts +0 -251
- package/templates/completion-report.md +0 -72
- package/templates/feedback.md +0 -56
- package/templates/project-files/CLAUDE.md.template +0 -109
- package/templates/project-files/coreai.json.example +0 -47
- package/templates/project-files/mcp.json.template +0 -20
- package/templates/review-complete.md +0 -64
- package/templates/review-request.md +0 -67
- package/templates/task-assignment.md +0 -51
- package/tsconfig.build.json +0 -4
- package/tsconfig.json +0 -26
- package/tsup.config.ts +0 -23
package/commands/core/review.md
DELETED
|
@@ -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.
|