clikit-plugin 0.1.0

package/memory/_templates/research.md

@@ -0,0 +1,108 @@
+# Research Template
+
+Use this template when documenting research findings.
+
+**Output path:** `.opencode/memory/research/YYYY-MM-DD-<topic>.md`
+
+---
+
+```markdown
+---
+topic: [Topic Name]
+date: YYYY-MM-DD
+confidence: high | medium | low
+depth: quick | standard | deep
+versions:
+  - library: "[name]"
+    version: "[version]"
+bead_id: [optional]
+---
+
+# Research: [Topic]
+
+**Question:** [Original research question]
+
+---
+
+## Summary
+
+[2-3 sentence answer to the research question]
+
+---
+
+## Key Findings
+
+### Finding 1: [Title]
+[Details]
+
+### Finding 2: [Title]
+[Details]
+
+### Finding 3: [Title]
+[Details]
+
+---
+
+## Comparison (if applicable)
+
+| Option | Pros | Cons | Best For |
+|--------|------|------|----------|
+| [Option A] | [Pros] | [Cons] | [Use case] |
+| [Option B] | [Pros] | [Cons] | [Use case] |
+
+---
+
+## Code Examples
+
+### Example 1: [Title]
+```[language]
+// Code example
+```
+
+### Example 2: [Title]
+```[language]
+// Code example
+```
+
+---
+
+## Recommendation
+
+**Recommended approach:** [What to use/do]
+
+**Rationale:**
+1. [Reason 1]
+2. [Reason 2]
+
+---
+
+## Verification Steps
+
+- [ ] [Item to verify in implementation]
+- [ ] [Test with specific scenario]
+
+---
+
+## Open Questions
+
+- [ ] [Unanswered question 1]
+- [ ] [Unanswered question 2]
+
+---
+
+## Sources
+
+| Source | Type | Reliability |
+|--------|------|-------------|
+| [URL/Title] | Official Docs | High |
+| [URL/Title] | GitHub | Medium |
+| [URL/Title] | Blog/Article | Low |
+
+---
+
+## Version Notes
+
+| Library/Tool | Version Researched | Current Latest | Notes |
+|--------------|-------------------|----------------|-------|
+| [Name] | [v1.2.3] | [v1.2.5] | [Any version-specific notes] |
+```

package/memory/_templates/review.md

@@ -0,0 +1,117 @@
+# Review Template
+
+Use this template when reviewing code, PRDs, specs, or plans.
+
+**Output path:** `.opencode/memory/reviews/YYYY-MM-DD-<subject>-review.md`
+
+---
+
+```markdown
+---
+type: Code | PRD | Spec | Plan | Security
+date: YYYY-MM-DD
+reviewer: [Name/Agent]
+artifact: [Path to reviewed artifact]
+verdict: approved | changes_required | blocked
+bead_id: [optional]
+task_ids: []
+---
+
+# Review: [Subject Name]
+
+---
+
+## Summary
+
+[2-3 sentences on overall quality and readiness]
+
+---
+
+## Checklist
+
+### Completeness
+- [ ] All required sections present
+- [ ] Acceptance criteria defined
+- [ ] Dependencies identified
+
+### Clarity
+- [ ] No ambiguous language
+- [ ] Technical terms explained
+- [ ] Scope boundaries clear
+
+### Correctness
+- [ ] Logic is sound
+- [ ] No obvious errors
+- [ ] Edge cases considered
+
+### Quality
+- [ ] Follows conventions
+- [ ] Well-structured
+- [ ] Maintainable
+
+---
+
+## Findings
+
+### Critical (Must Fix Before Approval)
+| ID | Issue | Location | Recommendation |
+|----|-------|----------|----------------|
+| C-01 | [Issue] | [Where] | [Fix] |
+
+### High (Should Fix)
+| ID | Issue | Location | Recommendation |
+|----|-------|----------|----------------|
+| H-01 | [Issue] | [Where] | [Fix] |
+
+### Medium (Consider Fixing)
+| ID | Issue | Location | Recommendation |
+|----|-------|----------|----------------|
+| M-01 | [Issue] | [Where] | [Fix] |
+
+### Low (Optional)
+| ID | Issue | Location | Recommendation |
+|----|-------|----------|----------------|
+| L-01 | [Issue] | [Where] | [Fix] |
+
+---
+
+## Strengths
+
+1. ✅ [Strength 1]
+2. ✅ [Strength 2]
+
+---
+
+## Questions
+
+1. ❓ [Question 1]
+2. ❓ [Question 2]
+
+---
+
+## Verdict Details
+
+### ✅ Approved
+Ready to proceed. [Optional notes]
+
+### ⚠️ Changes Required
+**Required before approval:**
+1. [ ] [Change 1]
+2. [ ] [Change 2]
+
+**Re-review needed:** Yes | No
+
+### ❌ Blocked
+**Blocking issues:**
+- [Critical issue preventing approval]
+
+**Recommended action:**
+- [What needs to happen]
+
+---
+
+## Next Steps
+
+1. [ ] [Action 1]
+2. [ ] [Action 2]
+```

package/memory/_templates/spec.md

@@ -0,0 +1,116 @@
+# Spec Template
+
+Use this template when creating specifications.
+
+**Output path:** `.opencode/memory/specs/YYYY-MM-DD-<descriptor>.md`
+
+---
+
+```markdown
+# Specification: [Title]
+
+**Date:** YYYY-MM-DD
+**Author:** [Name]
+**Status:** Draft | Confirmed
+**bead_id:** [ID]
+
+---
+
+## Problem & Context
+
+### Problem Statement
+[Why is this needed?]
+
+### Background
+[Context and history]
+
+### Who is Affected
+[Stakeholders and users impacted]
+
+---
+
+## Outcomes
+
+### Success Criteria
+1. [Measurable outcome 1]
+2. [Measurable outcome 2]
+
+### Key Results
+| Outcome | Metric | Target |
+|---------|--------|--------|
+| [Outcome] | [How to measure] | [Target value] |
+
+---
+
+## Scope
+
+### In Scope
+- [Feature/capability 1]
+- [Feature/capability 2]
+
+### Out of Scope
+- [Excluded item 1]
+- [Excluded item 2]
+
+### Boundaries
+[Clear boundaries of what this spec covers]
+
+---
+
+## Users
+
+### Primary Users
+| User Type | Description | Needs |
+|-----------|-------------|-------|
+| [Type] | [Who they are] | [What they need] |
+
+### Secondary Users
+| User Type | Description | Needs |
+|-----------|-------------|-------|
+
+---
+
+## Constraints
+
+### Technical Constraints
+- [Constraint 1]
+
+### Business Constraints
+- [Timeline, budget, etc.]
+
+### Dependencies
+| Dependency | Type | Status |
+|------------|------|--------|
+| [Dependency] | Blocking/Soft | Ready/Pending |
+
+---
+
+## Acceptance Criteria
+
+| ID | Criteria | Verification |
+|----|----------|--------------|
+| AC-01 | [Criteria] | [How to verify] |
+| AC-02 | [Criteria] | [How to verify] |
+
+---
+
+## Assumptions
+
+| ID | Assumption | Status | Notes |
+|----|------------|--------|-------|
+| A-01 | [Assumption] | Confirmed/Unconfirmed | [Notes] |
+
+---
+
+## Open Questions
+
+- [ ] [Question 1]
+- [ ] [Question 2]
+
+---
+
+## References
+
+- [Link to related docs]
+- [Link to research]
+```

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "clikit-plugin",
+  "version": "0.1.0",
+  "description": "OpenCode plugin with 10 agents, 19 commands, 48 skills, 14 hooks",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "clikit": "./dist/cli.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./schema.json": "./dist/clikit.schema.json"
+  },
+  "files": [
+    "dist",
+    "src/agents",
+    "skill",
+    "command",
+    "memory",
+    "AGENTS.md"
+  ],
+  "scripts": {
+    "build": "bun build src/index.ts src/cli.ts --outdir dist --target bun --format esm && tsc --emitDeclarationOnly && cp src/clikit.schema.json dist/",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "bun run clean && bun run build",
+    "typecheck": "tsc --noEmit",
+    "dev": "bun run build --watch"
+  },
+  "keywords": [
+    "opencode",
+    "plugin",
+    "agents",
+    "ai",
+    "llm",
+    "cli",
+    "claude",
+    "gpt"
+  ],
+  "author": "Kira",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/KiraKas-Tr/CliKit.git"
+  },
+  "bugs": {
+    "url": "https://github.com/KiraKas-Tr/CliKit/issues"
+  },
+  "homepage": "https://github.com/KiraKas-Tr/CliKit#readme",
+  "dependencies": {
+    "@opencode-ai/plugin": "1.1.64",
+    "gray-matter": "^4.0.3"
+  },
+  "devDependencies": {
+    "bun-types": "latest",
+    "typescript": "^5.7.3"
+  },
+  "peerDependencies": {
+    "bun": ">=1.0.0"
+  }
+}

package/skill/accessibility-audit/SKILL.md

@@ -0,0 +1,115 @@
+---
+name: accessibility-audit
+description: Use when verifying WCAG compliance, checking keyboard navigation, color contrast, or screen reader compatibility.
+---
+
+# Accessibility Audit Skill
+
+You are running the **accessibility-audit** skill. No barriers. Full access.
+
+## WCAG Levels
+
+| Level | Coverage | Use Case |
+|-------|----------|----------|
+| A | Minimum | Legal baseline |
+| AA | Standard | Most regulations |
+| AAA | Enhanced | Maximum accessibility |
+
+## Audit Categories
+
+### 1. Color Contrast
+
+```bash
+# Check contrast ratios
+gemini -p "Analyze color contrast in this UI for WCAG AA compliance: $(cat ui.png)"
+```
+
+Requirements:
+- Normal text: 4.5:1 minimum
+- Large text: 3:1 minimum
+- UI components: 3:1 minimum
+
+### 2. Keyboard Navigation
+
+Test checklist:
+- [ ] All interactive elements focusable
+- [ ] Focus order matches visual order
+- [ ] Focus visible indicator present
+- [ ] No keyboard traps
+- [ ] Skip links provided
+- [ ] Modal focus management
+
+### 3. Screen Reader Compatibility
+
+Test with:
+- VoiceOver (Mac/iOS)
+- NVDA (Windows)
+- TalkBack (Android)
+
+Check:
+- [ ] All images have alt text
+- [ ] Headings hierarchy correct (h1→h2→h3)
+- [ ] Landmarks properly labeled
+- [ ] Form labels associated
+- [ ] ARIA attributes correct
+- [ ] Dynamic content announced
+
+### 4. Semantic Structure
+
+```html
+<!-- Good -->
+<nav aria-label="Main navigation">...</nav>
+<main>...</main>
+<article>...</article>
+<aside aria-label="Related content">...</aside>
+
+<!-- Bad -->
+<div class="nav">...</div>
+<div class="main">...</div>
+```
+
+### 5. Forms
+
+- [ ] All inputs have associated labels
+- [ ] Error messages linked to inputs
+- [ ] Required fields indicated
+- [ ] Validation errors announced
+- [ ] Instructions provided before inputs
+
+## Pre-Launch Verification
+
+### Automated Testing
+```bash
+# Lighthouse
+npx lighthouse URL --only-categories=accessibility
+
+# axe-core
+npx axe URL
+```
+
+### Manual Testing
+- [ ] Keyboard-only navigation complete
+- [ ] Screen reader test (2+ browsers)
+- [ ] Zoom to 200% without horizontal scroll
+- [ ] High contrast mode usable
+- [ ] Reduced motion preference respected
+
+## Checklist
+
+- [ ] Color contrast: All text meets AA
+- [ ] Keyboard: Full navigation possible
+- [ ] Screen reader: All content accessible
+- [ ] Semantic: Proper HTML structure
+- [ ] Forms: Labels and errors accessible
+- [ ] Motion: Reduced motion supported
+- [ ] Zoom: 200% without horizontal scroll
+
+## Red Flags
+
+- Color-only information conveyance
+- Missing alt text on meaningful images
+- Empty or generic link text ("click here")
+- Keyboard traps in modals/menus
+- Auto-playing media
+- Flashing content >3 times/second
+- Timeouts without warning/extension

package/skill/beads/SKILL.md

@@ -0,0 +1,56 @@
+---
+name: beads
+description: Use for multi-agent task coordination, file locking, and dependency management via beads-village tools.
+---
+
+# Beads Skill
+
+You are running the **beads** skill. Multi-agent coordination via beads-village.
+
+## Core Cycle
+
+```
+claim → reserve → work → done
+```
+
+## beads-village Tools
+
+| Tool | Purpose |
+|------|---------|
+| `beads-village_claim` | Pick up next ready task |
+| `beads-village_reserve` | Lock files before editing |
+| `beads-village_done` | Complete task, release files |
+| `beads-village_ready` | List tasks with no blockers |
+| `beads-village_add` | Create new task |
+| `beads-village_assign` | Delegate to role (leader only) |
+| `beads-village_ls` | List all tasks |
+| `beads-village_show` | Get task details |
+| `beads-village_status` | Workspace overview |
+
+## Dependency Management
+
+- Tasks with `deps` wait for dependencies to complete
+- Use `beads-village_ready` to find unblocked tasks
+- Check status with `beads-village_status`
+
+## File Locking Protocol
+
+1. Call `reserve` before editing shared files
+2. TTL defaults to 10 minutes
+3. Locks auto-release on `done`
+4. Check `reservations` before editing
+
+## Session Workflow
+
+1. `beads-village_init` on session start
+2. `beads-village_claim` to get work
+3. `beads-village_reserve` files you'll edit
+4. `beads-village_done` when complete
+5. `beads-village_sync` to push/pull changes
+
+## Best Practices
+
+- Always check dependencies before claiming
+- Reserve files early to prevent conflicts
+- Use descriptive task titles
+- Tag tasks with roles (fe, be, mobile, devops, qa)

package/skill/beads-bridge/SKILL.md

@@ -0,0 +1,45 @@
+---
+name: beads-bridge
+description: Use to bridge beads git-backed tasks with OpenCode's native todo system for cross-session coordination.
+---
+
+# Beads Bridge Skill
+
+You are running the **beads-bridge** skill. Bridge between beads git-backed tasks and OpenCode todos.
+
+## Purpose
+
+Enables coordination between:
+- **Beads git-backed tasks**: Persistent tasks in `.beads/` directory
+- **OpenCode native todos**: Session-native task list
+
+## Bridging Operations
+
+| Action | Description |
+|--------|-------------|
+| Sync todos | Import beads tasks to OpenCode todo list |
+| Export progress | Push OpenCode completions to beads |
+| Cross-session | Maintain state across agent sessions |
+| Swarm view | Unified task view for multiple agents |
+
+## Workflow
+
+1. Load beads state from `.beads/`
+2. Bridge imports ready tasks to native todos
+3. Work on tasks using native tools
+4. Bridge syncs completions back to beads
+5. Other agents see progress via beads git-backed tasks
+
+## Use Cases
+
+- Multi-agent swarms sharing a task backlog
+- Long-running projects with session breaks
+- Cross-workspace coordination
+- Human review integration
+
+## Best Practices
+
+- Run bridge sync at session start and end
+- Use beads git-backed tasks for persistent storage
+- Use native todos for active work tracking
+- Keep task titles consistent across systems

package/skill/brainstorming/SKILL.md

@@ -0,0 +1,41 @@
+---
+name: brainstorming
+description: Use when starting a new feature or project without clear requirements. Activates before writing code.
+---
+
+# Brainstorming Skill
+
+You are running the **brainstorming** skill. Your goal is to tease out requirements through iterative questioning.
+
+## Process
+
+1. **One question at a time** — Never ask multiple questions in one message
+2. **Multiple choice preferred** — Offer 2-4 options when possible
+3. **Build on answers** — Each question should refine understanding
+4. **Explore alternatives** — Don't assume the first approach is best
+
+## Question Types
+
+| Type | When to Use | Example |
+|------|-------------|---------|
+| Clarification | Vague requirement | "Should this be real-time or batch?" |
+| Trade-off | Multiple valid approaches | "Prefer speed or memory efficiency?" |
+| Boundary | Scope unclear | "Should this handle X case?" |
+| Priority | Too many features | "Which matters more: A or B?" |
+
+## Red Flags to Avoid
+
+- Jumping to implementation
+- Assuming requirements
+- Skipping the "why"
+- Not exploring alternatives
+
+## Exit Criteria
+
+Stop brainstorming when:
+- Requirements are specific and bounded
+- Acceptance criteria are clear
+- Technical approach is decided
+- User says "that's all"
+
+Then transition to writing-plans or development-lifecycle.