🤖 Initialize gh-teamwork framework

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Author: JoshLuedeman

.editorconfig

@@ -0,0 +1,24 @@
+# EditorConfig — consistent formatting across all editors and agents
+# https://editorconfig.org
+
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+indent_style = space
+indent_size = 2
+
+[*.md]
+trim_trailing_whitespace = false
+
+[*.py]
+indent_size = 4
+
+[*.go]
+indent_style = tab
+
+[Makefile]
+indent_style = tab

.github/ISSUE_TEMPLATE/bug.yml

@@ -0,0 +1,73 @@
+name: Bug Report
+description: Report a bug for investigation and fix
+title: "[BUG] "
+labels: ["bug"]
+body:
+  - type: textarea
+    id: description
+    attributes:
+      label: Description
+      description: What's wrong
+    validations:
+      required: true
+
+  - type: textarea
+    id: steps-to-reproduce
+    attributes:
+      label: Steps to Reproduce
+      description: Step-by-step instructions to reproduce the bug
+      placeholder: |
+        1. Step one
+        2. Step two
+        3. Step three
+    validations:
+      required: true
+
+  - type: textarea
+    id: expected-behavior
+    attributes:
+      label: Expected Behavior
+      description: What should happen
+    validations:
+      required: true
+
+  - type: textarea
+    id: actual-behavior
+    attributes:
+      label: Actual Behavior
+      description: What actually happens
+    validations:
+      required: true
+
+  - type: textarea
+    id: environment
+    attributes:
+      label: Environment
+      description: "OS, language version, dependency versions, etc."
+      placeholder: |
+        - OS: macOS 14.0
+        - Python: 3.12
+    validations:
+      required: false
+
+  - type: dropdown
+    id: severity
+    attributes:
+      label: Severity
+      description: How severe is this bug
+      options:
+        - Critical
+        - High
+        - Medium
+        - Low
+    validations:
+      required: true
+
+  - type: textarea
+    id: logs-screenshots
+    attributes:
+      label: Relevant Logs/Screenshots
+      description: Any logs, error messages, or screenshots
+      render: shell
+    validations:
+      required: false

.github/ISSUE_TEMPLATE/planning.yml

@@ -0,0 +1,70 @@
+name: Planning Request
+description: Request planning or design work for a goal
+title: "[PLAN] "
+labels: ["planning"]
+body:
+  - type: textarea
+    id: goal
+    attributes:
+      label: Goal
+      description: What you want to achieve
+    validations:
+      required: true
+
+  - type: textarea
+    id: context
+    attributes:
+      label: Context
+      description: Background information relevant to this goal
+    validations:
+      required: false
+
+  - type: textarea
+    id: constraints
+    attributes:
+      label: Constraints
+      description: Limitations, requirements, or boundaries
+    validations:
+      required: false
+
+  - type: textarea
+    id: success-criteria
+    attributes:
+      label: Success Criteria
+      description: How to know when this is done
+      placeholder: |
+        - [ ] Criterion 1
+        - [ ] Criterion 2
+    validations:
+      required: false
+
+  - type: dropdown
+    id: workflow-type
+    attributes:
+      label: Workflow Type
+      description: Which workflow fits this goal? See agents/workflows/ for details on each workflow.
+      options:
+        - Feature
+        - Bugfix
+        - Refactor
+        - Hotfix
+        - Security Response
+        - Dependency Update
+        - Documentation
+        - Spike
+        - Release
+        - Not Sure
+    validations:
+      required: false
+
+  - type: dropdown
+    id: scope
+    attributes:
+      label: Scope
+      description: Estimated size of this effort
+      options:
+        - Small (hours)
+        - Medium (days)
+        - Large (weeks)
+    validations:
+      required: false

.github/ISSUE_TEMPLATE/task.yml

@@ -0,0 +1,74 @@
+name: Task
+description: A structured task for agent implementation
+title: "[TASK] "
+labels: ["task"]
+body:
+  - type: textarea
+    id: summary
+    attributes:
+      label: Summary
+      description: What needs to be done
+    validations:
+      required: true
+
+  - type: textarea
+    id: acceptance-criteria
+    attributes:
+      label: Acceptance Criteria
+      description: Specific, testable criteria for completion
+      placeholder: |
+        - [ ] Criterion 1
+        - [ ] Criterion 2
+    validations:
+      required: true
+
+  - type: textarea
+    id: relevant-files
+    attributes:
+      label: Relevant Files
+      description: Files or directories the agent should focus on
+      placeholder: |
+        - src/module/file.py
+        - tests/test_module.py
+    validations:
+      required: false
+
+  - type: textarea
+    id: dependencies
+    attributes:
+      label: Dependencies
+      description: Other issues that must complete before this task
+      placeholder: |
+        - #issue_number
+    validations:
+      required: false
+
+  - type: textarea
+    id: technical-notes
+    attributes:
+      label: Technical Notes
+      description: Design constraints, patterns to follow, or other guidance
+    validations:
+      required: false
+
+  - type: dropdown
+    id: agent-role
+    attributes:
+      label: Agent Role
+      description: Which role should handle this task
+      options:
+        # Core roles
+        - Planner
+        - Architect
+        - Coder
+        - Tester
+        - Reviewer
+        - Security Auditor
+        - Documenter
+        # Optional / specialized roles
+        - Triager
+        - DevOps
+        - Dependency Manager
+        - Refactorer
+    validations:
+      required: true

.github/PULL_REQUEST_TEMPLATE.md

@@ -1,34 +1,26 @@
-## 📋 Description
+## Task Issue
 
-<!-- Briefly describe the changes in this PR -->
+Closes #<!-- issue number -->
 
-## 🔗 Related Issues
+## Description
 
-<!-- Link to related issues: Fixes #123, Closes #456 -->
+<!-- What changes does this PR make and why? -->
 
-## 🧪 Type of Change
+## Checklist
 
-- [ ] 🐛 Bug fix (non-breaking change which fixes an issue)
-- [ ] ✨ New feature (non-breaking change which adds functionality)
-- [ ] 💥 Breaking change (fix or feature that would cause existing functionality to not work as expected)
-- [ ] 📚 Documentation update
-- [ ] 🔧 Maintenance / refactoring
-- [ ] 🔒 Security fix
+- [ ] Linked to task issue
+- [ ] Changes are minimal (only what the task requires)
+- [ ] Tests added/updated
+- [ ] All tests pass (`make test`)
+- [ ] Linting passes (`make lint`)
+- [ ] No secrets or credentials committed
+- [ ] Documentation updated (if applicable)
+- [ ] Follows project conventions (docs/conventions.md)
 
-## ✅ Checklist
+## Reviewer Notes
 
-- [ ] My code follows the project's style guidelines
-- [ ] I have performed a self-review of my code
-- [ ] I have commented my code, particularly in hard-to-understand areas
-- [ ] I have made corresponding changes to the documentation
-- [ ] My changes generate no new warnings
-- [ ] I have added tests that prove my fix is effective or that my feature works
-- [ ] New and existing unit tests pass locally with my changes
+<!-- Anything reviewers should know or pay attention to -->
 
-## 📸 Screenshots (if applicable)
+## Security Considerations
 
-<!-- Add screenshots to help explain your changes -->
-
-## 📝 Additional Notes
-
-<!-- Any additional information that reviewers should know -->
+<!-- Any security implications of these changes? (new inputs, auth changes, dependency updates, etc.) -->

.github/agents/api-agent.agent.md

@@ -17,6 +17,10 @@ You are the API Agent. You design, build, and maintain API endpoints. You ensure
 - **Dev Server Command:** [e.g., `npm run dev`, `make run`, `go run ./cmd/server`]
 - **API Test Command:** [e.g., `npm test -- --grep api`, `make test-api`, `go test ./api/...`]
 
+## MCP Tools
+- **GitHub MCP** — `search_code`, `get_file_contents` — understand existing API patterns and contracts
+- **Context7** — `resolve-library-id`, `get-library-docs` — look up framework-specific API conventions and documentation
+
 ## Responsibilities
 
 - Design API endpoints with consistent naming, methods, and status codes

.github/agents/architect.agent.md

@@ -21,6 +21,15 @@ You are the Architect. You make design decisions that shape the system's structu
 - **Why:** Architecture decisions require deep reasoning, multi-system tradeoff analysis, and the ability to evaluate long-term consequences of design choices. This role produces the most consequential outputs — a bad architecture decision is expensive to reverse.
 - **Key capabilities needed:** Deep analytical reasoning, tradeoff evaluation, large context window (for understanding system-wide impacts), structured document generation
 
+## MCP Tools
+- **GitHub MCP** — `search_code`, `get_file_contents`, `search_repositories` — understand existing codebase structure before designing
+- **Context7** — `resolve-library-id`, `get-library-docs` — fetch accurate, version-specific library documentation before recommending a dependency
+- **Tavily** — `tavily_search`, `tavily_extract` — research architectural patterns, evaluate tradeoffs, look up RFCs
+- **Mermaid MCP** — diagram generation tools — produce architecture diagrams for ADRs and design docs
+- **Terraform MCP** — `terraform_plan`, `terraform_validate` — validate infrastructure designs and review Terraform configurations
+- **ADR MCP** — `search_adrs`, `create_adr`, `list_adrs` — search existing decisions, create new ADRs, and manage the decision log
+- **Complexity MCP** — `analyze_complexity`, `get_hotspots` — assess codebase health and identify high-complexity areas during design reviews
+
 ## Responsibilities
 
 - Evaluate technical approaches and choose the best fit for the project's constraints

.github/agents/coder.agent.md

@@ -25,6 +25,14 @@ You are the Coder. You implement tasks by writing code. You take well-defined ta
 - **Why:** Code generation demands strong reasoning about program correctness, awareness of edge cases, and the ability to produce working code that satisfies acceptance criteria on the first attempt. Lower-tier models generate more bugs, miss edge cases, and require more review cycles.
 - **Key capabilities needed:** Code generation, tool use (file editing, terminal commands), large context window (for understanding existing codebase), test writing
 
+## MCP Tools
+- **GitHub MCP** — `get_file_contents`, `create_pull_request`, `create_or_update_file`, `list_workflow_runs` — read code, open PRs, check CI status
+- **Context7** — `resolve-library-id`, `get-library-docs` — look up correct API signatures before writing code; do not rely on training data for library APIs
+- **E2B** — `execute_python`, `execute_javascript`, `install_packages` — run and test code in an isolated sandbox before committing
+- **Semgrep** — `semgrep_scan` — self-audit new code for security issues before opening a PR
+- **Commits MCP** — `generate_commit_message` — generate conventional commit messages from staged diffs
+- **ADR MCP** — `search_adrs`, `get_adr` — read architecture decisions before implementing to ensure alignment with design choices
+
 ## Responsibilities
 
 - Read task issues and understand the acceptance criteria before writing any code

.github/agents/dba-agent.agent.md

@@ -18,6 +18,10 @@ You are the DBA Agent. You manage database schemas, write migrations, optimize q
 - **Migration Command:** [e.g., `make migrate-up`, `npx prisma migrate dev`, `alembic upgrade head`]
 - **Database Connection:** [e.g., see `.env.example` for connection string format, use `make db-shell` for direct access]
 
+## MCP Tools
+- **GitHub MCP** — `search_code`, `get_file_contents` — review existing schema, migrations, and query patterns
+- **Context7** — `resolve-library-id`, `get-library-docs` — look up database driver and ORM documentation
+
 ## Responsibilities
 
 - Design database schemas with proper normalization, constraints, and indexes

.github/agents/dependency-manager.agent.md

@@ -25,6 +25,10 @@ You are the Dependency Manager. You keep the project's dependencies healthy, sec
 - **Why:** Dependency management involves structured evaluation (version comparison, changelog reading, CVE assessment) within a well-defined process. Standard-tier models can effectively read changelogs, assess breaking changes, and generate update PRs without requiring premium reasoning capabilities.
 - **Key capabilities needed:** Changelog comprehension, version comparison, security advisory evaluation, structured PR generation
 
+## MCP Tools
+- **GitHub MCP** — `list_dependabot_alerts`, `get_file_contents` — review dependency alerts and lock files
+- **OSV MCP** — `query_package`, `query_batch` — look up CVEs for dependencies being updated
+
 ## Responsibilities
 
 - Monitor dependencies for new versions (major, minor, patch)