amazingteam 3.0.0

package/presets/default.yaml

@@ -0,0 +1,161 @@
+# AmazingTeam Foundation - Default Configuration Preset
+# This is the base configuration that all other presets extend from.
+
+version: "1.0"
+
+project:
+  name: ""
+  description: ""
+  language: "typescript"
+  framework: "node"
+
+ai_team:
+  version: "3.0.0"
+
+agents:
+  planner:
+    enabled: true
+    description: "Decomposes tasks and coordinates workflow progression"
+    skills: ["task-breakdown-and-dispatch"]
+    memory:
+      read: ["docs/", "AGENTS.md", ".amazingteam/memory/planner/", ".amazingteam/memory/architect/", ".amazingteam/memory/triage/", ".amazingteam/memory/failures/", "tasks/"]
+      write: [".amazingteam/memory/planner/", "tasks/{task_id}/task.yaml"]
+
+  architect:
+    enabled: true
+    description: "Analyzes requirements and designs solutions"
+    skills: ["repo-architecture-reader"]
+    memory:
+      read: ["docs/", "AGENTS.md", ".amazingteam/memory/planner/", ".amazingteam/memory/architect/", ".amazingteam/memory/developer/", ".amazingteam/memory/failures/", "tasks/"]
+      write: [".amazingteam/memory/architect/", "tasks/{task_id}/analysis.md", "tasks/{task_id}/design.md"]
+
+  developer:
+    enabled: true
+    description: "Implements features and fixes bugs"
+    skills: ["test-first-feature-dev", "bugfix-playbook"]
+    memory:
+      read: ["docs/", "AGENTS.md", ".amazingteam/memory/planner/", ".amazingteam/memory/architect/", ".amazingteam/memory/developer/", ".amazingteam/memory/failures/", "tasks/{task_id}/"]
+      write: [".amazingteam/memory/developer/", "tasks/{task_id}/implementation.md", "src/", "tests/"]
+
+  qa:
+    enabled: true
+    description: "Validates implementations and ensures quality"
+    skills: ["test-first-feature-dev", "regression-checklist"]
+    memory:
+      read: ["docs/", "AGENTS.md", ".amazingteam/memory/planner/", ".amazingteam/memory/architect/", ".amazingteam/memory/qa/", ".amazingteam/memory/failures/", "tasks/{task_id}/"]
+      write: [".amazingteam/memory/qa/", "tasks/{task_id}/validation.md", "tests/"]
+
+  reviewer:
+    enabled: true
+    description: "Reviews code for quality and correctness"
+    skills: ["safe-refactor-checklist", "regression-checklist", "release-readiness-check"]
+    memory:
+      read: ["docs/", "AGENTS.md", ".amazingteam/memory/", ".amazingteam/memory/failures/", "tasks/{task_id}/"]
+      write: [".amazingteam/memory/reviewer/", "tasks/{task_id}/review.md", "tasks/{task_id}/release.md"]
+
+  triage:
+    enabled: true
+    description: "Classifies issues and performs first-pass debug analysis"
+    skills: ["issue-triage", "bugfix-playbook"]
+    memory:
+      read: ["docs/", "AGENTS.md", ".amazingteam/memory/triage/", ".amazingteam/memory/failures/", "tasks/{task_id}/"]
+      write: [".amazingteam/memory/triage/", "tasks/{task_id}/"]
+
+  ci_analyst:
+    enabled: true
+    description: "Investigates CI failures and documents patterns"
+    skills: ["ci-failure-analysis", "bugfix-playbook"]
+    memory:
+      read: ["docs/", "AGENTS.md", ".amazingteam/memory/ci-analyst/", ".amazingteam/memory/failures/", "tasks/{task_id}/", "docs/runbooks/ci/"]
+      write: [".amazingteam/memory/ci-analyst/", ".amazingteam/memory/failures/", "tasks/{task_id}/"]
+
+workflows:
+  feature:
+    sequence: ["planner", "architect", "developer", "qa", "reviewer"]
+    description: "Feature development workflow"
+
+  bugfix:
+    sequence: ["triage", "architect", "developer", "qa", "reviewer"]
+    description: "Bug fix workflow"
+
+  refactor:
+    sequence: ["architect", "developer", "reviewer"]
+    description: "Refactoring workflow"
+
+  ci_failure:
+    sequence: ["ci_analyst", "developer", "qa"]
+    description: "CI failure resolution workflow"
+
+  release:
+    sequence: ["reviewer"]
+    description: "Release validation workflow"
+
+memory:
+  global:
+    locations: ["docs/", "AGENTS.md"]
+    write_requires_approval: true
+
+  role:
+    base_path: ".amazingteam/memory"
+    roles:
+      planner:
+        files: ["decomposition_notes.md", "flow_rules.md", "github_issue_patterns.md"]
+      architect:
+        files: ["architecture_notes.md", "module_map.md", "design_rationale.md"]
+      developer:
+        files: ["implementation_notes.md", "bug_investigation.md", "build_issues.md"]
+      qa:
+        files: ["test_strategy.md", "regression_cases.md", "validation_notes.md"]
+      reviewer:
+        files: ["review_notes.md", "quality_rules.md", "recurring_risks.md"]
+      triage:
+        files: ["classification_heuristics.md", "debug_notes.md"]
+      ci_analyst:
+        files: ["failure_patterns.md", "runbook_references.md"]
+
+  failures:
+    path: ".amazingteam/memory/failures"
+    files: ["failure_library.md"]
+    writable_by: ["ci_analyst"]
+
+  task:
+    base_path: "tasks"
+    naming: "issue-{issue_id}"
+    files: ["task.yaml", "analysis.md", "design.md", "implementation.md", "validation.md", "review.md", "release.md"]
+    auto_create: true
+    preserve_after_completion: true
+
+rules:
+  max_changes_per_commit: 10
+  require_tests: true
+  require_review: true
+  auto_merge: false
+  memory_isolation: true
+  protected_paths:
+    - "docs/architecture/"
+    - "docs/decisions/"
+  human_approval_required:
+    - "architecture changes"
+    - "release operations"
+    - "breaking changes"
+
+integrations:
+  github:
+    enabled: true
+    auto_label: true
+    auto_assign: true
+
+  ci:
+    enabled: true
+    require_passing: true
+    failure_analysis:
+      enabled: true
+      agent: "ci_analyst"
+
+build:
+  command: ""
+  test: ""
+  lint: ""
+  typecheck: ""
+
+overlay: null

package/presets/go.yaml

@@ -0,0 +1,43 @@
+# Go Configuration Preset
+# For Go microservices and backend projects
+
+$preset: "default"
+
+project:
+  language: "go"
+  framework: "gin"
+
+build:
+  command: "go build ./..."
+  test: "go test ./..."
+  lint: "golangci-lint run"
+  typecheck: ""
+
+rules:
+  test_coverage_threshold: 70
+  max_function_lines: 40
+  commit_convention: "conventional"
+  go:
+    max_file_lines: 500
+    error_handling: "explicit"
+
+agents:
+  developer:
+    skills: ["test-first-feature-dev", "bugfix-playbook"]
+    memory:
+      write: [".amazingteam/memory/developer/", "tasks/{task_id}/implementation.md", "pkg/", "internal/", "tests/"]
+
+  qa:
+    skills: ["test-first-feature-dev", "regression-checklist"]
+    memory:
+      write: [".amazingteam/memory/qa/", "tasks/{task_id}/validation.md", "tests/"]
+
+integrations:
+  ci:
+    enabled: true
+    require_passing: true
+    commands:
+      install: "go mod download"
+      build: "go build ./..."
+      test: "go test -v -race -coverprofile=coverage.out ./..."
+      lint: "golangci-lint run"

package/presets/python.yaml

@@ -0,0 +1,43 @@
+# Python Configuration Preset
+# For Python backend projects
+
+$preset: "default"
+
+project:
+  language: "python"
+  framework: "fastapi"
+
+build:
+  command: "python -m build"
+  test: "pytest"
+  lint: "ruff check ."
+  typecheck: "mypy ."
+
+rules:
+  test_coverage_threshold: 80
+  max_function_lines: 30
+  commit_convention: "conventional"
+  python:
+    max_line_length: 88
+    docstring_style: "google"
+
+agents:
+  developer:
+    skills: ["test-first-feature-dev", "bugfix-playbook"]
+    memory:
+      write: [".amazingteam/memory/developer/", "tasks/{task_id}/implementation.md", "src/", "tests/"]
+
+  qa:
+    skills: ["test-first-feature-dev", "regression-checklist"]
+    memory:
+      write: [".amazingteam/memory/qa/", "tasks/{task_id}/validation.md", "tests/"]
+
+integrations:
+  ci:
+    enabled: true
+    require_passing: true
+    commands:
+      install: "pip install -r requirements.txt"
+      build: "python -m build"
+      test: "pytest --cov"
+      lint: "ruff check . && mypy ."

package/presets/typescript.yaml

@@ -0,0 +1,40 @@
+# TypeScript/Node.js Configuration Preset
+# Extends default.yaml with TypeScript-specific settings
+
+$preset: "default"
+
+project:
+  language: "typescript"
+  framework: "node"
+
+build:
+  command: "npm run build"
+  test: "npm test"
+  lint: "npm run lint"
+  typecheck: "npm run typecheck"
+
+rules:
+  test_coverage_threshold: 80
+  max_function_lines: 30
+  commit_convention: "conventional"
+
+agents:
+  developer:
+    skills: ["test-first-feature-dev", "bugfix-playbook"]
+    memory:
+      write: [".amazingteam/memory/developer/", "tasks/{task_id}/implementation.md", "src/", "tests/"]
+
+  qa:
+    skills: ["test-first-feature-dev", "regression-checklist"]
+    memory:
+      write: [".amazingteam/memory/qa/", "tasks/{task_id}/validation.md", "tests/"]
+
+integrations:
+  ci:
+    enabled: true
+    require_passing: true
+    commands:
+      install: "npm ci"
+      build: "npm run build"
+      test: "npm test"
+      lint: "npm run lint"

package/schemas/config.schema.json

@@ -0,0 +1,239 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://amazingteam.dev/schemas/config.schema.json",
+  "title": "AmazingTeam Configuration",
+  "description": "Configuration schema for AmazingTeam Foundation v3",
+  "type": "object",
+  "required": ["version", "project"],
+  "additionalProperties": false,
+  "properties": {
+    "version": {
+      "type": "string",
+      "pattern": "^\\d+\\.\\d+\\.\\d+$",
+      "description": "Configuration file version (semver)"
+    },
+    "$preset": {
+      "type": "string",
+      "description": "Base preset to extend (default, typescript, python, go)"
+    },
+    "project": {
+      "type": "object",
+      "required": ["name", "language"],
+      "properties": {
+        "name": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Project name"
+        },
+        "description": {
+          "type": "string",
+          "description": "Project description"
+        },
+        "language": {
+          "type": "string",
+          "enum": ["typescript", "javascript", "python", "go", "java", "cpp", "c", "rust", "ruby"],
+          "description": "Primary programming language"
+        },
+        "framework": {
+          "type": "string",
+          "description": "Primary framework (e.g., node, react, fastapi, gin)"
+        }
+      }
+    },
+    "ai_team": {
+      "type": "object",
+      "properties": {
+        "version": {
+          "type": "string",
+          "pattern": "^\\d+\\.\\d+\\.\\d+$",
+          "description": "AmazingTeam Foundation version"
+        }
+      }
+    },
+    "agents": {
+      "type": "object",
+      "description": "Agent configuration overrides",
+      "properties": {
+        "planner": { "$ref": "#/definitions/agent" },
+        "architect": { "$ref": "#/definitions/agent" },
+        "developer": { "$ref": "#/definitions/agent" },
+        "qa": { "$ref": "#/definitions/agent" },
+        "reviewer": { "$ref": "#/definitions/agent" },
+        "triage": { "$ref": "#/definitions/agent" },
+        "ci_analyst": { "$ref": "#/definitions/agent" }
+      }
+    },
+    "workflows": {
+      "type": "object",
+      "description": "Workflow definitions",
+      "additionalProperties": {
+        "type": "object",
+        "required": ["sequence"],
+        "properties": {
+          "sequence": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "enum": ["planner", "architect", "developer", "qa", "reviewer", "triage", "ci_analyst"]
+            }
+          },
+          "description": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    "memory": {
+      "type": "object",
+      "properties": {
+        "global": {
+          "type": "object",
+          "properties": {
+            "locations": {
+              "type": "array",
+              "items": { "type": "string" }
+            },
+            "write_requires_approval": {
+              "type": "boolean"
+            }
+          }
+        },
+        "role": {
+          "type": "object",
+          "properties": {
+            "base_path": { "type": "string" }
+          }
+        },
+        "failures": {
+          "type": "object",
+          "properties": {
+            "path": { "type": "string" },
+            "writable_by": {
+              "type": "array",
+              "items": { "type": "string" }
+            }
+          }
+        },
+        "task": {
+          "type": "object",
+          "properties": {
+            "base_path": { "type": "string" },
+            "naming": { "type": "string" },
+            "auto_create": { "type": "boolean" },
+            "preserve_after_completion": { "type": "boolean" }
+          }
+        }
+      }
+    },
+    "rules": {
+      "type": "object",
+      "properties": {
+        "max_changes_per_commit": {
+          "type": "integer",
+          "minimum": 1
+        },
+        "require_tests": { "type": "boolean" },
+        "require_review": { "type": "boolean" },
+        "auto_merge": { "type": "boolean" },
+        "memory_isolation": { "type": "boolean" },
+        "test_coverage_threshold": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 100
+        },
+        "max_function_lines": {
+          "type": "integer",
+          "minimum": 1
+        },
+        "commit_convention": {
+          "type": "string",
+          "enum": ["conventional", "none"]
+        },
+        "protected_paths": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "human_approval_required": {
+          "type": "array",
+          "items": { "type": "string" }
+        }
+      }
+    },
+    "build": {
+      "type": "object",
+      "description": "Build and test commands",
+      "properties": {
+        "command": { "type": "string" },
+        "test": { "type": "string" },
+        "lint": { "type": "string" },
+        "typecheck": { "type": "string" }
+      }
+    },
+    "integrations": {
+      "type": "object",
+      "properties": {
+        "github": {
+          "type": "object",
+          "properties": {
+            "enabled": { "type": "boolean" },
+            "auto_label": { "type": "boolean" },
+            "auto_assign": { "type": "boolean" }
+          }
+        },
+        "ci": {
+          "type": "object",
+          "properties": {
+            "enabled": { "type": "boolean" },
+            "require_passing": { "type": "boolean" },
+            "commands": {
+              "type": "object",
+              "properties": {
+                "install": { "type": "string" },
+                "build": { "type": "string" },
+                "test": { "type": "string" },
+                "lint": { "type": "string" }
+              }
+            }
+          }
+        }
+      }
+    },
+    "overlay": {
+      "type": ["string", "null"],
+      "description": "Technology overlay to apply (e.g., python-backend, web-fullstack)"
+    }
+  },
+  "definitions": {
+    "agent": {
+      "type": "object",
+      "properties": {
+        "enabled": {
+          "type": "boolean",
+          "description": "Enable or disable this agent"
+        },
+        "description": {
+          "type": "string",
+          "description": "Agent description override"
+        },
+        "skills": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Skills assigned to this agent"
+        },
+        "memory": {
+          "type": "object",
+          "properties": {
+            "read": {
+              "type": "array",
+              "items": { "type": "string" }
+            },
+            "write": {
+              "type": "array",
+              "items": { "type": "string" }
+            }
+          }
+        }
+      }
+    }
+  }
+}

package/scripts/diff_foundation_vs_project.sh

@@ -0,0 +1,134 @@
+#!/bin/bash
+# diff_foundation_vs_project.sh
+# Compare foundation and project files
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+FOUNDATION_ROOT="$(dirname "$SCRIPT_DIR")"
+PROJECT_ROOT="${1:-.}"
+
+# Colors
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+CYAN='\033[0;36m'
+NC='\033[0m'
+
+usage() {
+    echo "Usage: $0 [project-path] [file-pattern]"
+    echo ""
+    echo "Compare foundation and project files."
+    echo ""
+    echo "Options:"
+    echo "  -h, --help    Show this help message"
+    echo ""
+    echo "Examples:"
+    echo "  $0 ./my-project"
+    echo "  $0 ./my-project .ai-team/agents/planner.md"
+}
+
+# Resolve to absolute path
+if [[ "${PROJECT_ROOT:0:1}" != "/" ]]; then
+    PROJECT_ROOT="$(pwd)/$PROJECT_ROOT"
+fi
+
+FILE_PATTERN="${2:-}"
+
+echo -e "${CYAN}══════════════════════════════════════════════════${NC}"
+echo -e "${CYAN}  Foundation vs Project Diff${NC}"
+echo -e "${CYAN}══════════════════════════════════════════════════${NC}"
+echo ""
+
+echo -e "${CYAN}Foundation:${NC} $FOUNDATION_ROOT"
+echo -e "${CYAN}Project:${NC}    $PROJECT_ROOT"
+echo ""
+
+# Classify a file
+classify_file() {
+    local file="$1"
+    
+    # Class C (Protected)
+    if [[ "$file" == docs/architecture/* ]] || [[ "$file" == docs/decisions/* ]]; then
+        echo -e "${RED}[Class C - Protected]${NC}"
+        return
+    fi
+    
+    # Class B (Review required)
+    if [[ "$file" == .ai-team/agents/* ]] || \
+       [[ "$file" == .ai-team/skills/* ]] || \
+       [[ "$file" == .ai-team/commands/* ]] || \
+       [[ "$file" == .github/workflows/* ]] || \
+       [[ "$file" == AGENTS.md ]]; then
+        echo -e "${YELLOW}[Class B - Review Required]${NC}"
+        return
+    fi
+    
+    # Class A (Auto-generatable)
+    echo -e "${GREEN}[Class A - Auto-generatable]${NC}"
+}
+
+# Compare a single file
+compare_file() {
+    local relative_path="$1"
+    local foundation_file="$FOUNDATION_ROOT/$relative_path"
+    local project_file="$PROJECT_ROOT/$relative_path"
+    
+    echo -e "${CYAN}────────────────────────────────────────────────${NC}"
+    echo -e "File: $relative_path"
+    classify_file "$relative_path"
+    echo ""
+    
+    if [[ ! -f "$foundation_file" ]]; then
+        echo -e "${YELLOW}Not in foundation (project-specific)${NC}"
+        return
+    fi
+    
+    if [[ ! -f "$project_file" ]]; then
+        echo -e "${YELLOW}Not in project (missing)${NC}"
+        return
+    fi
+    
+    if diff -q "$foundation_file" "$project_file" > /dev/null 2>&1; then
+        echo -e "${GREEN}Identical${NC}"
+    else
+        echo -e "${YELLOW}Different:${NC}"
+        echo ""
+        diff -u "$foundation_file" "$project_file" | head -50
+        echo ""
+    fi
+}
+
+# Compare all files or specific file
+if [[ -n "$FILE_PATTERN" ]]; then
+    compare_file "$FILE_PATTERN"
+else
+    # Compare key files
+    FILES_TO_COMPARE=(
+        "AGENTS.md"
+        ".ai-team/agents/planner.md"
+        ".ai-team/agents/architect.md"
+        ".ai-team/agents/developer.md"
+        ".ai-team/agents/qa.md"
+        ".ai-team/agents/reviewer.md"
+        ".ai-team/agents/triage.md"
+        ".ai-team/agents/ci-analyst.md"
+        ".github/workflows/opencode.yml"
+        ".github/workflows/ci.yml"
+    )
+    
+    for file in "${FILES_TO_COMPARE[@]}"; do
+        compare_file "$file"
+    done
+fi
+
+echo ""
+echo -e "${CYAN}══════════════════════════════════════════════════${NC}"
+echo -e "${CYAN}Classification Legend${NC}"
+echo -e "${CYAN}══════════════════════════════════════════════════${NC}"
+echo ""
+echo -e "  ${GREEN}[Class A]${NC} Auto-generatable - Safe to create/replace"
+echo -e "  ${YELLOW}[Class B]${NC} Review required - Generate diff, human reviews"
+echo -e "  ${RED}[Class C]${NC} Protected - Human approval mandatory"
+echo ""