clikit-plugin 0.3.9 → 0.3.11

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.
@@ -1,175 +0,0 @@
1
- ---
2
- description: Import tasks from Jira, Notion, Linear, or raw markdown/JSON and convert them into tracked Beads issues with a ready-to-execute plan.
3
- agent: plan
4
- ---
5
-
6
- You are the **Plan Agent**. Execute the `/import-plan` command.
7
-
8
- ## Your Task
9
-
10
- Import planning data from external tools (Jira, Notion, Linear, etc.) and convert to internal format.
11
-
12
- ## Process
13
-
14
- ### 1. Gather Source Data
15
-
16
- Ask user for:
17
- - Source type (Jira, Notion, Linear, Markdown, JSON)
18
- - Data to import (URL, file path, or pasted content)
19
-
20
- ### 2. Parse External Format
21
-
22
- **Jira:**
23
- ```
24
- - Epic → Bead
25
- - Story/Task → Task (T-XXX)
26
- - Subtask → Acceptance Criteria
27
- - Priority → P0/P1/P2 mapping
28
- - Story Points → Effort (S/M/L/XL)
29
- ```
30
-
31
- **Notion:**
32
- ```
33
- - Page → Bead or Spec
34
- - Database items → Tasks
35
- - Properties → Task fields
36
- ```
37
-
38
- **Linear:**
39
- ```
40
- - Project → Bead
41
- - Issue → Task
42
- - Labels → Tags
43
- - Priority → P0/P1/P2 mapping
44
- ```
45
-
46
- **Markdown/JSON:**
47
- ```
48
- - Parse structure
49
- - Map to Task Schema
50
- ```
51
-
52
- ### 3. Normalize to Internal Format
53
-
54
- Convert each item to Task Schema (`.opencode/schemas.md` §1):
55
-
56
- ```yaml
57
- task_id: "T-001"
58
- title: "[Imported title]"
59
- type: task | bug | feature | chore
60
- status: not_started
61
- assignee: build | fe | be | mobile | devops
62
- priority: P0 | P1 | P2
63
- effort: S | M | L | XL
64
- dependencies: []
65
- description: "[Imported description]"
66
- input: []
67
- output: []
68
- boundaries: []
69
- acceptance_criteria: []
70
- ```
71
-
72
- ### 4. Validate Against Spec
73
-
74
- - Check if `spec.md` exists
75
- - If yes: validate imported tasks align with spec
76
- - If no: suggest creating spec first or generate from import
77
-
78
- ### 5. Identify Gaps
79
-
80
- | Gap Type | Action |
81
- |----------|--------|
82
- | Missing acceptance criteria | Flag for user input |
83
- | Missing dependencies | Ask user to define |
84
- | Unclear scope | Mark as "Needs Clarification" |
85
- | Missing effort estimates | Suggest based on description |
86
-
87
- ### 6. Generate plan.md
88
-
89
- Create plan at `.opencode/memory/plans/YYYY-MM-DD-<feature>.md` using template `@.opencode/memory/_templates/plan.md`
90
-
91
- ### 7. Create Beads
92
-
93
- For each task:
94
- ```
95
- mcp__beads_village__add(
96
- title: "[Task title]",
97
- desc: "[Description]",
98
- typ: "[type]",
99
- pri: [0-4],
100
- deps: ["task:T-XXX"]
101
- )
102
- ```
103
-
104
- ## Output Format
105
-
106
- ```markdown
107
- ## Import Summary
108
-
109
- ### Source
110
- - **Type:** [Jira/Notion/Linear/etc.]
111
- - **Items Found:** [count]
112
-
113
- ### Imported Tasks
114
-
115
- | ID | Title | Type | Effort | Priority | Status |
116
- |----|-------|------|--------|----------|--------|
117
- | T-001 | [Title] | feature | M | P1 | Imported ✅ |
118
- | T-002 | [Title] | task | S | P2 | Needs AC ⚠️ |
119
-
120
- ### Gaps Identified
121
-
122
- - [ ] T-002: Missing acceptance criteria
123
- - [ ] T-003: Dependencies unclear
124
-
125
- ### Artifacts Created
126
-
127
- - Plan: `.opencode/memory/plans/YYYY-MM-DD-feature.md`
128
- - Beads: [count] tasks added to beads village
129
-
130
- ### Next Steps
131
-
132
- 1. Review and fill gaps
133
- 2. Get user approval on plan
134
- 3. `/start` to begin execution
135
- ```
136
-
137
- ## Field Mapping Reference
138
-
139
- ### Priority Mapping
140
-
141
- | External | Internal |
142
- |----------|----------|
143
- | Highest, Critical, P0 | P0 |
144
- | High, P1 | P1 |
145
- | Medium, Normal, P2 | P2 |
146
- | Low, P3, P4 | P2 |
147
-
148
- ### Effort Mapping
149
-
150
- | External | Internal |
151
- |----------|----------|
152
- | 1-2 points, XS | S |
153
- | 3-5 points, S, M | M |
154
- | 8-13 points, L | L |
155
- | 21+ points, XL | XL |
156
-
157
- ### Type Mapping
158
-
159
- | External | Internal |
160
- |----------|----------|
161
- | Story, Feature, Enhancement | feature |
162
- | Bug, Defect | bug |
163
- | Task, Subtask | task |
164
- | Chore, Maintenance, Tech Debt | chore |
165
-
166
- ## Rules
167
-
168
- - ✅ ALWAYS validate against Task Schema
169
- - ✅ ALWAYS preserve original IDs as reference
170
- - ✅ ALWAYS flag gaps rather than guess
171
- - ✅ ALWAYS get user approval before proceeding
172
- - ❌ NEVER auto-fill critical fields (AC, dependencies)
173
- - ❌ NEVER import without creating beads
174
-
175
- Now, what would you like to import? Please provide the source type and data.
package/command/issue.md DELETED
@@ -1,109 +0,0 @@
1
- ---
2
- description: Instantly capture any task, bug, or idea as a tracked Beads issue with priority and tags — no full spec needed.
3
- agent: build
4
- ---
5
-
6
- You are creating a **quick issue** in beads village.
7
-
8
- ## Your Task
9
-
10
- Rapidly create an issue/task without full spec process.
11
-
12
- ## Usage
13
-
14
- ```
15
- /issue [title]
16
- ```
17
-
18
- Or just `/issue` and I'll ask for details.
19
-
20
- ## Process
21
-
22
- ### 1. Gather Minimal Info
23
-
24
- - **Title:** What needs to be done? (required)
25
- - **Type:** task | bug | feature | chore (default: task)
26
- - **Priority:** P0=critical, P1=high, P2=normal (default: P2)
27
- - **Description:** Brief context (optional)
28
- - **Tags:** fe, be, mobile, devops, qa (optional)
29
-
30
- ### 2. Create in Beads
31
-
32
- ```
33
- mcp__beads_village__add(
34
- title: "[title]",
35
- typ: "[type]",
36
- pri: [priority],
37
- desc: "[description]",
38
- tags: ["tag1", "tag2"]
39
- )
40
- ```
41
-
42
- ### 3. Confirm Creation
43
-
44
- ## Quick Templates
45
-
46
- ### Bug Report
47
- ```
48
- /issue Bug: [what's broken]
49
- ```
50
- → Creates with `typ: "bug"`, `pri: 1`
51
-
52
- ### Feature Request
53
- ```
54
- /issue Feature: [what to add]
55
- ```
56
- → Creates with `typ: "feature"`, `pri: 2`
57
-
58
- ### Quick Task
59
- ```
60
- /issue [action verb] [thing]
61
- ```
62
- → Creates with `typ: "task"`, `pri: 2`
63
-
64
- ### Chore
65
- ```
66
- /issue Chore: [maintenance task]
67
- ```
68
- → Creates with `typ: "chore"`, `pri: 2`
69
-
70
- ## Examples
71
-
72
- | Input | Result |
73
- |-------|--------|
74
- | `/issue Fix login button not working` | Bug, P1 |
75
- | `/issue Add dark mode support` | Feature, P2 |
76
- | `/issue Update dependencies` | Chore, P2 |
77
- | `/issue Refactor auth module` | Task, P2 |
78
-
79
- ## Output Format
80
-
81
- ```markdown
82
- ## ✅ Issue Created
83
-
84
- **ID:** [bead-id]
85
- **Title:** [title]
86
- **Type:** [type]
87
- **Priority:** P0 | P1 | P2
88
- **Tags:** [tags]
89
-
90
- ### Next Steps
91
- - Start with `/start` (after `/create` generates a plan)
92
- - View all with `/status`
93
- ```
94
-
95
- ## Advanced Options
96
-
97
- For complex issues, use full form:
98
- ```
99
- /issue
100
- Title: [required]
101
- Type: bug | task | feature | chore
102
- Priority: P0 | P1 | P2
103
- Description: [context]
104
- Tags: fe, be, mobile, devops, qa
105
- Parent: [parent-id for subtasks]
106
- Deps: [blocking-issue-ids]
107
- ```
108
-
109
- What issue do you want to create?
@@ -1,128 +0,0 @@
1
- # Spec Template
2
-
3
- Use this template when creating specifications.
4
-
5
- **Output path:** `.opencode/memory/specs/YYYY-MM-DD-<descriptor>.md`
6
-
7
- ---
8
-
9
- ```markdown
10
- # Specification: [Title]
11
-
12
- **Date:** YYYY-MM-DD
13
- **Author:** [Name]
14
- **Status:** Draft | Confirmed
15
- **bead_id:** [ID]
16
-
17
- ---
18
-
19
- ## Problem & Context
20
-
21
- ### Problem Statement
22
- [Why is this needed?]
23
-
24
- ### Background
25
- [Context and history]
26
-
27
- ### Who is Affected
28
- [Stakeholders and users impacted]
29
-
30
- ---
31
-
32
- ## Outcomes
33
-
34
- ### Success Criteria
35
- 1. [Measurable outcome 1]
36
- 2. [Measurable outcome 2]
37
-
38
- ### Key Results
39
- | Outcome | Metric | Target |
40
- |---------|--------|--------|
41
- | [Outcome] | [How to measure] | [Target value] |
42
-
43
- ---
44
-
45
- ## Scope
46
-
47
- ### In Scope
48
- - [Feature/capability 1]
49
- - [Feature/capability 2]
50
-
51
- ### Out of Scope
52
- - [Excluded item 1]
53
- - [Excluded item 2]
54
-
55
- ### Boundaries
56
- [Clear boundaries of what this spec covers]
57
-
58
- ---
59
-
60
- ## Users
61
-
62
- ### Primary Users
63
- | User Type | Description | Needs |
64
- |-----------|-------------|-------|
65
- | [Type] | [Who they are] | [What they need] |
66
-
67
- ### Secondary Users
68
- | User Type | Description | Needs |
69
- |-----------|-------------|-------|
70
-
71
- ---
72
-
73
- ## Constraints
74
-
75
- ### Technical Constraints
76
- - [Constraint 1]
77
-
78
- ### Business Constraints
79
- - [Timeline, budget, etc.]
80
-
81
- ### Dependencies
82
- | Dependency | Type | Status |
83
- |------------|------|--------|
84
- | [Dependency] | Blocking/Soft | Ready/Pending |
85
-
86
- ---
87
-
88
- ## Acceptance Criteria
89
-
90
- | ID | Criteria | Verification |
91
- |----|----------|--------------|
92
- | AC-01 | [Criteria] | [How to verify] |
93
- | AC-02 | [Criteria] | [How to verify] |
94
-
95
- ### Execution Notes
96
- - Preferred workflow mode: `compressed`
97
- - Expected execution unit: **Task Packet**
98
- - Beads issue/task is the live execution state
99
- - Manual-only verification is not allowed unless explicitly marked as follow-up
100
-
101
- ---
102
-
103
- ## Assumptions
104
-
105
- | ID | Assumption | Status | Notes |
106
- |----|------------|--------|-------|
107
- | A-01 | [Assumption] | Confirmed/Unconfirmed | [Notes] |
108
-
109
- ---
110
-
111
- ## Open Questions
112
-
113
- - [ ] [Question 1]
114
- - [ ] [Question 2]
115
-
116
- ## Planning Handoff Hints
117
-
118
- - Likely files in scope: [candidate files/directories]
119
- - Likely packet boundaries: [how the work should split into 1–3 file packets]
120
- - Escalate if: [conditions that should trigger re-plan or Oracle]
121
-
122
- ---
123
-
124
- ## References
125
-
126
- - [Link to related docs]
127
- - [Link to research]
128
- ```