oh-my-customcodex 0.1.0

package/templates/guides/rust/ownership.md

@@ -0,0 +1,180 @@
+# Rust Ownership
+
+> Reference for ownership, borrowing, and lifetimes
+
+## Ownership Rules
+
+1. Each value has exactly one owner
+2. When the owner goes out of scope, the value is dropped
+3. Values can be moved or borrowed
+
+## Move Semantics
+
+```rust
+// Move ownership
+let s1 = String::from("hello");
+let s2 = s1; // s1 is moved to s2
+// s1 is no longer valid
+
+// Clone to copy
+let s1 = String::from("hello");
+let s2 = s1.clone(); // s1 is still valid
+
+// Copy types (stack-only data)
+let x = 5;
+let y = x; // x is still valid (i32 implements Copy)
+```
+
+## Borrowing
+
+### Immutable References
+
+```rust
+fn main() {
+    let s1 = String::from("hello");
+    let len = calculate_length(&s1); // borrow s1
+    println!("The length of '{}' is {}.", s1, len);
+}
+
+fn calculate_length(s: &String) -> usize {
+    s.len()
+}
+```
+
+### Mutable References
+
+```rust
+fn main() {
+    let mut s = String::from("hello");
+    change(&mut s);
+}
+
+fn change(some_string: &mut String) {
+    some_string.push_str(", world");
+}
+```
+
+### Borrowing Rules
+
+```rust
+// Rule 1: At any time, either ONE mutable reference
+// OR any number of immutable references
+let mut s = String::from("hello");
+
+let r1 = &s; // OK
+let r2 = &s; // OK
+// let r3 = &mut s; // ERROR: cannot borrow as mutable
+
+let r3 = &mut s; // OK after r1 and r2 are done
+```
+
+## Lifetimes
+
+### Basic Syntax
+
+```rust
+// Lifetime annotation
+fn longest<'a>(x: &'a str, y: &'a str) -> &'a str {
+    if x.len() > y.len() {
+        x
+    } else {
+        y
+    }
+}
+```
+
+### Struct Lifetimes
+
+```rust
+struct ImportantExcerpt<'a> {
+    part: &'a str,
+}
+
+impl<'a> ImportantExcerpt<'a> {
+    fn level(&self) -> i32 {
+        3
+    }
+
+    fn announce_and_return_part(&self, announcement: &str) -> &str {
+        println!("Attention please: {}", announcement);
+        self.part
+    }
+}
+```
+
+### Lifetime Elision
+
+```rust
+// These are equivalent:
+fn first_word(s: &str) -> &str { ... }
+fn first_word<'a>(s: &'a str) -> &'a str { ... }
+
+// Elision rules:
+// 1. Each reference parameter gets its own lifetime
+// 2. If exactly one input lifetime, it's assigned to all outputs
+// 3. If &self or &mut self, its lifetime is assigned to outputs
+```
+
+### Static Lifetime
+
+```rust
+// 'static: lives for entire program duration
+let s: &'static str = "I have a static lifetime.";
+
+// All string literals have 'static lifetime
+```
+
+## Common Patterns
+
+### Returning References
+
+```rust
+// Cannot return reference to local variable
+fn dangle() -> &String { // ERROR
+    let s = String::from("hello");
+    &s // s goes out of scope!
+}
+
+// Return owned value instead
+fn no_dangle() -> String {
+    let s = String::from("hello");
+    s
+}
+```
+
+### Struct with References
+
+```rust
+// Struct holding reference must have lifetime
+struct Config<'a> {
+    query: &'a str,
+    filename: &'a str,
+}
+
+// Implementation with lifetime
+impl<'a> Config<'a> {
+    fn new(args: &'a [String]) -> Config<'a> {
+        Config {
+            query: &args[1],
+            filename: &args[2],
+        }
+    }
+}
+```
+
+### Multiple Lifetimes
+
+```rust
+fn longest_with_announcement<'a, 'b>(
+    x: &'a str,
+    y: &'a str,
+    ann: &'b str,
+) -> &'a str {
+    println!("Announcement: {}", ann);
+    if x.len() > y.len() {
+        x
+    } else {
+        y
+    }
+}
+```

package/templates/guides/skill-bundle-design/README.md

@@ -0,0 +1,106 @@
+# Domain Skill Bundle Design Guide
+
+## Overview
+
+Domain skill bundles package related skills, agents, and guides for a specific technology or framework. This guide defines the standard pattern based on the Author/Test/Troubleshoot tri-pattern (inspired by Microsoft Copilot Studio Skills).
+
+## The Author/Test/Troubleshoot Pattern
+
+Every domain skill bundle should provide three capability axes:
+
+### Author (Create & Edit)
+Skills and agents that help CREATE artifacts in the domain.
+
+| Component | Example (Spring Boot) | Example (Airflow) |
+|-----------|----------------------|-------------------|
+| Best practices skill | springboot-best-practices | airflow-best-practices |
+| Expert agent | be-springboot-expert | de-airflow-expert |
+| Code generation | Scaffold, boilerplate | DAG authoring |
+
+### Test (Verify & Validate)
+Skills and agents that help VERIFY correctness.
+
+| Component | Example (Spring Boot) | Example (Airflow) |
+|-----------|----------------------|-------------------|
+| Review skill | dev-review | dev-review |
+| QA workflow | qa-lead-routing | qa-lead-routing |
+| Domain-specific checks | Spring actuator health | DAG validation |
+
+### Troubleshoot (Debug & Fix)
+Skills and agents that help DIAGNOSE and FIX issues.
+
+| Component | Example (Spring Boot) | Example (Airflow) |
+|-----------|----------------------|-------------------|
+| Debugging skill | systematic-debugging | systematic-debugging |
+| Domain diagnostics | Spring Boot Actuator | Airflow log analysis |
+| Fix patterns | Common Spring errors | DAG failure patterns |
+
+## Existing Bundle Inventory
+
+Map existing oh-my-customcodex skills/agents to the tri-pattern:
+
+| Domain | Author | Test | Troubleshoot | Completeness |
+|--------|--------|------|-------------|-------------|
+| Spring Boot | springboot-best-practices, be-springboot-expert | dev-review | systematic-debugging | ★★★ |
+| FastAPI | fastapi-best-practices, be-fastapi-expert | dev-review | systematic-debugging | ★★★ |
+| Go | go-best-practices, lang-golang-expert, be-go-backend-expert | dev-review | systematic-debugging | ★★★ |
+| Airflow | airflow-best-practices, de-airflow-expert | dev-review | systematic-debugging | ★★★ |
+| React/Next.js | react-best-practices, fe-vercel-agent | web-design-guidelines | systematic-debugging | ★★★ |
+| PostgreSQL | postgres-best-practices, db-postgres-expert | dev-review | systematic-debugging | ★★★ |
+| Docker | docker-best-practices, infra-docker-expert | dev-review | systematic-debugging | ★★☆ |
+| Kafka | kafka-best-practices, de-kafka-expert | dev-review | systematic-debugging | ★★☆ |
+| Redis | redis-best-practices, db-redis-expert | dev-review | systematic-debugging | ★★☆ |
+
+## Creating a New Bundle
+
+### Checklist
+
+1. **Author axis**:
+   - [ ] Best practices skill (`.claude/skills/{domain}-best-practices/SKILL.md`)
+   - [ ] Expert agent (`.claude/agents/{type}-{domain}-expert.md`)
+   - [ ] Reference guide (`guides/{domain}/`)
+
+2. **Test axis**:
+   - [ ] Domain-specific test patterns documented in best practices skill
+   - [ ] Integration with qa-lead-routing or dev-review
+
+3. **Troubleshoot axis**:
+   - [ ] Common error patterns documented in best practices skill
+   - [ ] Integration with systematic-debugging
+
+### Minimum Viable Bundle
+
+At minimum, a domain bundle needs:
+- 1 best practices skill (Author)
+- 1 expert agent (Author + Troubleshoot)
+- Integration with dev-review (Test)
+
+### Template
+
+```
+guides/{domain}/
+├── README.md          # Domain overview and quick reference
+├── patterns.md        # Common patterns and anti-patterns
+└── troubleshooting.md # Common errors and solutions
+
+.claude/skills/{domain}-best-practices/
+└── SKILL.md           # Best practices skill
+
+.claude/agents/{type}-{domain}-expert.md  # Expert agent
+```
+
+## Relationship to Other Skills
+
+| Skill | Role in Bundle Pattern |
+|-------|----------------------|
+| dev-review | Universal Test axis |
+| systematic-debugging | Universal Troubleshoot axis |
+| adversarial-review | Advanced Test axis (security) |
+| qa-lead-routing | Test orchestration |
+| mgr-creator | Bundle creation automation |
+
+## References
+
+- Microsoft Copilot Studio Skills: Author/Test/Troubleshoot pattern
+- oh-my-customcodex R006: Agent Design (separation of concerns)
+- oh-my-customcodex compilation metaphor: skills = source, agents = build artifacts

package/templates/guides/slack-cli/README.md

@@ -0,0 +1,145 @@
+# Slack CLI Reference Guide
+
+> Source: https://docs.slack.dev/tools/slack-cli/ | Version: v3.15.0
+
+## Overview
+
+Slack CLI allows creating and managing Slack apps from the command line. Works with Deno Slack SDK and Bolt frameworks (JavaScript/Python).
+
+## Installation
+
+```bash
+# macOS/Linux
+curl -fsSL https://downloads.slack-edge.com/slack-cli/install.sh | bash
+
+# Verify
+slack version
+slack doctor
+```
+
+## Quick Start
+
+```bash
+# Login to workspace
+slack login
+
+# Create new app
+slack create my-app
+
+# Run locally (development)
+slack run
+
+# Deploy to production
+slack deploy
+```
+
+## Command Reference
+
+### App Management
+
+| Command | Description |
+|---------|-------------|
+| `slack create` | Create a new Slack project |
+| `slack run` | Start local development server |
+| `slack deploy` | Deploy app to Slack Platform |
+| `slack delete` | Delete an app |
+| `slack app install` | Install app to a workspace |
+| `slack app uninstall` | Uninstall app from a workspace |
+| `slack app list` | List installed apps |
+| `slack doctor` | System diagnostics |
+
+### Authentication
+
+| Command | Description |
+|---------|-------------|
+| `slack login` / `slack auth login` | Log in to Slack account |
+| `slack logout` / `slack auth logout` | Log out |
+| `slack auth list` | List authorizations |
+| `slack auth token` | Manage access tokens |
+| `slack auth revoke` | Revoke authorization |
+
+### Triggers
+
+| Command | Description |
+|---------|-------------|
+| `slack trigger create` | Create a new trigger |
+| `slack trigger update` | Update a trigger |
+| `slack trigger delete` | Delete a trigger |
+| `slack trigger list` | List all triggers |
+| `slack trigger info` | View trigger details |
+| `slack trigger access` | Manage trigger access |
+
+### Datastore
+
+| Command | Description |
+|---------|-------------|
+| `slack datastore put` | Add an item |
+| `slack datastore get` | Retrieve an item |
+| `slack datastore query` | Query items |
+| `slack datastore update` | Update an item |
+| `slack datastore delete` | Delete an item |
+| `slack datastore count` | Count items |
+| `slack datastore bulk-put` | Bulk add items |
+| `slack datastore bulk-get` | Bulk retrieve items |
+| `slack datastore bulk-delete` | Bulk delete items |
+
+### Environment Variables
+
+| Command | Description |
+|---------|-------------|
+| `slack env add` | Add environment variable |
+| `slack env list` | List environment variables |
+| `slack env remove` | Remove environment variable |
+
+### Collaboration
+
+| Command | Description |
+|---------|-------------|
+| `slack collaborator add` | Add a collaborator |
+| `slack collaborator list` | List collaborators |
+| `slack collaborator remove` | Remove a collaborator |
+
+### Project Management
+
+| Command | Description |
+|---------|-------------|
+| `slack init` | Initialize existing project for Slack CLI |
+| `slack manifest validate` | Validate app manifest |
+| `slack manifest info` | Display manifest information |
+| `slack samples` | List available sample apps |
+| `slack upgrade` | Check for CLI/SDK updates |
+
+## Common Workflows
+
+### Create and Deploy App
+
+```bash
+slack login                    # Authenticate
+slack create my-app            # Create project
+cd my-app
+slack run                      # Test locally
+slack deploy                   # Deploy to production
+slack trigger create           # Set up triggers
+```
+
+### Manage Environment
+
+```bash
+slack env add MY_KEY my_value  # Add env var
+slack env list                 # Verify
+slack env remove MY_KEY        # Remove
+```
+
+### Datastore Operations
+
+```bash
+slack datastore put '{"datastore":"tasks","item":{"id":"1","title":"Test"}}'
+slack datastore query '{"datastore":"tasks","expression":"id = :id","expression_values":{":id":"1"}}'
+```
+
+## Resources
+
+- Documentation: https://docs.slack.dev/tools/slack-cli/
+- Command Reference: https://docs.slack.dev/tools/slack-cli/reference/commands/slack/
+- GitHub: https://github.com/slackapi/slack-cli
+- Changelog: https://docs.slack.dev/changelog/

package/templates/guides/snowflake/README.md

@@ -0,0 +1,32 @@
+# Snowflake Guide
+
+Reference documentation for Snowflake cloud data warehouse best practices.
+
+## Source
+
+Based on [Snowflake official documentation](https://docs.snowflake.com/) and performance optimization guides.
+
+## Categories
+
+| Priority | Category | Impact |
+|----------|----------|--------|
+| 1 | Warehouse Design | CRITICAL |
+| 2 | Query Optimization | CRITICAL |
+| 3 | Data Loading | HIGH |
+| 4 | Storage & Clustering | HIGH |
+| 5 | Data Sharing | MEDIUM |
+| 6 | Security & Governance | MEDIUM |
+| 7 | Cost Management | LOW-MEDIUM |
+
+## Usage
+
+This guide is referenced by:
+- **Agent**: de-snowflake-expert
+- **Skill**: snowflake-best-practices
+
+## External Resources
+
+- [Snowflake Docs](https://docs.snowflake.com/)
+- [Snowflake Best Practices](https://docs.snowflake.com/en/user-guide/performance-query)
+- [Snowflake University](https://learn.snowflake.com/)
+- [Snowflake Community](https://community.snowflake.com/)

package/templates/guides/spark/README.md

@@ -0,0 +1,32 @@
+# Apache Spark Guide
+
+Reference documentation for Apache Spark distributed data processing best practices.
+
+## Source
+
+Based on [Apache Spark official documentation](https://spark.apache.org/docs/latest/) and performance tuning guides.
+
+## Categories
+
+| Priority | Category | Impact |
+|----------|----------|--------|
+| 1 | Performance Optimization | CRITICAL |
+| 2 | Data Processing | CRITICAL |
+| 3 | Resource Management | HIGH |
+| 4 | Structured Streaming | HIGH |
+| 5 | Storage Formats | MEDIUM |
+| 6 | Testing | MEDIUM |
+| 7 | Deployment & Monitoring | LOW-MEDIUM |
+
+## Usage
+
+This guide is referenced by:
+- **Agent**: de-spark-expert
+- **Skill**: spark-best-practices
+
+## External Resources
+
+- [Spark Official Docs](https://spark.apache.org/docs/latest/)
+- [Spark Performance Tuning](https://spark.apache.org/docs/latest/sql-performance-tuning.html)
+- [PySpark API Reference](https://spark.apache.org/docs/latest/api/python/)
+- [Spark SQL Guide](https://spark.apache.org/docs/latest/sql-programming-guide.html)