moai-adk 0.4.5__py3-none-any.whl → 0.20.1__py3-none-any.whl

moai_adk/templates/.claude/skills/moai-foundation-git/SKILL.md

@@ -1,90 +1,247 @@
 ---
-
 name: moai-foundation-git
-description: Git workflow automation (branching, TDD commits, PR management). Use when standardizing Git practices across the project.
+version: 2.0.0
+created: 2025-10-22
+updated: 2025-10-22
+status: active
+description: GitFlow automation and PR policy enforcement for MoAI-ADK workflows.
+keywords: ['git', 'gitflow', 'pr', 'automation']
 allowed-tools:
   - Read
   - Bash
-  - Write
-  - Edit
-  - TodoWrite
 ---
 
-# Alfred Git Workflow
+# Foundation Git Skill
 
 ## Skill Metadata
+
 | Field | Value |
 | ----- | ----- |
-| Allowed tools | Read (read_file), Write (write_file), Edit (edit_file), Bash (terminal), TodoWrite (todo_write) |
-| Auto-load | SessionStart (foundation bootstrap) |
-| Trigger cues | Branch creation, commit convention, PR readiness, and release gating requests. |
+| **Skill Name** | moai-foundation-git |
+| **Version** | 2.0.0 (2025-10-22) |
+| **Allowed tools** | Read (read_file), Bash (terminal) |
+| **Auto-load** | On demand when keywords detected |
+| **Tier** | Foundation |
+
+---
+
+## What It Does
+
+GitFlow automation and PR policy enforcement for MoAI-ADK workflows.
+
+**Key capabilities**:
+- ✅ Best practices enforcement for foundation domain
+- ✅ TRUST 5 principles integration
+- ✅ Latest tool versions (2025-10-22)
+- ✅ TDD workflow support
+
+---
 
-## What it does
+## When to Use
 
-Automates Git operations following MoAI-ADK conventions: branch creation, locale-based TDD commits, Draft PR creation, and PR Ready transition.
+**Automatic triggers**:
+- Related code discussions and file patterns
+- SPEC implementation (`/alfred:2-run`)
+- Code review requests
 
-## When to use
+**Manual invocation**:
+- Review code for TRUST 5 compliance
+- Design new features
+- Troubleshoot issues
 
-- Activates when Git workflow automation is needed for branching, commits, or PR promotion.
-- “Create branch”, “Create PR”, “Create commit”
-- Automatically invoked by `/alfred:1-plan`, `/alfred:2-run`, `/alfred:3-sync`
-- Git workflow automation needed
+---
+
+## Tool Version Matrix (2025-10-22)
+
+| Tool | Version | Purpose | Status |
+|------|---------|---------|--------|
+| **Git** | 2.47.0 | Primary | ✅ Current |
+| **GitHub CLI** | 2.63.0 | Primary | ✅ Current |
+
+---
 
-## How it works
+## v0.17.0: Three Flexible Git Workflows
+
+MoAI-ADK now supports **3 configurable SPEC development workflows** via `git.spec_git_workflow` setting:
+
+### 1️⃣ Feature Branch + PR (feature_branch)
+
+**Best for**: Team collaboration, code review, quality gates
 
-**1. Branch Creation**:
 ```bash
+# Create feature branch from develop
 git checkout develop
-git checkout -b feature/SPEC-AUTH-001
+git checkout -b feature/SPEC-001
+
+# Implement with TDD: RED → GREEN → REFACTOR
+git commit -m "🔴 RED: test description"
+git commit -m "🟢 GREEN: implementation description"
+git commit -m "♻️ REFACTOR: improvement description"
+
+# Create Draft PR
+gh pr create --draft --base develop --head feature/SPEC-001
+
+# After implementation complete
+git push origin feature/SPEC-001
+gh pr ready
+gh pr merge --squash --delete-branch
 ```
 
-**2. Locale-based TDD Commits**:
-- **Korean (ko)**: 🔴 RED: [Test Description]
-- **English (en)**: 🔴 RED: [Test description]
-- **Japanese (ja)**: 🔴 RED: [テスト説明]
-- **Chinese (zh)**: 🔴 RED: [测试说明]
+**Advantages**:
+- ✅ Code review before merge
+- ✅ CI/CD validation
+- ✅ Team discussion
+- ✅ Audit trail
 
-Configured via `.moai/config.json`:
-```json
-{"project": {"locale": "ko"}}
+**Disadvantages**:
+- ⏱️ Slower than direct commit
+- 📋 Requires PR review
+
+---
+
+### 2️⃣ Direct Commit to Develop (develop_direct)
+
+**Best for**: Rapid development, solo/trusted developers
+
+```bash
+# Work directly on develop
+git checkout develop
+
+# Implement with TDD: RED → GREEN → REFACTOR
+git commit -m "🔴 RED: test description"
+git commit -m "🟢 GREEN: implementation description"
+git commit -m "♻️ REFACTOR: improvement description"
+
+# Push to develop (no PR)
+git push origin develop
 ```
 
-**3. Draft PR Creation**:
-Creates Draft PR with SPEC reference and test checklist.
+**Advantages**:
+- ⚡ Fastest path to integration
+- 📝 Minimal overhead
+- 🚀 Suitable for rapid prototyping
+
+**Disadvantages**:
+- ⚠️ No review gate (requires trust)
+- 📊 Less audit trail
+
+---
+
+### 3️⃣ Ask Per SPEC (per_spec)
+
+**Best for**: Mixed team (hybrid review + direct approach)
 
-**4. PR Ready Transition** (via `/alfred:3-sync`):
-- Updates PR from Draft → Ready
-- Adds quality gate checklist
-- Verifies TRUST 5-principles
+**Behavior**: When creating each SPEC with `/alfred:1-plan`, Alfred asks:
 
-## Examples
-```markdown
-- Scan standard documents and report missing sections.
-- Changed regulations are reflected in CLAUDE.md.
 ```
+"Which git workflow for this SPEC?"
 
-## Best Practices
-- When changing standards, the reason for change and supporting documents are recorded.
-- Follow the single source principle and avoid modifying the same item in multiple places.
+Options:
+- 📋 Feature Branch + PR (recommended for team)
+- ⚡ Direct Commit to Develop (recommended for speed)
+```
+
+**Advantages**:
+- 🎯 Flexibility per feature
+- 👥 Team can choose per SPEC
+- 🔄 Combine both approaches
+
+**Disadvantages**:
+- 🤔 Manual decision per SPEC
+- ⚠️ Inconsistency if overused
+
+---
+
+## Configuration
+
+**Set workflow in `.moai/config.json`**:
+
+```json
+{
+  "git": {
+    "spec_git_workflow": "feature_branch"
+  }
+}
+```
+
+**Valid values**:
+- `"feature_branch"` - Always use PR workflow
+- `"develop_direct"` - Always direct commit
+- `"per_spec"` - Ask user for each SPEC
+
+---
 
 ## Inputs
-- Project standard documents (e.g. `CLAUDE.md`, `.moai/config.json`).
-- Latest printouts from relevant sub-agents.
+
+- Git configuration from `.moai/config.json`
+- SPEC metadata for branch naming
+- TDD phase information (RED/GREEN/REFACTOR)
 
 ## Outputs
-- Templates or policy summaries conforming to the MoAI-ADK standard.
-- Reusable rules/checklists.
+
+- Feature branch creation commands
+- Commit messages with @TAG references
+- PR status transitions
+- GitHub CLI commands for automation
 
 ## Failure Modes
-- When required standard files are missing or have limited access rights.
-- When conflicting policies are detected and coordination is required.
+
+- When Git is not installed
+- When invalid spec_git_workflow value in config
+- When PR merge conflicts occur
+- When CI/CD checks fail
 
 ## Dependencies
-- There is great synergy when called together with cc-manager.
+
+- Access to project files via Read/Bash tools
+- Git 2.47.0+ installed
+- GitHub CLI 2.63.0+ for PR operations
+- Integration with `moai-alfred-config-schema` for config reading
+- Integration with `moai-foundation-trust` for quality gates
+
+---
 
 ## References
-- Vincent Driessen. "A successful Git branching model." https://nvie.com/posts/a-successful-git-branching-model/ (accessed 2025-03-29).
-- GitHub Docs. "GitHub Flow." https://docs.github.com/en/get-started/using-github/github-flow (accessed 2025-03-29).
+
+- **Feature Branch Workflow**: SKILL.md "v0.17.0: Three Flexible Git Workflows"
+- **Direct Commit Workflow**: SKILL.md "v0.17.0: Three Flexible Git Workflows"
+- **Per-SPEC Workflow**: SKILL.md "v0.17.0: Three Flexible Git Workflows"
+
+_Documentation updated 2025-11-04_
+
+---
 
 ## Changelog
-- 2025-03-29: Foundation skill templates have been enhanced to align with best practice structures.
+
+- **v2.1.0** (2025-11-04): Added three configurable workflows (feature_branch, develop_direct, per_spec) and token management
+- **v2.0.0** (2025-10-22): Major update with latest tool versions, comprehensive best practices, TRUST 5 integration
+- **v1.0.0** (2025-03-29): Initial Skill release
+
+---
+
+## Works Well With
+
+- `moai-alfred-config-schema` (workflow configuration)
+- `moai-alfred-ask-user-questions` (per-spec workflow selection)
+- `moai-foundation-trust` (quality gates)
+- `moai-alfred-code-reviewer` (code review)
+- `moai-essentials-debug` (debugging support)
+
+---
+
+## Best Practices
+
+✅ **DO**:
+- Read `spec_git_workflow` from config before creating branch
+- Use feature branches for team projects
+- Use direct commits for solo/prototype work
+- Use per_spec for mixed team flexibility
+- Maintain test coverage ≥85% regardless of workflow
+- Document all public APIs
+
+❌ **DON'T**:
+- Skip quality gates based on workflow choice
+- Use deprecated tools
+- Ignore security warnings
+- Mix testing frameworks
+- Force workflow decisions on team members (use per_spec)

moai_adk/templates/.claude/skills/moai-foundation-git/examples.md

@@ -0,0 +1,29 @@
+# moai-foundation-git - Working Examples
+
+_Last updated: 2025-10-22_
+
+## Example 1: Basic Setup
+
+```bash
+# Setup commands
+# ...
+```
+
+## Example 2: TDD Workflow
+
+```bash
+# RED: Write failing test
+# GREEN: Implement feature
+# REFACTOR: Improve code
+```
+
+## Example 3: Quality Gate
+
+```bash
+# Run quality checks
+# Verify coverage ≥85%
+```
+
+---
+
+_For more examples, see SKILL.md reference section_

moai_adk/templates/.claude/skills/moai-foundation-git/reference.md

@@ -0,0 +1,29 @@
+# moai-foundation-git - CLI Reference
+
+_Last updated: 2025-10-22_
+
+## Quick Reference
+
+### Installation
+
+```bash
+# Installation commands
+```
+
+### Common Commands
+
+```bash
+# Test
+# Lint
+# Format
+# Build
+```
+
+## Tool Versions (2025-10-22)
+
+- **Git**: 2.47.0
+- **GitHub CLI**: 2.63.0
+
+---
+
+_For detailed usage, see SKILL.md_

moai_adk/templates/.claude/skills/moai-foundation-langs/SKILL.md

@@ -1,94 +1,113 @@
 ---
-
 name: moai-foundation-langs
-description: Auto-detects project language and framework (package.json, pyproject.toml, etc). Use when referencing multi-language conventions.
+version: 2.0.0
+created: 2025-10-22
+updated: 2025-10-22
+status: active
+description: Auto-detects project language from package.json, pyproject.toml, go.mod, Cargo.toml, etc.
+keywords: ['language', 'detection', 'framework', 'auto']
 allowed-tools:
   - Read
   - Bash
-  - Write
-  - Edit
-  - TodoWrite
 ---
 
-# Alfred Language Detection
+# Foundation Langs Skill
 
 ## Skill Metadata
+
 | Field | Value |
 | ----- | ----- |
-| Allowed tools | Read (read_file), Write (write_file), Edit (edit_file), Bash (terminal), TodoWrite (todo_write) |
-| Auto-load | SessionStart (foundation bootstrap) |
-| Trigger cues | Project language detection, toolchain hints, multi-language repository setup questions. |
-
-## What it does
-
-Automatically detects project's primary language and framework by scanning configuration files, then recommends appropriate testing tools and linters.
-
-## When to use
-
-- Activates when the conversation needs to detect project languages or recommend toolchains.
-- "Detect language", "Check project language", "Recommend testing tools"
-- Automatically invoked by `/alfred:0-project`, `/alfred:2-run`
-- Setting up new project
-
-## How it works
-
-**Configuration File Scanning**:
-- `package.json` → TypeScript/JavaScript (Jest/Vitest, ESLint/Biome)
-- `pyproject.toml` → Python (pytest, ruff, black)
-- `Cargo.toml` → Rust (cargo test, clippy, rustfmt)
-- `go.mod` → Go (go test, golint, gofmt)
-- `Gemfile` → Ruby (RSpec, RuboCop)
-- `pubspec.yaml` → Dart/Flutter (flutter test, dart analyze)
-- `build.gradle` → Java/Kotlin (JUnit, Checkstyle)
-- `Package.swift` → Swift (XCTest, SwiftLint)
-
-**Toolchain Recommendation**:
-```json
-{
-  "language": "Python",
-  "test_framework": "pytest",
-  "linter": "ruff",
-  "formatter": "black",
-  "type_checker": "mypy",
-  "package_manager": "uv"
-}
-```
-
-**Framework Detection**:
-- **Python**: FastAPI, Django, Flask
-- **TypeScript**: React, Next.js, Vue
-- **Java**: Spring Boot, Quarkus
-
-**Supported Languages**: Python, TypeScript, Java, Go, Rust, Ruby, Dart, Swift, Kotlin, PHP, C#, C++, Elixir, Scala, Clojure (20+ languages)
-
-## Examples
-```markdown
-- Scan standard documents and report missing sections.
-- Changed regulations are reflected in CLAUDE.md.
-```
+| **Skill Name** | moai-foundation-langs |
+| **Version** | 2.0.0 (2025-10-22) |
+| **Allowed tools** | Read (read_file), Bash (terminal) |
+| **Auto-load** | On demand when keywords detected |
+| **Tier** | Foundation |
 
-## Best Practices
-- When changing standards, the reason for change and supporting documents are recorded.
-- Follow the single source principle and avoid modifying the same item in multiple places.
+---
+
+## What It Does
+
+Auto-detects project language from package.json, pyproject.toml, go.mod, Cargo.toml, etc.
+
+**Key capabilities**:
+- ✅ Best practices enforcement for foundation domain
+- ✅ TRUST 5 principles integration
+- ✅ Latest tool versions (2025-10-22)
+- ✅ TDD workflow support
+
+---
+
+## When to Use
+
+**Automatic triggers**:
+- Related code discussions and file patterns
+- SPEC implementation (`/alfred:2-run`)
+- Code review requests
+
+**Manual invocation**:
+- Review code for TRUST 5 compliance
+- Design new features
+- Troubleshoot issues
+
+---
 
 ## Inputs
-- Project standard documents (e.g. `CLAUDE.md`, `.moai/config.json`).
-- Latest printouts from relevant sub-agents.
+
+- Language-specific source directories
+- Configuration files
+- Test suites and sample data
 
 ## Outputs
-- Templates or policy summaries conforming to the MoAI-ADK standard.
-- Reusable rules/checklists.
+
+- Test/lint execution plan
+- TRUST 5 review checkpoints
+- Migration guidance
 
 ## Failure Modes
-- When required standard files are missing or have limited access rights.
-- When conflicting policies are detected and coordination is required.
+
+- When required tools are not installed
+- When dependencies are missing
+- When test coverage falls below 85%
 
 ## Dependencies
-- There is great synergy when called together with cc-manager.
 
-## References
-- JetBrains. "Multi-language project organization." https://www.jetbrains.com/help/idea/project-tool-window.html (accessed 2025-03-29).
-- Stack Overflow. "Multi-language repository patterns." https://stackoverflow.blog/2020/04/20/the-developer's-guide-to-multi-language-repos/ (accessed 2025-03-29).
+- Access to project files via Read/Bash tools
+- Integration with `moai-foundation-langs` for language detection
+- Integration with `moai-foundation-trust` for quality gates
+
+---
+
+## References (Latest Documentation)
+
+_Documentation links updated 2025-10-22_
+
+---
 
 ## Changelog
-- 2025-03-29: Foundation skill templates have been enhanced to align with best practice structures.
+
+- **v2.0.0** (2025-10-22): Major update with latest tool versions, comprehensive best practices, TRUST 5 integration
+- **v1.0.0** (2025-03-29): Initial Skill release
+
+---
+
+## Works Well With
+
+- `moai-foundation-trust` (quality gates)
+- `moai-alfred-code-reviewer` (code review)
+- `moai-essentials-debug` (debugging support)
+
+---
+
+## Best Practices
+
+✅ **DO**:
+- Follow foundation best practices
+- Use latest stable tool versions
+- Maintain test coverage ≥85%
+- Document all public APIs
+
+❌ **DON'T**:
+- Skip quality gates
+- Use deprecated tools
+- Ignore security warnings
+- Mix testing frameworks

moai_adk/templates/.claude/skills/moai-foundation-langs/examples.md

@@ -0,0 +1,29 @@
+# moai-foundation-langs - Working Examples
+
+_Last updated: 2025-10-22_
+
+## Example 1: Basic Setup
+
+```bash
+# Setup commands
+# ...
+```
+
+## Example 2: TDD Workflow
+
+```bash
+# RED: Write failing test
+# GREEN: Implement feature
+# REFACTOR: Improve code
+```
+
+## Example 3: Quality Gate
+
+```bash
+# Run quality checks
+# Verify coverage ≥85%
+```
+
+---
+
+_For more examples, see SKILL.md reference section_

moai_adk/templates/.claude/skills/moai-foundation-langs/reference.md

@@ -0,0 +1,28 @@
+# moai-foundation-langs - CLI Reference
+
+_Last updated: 2025-10-22_
+
+## Quick Reference
+
+### Installation
+
+```bash
+# Installation commands
+```
+
+### Common Commands
+
+```bash
+# Test
+# Lint
+# Format
+# Build
+```
+
+## Tool Versions (2025-10-22)
+
+_No specific tool versions (workflow/process Skill)_
+
+---
+
+_For detailed usage, see SKILL.md_