moai-adk 0.8.0__py3-none-any.whl → 0.34.0__py3-none-any.whl

moai_adk/templates/.claude/skills/moai-cc-settings/SKILL.md

@@ -1,263 +0,0 @@
----
-name: moai-cc-settings
-description: "Configuring Claude Code settings.json & Security. Set up permissions (allow/deny), permission modes, environment variables, tool restrictions. Use when securing Claude Code, restricting tool access, or optimizing session settings."
-allowed-tools: "Read, Write, Edit, Bash"
----
-
-## Skill Metadata
-
-| Field | Value |
-| ----- | ----- |
-| Version | 1.0.0 |
-| Tier | Ops |
-| Auto-load | When configuring security & permissions |
-
-## What It Does
-
-settings.json 설정 및 보안 구성을 위한 전체 가이드를 제공합니다. Permissions (allow/deny), permission modes, environment variables, tool restrictions 설정 방법을 다룹니다.
-
-## When to Use
-
-- 새 프로젝트의 settings.json을 설정할 때
-- Tool access를 제한하거나 보안을 강화할 때
-- Environment variables를 구성할 때
-- Permission mode (ask/allow/deny)를 변경할 때
-
-
-# Configuring Claude Code settings.json
-
-`settings.json` centralizes all Claude Code configuration: permissions, tool access, environment variables, and session behavior.
-
-**Location**: `.claude/settings.json`
-
-## Complete Configuration Template
-
-```json
-{
-  "permissions": {
-    "allowedTools": [
-      "Read(**/*.{js,ts,json,md})",
-      "Edit(**/*.{js,ts})",
-      "Glob(**/*)",
-      "Grep(**/*)",
-      "Bash(git:*)",
-      "Bash(npm:*)",
-      "Bash(npm run:*)",
-      "Bash(pytest:*)",
-      "Bash(python:*)"
-    ],
-    "deniedTools": [
-      "Read(./.env)",
-      "Read(./.env.*)",
-      "Read(./secrets/**)",
-      "Bash(rm -rf:*)",
-      "Bash(sudo:*)",
-      "Bash(curl:*)"
-    ]
-  },
-  "permissionMode": "ask",
-  "spinnerTipsEnabled": true,
-  "disableAllHooks": false,
-  "env": {
-    "ANTHROPIC_API_KEY": "${ANTHROPIC_API_KEY}",
-    "GITHUB_TOKEN": "${GITHUB_TOKEN}",
-    "CLAUDE_CODE_ENABLE_TELEMETRY": "1"
-  },
-  "hooks": {
-    "PreToolUse": [
-      {
-        "matcher": "Bash",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "bash ~/.claude/hooks/pre-bash-check.sh"
-          }
-        ]
-      }
-    ],
-    "PostToolUse": [
-      {
-        "matcher": "Edit",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "bash ~/.claude/hooks/post-edit-format.sh"
-          }
-        ]
-      }
-    ],
-    "SessionStart": [
-      {
-        "matcher": "*",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "bash ~/.claude/hooks/session-init.sh"
-          }
-        ]
-      }
-    ]
-  },
-  "statusLine": {
-    "enabled": true,
-    "type": "command",
-    "command": "~/.claude/statusline.sh"
-  },
-  "mcpServers": {
-    "github": {
-      "command": "npx",
-      "args": ["-y", "@anthropic-ai/mcp-server-github"],
-      "oauth": {
-        "clientId": "${GITHUB_CLIENT_ID}",
-        "clientSecret": "${GITHUB_CLIENT_SECRET}",
-        "scopes": ["repo", "issues"]
-      }
-    },
-    "filesystem": {
-      "command": "npx",
-      "args": ["-y", "@modelcontextprotocol/server-filesystem", "${CLAUDE_PROJECT_DIR}/.moai", "${CLAUDE_PROJECT_DIR}/src"]
-    }
-  },
-  "extraKnownMarketplaces": [
-    {
-      "name": "company-plugins",
-      "url": "https://github.com/your-org/claude-plugins"
-    }
-  ]
-}
-```
-
-## Permission Modes
-
-| Mode | Behavior | Use Case |
-|------|----------|----------|
-| **allow** | Execute all allowed tools without asking | Trusted environments |
-| **ask** | Ask before executing each tool | Development (safer) |
-| **deny** | Deny all tools except whitelisted | Restrictive (default) |
-
-```json
-{
-  "permissionMode": "ask"
-}
-```
-
-## Tool Permission Patterns
-
-### Restrictive (Recommended for teams)
-```json
-{
-  "allowedTools": [
-    "Read(src/**)",
-    "Edit(src/**/*.ts)",
-    "Bash(npm run test:*)",
-    "Glob(src/**)"
-  ],
-  "deniedTools": [
-    "Bash(rm:*)",
-    "Bash(sudo:*)",
-    "Read(.env)"
-  ]
-}
-```
-
-### Permissive (Local development only)
-```json
-{
-  "allowedTools": [
-    "Read",
-    "Write",
-    "Edit",
-    "Bash(git:*)",
-    "Bash(npm:*)",
-    "Bash(python:*)",
-    "Glob",
-    "Grep"
-  ]
-}
-```
-
-## Environment Variables Pattern
-
-```json
-{
-  "env": {
-    "ANTHROPIC_API_KEY": "${ANTHROPIC_API_KEY}",
-    "GITHUB_TOKEN": "${GITHUB_TOKEN}",
-    "BRAVE_SEARCH_API_KEY": "${BRAVE_SEARCH_API_KEY}",
-    "NODE_ENV": "development"
-  }
-}
-```
-
-**Security rule**: Never hardcode secrets; always use `${VAR_NAME}` syntax.
-
-## Dangerous Tools to Deny
-
-```json
-{
-  "deniedTools": [
-    "Bash(rm -rf:*)",           // Recursive delete
-    "Bash(sudo:*)",             // Privilege escalation
-    "Bash(curl.*|.*bash)",      // Code injection
-    "Read(.env)",               // Secrets
-    "Read(.ssh/**)",            // SSH keys
-    "Read(/etc/shadow)",        // System secrets
-    "Edit(/etc/**)",            // System files
-  ]
-}
-```
-
-## Permission Validation
-
-```bash
-# Check current permissions
-cat .claude/settings.json | jq '.permissions'
-
-# Validate JSON syntax
-jq . .claude/settings.json
-
-# List allowed tools
-jq '.permissions.allowedTools[]' .claude/settings.json
-```
-
-## Spinner Tips Configuration
-
-```json
-{
-  "spinnerTipsEnabled": true
-}
-```
-
-Custom tips can be added for better UX during long operations.
-
-## Best Practices
-
-✅ **DO**:
-- Use `ask` mode for teams
-- Explicitly whitelist paths
-- Environment variables for all secrets
-- Review permissions regularly
-- Document why each denial exists
-
-❌ **DON'T**:
-- Hardcode credentials in settings.json
-- Use `allow` mode for untrusted contexts
-- Grant `Bash(*)` without restrictions
-- Include secrets in version control
-- Mix personal and project settings
-
-## Permission Checklist
-
-- [ ] All secrets use `${VAR_NAME}` syntax
-- [ ] Dangerous patterns are denied
-- [ ] File paths are explicit (not wildcards)
-- [ ] Permission mode matches use case (ask/allow/deny)
-- [ ] Hooks are not left in commented state
-- [ ] MCP servers have proper OAuth configuration
-- [ ] No `.env` file is readable
-- [ ] Sudo commands are denied
-
----
-
-**Reference**: Claude Code settings.json documentation
-**Version**: 1.0.0

moai_adk/templates/.claude/skills/moai-cc-settings/templates/settings-complete-template.json

@@ -1,30 +0,0 @@
-{
-  "permissions": {
-    "allowedTools": [
-      "Read(**/*.{js,ts,json,md})",
-      "Edit(**/*.{js,ts})",
-      "Glob(**/*)",
-      "Grep(**/*)",
-      "Bash(git:*)",
-      "Bash(npm:*)",
-      "Bash(npm run:*)",
-      "Bash(pytest:*)",
-      "Bash(python:*)"
-    ],
-    "deniedTools": [
-      "Read(./.env)",
-      "Read(./.env.*)",
-      "Read(./secrets/**)",
-      "Bash(rm -rf:*)",
-      "Bash(sudo:*)",
-      "Bash(curl:*)"
-    ]
-  },
-  "permissionMode": "ask",
-  "spinnerTipsEnabled": true,
-  "disableAllHooks": false,
-  "env": {
-    "ANTHROPIC_API_KEY": "${ANTHROPIC_API_KEY}",
-    "GITHUB_TOKEN": "${GITHUB_TOKEN}"
-  }
-}

moai_adk/templates/.claude/skills/moai-cc-skills/SKILL.md

@@ -1,291 +0,0 @@
----
-name: moai-cc-skills
-description: "Creating and Optimizing Claude Code Skills. Design reusable knowledge capsules with progressive disclosure (metadata → content → resources). Apply freedom levels (high/medium/low), create examples, validate YAML. Use when building domain-specific guidance or automating recurring patterns."
-allowed-tools: "Read, Write, Edit, Glob, Bash"
----
-
-## Skill Metadata
-
-| Field | Value |
-| ----- | ----- |
-| Version | 1.0.0 |
-| Tier | Ops |
-| Auto-load | When creating or updating Skills |
-
-## What It Does
-
-Claude Code Skill 생성 및 최적화를 위한 전체 가이드를 제공합니다. Progressive disclosure 패턴, freedom level framework, YAML metadata 작성, 예제 구성 방법을 다룹니다.
-
-## When to Use
-
-- 새로운 Skill을 생성할 때
-- 기존 Skill을 최적화하거나 리팩토링할 때
-- Freedom level (high/medium/low) 균형을 조정할 때
-- Skill metadata나 구조를 검증할 때
-
-
-# Creating and Optimizing Claude Code Skills
-
-Skills are modular, reusable knowledge capsules that load via Progressive Disclosure. They combine templates, patterns, and best practices without blocking user workflow.
-
-## Skill File Structure
-
-**Location**: `.claude/skills/skill-name/`
-
-```
-skill-name/
-├── SKILL.md              # Main instructions (~400 lines)
-├── reference.md          # Detailed reference (optional)
-├── examples.md           # Real-world examples (optional)
-├── CHECKLIST.md          # Validation guide (optional)
-├── scripts/              # Utility scripts
-│   ├── validator.sh
-│   └── formatter.py
-└── templates/            # Reusable templates
-    ├── config.json
-    └── main.md
-```
-
-## YAML Frontmatter
-
-```yaml
----
-name: "Skill Name (Gerund + Domain)"
-description: "Creating and Optimizing Claude Code Skills. [Capability]. Use when [trigger 1], [trigger 2], [trigger 3]."
-allowed-tools: "Read, Write, Bash(python:*)"
----
-```
-
-### Field Rules
-
-| Field | Max | Format | Example |
-|-------|-----|--------|---------|
-| `name` | 64 chars | Gerund + Domain | "Processing CSV Files with Python" |
-| `description` | 1024 chars | 3rd person, 3+ triggers | "Extract data, validate schema, merge datasets. Use when processing CSV, Excel files, or data cleaning." |
-| `allowed-tools` | — | Comma-separated minimal list | "Read, Bash(python:*), Bash(grep:*)" |
-
-## Freedom Level Framework
-
-| Freedom | % | Use Case | Content Style |
-|---------|---|----------|----------------|
-| **High** | 20-30% | Flexible, creative | Principles, trade-offs, decision trees |
-| **Medium** | 50-60% | Standard patterns | Pseudocode, flowcharts, templates |
-| **Low** | 10-20% | Deterministic, error-prone | Scripts, error handling, validation |
-
-### High-Freedom: Architecture Design
-
-```markdown
-## Architecture Trade-offs
-
-| Pattern | Pros | Cons | When |
-|---------|------|------|------|
-| Monolith | Simple, unified | Scales poorly | MVP, <10 people |
-| Microservices | Scalable, independent | Complex, distributed tracing | 10+ teams |
-| Serverless | Zero ops, elastic | Cold starts, vendor lock-in | Event-driven |
-
-Choose based on:
-1. **Team size**: Monolith if <5 devs
-2. **Scale**: Microservices if >10M requests/month
-3. **Budget**: Serverless if unpredictable workload
-```
-
-### Medium-Freedom: Data Validation Pattern
-
-```pseudocode
-## Validation Workflow
-
-1. Load data source (CSV, JSON, API)
-2. For each record:
-   a. Check required fields exist
-   b. Validate data types
-   c. Verify constraints (range, format)
-   d. Check references (foreign keys)
-3. Collect errors with row numbers
-4. Report summary + fix suggestions
-5. Proceed only if all errors fixed
-
-## Example: CSV Validation
-   - Input: data.csv
-   - Schema: validators/schema.json
-   - Output: validation_report.json
-```
-
-### Low-Freedom: Security Validator Script
-
-```python
-#!/usr/bin/env python3
-"""Validate code for OWASP Top 10 risks"""
-import re
-import sys
-
-PATTERNS = [
-    (r"eval\(", "OWASP-A1: Code injection risk"),
-    (r"SELECT.*\$", "OWASP-A3: SQL injection risk"),
-    (r"os\.system\(", "OWASP-A6: Command injection risk"),
-]
-
-def validate_file(filepath):
-    with open(filepath) as f:
-        content = f.read()
-
-    issues = []
-    for pattern, risk in PATTERNS:
-        if re.search(pattern, content):
-            issues.append(risk)
-
-    return issues
-
-if __name__ == "__main__":
-    for filepath in sys.argv[1:]:
-        issues = validate_file(filepath)
-        if issues:
-            print(f"⚠️  {filepath}:")
-            for issue in issues:
-                print(f"  • {issue}")
-```
-
-## Progressive Disclosure Pattern
-
-**Level 1**: Metadata (always loaded)
-```yaml
-name: "Database Query Optimization"
-description: "Creating and Optimizing Claude Code Skills. Profile slow queries, analyze execution plans, suggest indexes..."
-allowed-tools: "Read, Bash(sqlite3:*)"
-```
-
-**Level 2**: Main content (on demand)
-- Overview + quick start
-- 3-4 core patterns
-- Decision tree
-
-**Level 3**: Resources (when referenced)
-- `reference.md` — Detailed specs
-- `examples.md` — Real-world scenarios
-- `scripts/` — Utility tools
-
-## Skill Discovery Keywords
-
-Embed in description for auto-activation:
-
-✅ **DO** include:
-- Problem domain: "CSV", "SQL", "React", "API"
-- Operation: "parsing", "validation", "optimization", "debugging"
-- Tech stack: "Python", "TypeScript", "Go"
-
-Example description:
-```
-"Parse CSV files, validate data schemas, clean datasets.
-Use when processing CSV, Excel, JSON data or when user mentions
-data cleaning, validation, or transformation."
-```
-
-## Medium-Freedom: Example Skill Template
-
-```yaml
----
-name: "Testing React Components with Vitest"
-description: "Creating and Optimizing Claude Code Skills. Write unit tests for React components, mock hooks, test async behavior. Use when testing React components, setting up Vitest, or debugging test failures."
-allowed-tools: "Read, Write, Bash(npm:*), Bash(npm run:*)"
----
-
-# Testing React Components with Vitest
-
-## Quick Start
-
-1. Install: `npm install -D vitest @testing-library/react`
-2. Create test: `src/Component.test.tsx`
-3. Run: `npm run test`
-
-## Core Patterns
-
-### Pattern 1: Basic Component Test
-```typescript
-import { render, screen } from '@testing-library/react'
-import { Button } from './Button'
-
-it('renders button with text', () => {
-  render(<Button>Click me</Button>)
-  expect(screen.getByText('Click me')).toBeInTheDocument()
-})
-```
-
-### Pattern 2: Mock Hooks
-```typescript
-import { useUserStore } from './store'
-
-vi.mock('./store', () => ({
-  useUserStore: vi.fn(() => ({ user: null }))
-}))
-```
-
-## Examples
-
-See [examples.md](examples.md) for integration with Redux, React Query, form testing.
-```
-
-## Skill Validation Checklist
-
-- [ ] `name` is specific (not "React Helper")
-- [ ] `description` includes 3+ discovery keywords
-- [ ] Main content ≤ 500 lines
-- [ ] At least 2 concrete examples
-- [ ] Progressive Disclosure applied (metadata → content → resources)
-- [ ] Freedom levels mixed appropriately
-- [ ] No hardcoded paths or time-sensitive data
-- [ ] YAML frontmatter is valid
-- [ ] Paths use forward slashes (`/` not `\`)
-
-## Skill Optimization Patterns
-
-### Anti-pattern 1: Too Generic
-```yaml
-❌ name: "Python Helper"
-✅ name: "Testing Python Code with pytest"
-```
-
-### Anti-pattern 2: No Examples
-```yaml
-❌ Only principles, no code samples
-✅ Each concept has working example
-```
-
-### Anti-pattern 3: Nested Files
-```yaml
-❌ docs/api/v2/reference/security.md
-✅ reference.md (one level)
-```
-
-### Anti-pattern 4: Absolute Paths
-```yaml
-❌ /Users/name/project/config.json
-✅ ./config.json or ${PROJECT_DIR}/config.json
-```
-
-## Best Practices
-
-✅ **DO**:
-- Keep < 500 lines per SKILL.md
-- Use relative paths with forward slashes
-- Provide working code examples
-- Design for reusability across projects
-- Include both success and error paths
-
-❌ **DON'T**:
-- Mix too many domains (split into separate Skills)
-- Explain fundamentals (trust Claude already knows)
-- Create nested directory structures
-- Include time-sensitive info (dates, versions)
-- Use Windows-style paths
-
-## Skill Lifecycle
-
-1. **Create**: Design persona, scope, freedom levels
-2. **Implement**: Write SKILL.md + examples
-3. **Test**: Verify with Haiku, Sonnet, Opus
-4. **Deploy**: Add to `.claude/skills/`
-5. **Iterate**: Get feedback, update as needed
-
----
-
-**Reference**: Claude Code Skills official documentation
-**Version**: 1.0.0

moai_adk/templates/.claude/skills/moai-cc-skills/templates/SKILL-template.md

@@ -1,15 +0,0 @@
----
-name: "Skill Name (Gerund + Domain)"
-description: "[Capability]. Use when [trigger 1], [trigger 2], [trigger 3]."
-allowed-tools: "Read, Write, Bash(python:*)"
----
-
-# Skill Name
-
-## Quick Start
-
-## Core Patterns
-
-## Examples
-
-See examples.md for real-world scenarios.