Skip to content

Commit e65f73b

Browse files
JoshLuedemanCopilot
JoshLuedeman
and
Copilot
committed
🤖 Initialize gh-teamwork framework
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
1 parent af8e61c commit e65f73b

36 files changed

+3158
-50
lines changed

‎.editorconfig‎

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,24 @@
1+
# EditorConfig — consistent formatting across all editors and agents
2+
# https://editorconfig.org
3+
4+
root = true
5+
6+
[*]
7+
charset = utf-8
8+
end_of_line = lf
9+
insert_final_newline = true
10+
trim_trailing_whitespace = true
11+
indent_style = space
12+
indent_size = 2
13+
14+
[*.md]
15+
trim_trailing_whitespace = false
16+
17+
[*.py]
18+
indent_size = 4
19+
20+
[*.go]
21+
indent_style = tab
22+
23+
[Makefile]
24+
indent_style = tab

‎.github/ISSUE_TEMPLATE/bug.yml‎

Lines changed: 73 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,73 @@
1+
name: Bug Report
2+
description: Report a bug for investigation and fix
3+
title: "[BUG] "
4+
labels: ["bug"]
5+
body:
6+
- type: textarea
7+
id: description
8+
attributes:
9+
label: Description
10+
description: What's wrong
11+
validations:
12+
required: true
13+
14+
- type: textarea
15+
id: steps-to-reproduce
16+
attributes:
17+
label: Steps to Reproduce
18+
description: Step-by-step instructions to reproduce the bug
19+
placeholder: |
20+
1. Step one
21+
2. Step two
22+
3. Step three
23+
validations:
24+
required: true
25+
26+
- type: textarea
27+
id: expected-behavior
28+
attributes:
29+
label: Expected Behavior
30+
description: What should happen
31+
validations:
32+
required: true
33+
34+
- type: textarea
35+
id: actual-behavior
36+
attributes:
37+
label: Actual Behavior
38+
description: What actually happens
39+
validations:
40+
required: true
41+
42+
- type: textarea
43+
id: environment
44+
attributes:
45+
label: Environment
46+
description: "OS, language version, dependency versions, etc."
47+
placeholder: |
48+
- OS: macOS 14.0
49+
- Python: 3.12
50+
validations:
51+
required: false
52+
53+
- type: dropdown
54+
id: severity
55+
attributes:
56+
label: Severity
57+
description: How severe is this bug
58+
options:
59+
- Critical
60+
- High
61+
- Medium
62+
- Low
63+
validations:
64+
required: true
65+
66+
- type: textarea
67+
id: logs-screenshots
68+
attributes:
69+
label: Relevant Logs/Screenshots
70+
description: Any logs, error messages, or screenshots
71+
render: shell
72+
validations:
73+
required: false

‎.github/ISSUE_TEMPLATE/planning.yml‎

Lines changed: 70 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,70 @@
1+
name: Planning Request
2+
description: Request planning or design work for a goal
3+
title: "[PLAN] "
4+
labels: ["planning"]
5+
body:
6+
- type: textarea
7+
id: goal
8+
attributes:
9+
label: Goal
10+
description: What you want to achieve
11+
validations:
12+
required: true
13+
14+
- type: textarea
15+
id: context
16+
attributes:
17+
label: Context
18+
description: Background information relevant to this goal
19+
validations:
20+
required: false
21+
22+
- type: textarea
23+
id: constraints
24+
attributes:
25+
label: Constraints
26+
description: Limitations, requirements, or boundaries
27+
validations:
28+
required: false
29+
30+
- type: textarea
31+
id: success-criteria
32+
attributes:
33+
label: Success Criteria
34+
description: How to know when this is done
35+
placeholder: |
36+
- [ ] Criterion 1
37+
- [ ] Criterion 2
38+
validations:
39+
required: false
40+
41+
- type: dropdown
42+
id: workflow-type
43+
attributes:
44+
label: Workflow Type
45+
description: Which workflow fits this goal? See agents/workflows/ for details on each workflow.
46+
options:
47+
- Feature
48+
- Bugfix
49+
- Refactor
50+
- Hotfix
51+
- Security Response
52+
- Dependency Update
53+
- Documentation
54+
- Spike
55+
- Release
56+
- Not Sure
57+
validations:
58+
required: false
59+
60+
- type: dropdown
61+
id: scope
62+
attributes:
63+
label: Scope
64+
description: Estimated size of this effort
65+
options:
66+
- Small (hours)
67+
- Medium (days)
68+
- Large (weeks)
69+
validations:
70+
required: false

‎.github/ISSUE_TEMPLATE/task.yml‎

Lines changed: 74 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,74 @@
1+
name: Task
2+
description: A structured task for agent implementation
3+
title: "[TASK] "
4+
labels: ["task"]
5+
body:
6+
- type: textarea
7+
id: summary
8+
attributes:
9+
label: Summary
10+
description: What needs to be done
11+
validations:
12+
required: true
13+
14+
- type: textarea
15+
id: acceptance-criteria
16+
attributes:
17+
label: Acceptance Criteria
18+
description: Specific, testable criteria for completion
19+
placeholder: |
20+
- [ ] Criterion 1
21+
- [ ] Criterion 2
22+
validations:
23+
required: true
24+
25+
- type: textarea
26+
id: relevant-files
27+
attributes:
28+
label: Relevant Files
29+
description: Files or directories the agent should focus on
30+
placeholder: |
31+
- src/module/file.py
32+
- tests/test_module.py
33+
validations:
34+
required: false
35+
36+
- type: textarea
37+
id: dependencies
38+
attributes:
39+
label: Dependencies
40+
description: Other issues that must complete before this task
41+
placeholder: |
42+
- #issue_number
43+
validations:
44+
required: false
45+
46+
- type: textarea
47+
id: technical-notes
48+
attributes:
49+
label: Technical Notes
50+
description: Design constraints, patterns to follow, or other guidance
51+
validations:
52+
required: false
53+
54+
- type: dropdown
55+
id: agent-role
56+
attributes:
57+
label: Agent Role
58+
description: Which role should handle this task
59+
options:
60+
# Core roles
61+
- Planner
62+
- Architect
63+
- Coder
64+
- Tester
65+
- Reviewer
66+
- Security Auditor
67+
- Documenter
68+
# Optional / specialized roles
69+
- Triager
70+
- DevOps
71+
- Dependency Manager
72+
- Refactorer
73+
validations:
74+
required: true

‎.github/PULL_REQUEST_TEMPLATE.md‎

Lines changed: 26 additions & 45 deletions
Original file line numberDiff line numberDiff line change
@@ -1,45 +1,26 @@
1-
## Purpose
2-
<!-- Describe the intention of the changes being proposed. What problem does it solve or functionality does it add? -->
3-
* ...
4-
5-
## Does this introduce a breaking change?
6-
<!-- Mark one with an "x". -->
7-
```
8-
[ ] Yes
9-
[ ] No
10-
```
11-
12-
## Pull Request Type
13-
What kind of change does this Pull Request introduce?
14-
15-
<!-- Please check the one that applies to this PR using "x". -->
16-
```
17-
[ ] Bugfix
18-
[ ] Feature
19-
[ ] Code style update (formatting, local variables)
20-
[ ] Refactoring (no functional changes, no api changes)
21-
[ ] Documentation content changes
22-
[ ] Other... Please describe:
23-
```
24-
25-
## How to Test
26-
* Get the code
27-
28-
```
29-
git clone [repo-address]
30-
cd [repo-name]
31-
git checkout [branch-name]
32-
npm install
33-
```
34-
35-
* Test the code
36-
<!-- Add steps to run the tests suite and/or manually test -->
37-
```
38-
```
39-
40-
## What to Check
41-
Verify that the following are valid
42-
* ...
43-
44-
## Other Information
45-
<!-- Add any other helpful information that may be needed here. -->
1+
## Task Issue
2+
3+
Closes #<!-- issue number -->
4+
5+
## Description
6+
7+
<!-- What changes does this PR make and why? -->
8+
9+
## Checklist
10+
11+
- [ ] Linked to task issue
12+
- [ ] Changes are minimal (only what the task requires)
13+
- [ ] Tests added/updated
14+
- [ ] All tests pass (`make test`)
15+
- [ ] Linting passes (`make lint`)
16+
- [ ] No secrets or credentials committed
17+
- [ ] Documentation updated (if applicable)
18+
- [ ] Follows project conventions (docs/conventions.md)
19+
20+
## Reviewer Notes
21+
22+
<!-- Anything reviewers should know or pay attention to -->
23+
24+
## Security Considerations
25+
26+
<!-- Any security implications of these changes? (new inputs, auth changes, dependency updates, etc.) -->

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

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -17,6 +17,10 @@ You are the API Agent. You design, build, and maintain API endpoints. You ensure
1717
- **Dev Server Command:** [e.g., `npm run dev`, `make run`, `go run ./cmd/server`]
1818
- **API Test Command:** [e.g., `npm test -- --grep api`, `make test-api`, `go test ./api/...`]
1919

20+
## MCP Tools
21+
- **GitHub MCP** — `search_code`, `get_file_contents` — understand existing API patterns and contracts
22+
- **Context7** — `resolve-library-id`, `get-library-docs` — look up framework-specific API conventions and documentation
23+
2024
## Responsibilities
2125

2226
- Design API endpoints with consistent naming, methods, and status codes

‎.github/agents/architect.agent.md‎

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -21,6 +21,15 @@ You are the Architect. You make design decisions that shape the system's structu
2121
- **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.
2222
- **Key capabilities needed:** Deep analytical reasoning, tradeoff evaluation, large context window (for understanding system-wide impacts), structured document generation
2323

24+
## MCP Tools
25+
- **GitHub MCP** — `search_code`, `get_file_contents`, `search_repositories` — understand existing codebase structure before designing
26+
- **Context7** — `resolve-library-id`, `get-library-docs` — fetch accurate, version-specific library documentation before recommending a dependency
27+
- **Tavily** — `tavily_search`, `tavily_extract` — research architectural patterns, evaluate tradeoffs, look up RFCs
28+
- **Mermaid MCP** — diagram generation tools — produce architecture diagrams for ADRs and design docs
29+
- **Terraform MCP** — `terraform_plan`, `terraform_validate` — validate infrastructure designs and review Terraform configurations
30+
- **ADR MCP** — `search_adrs`, `create_adr`, `list_adrs` — search existing decisions, create new ADRs, and manage the decision log
31+
- **Complexity MCP** — `analyze_complexity`, `get_hotspots` — assess codebase health and identify high-complexity areas during design reviews
32+
2433
## Responsibilities
2534

2635
- Evaluate technical approaches and choose the best fit for the project's constraints

‎.github/agents/coder.agent.md‎

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -25,6 +25,14 @@ You are the Coder. You implement tasks by writing code. You take well-defined ta
2525
- **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.
2626
- **Key capabilities needed:** Code generation, tool use (file editing, terminal commands), large context window (for understanding existing codebase), test writing
2727

28+
## MCP Tools
29+
- **GitHub MCP** — `get_file_contents`, `create_pull_request`, `create_or_update_file`, `list_workflow_runs` — read code, open PRs, check CI status
30+
- **Context7** — `resolve-library-id`, `get-library-docs` — look up correct API signatures before writing code; do not rely on training data for library APIs
31+
- **E2B** — `execute_python`, `execute_javascript`, `install_packages` — run and test code in an isolated sandbox before committing
32+
- **Semgrep** — `semgrep_scan` — self-audit new code for security issues before opening a PR
33+
- **Commits MCP** — `generate_commit_message` — generate conventional commit messages from staged diffs
34+
- **ADR MCP** — `search_adrs`, `get_adr` — read architecture decisions before implementing to ensure alignment with design choices
35+
2836
## Responsibilities
2937

3038
- Read task issues and understand the acceptance criteria before writing any code

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

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -18,6 +18,10 @@ You are the DBA Agent. You manage database schemas, write migrations, optimize q
1818
- **Migration Command:** [e.g., `make migrate-up`, `npx prisma migrate dev`, `alembic upgrade head`]
1919
- **Database Connection:** [e.g., see `.env.example` for connection string format, use `make db-shell` for direct access]
2020

21+
## MCP Tools
22+
- **GitHub MCP** — `search_code`, `get_file_contents` — review existing schema, migrations, and query patterns
23+
- **Context7** — `resolve-library-id`, `get-library-docs` — look up database driver and ORM documentation
24+
2125
## Responsibilities
2226

2327
- Design database schemas with proper normalization, constraints, and indexes

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

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -25,6 +25,10 @@ You are the Dependency Manager. You keep the project's dependencies healthy, sec
2525
- **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.
2626
- **Key capabilities needed:** Changelog comprehension, version comparison, security advisory evaluation, structured PR generation
2727

28+
## MCP Tools
29+
- **GitHub MCP** — `list_dependabot_alerts`, `get_file_contents` — review dependency alerts and lock files
30+
- **OSV MCP** — `query_package`, `query_batch` — look up CVEs for dependencies being updated
31+
2832
## Responsibilities
2933

3034
- Monitor dependencies for new versions (major, minor, patch)

0 commit comments

Comments
 (0)