Devflow Native — AI 코딩 에이전트 작업 흐름을 repo 안에 남기는 CLI

Devflow Native — AI 코딩 에이전트 작업 흐름을 repo 안에 남기는 CLI

AI 코딩 에이전트가 코드를 생성하는 속도보다 "이 작업이 어디까지 진행됐는지", "다음 세션이 어디서 이어가야 하는지"를 추적하는 게 더 어려운 일입니다. Devflow Native는 바로 이 문제를 해결하는 로컬 퍼스트 워크플로우 하네스입니다.

---

Devflow Native란

Devflow Native는 Codex, Claude Code 같은 AI 코딩 에이전트를 대체하는 도구가 아닙니다. 대신 에이전트 주변에 붙는 로컬 퍼스트 워크플로우 하네스입니다. 저장소(repo) 안에 작업 상태, 검증 결과, 다음 세션 이어가기 정보를 남겨서 에이전트 간 연속성을 확보합니다.

AI 코딩을 하다 보면 코드 생성 자체보다 이런 질문들이 더 자주 등장합니다:

• "작업이 어디까지 왔지?"

• "무엇을 실제로 검증했고 무엇이 아직 위험해 보여?"

• "다음 세션이 어디서 이어가야 하지?"

Devflow는 이 정보를 repo 안에 남기는 것이 핵심 철학입니다. 에이전트가 떠난 후에도 저장소를 열면 이전 세션의 작업 맥락이 그대로 남아있는 느낌입니다.

---

주요 기능

프로젝트 초기화

Devflow를 프로젝트에 적용하면 .devflow/config.json과 기본 워크플로우 문서가 자동으로 생성됩니다. 별도 설정 없이 바로 워크플로우 추적을 시작할 수 있습니다.

에이전트 하네스

Codex나 Claude Code용 하네스를 지원합니다. 다음 명령으로 하네스를 설치하고 상태를 확인할 수 있습니다:

# 하네스 설치 (Codex/Claude Code에게 설치 자체를 맡길 수 있음)

devflow harness inspect
devflow harness install
devflow harness health-check

Agent-native 설정을 따르면 에이전트가 스스로 Devflow를 설치하고 상태를 확인하면서 작업을 진행합니다.

repo 상태 확인

현재 repo의 변경 파일, 게이트, 세션,handoff 상태를 한눈에 확인할 수 있습니다:

devflow status

→ 변경 파일 목록, 검증 상태, 다음 작업 등 출력

리뷰 증거 기록

작업 완료 전 "이것만하면 완료로 인정해도 되는지" dry-run 점검 기능이 있습니다. 리뷰 증거(record)를 남겨서 실제로 무엇이 검증됐는지 투명하게 관리합니다.

다음 세션용 프롬프트 생성

에이전트가 finish하기 전에 다음 세션이 이어받을 프롬프트를 자동 생성합니다. 다음에 저장소를 여는 순간, 이전 작업이 어디서 멈췄는지 바로 파악할 수 있습니다:

devflow handoff generate

→ 다음 세션 이어가기용 프롬프트 출력

MCP STDIO 서버

MCP stdio server로 구현되어 있어 agent host에서 호출 가능합니다. Claude Code, Codex 같은 에이전트가 Devflow를 자신의 워크플로우 안에서 직접 호출할 수 있습니다.

---

기존 도구와의 차이점

Devflow를 다른 AI 코딩 관련 도구와 비교하면 그 위상이 더 선명합니다:

도구	목적	위치
Superpowers	에이전트가 따라야 할 개발 습관 정의	에이전트 규칙 레벨
CodeGraph	repo를 이해하기 위한 컨텍스트 레이어	코드 구조 분석
Devflow	작업이 실제로 어디까지 진행되고 무엇이 검증됐는지 repo-local state로 남기기	작업 흐름 추적

Superpowers가 에이전트의 행동을 규칙으로 정의한다면, Devflow는 에이전트가 실제로 한 작업을 상태로 기록합니다. CodeGraph가 코드의 구조를 파악한다면, Devflow는 그 구조 위에서 움직이는 작업의를 추적합니다.

---

활용 시나리오

새 세션 시작 시

다른 팀원이 작업한 repo를받은 상황을 생각해봅니다. Devflow가 남긴 handoff 정보를 확인하면 이전 에이전트가 무엇을 했는지, 무엇을했고, 다음에 무엇을 해야 하는지 바로 파악할 수 있습니다.

# 이전 세션의 작업 상태 확인

devflow status

다음 세션용 프롬프트 확인
devflow handoff show

리뷰 증거 기반 작업 완료 체크

에이전트가 작업을 끝냈다고 느낄 때, Devflow의 dry-run 점검으로 "완료라고 말해도 되는지" 객관적으로 확인할 수 있습니다. 검증되지 않은 작업은 handoff에 남겨서 다음 세션이 이어받도록 합니다.

---

설치하고 써보기

아직 alpha 단계이지만 직접 써볼 수 있습니다. 가장 의도에 맞는 방법은 README의 "Agent-native setup" 흐름을 따라 Codex나 Claude Code에게 설치와 health check를 맡기는 방식입니다:

# Codex/Claude Code에게 설치 맡기기 (가장 자연스러운 시작)

에이전트가 직접 Devflow를 설치하고 설정함

저자도 OpenCairn 같은 repo에 직접 적용하면서 개선 중인 상태입니다. 피드백을 적극적으로 받고 있으므로, 실제 사용 중 느끼는 문제나 개선 아이디어를 GitHub 이슈로 공유하면 도움이 됩니다.

---

향후 발전 방향

저자가 강조하는 질문들입니다:

• 이런 작업 흐름 기록이 실제 AI coding에 도움이 되는지

• repo에 남겨야 하는 정보와 local-only로 둬야 하는 정보의 경계

• Codex/Claude 외에 어떤 agent host를 먼저 지원하면 좋을지

AI 코딩 에이전트가 단순한 코드 생성기를 넘어 협업 도구로 성숙하려면, 작업의 연속성(workflow continuity)이 핵심입니다. Devflow Native는 그 방향에서한 시도입니다.

---

요약

Devflow Native는 AI 코딩 에이전트의 작업 흐름을 repo-local state로 남기는 로컬 퍼스트 CLI입니다. 에이전트가 떠나도 저장소에 작업 맥락이 남아있어, 다음 세션이 자연스럽게 이어갈 수 있습니다. Codex/Claude 하네스, repo 상태 추적, 리뷰 증거 기록, 세션 handoff 프롬프트 생성을 제공합니다. AI 코딩 워크플로우의 연속성 문제를 해결하고 싶다면하는 도구입니다.

---

📚 출처

• GeekNews - Devflow Native

• GitHub - Sungblab/devflow-native

---

📚 출처

• https://news.hada.io/topic?id=29955