Skip to content

Commit 9d2cd0a

Browse files
docs(blog): add launch announcement post
Introduces DevRail with beta status, feedback link to GitHub Issues, and overview of the contract, container, agent support, and language matrix. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
1 parent 05f7860 commit 9d2cd0a

File tree

1 file changed

+91
-0
lines changed

1 file changed

+91
-0
lines changed
Lines changed: 91 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,91 @@
1+
---
2+
title: "Introducing DevRail"
3+
date: 2026-03-02
4+
description: "One Makefile, one container, every language -- opinionated development standards for teams that ship with AI agents."
5+
---
6+
7+
## The Problem
8+
9+
Every team eventually builds its own tooling stack. Linters, formatters, security scanners, test runners -- installed differently on every developer's machine, pinned to different versions in CI, and completely invisible to the AI agent that just rewrote half your codebase.
10+
11+
The result is predictable. Code that passes locally fails in CI. An agent commits unformatted code because it doesn't know your project uses `shfmt`. A new hire spends a day installing tools that should have been one command. Environment drift compounds over time, and the response is always the same: more documentation that nobody reads, more onboarding steps that go stale, more "works on my machine."
12+
13+
The root cause is not carelessness. It is the absence of a universal contract -- a single interface that produces identical results regardless of who (or what) runs it.
14+
15+
## What DevRail Does
16+
17+
DevRail provides that contract. It consists of three components:
18+
19+
1. **One Makefile.** Public targets (`make lint`, `make format`, `make test`, `make security`, `make scan`, `make check`) delegate to a Docker container. No tools run on the host.
20+
2. **One container.** The [`dev-toolchain`](https://github.com/devrail-dev/dev-toolchain) image packages every linter, formatter, security scanner, and test runner for all supported languages. Pin a version tag and forget about tool management.
21+
3. **One config file.** `.devrail.yml` declares which languages your project uses. The Makefile reads it and runs only the relevant tools.
22+
23+
The outcome: `make check` produces the same results on your laptop, in CI, and inside an AI agent's sandbox. If it passes, the code meets the standard. If it fails, the output tells you exactly what to fix.
24+
25+
## How It Works
26+
27+
1. **Start from a template.** Create a new repository from the [GitHub](https://github.com/devrail-dev/github-repo-template) or [GitLab](https://github.com/devrail-dev/gitlab-repo-template) template. All DevRail files are pre-configured.
28+
29+
2. **Declare your languages.** Edit `.devrail.yml` to list the languages your project uses:
30+
31+
```yaml
32+
languages:
33+
- python
34+
- bash
35+
```
36+
37+
3. **Run `make check`.** Every tool executes inside the container. Results are identical on every machine.
38+
39+
```console
40+
$ make check
41+
✓ lint (ruff, shellcheck)
42+
✓ format (ruff format, shfmt)
43+
✓ test (pytest, bats)
44+
✓ security (bandit, semgrep)
45+
✓ scan (trivy, gitleaks)
46+
```
47+
48+
4. **Ship with confidence.** CI pipelines call the same `make` targets. Pre-commit hooks catch issues before push. AI agents follow the same rules.
49+
50+
Already have a project? The [retrofit guide](/docs/getting-started/retrofit/) walks you through adding DevRail files to an existing repository without disrupting your code.
51+
52+
## What's in the Container
53+
54+
The `dev-toolchain` container includes tools for seven language ecosystems. Each language has opinionated defaults documented in the [standards reference](/docs/standards/).
55+
56+
| Concern | Python | Bash | Terraform | Ansible | Ruby | Go | JS/TS |
57+
|---|---|---|---|---|---|---|---|
58+
| Linter | ruff | shellcheck | tflint | ansible-lint | rubocop | golangci-lint | eslint |
59+
| Formatter | ruff | shfmt | terraform fmt | -- | rubocop | gofumpt | prettier |
60+
| Security | bandit | -- | tfsec | -- | brakeman | govulncheck | npm audit |
61+
| Tests | pytest | bats | terratest | molecule | rspec | go test | vitest |
62+
63+
Universal tools -- trivy, gitleaks, and git-cliff -- run for every project regardless of language.
64+
65+
## Agent-Ready by Default
66+
67+
DevRail was built with AI coding agents in mind. The template repositories ship with instruction files for Claude Code (`CLAUDE.md`), Cursor (`.cursorrules`), OpenCode (`.opencode/agents.yaml`), and a generic `AGENTS.md`. Each file inlines six critical rules so agents follow the standard even if they don't read cross-file references.
68+
69+
The shortest path to agent compliance:
70+
71+
> This project follows DevRail development standards. Read DEVELOPMENT.md before making changes. Run `make check` before marking any task complete.
72+
73+
Agents that follow file references get the full picture. Agents that don't still get the minimum viable rules. Either way, `make check` is the gate.
74+
75+
See the [agent setup guide](/docs/getting-started/agents/) for detailed configuration, example prompts, and verification steps.
76+
77+
## Current Status
78+
79+
DevRail is in **beta**. The core contract -- Makefile, container, `.devrail.yml` -- is stable and used in production projects. Language support for all seven ecosystems ships in the `v1` container image. Standards, tool versions, and defaults may still change based on real-world usage.
80+
81+
What works today: new projects from templates, retrofitting existing repos, CI integration, agent instruction files. What's still evolving: the `make fix` auto-remediation workflow, additional language ecosystems, and edge cases we haven't hit yet.
82+
83+
If you run into problems or have opinions about how things should work, [open an issue](https://github.com/devrail-dev/devrail.dev/issues). Bug reports, feature requests, and "this default is wrong" complaints are all welcome.
84+
85+
## Get Started
86+
87+
- [Quick start guide](/docs/getting-started/) -- set up a new project in minutes
88+
- [Retrofit guide](/docs/getting-started/retrofit/) -- add DevRail to an existing repository
89+
- [Standards reference](/docs/standards/) -- per-language tooling and configuration
90+
- [Container documentation](/docs/container/) -- how the dev-toolchain image works
91+
- [Contributing](/docs/contributing/) -- help improve DevRail

0 commit comments

Comments
 (0)