Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 14 additions & 0 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
# Contributing

We'd like to try something a little different with this repo.

Given that coding agents write most underlying code now, we'd prefer PRs in the form of _human-written_
text. This can be quite informal — just run your idea by us in the same way you would a coworker or
friend, say, over Slack. If we're aligned on the change, we're happy to burn our tokens
on the underlying implementation.

Please do not have AI artificially expand what you'd like to do into a formal proposal.

Submit changes as a PR adding a `.txt` or `.md` file to the [`adrs/`](./adrs/) folder.

PS: Report any security vulnerabilities privately — see [`SECURITY.md`](./SECURITY.md), not a public issue.
9 changes: 5 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -116,10 +116,11 @@ and this repository has no production deployment workflow. See

## Contributing

Issues and pull requests are welcome. `npm run typecheck`, `npm run lint`, and `npm test`
are the checks to run locally — CI adds the Postgres suites, the CLI and plugin builds,
and the deployment contracts. Report vulnerabilities privately —
see [`SECURITY.md`](./SECURITY.md), not a public issue.
We take contributions as _human-written_ text, not code — see
[`CONTRIBUTING.md`](./CONTRIBUTING.md). Describe the change you'd like informally in a
`.txt` or `.md` file in [`adrs/`](./adrs/), and if we're aligned we'll handle the
implementation. Report vulnerabilities privately — see [`SECURITY.md`](./SECURITY.md),
not a public issue.

## Customize your instance

Expand Down
Empty file added adrs/.gitkeep
Empty file.