Mister Clean

Mister Clean은 저장소 작업을 끝까지 마무리하기 위한 에이전트 스킬입니다. 완료 부채를 갚고, 계획 상태와 Git 상태를 조정하고, 결과를 검증하며, 후임자가 바로 이어받을 수 있는 코드베이스를 남깁니다. 전제는 간단합니다. 저장소는 다음 팀의 프롬프트이므로, 깨끗한 인수인계는 지적인 추진력을 만들지만, 끝나지 않은 인수인계는 이후의 모든 세션에서 부채를 누적시킵니다.

호출은 이 스킬에 문서화된 절차에 대한 상시 승인입니다. 일반적인 범위 내 정리는 대기열에 넣지 않고 수행됩니다. 안전과 소유권에 관한 확고한 경계는 계속 확고한 경계로 유지됩니다.

스킬 사용하기

이 저장소를 에이전트 하네스에 스킬로 설치한 후 호출하십시오:

$mister-clean

진입점은 SKILL.md입니다. 현재 저장소와 관련이 있을 때만 집중 참조 문서로 연결합니다.

Related MCP server: capalith

MCP 서버 사용하기

로컬 stdio 서버를 실행하십시오:

npx -y --package @bradheitmann/mister-clean mister-clean-mcp

또는 Streamable HTTP 클라이언트를 다음에 연결하십시오:

https://mister-clean.bradheitmann.ai/mcp

MCP 서버는 의도적으로 읽기 전용입니다. 표준 스킬, 참조 문서, 템플릿, 예제 및 마무리(closeout) 프롬프트를 제공합니다. 호출 에이전트는 저장소 정책과 소유권을 검증할 수 있는 로컬에서 권한 있는 작업을 수행합니다.

마무리 검증

공식 로컬 검증기는 하나의 Node 호환 CLI를 통해 제공됩니다:

mister-clean validate report path/to/closeout-report.json
mister-clean validate manifest path/to/action-manifest.json
mister-clean validate bundle path/to/closure-bundle.json --repo path/to/live-checkout
mister-clean audit planning path/to/live-checkout --json

계획 감사는 실행 가능한 후임 인계 준비 최소 기준입니다. Markdown/MDX YAML frontmatter와 최상위 JSON 및 YAML 객체 레코드를 파싱하고, 계획 디렉터리와 ROADMAP.md, STATUS.md, PLAN.md, TASKS.md, BACKLOG.md, CURRENT.md 같은 정확한 표준 파일을 모두 발견하며, 물리적 레인과 현재 본문 상태를 조정하고, 구조화된 목록과 하위 테이블에서 정확한 하위 ID를 해석하며, 동일한 승인 게이트의 중복 투영을 그룹화합니다. 형식이 잘못된 구조화 레코드, 지원되지 않는 수명주기 또는 게이트 상태, 모순된 부모 관계, 번들 전용 아카이브 레이블, 완료된 하위 항목 이후의 누락된 게이트, 그리고 실행되지 않았거나 실패한 승인은 모두 0이 아닌 종료 코드를 반환합니다. 모든 계획 항목은 구조적으로 검증된 하나의 수명주기/관계 그래프에 배치되거나, 근거와 함께 비산출물 지침으로 명시적으로 분류되어야 합니다. 지침/템플릿/스키마 레이블은 수명주기, 정체성, 관계, 하위 테이블 또는 승인 신호를 절대 재정의하지 않습니다. 승인은 구조화된 근거가 있을 때만 not_applicable일 수 있습니다. 이 보수적인 교차 저장소 게이트 외에도 저장소별 스키마와 검증기가 계속 실행됩니다.

하위 참조는 명시적인 의미론적 역할을 가집니다. 일반 작업 산출물은 child_parentage를 사용합니다. 하위 행은 정확히 하나의 산출물로 해석되고 그래프 간선을 만듭니다. index, status_index, 또는 rollup 유형의 산출물은 rollup_projection을 사용합니다. 모든 행은 여전히 고유하게 해석되고 현재 상태와 일치해야 하지만, 두 번째 부모가 되지는 않습니다. 저장소별 산출물은 relationship_role: child_parentage 또는 relationship_role: rollup_projection과 relationship_role_rationale를 사용해 기본값을 재정의할 수 있습니다. 지원되지 않거나, 충돌하거나, 모호하거나, 설명되지 않은 재정의는 실패 시 닫힘 처리됩니다. 내장 계층 구조 및 롤업 유형은 변경할 수 없는 역할을 가지므로, 근거만으로 스토리/태스크를 인덱스로 또는 인덱스를 부모로 다시 레이블링할 수 없습니다. 롤업은 표준 작업 항목 대상 열을 인식합니다. 저장소별 열에는 rollup_target_column과 rollup_target_column_rationale가 필요하며, 사용자 지정 부모 테이블은 child_target_column과 child_target_column_rationale를 사용합니다. 인식되거나 선언된 대상 열이 없는 상태를 지닌 관계 테이블은 실패 시 닫힘 처리됩니다. 모든 테이블 행과 구조화된 하위 컬렉션 항목은 하나의 해석 가능한 정체성을 포함해야 합니다. 투영된 상태는 인식 가능하고 일관적이어야 합니다. CamelCase 및 snake_case 레코드 키는 동일한 스키마를 공유합니다. 일반 계층 구조 산출물은 non_relationship_table_columns와 non_relationship_table_rationale를 사용하여 체크리스트/결정 테이블 대상 열을 면제할 수 있습니다. 롤업 산출물과 표준 관계/수명주기 열은 그 탈출구를 사용할 수 없습니다.

산출물 유형, 정체성, 수명주기, 역할, 대상, 근거 및 top_level 별칭은 존재 인식 방식입니다. 선언된 각 단수 별칭은 하나의 비어 있지 않은 스칼라를 포함해야 하며, 동등한 별칭은 서로 일치해야 합니다. 추론이나 기본값은 해당 별칭이 없을 때만 허용됩니다. 중복 JSON 키, 지원되지 않는 상태형 별칭, 형식이 잘못된 관계 범위 및 복합 수명주기 문구는 실패 시 닫힘 처리됩니다. 산출물의 정체성을 확립하는 것은 해당 산출물 자신의 유형화된 ID와 일반 id뿐이며, 부모 필드는 절대 아닙니다. 단수, 복수, 스네이크 케이스 및 캐멀 케이스의 하위/부모 참조 별칭은 항목별로 조정됩니다. 부모 참조 수명주기는 해석된 부모와 일치해야 합니다.

승인 발견은 지원되는 부모 관계를 따라 구조화된 레코드를 재귀적으로 탐색하고 모든 선언된 결과 범위를 검증합니다. not_applicable 근거는 정확히 그 범위 안에 있어야 합니다. 구조화된 JSON/YAML은 결코 본문으로 재해석되지 않습니다. Markdown 스캐닝은 펜스 처리된 예제와 HTML 주석을 무시하면서도, 표시되는 제목 및 인용구 상태 레이블, 승인 레이블, 검토 대기 문구 및 체크되지 않은 승인 항목을 계속 조정합니다. 중첩된 표준 작업 선언과 유형이 해석되지 않은 계층 별칭은 일반 메타데이터나 비산출물 분류 뒤에 숨을 수 없습니다. 발견된 계획 루트 내의 지원되지 않는 항목, 바이너리 항목 및 심볼릭 링크 항목은 독립 실행 감사에서 실패합니다. CLEAN 번들은 모든 활성 항목을 포함해야 하며, 지원되지 않는 일반 파일을 근거 있는 비산출물로 명시적으로 분류해야 합니다.

설치된 스킬은 자체 bin/mister-clean.js에서 동일한 독립 실행 CLI를 실행합니다. 대상 저장소에 Mister Clean 도구가 포함되어 있다고 가정하지 않습니다. 보고서, 매니페스트, 번들 및 해당 다이제스트로 묶인 증거 레코드를 하나의 실행 디렉터리 아래에 함께 보관하십시오.

릴리스를 제안하기 전에 전체 프로젝트 검사를 실행하십시오:

bun install --frozen-lockfile
bun run check
bun src/cli.ts audit public-safety .

공개 안전 경계

공개 배포본에는 일반화된 원칙과 합성 예제가 포함되어 있습니다. 비공개 사례 연구, 로컬 경로, 자격 증명, 프로젝트 이름 및 운영 증거는 이 저장소나 Git 히스토리에 포함되어서는 안 됩니다.

라이선스

MIT