@ngxtm/devkit 3.7.0 → 3.9.0

package/merged-commands/design-orchestration.md

@@ -0,0 +1,167 @@
+---
+name: design-orchestration
+description: >
+  Orchestrates design workflows by routing work through
+  brainstorming, multi-agent review, and execution readiness
+  in the correct order. Prevents premature implementation,
+  skipped validation, and unreviewed high-risk designs.
+---
+
+# Design Orchestration (Meta-Skill)
+
+## Purpose
+
+Ensure that **ideas become designs**, **designs are reviewed**, and
+**only validated designs reach implementation**.
+
+This skill does not generate designs.
+It **controls the flow between other skills**.
+
+---
+
+## Operating Model
+
+This is a **routing and enforcement skill**, not a creative one.
+
+It decides:
+- which skill must run next
+- whether escalation is required
+- whether execution is permitted
+
+---
+
+## Controlled Skills
+
+This meta-skill coordinates the following:
+
+- `brainstorming` — design generation
+- `multi-agent-brainstorming` — design validation
+- downstream implementation or planning skills
+
+---
+
+## Entry Conditions
+
+Invoke this skill when:
+- a user proposes a new feature, system, or change
+- a design decision carries meaningful risk
+- correctness matters more than speed
+
+---
+
+## Routing Logic
+
+### Step 1 — Brainstorming (Mandatory)
+
+If no validated design exists:
+
+- Invoke `brainstorming`
+- Require:
+  - Understanding Lock
+  - Initial Design
+  - Decision Log started
+
+You may NOT proceed without these artifacts.
+
+---
+
+### Step 2 — Risk Assessment
+
+After brainstorming completes, classify the design as:
+
+- **Low risk**
+- **Moderate risk**
+- **High risk**
+
+Use factors such as:
+- user impact
+- irreversibility
+- operational cost
+- complexity
+- uncertainty
+- novelty
+
+---
+
+### Step 3 — Conditional Escalation
+
+- **Low risk**  
+  → Proceed to implementation planning
+
+- **Moderate risk**  
+  → Recommend `multi-agent-brainstorming`
+
+- **High risk**  
+  → REQUIRE `multi-agent-brainstorming`
+
+Skipping escalation when required is prohibited.
+
+---
+
+### Step 4 — Multi-Agent Review (If Invoked)
+
+If `multi-agent-brainstorming` is run:
+
+Require:
+- completed Understanding Lock
+- current Design
+- Decision Log
+
+Do NOT allow:
+- new ideation
+- scope expansion
+- reopening problem definition
+
+Only critique, revision, and decision resolution are allowed.
+
+---
+
+### Step 5 — Execution Readiness Check
+
+Before allowing implementation:
+
+Confirm:
+- design is approved (single-agent or multi-agent)
+- Decision Log is complete
+- major assumptions are documented
+- known risks are acknowledged
+
+If any condition fails:
+- block execution
+- return to the appropriate skill
+
+---
+
+## Enforcement Rules
+
+- Do NOT allow implementation without a validated design
+- Do NOT allow skipping required review
+- Do NOT allow silent escalation or de-escalation
+- Do NOT merge design and implementation phases
+
+---
+
+## Exit Conditions
+
+This meta-skill exits ONLY when:
+- the next step is explicitly identified, AND
+- all required prior steps are complete
+
+Possible exits:
+- “Proceed to implementation planning”
+- “Run multi-agent-brainstorming”
+- “Return to brainstorming for clarification”
+- "If a reviewed design reports a final disposition of APPROVED, REVISE, or REJECT, you MUST route the workflow accordingly and state the chosen next step explicitly."
+---
+
+## Design Philosophy
+
+This skill exists to:
+- slow down the right decisions
+- speed up the right execution
+- prevent costly mistakes
+
+Good systems fail early.
+Bad systems fail in production.
+
+This meta-skill exists to enforce the former.

package/merged-commands/developer-growth-analysis.md

@@ -0,0 +1,322 @@
+---
+name: developer-growth-analysis
+description: Analyzes your recent Claude Code chat history to identify coding patterns, development gaps, and areas for improvement, curates relevant learning resources from HackerNews, and automatically sends a personalized growth report to your Slack DMs.
+---
+
+# Developer Growth Analysis
+
+This skill provides personalized feedback on your recent coding work by analyzing your Claude Code chat interactions and identifying patterns that reveal strengths and areas for growth.
+
+## When to Use This Skill
+
+Use this skill when you want to:
+- Understand your development patterns and habits from recent work
+- Identify specific technical gaps or recurring challenges
+- Discover which topics would benefit from deeper study
+- Get curated learning resources tailored to your actual work patterns
+- Track improvement areas across your recent projects
+- Find high-quality articles that directly address the skills you're developing
+
+This skill is ideal for developers who want structured feedback on their growth without waiting for code reviews, and who prefer data-driven insights from their own work history.
+
+## What This Skill Does
+
+This skill performs a six-step analysis of your development work:
+
+1. **Reads Your Chat History**: Accesses your local Claude Code chat history from the past 24-48 hours to understand what you've been working on.
+
+2. **Identifies Development Patterns**: Analyzes the types of problems you're solving, technologies you're using, challenges you encounter, and how you approach different kinds of tasks.
+
+3. **Detects Improvement Areas**: Recognizes patterns that suggest skill gaps, repeated struggles, inefficient approaches, or areas where you might benefit from deeper knowledge.
+
+4. **Generates a Personalized Report**: Creates a comprehensive report showing your work summary, identified improvement areas, and specific recommendations for growth.
+
+5. **Finds Learning Resources**: Uses HackerNews to curate high-quality articles and discussions directly relevant to your improvement areas, providing you with a reading list tailored to your actual development work.
+
+6. **Sends to Your Slack DMs**: Automatically delivers the complete report to your own Slack direct messages so you can reference it anytime, anywhere.
+
+## How to Use
+
+Ask Claude to analyze your recent coding work:
+
+```
+Analyze my developer growth from my recent chats
+```
+
+Or be more specific about which time period:
+
+```
+Analyze my work from today and suggest areas for improvement
+```
+
+The skill will generate a formatted report with:
+- Overview of your recent work
+- Key improvement areas identified
+- Specific recommendations for each area
+- Curated learning resources from HackerNews
+- Action items you can focus on
+
+## Instructions
+
+When a user requests analysis of their developer growth or coding patterns from recent work:
+
+1. **Access Chat History**
+
+   Read the chat history from `~/.claude/history.jsonl`. This file is a JSONL format where each line contains:
+   - `display`: The user's message/request
+   - `project`: The project being worked on
+   - `timestamp`: Unix timestamp (in milliseconds)
+   - `pastedContents`: Any code or content pasted
+
+   Filter for entries from the past 24-48 hours based on the current timestamp.
+
+2. **Analyze Work Patterns**
+
+   Extract and analyze the following from the filtered chats:
+   - **Projects and Domains**: What types of projects was the user working on? (e.g., backend, frontend, DevOps, data, etc.)
+   - **Technologies Used**: What languages, frameworks, and tools appear in the conversations?
+   - **Problem Types**: What categories of problems are being solved? (e.g., performance optimization, debugging, feature implementation, refactoring, setup/configuration)
+   - **Challenges Encountered**: What problems did the user struggle with? Look for:
+     - Repeated questions about similar topics
+     - Problems that took multiple attempts to solve
+     - Questions indicating knowledge gaps
+     - Complex architectural decisions
+   - **Approach Patterns**: How does the user solve problems? (e.g., methodical, exploratory, experimental)
+
+3. **Identify Improvement Areas**
+
+   Based on the analysis, identify 3-5 specific areas where the user could improve. These should be:
+   - **Specific** (not vague like "improve coding skills")
+   - **Evidence-based** (grounded in actual chat history)
+   - **Actionable** (practical improvements that can be made)
+   - **Prioritized** (most impactful first)
+
+   Examples of good improvement areas:
+   - "Advanced TypeScript patterns (generics, utility types, type guards) - you struggled with type safety in [specific project]"
+   - "Error handling and validation - I noticed you patched several bugs related to missing null checks"
+   - "Async/await patterns - your recent work shows some race conditions and timing issues"
+   - "Database query optimization - you rewrote the same query multiple times"
+
+4. **Generate Report**
+
+   Create a comprehensive report with this structure:
+
+   ```markdown
+   # Your Developer Growth Report
+
+   **Report Period**: [Yesterday / Today / [Custom Date Range]]
+   **Last Updated**: [Current Date and Time]
+
+   ## Work Summary
+
+   [2-3 paragraphs summarizing what the user worked on, projects touched, technologies used, and overall focus areas]
+
+   Example:
+   "Over the past 24 hours, you focused primarily on backend development with three distinct projects. Your work involved TypeScript, React, and deployment infrastructure. You tackled a mix of feature implementation, debugging, and architectural decisions, with a particular focus on API design and database optimization."
+
+   ## Improvement Areas (Prioritized)
+
+   ### 1. [Area Name]
+
+   **Why This Matters**: [Explanation of why this skill is important for the user's work]
+
+   **What I Observed**: [Specific evidence from chat history showing this gap]
+
+   **Recommendation**: [Concrete step(s) to improve in this area]
+
+   **Time to Skill Up**: [Brief estimate of effort required]
+
+   ---
+
+   [Repeat for 2-4 additional areas]
+
+   ## Strengths Observed
+
+   [2-3 bullet points highlighting things you're doing well - things to continue doing]
+
+   ## Action Items
+
+   Priority order:
+   1. [Action item derived from highest priority improvement area]
+   2. [Action item from next area]
+   3. [Action item from next area]
+
+   ## Learning Resources
+
+   [Will be populated in next step]
+   ```
+
+5. **Search for Learning Resources**
+
+   Use Rube MCP to search HackerNews for articles related to each improvement area:
+
+   - For each improvement area, construct a search query targeting high-quality resources
+   - Search HackerNews using RUBE_SEARCH_TOOLS with queries like:
+     - "Learn [Technology/Pattern] best practices"
+     - "[Technology] advanced patterns and techniques"
+     - "Debugging [specific problem type] in [language]"
+   - Prioritize posts with high engagement (comments, upvotes)
+   - For each area, include 2-3 most relevant articles with:
+     - Article title
+     - Publication date
+     - Brief description of why it's relevant
+     - Link to the article
+
+   Add this section to the report:
+
+   ```markdown
+   ## Curated Learning Resources
+
+   ### For: [Improvement Area]
+
+   1. **[Article Title]** - [Date]
+      [Description of what it covers and why it's relevant to your improvement area]
+      [Link]
+
+   2. **[Article Title]** - [Date]
+      [Description]
+      [Link]
+
+   [Repeat for other improvement areas]
+   ```
+
+6. **Present the Complete Report**
+
+   Deliver the report in a clean, readable format that the user can:
+   - Quickly scan for key takeaways
+   - Use for focused learning planning
+   - Reference over the next week as they work on improvements
+   - Share with mentors if they want external feedback
+
+7. **Send Report to Slack DMs**
+
+   Use Rube MCP to send the complete report to the user's own Slack DMs:
+
+   - Check if Slack connection is active via RUBE_SEARCH_TOOLS
+   - If not connected, use RUBE_MANAGE_CONNECTIONS to initiate Slack auth
+   - Use RUBE_MULTI_EXECUTE_TOOL to send the report as a formatted message:
+     - Send the report title and period as the first message
+     - Break the report into logical sections (Summary, Improvements, Strengths, Actions, Resources)
+     - Format each section as a well-structured Slack message with proper markdown
+     - Include clickable links for the learning resources
+   - Confirm delivery in the CLI output
+
+   This ensures the user has the report in a place they check regularly and can reference it throughout the week.
+
+## Example Usage
+
+### Input
+
+```
+Analyze my developer growth from my recent chats
+```
+
+### Output
+
+```markdown
+# Your Developer Growth Report
+
+**Report Period**: November 9-10, 2024
+**Last Updated**: November 10, 2024, 9:15 PM UTC
+
+## Work Summary
+
+Over the past two days, you focused on backend infrastructure and API development. Your primary project was an open-source showcase application, where you made significant progress on connections management, UI improvements, and deployment configuration. You worked with TypeScript, React, and Node.js, tackling challenges ranging from data security to responsive design. Your work shows a balance between implementing features and addressing technical debt.
+
+## Improvement Areas (Prioritized)
+
+### 1. Advanced TypeScript Patterns and Type Safety
+
+**Why This Matters**: TypeScript is central to your work, but leveraging its advanced features (generics, utility types, conditional types, type guards) can significantly improve code reliability and reduce runtime errors. Better type safety catches bugs at compile time rather than in production.
+
+**What I Observed**: In your recent chats, you were working with connection data structures and struggled a few times with typing auth configurations properly. You also had to iterate on union types for different connection states. There's an opportunity to use discriminated unions and type guards more effectively.
+
+**Recommendation**: Study TypeScript's advanced type system, particularly utility types (Omit, Pick, Record), conditional types, and discriminated unions. Apply these patterns to your connection configuration handling and auth state management.
+
+**Time to Skill Up**: 5-8 hours of focused learning and practice
+
+### 2. Secure Data Handling and Information Hiding in UI
+
+**Why This Matters**: You identified and fixed a security concern where sensitive connection data was being displayed in your console. Preventing information leakage is critical for applications handling user credentials and API keys. Good practices here prevent security incidents and user trust violations.
+
+**What I Observed**: You caught that your "Your Apps" page was showing full connection data including auth configs. This shows good security instincts, and the next step is building this into your default thinking when handling sensitive information.
+
+**Recommendation**: Review security best practices for handling sensitive data in frontend applications. Create reusable patterns for filtering/masking sensitive information before displaying it. Consider implementing a secure data layer that explicitly whitelist what can be shown in the UI.
+
+**Time to Skill Up**: 3-4 hours
+
+### 3. Component Architecture and Responsive UI Patterns
+
+**Why This Matters**: You're designing UIs that need to work across different screen sizes and user interactions. Strong component architecture makes it easier to build complex UIs without bugs and improves maintainability.
+
+**What I Observed**: You worked on the "Marketplace" UI (formerly Browse Tools), recreating it from a design image. You also identified and fixed scrolling issues where content was overflowing containers. There's an opportunity to strengthen your understanding of layout containment and responsive design patterns.
+
+**Recommendation**: Study React component composition patterns and CSS layout best practices (especially flexbox and grid). Focus on container queries and responsive patterns that prevent overflow issues. Look into component composition libraries and design system approaches.
+
+**Time to Skill Up**: 6-10 hours (depending on depth)
+
+## Strengths Observed
+
+- **Security Awareness**: You proactively identified data leakage issues before they became problems
+- **Iterative Refinement**: You worked through UI requirements methodically, asking clarifying questions and improving designs
+- **Full-Stack Capability**: You comfortably work across backend APIs, frontend UI, and deployment concerns
+- **Problem-Solving Approach**: You break down complex tasks into manageable steps
+
+## Action Items
+
+Priority order:
+1. Spend 1-2 hours learning TypeScript utility types and discriminated unions; apply to your connection data structures
+2. Document security patterns for your project (what data is safe to display, filtering/masking functions)
+3. Study one article on advanced React patterns and apply one pattern to your current UI work
+4. Set up a code review checklist focused on type safety and data security for future PRs
+
+## Curated Learning Resources
+
+### For: Advanced TypeScript Patterns
+
+1. **TypeScript's Advanced Types: Generics, Utility Types, and Conditional Types** - HackerNews, October 2024
+   Deep dive into TypeScript's type system with practical examples and real-world applications. Covers discriminated unions, type guards, and patterns for ensuring compile-time safety in complex applications.
+   [Link to discussion]
+
+2. **Building Type-Safe APIs in TypeScript** - HackerNews, September 2024
+   Practical guide to designing APIs with TypeScript that catch errors early. Particularly relevant for your connection configuration work.
+   [Link to discussion]
+
+### For: Secure Data Handling in Frontend
+
+1. **Preventing Information Leakage in Web Applications** - HackerNews, August 2024
+   Comprehensive guide to data security in frontend applications, including filtering sensitive information, secure logging, and audit trails.
+   [Link to discussion]
+
+2. **OAuth and API Key Management Best Practices** - HackerNews, July 2024
+   How to safely handle authentication tokens and API keys in applications, with examples for different frameworks.
+   [Link to discussion]
+
+### For: Component Architecture and Responsive Design
+
+1. **Advanced React Patterns: Composition Over Configuration** - HackerNews
+   Explores component composition strategies that scale, with examples using modern React patterns.
+   [Link to discussion]
+
+2. **CSS Layout Mastery: Flexbox, Grid, and Container Queries** - HackerNews, October 2024
+   Learn responsive design patterns that prevent overflow issues and work across all screen sizes.
+   [Link to discussion]
+```
+
+## Tips and Best Practices
+
+- Run this analysis once a week to track your improvement trajectory over time
+- Pick one improvement area at a time and focus on it for a few days before moving to the next
+- Use the learning resources as a study guide; work through the recommended materials and practice applying the patterns
+- Revisit this report after focusing on an area for a week to see how your work patterns change
+- The learning resources are intentionally curated for your actual work, not generic topics, so they'll be highly relevant to what you're building
+
+## How Accuracy and Quality Are Maintained
+
+This skill:
+- Analyzes your actual work patterns from timestamped chat history
+- Generates evidence-based recommendations grounded in real projects
+- Curates learning resources that directly address your identified gaps
+- Focuses on actionable improvements, not vague feedback
+- Provides specific time estimates based on complexity
+- Prioritizes areas that will have the most impact on your development velocity

package/merged-commands/devops-engineer.md

@@ -0,0 +1,92 @@
+---
+name: devops-engineer
+description: Use when setting up CI/CD pipelines, containerizing applications, or managing infrastructure as code. Invoke for pipelines, Docker, Kubernetes, cloud platforms, GitOps.
+triggers:
+  - DevOps
+  - CI/CD
+  - deployment
+  - Docker
+  - Kubernetes
+  - Terraform
+  - GitHub Actions
+  - infrastructure
+  - platform engineering
+  - incident response
+  - on-call
+  - self-service
+role: engineer
+scope: implementation
+output-format: code
+---
+
+# DevOps Engineer
+
+Senior DevOps engineer specializing in CI/CD pipelines, infrastructure as code, and deployment automation.
+
+## Role Definition
+
+You are a senior DevOps engineer with 10+ years of experience. You operate with three perspectives:
+- **Build Hat**: Automating build, test, and packaging
+- **Deploy Hat**: Orchestrating deployments across environments
+- **Ops Hat**: Ensuring reliability, monitoring, and incident response
+
+## When to Use This Skill
+
+- Setting up CI/CD pipelines (GitHub Actions, GitLab CI, Jenkins)
+- Containerizing applications (Docker, Docker Compose)
+- Kubernetes deployments and configurations
+- Infrastructure as code (Terraform, Pulumi)
+- Cloud platform configuration (AWS, GCP, Azure)
+- Deployment strategies (blue-green, canary, rolling)
+- Building internal developer platforms and self-service tools
+- Incident response, on-call, and production troubleshooting
+- Release automation and artifact management
+
+## Core Workflow
+
+1. **Assess** - Understand application, environments, requirements
+2. **Design** - Pipeline structure, deployment strategy
+3. **Implement** - IaC, Dockerfiles, CI/CD configs
+4. **Deploy** - Roll out with verification
+5. **Monitor** - Set up observability, alerts
+
+## Reference Guide
+
+Load detailed guidance based on context:
+
+| Topic | Reference | Load When |
+|-------|-----------|-----------|
+| GitHub Actions | `references/github-actions.md` | Setting up CI/CD pipelines, GitHub workflows |
+| Docker | `references/docker-patterns.md` | Containerizing applications, writing Dockerfiles |
+| Kubernetes | `references/kubernetes.md` | K8s deployments, services, ingress, pods |
+| Terraform | `references/terraform-iac.md` | Infrastructure as code, AWS/GCP provisioning |
+| Deployment | `references/deployment-strategies.md` | Blue-green, canary, rolling updates, rollback |
+| Platform | `references/platform-engineering.md` | Self-service infra, developer portals, golden paths, Backstage |
+| Release | `references/release-automation.md` | Artifact management, feature flags, multi-platform CI/CD |
+| Incidents | `references/incident-response.md` | Production outages, on-call, MTTR, postmortems, runbooks |
+
+## Constraints
+
+### MUST DO
+- Use infrastructure as code (never manual changes)
+- Implement health checks and readiness probes
+- Store secrets in secret managers (not env files)
+- Enable container scanning in CI/CD
+- Document rollback procedures
+- Use GitOps for Kubernetes (ArgoCD, Flux)
+
+### MUST NOT DO
+- Deploy to production without explicit approval
+- Store secrets in code or CI/CD variables
+- Skip staging environment testing
+- Ignore resource limits in containers
+- Use `latest` tag in production
+- Deploy on Fridays without monitoring
+
+## Output Templates
+
+Provide: CI/CD pipeline config, Dockerfile, K8s/Terraform files, deployment verification, rollback procedure
+
+## Knowledge Reference
+
+GitHub Actions, GitLab CI, Jenkins, CircleCI, Docker, Kubernetes, Helm, ArgoCD, Flux, Terraform, Pulumi, Crossplane, AWS/GCP/Azure, Prometheus, Grafana, PagerDuty, Backstage, LaunchDarkly, Flagger