@hivehub/rulebook 2.1.0 → 3.1.0

package/templates/skills/languages/zig/SKILL.md

@@ -0,0 +1,275 @@
+---
+name: "Zig"
+description: "Execute these commands after EVERY implementation (see AGENT_AUTOMATION module for full workflow)."
+version: "1.0.0"
+category: "languages"
+author: "Rulebook"
+tags: ["languages", "language"]
+dependencies: []
+conflicts: []
+---
+<!-- ZIG:START -->
+# Zig Project Rules
+
+## Agent Automation Commands
+
+**CRITICAL**: Execute these commands after EVERY implementation (see AGENT_AUTOMATION module for full workflow).
+
+```bash
+# Complete quality check sequence:
+zig fmt --check .         # Format check
+zig build                 # Build verification
+zig build test            # All tests (100% pass)
+
+# No standard security audit tool for Zig yet
+```
+
+## Zig Configuration
+
+**CRITICAL**: Use Zig 0.11+ with strict compilation and comprehensive testing.
+
+- **Version**: Zig 0.11+
+- **Recommended**: Zig 0.13+
+- **Build System**: zig build (built-in)
+- **Testing**: zig test (built-in)
+- **Formatter**: zig fmt (built-in)
+
+### build.zig Requirements
+
+```zig
+const std = @import("std");
+
+pub fn build(b: *std.Build) void {
+    const target = b.standardTargetOptions(.{});
+    const optimize = b.standardOptimizeOption(.{});
+
+    // Library
+    const lib = b.addStaticLibrary(.{
+        .name = "your-lib",
+        .root_source_file = .{ .path = "src/main.zig" },
+        .target = target,
+        .optimize = optimize,
+    });
+    b.installArtifact(lib);
+
+    // Executable
+    const exe = b.addExecutable(.{
+        .name = "your-app",
+        .root_source_file = .{ .path = "src/main.zig" },
+        .target = target,
+        .optimize = optimize,
+    });
+    b.installArtifact(exe);
+
+    // Tests
+    const main_tests = b.addTest(.{
+        .root_source_file = .{ .path = "src/main.zig" },
+        .target = target,
+        .optimize = optimize,
+    });
+
+    const run_main_tests = b.addRunArtifact(main_tests);
+    const test_step = b.step("test", "Run library tests");
+    test_step.dependOn(&run_main_tests.step);
+
+    // Run command
+    const run_cmd = b.addRunArtifact(exe);
+    run_cmd.step.dependOn(b.getInstallStep());
+    if (b.args) |args| {
+        run_cmd.addArgs(args);
+    }
+
+    const run_step = b.step("run", "Run the app");
+    run_step.dependOn(&run_cmd.step);
+}
+```
+
+## Code Quality Standards
+
+### Mandatory Quality Checks
+
+**CRITICAL**: After implementing ANY feature, you MUST run these commands in order.
+
+**IMPORTANT**: These commands MUST match your GitHub Actions workflows to prevent CI/CD failures!
+
+```bash
+# Pre-Commit Checklist (MUST match .github/workflows/*.yml)
+
+# 1. Format check (matches workflow)
+zig fmt --check src/ tests/
+
+# 2. Build (MUST pass - matches workflow)
+zig build -Doptimize=ReleaseFast
+
+# 3. Build with all optimizations (matches workflow)
+zig build -Doptimize=ReleaseSmall
+zig build -Doptimize=ReleaseSafe
+
+# 4. Run all tests (MUST pass 100% - matches workflow)
+zig build test
+
+# 5. Test with different targets (matches workflow)
+zig build test -Dtarget=x86_64-linux
+zig build test -Dtarget=x86_64-windows
+zig build test -Dtarget=aarch64-macos
+
+# 6. Check for memory leaks (matches workflow)
+zig build test -Doptimize=Debug --summary all
+
+# If ANY fails: ❌ DO NOT COMMIT - Fix first!
+```
+
+**If ANY of these fail, you MUST fix the issues before committing.**
+
+**Why This Matters:**
+- Running different commands locally than in CI causes build failures
+- Zig's compile-time guarantees only work if all checks pass
+- Example: Using `zig fmt src/` locally but `zig fmt --check src/` in CI = failure
+- Example: Only testing Debug builds locally = Release builds fail in CI
+- Example: Not testing cross-compilation = deployment fails on target platform
+
+### Testing
+
+- **Framework**: Built-in `zig test`
+- **Location**: Tests can be inline or in `/tests`
+- **Coverage**: Comprehensive test coverage required
+- **Memory**: No leaks allowed (valgrind clean)
+
+Example test structure:
+```zig
+const std = @import("std");
+const testing = std.testing;
+const DataProcessor = @import("processor.zig").DataProcessor;
+
+test "DataProcessor: basic functionality" {
+    var processor = DataProcessor.init(0.5);
+    defer processor.deinit();
+    
+    const input = [_]i32{ 1, 2, 3, 4, 5 };
+    const result = try processor.process(&input);
+    defer testing.allocator.free(result);
+    
+    try testing.expect(result.len > 0);
+    try testing.expectEqual(@as(usize, 3), result.len);
+}
+
+test "DataProcessor: handles empty input" {
+    var processor = DataProcessor.init(0.5);
+    defer processor.deinit();
+    
+    const input = [_]i32{};
+    const result = try processor.process(&input);
+    defer testing.allocator.free(result);
+    
+    try testing.expectEqual(@as(usize, 0), result.len);
+}
+
+test "DataProcessor: memory management" {
+    // Test that all allocations are freed
+    const allocator = testing.allocator;
+    
+    var processor = try DataProcessor.initWithAllocator(allocator, 0.5);
+    defer processor.deinit();
+    
+    const input = try allocator.alloc(i32, 1000);
+    defer allocator.free(input);
+    
+    for (input, 0..) |*item, i| {
+        item.* = @intCast(i);
+    }
+    
+    const result = try processor.process(input);
+    defer allocator.free(result);
+    
+    // If we reach here without leaks, test passes
+    try testing.expect(result.len > 0);
+}
+```
+
+## Memory Safety
+
+**CRITICAL**: Zig provides compile-time safety - use it!
+
+```zig
+// ✅ GOOD: Safe memory management
+const std = @import("std");
+
+pub fn processData(allocator: std.mem.Allocator, input: []const i32) ![]i32 {
+    var result = std.ArrayList(i32).init(allocator);
+    defer result.deinit();  // Always cleanup!
+    
+    for (input) |value| {
+        if (value > 0) {
+            try result.append(value * 2);
+        }
+    }
+    
+    return result.toOwnedSlice();
+}
+
+// Usage with proper cleanup
+pub fn main() !void {
+    var gpa = std.heap.GeneralPurposeAllocator(.{}){};
+    defer _ = gpa.deinit();
+    
+    const allocator = gpa.allocator();
+    
+    const input = [_]i32{ 1, 2, 3, 4, 5 };
+    const result = try processData(allocator, &input);
+    defer allocator.free(result);  // Free returned memory!
+    
+    for (result) |value| {
+        std.debug.print("{}\n", .{value});
+    }
+}
+
+// ❌ BAD: Memory leaks
+pub fn processDataLeaky(allocator: std.mem.Allocator) ![]i32 {
+    var result = std.ArrayList(i32).init(allocator);
+    // Missing defer result.deinit()!
+    
+    try result.append(42);
+    return result.toOwnedSlice();  // Leaks ArrayList memory!
+}
+```
+
+## Best Practices
+
+### DO's ✅
+
+- **USE** defer for cleanup
+- **CHECK** all error returns
+- **VALIDATE** all inputs
+- **TEST** with different allocators
+- **USE** comptime for compile-time computations
+- **PREFER** stack allocation when possible
+- **USE** tagged unions for variants
+- **CROSS-COMPILE** to verify portability
+
+### DON'Ts ❌
+
+- **NEVER** ignore error returns
+- **NEVER** use undefined behavior
+- **NEVER** leak memory
+- **NEVER** use @ptrCast without validation
+- **NEVER** assume platform specifics
+- **NEVER** skip cross-compilation tests
+- **NEVER** use global mutable state
+
+## CI/CD Requirements
+
+Must include GitHub Actions workflows:
+
+1. **Testing** (`zig-test.yml`):
+   - Test on Linux, Windows, macOS
+   - Test with Debug, ReleaseSafe, ReleaseFast, ReleaseSmall
+   - Cross-compilation tests
+   - Memory leak detection
+
+2. **Linting** (`zig-lint.yml`):
+   - zig fmt --check
+   - Build verification
+   - All optimize modes
+
+<!-- ZIG:END -->
+

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

@@ -0,0 +1,265 @@
+---
+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/context7/SKILL.md

@@ -0,0 +1,64 @@
+---
+name: "Context7"
+description: "Use MCP Context7 to access up-to-date library documentation before adding dependencies."
+version: "1.0.0"
+category: "modules"
+author: "Rulebook"
+tags: ["modules", "mcp"]
+dependencies: []
+conflicts: []
+---
+<!-- CONTEXT7:START -->
+# Context7 Instructions
+
+**CRITICAL**: Use MCP Context7 to access up-to-date library documentation before adding dependencies.
+
+## Core Functions
+
+### 1. resolve-library-id
+Resolve a package name to Context7-compatible library ID:
+```
+resolve-library-id("tokio") → "/tokio-rs/tokio"
+resolve-library-id("react") → "/facebook/react"
+```
+
+### 2. get-library-docs
+Fetch documentation with optional topic filter:
+```
+get-library-docs("/tokio-rs/tokio", topic="async")
+```
+
+## Workflow
+
+**Before adding ANY dependency:**
+```
+1. resolve-library-id(library_name)
+2. get-library-docs(library_id) 
+3. Check latest version and security
+4. Add dependency with correct version
+5. Document choice in commit
+```
+
+**Before updating major version:**
+```
+1. get-library-docs for current version
+2. get-library-docs for target version
+3. Review breaking changes
+4. Plan migration
+```
+
+## Best Practices
+
+✅ **DO:**
+- Always check Context7 before adding dependencies
+- Use topic parameter for specific info
+- Document version choices
+- Review security advisories
+
+❌ **DON'T:**
+- Add dependencies without checking latest version
+- Skip migration guides on major updates
+- Ignore security warnings
+
+<!-- CONTEXT7:END -->
+