clikit-plugin 0.2.44 → 0.2.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.
- package/AGENTS.md +69 -3
- package/README.md +128 -92
- package/command/commit.md +1 -1
- package/command/create.md +65 -8
- package/command/debug.md +1 -1
- package/command/design.md +183 -43
- package/command/handoff.md +1 -1
- package/command/import-plan.md +2 -2
- package/command/init.md +1 -1
- package/command/issue.md +3 -4
- package/command/pr.md +1 -1
- package/command/research.md +5 -7
- package/command/resume.md +1 -1
- package/command/ship.md +29 -32
- package/command/start.md +38 -27
- package/command/{status-beads.md → status.md} +2 -3
- package/command/verify.md +132 -48
- package/dist/.tsbuildinfo +1 -1
- package/dist/agents/index.d.ts +0 -0
- package/dist/agents/index.d.ts.map +0 -0
- package/dist/beads-context.test.d.ts +2 -0
- package/dist/beads-context.test.d.ts.map +1 -0
- package/dist/cli.d.ts +0 -0
- package/dist/cli.d.ts.map +0 -0
- package/dist/cli.js +5 -0
- package/dist/cli.test.d.ts +0 -0
- package/dist/cli.test.d.ts.map +0 -0
- package/dist/clikit.schema.json +32 -11
- package/dist/clilog.test.d.ts +0 -0
- package/dist/clilog.test.d.ts.map +0 -0
- package/dist/commands/index.d.ts +0 -0
- package/dist/commands/index.d.ts.map +0 -0
- package/dist/config.d.ts +15 -7
- package/dist/config.d.ts.map +1 -1
- package/dist/config.test.d.ts +0 -0
- package/dist/config.test.d.ts.map +0 -0
- package/dist/hooks/beads-context.d.ts +2 -0
- package/dist/hooks/beads-context.d.ts.map +1 -1
- package/dist/hooks/empty-message-sanitizer.d.ts +0 -0
- package/dist/hooks/empty-message-sanitizer.d.ts.map +0 -0
- package/dist/hooks/error-logger.d.ts +0 -0
- package/dist/hooks/error-logger.d.ts.map +0 -0
- package/dist/hooks/git-guard.d.ts +0 -0
- package/dist/hooks/git-guard.d.ts.map +0 -0
- package/dist/hooks/index.d.ts +0 -2
- package/dist/hooks/index.d.ts.map +1 -1
- package/dist/hooks/memory-digest.d.ts +1 -0
- package/dist/hooks/memory-digest.d.ts.map +1 -1
- package/dist/hooks/security-check.d.ts +0 -0
- package/dist/hooks/security-check.d.ts.map +0 -0
- package/dist/hooks/subagent-question-blocker.d.ts +0 -0
- package/dist/hooks/subagent-question-blocker.d.ts.map +0 -0
- package/dist/hooks/todo-beads-sync.d.ts +1 -0
- package/dist/hooks/todo-beads-sync.d.ts.map +1 -1
- package/dist/hooks/todo-enforcer.d.ts +1 -1
- package/dist/hooks/todo-enforcer.d.ts.map +1 -1
- package/dist/hooks/truncator.d.ts +0 -0
- package/dist/hooks/truncator.d.ts.map +0 -0
- package/dist/index.d.ts +0 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +250 -576
- package/dist/skills/index.d.ts +0 -0
- package/dist/skills/index.d.ts.map +0 -0
- package/dist/tools/cass-memory.d.ts +0 -0
- package/dist/tools/cass-memory.d.ts.map +0 -0
- package/dist/tools/context-summary.d.ts +0 -0
- package/dist/tools/context-summary.d.ts.map +0 -0
- package/dist/tools/index.d.ts +0 -3
- package/dist/tools/index.d.ts.map +1 -1
- package/dist/tools/memory-db.d.ts +0 -0
- package/dist/tools/memory-db.d.ts.map +0 -0
- package/dist/tools/memory.d.ts +0 -0
- package/dist/tools/memory.d.ts.map +0 -0
- package/dist/tools/observation.d.ts +0 -0
- package/dist/tools/observation.d.ts.map +0 -0
- package/dist/types.d.ts +0 -0
- package/dist/types.d.ts.map +0 -0
- package/memory/_digest.md +1 -1
- package/memory/_templates/handoff.md +0 -0
- package/memory/_templates/plan.md +35 -0
- package/memory/_templates/prd.md +0 -0
- package/memory/_templates/research.md +0 -0
- package/memory/_templates/review.md +0 -0
- package/memory/_templates/spec.md +12 -0
- package/memory/beads/.gitkeep +0 -0
- package/memory/handoffs/.gitkeep +0 -0
- package/memory/memory.db +0 -0
- package/memory/plans/.gitkeep +0 -0
- package/memory/prds/.gitkeep +0 -0
- package/memory/research/.gitkeep +0 -0
- package/memory/reviews/.gitkeep +0 -0
- package/memory/specs/.gitkeep +0 -0
- package/package.json +4 -4
- package/skill/beads/SKILL.md +42 -43
- package/skill/beads/mcp.json +26 -0
- package/skill/beads/references/api-reference.md +64 -0
- package/skill/chrome-devtools/SKILL.md +22 -23
- package/skill/chrome-devtools/mcp.json +17 -0
- package/skill/chrome-devtools/references/tool-reference.md +63 -0
- package/skill/condition-based-waiting/SKILL.md +28 -66
- package/skill/deep-research/SKILL.md +34 -103
- package/skill/deep-research/mcp.json +21 -0
- package/skill/deep-research/references/lsp-ops.md +44 -0
- package/skill/defense-in-depth/SKILL.md +29 -69
- package/skill/executing-plans/SKILL.md +25 -34
- package/skill/finishing-a-development-branch/SKILL.md +28 -89
- package/skill/playwright/SKILL.md +27 -22
- package/skill/playwright/mcp.json +20 -0
- package/skill/playwright/references/tool-reference.md +64 -0
- package/skill/receiving-code-review/SKILL.md +16 -27
- package/skill/requesting-code-review/SKILL.md +22 -26
- package/skill/ritual-workflow/SKILL.md +22 -82
- package/skill/root-cause-tracing/SKILL.md +30 -54
- package/skill/session-management/SKILL.md +21 -40
- package/skill/source-code-research/SKILL.md +33 -102
- package/skill/source-code-research/mcp.json +13 -0
- package/skill/source-code-research/references/quick-ref.md +65 -0
- package/skill/systematic-debugging/SKILL.md +28 -41
- package/skill/systematic-debugging/references/patterns.md +71 -0
- package/skill/test-driven-development/SKILL.md +16 -40
- package/skill/testing-anti-patterns/SKILL.md +36 -64
- package/skill/testing-anti-patterns/references/decision-matrix.md +55 -0
- package/skill/using-git-worktrees/SKILL.md +27 -103
- package/skill/vercel-react-best-practices/SKILL.md +50 -139
- package/skill/vercel-react-best-practices/references/patterns.md +70 -0
- package/skill/verification-before-completion/SKILL.md +19 -37
- package/skill/writing-plans/SKILL.md +20 -32
- package/skill/writing-skills/SKILL.md +52 -41
- package/skill/writing-skills/references/skill-anatomy.md +210 -0
- package/src/agents/AGENTS.md +48 -18
- package/src/agents/build.md +342 -93
- package/src/agents/explore.md +77 -60
- package/src/agents/index.ts +0 -0
- package/src/agents/oracle.md +153 -63
- package/src/agents/plan.md +275 -110
- package/src/agents/research.md +72 -52
- package/src/agents/review.md +182 -61
- package/src/agents/vision.md +7 -5
- package/command/plan.md +0 -152
- package/command/review-codebase.md +0 -228
- package/command/review.md +0 -135
- package/command/vision.md +0 -210
- package/dist/hooks/swarm-enforcer.d.ts +0 -31
- package/dist/hooks/swarm-enforcer.d.ts.map +0 -1
- package/dist/tools/beads-memory-sync.d.ts +0 -17
- package/dist/tools/beads-memory-sync.d.ts.map +0 -1
- package/dist/tools/quick-research.d.ts +0 -16
- package/dist/tools/quick-research.d.ts.map +0 -1
- package/dist/tools/swarm.d.ts +0 -57
- package/dist/tools/swarm.d.ts.map +0 -1
- package/skill/accessibility-audit/SKILL.md +0 -115
- package/skill/beads-bridge/SKILL.md +0 -45
- package/skill/brainstorming/SKILL.md +0 -41
- package/skill/cass-village/SKILL.md +0 -217
- package/skill/cloudflare/SKILL.md +0 -96
- package/skill/design-system-audit/SKILL.md +0 -136
- package/skill/development-lifecycle/SKILL.md +0 -58
- package/skill/dispatching-parallel-agents/SKILL.md +0 -94
- package/skill/figma/SKILL.md +0 -34
- package/skill/frontend-aesthetics/SKILL.md +0 -63
- package/skill/gemini-large-context/SKILL.md +0 -80
- package/skill/mockup-to-code/SKILL.md +0 -98
- package/skill/mqdh/SKILL.md +0 -54
- package/skill/notebooklm/SKILL.md +0 -71
- package/skill/playwriter/SKILL.md +0 -56
- package/skill/polar/SKILL.md +0 -39
- package/skill/resend/SKILL.md +0 -85
- package/skill/sharing-skills/SKILL.md +0 -50
- package/skill/subagent-driven-development/SKILL.md +0 -69
- package/skill/supabase/SKILL.md +0 -80
- package/skill/supabase-postgres-best-practices/SKILL.md +0 -168
- package/skill/swarm-coordination/SKILL.md +0 -54
- package/skill/testing-skills-with-subagents/SKILL.md +0 -102
- package/skill/ui-ux-research/SKILL.md +0 -93
- package/skill/v0/SKILL.md +0 -67
- package/skill/v1-run/SKILL.md +0 -85
- package/skill/visual-analysis/SKILL.md +0 -113
package/command/review.md
DELETED
|
@@ -1,135 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
description: Full code review for quality and correctness.
|
|
3
|
-
agent: review
|
|
4
|
-
subtask: true
|
|
5
|
-
---
|
|
6
|
-
|
|
7
|
-
You are the **Review Agent**. Execute the `/review` command.
|
|
8
|
-
|
|
9
|
-
## Template
|
|
10
|
-
|
|
11
|
-
Use template at: `@.opencode/memory/_templates/review.md`
|
|
12
|
-
|
|
13
|
-
## Your Task
|
|
14
|
-
|
|
15
|
-
Perform a comprehensive code review of recent changes.
|
|
16
|
-
|
|
17
|
-
## Process
|
|
18
|
-
|
|
19
|
-
### 1. Gather Context
|
|
20
|
-
- Load spec.md, plan.md
|
|
21
|
-
- Identify changed files via `git diff` or provided list
|
|
22
|
-
- Read each changed file
|
|
23
|
-
|
|
24
|
-
### 2. Review Checklist
|
|
25
|
-
|
|
26
|
-
**Correctness**
|
|
27
|
-
- [ ] Logic is correct
|
|
28
|
-
- [ ] Edge cases handled
|
|
29
|
-
- [ ] Null/undefined handling
|
|
30
|
-
- [ ] Error handling complete
|
|
31
|
-
|
|
32
|
-
**Security**
|
|
33
|
-
- [ ] No hardcoded secrets
|
|
34
|
-
- [ ] Input validation present
|
|
35
|
-
- [ ] Auth/authz logic correct
|
|
36
|
-
- [ ] No SQL injection/XSS risks
|
|
37
|
-
|
|
38
|
-
**Performance**
|
|
39
|
-
- [ ] No N+1 queries
|
|
40
|
-
- [ ] No memory leaks
|
|
41
|
-
- [ ] Efficient algorithms
|
|
42
|
-
|
|
43
|
-
**Maintainability**
|
|
44
|
-
- [ ] Code is readable
|
|
45
|
-
- [ ] DRY principles followed
|
|
46
|
-
- [ ] Complexity is reasonable
|
|
47
|
-
- [ ] Naming is clear
|
|
48
|
-
|
|
49
|
-
**Testing**
|
|
50
|
-
- [ ] Tests exist for changes
|
|
51
|
-
- [ ] Assertions are meaningful
|
|
52
|
-
- [ ] Coverage is adequate
|
|
53
|
-
|
|
54
|
-
### 3. Issue Severity
|
|
55
|
-
|
|
56
|
-
| Severity | Examples |
|
|
57
|
-
|----------|----------|
|
|
58
|
-
| Critical | Security vuln, data loss risk, logic error causing crashes |
|
|
59
|
-
| High | Auth flaw, unhandled errors, performance bottleneck |
|
|
60
|
-
| Medium | Missing edge case, poor error messages, minor perf issue |
|
|
61
|
-
| Low | Style issues, minor clarity improvements |
|
|
62
|
-
|
|
63
|
-
### 4. Generate Report
|
|
64
|
-
|
|
65
|
-
Save to `.opencode/memory/reviews/YYYY-MM-DD-<feature>-review.md`
|
|
66
|
-
|
|
67
|
-
## Review Report Template
|
|
68
|
-
|
|
69
|
-
```markdown
|
|
70
|
-
---
|
|
71
|
-
type: Code | PRD | Spec | Plan | Security
|
|
72
|
-
date: YYYY-MM-DD
|
|
73
|
-
reviewer: Review Agent
|
|
74
|
-
artifact: [Path to reviewed artifact]
|
|
75
|
-
verdict: approved | changes_required | blocked
|
|
76
|
-
bead_id: [optional]
|
|
77
|
-
task_ids: []
|
|
78
|
-
---
|
|
79
|
-
|
|
80
|
-
# Review: [Feature/PR Name]
|
|
81
|
-
|
|
82
|
-
## Summary
|
|
83
|
-
[2-3 sentence overview]
|
|
84
|
-
|
|
85
|
-
## Findings
|
|
86
|
-
|
|
87
|
-
### Critical (Must Fix Before Approval)
|
|
88
|
-
| ID | Issue | Location | Recommendation |
|
|
89
|
-
|----|-------|----------|----------------|
|
|
90
|
-
| C-01 | [Issue] | [Where] | [Fix] |
|
|
91
|
-
|
|
92
|
-
### High (Should Fix)
|
|
93
|
-
| ID | Issue | Location | Recommendation |
|
|
94
|
-
|----|-------|----------|----------------|
|
|
95
|
-
| H-01 | [Issue] | [Where] | [Fix] |
|
|
96
|
-
|
|
97
|
-
### Medium (Consider Fixing)
|
|
98
|
-
| ID | Issue | Location | Recommendation |
|
|
99
|
-
|----|-------|----------|----------------|
|
|
100
|
-
| M-01 | [Issue] | [Where] | [Fix] |
|
|
101
|
-
|
|
102
|
-
### Low (Optional)
|
|
103
|
-
| ID | Issue | Location | Recommendation |
|
|
104
|
-
|----|-------|----------|----------------|
|
|
105
|
-
| L-01 | [Issue] | [Where] | [Fix] |
|
|
106
|
-
|
|
107
|
-
## Required Changes
|
|
108
|
-
1. [Change 1]
|
|
109
|
-
2. [Change 2]
|
|
110
|
-
|
|
111
|
-
## Suggestions (Optional)
|
|
112
|
-
- [Improvement idea]
|
|
113
|
-
|
|
114
|
-
## Security Checklist
|
|
115
|
-
- [x] No hardcoded secrets
|
|
116
|
-
- [x] Input validation present
|
|
117
|
-
- [x] Auth logic reviewed
|
|
118
|
-
|
|
119
|
-
## Acceptance Criteria Verification
|
|
120
|
-
- [x] AC-01: [Verified]
|
|
121
|
-
- [x] AC-02: [Verified]
|
|
122
|
-
|
|
123
|
-
## Verdict Details
|
|
124
|
-
[Why this verdict was chosen]
|
|
125
|
-
```
|
|
126
|
-
|
|
127
|
-
## Verdict Rules
|
|
128
|
-
|
|
129
|
-
| Verdict | Criteria |
|
|
130
|
-
|---------|----------|
|
|
131
|
-
| `approved` | 0 critical, 0 high, ACs verified |
|
|
132
|
-
| `changes_required` | 0 critical, has high/medium fixable issues |
|
|
133
|
-
| `blocked` | Has critical issues, security vulnerabilities |
|
|
134
|
-
|
|
135
|
-
Now, gathering files to review...
|
package/command/vision.md
DELETED
|
@@ -1,210 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
description: Design and implement UI from prompts, images, or wireframes. Variant exploration, iterative refinement, pixel-perfect code.
|
|
3
|
-
agent: vision
|
|
4
|
-
subtask: true
|
|
5
|
-
---
|
|
6
|
-
|
|
7
|
-
You are the **Vision Agent**. Execute the `/vision` command.
|
|
8
|
-
|
|
9
|
-
## Input Modes
|
|
10
|
-
|
|
11
|
-
| Mode | Trigger | Pipeline |
|
|
12
|
-
|------|---------|----------|
|
|
13
|
-
| **Text-to-UI** | Text description of desired UI | Explore → Variants → Pick → Implement |
|
|
14
|
-
| **Image-to-UI** | Screenshot or mockup attached | Analyze → Extract tokens → Variants → Implement |
|
|
15
|
-
| **Wireframe-to-UI** | Sketch or low-fi wireframe | Interpret structure → Add design → Implement |
|
|
16
|
-
| **Redesign** | "Redesign this component/page" | Audit current → Variants → Implement |
|
|
17
|
-
| **Review** | "Review UI quality" | Audit → Report (see Review Process below) |
|
|
18
|
-
|
|
19
|
-
## Process
|
|
20
|
-
|
|
21
|
-
### 1. Detect Input & Explore (parallel)
|
|
22
|
-
|
|
23
|
-
Classify input type, then fire immediately:
|
|
24
|
-
|
|
25
|
-
```
|
|
26
|
-
Explore: "Find existing design system — CSS variables, tokens, theme config, color palette, typography. Return file paths + values."
|
|
27
|
-
Explore: "Find existing UI components — naming, props, composition, styling approach. Compare 2-3 components."
|
|
28
|
-
Explore: "Find package.json — CSS framework, component lib, icon set, fonts in use."
|
|
29
|
-
```
|
|
30
|
-
|
|
31
|
-
If image attached, simultaneously extract:
|
|
32
|
-
- Color palette (hex + roles)
|
|
33
|
-
- Typography (fonts, scale, weights)
|
|
34
|
-
- Spacing system (base unit, rhythm)
|
|
35
|
-
- Component inventory
|
|
36
|
-
- Layout structure (grid, columns)
|
|
37
|
-
- Visual effects (shadows, radii, gradients)
|
|
38
|
-
|
|
39
|
-
### 2. Variant Exploration
|
|
40
|
-
|
|
41
|
-
Present 2-3 design directions. Each variant:
|
|
42
|
-
|
|
43
|
-
```markdown
|
|
44
|
-
### Variant [A/B/C]: [Name]
|
|
45
|
-
|
|
46
|
-
**Direction:** [Aesthetic approach]
|
|
47
|
-
**Layout:** [Structure description]
|
|
48
|
-
**Colors:** [Palette strategy]
|
|
49
|
-
**Typography:** [Font pairing]
|
|
50
|
-
**Key Differentiator:** [What's memorable]
|
|
51
|
-
**Components:** [List with brief design notes]
|
|
52
|
-
```
|
|
53
|
-
|
|
54
|
-
For image-to-UI, present:
|
|
55
|
-
1. **Faithful** — Match source closely
|
|
56
|
-
2. **Enhanced** — Keep structure, improve polish/a11y
|
|
57
|
-
3. **Adapted** — Keep essence, fit project's design system
|
|
58
|
-
|
|
59
|
-
Wait for user selection. If user said "just do it", pick the most distinctive option that fits existing patterns.
|
|
60
|
-
|
|
61
|
-
### 3. Resolve Design Tokens
|
|
62
|
-
|
|
63
|
-
Before coding, resolve all tokens against project's existing system:
|
|
64
|
-
- Colors (primary, secondary, accent, semantic)
|
|
65
|
-
- Typography (display font, body font, scale ratio)
|
|
66
|
-
- Spacing (base unit, scale)
|
|
67
|
-
- Radii, shadows, transitions
|
|
68
|
-
|
|
69
|
-
**Use existing tokens if they exist. Define new ones only if needed.**
|
|
70
|
-
|
|
71
|
-
### 4. Implement
|
|
72
|
-
|
|
73
|
-
Build in this order:
|
|
74
|
-
1. Tokens / theme config (if new)
|
|
75
|
-
2. Layout shell (semantic HTML)
|
|
76
|
-
3. Core components (atoms → molecules → organisms)
|
|
77
|
-
4. Content with realistic placeholders
|
|
78
|
-
5. Interactive states (hover, focus, active, disabled, loading, error, empty)
|
|
79
|
-
6. Responsive (mobile-first, clamp/min/max)
|
|
80
|
-
7. Accessibility (ARIA, focus, contrast, reduced motion)
|
|
81
|
-
8. Motion & polish (transitions, micro-interactions)
|
|
82
|
-
|
|
83
|
-
### 5. Self-Review
|
|
84
|
-
|
|
85
|
-
Before presenting, verify:
|
|
86
|
-
- [ ] Matches chosen variant direction
|
|
87
|
-
- [ ] Responsive at 375px, 768px, 1024px, 1440px
|
|
88
|
-
- [ ] WCAG AA contrast (4.5:1 text, 3:1 large text)
|
|
89
|
-
- [ ] All interactive states implemented
|
|
90
|
-
- [ ] `prefers-reduced-motion` respected
|
|
91
|
-
- [ ] Semantic HTML (button, nav, main, aside)
|
|
92
|
-
- [ ] No hardcoded values — all use tokens/variables
|
|
93
|
-
- [ ] Follows project's existing code conventions
|
|
94
|
-
- [ ] No generic AI aesthetic (Inter, purple gradients)
|
|
95
|
-
|
|
96
|
-
Fix failures before presenting.
|
|
97
|
-
|
|
98
|
-
### 6. Iterate
|
|
99
|
-
|
|
100
|
-
When user requests changes:
|
|
101
|
-
1. Scope: Token-level (global) or component-level (local)?
|
|
102
|
-
2. Apply surgically — minimum file edits
|
|
103
|
-
3. Propagate token changes across all affected components
|
|
104
|
-
4. Re-verify changed components
|
|
105
|
-
|
|
106
|
-
---
|
|
107
|
-
|
|
108
|
-
## Review Process (audit mode)
|
|
109
|
-
|
|
110
|
-
When reviewing existing UI:
|
|
111
|
-
|
|
112
|
-
### Design Quality
|
|
113
|
-
|
|
114
|
-
| Aspect | Check |
|
|
115
|
-
|--------|-------|
|
|
116
|
-
| Typography | Font choices, hierarchy, readability, line-height |
|
|
117
|
-
| Color | Palette consistency, contrast, semantic usage |
|
|
118
|
-
| Spacing | Consistent rhythm, tokens used, padding/margins |
|
|
119
|
-
| Layout | Grid alignment, responsive, overflow |
|
|
120
|
-
| Motion | Appropriate animations, reduced motion |
|
|
121
|
-
| Consistency | Components match existing patterns |
|
|
122
|
-
| Aesthetic | Distinctive direction vs generic AI slop |
|
|
123
|
-
|
|
124
|
-
### Accessibility Audit
|
|
125
|
-
|
|
126
|
-
| Check | Standard |
|
|
127
|
-
|-------|----------|
|
|
128
|
-
| Color contrast | WCAG AA (4.5:1 text, 3:1 large text) |
|
|
129
|
-
| Focus indicators | Visible, styled, keyboard-navigable |
|
|
130
|
-
| ARIA | Labels, roles, states for interactive elements |
|
|
131
|
-
| Semantic HTML | Proper elements (button, nav, main, aside) |
|
|
132
|
-
| Touch targets | Minimum 44x44px on mobile |
|
|
133
|
-
| Reduced motion | `prefers-reduced-motion` media query |
|
|
134
|
-
|
|
135
|
-
### Responsive Check
|
|
136
|
-
|
|
137
|
-
Breakpoints: 375px, 768px, 1024px, 1440px
|
|
138
|
-
Look for: overflow, illegible text, touch targets, layout breakage
|
|
139
|
-
|
|
140
|
-
### Generate Report
|
|
141
|
-
|
|
142
|
-
Save to `.opencode/memory/reviews/YYYY-MM-DD-ui-review.md`:
|
|
143
|
-
|
|
144
|
-
```markdown
|
|
145
|
-
---
|
|
146
|
-
type: UI
|
|
147
|
-
date: YYYY-MM-DD
|
|
148
|
-
reviewer: Vision Agent
|
|
149
|
-
artifact: [paths reviewed]
|
|
150
|
-
verdict: approved | changes_required | blocked
|
|
151
|
-
---
|
|
152
|
-
|
|
153
|
-
# UI Review: [Feature/Component]
|
|
154
|
-
|
|
155
|
-
## Summary
|
|
156
|
-
[2-3 sentences]
|
|
157
|
-
|
|
158
|
-
## Design Quality
|
|
159
|
-
| Aspect | Rating | Notes |
|
|
160
|
-
|--------|--------|-------|
|
|
161
|
-
| Typography | ✅/⚠️/❌ | [Details] |
|
|
162
|
-
| Color | ✅/⚠️/❌ | [Details] |
|
|
163
|
-
| Spacing | ✅/⚠️/❌ | [Details] |
|
|
164
|
-
| Layout | ✅/⚠️/❌ | [Details] |
|
|
165
|
-
| Motion | ✅/⚠️/❌ | [Details] |
|
|
166
|
-
| Aesthetic | ✅/⚠️/❌ | [Distinctive or generic?] |
|
|
167
|
-
|
|
168
|
-
## Accessibility
|
|
169
|
-
| Check | Pass | Notes |
|
|
170
|
-
|-------|------|-------|
|
|
171
|
-
| Contrast | ✅/❌ | [Ratio] |
|
|
172
|
-
| Focus | ✅/❌ | [Details] |
|
|
173
|
-
| ARIA | ✅/❌ | [Missing attrs] |
|
|
174
|
-
| Semantic HTML | ✅/❌ | [Details] |
|
|
175
|
-
|
|
176
|
-
## Responsive
|
|
177
|
-
| Breakpoint | Status | Issues |
|
|
178
|
-
|------------|--------|--------|
|
|
179
|
-
| 375px | ✅/❌ | [Issues] |
|
|
180
|
-
| 768px | ✅/❌ | [Issues] |
|
|
181
|
-
| 1024px | ✅/❌ | [Issues] |
|
|
182
|
-
|
|
183
|
-
## Required Changes
|
|
184
|
-
1. [Change with file:line reference]
|
|
185
|
-
|
|
186
|
-
## Verdict
|
|
187
|
-
[Why this verdict]
|
|
188
|
-
```
|
|
189
|
-
|
|
190
|
-
| Verdict | Criteria |
|
|
191
|
-
|---------|----------|
|
|
192
|
-
| `approved` | No a11y issues, responsive OK, design consistent, distinctive aesthetic |
|
|
193
|
-
| `changes_required` | A11y issues OR responsive breakage OR generic aesthetic |
|
|
194
|
-
| `blocked` | Critical a11y failures, major design system violations |
|
|
195
|
-
|
|
196
|
-
## Rules
|
|
197
|
-
|
|
198
|
-
- ✅ ALWAYS explore existing design system first
|
|
199
|
-
- ✅ ALWAYS present variant options before implementing
|
|
200
|
-
- ✅ ALWAYS extract tokens from images before coding
|
|
201
|
-
- ✅ ALWAYS check accessibility (non-negotiable)
|
|
202
|
-
- ✅ ALWAYS check responsive behavior
|
|
203
|
-
- ✅ ALWAYS use semantic HTML
|
|
204
|
-
- ✅ ALWAYS commit to a distinctive aesthetic direction
|
|
205
|
-
- ❌ NEVER jump to code without variant exploration
|
|
206
|
-
- ❌ NEVER use generic AI aesthetic (Inter, purple gradients, 3-col cards)
|
|
207
|
-
- ❌ NEVER hardcode colors, spacing, or fonts
|
|
208
|
-
- ❌ NEVER approve with accessibility failures
|
|
209
|
-
- ❌ NEVER skip responsive verification
|
|
210
|
-
- ❌ NEVER mix conflicting aesthetic directions
|
|
@@ -1,31 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Swarm Enforcer Hook
|
|
3
|
-
*
|
|
4
|
-
* Enforces task isolation for worker agents in multi-agent swarms.
|
|
5
|
-
* Prevents agents from editing files outside their assigned scope,
|
|
6
|
-
* ensures claimed tasks are completed, and blocks cross-task interference.
|
|
7
|
-
* Runs on tool.execute.before for edit/write/bash tools.
|
|
8
|
-
*/
|
|
9
|
-
export interface SwarmEnforcerConfig {
|
|
10
|
-
enabled?: boolean;
|
|
11
|
-
strict_file_locking?: boolean;
|
|
12
|
-
block_unreserved_edits?: boolean;
|
|
13
|
-
log?: boolean;
|
|
14
|
-
}
|
|
15
|
-
export interface TaskScope {
|
|
16
|
-
taskId: string;
|
|
17
|
-
agentId: string;
|
|
18
|
-
reservedFiles: string[];
|
|
19
|
-
allowedPatterns?: string[];
|
|
20
|
-
}
|
|
21
|
-
export interface EnforcementResult {
|
|
22
|
-
allowed: boolean;
|
|
23
|
-
file?: string;
|
|
24
|
-
reason?: string;
|
|
25
|
-
suggestion?: string;
|
|
26
|
-
}
|
|
27
|
-
export declare function isFileInScope(filePath: unknown, scope: TaskScope): boolean;
|
|
28
|
-
export declare function checkEditPermission(filePath: unknown, scope: TaskScope | undefined, config?: SwarmEnforcerConfig): EnforcementResult;
|
|
29
|
-
export declare function extractFileFromToolInput(toolName: unknown, input: Record<string, unknown>): string | undefined;
|
|
30
|
-
export declare function formatEnforcementWarning(result: EnforcementResult): string;
|
|
31
|
-
//# sourceMappingURL=swarm-enforcer.d.ts.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"swarm-enforcer.d.ts","sourceRoot":"","sources":["../../src/hooks/swarm-enforcer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,OAAO,EACjB,KAAK,EAAE,SAAS,GACf,OAAO,CAsBT;AAED,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,OAAO,EACjB,KAAK,EAAE,SAAS,GAAG,SAAS,EAC5B,MAAM,CAAC,EAAE,mBAAmB,GAC3B,iBAAiB,CAyBnB;AAED,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,OAAO,EACjB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,MAAM,GAAG,SAAS,CA6BpB;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,CAM1E"}
|
|
@@ -1,17 +0,0 @@
|
|
|
1
|
-
export interface BeadsMemorySyncParams {
|
|
2
|
-
operation: "sync_to_memory" | "sync_from_memory" | "link" | "status";
|
|
3
|
-
beadId?: string;
|
|
4
|
-
observationId?: number;
|
|
5
|
-
}
|
|
6
|
-
export interface BeadsMemorySyncResult {
|
|
7
|
-
success: boolean;
|
|
8
|
-
operation: string;
|
|
9
|
-
details: {
|
|
10
|
-
tasksSynced?: number;
|
|
11
|
-
observationsLinked?: number;
|
|
12
|
-
memoryCount?: number;
|
|
13
|
-
activeTasks?: number;
|
|
14
|
-
};
|
|
15
|
-
}
|
|
16
|
-
export declare function beadsMemorySync(params: unknown): BeadsMemorySyncResult;
|
|
17
|
-
//# sourceMappingURL=beads-memory-sync.d.ts.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"beads-memory-sync.d.ts","sourceRoot":"","sources":["../../src/tools/beads-memory-sync.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,gBAAgB,GAAG,kBAAkB,GAAG,MAAM,GAAG,QAAQ,CAAC;IACrE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE;QACP,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;CACH;AAcD,wBAAgB,eAAe,CAAC,MAAM,EAAE,OAAO,GAAG,qBAAqB,CAwBtE"}
|
|
@@ -1,16 +0,0 @@
|
|
|
1
|
-
import { type MemorySearchResult } from "./memory";
|
|
2
|
-
export interface QuickResearchParams {
|
|
3
|
-
query: string;
|
|
4
|
-
sources?: ("memory" | "context7" | "github")[];
|
|
5
|
-
language?: string;
|
|
6
|
-
limit?: number;
|
|
7
|
-
}
|
|
8
|
-
export interface QuickResearchResult {
|
|
9
|
-
query: string;
|
|
10
|
-
memory?: MemorySearchResult[];
|
|
11
|
-
context7Hint?: string;
|
|
12
|
-
githubHint?: string;
|
|
13
|
-
suggestion: string;
|
|
14
|
-
}
|
|
15
|
-
export declare function quickResearch(params: unknown): QuickResearchResult;
|
|
16
|
-
//# sourceMappingURL=quick-research.d.ts.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"quick-research.d.ts","sourceRoot":"","sources":["../../src/tools/quick-research.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAEjE,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,CAAC,QAAQ,GAAG,UAAU,GAAG,QAAQ,CAAC,EAAE,CAAC;IAC/C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,OAAO,GAAG,mBAAmB,CAgDlE"}
|
package/dist/tools/swarm.d.ts
DELETED
|
@@ -1,57 +0,0 @@
|
|
|
1
|
-
export interface SwarmPlanParams {
|
|
2
|
-
operation: "plan";
|
|
3
|
-
tasks: SwarmTask[];
|
|
4
|
-
parallelism?: number;
|
|
5
|
-
}
|
|
6
|
-
export interface SwarmMonitorParams {
|
|
7
|
-
operation: "monitor";
|
|
8
|
-
taskId?: string;
|
|
9
|
-
}
|
|
10
|
-
export interface SwarmDelegateParams {
|
|
11
|
-
operation: "delegate";
|
|
12
|
-
taskId: string;
|
|
13
|
-
agentRole: "fe" | "be" | "mobile" | "devops" | "qa";
|
|
14
|
-
}
|
|
15
|
-
export interface SwarmAbortParams {
|
|
16
|
-
operation: "abort";
|
|
17
|
-
taskId: string;
|
|
18
|
-
reason: string;
|
|
19
|
-
}
|
|
20
|
-
export type SwarmParams = SwarmPlanParams | SwarmMonitorParams | SwarmDelegateParams | SwarmAbortParams;
|
|
21
|
-
export interface SwarmTask {
|
|
22
|
-
id: string;
|
|
23
|
-
title: string;
|
|
24
|
-
description: string;
|
|
25
|
-
dependencies?: string[];
|
|
26
|
-
agentRole?: "fe" | "be" | "mobile" | "devops" | "qa";
|
|
27
|
-
files?: string[];
|
|
28
|
-
status: "pending" | "in_progress" | "completed" | "failed" | "blocked";
|
|
29
|
-
}
|
|
30
|
-
export interface SwarmPlanResult {
|
|
31
|
-
planId: string;
|
|
32
|
-
tasks: SwarmTask[];
|
|
33
|
-
parallelism: number;
|
|
34
|
-
estimatedTime: string;
|
|
35
|
-
}
|
|
36
|
-
export interface SwarmMonitorResult {
|
|
37
|
-
planId: string;
|
|
38
|
-
totalTasks: number;
|
|
39
|
-
completed: number;
|
|
40
|
-
inProgress: number;
|
|
41
|
-
pending: number;
|
|
42
|
-
failed: number;
|
|
43
|
-
tasks: SwarmTask[];
|
|
44
|
-
}
|
|
45
|
-
export interface SwarmDelegateResult {
|
|
46
|
-
taskId: string;
|
|
47
|
-
delegatedTo: string;
|
|
48
|
-
status: string;
|
|
49
|
-
}
|
|
50
|
-
export interface SwarmAbortResult {
|
|
51
|
-
taskId: string;
|
|
52
|
-
aborted: boolean;
|
|
53
|
-
reason: string;
|
|
54
|
-
}
|
|
55
|
-
export type SwarmResult = SwarmPlanResult | SwarmMonitorResult | SwarmDelegateResult | SwarmAbortResult;
|
|
56
|
-
export declare function swarm(params: unknown): SwarmResult;
|
|
57
|
-
//# sourceMappingURL=swarm.d.ts.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"swarm.d.ts","sourceRoot":"","sources":["../../src/tools/swarm.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,SAAS,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,UAAU,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,IAAI,GAAG,IAAI,GAAG,QAAQ,GAAG,QAAQ,GAAG,IAAI,CAAC;CACrD;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,WAAW,GAAG,eAAe,GAAG,kBAAkB,GAAG,mBAAmB,GAAG,gBAAgB,CAAC;AAExG,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,SAAS,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,QAAQ,GAAG,QAAQ,GAAG,IAAI,CAAC;IACrD,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,EAAE,SAAS,GAAG,aAAa,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;CACxE;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,SAAS,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,WAAW,GAAG,eAAe,GAAG,kBAAkB,GAAG,mBAAmB,GAAG,gBAAgB,CAAC;AAcxG,wBAAgB,KAAK,CAAC,MAAM,EAAE,OAAO,GAAG,WAAW,CAkBlD"}
|
|
@@ -1,115 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: accessibility-audit
|
|
3
|
-
description: Use when verifying WCAG compliance, checking keyboard navigation, color contrast, or screen reader compatibility.
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
# Accessibility Audit Skill
|
|
7
|
-
|
|
8
|
-
You are running the **accessibility-audit** skill. No barriers. Full access.
|
|
9
|
-
|
|
10
|
-
## WCAG Levels
|
|
11
|
-
|
|
12
|
-
| Level | Coverage | Use Case |
|
|
13
|
-
|-------|----------|----------|
|
|
14
|
-
| A | Minimum | Legal baseline |
|
|
15
|
-
| AA | Standard | Most regulations |
|
|
16
|
-
| AAA | Enhanced | Maximum accessibility |
|
|
17
|
-
|
|
18
|
-
## Audit Categories
|
|
19
|
-
|
|
20
|
-
### 1. Color Contrast
|
|
21
|
-
|
|
22
|
-
```bash
|
|
23
|
-
# Check contrast ratios
|
|
24
|
-
gemini -p "Analyze color contrast in this UI for WCAG AA compliance: $(cat ui.png)"
|
|
25
|
-
```
|
|
26
|
-
|
|
27
|
-
Requirements:
|
|
28
|
-
- Normal text: 4.5:1 minimum
|
|
29
|
-
- Large text: 3:1 minimum
|
|
30
|
-
- UI components: 3:1 minimum
|
|
31
|
-
|
|
32
|
-
### 2. Keyboard Navigation
|
|
33
|
-
|
|
34
|
-
Test checklist:
|
|
35
|
-
- [ ] All interactive elements focusable
|
|
36
|
-
- [ ] Focus order matches visual order
|
|
37
|
-
- [ ] Focus visible indicator present
|
|
38
|
-
- [ ] No keyboard traps
|
|
39
|
-
- [ ] Skip links provided
|
|
40
|
-
- [ ] Modal focus management
|
|
41
|
-
|
|
42
|
-
### 3. Screen Reader Compatibility
|
|
43
|
-
|
|
44
|
-
Test with:
|
|
45
|
-
- VoiceOver (Mac/iOS)
|
|
46
|
-
- NVDA (Windows)
|
|
47
|
-
- TalkBack (Android)
|
|
48
|
-
|
|
49
|
-
Check:
|
|
50
|
-
- [ ] All images have alt text
|
|
51
|
-
- [ ] Headings hierarchy correct (h1→h2→h3)
|
|
52
|
-
- [ ] Landmarks properly labeled
|
|
53
|
-
- [ ] Form labels associated
|
|
54
|
-
- [ ] ARIA attributes correct
|
|
55
|
-
- [ ] Dynamic content announced
|
|
56
|
-
|
|
57
|
-
### 4. Semantic Structure
|
|
58
|
-
|
|
59
|
-
```html
|
|
60
|
-
<!-- Good -->
|
|
61
|
-
<nav aria-label="Main navigation">...</nav>
|
|
62
|
-
<main>...</main>
|
|
63
|
-
<article>...</article>
|
|
64
|
-
<aside aria-label="Related content">...</aside>
|
|
65
|
-
|
|
66
|
-
<!-- Bad -->
|
|
67
|
-
<div class="nav">...</div>
|
|
68
|
-
<div class="main">...</div>
|
|
69
|
-
```
|
|
70
|
-
|
|
71
|
-
### 5. Forms
|
|
72
|
-
|
|
73
|
-
- [ ] All inputs have associated labels
|
|
74
|
-
- [ ] Error messages linked to inputs
|
|
75
|
-
- [ ] Required fields indicated
|
|
76
|
-
- [ ] Validation errors announced
|
|
77
|
-
- [ ] Instructions provided before inputs
|
|
78
|
-
|
|
79
|
-
## Pre-Launch Verification
|
|
80
|
-
|
|
81
|
-
### Automated Testing
|
|
82
|
-
```bash
|
|
83
|
-
# Lighthouse
|
|
84
|
-
npx lighthouse URL --only-categories=accessibility
|
|
85
|
-
|
|
86
|
-
# axe-core
|
|
87
|
-
npx axe URL
|
|
88
|
-
```
|
|
89
|
-
|
|
90
|
-
### Manual Testing
|
|
91
|
-
- [ ] Keyboard-only navigation complete
|
|
92
|
-
- [ ] Screen reader test (2+ browsers)
|
|
93
|
-
- [ ] Zoom to 200% without horizontal scroll
|
|
94
|
-
- [ ] High contrast mode usable
|
|
95
|
-
- [ ] Reduced motion preference respected
|
|
96
|
-
|
|
97
|
-
## Checklist
|
|
98
|
-
|
|
99
|
-
- [ ] Color contrast: All text meets AA
|
|
100
|
-
- [ ] Keyboard: Full navigation possible
|
|
101
|
-
- [ ] Screen reader: All content accessible
|
|
102
|
-
- [ ] Semantic: Proper HTML structure
|
|
103
|
-
- [ ] Forms: Labels and errors accessible
|
|
104
|
-
- [ ] Motion: Reduced motion supported
|
|
105
|
-
- [ ] Zoom: 200% without horizontal scroll
|
|
106
|
-
|
|
107
|
-
## Red Flags
|
|
108
|
-
|
|
109
|
-
- Color-only information conveyance
|
|
110
|
-
- Missing alt text on meaningful images
|
|
111
|
-
- Empty or generic link text ("click here")
|
|
112
|
-
- Keyboard traps in modals/menus
|
|
113
|
-
- Auto-playing media
|
|
114
|
-
- Flashing content >3 times/second
|
|
115
|
-
- Timeouts without warning/extension
|
|
@@ -1,45 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: beads-bridge
|
|
3
|
-
description: Use to bridge beads git-backed tasks with OpenCode's native todo system for cross-session coordination.
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
# Beads Bridge Skill
|
|
7
|
-
|
|
8
|
-
You are running the **beads-bridge** skill. Bridge between beads git-backed tasks and OpenCode todos.
|
|
9
|
-
|
|
10
|
-
## Purpose
|
|
11
|
-
|
|
12
|
-
Enables coordination between:
|
|
13
|
-
- **Beads git-backed tasks**: Persistent tasks in `.beads/` directory
|
|
14
|
-
- **OpenCode native todos**: Session-native task list
|
|
15
|
-
|
|
16
|
-
## Bridging Operations
|
|
17
|
-
|
|
18
|
-
| Action | Description |
|
|
19
|
-
|--------|-------------|
|
|
20
|
-
| Sync todos | Import beads tasks to OpenCode todo list |
|
|
21
|
-
| Export progress | Push OpenCode completions to beads |
|
|
22
|
-
| Cross-session | Maintain state across agent sessions |
|
|
23
|
-
| Swarm view | Unified task view for multiple agents |
|
|
24
|
-
|
|
25
|
-
## Workflow
|
|
26
|
-
|
|
27
|
-
1. Load beads state from `.beads/`
|
|
28
|
-
2. Bridge imports ready tasks to native todos
|
|
29
|
-
3. Work on tasks using native tools
|
|
30
|
-
4. Bridge syncs completions back to beads
|
|
31
|
-
5. Other agents see progress via beads git-backed tasks
|
|
32
|
-
|
|
33
|
-
## Use Cases
|
|
34
|
-
|
|
35
|
-
- Multi-agent swarms sharing a task backlog
|
|
36
|
-
- Long-running projects with session breaks
|
|
37
|
-
- Cross-workspace coordination
|
|
38
|
-
- Human review integration
|
|
39
|
-
|
|
40
|
-
## Best Practices
|
|
41
|
-
|
|
42
|
-
- Run bridge sync at session start and end
|
|
43
|
-
- Use beads git-backed tasks for persistent storage
|
|
44
|
-
- Use native todos for active work tracking
|
|
45
|
-
- Keep task titles consistent across systems
|
|
@@ -1,41 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: brainstorming
|
|
3
|
-
description: Use when starting a new feature or project without clear requirements. Activates before writing code.
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
# Brainstorming Skill
|
|
7
|
-
|
|
8
|
-
You are running the **brainstorming** skill. Your goal is to tease out requirements through iterative questioning.
|
|
9
|
-
|
|
10
|
-
## Process
|
|
11
|
-
|
|
12
|
-
1. **One question at a time** — Never ask multiple questions in one message
|
|
13
|
-
2. **Multiple choice preferred** — Offer 2-4 options when possible
|
|
14
|
-
3. **Build on answers** — Each question should refine understanding
|
|
15
|
-
4. **Explore alternatives** — Don't assume the first approach is best
|
|
16
|
-
|
|
17
|
-
## Question Types
|
|
18
|
-
|
|
19
|
-
| Type | When to Use | Example |
|
|
20
|
-
|------|-------------|---------|
|
|
21
|
-
| Clarification | Vague requirement | "Should this be real-time or batch?" |
|
|
22
|
-
| Trade-off | Multiple valid approaches | "Prefer speed or memory efficiency?" |
|
|
23
|
-
| Boundary | Scope unclear | "Should this handle X case?" |
|
|
24
|
-
| Priority | Too many features | "Which matters more: A or B?" |
|
|
25
|
-
|
|
26
|
-
## Red Flags to Avoid
|
|
27
|
-
|
|
28
|
-
- Jumping to implementation
|
|
29
|
-
- Assuming requirements
|
|
30
|
-
- Skipping the "why"
|
|
31
|
-
- Not exploring alternatives
|
|
32
|
-
|
|
33
|
-
## Exit Criteria
|
|
34
|
-
|
|
35
|
-
Stop brainstorming when:
|
|
36
|
-
- Requirements are specific and bounded
|
|
37
|
-
- Acceptance criteria are clear
|
|
38
|
-
- Technical approach is decided
|
|
39
|
-
- User says "that's all"
|
|
40
|
-
|
|
41
|
-
Then transition to writing-plans or development-lifecycle.
|