Documents / Public read-only

하네스가 남긴 문서

하네스를 적용하면 설계 승인부터 배포·운영 증거까지 단계마다 문서가 남습니다. 그 문서를 그대로 보여줍니다. 각 단계가 무엇을 통과해야 다음으로 넘어갔는지를 일이 지나간 순서대로 읽을 수 있습니다.

7단계

신규제작

없던 것을 새로 만드는 일의 순서입니다. 백지에서 시작해 설계 승인부터 배포까지 지나간 자취를 그대로 보여줍니다 — 여기서는 마침 이 사이트 자신이 그 예입니다.

무엇을 만든 기능이었는지는 중요하지 않습니다. 같은 순서와 같은 게이트가 모든 기능에 적용됩니다. 여기서는 마침 이 사이트 자신이 그 예입니다.

스킬(Superpowers·spec-kit)은 이 저장소 작업에서 실제로 써 온 것이다. 에이전트 역할 세 개는 2026-08-18에 작업 하나를 구현·검토·수정으로 한 번 통과시켰다 — 다만 저장소에 정의된 에이전트가 그대로 등록되어 돌아간 것은 아니고, 정의 파일의 계약을 실어 같은 역할을 수행시킨 것이다.

  1. 01 · 브레인스토밍

    브레인스토밍

    이 단계에서 활용되는 것

    • Superpowersbrainstorming

    가이드에서 이 단계 설명 보기5240lab 근거 보기

  2. 02 · 기능 정의

    기능 정의

    이 단계에서 활용되는 것

    • spec-kitspeckit-specify
    • spec-kitspeckit-clarify
    • spec-kitspeckit-checklist

    가이드에서 이 단계 설명 보기5240lab 근거 보기

  3. 03 · 기술 설계

    기술 설계

    이 단계에서 활용되는 것

    • spec-kitspeckit-plan

    가이드에서 이 단계 설명 보기5240lab 근거 보기

  4. 04 · 작업 분해

    작업 분해

    이 단계에서 활용되는 것

    • Superpowerssubagent-driven-development / executing-plans
    • spec-kitspeckit-tasks
    • spec-kitspeckit-analyze

    가이드에서 이 단계 설명 보기5240lab 근거 보기

  5. 05 · 격리 구현

    격리 구현

    이 단계에서 활용되는 것

    • Superpowerstest-driven-development
    • Superpowerssubagent-driven-development / executing-plans
    • spec-kitspeckit-implement
    • 에이전트 역할harness-implementer

    가이드에서 이 단계 설명 보기5240lab 근거 보기

  6. 06 · 독립 검토

    독립 검토

    이 단계에서 활용되는 것

    • Superpowerssubagent-driven-development / executing-plans
    • Superpowersverification-before-completion
    • 에이전트 역할harness-reviewer
    • 에이전트 역할harness-fixer

    가이드에서 이 단계 설명 보기5240lab 근거 보기

  7. 07 · 통합 배포

    통합 배포

    이 단계에서 활용되는 것

    • Superpowersverification-before-completion

    가이드에서 이 단계 설명 보기5240lab 근거 보기

9단계

SM · 개선·추가

이미 운영 중인 시스템을 고치고 더하는 일의 순서입니다. 백지가 아니라 그 시스템에 이미 쌓인 문서에서 출발해, 그 문서를 다시 닫는 것으로 끝납니다. 5240lab의 SM 작업은 이 순서를 따릅니다.

2026-08-18에 운영 중인 시스템(kiwi HR)의 화면 하나를 골라 이 순서를 실제로 밟아봤습니다. 완주하지 못했고 두 곳에서 걸렸습니다. 걸렸다는 것이 곧 게이트가 일했다는 뜻이라, 감추지 않고 그대로 적습니다. 여기서 드러난 규정의 빈칸은 개선 로드맵의 "일하는 방법" 칸에 쌓았습니다.

  1. 01 · 현행 확인

    현행 확인

    실제로 돌려보니 걸렸습니다. 대상 화면의 모듈 문서가 마지막으로 확인된 날짜가 코드 변경보다 26일 뒤처져 있었습니다. 그 사이 그 영역을 건드린 커밋이 12건 있었고, 문서에 흔적이 없는 기능이 그 안에 있었습니다. 낡은 문서를 근거로 고칠 곳을 지목하면 이미 바뀐 자리를 또 고치자고 적게 됩니다 — 이 게이트가 막으려는 것이 그것입니다.

    가이드에서 이 단계 설명 보기

  2. 02 · 개선 정의

    개선 정의

    이 단계에서 활용되는 것

    • Superpowersbrainstorming

    가이드에서 이 단계 설명 보기

  3. 03 · 영향 분석

    영향 분석

    가이드에서 이 단계 설명 보기

  4. 04 · 기술 설계

    기술 설계

    가이드에서 이 단계 설명 보기5240lab 근거 보기

  5. 05 · 작업 분해

    작업 분해

    가이드에서 이 단계 설명 보기5240lab 근거 보기

  6. 06 · 격리 구현

    격리 구현

    이 단계에서 활용되는 것

    • Superpowerstest-driven-development

    가이드에서 이 단계 설명 보기5240lab 근거 보기

  7. 07 · 독립 검토

    독립 검토

    실제로 돌려보니 걸렸습니다. 영향 분석이 "확인 필요"로 남긴 항목을 닫을 수단이 없었습니다. 게이트는 설계대로 물렸지만, 확인할 수 없는 항목을 어떻게 처리할지가 규정에 없어 여기서 멈췄습니다.

    이 단계에서 활용되는 것

    • Superpowersverification-before-completion

    가이드에서 이 단계 설명 보기5240lab 근거 보기

  8. 08 · 매뉴얼 동기화

    매뉴얼 동기화

    가이드에서 이 단계 설명 보기5240lab 근거 보기

  9. 09 · 통합 배포

    통합 배포

    가이드에서 이 단계 설명 보기5240lab 근거 보기

전체 45편

문서 전체, 단계별로

같은 하네스 단계 축으로 이 사이트가 싣는 문서 전체를 다시 묶었습니다. 문서 한 편이 여러 기능에서 같은 단계 역할을 반복해서 맡을 수 있어, 위 여정과 아래 색인에 같은 문서가 다시 나올 수 있습니다.

9편

브레인스토밍

가이드에서 이 단계 설명 보기5240lab 근거 보기

4편

기능 정의

가이드에서 이 단계 설명 보기5240lab 근거 보기

12편

기술 설계

가이드에서 이 단계 설명 보기5240lab 근거 보기

2편

작업 분해

가이드에서 이 단계 설명 보기5240lab 근거 보기

7편

격리 구현

가이드에서 이 단계 설명 보기5240lab 근거 보기

3편

독립 검토

가이드에서 이 단계 설명 보기5240lab 근거 보기

2편

매뉴얼 제작

가이드에서 이 단계 설명 보기5240lab 근거 보기

2편

통합 배포

가이드에서 이 단계 설명 보기5240lab 근거 보기

4편 · 모든 단계에 적용

기준문서

특정 단계에 속하지 않고, 모든 단계를 규율한다.

맨 위로