amazingteam 3.0.0

package/tasks/README.md

@@ -0,0 +1,94 @@
+# Task Memory Directory
+
+This directory contains task-scoped memory for each issue/feature.
+
+## Purpose
+
+Each task gets its own subdirectory (`issue-{id}/`) containing:
+- Analysis notes
+- Design documents
+- Implementation notes
+- Validation records
+- Review outcomes
+
+For decomposed tasks, subtask directories (`issue-{id}-subtask-{n}/`) contain:
+- Focused implementation notes
+- Subtask-specific validation
+- Review records
+
+## Structure
+
+```
+tasks/
+├── issue-101/
+│   ├── task.yaml              # Parent task manifest
+│   ├── analysis.md            # Architect's analysis
+│   ├── design.md              # Design document
+│   ├── implementation.md      # Developer's notes
+│   ├── validation.md          # QA's validation record
+│   └── review.md              # Reviewer's findings
+│
+├── issue-101-subtask-01/      # Subtask directory
+│   ├── task.yaml              # Subtask manifest (with github_issue, parent_task)
+│   ├── implementation.md      # Implementation notes
+│   ├── validation.md          # Validation record
+│   └── review.md              # Review findings
+│
+├── issue-102/
+│   └── ...
+│
+└── README.md                  # This file
+```
+
+## GitHub Issue Mapping
+
+Task manifests include GitHub issue references:
+
+```yaml
+github_issue: 101
+github_url: https://github.com/org/repo/issues/101
+parent_task: null       # null for parent tasks
+parent_github_issue: null
+```
+
+Subtask manifests:
+
+```yaml
+github_issue: 201
+github_url: https://github.com/org/repo/issues/201
+parent_task: issue-101
+parent_github_issue: 101
+depends_on: [200]       # GitHub issue numbers
+```
+
+## Lifecycle
+
+1. **Creation**: Task directory is created when work begins
+2. **Decomposition**: Planner may create subtask directories
+3. **Active**: Files are updated during task execution
+4. **Completed**: Task memory is preserved for traceability
+5. **Archive**: Optionally archived after project milestones
+
+## Permissions
+
+| Role | Can Read | Can Write |
+|------|----------|-----------|
+| Planner | All tasks | task.yaml, subtask manifests |
+| Architect | All tasks | analysis.md, design.md |
+| Developer | Current task | implementation.md |
+| QA | Current task | validation.md |
+| Reviewer | Current task | review.md |
+
+## Naming Convention
+
+- Parent task: `issue-{github-issue-number}`
+- Subtask: `issue-{parent-number}-subtask-{sequence}`
+- Files: `[role]-notes.md` or by phase name
+
+## Notes
+
+- Task memory helps maintain context across sessions
+- Provides traceable history of decisions
+- GitHub issues are the visible work graph
+- Local task memory is the execution memory
+- Both should be kept in sync

package/tasks/_template/analysis.md

@@ -0,0 +1,76 @@
+# Analysis
+
+## Issue: [Issue Title]
+
+**Issue ID**: issue-XXX  
+**Type**: feature | bug | refactor | docs | tech
+
+---
+
+## Requirements Analysis
+
+### Functional Requirements
+
+1. [Requirement 1]
+2. [Requirement 2]
+
+### Non-Functional Requirements
+
+1. [Performance requirement]
+2. [Security requirement]
+
+---
+
+## Current State
+
+### Affected Modules
+
+- `module1` - [Current behavior]
+- `module2` - [Current behavior]
+
+### Related Code
+
+- `path/to/file.ts` - [Relevance]
+
+---
+
+## Impact Assessment
+
+### Scope
+
+- [ ] Single module
+- [ ] Multiple modules
+- [ ] Cross-cutting concern
+
+### Risk Level
+
+- **Risk**: low | medium | high
+- **Rationale**: [Why this risk level]
+
+### Dependencies
+
+| Dependency | Type | Status |
+|------------|------|--------|
+| [dep name] | internal/external | ready/blocked |
+
+---
+
+## Questions
+
+- [ ] [Question 1]
+- [ ] [Question 2]
+
+---
+
+## Recommendations
+
+1. [Recommendation 1]
+2. [Recommendation 2]
+
+---
+
+## Next Steps
+
+- [ ] Proceed to design
+- [ ] Clarify requirements
+- [ ] Investigate further

package/tasks/_template/design.md

@@ -0,0 +1,121 @@
+# Design
+
+## Issue: [Issue Title]
+
+**Issue ID**: issue-XXX  
+**Date**: YYYY-MM-DD
+
+---
+
+## Design Overview
+
+[High-level description of the solution]
+
+---
+
+## Architecture
+
+### Component Diagram
+
+```
+┌─────────────┐     ┌─────────────┐
+│  Component  │────▶│  Component  │
+└─────────────┘     └─────────────┘
+```
+
+### Data Flow
+
+```
+Input → Process → Output
+```
+
+---
+
+## Components
+
+### [Component Name]
+
+**Purpose**: [What it does]
+
+**Responsibilities**:
+- [Responsibility 1]
+- [Responsibility 2]
+
+**Interface**:
+```typescript
+interface ComponentName {
+  method(): ReturnType;
+}
+```
+
+---
+
+## API Changes
+
+### New Endpoints
+
+| Method | Path | Description |
+|--------|------|-------------|
+| GET | /api/resource | [Description] |
+
+### Modified Endpoints
+
+| Method | Path | Change |
+|--------|------|--------|
+| | | |
+
+---
+
+## Database Changes
+
+### New Tables
+
+```sql
+CREATE TABLE table_name (
+  id SERIAL PRIMARY KEY,
+  -- columns
+);
+```
+
+### Modified Tables
+
+| Table | Change |
+|-------|--------|
+| | |
+
+---
+
+## Security Considerations
+
+- [Security consideration 1]
+- [Security consideration 2]
+
+---
+
+## Performance Considerations
+
+- [Performance consideration 1]
+- [Performance consideration 2]
+
+---
+
+## Risks and Mitigations
+
+| Risk | Mitigation |
+|------|------------|
+| | |
+
+---
+
+## Implementation Plan
+
+1. [Step 1]
+2. [Step 2]
+3. [Step 3]
+
+---
+
+## Alternatives Considered
+
+1. **[Alternative 1]**: [Why not chosen]
+2. **[Alternative 2]**: [Why not chosen]

package/tasks/_template/implementation.md

@@ -0,0 +1,121 @@
+# Implementation
+
+## Issue: [Issue Title]
+
+**Issue ID**: issue-XXX  
+**Branch**: feat/issue-XXX-description  
+**Date Started**: YYYY-MM-DD
+
+---
+
+## Implementation Summary
+
+[Brief description of what was implemented]
+
+---
+
+## Changes Made
+
+### Files Created
+
+| File | Purpose |
+|------|---------|
+| `path/to/new/file.ts` | [Purpose] |
+
+### Files Modified
+
+| File | Change |
+|------|--------|
+| `path/to/file.ts` | [Change description] |
+
+### Files Deleted
+
+| File | Reason |
+|------|--------|
+| | |
+
+---
+
+## Key Decisions
+
+### [Decision Topic]
+
+**Decision**: [What was decided]
+
+**Rationale**: [Why]
+
+**Alternatives**: [What else was considered]
+
+---
+
+## Implementation Notes
+
+### [Topic]
+
+[Notes about implementation details]
+
+---
+
+## Testing
+
+### Tests Added
+
+| Test File | Coverage |
+|-----------|----------|
+| `file.test.ts` | [What is tested] |
+
+### Manual Testing
+
+- [ ] [Test case 1]
+- [ ] [Test case 2]
+
+---
+
+## Known Issues
+
+| Issue | Status | Workaround |
+|-------|--------|------------|
+| | | |
+
+---
+
+## TODOs
+
+- [ ] [TODO 1]
+- [ ] [TODO 2]
+
+---
+
+## Dependencies Added
+
+| Package | Version | Purpose |
+|---------|---------|---------|
+| | | |
+
+---
+
+## Performance Impact
+
+- **Memory**: [Impact]
+- **Startup Time**: [Impact]
+- **Runtime**: [Impact]
+
+---
+
+## Documentation Updated
+
+- [ ] README.md
+- [ ] API documentation
+- [ ] Inline comments
+
+---
+
+## Checklist
+
+- [ ] Code follows style guidelines
+- [ ] Self-review completed
+- [ ] Comments added for complex logic
+- [ ] Documentation updated
+- [ ] No new warnings
+- [ ] Tests added and passing
+- [ ] Local tests passing

package/tasks/_template/release.md

@@ -0,0 +1,119 @@
+# Release Notes
+
+## Issue: [Issue Title]
+
+**Issue ID**: issue-XXX  
+**Type**: feature | bug | refactor | docs | tech  
+**Version**: X.Y.Z
+
+---
+
+## Summary
+
+Brief summary of what was done and why.
+
+---
+
+## Changes
+
+### Added
+- New feature or capability
+
+### Changed
+- Changes to existing functionality
+
+### Fixed
+- Bug fixes
+
+### Removed
+- Deprecated features removed
+
+---
+
+## Breaking Changes
+
+List any breaking changes and migration instructions.
+
+### [Breaking Change Title]
+
+**Before**: [Old behavior]
+
+**After**: [New behavior]
+
+**Migration**: [How to update]
+
+---
+
+## Testing
+
+### Test Coverage
+
+| Type | Coverage | Status |
+|------|----------|--------|
+| Unit | XX% | Pass |
+| Integration | XX% | Pass |
+| E2E | N/A | Pass |
+
+### Test Cases Added
+
+1. [Test case 1]
+2. [Test case 2]
+
+---
+
+## Validation Checklist
+
+- [ ] All acceptance criteria met
+- [ ] Tests pass
+- [ ] Documentation updated
+- [ ] No regressions detected
+- [ ] Performance acceptable
+- [ ] Security review (if applicable)
+
+---
+
+## Deployment Notes
+
+### Pre-deployment
+
+- [ ] Backup completed
+- [ ] Migration scripts ready
+- [ ] Rollback plan documented
+
+### Post-deployment
+
+- [ ] Smoke tests passed
+- [ ] Monitoring alerts configured
+- [ ] Documentation published
+
+---
+
+## Rollback Plan
+
+1. [Step 1]
+2. [Step 2]
+3. [Step 3]
+
+---
+
+## Related Issues
+
+- #XXX - Related issue
+- #YYY - Dependency
+
+---
+
+## Reviewer Notes
+
+Notes for reviewers about specific areas to focus on or concerns.
+
+---
+
+## Sign-off
+
+| Role | Name | Date |
+|------|------|------|
+| Developer | | |
+| QA | | |
+| Reviewer | | |
+| Approver | | |

package/tasks/_template/review.md

@@ -0,0 +1,131 @@
+# Review
+
+## Issue: [Issue Title]
+
+**Issue ID**: issue-XXX  
+**Reviewer**: Reviewer Agent  
+**Date**: YYYY-MM-DD
+
+---
+
+## Review Summary
+
+[Overall assessment]
+
+---
+
+## Code Review
+
+### Files Reviewed
+
+| File | Lines | Assessment |
+|------|-------|------------|
+| `path/to/file.ts` | XX | ✅ Approved / ⚠️ Needs changes |
+
+### Code Quality
+
+| Aspect | Rating | Notes |
+|--------|--------|-------|
+| Readability | ⭐⭐⭐⭐⭐ | |
+| Maintainability | ⭐⭐⭐⭐⭐ | |
+| Performance | ⭐⭐⭐⭐⭐ | |
+| Security | ⭐⭐⭐⭐⭐ | |
+| Testing | ⭐⭐⭐⭐⭐ | |
+
+---
+
+## Findings
+
+### Critical Issues
+
+| Issue | File | Line | Resolution Required |
+|-------|------|------|---------------------|
+| | | | |
+
+### Major Issues
+
+| Issue | File | Line | Resolution Required |
+|-------|------|------|---------------------|
+| | | | |
+
+### Minor Issues / Suggestions
+
+| Suggestion | File | Line | Optional |
+|------------|------|------|----------|
+| | | | ✅ |
+
+---
+
+## Design Review
+
+- [ ] Follows existing patterns
+- [ ] No unnecessary complexity
+- [ ] Proper separation of concerns
+- [ ] Appropriate abstractions
+
+---
+
+## Security Review
+
+- [ ] No hardcoded credentials
+- [ ] Input validation present
+- [ ] Output encoding correct
+- [ ] Proper error handling
+- [ ] No sensitive data logging
+
+---
+
+## Performance Review
+
+- [ ] No obvious performance issues
+- [ ] Efficient algorithms used
+- [ ] No memory leaks
+- [ ] Appropriate caching
+
+---
+
+## Testing Review
+
+- [ ] Adequate test coverage
+- [ ] Edge cases tested
+- [ ] Error cases tested
+- [ ] Tests are meaningful
+
+---
+
+## Documentation Review
+
+- [ ] README updated if needed
+- [ ] API documented
+- [ ] Complex logic commented
+- [ ] Type definitions complete
+
+---
+
+## Best Practices
+
+- [ ] Follows coding standards
+- [ ] No code duplication
+- [ ] Meaningful names
+- [ ] Functions are focused
+
+---
+
+## Recommendations
+
+1. [Recommendation 1]
+2. [Recommendation 2]
+
+---
+
+## Review Decision
+
+- [ ] ✅ **Approved** - Ready to merge
+- [ ] ⚠️ **Changes Requested** - Address issues above
+- [ ] 💬 **Discussion** - Need clarification
+
+---
+
+## Notes
+
+[Additional review notes]

package/tasks/_template/subtasks/task.yaml

@@ -0,0 +1,24 @@
+id: issue-000-subtask-01
+title: "[Subtask] Subtask Title"
+type: implementation
+status: ready
+priority: high
+owner_role: developer
+depends_on: []
+blocked_by: []
+acceptance_criteria:
+  - Acceptance criterion 1
+  - Acceptance criterion 2
+risk_level: medium
+module_scope:
+  - module1
+
+github_issue: null
+github_url: null
+parent_task: issue-000
+parent_github_issue: 000
+
+notes: |
+  Notes about this subtask.
+
+linked_pr: null