Contributor-focused guide for AI agents working on the AWS CDK codebase. AWS CDK is an open-source framework that lets developers define cloud infrastructure in code and provision it through AWS CloudFormation. This is a TypeScript monorepo that uses jsii to generate bindings for Python, Java, .NET, and Go. Constructs follow a layered model: L1 (auto-generated CloudFormation wrappers), L2 (intent-based APIs with smart defaults), and L3 (multi-resource patterns). See CONTRIBUTING.md for the full contributor guide. You are a CDK contributor. You…
13k17d agoReviewMountCreate a free account to mount
Guidance for AI coding agents (Cursor, GitHub Copilot, Claude Code, Amazon Q Developer, Kiro, Codex, Gemini CLI, etc.) working in this repository. Follows the AGENTS.md convention (https://agents.md). This repository contains example notebooks for the Amazon SageMaker Python SDK v3. pip install sagemaker installs v3. SDK v3 is a modular redesign and is not backward compatible with v2. It is split into: Generate SageMaker Python SDK v3 code by default. Produce v2 code only when the user explicitly asks for "v2"…
11k2mo agoReviewMountCreate a free account to mount
These rules apply when you add or edit the per-version notes in upgrade-guide.md (the ### Upgrading to <version>+ sections). Rank notes within each group by impact as well. For metrics, that means how much observability breaks, e.g. how widely the metric is used and how many queries the change breaks. - This file isn't published: website/hugo.yaml lists AGENTS.md in ignoreFiles.
No other project uses it yet
7.7k36d agoReviewMountCreate a free account to mount
Guidance for AI coding agents (Cursor, GitHub Copilot, Claude Code, Amazon Q Developer, Kiro, Codex, Gemini CLI, etc.) working in this repository — the source of the Amazon SageMaker Python SDK. Follows the AGENTS.md convention (https://agents.md). This file has two audiences: 1. Contributors' agents editing SDK source, tests, and docs in this repo. 2. Any agent that reads this repo as a reference for how to use the SDK — so the usage guidance (v3 by default) is stated here…
Steady6 mentions in 2 weeks
No other project uses it yet
2.3k3mo agoReviewMountCreate a free account to mount
Correct behavior is necessary but not sufficient — structural quality is a hard requirement. Don't accept a messy implementation just because it passes tests. Read the relevant doc before working in that area:
49045d agoReviewMountCreate a free account to mount
@aws/agentcore: the AgentCore CLI (agentcore). TypeScript, React/Ink TUI, Commander under a custom Router/Handler framework, AWS SDK v3, zod. Developed with Bun, shipped to run under Node (npm bundle) and as Bun-compiled standalone binaries. Read CONTRIBUTING.md first for architecture (Router/Handler tree, Context, middleware, Core + dependency inversion, TUI, testing strategy, repo layout). This file only adds what is not obvious from there or from the code. Use Bun for tooling (bun install, bun run, bunx). Lockfile is bun.lock; CI runs bun…
32811d agoReviewMountCreate a free account to mount
You are writing the code for an AgentCore runtime. The AgentCore CLI deploys this folder. Follow these rules exactly, or agentcore dev and agentcore deploy will fail. README.md in this folder explains each rule in more detail. - Put the entrypoint in main.py at the root of this folder. To use another file, name it in pyproject.toml under [tool.agentcore] as entrypoint = "server.py" (optionally "server.py:app"); the CLI copies it into agentcore/agentcore.json on agentcore dev, build, and deploy. - Implement the…
32811d agoReviewMountCreate a free account to mount
You are writing the code for an AgentCore runtime. The AgentCore CLI deploys this folder. Follow these rules exactly, or agentcore dev and agentcore deploy will fail. README.md in this folder explains each rule in more detail. - Put the entrypoint in main.ts at the root of this folder. The CLI bundles it into main.js, which agentcore.json records as the entrypoint. A "main" in package.json other than "main.ts" is ignored. - Implement the runtime contract with the AgentCore SDK for…
32811d agoReviewMountCreate a free account to mount
smithy-go is the Go code generator and runtime for Smithy. It has two major components: 1. Codegen (codegen/) — A Smithy build plugin written in Java that generates Go client/server/shape code from Smithy models. 2. Runtime (./, top-level Go module) — The Go packages that generated code depends on at runtime. The primary downstream consumer is aws-sdk-go-v2. The codegen artifact version is published to Maven Central and bumped on each release. For local development against unreleased codegen changes, use publishToMavenLocal…
2594mo agoReviewMountCreate a free account to mount
AWS OFI NCCL is a plugin that enables NVIDIA NCCL, AMD RCCL, and AWS Neuron applications to use libfabric as a network provider. It maps NCCL's connection-oriented transport APIs to libfabric's connection-less reliable interface (FI_EP_RDM). The project uses GNU autotools (autoconf, automake, libtool). If a compile_commands.json file does not exist, you should run make clean ; bear -- make in order to generate a compile_commands.json to build a database for clangd. Unit tests are in tests/unit/. They run without special…
2416mo agoReviewMountCreate a free account to mount
Tests use handwritten spies and the verification helpers in common/CommonTestCase.swift. Do not add Cuckoo, generated mocks, or method-specific verifier proxies without explicit approval. Avoid reintroducing equivalent boilerplate: Run the affected test class first, then run the complete suite before submitting broad test refactors:
1534mo agoReviewMountCreate a free account to mount
Guidance for AI coding agents working in the AWS SDK for .NET repository. Read and follow: Before modifying SDK source, read: For DevConfig work, also read: Do not edit generated source directly. Follow the maintainer skill to determine whether a change belongs in handwritten code, a generator, or a service model. When working under generator/SmithyDotNet/, also follow:
15330d agoReviewMountCreate a free account to mount
Contributor-focused guide for AI agents working on the AWS CDK CLI monorepo. This is the monorepo for the AWS CDK's command-line interface and programmatic toolkit. It contains the cdk CLI, the programmatic @aws-cdk/toolkit-lib, and supporting libraries for CloudFormation diffing, cloud assembly handling, and asset publishing. The repo is TypeScript-only, managed by Projen, built with NX for caching and task orchestration, and uses Yarn workspaces. This is not the construct library repo (aws/aws-cdk). This repo focuses exclusively on the CLI toolchain…
11058d agoReviewMountCreate a free account to mount
This document provides guidance specifically for AI agents working on the AWS Bedrock AgentCore TypeScript SDK codebase. For human contributor guidelines, see CONTRIBUTING.md. AGENTS.md contains agent-specific repository information including: For human contributors: See CONTRIBUTING.md for setup, testing, and contribution guidelines.
9957d agoReviewMountCreate a free account to mount
Rules for coding agents that change this repository. People follow them too. 1. Read the rules for every change. Reviewers, people and agents, enforce them. 2. Before you change the SDK package, read packages/aws-durable-execution-sdk-js/AGENTS.md. It lists the SDK invariants and the contract tests that guard them. 3. A new feature, a new option or a public API change starts with a design note. A maintainer agrees to it before you write code. 1. Keep the change as small as the…
8514d agoReviewMountCreate a free account to mount
This file is for people and coding agents who change the SDK itself. The root AGENTS.md covers the whole repository. The rules for every change in CONTRIBUTING.md apply too. The checkpoint manager suspends the invocation when no operation is EXECUTING and another operation is waiting. It sees only lifecycle states. So SDK work that runs while no operation is EXECUTING can be cut off, and the code after it then runs in no recorded invocation. The rules below prevent that.…
8514d agoReviewMountCreate a free account to mount
This repository contains the AWS Durable Execution SDK for Python and its companion packages, used to author AWS Lambda durable functions. Do not rely on this file for method signatures, configuration objects, or code examples. The canonical reference is the AWS Durable Execution SDK Developer Guide, which is maintained alongside SDK releases and covers TypeScript, Python, and Java. Key sections: For Lambda service topics such as deployment, infrastructure as code, invocation, IAM permissions, and quotas, see the Lambda durable functions…
5820d agoReviewMountCreate a free account to mount
AWSAGENTS.md