moai-adk 0.10.1__py3-none-any.whl → 0.11.0__py3-none-any.whl

moai_adk/templates/.claude/skills/moai-alfred-ears-authoring/SKILL.md

@@ -1,113 +0,0 @@
----
-name: moai-alfred-ears-authoring
-version: 2.0.0
-created: 2025-10-22
-updated: 2025-10-22
-status: active
-description: EARS (Easy Approach to Requirements Syntax) authoring with 5 statement patterns for clear requirements.
-keywords: ['ears', 'requirements', 'specs', 'authoring']
-allowed-tools:
-  - Read
-  - Bash
----
-
-# Alfred Ears Authoring Skill
-
-## Skill Metadata
-
-| Field | Value |
-| ----- | ----- |
-| **Skill Name** | moai-alfred-ears-authoring |
-| **Version** | 2.0.0 (2025-10-22) |
-| **Allowed tools** | Read (read_file), Bash (terminal) |
-| **Auto-load** | On demand when keywords detected |
-| **Tier** | Alfred |
-
----
-
-## What It Does
-
-EARS (Easy Approach to Requirements Syntax) authoring with 5 statement patterns for clear requirements.
-
-**Key capabilities**:
-- ✅ Best practices enforcement for alfred 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
-
-- Language-specific source directories
-- Configuration files
-- Test suites and sample data
-
-## Outputs
-
-- Test/lint execution plan
-- TRUST 5 review checkpoints
-- Migration guidance
-
-## Failure Modes
-
-- When required tools are not installed
-- When dependencies are missing
-- When test coverage falls below 85%
-
-## Dependencies
-
-- 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
-
-- **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 alfred 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-alfred-ears-authoring/examples.md

@@ -1,29 +0,0 @@
-# moai-alfred-ears-authoring - 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-alfred-ears-authoring/reference.md

@@ -1,28 +0,0 @@
-# moai-alfred-ears-authoring - 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_

moai_adk/templates/.claude/skills/moai-alfred-git-workflow/SKILL.md

@@ -1,122 +0,0 @@
----
-name: moai-alfred-git-workflow
-version: 2.0.0
-created: 2025-10-22
-updated: 2025-10-22
-status: active
-description: GitFlow automation with feature branches, TDD commits, Draft PR, and PR Ready transitions.
-keywords: ['git', 'gitflow', 'pr', 'commits']
-allowed-tools:
-  - Read
-  - Bash
----
-
-# Alfred Git Workflow Skill
-
-## Skill Metadata
-
-| Field | Value |
-| ----- | ----- |
-| **Skill Name** | moai-alfred-git-workflow |
-| **Version** | 2.0.0 (2025-10-22) |
-| **Allowed tools** | Read (read_file), Bash (terminal) |
-| **Auto-load** | On demand when keywords detected |
-| **Tier** | Alfred |
-
----
-
-## What It Does
-
-GitFlow automation with feature branches, TDD commits, Draft PR, and PR Ready transitions.
-
-**Key capabilities**:
-- ✅ Best practices enforcement for alfred 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
-
----
-
-## Tool Version Matrix (2025-10-22)
-
-| Tool | Version | Purpose | Status |
-|------|---------|---------|--------|
-| **Git** | 2.47.0 | Primary | ✅ Current |
-| **GitHub CLI** | 2.63.0 | Primary | ✅ Current |
-
----
-
-## Inputs
-
-- Language-specific source directories
-- Configuration files
-- Test suites and sample data
-
-## Outputs
-
-- Test/lint execution plan
-- TRUST 5 review checkpoints
-- Migration guidance
-
-## Failure Modes
-
-- When required tools are not installed
-- When dependencies are missing
-- When test coverage falls below 85%
-
-## Dependencies
-
-- 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
-
-- **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 alfred 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-alfred-git-workflow/examples.md

@@ -1,29 +0,0 @@
-# moai-alfred-git-workflow - 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-alfred-git-workflow/reference.md

@@ -1,29 +0,0 @@
-# moai-alfred-git-workflow - 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-alfred-interactive-questions/SKILL.md

@@ -1,237 +0,0 @@
----
-name: moai-alfred-interactive-questions
-version: 3.1.0
-created: 2025-10-22
-updated: 2025-10-27
-status: active
-description: Guide Alfred sub-agents to actively invoke AskUserQuestion for ambiguous decisions.
-keywords: ['interactive', 'clarification', 'decision-making', 'AskUserQuestion']
-allowed-tools:
-  - AskUserQuestion
----
-
-# Alfred Interactive Questions - Skill Guide
-
-## Skill Metadata
-
-| Field | Value |
-| ----- | ----- |
-| **Skill Name** | moai-alfred-interactive-questions |
-| **Version** | 3.1.0 (2025-10-27) |
-| **Core Tool** | `AskUserQuestion` (Claude Code built-in) |
-| **Auto-load** | When Alfred detects ambiguity in requests |
-| **Tier** | Alfred (Workflow Orchestration) |
-
----
-
-## What It Does
-
-**Purpose**: Empower Alfred sub-agents to **actively ask clarifying questions** whenever user intent is ambiguous, rather than guessing.
-
-Leverages Claude Code's native `AskUserQuestion` tool to collect explicit, structured user input that transforms vague requests into precise specifications.
-
-**Key capabilities**:
-- ✅ Single-select & multi-select option types
-- ✅ 1-4 questions per survey (avoid fatigue)
-- ✅ 2-4 options per question (prevent choice overload)
-- ✅ Automatic "Other" option for custom input
-- ✅ Conditional branching based on answers
-- ✅ Integration across all Alfred commands (Plan/Run/Sync)
-- ✅ Reduces ambiguity → fewer iterations → faster execution
-
----
-
-## When to Ask (Trigger Patterns)
-
-### ✅ ASK when user intent is ambiguous:
-
-1. **Vague noun phrases**: "Add dashboard", "Refactor auth", "Improve performance"
-2. **Missing scope**: No specification of WHERE, WHO, WHAT, HOW, WHEN
-3. **Multiple valid paths**: ≥2 reasonable implementation approaches
-4. **Trade-off decisions**: Speed vs quality, simple vs comprehensive, etc.
-5. **Risky operations**: Destructive actions needing explicit consent
-
-### ❌ DON'T ask when:
-- User explicitly specified exact requirements
-- Decision is automatic (no choices)
-- Single obvious path exists
-- Quick yes/no confirmation only (maybe, but keep it brief)
-
----
-
-## Core Principle: Just Ask!
-
-**Golden Rule**: When in doubt, **ask the user** instead of guessing.
-
-**Why**:
-- ✅ User sees exactly what you'll do → no surprises
-- ✅ Single interaction vs 3-5 rounds of back-and-forth
-- ✅ Fast → execute with certainty
-- ✅ Reduces "vibe coding" frustration
-
-**Pattern**:
-```
-Ambiguous request detected
-         ↓
-Call AskUserQuestion({questions: [...]})
-         ↓
-User selects from clear options
-         ↓
-Proceed with confirmed specifications
-```
-
----
-
-## Quick Start: Minimal Invocation
-
-```typescript
-const answer = await AskUserQuestion({
-  questions: [
-    {
-      question: "How should we implement this?",
-      header: "Approach",          // max 12 chars
-      multiSelect: false,
-      options: [
-        {
-          label: "Option 1",       // 1-5 words
-          description: "What it does and why you'd pick it."
-        },
-        {
-          label: "Option 2",
-          description: "Alternative with different trade-offs."
-        }
-      ]
-    }
-  ]
-});
-
-// Returns: { "Approach": "Option 1" }
-```
-
----
-
-## Key Constraints
-
-| Constraint | Reason |
-|-----------|--------|
-| **1-4 questions max** | Avoid user fatigue |
-| **2-4 options per Q** | Prevent choice overload |
-| **Header ≤12 chars** | TUI layout fit |
-| **Label 1-5 words** | Quick scanning |
-| **Description required** | Enables informed choice |
-| **Auto "Other" option** | Always available for custom input |
-
----
-
-## Top 5 Usage Patterns
-
-### Pattern 1: Implementation Approach
-**Trigger**: "Add feature X" or "Build Y" without specifics
-
-### Pattern 2: Confirmation (Risky Operations)
-**Trigger**: Destructive action (delete, migrate, reset)
-
-### Pattern 3: Multi-Option Feature Selection
-**Trigger**: "Which framework/library/approach?"
-
-### Pattern 4: Multi-Select (Independent Features)
-**Trigger**: "Which features to enable/include?"
-
-### Pattern 5: Sequential Questions (Conditional Flow)
-**Trigger**: Dependent decisions (Q2 depends on Q1 answer)
-
-> **Detailed examples and code**: See [examples.md](examples.md)
-
----
-
-## Integration with Alfred Sub-agents
-
-| Sub-agent | When to Ask | Example Trigger |
-|-----------|-------------|-----------------|
-| **spec-builder** (`/alfred:1-plan`) | SPEC title vague, scope undefined | "Add feature" without specifics |
-| **code-builder** (`/alfred:2-run`) | Implementation approach unclear | Multiple valid implementation paths |
-| **doc-syncer** (`/alfred:3-sync`) | Sync scope unclear | Full vs partial sync decision |
-
-> **Detailed integration patterns**: See [reference.md](reference.md)
-
----
-
-## Best Practices Summary
-
-### ✅ DO
-- **Be specific**: "Which database type?" not "What should we use?"
-- **Provide context**: Include file names, scope, or impact
-- **Order logically**: General → Specific; safest option first
-- **Flag risks**: Use "NOT RECOMMENDED" or "CAUTION:" prefixes
-- **Explain trade-offs**: Mention time, resources, complexity
-
-### ❌ DON'T
-- **Overuse questions**: Only ask when ambiguous
-- **Too many options**: 2-4 per question max
-- **Vague labels**: "Option A", "Use tokens", "Option 2"
-- **Skip descriptions**: User needs rationale
-- **Hide trade-offs**: Always mention implications
-
-> **Complete best practices guide**: See [reference.md](reference.md)
-
----
-
-## Error Handling
-
-### User Cancels (ESC key)
-```typescript
-try {
-  const answer = await AskUserQuestion({...});
-} catch (error) {
-  console.log("User cancelled survey");
-  // Fall back to default or abort
-}
-```
-
-### Validate Custom Input ("Other" option)
-```typescript
-const answer = await AskUserQuestion({...});
-
-if (answer["Header"] === "Other" || !VALID_OPTIONS.includes(answer["Header"])) {
-  validateCustomInput(answer["Header"]);
-}
-```
-
----
-
-## Related Skills
-
-- `moai-alfred-spec-metadata-validation` (SPEC clarity)
-- `moai-alfred-ears-authoring` (requirement phrasing)
-- `moai-foundation-specs` (SPEC structure)
-
----
-
-## Quick Reference
-
-**When to use**:
-- User intent is ambiguous
-- Multiple valid approaches exist
-- Architectural decisions with trade-offs
-- Approvals needed before risky ops
-
-**How**:
-1. Detect ambiguity (vague request, multiple paths, etc.)
-2. Call `AskUserQuestion({ questions: [...] })`
-3. User selects from clear options
-4. Proceed with confirmed specifications
-
-**Benefits**:
-- ✅ Certainty instead of guessing
-- ✅ Single interaction vs 3-5 iterations
-- ✅ Faster, happier users
-- ✅ Less "vibe coding" frustration
-
----
-
-**For detailed API specifications**: [reference.md](reference.md)  
-**For real-world examples**: [examples.md](examples.md)
-
----
-
-**End of Skill** | Refactored 2025-10-27