Community생산성 & 협업github.com

Pu11en/sysmap

저장된 클릭 가능한 맵을 통해 시스템을 계획하고 설명합니다. 협업 설계, 계획 대화 이어가기, 시스템 설명, 또는 합의된 구현 계획 준비에 사용하세요. 설계 관련 질문은 채팅에서 유지하세요.

sysmap란 무엇인가요?

이 스킬은 개발자와 AI 에이전트가 시스템 동작을 시각적 맵으로 계획하고 설명할 수 있도록 지원합니다. 협업 설계, 계획 대화 이어가기, 시스템 설명, 합의된 구현 계획 준비에 유용합니다. 주요 기능은 `.plan.json` 소스 파일을 기반으로 시스템 파트(부품)를 정의하고, 각 파트의 역할, 입력, 작업, 결과, 규칙 등을 구조화된 필드로 기록합니다. 결과물은 클릭 가능한 맵으로 생성되어 시스템 동작을 직관적으로 파악할 수 있으며, 채팅은 토론과 의사 결정 기록을 유지합니다. Cursor, Claude Code 등 다양한 AI 에이전트 플랫폼에서 사용할 수 있으며, 계획과 구현을 명확히 분리하여 신중한 설계를 강조합니다. 오픈 질문, 결정 사항, 검증된 사실과 미검증 제안을 구분하여 기록하며, 검증되지 않은 가정 없이 증거 기반으로 시스템을 설명합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Pu11en/sysmap/tree/HEAD

Installed? Explore more 생산성 & 협업 skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

시스템 맵을 통한 계획 수립

그리거나 구축하기 전에 공유된 이해를 만드세요. 맵은 시스템 동작을 보여주고, 채팅은 논의를 유지합니다. 계획 수립은 제품 구현을 허가하지 않습니다.

계획 수립을 시작하거나 재개하기 전에 계획 가이드를 읽으세요. 가이드는 소스 형식, 부품 기록, 탐색 및 검사를 정의합니다. 도우미 설정과 명령어는 README를 참조하세요.

증거에서 시작하세요

대화에 저장된 하나의 .plan.json 소스를 이어가세요. 목표, 결정, 미해결 질문 및 현재 계획 위치를 읽으세요. 기존 동작을 설명하기 전에 관련 프로젝트 증거를 검사하세요. 소스가 큰 경우 현재 부품과 그 이웃만 로드하세요.

새 대화의 경우 고유한 설명적 소스 이름을 선택하세요. 다른 대화의 계획을 덮어쓰지 마세요. 소스 계획이 권위적이며, 생성된 그림과 매니페스트는 편집 가능한 계획이 아닙니다.

검증된 사실, 합의된 계획, 미지의 사항, 수락되지 않은 제안을 분리하세요. 증거를 인용하세요. 모호한 레이블에서 이전 결정을 추론하거나 격차를 메우기 위해 사실을 지어내지 마세요.

그리기 전에 의미를 정의하세요

모든 부품에 대해 하나의 작업, 입력, 작업, 결과, 규칙, 다음 수신자, 경계 및 증거를 기록하세요. 가이드에 정의된 필드 이름을 사용하세요.

저장소를 액션과 분리하세요. 대기 상태와 작업을 구분하세요. 각 결과를 다음 부품의 예상 입력에 연결하세요. 연결된 부품을 통해 하나의 구체적인 예를 따라가세요.

짧은 레이블과 명명된 화살표를 사용하세요. 하위 페이지는 상위 부품을 설명합니다. 이름 일치나 추측된 링크가 아닌 명시적인 detail 대상을 통해 연결하세요. 그래프에서 도구 선택, 설계 질문 및 제거된 기능에 대한 설명을 유지하지 마세요.

협업하고 진행하세요

먼저 현재 질문에 답하세요. 다른 질문을 하기 전에 결정된 사항을 읽으세요. 요청된 변경 사항을 명확히 업데이트하면서 관련 없는 결정은 유지하세요. 동의는 실제로 제시된 제안만 수락합니다.

한 지점이 해결된 후, 의미 있는 다음 미해결 부품으로 이동하세요. 목적을 설명하고, 근거 있는 접근 방식을 제안한 다음, 설계를 변경하는 구체적인 선택지 하나를 물어보세요. 계획 수립을 인터뷰로 만들거나 "저장됨"에서 멈추지 마세요.

사소한 기본값은 제안으로 표시하세요. 권한, 개인정보 보호, 비용 또는 사실적 증거를 묵묵히 결정하지 마세요. 진행하기 전에 혼란을 해결하세요. 더 이상 중요한 결정 사항이 없으면 준비 상태를 요약하고 검토 또는 별도로 승인된 구현을 제안하세요.

완료를 주장하기 전에 확인하세요

계획을 변경한 후, 빌드하고 영향을 받은 연결과 하위 페이지 의미를 검사하세요. 브라우저 접근이 가능한 경우 그림과 탐색도 검사하세요. 사용할 수 없는 검사는 정직하게 보고하세요.

도우미 테스트는 구조와 생성된 출력을 확인하지만, 시스템의 진실, 실제 브라우저 상호작용 또는 모든 에이전트 환경과의 호환성은 확인하지 않습니다.

관련 스킬