BlastLoop

BlastLoop은 Ross Shaw가 개발한 AI 에이전트용 실용적인 코딩 프레임워크입니다. 이 프레임워크는 Blast, Mid, 그리고 Inner에서 서로 다른 수준(altitude)으로 코드를 작성한 다음, 순서대로 T1 구조적(structural), T2 버그/운영(bug/ops), 그리고 T3 적대적(adversarial) 테스트를 수행합니다.

존재 이유: AI 코딩 에이전트는 팀의 속도를 높이지만, 동시에 실패하는 속도 또한 빠르게 만듭니다. BlastLoop은 운영(operations) 마인드셋을 에이전트 작업에 적용합니다. 즉, 모든 변경 사항에는 적절한 수준의 소유자가 있으며, 모든 결과물은 배포되기 전에 구조적, 운영적, 그리고 적대적 게이트를 정해진 순서로 통과해야 합니다.

BlastLoop 상세 설명: WORLDWRIGHT Issue 3, AI가 엔지니어링 실패를 제거하지 않았다는 것. 단지 더 빠르게 만들었을 뿐이다.

버전: 1.0.0
슬로건: 구조 우선, 기능 다음, 공격은 세 번째.

5분 만에 AI 코딩 에이전트와 BlastLoop 사용하기

이 저장소를 에이전트의 도움이 필요한 프로젝트 폴더로 복제(Clone)합니다.
에이전트를 AGENTS.md 파일로 지정합니다.
작업 수준에 따라 적절한 빌드 프롬프트를 로드합니다:
- 시스템 또는 리포지토리 구조: prompts/blast.md
- 서브시스템 또는 기능 슬라이스: prompts/mid.md
- 로컬 파일 또는 단위 변경: prompts/inner.md
에이전트가 해당 수준에서 코드를 작성하도록 합니다. BlastLoop은 '명세 우선(spec first)', '계획 우선(plan first)', 그리고 '단일 구현자' 방식이 아닙니다. 빌드 계층은 자체 범위 내에서 코드를 생성해야 합니다.
다음 순서로 테스트 루프를 실행합니다:
만약 T3에서 구조적 문제가 발견되면, T1부터 재시작하고 수정 경로를 Blast, Mid, 또는 Inner로 되돌린 다음, T2와 T3를 다시 실행합니다.

이것이 전체 공개 버전의 전부입니다: 적절한 프롬프트를 로드하고, 올바른 수준에서 작성하며, 올바른 순서로 테스트하는 것입니다.

필요한 핸드오프 패킷(handoff packet)과 라우팅 규칙은 docs/HANDOFFS.md를 참조하십시오. 한 스테이지는 자체적인 관점에서 수정 사항을 권장할 수 있지만, 소유권을 가진 고도(owning altitude)가 여전히 변경 사항을 결정하고 구현합니다.

B / M / I: 세 가지 코딩 고도 (three coding altitudes)

Blast

Blast는 시스템 레벨 코드와 구조를 작성합니다.

다음과 같은 작업이 필요한 경우 Blast를 사용하십시오. 리포지토리(repo) 형태, 서비스 경계(service boundaries), 최상위 인터페이스(top-level interfaces), 공유 계약(shared contracts), 배포 구조(deployment structure), 또는 새로운 기능의 골격(skeleton)을 변경할 때입니다.

Mid

Mid는 서브시스템 코드(subsystem code)를 작성합니다.

다음과 같은 작업이 필요한 경우 Mid를 사용하십시오. 로컬 패치보다는 크지만 시스템 재설계보다는 작은 작업, 즉 기능 슬라이스(feature slice), 서비스 모듈(service module), 통합 표면(integration surface), 또는 서브시스템 리팩토링(subsystem refactor)입니다.

Inner

Inner는 로컬 유닛 코드(local unit code)를 작성합니다.

다음과 같은 작업이 필요한 경우 Inner를 사용하십시오. 몇 개의 파일, 함수, 테스트 또는 어댑터에 국한된 작업입니다. Inner는 BlastLoop의 로컬-유닛 고도이며, 초점이 맞춰진 범위(focused scope), 명확한 소유권(clear ownership), 그리고 변경 사항의 직접적인 완료(direct completion)를 의미합니다.

T1 -> T2 -> T3 테스트 루프 (test loop)

이 순서대로 테스트를 실행하십시오.

T1 구조적 (structural)

T1은 구조적 문제를 찾습니다. 잘못된 경계, 잘못된 고도의 로직 배치, 누수되는 추상화(leaky abstractions), 깨진 파일 소유권, 누락된 인터페이스, 또는 잘못 배치된 교차 관심사(cross-cutting concerns) 등이 포함됩니다.

T1은 일반적인 버그 수정기처럼 작동하지 않습니다. 그 임무는 코드가 올바르게 형태를 갖추었는지 결정하고, 수정을 적절한 작성자(Inner, Mid, 또는 Blast)에게 라우팅하는 것입니다.

T2 버그/운영 (bug / ops)

T2는 구조가 이미 건전할 경우 직접적으로 버그와 운영 문제를 수정합니다.

T2가 발견한 문제가 실제로는 아키텍처적인 문제인 경우, 로컬에서 임시방편으로 덮어버리기보다는 T1로 에스컬레이션(escalates)합니다.

T3 적대적 (adversarial)

T3는 결과에 공격을 가합니다. 엣지 케이스(edge cases), 오용(misuse), 레이스 컨디션(race conditions), 이상한 입력값, 취약한 가정(brittle assumptions), 보안 태세(security posture), 롤백 경로(rollback paths), 그리고 실패 동작(failure behavior) 등이 포함됩니다.

만약 T3가 구조적 문제를 발견한다면, 루프는 다음과 같이 재시작합니다:

T3 -> T1 -> B/M/I 수정 -> T2 -> T3

이 재시작 규칙은 중요합니다. 구조적인 파손(Structural breakage)은 로컬 버그로 패치하는 것이 아니라, 구조적으로 수리되어야 합니다.

이것이 아닌 것들

사실 확인기(fact-checker)가 아닙니다. BlastLoop는 진실 엔진이 아니라 코딩 및 테스트 프레임워크입니다.
GitHub Spec Kit도 아닙니다. Spec Kit은 명세(spec) $
ightarrow$ 계획(plan) $
ightarrow$ 작업(tasks) $
ightarrow$ 구현(implement) $
ightarrow$ 수렴(converge)의 흐름을 따릅니다. BlastLoop는 여러 코딩 고도(altitudes)와 단계적 테스트 루프를 결합한 것입니다.
경쟁하는 '에이전트 스타일'도 아닙니다. BlastLoop는 Spec Kit, 바이브 코딩(vibe coding), 집중적인 로컬 구현 프롬프트(focused local implementation prompts), 또는 레드/블루 테스트(red/blue testing)와 함께 작동할 수 있습니다. 이들은 고도나 테스트 레이어 안에 위치할 수 있으며, BlastLoop는 이들을 라우팅하는 구조 중심의 루프입니다.
다중 에이전트 조직도도 아닙니다. 이번 공개 버전은 관리 계층, 봇 계층 구조 또는 사설 자동화를 정의하지 않습니다.
레드/블루 테스트만으로 이루어진 것도 아닙니다. 적대적 테스트(Adversarial testing)는 T3에서만 수행되는 것이지 전체 방법론을 구성하는 것은 아닙니다.

다른 에이전트 스타일과의 연동

BlastLoop는 특정 코딩 스타일이나 하나의 계획 방식만을 요구하지 않습니다.

Spec Kit은 코드 작성 전에 계획을 수립할 수 있도록 돕습니다.
바이브 코딩 또는 기타 구현 스타일은 범위에 따라 Blast, Mid, 또는 Inner 내부에서 작동할 수 있습니다.
집중적인 로컬 구현 프롬프트는 작업에 적합할 경우 Inner 내부에서 사용될 수 있습니다.
레드/블루 테스트는 T3의 적대적 작업에 자연스럽게 통합됩니다.

BlastLoop의 역할은 작업을 라우팅하는 것입니다. 즉, 올바른 고도를 선택한 다음 순서대로 T1 $
ightarrow$ T2 $
ightarrow$ T3을 실행합니다.

자세한 비교는 docs/COMPARISON.md를 참고하십시오.

리포지토리 내용물

AGENTS.md - 어떤 프롬프트를 로드할지에 대한 라우팅 카드
prompts/ - 각 빌드 및 테스트 역할에 대한 로드 가능한 지침(instructions)
docs/HANDOFFS.md - 필수 핸드오프 패킷 및 소유권 규칙
docs/COMPARISON.md - 인접한 공개 방법론과의 간략한 비교
examples/session.md - 루프를 통해 작은 기능을 가상으로 워크스루(walkthrough)하는 예시

라이선스

MIT. LICENSE 참조.

Show HN: AI 에이전트를 위한 구조 우선 코딩 방법론 BlastLoop

요약

핵심 포인트