amazingteam 3.0.0

package/.ai-team/workflows/nightly-ai-maintenance.yml

@@ -0,0 +1,129 @@
+name: Nightly AI Maintenance
+
+on:
+  schedule:
+    - cron: '0 2 * * *'
+  workflow_dispatch:
+
+jobs:
+  memory-cleanup:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      
+      - name: Check Task Memory
+        run: |
+          echo "Checking task memory directories..."
+          TASKS_DIR="tasks"
+          
+          if [ -d "$TASKS_DIR" ]; then
+            for task_dir in "$TASKS_DIR"/issue-*/; do
+              if [ -d "$task_dir" ]; then
+                issue_num=$(basename "$task_dir" | sed 's/issue-//')
+                echo "Checking task for issue #$issue_num"
+              fi
+            done
+          else
+            echo "No tasks directory found"
+          fi
+
+      - name: Memory Statistics
+        run: |
+          echo "=== Memory Statistics ==="
+          
+          echo ""
+          echo "Role Memory Files:"
+          if [ -d ".ai-team/memory" ]; then
+            find .ai-team/memory -name "*.md" -exec wc -l {} \; 2>/dev/null || echo "No memory files found"
+          else
+            echo "No .ai-team/memory directory found"
+          fi
+          
+          echo ""
+          echo "Task Memory Directories:"
+          find tasks -type d -name "issue-*" 2>/dev/null | wc -l
+
+      - name: Archive Completed Tasks
+        run: |
+          echo "Archiving completed task memory..."
+          
+          ARCHIVE_DIR="tasks/.archive"
+          mkdir -p "$ARCHIVE_DIR"
+          
+          if [ -d "tasks" ]; then
+            echo "Task directory exists, checking for archived items..."
+          fi
+
+  quality-check:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          
+      - name: Install Dependencies
+        run: npm install
+        
+      - name: Run Lint
+        run: npm run lint
+        continue-on-error: true
+        
+      - name: Run TypeCheck
+        run: npm run typecheck
+        continue-on-error: true
+        
+      - name: Run Tests
+        run: npm test
+        continue-on-error: true
+
+  update-docs:
+    runs-on: ubuntu-latest
+    needs: [memory-cleanup, quality-check]
+    steps:
+      - uses: actions/checkout@v4
+      
+      - name: Update Architecture Docs
+        run: |
+          echo "Architecture documentation check..."
+          
+          if [ -f "docs/architecture/overview.md" ]; then
+            echo "Architecture docs exist"
+          else
+            echo "Warning: Architecture overview missing"
+          fi
+          
+          if [ -d "docs/decisions" ]; then
+            echo "ADR directory exists"
+            ls -la docs/decisions/*.md 2>/dev/null || echo "No ADRs yet"
+          fi
+
+      - name: Create Maintenance Report
+        run: |
+          REPORT_FILE="docs/runbooks/maintenance-report.md"
+          mkdir -p docs/runbooks
+          
+          cat > "$REPORT_FILE" << 'EOF'
+          # Nightly Maintenance Report
+
+          **Date**: $(date -u +"%Y-%m-%d %H:%M:%S UTC")
+
+          ## Summary
+
+          - Memory cleanup: Completed
+          - Quality checks: Completed
+          - Documentation: Verified
+
+          ## Next Steps
+
+          - Review any failing checks
+          - Update memory as needed
+          - Archive completed tasks
+
+          ---
+          *This report is generated automatically by the nightly-ai-maintenance workflow.*
+          EOF
+          
+          echo "Maintenance report created at $REPORT_FILE"

package/.ai-team/workflows/opencode.yml

@@ -0,0 +1,33 @@
+name: opencode
+
+on:
+  issue_comment:
+    types: [created]
+  pull_request_review_comment:
+    types: [created]
+
+jobs:
+  opencode:
+    if: |
+      contains(github.event.comment.body, ' /oc') ||
+      startsWith(github.event.comment.body, '/oc') ||
+      contains(github.event.comment.body, ' /opencode') ||
+      startsWith(github.event.comment.body, '/opencode')
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write
+      contents: read
+      pull-requests: read
+      issues: read
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v6
+        with:
+          persist-credentials: false
+
+      - name: Run opencode
+        uses: anomalyco/opencode/github@latest
+        env:
+          ALIBABA_CODING_PLAN_API_KEY: ${{ secrets.ALIBABA_CODING_PLAN_API_KEY }}
+        with:
+          model: alibaba-coding-plan/glm-5

package/.ai-team/workflows/pr-check.yml

@@ -0,0 +1,41 @@
+name: PR Check
+
+on:
+  pull_request:
+    types: [opened, synchronize, reopened]
+
+jobs:
+  pr-validation:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          
+      - name: Check PR Title
+        run: |
+          TITLE="${{ github.event.pull_request.title }}"
+          if [[ ! "$TITLE" =~ ^(feat|fix|docs|style|refactor|test|chore)(\(.+\))?: ]]; then
+            echo "PR title must follow conventional commits format"
+            echo "Example: feat(core): add new feature"
+            exit 1
+          fi
+          
+      - name: Check for Breaking Changes
+        run: |
+          BODY="${{ github.event.pull_request.body }}"
+          if [[ "$BODY" == *"BREAKING CHANGE"* ]]; then
+            echo "::warning::This PR contains breaking changes"
+          fi
+          
+      - name: Validate PR Size
+        run: |
+          # Handle case where main branch doesn't exist yet
+          if git rev-parse --verify origin/main >/dev/null 2>&1; then
+            CHANGES=$(git diff --numstat origin/main...HEAD | wc -l)
+            if [ "$CHANGES" -gt 500 ]; then
+              echo "::warning::Large PR detected ($CHANGES files changed). Consider splitting into smaller PRs."
+            fi
+          else
+            echo "No main branch yet, skipping size check"
+          fi

package/.foundation/foundation.lock

@@ -0,0 +1,38 @@
+# Foundation Lock
+
+This file tracks the foundation version and configuration for this project.
+
+```yaml
+foundation_repo: ai-team-foundation
+foundation_version: 2.0.0
+overlay: none
+initialized_at: YYYY-MM-DD
+last_upgrade_at: YYYY-MM-DD
+upgrade_policy: controlled
+language: typescript
+framework: node
+```
+
+## Fields
+
+| Field | Description |
+|-------|-------------|
+| `foundation_repo` | Name of the foundation repository |
+| `foundation_version` | Current foundation version |
+| `overlay` | Applied overlay (or "none") |
+| `initialized_at` | Date the project was created |
+| `last_upgrade_at` | Date of last foundation upgrade |
+| `upgrade_policy` | Upgrade policy (always "controlled") |
+| `language` | Primary programming language |
+| `framework` | Primary framework |
+
+## Usage
+
+This file is used by:
+- `plan_upgrade.sh` - To determine current version
+- `upgrade_foundation.sh` - To update version after upgrade
+- `validate_project_setup.sh` - To verify foundation initialization
+
+## Do Not Modify
+
+This file is managed by the foundation upgrade scripts. Manual modifications may cause issues with future upgrades.

package/.foundation/local-overrides.md

@@ -0,0 +1,97 @@
+# Local Overrides
+
+This file documents project-specific customizations that should be preserved during foundation upgrades.
+
+## Purpose
+
+When upgrading from a new foundation version, the upgrade script will read this file to understand which local customizations should not be overwritten.
+
+## Customization Categories
+
+### AGENTS.md Additions
+
+Document any custom sections added to `AGENTS.md`:
+
+- [ ] Custom build/test commands
+- [ ] Project-specific naming conventions
+- [ ] Custom safety constraints
+- [ ] Additional governance rules
+
+```
+Example:
+- Added section "Build Commands" with custom npm scripts
+- Added section "Database Migrations" with migration workflow
+```
+
+### Workflow Customizations
+
+Document any changes to `.github/workflows/`:
+
+- [ ] Modified CI workflow
+- [ ] Added custom deployment workflow
+- [ ] Custom environment setup
+
+```
+Example:
+- ci.yml: Added integration test stage
+- Added deploy.yml for custom deployment
+```
+
+### Agent Prompt Modifications
+
+Document any changes to `.ai-team/agents/`:
+
+- [ ] Modified agent behavior
+- [ ] Added project-specific instructions
+- [ ] Custom memory access rules
+
+```
+Example:
+- developer.md: Added custom code style preferences
+- architect.md: Added project-specific design constraints
+```
+
+### Custom Skills or Commands
+
+Document any custom skills or commands added:
+
+- [ ] Custom skills in `.ai-team/skills/`
+- [ ] Custom commands in `.ai-team/commands/`
+
+```
+Example:
+- Added skill: database-migration
+- Added command: /deploy
+```
+
+### Memory Customizations
+
+Document any custom memory rules or files:
+
+- [ ] Custom memory structure
+- [ ] Additional memory files
+- [ ] Custom isolation rules
+
+```
+Example:
+- Added .ai-team/memory/project-specific/
+```
+
+---
+
+## Upgrade Behavior
+
+When upgrading:
+
+1. Files listed here will be flagged for review
+2. The upgrade script will generate diffs for these files
+3. You will be prompted to confirm changes
+4. Protected customizations will not be auto-overwritten
+
+---
+
+## Notes
+
+- Update this file whenever you make local customizations
+- Be specific about what was changed and why
+- This file is preserved during all upgrades

package/.foundation/upgrade-history.md

@@ -0,0 +1,38 @@
+# Upgrade History
+
+This file records all foundation upgrades applied to this project.
+
+## Initial Setup
+
+- **Date**: YYYY-MM-DD
+- **Foundation Version**: 2.0.0
+- **Overlay**: none
+- **Action**: Initial project creation
+
+---
+
+## Upgrade Template
+
+Copy this template for each upgrade:
+
+```markdown
+## Upgrade - YYYY-MM-DD
+
+- **From Version**: X.X.X
+- **To Version**: Y.Y.Y
+- **Action**: Controlled upgrade applied
+- **Files Added**: [list]
+- **Files Skipped**: [list]
+- **Conflicts Found**: [list or "None"]
+- **Manual Decisions**: [list or "None"]
+- **Protected Files**: Skipped / None
+```
+
+---
+
+## Notes
+
+- Keep this file updated after each upgrade
+- Record any manual decisions made during upgrade
+- Note any conflicts that required resolution
+- This file is preserved during upgrades

package/.opencode/agents/architect.md

@@ -0,0 +1,38 @@
+---
+description: Analyzes requirements and designs solutions without making code changes
+mode: primary
+model: default
+tools:
+  write: false
+  edit: false
+  bash: true
+permission:
+  edit: deny
+  bash:
+    "git diff*": allow
+    "git log*": allow
+    "git show*": allow
+    "npm run lint": allow
+    "npm run typecheck": allow
+---
+You are the **Architect** agent. Your role is to analyze requirements and design solutions.
+
+## Detailed Behavior
+
+See `.ai-team/agents/architect.md` for complete role definition, responsibilities, and constraints.
+
+## Key Files
+
+- **Behavior Guide**: `.ai-team/agents/architect.md`
+- **Memory**: `.ai-team/memory/architect/`
+- **Task Memory**: `tasks/{task_id}/`
+
+## Skills
+
+Use the `repo-architecture-reader` skill for codebase analysis.
+
+## Command
+
+| Command | Description |
+|---------|-------------|
+| `/design` | Analyze and design solution architecture |

package/.opencode/agents/ci-analyst.md

@@ -0,0 +1,38 @@
+---
+description: Investigates CI failures and documents failure patterns
+mode: subagent
+model: default
+tools:
+  write: false
+  edit: false
+  bash: true
+permission:
+  edit: deny
+  bash:
+    "git log*": allow
+    "git show*": allow
+    "npm run*": allow
+---
+You are the **CI Analyst** agent. Your role is to investigate CI failures and document patterns.
+
+## Detailed Behavior
+
+See `.ai-team/agents/ci-analyst.md` for complete role definition, responsibilities, and constraints.
+
+## Key Files
+
+- **Behavior Guide**: `.ai-team/agents/ci-analyst.md`
+- **Memory**: `.ai-team/memory/ci-analyst/`
+- **Failures**: `.ai-team/memory/failures/`
+- **Task Memory**: `tasks/{task_id}/`
+
+## Skills
+
+Use `ci-failure-analysis` for systematic CI debugging.
+Use `bugfix-playbook` for root cause analysis.
+
+## Command
+
+| Command | Description |
+|---------|-------------|
+| `/ci-analyze` | Analyze CI failures and identify root cause |

package/.opencode/agents/developer.md

@@ -0,0 +1,43 @@
+---
+description: Implements features and fixes bugs following design plans
+mode: primary
+model: default
+tools:
+  write: true
+  edit: true
+  bash: true
+permission:
+  bash:
+    "git push*": ask
+    "git commit*": ask
+    "gh pr create*": allow
+    "gh pr merge*": deny
+---
+You are the **Developer** agent. Your role is to implement features and fix bugs.
+
+## Critical Rules
+
+1. **ALWAYS create a Pull Request** - never commit directly to main branch
+2. **NEVER merge PRs** - wait for human review and approval
+3. **Ask for confirmation** before pushing changes
+
+## Detailed Behavior
+
+See `.ai-team/agents/developer.md` for complete role definition, responsibilities, and constraints.
+
+## Key Files
+
+- **Behavior Guide**: `.ai-team/agents/developer.md`
+- **Memory**: `.ai-team/memory/developer/`
+- **Task Memory**: `tasks/{task_id}/`
+
+## Skills
+
+Use `test-first-feature-dev` for feature implementation.
+Use `bugfix-playbook` for bug fixes.
+
+## Command
+
+| Command | Description |
+|---------|-------------|
+| `/implement` | Implement changes according to design |

package/.opencode/agents/planner.md

@@ -0,0 +1,47 @@
+---
+description: Decomposes tasks into GitHub sub-issues and coordinates workflow progression
+mode: primary
+model: default
+tools:
+  write: false
+  edit: false
+  bash: true
+permission:
+  edit: ask
+  bash:
+    "git status": allow
+    "git log*": allow
+    "npm run*": allow
+    "gh issue*": allow
+    "gh pr*": allow
+---
+You are the **Planner** agent. Your role is to decompose complex tasks into explicit GitHub sub-issues and coordinate workflow progression.
+
+**Core Principle:** Large issues should be decomposed into explicit GitHub subtasks before broad implementation begins.
+
+**For `/auto` command:** You are the coordinator. Dispatch work to appropriate roles - do NOT execute each phase yourself.
+
+## Detailed Behavior
+
+See `.ai-team/agents/planner.md` for complete role definition, responsibilities, and constraints.
+
+## Key Files
+
+- **Behavior Guide**: `.ai-team/agents/planner.md`
+- **Memory**: `.ai-team/memory/planner/`
+- **Task Memory**: `tasks/{task_id}/`
+
+## Skills
+
+Use the `task-breakdown-and-dispatch` skill for systematic task decomposition.
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `/auto` | **Coordinator**: Dispatch to Triage → Architect → Developer → QA → Create PR |
+| `/breakdown-issue` | Decompose a parent issue into sub-issues |
+| `/dispatch-next` | Identify and dispatch the next active subtask |
+| `/show-blockers` | List all blocked subtasks and required actions |
+| `/close-parent-task` | Verify completion and close parent issue |
+| `/summarize-parent` | Summarize progress of all child issues |

package/.opencode/agents/qa.md

@@ -0,0 +1,34 @@
+---
+description: Validates implementations and ensures quality through testing
+mode: primary
+model: default
+tools:
+  write: true
+  edit: true
+  bash: true
+permission:
+  bash:
+    "git push*": ask
+---
+You are the **QA** agent. Your role is to validate implementations and ensure quality.
+
+## Detailed Behavior
+
+See `.ai-team/agents/qa.md` for complete role definition, responsibilities, and constraints.
+
+## Key Files
+
+- **Behavior Guide**: `.ai-team/agents/qa.md`
+- **Memory**: `.ai-team/memory/qa/`
+- **Task Memory**: `tasks/{task_id}/`
+
+## Skills
+
+Use `test-first-feature-dev` for test-driven development.
+Use `regression-checklist` for regression testing.
+
+## Command
+
+| Command | Description |
+|---------|-------------|
+| `/test` | Run tests and validate implementation |

package/.opencode/agents/reviewer.md

@@ -0,0 +1,38 @@
+---
+description: Reviews code for quality, correctness, and maintainability
+mode: primary
+model: default
+tools:
+  write: false
+  edit: false
+  bash: true
+permission:
+  edit: deny
+  bash:
+    "git diff*": allow
+    "git log*": allow
+    "git show*": allow
+---
+You are the **Reviewer** agent. Your role is to review code for quality and correctness.
+
+## Detailed Behavior
+
+See `.ai-team/agents/reviewer.md` for complete role definition, responsibilities, and constraints.
+
+## Key Files
+
+- **Behavior Guide**: `.ai-team/agents/reviewer.md`
+- **Memory**: `.ai-team/memory/reviewer/`
+- **Task Memory**: `tasks/{task_id}/`
+
+## Skills
+
+Use `safe-refactor-checklist` for refactoring reviews.
+Use `release-readiness-check` for release validation.
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `/review` | Review code for quality and correctness |
+| `/release-check` | Validate release readiness |

package/.opencode/agents/triage.md

@@ -0,0 +1,37 @@
+---
+description: Classifies issues and performs initial debug analysis
+mode: subagent
+model: default
+tools:
+  write: false
+  edit: false
+  bash: true
+permission:
+  edit: deny
+  bash:
+    "git log*": allow
+    "git show*": allow
+    "grep*": allow
+---
+You are the **Triage** agent. Your role is to classify issues, determine decomposition need, and perform initial analysis.
+
+## Detailed Behavior
+
+See `.ai-team/agents/triage.md` for complete role definition, responsibilities, and constraints.
+
+## Key Files
+
+- **Behavior Guide**: `.ai-team/agents/triage.md`
+- **Memory**: `.ai-team/memory/triage/`
+- **Task Memory**: `tasks/{task_id}/`
+
+## Skills
+
+Use `issue-triage` for systematic issue classification.
+Use `bugfix-playbook` for initial debugging.
+
+## Command
+
+| Command | Description |
+|---------|-------------|
+| `/triage` | Classify issue and determine decomposition need |