diff --git a/.github/ISSUE_TEMPLATE/bug_report.md b/.github/ISSUE_TEMPLATE/bug_report.md new file mode 100644 index 0000000..2091a29 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/bug_report.md @@ -0,0 +1,33 @@ +--- +name: Bug report +about: Report something that does not work as expected +title: "bug: " +labels: bug +--- + + + +## What happened + + + +## Steps to reproduce + +1. +2. +3. + +## Environment + +- MAESTRO version / commit: +- Install method: +- OS & Node.js version: +- LLM endpoint: + +## Logs + + + +``` +``` diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml new file mode 100644 index 0000000..db18f92 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/config.yml @@ -0,0 +1,8 @@ +blank_issues_enabled: false +contact_links: + - name: Security vulnerability + url: https://github.com/your-org/maestro/blob/main/SECURITY.md + about: Do not open a public issue for a vulnerability. Follow the security policy instead. + - name: Documentation + url: https://github.com/your-org/maestro/tree/main/docs + about: Setup, configuration, and architecture guides. diff --git a/.github/ISSUE_TEMPLATE/feature_request.md b/.github/ISSUE_TEMPLATE/feature_request.md new file mode 100644 index 0000000..54bb224 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/feature_request.md @@ -0,0 +1,22 @@ +--- +name: Feature request +about: Suggest an enhancement or new capability +title: "feat: " +labels: enhancement +--- + +## Problem + + + +## Proposed solution + + + +## Alternatives considered + + + +## Additional context + + diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md new file mode 100644 index 0000000..313465d --- /dev/null +++ b/.github/PULL_REQUEST_TEMPLATE.md @@ -0,0 +1,25 @@ + + +## Summary + + + +## Related issues + + + +## How verified + + + +- [ ] `npx tsc --noEmit` is clean +- [ ] Relevant tests pass (`npm test` or a focused `npx vitest run `) + +## Checklist + +- [ ] Change is focused and scoped to one concern +- [ ] Tests added/adjusted for behavior that changed +- [ ] New config options reflected in `config.yaml.example` **and** `docs/configuration.md` +- [ ] New tools registered in `tools/index.ts` + listed in the relevant Piece + documented in `docs/tools/` +- [ ] DB schema changes have an idempotent migration in `src/db/migrate.ts` +- [ ] Docs updated when behavior or setup changed diff --git a/CODE_OF_CONDUCT.md b/CODE_OF_CONDUCT.md new file mode 100644 index 0000000..a929ae1 --- /dev/null +++ b/CODE_OF_CONDUCT.md @@ -0,0 +1,21 @@ +# Code of Conduct + +This project adopts the [Contributor Covenant](https://www.contributor-covenant.org/version/2/1/code_of_conduct/), +version 2.1, as its Code of Conduct. + +In short: we want participation in this project to be a respectful, +harassment-free experience for everyone. Be considerate and constructive in +issues, pull requests, and all other project spaces. + +## Scope + +This Code of Conduct applies within all project spaces and when an individual +is representing the project in public spaces. + +## Reporting + +If you experience or witness unacceptable behavior, report it privately to the +maintainers using the repository host's private contact feature, or by +contacting the repository owner directly. Reports will be reviewed and handled +discreetly. The full text of the standards, enforcement guidelines, and +maintainer responsibilities is available at the Contributor Covenant link above. diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 54e007b..405a19b 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -3,6 +3,11 @@ Thanks for your interest in contributing! This guide covers how to build, run, test, and submit changes. +## Code of Conduct + +This project is governed by our [Code of Conduct](CODE_OF_CONDUCT.md). By +participating, you are expected to uphold it. + ## Prerequisites - **Node.js 22+** diff --git a/README.ja.md b/README.ja.md index 6a236dc..f16e5c0 100644 --- a/README.ja.md +++ b/README.ja.md @@ -57,6 +57,7 @@ scripts/server.sh start # http://localhost:9876 - **[docs/tools/](docs/tools/)** — 各ツールの詳細 - **[docs/operations/bash-sandbox-provisioning.md](docs/operations/bash-sandbox-provisioning.md)** — 本番でのサンドボックス有効化手順 - **[AGENTS.md](AGENTS.md)** / **[CONTRIBUTING.md](CONTRIBUTING.md)** — コントリビュータ向け +- **[CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md)** — コミュニティ行動規範 - **[SECURITY.md](SECURITY.md)** — セキュリティ方針・脆弱性報告 ## セキュリティ diff --git a/README.md b/README.md index eb7a297..674debe 100644 --- a/README.md +++ b/README.md @@ -57,6 +57,7 @@ For detailed instructions, see **[docs/getting-started.md](docs/getting-started. - **[docs/tools/](docs/tools/)** — details of each tool - **[docs/operations/bash-sandbox-provisioning.md](docs/operations/bash-sandbox-provisioning.md)** — how to enable the sandbox in production - **[AGENTS.md](AGENTS.md)** / **[CONTRIBUTING.md](CONTRIBUTING.md)** — for contributors +- **[CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md)** — community standards - **[SECURITY.md](SECURITY.md)** — security policy and vulnerability reporting ## Security