@hivehub/rulebook 5.8.1 → 6.0.0

package/templates/skills/modules/atlassian/SKILL.md

@@ -1,265 +0,0 @@
----
-name: "Atlassian"
-description: "Use MCP Atlassian for Jira issues, Confluence documentation, and Bitbucket repositories."
-version: "1.0.0"
-category: "modules"
-author: "Rulebook"
-tags: ["modules", "mcp"]
-dependencies: []
-conflicts: []
----
-<!-- ATLASSIAN:START -->
-# Atlassian MCP Instructions
-
-**CRITICAL**: Use MCP Atlassian for Jira issues, Confluence documentation, and Bitbucket repositories.
-
-## Jira Operations
-
-### Issue Management
-```typescript
-// Create issue
-jira.issues.createIssue({
-  fields: {
-    project: { key: 'PROJ' },
-    summary: 'Bug in authentication',
-    description: 'Users cannot login with valid credentials',
-    issuetype: { name: 'Bug' },
-    priority: { name: 'High' }
-  }
-})
-
-// Update issue
-jira.issues.updateIssue({
-  issueIdOrKey: 'PROJ-123',
-  fields: {
-    status: { name: 'In Progress' },
-    assignee: { accountId: 'user-id' }
-  }
-})
-
-// Get issue
-jira.issues.getIssue({ issueIdOrKey: 'PROJ-123' })
-
-// Search issues
-jira.issueSearch.searchForIssuesUsingJql({
-  jql: 'project = PROJ AND status = "To Do" ORDER BY priority DESC'
-})
-
-// Add comment
-jira.issueComments.addComment({
-  issueIdOrKey: 'PROJ-123',
-  body: 'Working on this issue'
-})
-```
-
-### Transitions
-```typescript
-// Get transitions
-const transitions = await jira.issues.getTransitions({ issueIdOrKey: 'PROJ-123' })
-
-// Transition issue
-jira.issues.doTransition({
-  issueIdOrKey: 'PROJ-123',
-  transition: { id: transitionId }
-})
-```
-
-## Confluence Operations
-
-### Page Management
-```typescript
-// Create page
-confluence.content.createContent({
-  type: 'page',
-  title: 'API Documentation',
-  space: { key: 'DOCS' },
-  body: {
-    storage: {
-      value: '<h1>Introduction</h1><p>Content here</p>',
-      representation: 'storage'
-    }
-  }
-})
-
-// Update page
-confluence.content.updateContent({
-  id: 'page-id',
-  type: 'page',
-  title: 'Updated Title',
-  version: { number: currentVersion + 1 },
-  body: {
-    storage: {
-      value: '<p>Updated content</p>',
-      representation: 'storage'
-    }
-  }
-})
-
-// Get page
-confluence.content.getContentById({ id: 'page-id' })
-
-// Search
-confluence.search.search({
-  cql: 'type=page AND space=DOCS AND title~"API"'
-})
-```
-
-### Attachments
-```typescript
-// Add attachment
-confluence.content.createAttachment({
-  id: 'page-id',
-  file: fileBuffer,
-  filename: 'document.pdf'
-})
-
-// Get attachments
-confluence.content.getAttachments({ id: 'page-id' })
-```
-
-## Bitbucket Operations
-
-### Repository Management
-```typescript
-// Get repositories
-bitbucket.repositories.list({ workspace: 'my-workspace' })
-
-// Get repository
-bitbucket.repositories.get({
-  workspace: 'my-workspace',
-  repo_slug: 'my-repo'
-})
-
-// Get branches
-bitbucket.refs.listBranches({
-  workspace: 'my-workspace',
-  repo_slug: 'my-repo'
-})
-```
-
-### Pull Requests
-```typescript
-// Create PR
-bitbucket.pullrequests.create({
-  workspace: 'my-workspace',
-  repo_slug: 'my-repo',
-  title: 'Add new feature',
-  source: { branch: { name: 'feature/new-feature' } },
-  destination: { branch: { name: 'main' } },
-  description: 'Implements feature X'
-})
-
-// List PRs
-bitbucket.pullrequests.list({
-  workspace: 'my-workspace',
-  repo_slug: 'my-repo',
-  state: 'OPEN'
-})
-
-// Approve PR
-bitbucket.pullrequests.approve({
-  workspace: 'my-workspace',
-  repo_slug: 'my-repo',
-  pull_request_id: 123
-})
-```
-
-## Common Patterns
-
-### CI/CD Integration
-```typescript
-// Create issue on test failure
-if (testsFailed) {
-  await jira.issues.createIssue({
-    fields: {
-      project: { key: 'PROJ' },
-      summary: `Test failure in ${testSuite}`,
-      description: `Tests failed with errors:\n${errors.join('\n')}`,
-      issuetype: { name: 'Bug' },
-      labels: ['ci-failure', 'automated']
-    }
-  })
-}
-```
-
-### Documentation Sync
-```typescript
-// Sync CHANGELOG to Confluence
-const changelog = fs.readFileSync('CHANGELOG.md', 'utf-8')
-const html = markdownToConfluenceHtml(changelog)
-
-await confluence.content.updateContent({
-  id: changelogPageId,
-  type: 'page',
-  title: 'Changelog',
-  version: { number: version + 1 },
-  body: { storage: { value: html, representation: 'storage' } }
-})
-```
-
-### Sprint Planning
-```typescript
-// Get sprint tasks
-const issues = await jira.issueSearch.searchForIssuesUsingJql({
-  jql: 'sprint = ACTIVE AND project = PROJ',
-  fields: ['summary', 'status', 'assignee', 'priority']
-})
-
-// Generate sprint report
-const report = issues.issues.map(issue => ({
-  key: issue.key,
-  summary: issue.fields.summary,
-  status: issue.fields.status.name,
-  assignee: issue.fields.assignee?.displayName
-}))
-```
-
-## Best Practices
-
-✅ **DO:**
-- Use JQL for complex Jira queries
-- Cache project/user data
-- Handle rate limits
-- Use issue transitions properly
-- Version Confluence pages correctly
-- Link issues to commits/PRs
-
-❌ **DON'T:**
-- Create duplicate issues
-- Skip issue validation
-- Ignore rate limiting
-- Hardcode issue keys
-- Update without version check
-- Store credentials in code
-
-## Configuration
-
-```json
-{
-  "mcpServers": {
-    "atlassian": {
-      "command": "npx",
-      "args": ["-y", "@modelcontextprotocol/server-atlassian"],
-      "env": {
-        "JIRA_HOST": "your-domain.atlassian.net",
-        "JIRA_EMAIL": "your-email@example.com",
-        "JIRA_API_TOKEN": "your-api-token",
-        "CONFLUENCE_HOST": "your-domain.atlassian.net",
-        "CONFLUENCE_EMAIL": "your-email@example.com",
-        "CONFLUENCE_API_TOKEN": "your-api-token",
-        "BITBUCKET_WORKSPACE": "your-workspace",
-        "BITBUCKET_USERNAME": "your-username",
-        "BITBUCKET_APP_PASSWORD": "your-app-password"
-      }
-    }
-  }
-}
-```
-
-**Setup:**
-1. Generate API token at https://id.atlassian.com/manage-profile/security/api-tokens
-2. For Bitbucket, create app password in account settings
-3. Never commit credentials
-
-<!-- ATLASSIAN:END -->
-

package/templates/skills/modules/figma/SKILL.md

@@ -1,277 +0,0 @@
----
-name: "Figma"
-description: "Use MCP Figma for design system integration, asset export, and design-to-code workflows."
-version: "1.0.0"
-category: "modules"
-author: "Rulebook"
-tags: ["modules", "mcp"]
-dependencies: []
-conflicts: []
----
-<!-- FIGMA:START -->
-# Figma MCP Instructions
-
-**CRITICAL**: Use MCP Figma for design system integration, asset export, and design-to-code workflows.
-
-## Core Operations
-
-### File Operations
-```typescript
-// Get file
-figma.getFile({ file_key: 'file-key' })
-
-// Get file nodes
-figma.getFileNodes({
-  file_key: 'file-key',
-  ids: ['node-id-1', 'node-id-2']
-})
-
-// Get file versions
-figma.getFileVersions({ file_key: 'file-key' })
-```
-
-### Image Export
-```typescript
-// Export images
-figma.getImage({
-  file_key: 'file-key',
-  ids: 'node-id',
-  format: 'png',  // png, jpg, svg, pdf
-  scale: 2  // @2x resolution
-})
-
-// Export multiple
-figma.getImage({
-  file_key: 'file-key',
-  ids: 'node-1,node-2,node-3',
-  format: 'svg',
-  svg_outline_text: true
-})
-```
-
-### Components
-```typescript
-// Get components
-figma.getFileComponents({ file_key: 'file-key' })
-
-// Get component sets
-figma.getFileComponentSets({ file_key: 'file-key' })
-
-// Get team components
-figma.getTeamComponents({ team_id: 'team-id' })
-```
-
-### Styles
-```typescript
-// Get file styles
-figma.getFileStyles({ file_key: 'file-key' })
-
-// Get team styles
-figma.getTeamStyles({ team_id: 'team-id' })
-```
-
-### Comments
-```typescript
-// Get comments
-figma.getComments({ file_key: 'file-key' })
-
-// Post comment
-figma.postComment({
-  file_key: 'file-key',
-  message: 'Approved for development',
-  comment_id: 'parent-comment-id'  // For replies
-})
-```
-
-## Common Patterns
-
-### Design Token Export
-```typescript
-// Export design tokens from Figma styles
-const { data: { styles } } = await figma.getFileStyles({ file_key: fileKey })
-
-const tokens = {
-  colors: {},
-  typography: {},
-  spacing: {}
-}
-
-for (const style of Object.values(styles)) {
-  if (style.style_type === 'FILL') {
-    tokens.colors[style.name] = extractColor(style)
-  } else if (style.style_type === 'TEXT') {
-    tokens.typography[style.name] = extractTextStyle(style)
-  }
-}
-
-// Write to tokens.json
-fs.writeFileSync('tokens.json', JSON.stringify(tokens, null, 2))
-```
-
-### Component Sync
-```typescript
-// Sync Figma components to code
-const { data: components } = await figma.getFileComponents({ file_key: fileKey })
-
-for (const component of Object.values(components)) {
-  // Export component as SVG
-  const { data: images } = await figma.getImage({
-    file_key: fileKey,
-    ids: component.node_id,
-    format: 'svg'
-  })
-  
-  // Save to assets folder
-  const svg = await fetch(images[component.node_id]).then(r => r.text())
-  fs.writeFileSync(`assets/icons/${component.name}.svg`, svg)
-}
-```
-
-### Screenshot Generation
-```typescript
-// Generate screenshots for documentation
-const screens = ['home-screen', 'login-screen', 'dashboard']
-
-for (const screenId of screens) {
-  const { data: images } = await figma.getImage({
-    file_key: fileKey,
-    ids: screenId,
-    format: 'png',
-    scale: 2
-  })
-  
-  const imageUrl = images[screenId]
-  const response = await fetch(imageUrl)
-  const buffer = await response.buffer()
-  
-  fs.writeFileSync(`docs/screenshots/${screenId}.png`, buffer)
-}
-```
-
-### Design Review Automation
-```typescript
-// Check for new comments
-const { data: comments } = await figma.getComments({ file_key: fileKey })
-
-const unresolved = comments.filter(c => !c.resolved_at)
-
-if (unresolved.length > 0) {
-  console.log(`${unresolved.length} unresolved design comments`)
-  
-  // Create Jira issues for unresolved comments
-  for (const comment of unresolved) {
-    await jira.issues.createIssue({
-      fields: {
-        project: { key: 'DESIGN' },
-        summary: `Design feedback: ${comment.message.substring(0, 50)}`,
-        description: comment.message,
-        issuetype: { name: 'Task' }
-      }
-    })
-  }
-}
-```
-
-### Design System Documentation
-```typescript
-// Generate component documentation
-const { data: components } = await figma.getFileComponents({ file_key: fileKey })
-
-let markdown = '# Design System Components\n\n'
-
-for (const [id, component] of Object.entries(components)) {
-  // Export thumbnail
-  const { data: images } = await figma.getImage({
-    file_key: fileKey,
-    ids: id,
-    format: 'png',
-    scale: 1
-  })
-  
-  markdown += `## ${component.name}\n\n`
-  markdown += `![${component.name}](${images[id]})\n\n`
-  markdown += `**Description:** ${component.description || 'No description'}\n\n`
-}
-
-fs.writeFileSync('docs/design-system.md', markdown)
-```
-
-## Best Practices
-
-✅ **DO:**
-- Cache file data to reduce API calls
-- Use version history for tracking changes
-- Export assets at appropriate resolutions
-- Document component usage
-- Use meaningful component names
-- Keep design tokens in sync
-- Handle rate limits (requests/minute)
-
-❌ **DON'T:**
-- Export entire files repeatedly
-- Ignore version control
-- Hardcode file keys
-- Skip error handling
-- Export at wrong resolutions
-- Commit API tokens
-
-## Configuration
-
-```json
-{
-  "mcpServers": {
-    "figma": {
-      "command": "npx",
-      "args": ["-y", "@modelcontextprotocol/server-figma"],
-      "env": {
-        "FIGMA_ACCESS_TOKEN": "your-personal-access-token"
-      }
-    }
-  }
-}
-```
-
-**Setup:**
-1. Generate personal access token: Account Settings → Personal Access Tokens
-2. Grant appropriate scopes (file content, comments)
-3. Store token securely
-
-## Integration Patterns
-
-### CI/CD Asset Pipeline
-```bash
-# Export icons on every design update
-figma-export --file-key=$FIGMA_FILE --format=svg --output=src/assets/icons
-
-# Optimize SVGs
-svgo --folder src/assets/icons
-
-# Commit if changes detected
-git diff --quiet src/assets/icons || git commit -m "chore: Update design assets"
-```
-
-### Design-to-Code Workflow
-```typescript
-// 1. Detect design changes
-const currentVersion = await figma.getFile({ file_key: fileKey })
-const lastVersion = loadLastProcessedVersion()
-
-if (currentVersion.version !== lastVersion) {
-  // 2. Export updated components
-  await exportComponents(fileKey)
-  
-  // 3. Generate code
-  await generateComponentCode()
-  
-  // 4. Run tests
-  await runVisualRegressionTests()
-  
-  // 5. Create PR if tests pass
-  if (testsPass) {
-    await createPullRequest('Update components from Figma')
-  }
-}
-```
-
-<!-- FIGMA:END -->
-