Rust off Rails: 코드 없이 Markdown 60개로 만든 AI 에이전트용 웹 스택

Who Should Read

코딩 에이전트에게 풀스택 웹앱을 맡길 때 매번 스택·구조가 달라져 고민인 백엔드 개발자

Core Mechanics

• 프레임워크가 코드 대신 Markdown이다
  • 프레임워크 코드는 0줄이고 Markdown 파일 60개로 구성된다.
  • 에이전트가 이 문서를 읽고 Rust 웹앱 코드를 직접 작성한다.
• 스택 선택을 미리 못 박았다
  • Axum·Tokio·SeaORM·Askama·Tailwind 등 크레이트(Rust 라이브러리)를 하나씩 정해 두었다.
  • 에이전트가 ORM 같은 걸 고민하지 않게 하는 것이 목적이다.
• 인터뷰→계획→생성→검증 순서로 돈다
  • 제품 질문만 묻고, 계획은 product/ 스펙에 적는다.
  • fmt, clippy, SQLite와 Postgres 양쪽 테스트가 통과해야 끝난다.
• 프론트엔드 모드를 처음에 하나 고른다
  • htmx가 기본이고 inertia(React/Svelte)와 spa도 있다.
  • api 모드는 아직 작업 중이다.
• 스킬 8개와 개발 도구가 딸려 있다
  • /offrails:new, feature, scaffold, generate, check, doctor, deploy, upgrade가 있다.
  • 트레이스·프로파일러·로컬 메일함·잡 대시보드가 내장되고 에이전트가 JSON으로 읽을 수 있다.
• 실제 앱 포팅으로 검증했다고 한다
  • Uptime Kuma 포팅은 SQLite와 Postgres에서 1530개 중 1530개 테스트가 통과했다.
  • Fizzy와 FreeScout 포팅은 진행 중이다.

Community Reactions

• 문서 한 장이면 충분하다는 의견
  • "Rails 방식 MVC와 마이그레이션으로 Rust 백엔드를 만들어라"라는 프롬프트로 족하다는 댓글이 있었다.
  • 베스트 프랙티스를 쓰게 한 뒤 앱을 만들게 하면 뭐가 다르냐는 질문도 나왔다.
• 코드가 아니라 문서라서 보장이 약하다는 반론
  • 진짜 프레임워크는 코드로 규칙을 강제하는데 이건 토큰만 더 쓰고 보장은 줄어든다는 댓글이 있었다.
• 스택 정의 자체는 쓸 만하다는 의견
  • 한 댓글은 "스택 스킬" 개념에 가치가 있다고 봤다.
  • 다만 문서를 소스 오브 트루스로 두기보다 에이전트와 대화하며 문서화하는 방식을 선호한다고 했다.
• 이미 비슷한 게 있다는 지적
  • Rust의 Loco(loco.rs)와 Go의 golazy.dev를 언급한 댓글이 있었다.
  • Rust 웹 백엔드는 컴파일 시간이 길어 Go가 낫다는 의견도 있었다.

How to Apply

• 지금 쓰는 에이전트에 스택 고정 문서 만들기
  • 오늘 AGENTS.md에 크레이트·폴더 구조·테스트 기준을 한 줄씩 못 박아라.
  • 에이전트가 "어떤 라이브러리 쓸까"를 묻지 않게 하라.
• 완료 조건을 명령어로 박기
  • 린트·타입체크·테스트 명령을 Definition of Done으로 적어라.
  • 에이전트가 이 명령이 모두 통과해야 끝났다고 말하게 하라.
• 기능 요청을 스펙 파일로 남기기
  • 채팅 대신 product/features/*.md에 인수 기준을 적어라.
  • 각 기준마다 테스트가 대응되는지 에이전트에게 확인시켜라.
• Claude Code로 작은 앱 하나 시험하기
  • 빈 디렉터리에서 플러그인을 설치하고 /offrails:new로 작은 앱을 만들어 보라.
  • 설치 스크립트는 파이프 실행 전에 직접 읽어라.

Try It

# Claude Code 빈 디렉터리에서 실행 (원문 방법의 간이 버전)

/plugin marketplace add rust-off-rails/rustoffrails
/plugin install offrails@offrails

/offrails:new bookshelf: people track the books they've read and review them

# 이어서 해 볼 것: 아래를 입력해 기능 추가
Scaffold Book with title:string, author:string, published_on:date, rating:integer.
Users must be logged in to create books.

Terminology

관련 논문

• LayerFS: AI 코딩 에이전트를 위한 파일시스템

  에이전트마다 임시 Workspace를 마운트하고 결과만 커밋하는 파일시스템

• Launch HN: Alter (YC S25) – 멀티유저 에이전트용 접근 제어

  에이전트마다 별도 신원·정책·감사로 API 키 공유 문제를 푼다

• Claude로 코드의 공격 표면(attack surface) 줄이기

  Claude로 25개 오픈소스를 분석해 불필요하게 열린 코드 493건을 찾았다

• WhatsApp 도움말 페이지에 숨겨진 LLM 지시문: 규제기관을 추천하지 말라

  WhatsApp 도움말에 화면엔 안 보이는 AI 지시문 102개가 숨어 있었다

• 같은 시뮬레이션, 다른 근거: 도구 출력을 파일로 넘기면 LLM 에이전트 정확도가 어디서 깎이나

  긴 툴 출력을 파일로 넘기자 GPT-5.1은 정확도 11.3%p 하락, 정식 출력 지정하니 회복

• 가짜 뉴스가 진짜 폭락을: LLM 트레이딩 에이전트 대상 정보 주입 공격

  가짜 헤드라인 한 줄로 LLM 트레이딩 에이전트 62%를 조종했다(프롬프트 주입은 14%)

• Harness Engineering 101: LLM은 뇌, harness는 몸

  에이전트는 JSON 배열을 관리하는 루프이고, 16개 챕터로 직접 만들어 본다

• Harness²: 에이전트 harness를 스스로 고쳐 쓰는 재귀 최적화 프레임워크

  모델은 고정하고 harness를 재귀로 고쳤더니 벤치마크 점수가 최대 11.8%p 올랐다

Related Resources

• https://rustoffrails.org/
• https://rustoffrails.org/install.sh
• https://loco.rs/
• https://golazy.dev
• https://rustoffrails.org/docs#the-stack-in-one-breath
• https://rustoffrails.org/how-it-was-built