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
2 changes: 1 addition & 1 deletion .editorconfig
Original file line number Diff line number Diff line change
Expand Up @@ -16,6 +16,6 @@ trim_trailing_whitespace = true
indent_size = 4
max_line_length = 120

[*HostFactoryResolver.cs]
[{*HostFactoryResolver.cs,docs/**}]
ij_formatter_enabled = false
resharper_disable_formatter = true
54 changes: 54 additions & 0 deletions .github/AGENTS.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,54 @@
# AGENTS.md (GitHub / CI / release)

## PRs

- PR titles must use Conventional Commits format.
- Use `.github/pull_request_template.md` for PR descriptions.
- Dependabot PRs are exempt from title validation.

Allowed types:

- `feat`
- `fix`
- `docs`
- `refactor`
- `test`
- `chore`
- `ci`

Allowed scopes:

- `host`
- `envelopes`
- `abstractions`
- `opentelemetry`
- `source-generators`
- `deps`
- `build`
- `ci`
- `github`
- `core`
- `docs`
- `testing`
- `tests`

Examples:

- `feat(host): add handler support`
- `fix(abstractions): resolve dependency issue`
- `docs: update README examples`

## Releases

- Release Drafter creates draft releases from PR titles.
- User manually publishes GitHub release.
- Publishing release triggers NuGet package publishing.
- Do not manually bump `Directory.Build.props` for routine releases.
- Do not publish NuGet packages manually.
- Do not create GitHub releases directly.

Packages version synchronously:

- `MinimalLambda`
- `MinimalLambda.Abstractions`
- `MinimalLambda.OpenTelemetry`
1 change: 1 addition & 0 deletions .github/CLAUDE.md
1 change: 1 addition & 0 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -83,3 +83,4 @@ nunit-*.xml
/.sonarqube/
/codecov*
**/.venv
/AGENTS.local.md
41 changes: 41 additions & 0 deletions AGENTS.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,41 @@
# AGENTS.md (MinimalLambda)

MinimalLambda is a Lambda-first hosting framework for .NET.
Code under `src/` runs on AWS Lambda or generates code that will.

## Core guidance

- Prefer small, focused diffs.
- Match existing patterns; avoid unnecessary refactors.
- Nullable warnings are bugs.
- Prefer AOT/trimming-friendly code.
- Avoid reflection-heavy/dynamic approaches unless required and guarded.
- Run formatting and relevant tests before handoff.

## Common commands

```bash
DOTNET_NOLOGO=1 dotnet restore
DOTNET_NOLOGO=1 dotnet tool restore
task format
task test:all
task build:aot-check
```

## Repo conventions

- C# preview is used in many projects.
- C# 14 `extension(...)` blocks are valid. Do not rewrite them to old `this` extension methods.
- XML docs: use only C# XML-supported tags. Do not use unsupported HTML tags like `<strong>`.

## More specific guidance

- Source/runtime code: `src/AGENTS.md`
- Tests: `tests/AGENTS.md`
- GitHub, PR, release, CI: `.github/AGENTS.md`
- Documentation: `docs/AGENTS.md`

## Git / PR

Use `git-workflow` skill for commits, branches, and PRs.
When writing PRs, use `./.github/pull_request_template.md`.
Loading
Loading