Borrowing it
Nothing to install: this file belongs to aws/tools-for-devops-agent. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.
curl -O https://raw.githubusercontent.com/aws/tools-for-devops-agent/main/.kiro/steering/project-conventions.mdgit clone --depth 1 https://github.com/aws/tools-for-devops-agentWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/instructions/aws/tools-for-devops-agent/project-conventions)<a href="https://agentmods.dev/instructions/aws/tools-for-devops-agent/project-conventions"><img src="https://agentmods.dev/badge/instructions/aws/tools-for-devops-agent/project-conventions/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/instructions/aws/tools-for-devops-agent/project-conventions"><img src="https://agentmods.dev/badge/instructions/aws/tools-for-devops-agent/project-conventions.svg" alt="Reviewed on agentmods" width="80" height="20"></a>What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.08925 | $0.08925 |
| Opus 5.5 | $0.03570 | $0.03570 |
| Sonnet 5.5 | $0.01785 | $0.01785 |
| Haiku 4.5 | $0.00893 | $0.00893 |
Grade A, and why
tools-for-devops-agent project-conventions.md scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 344 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Project Conventions
This repository consolidates open-source tools for AWS DevOps Agent — skills, custom agents, and MCP servers, plus supporting infrastructure templates. Follow these conventions when contributing. See CONTRIBUTING.md for the full contribution workflow.
Key References
- Agent Skills spec — the open standard this project follows for skill structure
- AWS DevOps Agent Skills documentation — official AWS docs on creating and uploading skills
- AWS DevOps Agent custom agents documentation — official AWS docs on custom agents
- AGENTS.md specification — the open standard for custom agent definitions
- Model Context Protocol — the open standard for MCP servers
- Connecting MCP servers to DevOps Agent — official AWS docs on registering MCP servers
Repository Structure
tools-for-devops-agent/
├── README.md # Project overview with links to the docs-site catalogs
├── CONTRIBUTING.md # Contribution guidelines
├── llms.txt # Structured repo overview for AI tools
├── .gitignore # Root-level ignores
├── cloudformation/
│ ├── devops-agent-skill-policies/ # IAM policies skills require
│ └── devops-agent-alarm-investigations/ # CloudWatch alarm → DevOps Agent webhook
├── docs/ # GitHub Pages (mkdocs) documentation site
├── skills/
│ ├── .gitignore # Allowlist for DevOps Agent supported extensions only
│ └── <skill-name>/
│ ├── SKILL.md # Required: main skill instructions with frontmatter
│ ├── README.md # Skill documentation (purpose, prompts, upload instructions)
│ ├── CHANGELOG.md # Version history
│ ├── evals/ # Required: skill evaluation tool output (generated)
│ │ ├── evals.json
│ │ ├── structure/ # structure-tests-results-v<N>.json
│ │ ├── best-practices/ # v<N>/benchmark.json, v<N>/iteration-<n>/
│ │ └── functional/ # v<N>/benchmark.json, v<N>/iteration-<n>/
│ ├── assets/ # Optional: images, diagrams, data files
│ └── references/ # Optional: supplementary reference docs
├── custom-agents/
│ └── <agent-name>/
│ ├── SYSTEM_PROMPT.md # Required: the agent's system prompt
│ ├── README.md # Agent documentation
│ └── CHANGELOG.md # Version history
└── mcp/
└── <server-name>/
├── README.md # Server documentation and deployment steps
└── ... # Server implementation and deployment assets
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 2d ago Changed · +13 lines · +352 tokens per session f9f0d2cf9054
- 9d ago Changed · +19 tokens per session b6c19970aa3c
- 10d ago Changed · +1 lines · +133 tokens per session 19b77d4cb2ac
- 15d ago Changed · +54 lines · +1,223 tokens per session b30ae9a74c83
- 17d ago Changed · +28 lines · +1,703 tokens per session 8e87fa9700b6
- 1mo ago Changed · +23 lines · +1,407 tokens per session 1ccfda8218be
- 1mo ago Changed · +2 lines · +224 tokens per session 7838221e6c08
- 1mo ago Changed · +42 lines · +1,345 tokens per session bf23f331680c
- 1mo ago Changed · +30 lines · +810 tokens per session 0d5a3843dba6
- 1mo ago First seen · 151 lines · 1,709 tokens per session scan A 473d55113390
tools-for-devops-agent project-conventions.md is an instructions file published in the GitHub repository aws/tools-for-devops-agent (137 stars, last pushed yesterday), licensed Apache-2.0. It adds 8,925 tokens to every session, about $0.0357 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-10.
tools-for-devops-agent project-conventions.md compared with instructions from other repositories
| Mod | Type | Stars | Last push | Licence | Scan | Tokens | Works with |
|---|---|---|---|---|---|---|---|
| tools-for-devops-agent project-conventions.mdaws/tools-for-devops-agent | Instructions file | 137 | yesterday | Apache-2.0 | A | 8,925 | Kiro |
| vscode buildNext.instructions.mdmicrosoft/vscode | Instructions file | 195k | today | MIT | A | 9,719 | GitHub Copilot |
| next.js AGENTS.mdvercel/next.js | Instructions file | 143k | today | MIT | A | 7,461 | Codex, OpenCode |
| langchain AGENTS.mdlangchain-ai/langchain | Instructions file | 149k | today | MIT | A | 4,680 | Codex, OpenCode |
| vscode oss-third-party-notices.instructions.mdmicrosoft/vscode | Instructions file | 195k | today | MIT | A | 5,516 | GitHub Copilot |
| vscode copilot-instructions.mdmicrosoft/vscode | Instructions file | 195k | today | MIT | A | 3,093 | GitHub Copilot |
| deepseek-harness AGENTS.mddeepseek-ai/deepseek-harness | Instructions file | 274k | 2d ago | MIT | A | 4,313 | Codex, OpenCode |