문제점: 에이전트 워크플로우는 여전히 공유하기 어렵습니다

AI 코딩 에이전트(AI coding agents)는 점점 좋아지고 있지만, 그 주변의 워크플로우(workflows)는 여전히 놀라울 정도로 수동적입니다.

만약 좋은 워크플로우를 가지고 있다면, 아마 다음과 같은 모습일 것입니다:

1. 요청 명확화 (clarify the request)
2. 제안서 작성 (write a proposal)
3. 설계 검토 (review the design)
4. 구현 계획 수립 (create an implementation plan)
5. 테스트와 함께 빌드 (build with tests)
6. 결과 검증 (verify the result)
7. 학습 내용 아카이브 (archive the learning)

이 프로세스는 한 개인에게는 잘 작동할 수 있습니다. 문제는 이를 팀, 다른 프로젝트, 또는 미래의 자신을 위해 반복 가능하게(repeatable) 만드는 것입니다.

대부분의 에이전트 워크플로우는 여전히 프롬프트 기록(prompt history), 문서(docs), 또는 근육 기억(muscle memory) 속에 머물러 있습니다.

내가 만든 것

나는 완전한 AI 에이전트 워크플로우를 하나의 설치 가능한 스킬 트리(skill tree)로 패키징할 수 있는 작은 CLI인 GetSuperpower를 만들었습니다.

아이디어는 간단합니다:

• workflow.json에 워크플로우 정의
• 사용자가 호출할 하나의 진입 스킬(entry skill) 제공
• 필요할 때 로컬 워크플로우 전용 스킬 포함
• 재사용 가능한 스킬에 대한 의존성(dependencies) 선언
• 지원되는 에이전트 클라이언트(agent clients)에 워크플로우 설치

사용자는 모든 단계를 수동으로 호출할 필요가 없습니다. 워크플로우를 설치하고, 에이전트를 재시작한 다음, 하나의 진입 스킬을 호출하기만 하면 됩니다.

예시

OpenSpec 전달 워크플로우를 설치합니다:

npx getsuperpower@latest install 'https://github.com/0xroylee/getsuperpower.git#examples/workflows/openspec-superpowers'

그 다음 호출합니다:

$openspec-delivery implement this OpenSpec change

이 진입 스킬은 다음을 조정합니다:

제안(proposal) -> 설계(design) -> 계획(plan) -> TDD -> 검증(verification) -> 아카이브(archive)

워크플로우는 로컬 스킬과 재사용 가능한 스킬을 함께 사용할 수 있으므로, 작성자는 모든 것을 처음부터 다시 만들 필요 없이 자신만의 프로세스를 패키징할 수 있습니다.

왜 그냥 README를 사용하지 않나요?

README는 인간에게는 유용하지만, 반복 가능한 에이전트 실행(repeatable agent execution)을 위해서는 충분하지 않습니다.

에이전트 워크플로우에는 다음이 필요합니다:

• 명확한 진입점 (entry point)
• 명시적 의존성 (explicit dependencies)
• 설치 대상 (install targets)
• 검증 (validation)
• 무엇이 설치될지 검사할 수 있는 방법

GetSuperpower는 README를 유지하면서, 그 주변에 매니페스트(manifest)와 CLI를 추가합니다.

이것이 아닌 것

GetSuperpower는 완전한 에이전트 런타임 (agent runtime)이 되려는 것이 아닙니다.

만약 프로덕션급 에이전트 애플리케이션을 구축하고 있다면, LangGraph, CrewAI 또는 n8n과 같은 도구들이 더 적합할 수 있습니다.

GetSuperpower는 기존 코딩 에이전트 주변의 프로세스를 위한 패키지 매니저 (package manager)에 더 가깝습니다. 이는 에이전트가 따르기를 원하는 지침 (instructions), 의존성 (dependencies), 그리고 워크플로우 형태 (workflow shape)를 패키징합니다.

지원되는 대상 (Supported Targets)

GetSuperpower는 현재 다음 대상에 대한 스킬 설치 (skill installs)를 지원합니다:

• Claude
• Codex
• Cursor
• opencode / OpenCodex
• GitHub Copilot

자신만의 워크플로우 생성하기

자신만의 워크플로우를 스캐폴딩 (scaffold) 할 수 있습니다:

npx getsuperpower@latest init my-workflow
npx getsuperpower@latest validate my-workflow
npx getsuperpower@latest deps my-workflow

목표는 패키지가 공유되는 방식처럼 에이전트 워크플로우를 공유 가능하게 만드는 것입니다. 즉, 설치 가능하고, 검사 가능하며, 버전 관리가 되고, 시도하기 쉽게 만드는 것입니다.

Repo: https://github.com/0xroylee/getsuperpower

특히 매니페스트 (manifest) 형태와 의존성 모델 (dependency model)에 대한 피드백을 환영합니다.