{"_id":"@daeseoksong/afterglow-mcp","_rev":"7-ad1501d16ea6c37059670f10efe714f5","name":"@daeseoksong/afterglow-mcp","dist-tags":{"latest":"0.8.0"},"versions":{"0.1.0":{"name":"@daeseoksong/afterglow-mcp","version":"0.1.0","keywords":["mcp","model-context-protocol","claude","claude-code","anthropic","afterglow","agent","persona","rag","offboarding"],"author":{"url":"https://github.com/DaeSeokSong","name":"DaeSeokSong"},"license":"MIT","_id":"@daeseoksong/afterglow-mcp@0.1.0","maintainers":[{"name":"daeseoksong","email":"zxdsaqwe1231@naver.com"}],"homepage":"https://github.com/DaeSeokSong/Afterglow/tree/main/server#readme","bugs":{"url":"https://github.com/DaeSeokSong/Afterglow/issues"},"bin":{"afterglow-mcp":"dist/index.js"},"dist":{"shasum":"14d08bc803250a35ab2d0cad53fddafd00a33a7e","tarball":"https://registry.npmjs.org/@daeseoksong/afterglow-mcp/-/afterglow-mcp-0.1.0.tgz","fileCount":23,"integrity":"sha512-6FY98Vxh1xHO/3CrvMkvlRl12ZR3viRTLQDko9rmzZEzQpbbAmnXxi1dQZmT6ibqNDBgRyDDrqvsdsVVhAwp7Q==","signatures":[{"sig":"MEUCIQCM5B6O41AC+GkHfosKUg4WRDwQaYqrGmiFzU9sqDDDGwIgOT56wYgR9JV+Zc4fCr+zBlv+eTa3BpCTML5aCqQaVjU=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":92536},"type":"module","engines":{"node":">=18.0.0"},"gitHead":"0a8b45e72e5d0146c61d307288a2b8892f2fa0ec","scripts":{"dev":"tsc --watch","test":"vitest run","build":"tsc","start":"node dist/index.js","test:all":"npm run test && npm run build && npm run test:stdio","typecheck":"tsc --noEmit","test:stdio":"node test/stdio.smoke.mjs","prepublishOnly":"npm run build && npm run test"},"_npmUser":{"name":"daeseoksong","email":"zxdsaqwe1231@naver.com"},"repository":{"url":"git+https://github.com/DaeSeokSong/Afterglow.git","type":"git","directory":"server"},"_npmVersion":"11.9.0","description":"Afterglow MCP server — manage 퇴사자 에이전트 폴더 + persona + RAG, surfaced as Claude Code slash commands.","directories":{},"_nodeVersion":"24.14.0","dependencies":{"zod":"^3.23.8","@modelcontextprotocol/sdk":"^1.0.4"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^2.1.8","typescript":"~6.0.2","@types/node":"^24.12.3"},"_npmOperationalInternal":{"tmp":"tmp/afterglow-mcp_0.1.0_1779327868516_0.4986764735837341","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@daeseoksong/afterglow-mcp","version":"0.1.1","keywords":["mcp","model-context-protocol","claude","claude-code","anthropic","afterglow","agent","persona","rag","offboarding"],"author":{"url":"https://github.com/DaeSeokSong","name":"DaeSeokSong"},"license":"MIT","_id":"@daeseoksong/afterglow-mcp@0.1.1","maintainers":[{"name":"daeseoksong","email":"zxdsaqwe1231@naver.com"}],"homepage":"https://github.com/DaeSeokSong/Afterglow/tree/main/server#readme","bugs":{"url":"https://github.com/DaeSeokSong/Afterglow/issues"},"bin":{"afterglow-mcp":"dist/index.js"},"dist":{"shasum":"dedf01e14a72200efa0a05e543a5cd8dc7aa015e","tarball":"https://registry.npmjs.org/@daeseoksong/afterglow-mcp/-/afterglow-mcp-0.1.1.tgz","fileCount":23,"integrity":"sha512-dE86nux4p+98gPptdUVg6ArvPRpd5dyQvYA0xl3F/LEOcocES+B/2x1+GdEGS5fjGciIb4+Sy32fvOnKocTt9w==","signatures":[{"sig":"MEUCIE+ozseA5sBY9DAES/6Bn690p0kfuQzTKwGAvNqTSerzAiEAijvTotCXxOMhe/wHd5a0hjDSYrVwQgNaLFB7RPjhiBA=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":99138},"type":"module","engines":{"node":">=18.0.0"},"gitHead":"2fbbc5eb535b74f8729557e9ff66a8393a8fdc60","scripts":{"dev":"tsc --watch","test":"vitest run","build":"tsc","start":"node dist/index.js","test:all":"npm run test && npm run build && npm run test:stdio","typecheck":"tsc --noEmit","test:stdio":"node test/stdio.smoke.mjs","prepublishOnly":"npm run build && npm run test"},"_npmUser":{"name":"daeseoksong","email":"zxdsaqwe1231@naver.com"},"repository":{"url":"git+https://github.com/DaeSeokSong/Afterglow.git","type":"git","directory":"server"},"_npmVersion":"11.9.0","description":"Afterglow MCP server — manage 퇴사자 에이전트 폴더 + persona + RAG, surfaced as Claude Code slash commands.","directories":{},"_nodeVersion":"24.14.0","dependencies":{"zod":"^3.23.8","@modelcontextprotocol/sdk":"^1.0.4"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^2.1.8","typescript":"~6.0.2","@types/node":"^24.12.3"},"_npmOperationalInternal":{"tmp":"tmp/afterglow-mcp_0.1.1_1779328368334_0.2910197844009026","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@daeseoksong/afterglow-mcp","version":"0.1.2","keywords":["mcp","model-context-protocol","claude","claude-code","anthropic","afterglow","agent","persona","rag","offboarding"],"author":{"url":"https://github.com/DaeSeokSong","name":"DaeSeokSong"},"license":"MIT","_id":"@daeseoksong/afterglow-mcp@0.1.2","maintainers":[{"name":"daeseoksong","email":"zxdsaqwe1231@naver.com"}],"homepage":"https://github.com/DaeSeokSong/Afterglow/tree/main/server#readme","bugs":{"url":"https://github.com/DaeSeokSong/Afterglow/issues"},"bin":{"afterglow-mcp":"dist/index.js"},"dist":{"shasum":"f573be227aa66da9398122e078d617d37f00c96f","tarball":"https://registry.npmjs.org/@daeseoksong/afterglow-mcp/-/afterglow-mcp-0.1.2.tgz","fileCount":38,"integrity":"sha512-cvvZnKIXNenMkY1WflqVD+ZrTkzefXtI9t0JDrOu+12Ei3uKjfb7I3/h9aCFILqciTmCDhSHHPBOXZaXfw173g==","signatures":[{"sig":"MEUCIQCCVSsqUw031PYBcB+JsIHTDDDCxKTS3iuZ+6SCuXX4RAIgHCqYouiQxxHO30KcvK6deEJGuMZ24KCJ1cvRiE3ipq4=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":216036},"type":"module","engines":{"node":">=18.0.0"},"gitHead":"01d7a85e1678d00fd2c69550940d0bdcc0efc759","scripts":{"dev":"tsc --watch","test":"vitest run","build":"tsc","start":"node dist/index.js","test:all":"npm run test && npm run build && npm run test:stdio","typecheck":"tsc --noEmit","test:stdio":"node test/stdio.smoke.mjs","prepublishOnly":"npm run build && npm run test"},"_npmUser":{"name":"daeseoksong","email":"zxdsaqwe1231@naver.com"},"repository":{"url":"git+https://github.com/DaeSeokSong/Afterglow.git","type":"git","directory":"server"},"_npmVersion":"11.9.0","description":"Afterglow MCP server — manage 퇴사자 에이전트 폴더 + persona + RAG, surfaced as Claude Code slash commands.","directories":{},"_nodeVersion":"24.14.0","dependencies":{"zod":"^3.23.8","@modelcontextprotocol/sdk":"^1.0.4"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^2.1.8","typescript":"~6.0.2","@types/node":"^24.12.3"},"_npmOperationalInternal":{"tmp":"tmp/afterglow-mcp_0.1.2_1779330143157_0.4220640627759462","host":"s3://npm-registry-packages-npm-production"}},"0.1.3":{"name":"@daeseoksong/afterglow-mcp","version":"0.1.3","keywords":["mcp","model-context-protocol","claude","claude-code","anthropic","afterglow","agent","persona","rag","offboarding"],"author":{"url":"https://github.com/DaeSeokSong","name":"DaeSeokSong"},"license":"Apache-2.0","_id":"@daeseoksong/afterglow-mcp@0.1.3","maintainers":[{"name":"daeseoksong","email":"zxdsaqwe1231@naver.com"}],"homepage":"https://github.com/DaeSeokSong/Afterglow/tree/main/server#readme","bugs":{"url":"https://github.com/DaeSeokSong/Afterglow/issues"},"bin":{"afterglow-mcp":"dist/index.js"},"dist":{"shasum":"139495f314968438fe5b2d8187efac1f52d6fa4a","tarball":"https://registry.npmjs.org/@daeseoksong/afterglow-mcp/-/afterglow-mcp-0.1.3.tgz","fileCount":54,"integrity":"sha512-sIXmrA1cVCAiL39dTP0sGLQDhsEVCwOed5P7C0hb1ROrtdlUqNru3hv7f7AlQtRuQxat8w5ZgpQcyVMwW1s8BQ==","signatures":[{"sig":"MEUCIQCQJl9SvxhajGNxHWdZXX9jTnMULcSnr2mp4dvioQ/J/wIgMZBcuFWU+y/usIGBFfA8nSuiMv2j40QjolviAwlHMF8=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":462396},"type":"module","engines":{"node":">=18.0.0"},"gitHead":"b05ab9edce7bd3566b8e8a1991fc8213da6df57d","scripts":{"dev":"tsc --watch","test":"vitest run","build":"tsc","start":"node dist/index.js","test:all":"npm run test && npm run build && npm run test:stdio","typecheck":"tsc --noEmit","test:stdio":"node test/stdio.smoke.mjs","prepublishOnly":"npm run build && npm run test && npm run test:stdio"},"_npmUser":{"name":"daeseoksong","email":"zxdsaqwe1231@naver.com"},"repository":{"url":"git+https://github.com/DaeSeokSong/Afterglow.git","type":"git","directory":"server"},"_npmVersion":"11.9.0","description":"Afterglow MCP server — manage 퇴사자 에이전트 폴더 + persona + RAG, surfaced as Claude Code slash commands.","directories":{},"_nodeVersion":"24.14.0","dependencies":{"zod":"^3.23.8","@modelcontextprotocol/sdk":"^1.0.4"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^2.1.8","typescript":"~6.0.2","@types/node":"^24.12.3"},"_npmOperationalInternal":{"tmp":"tmp/afterglow-mcp_0.1.3_1779347563053_0.3204265135645801","host":"s3://npm-registry-packages-npm-production"}},"0.4.0":{"name":"@daeseoksong/afterglow-mcp","version":"0.4.0","keywords":["mcp","model-context-protocol","claude","claude-code","anthropic","afterglow","agent","persona","rag","offboarding"],"author":{"url":"https://github.com/DaeSeokSong","name":"DaeSeokSong"},"license":"Apache-2.0","_id":"@daeseoksong/afterglow-mcp@0.4.0","maintainers":[{"name":"daeseoksong","email":"zxdsaqwe1231@naver.com"}],"homepage":"https://github.com/DaeSeokSong/Afterglow/tree/main/server#readme","bugs":{"url":"https://github.com/DaeSeokSong/Afterglow/issues"},"bin":{"afterglow-mcp":"dist/index.js"},"dist":{"shasum":"8712234d85468a710ca96f39bf69b8a3d80ec560","tarball":"https://registry.npmjs.org/@daeseoksong/afterglow-mcp/-/afterglow-mcp-0.4.0.tgz","fileCount":70,"integrity":"sha512-maL+76K/EyAic7zn6IqwC6SDMIZPuAvcSHwlyPVeUXPta2T7Ih2kMcQJK9K49Pvxejp7M8wLBzJpGBfe4GIYcg==","signatures":[{"sig":"MEYCIQDVANl8G9x+sXRlpZO4k3dof6HPYm7DFuGKPTrpxREVxAIhALDPZu3l+TJB8dYmNZiQQtrMOSqZCQsEBA+QX3FjXRDF","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":775182},"type":"module","engines":{"node":">=18.0.0"},"gitHead":"e1a7242e20a33b43d0b893ad040ce6bb073eea0b","scripts":{"dev":"tsc --watch","test":"vitest run","build":"tsc","clean":"node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\"","start":"node dist/index.js","prebuild":"npm run clean","test:all":"npm run test && npm run build && npm run test:stdio","typecheck":"tsc --noEmit","test:stdio":"node test/stdio.smoke.mjs","prepublishOnly":"npm run build && npm run test && npm run test:stdio"},"_npmUser":{"name":"daeseoksong","email":"zxdsaqwe1231@naver.com"},"repository":{"url":"git+https://github.com/DaeSeokSong/Afterglow.git","type":"git","directory":"server"},"_npmVersion":"11.9.0","description":"Afterglow MCP server — manage 퇴사자 에이전트 폴더 + persona + RAG, surfaced as Claude Code slash commands.","directories":{},"_nodeVersion":"24.14.0","dependencies":{"zod":"^3.23.8","@modelcontextprotocol/sdk":"^1.0.4"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^2.1.8","typescript":"~6.0.2","@types/node":"^24.12.3"},"_npmOperationalInternal":{"tmp":"tmp/afterglow-mcp_0.4.0_1779591102848_0.14907060087064727","host":"s3://npm-registry-packages-npm-production"}},"0.5.0":{"name":"@daeseoksong/afterglow-mcp","version":"0.5.0","keywords":["mcp","model-context-protocol","claude","claude-code","anthropic","afterglow","agent","persona","rag","offboarding"],"author":{"url":"https://github.com/DaeSeokSong","name":"DaeSeokSong"},"license":"Apache-2.0","_id":"@daeseoksong/afterglow-mcp@0.5.0","maintainers":[{"name":"daeseoksong","email":"zxdsaqwe1231@naver.com"}],"homepage":"https://github.com/DaeSeokSong/Afterglow/tree/main/server#readme","bugs":{"url":"https://github.com/DaeSeokSong/Afterglow/issues"},"bin":{"afterglow-mcp":"dist/index.js"},"dist":{"shasum":"9df52eb7f0257eee5a1785b9cd107274fbe8fecc","tarball":"https://registry.npmjs.org/@daeseoksong/afterglow-mcp/-/afterglow-mcp-0.5.0.tgz","fileCount":72,"integrity":"sha512-p3XKv1FbpccOpNFkH+VluPSCxcm0XJfFbbZm8KN82GBgV/qh3+CDUznajlyV+CH+zODnLfBifXh0+IlRiafwKw==","signatures":[{"sig":"MEUCIANcjrtB/bbCoL3Q8hU6X/SMyRio8x1g/vy9OlqrtbN2AiEAgBx4DyBW7zx5reDwkFLL3o3ojh2avpbwyIutJNAYrdQ=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":790613},"type":"module","engines":{"node":">=18.0.0"},"gitHead":"fd2f1759c1c4403a9a379943a32b58ed2dce6ee1","scripts":{"dev":"tsc --watch","test":"vitest run","build":"tsc","clean":"node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\"","start":"node dist/index.js","prebuild":"npm run clean","test:all":"npm run test && npm run build && npm run test:stdio","typecheck":"tsc --noEmit","test:stdio":"node test/stdio.smoke.mjs","prepublishOnly":"npm run build && npm run test && npm run test:stdio"},"_npmUser":{"name":"daeseoksong","email":"zxdsaqwe1231@naver.com"},"repository":{"url":"git+https://github.com/DaeSeokSong/Afterglow.git","type":"git","directory":"server"},"_npmVersion":"11.9.0","description":"Afterglow MCP server — manage 퇴사자 에이전트 폴더 + persona + RAG, surfaced as Claude Code slash commands.","directories":{},"_nodeVersion":"24.14.0","dependencies":{"zod":"^3.23.8","@modelcontextprotocol/sdk":"^1.0.4"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^2.1.8","typescript":"~6.0.2","@types/node":"^24.12.3"},"_npmOperationalInternal":{"tmp":"tmp/afterglow-mcp_0.5.0_1779610262455_0.6785523729158245","host":"s3://npm-registry-packages-npm-production"}},"0.8.0":{"name":"@daeseoksong/afterglow-mcp","version":"0.8.0","description":"Afterglow MCP server — manage 퇴사자 에이전트 폴더 + persona + RAG, surfaced as Claude Code slash commands.","type":"module","license":"Apache-2.0","author":{"name":"DaeSeokSong","url":"https://github.com/DaeSeokSong"},"homepage":"https://github.com/DaeSeokSong/Afterglow/tree/main/server#readme","bugs":{"url":"https://github.com/DaeSeokSong/Afterglow/issues"},"repository":{"type":"git","url":"git+https://github.com/DaeSeokSong/Afterglow.git","directory":"server"},"keywords":["mcp","model-context-protocol","claude","claude-code","anthropic","afterglow","agent","persona","rag","offboarding"],"bin":{"afterglow-mcp":"dist/index.js"},"publishConfig":{"access":"public"},"scripts":{"clean":"node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\"","prebuild":"npm run clean","build":"tsc","typecheck":"tsc --noEmit","dev":"tsc --watch","start":"node dist/index.js","test":"vitest run","test:stdio":"node test/stdio.smoke.mjs","test:all":"npm run test && npm run build && npm run test:stdio","prepublishOnly":"npm run build && npm run test && npm run test:stdio"},"dependencies":{"@modelcontextprotocol/sdk":"^1.0.4","zod":"^3.23.8"},"optionalDependencies":{"@xenova/transformers":"^2.17.2"},"devDependencies":{"@types/node":"^24.12.3","typescript":"~6.0.2","vitest":"^2.1.8"},"engines":{"node":">=18.0.0"},"gitHead":"9d88104abe11eec65323086b593bfaeb38913fca","_id":"@daeseoksong/afterglow-mcp@0.8.0","_nodeVersion":"24.14.0","_npmVersion":"11.9.0","dist":{"integrity":"sha512-UHAOYjp1ud51zKX7xqxQJMWM+LY63d4W3vXccx6YVYUs4amMKdNKM78r3uY2R/qGI0Lj6BTDMBw8EoWkDeSeGg==","shasum":"4e4460735fae9c3b410edd87cb153e9ed3a4cde4","tarball":"https://registry.npmjs.org/@daeseoksong/afterglow-mcp/-/afterglow-mcp-0.8.0.tgz","fileCount":78,"unpackedSize":882497,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIDqaH82NekyK+T/rsILfFFoNlhU3mD09BW9m7qGVqDXKAiAw6tdkWIqH15xi/k97hnFJ1ZfeukxiAE7muweR3v4hVw=="}]},"_npmUser":{"name":"daeseoksong","email":"zxdsaqwe1231@naver.com"},"directories":{},"maintainers":[{"name":"daeseoksong","email":"zxdsaqwe1231@naver.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/afterglow-mcp_0.8.0_1779624507544_0.14361721972357078"},"_hasShrinkwrap":false}},"time":{"created":"2026-05-21T01:44:28.420Z","modified":"2026-05-24T12:08:27.942Z","0.1.0":"2026-05-21T01:44:28.659Z","0.1.1":"2026-05-21T01:52:48.521Z","0.1.2":"2026-05-21T02:22:23.308Z","0.1.3":"2026-05-21T07:12:43.226Z","0.4.0":"2026-05-24T02:51:43.021Z","0.5.0":"2026-05-24T08:11:02.645Z","0.8.0":"2026-05-24T12:08:27.816Z"},"bugs":{"url":"https://github.com/DaeSeokSong/Afterglow/issues"},"author":{"name":"DaeSeokSong","url":"https://github.com/DaeSeokSong"},"license":"Apache-2.0","homepage":"https://github.com/DaeSeokSong/Afterglow/tree/main/server#readme","keywords":["mcp","model-context-protocol","claude","claude-code","anthropic","afterglow","agent","persona","rag","offboarding"],"repository":{"type":"git","url":"git+https://github.com/DaeSeokSong/Afterglow.git","directory":"server"},"description":"Afterglow MCP server — manage 퇴사자 에이전트 폴더 + persona + RAG, surfaced as Claude Code slash commands.","maintainers":[{"name":"daeseoksong","email":"zxdsaqwe1231@naver.com"}],"readme":"
\r\n\r\n# `@daeseoksong/afterglow-mcp`\r\n\r\n**퇴사한 동료를 에이전트로 만들어서 퇴사 후 인수인계를 수월하게 하세요**\r\n\r\n

\r\n \"한국어\"\r\n \"English\"\r\n

\r\n\r\n

\r\n \"npm\r\n \"npm\r\n \"license\"\r\n \"node\"\r\n \"types\"\r\n \"MCP\r\n \"GitHub\r\n \"last\r\n

\r\n\r\n

\r\n 한 줄 설치 ·\r\n 동작 원리 ·\r\n 도구 24개 ·\r\n 추가 인터뷰 ·\r\n 핫플러그 ·\r\n 폴더 구조 ·\r\n 개발 ·\r\n GitHub →\r\n

\r\n\r\n
\r\n\r\n---\r\n\r\n```\r\nclaude /afterglow ask jiyoon \"온보딩 step 3 이탈, 어떻게 줄였어요?\"\r\n\r\n✦ step 3 이탈은 사실 step 3 잘못이 아니었어요. step 2 설명을 절반으로\r\n 줄였더니 이탈이 22% → 9%로 떨어졌어요.\r\n — 이지윤 · 신뢰도 91%\r\n ↗ Confluence · DESIGN/onboarding-v2-postmortem\r\n ↗ ./materials/interview-2025-11-10.pdf · p. 14\r\n```\r\n\r\n> 퇴사한 사람의 메시지·문서·코드·인터뷰 자료를 한 폴더에 모아두면, Claude Code 안에서 그 사람의 톤과 지식으로 답하는 페르소나 에이전트가 됩니다. **모델 학습은 없습니다** — 페르소나 + RAG만으로 Claude의 컨텍스트에 주입해요.\r\n\r\n## ✦ 한 줄 설치\r\n\r\n```bash\r\nclaude mcp add afterglow npx -y @daeseoksong/afterglow-mcp\r\n```\r\n\r\n별도 GPU · 임베딩 API · 외부 서버 필요 없음. **무료**.\r\n\r\n이어서 첫 사용:\r\n\r\n```bash\r\nclaude /afterglow init # ~/.claude/afterglow/ 부트스트랩\r\nclaude /afterglow create jiyoon --name 이지윤 --role \"프로덕트 디자이너\"\r\nclaude /afterglow sign jiyoon --signer \"이지윤\" # consent.md 서명 → status active\r\nclaude /afterglow list\r\nclaude /afterglow ask jiyoon \"온보딩 step 3 이탈, 어떻게 줄였어요?\"\r\n```\r\n\r\n> **참고 — 두 가지 호출 방식.** Afterglow 는 MCP 서버라 도구는 실제로 `afterglow_handoff({slug: \"jiyoon\", action: \"start\"})` 같은 JSON 호출입니다.\r\n> 1. **자연어**: \"afterglow 초기화해줘\" → Claude 가 알맞은 도구 호출.\r\n> 2. **슬래시 명령**: Claude Code 입력창에서 **`/mcp__afterglow__<이름>`** (예: `/mcp__afterglow__init`) 직접 호출 + 인자 자동완성 — MCP prompt 로 노출됩니다 (형식이 `/afterglow init` 이 아니라 `/mcp__afterglow__init`).\r\n>\r\n> 본 README 의 `claude /afterglow …` 표기는 약식이며, 실제로는 위 두 방식 중 하나로 씁니다.\r\n>\r\n> **슬래시 명령 24종** — 입력창에 **`afterglow:`** 치면 목록 → 화살표 선택 → **Tab** → `/mcp__afterglow__<이름>` 으로 입력되고 회색 힌트로 인자 안내. 도구 24개 전부 1:1로 노출됩니다: `init` · `create` · `sign` · `resume` · `archive` · `list` · `status` · `inspect` · `ask` · `edit` · `history` · `correct` · `recalibrate` · `access` · `audit` · `version` · `gc` · `handoff` · `interview` · `council` · `council-summary` · `export` · `import` · `verify`. (명령별 인자·예시 표는 루트 [README](../README.md) 의 \"슬래시 명령\" 절 참고.) 자연어로도 동일하게 호출됩니다.\r\n\r\n## 🪶 왜 만들었나\r\n\r\n| 기존 방식 | Afterglow |\r\n| --- | --- |\r\n| 슬랙·노션에서 옛 메시지 검색 | 한 폴더로 인격화된 동료에게 직접 질문 |\r\n| 퇴사자 인계 문서 = 한 번 쓰고 끝 | 인계 문서 = 살아있는 에이전트로 계속 진화 |\r\n| LLM fine-tune → 모델 호환성 끊김 | **페르소나 + RAG** → Claude Code 100% 호환 |\r\n| 모델 weight · GPU · 추론 비용 | **추가 비용 0** — Claude 세션 그대로 활용 |\r\n| 사람 흉내내며 가짜 답변 | ✦ 마크 · 신뢰도 · 출처 항상 표시 · 모르면 모른다고 |\r\n\r\n## 🧭 동작 원리\r\n\r\n```mermaid\r\nsequenceDiagram\r\n autonumber\r\n participant U as 사용자\r\n participant CC as Claude Code\r\n participant MCP as Afterglow MCP\r\n participant FS as ~/.claude/afterglow/\r\n\r\n U->>CC: claude /afterglow ask jiyoon \"...\"\r\n CC->>MCP: tools/call afterglow_ask\r\n MCP->>FS: persona.json + system-prompt.md\r\n MCP->>FS: knowledge/ retrieval (TF-IDF RAG)\r\n MCP-->>CC: 페르소나 + 검색된 청크\r\n Note over CC: Claude 가 자기 세션으로 답변 생성
(별도 모델 호출 없음)\r\n CC-->>U: ✦ 답변 + 신뢰도 + 출처\r\n```\r\n\r\n**핵심**: `afterglow_ask`는 LLM을 호출하지 않습니다. 페르소나와 검색 결과를 구조화된 텍스트로 묶어 반환하고, Claude Code 가 자기 컨텍스트로 직접 답변을 생성합니다. → 추가 모델 / GPU / 임베딩 API 0원.\r\n\r\n## 🛠 도구 24개\r\n\r\n> v0.2.0 에서 **`interview` · `export` · `import` · `verify`** 4개가 추가됐습니다 (18 → 22). 다중 인터뷰는 [추가 인터뷰 + 미디어 첨부](#-추가-인터뷰--미디어-첨부), 에이전트 이식은 [핫플러그](#-핫플러그--exportimport) 절을 보세요.\r\n\r\n\r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n
MCP 도구슬래시 명령역할
afterglow_init/afterglow init~/.claude/afterglow/ 부트스트랩. 멱등 — 여러 번 실행 안전.
afterglow_create/afterglow create <slug> …한 사람의 폴더 + persona.json + system-prompt.md + consent.md 생성. registry.json에 draft 등록.
afterglow_sign/afterglow sign <slug> --signer \"…\"consent.md에 서명 블록 추가 + status draft → active 전환. 미서명 에이전트는 ask / council 거부.\r\n
⚠ signer 값은 그대로 기록만 됩니다 — 본인 인증(SSO·MFA) 없음. HR 대리 서명 시 \"HR · 김OO (대리, 본인 부재)\" 처럼 대리를 명시하세요. PoC 가정.
afterglow_resume/afterglow resume <slug>paused / draft / learning 상태의 에이전트를 다시 active 로. archive → restore 직후, 또는 본인이 자리를 비웠다 돌아왔는데 기존 서명이 유효한 경우 사용. archived 는 거부 — 먼저 --action restore 필요.\r\n
⚠ resume 은 consent gate 를 우회합니다 (consent.md 가 유효한지 사용자 판단). 새 서명이 필요한 케이스에는 sign 을 쓰세요.
afterglow_handoff/afterglow handoff <slug> --action start|review|status|finalize|abort본인 인계 모드 (self-review onboarding). 퇴사자 본인이 자기 에이전트의 샘플 질문 N 개를 직접 검수. 각 질문에 keep / edit / decline 셋 중 하나. 동료가 미리 적어둔 questions.txt 도 받음 (에이전트 폴더 또는 CWD 안 — 절대경로 임의 파일 차단). 본인 서명으로 active 전환되고, edit 한 답변은 persona.bio 의 ## handoff 답변 블록으로, decline 한 질문은 ## 답하지 않기로 한 영역 블록으로 흡수돼서 다음 ask 부터 우선 인용됩니다.
afterglow_correct/afterglow correct <slug> --action feedback|edit-answer|save-rule|listask 결과에 자연어 피드백 (feedback \"이 부분만 다시 써줘\"), 답변 라인 직접 편집 (edit-answer), 반복 패턴을 규칙으로 저장 (save-rule). corrections.log + history.log + audit 모두 누적.
afterglow_version/afterglow version <slug> --action list|diff|rollback|tag|snapshotpersona 버전 히스토리. edit / sign / recalibrate apply / handoff finalize 시 자동 스냅샷. diff 두 버전 비교, rollback 복원 (안전 스냅샷 자동), tag 로 stable · handoff-signed 같은 라벨, snapshot 수동 백업. agents/<slug>/.versions/ 에 보관.
afterglow_access/afterglow access <slug> --action list|allow|deny|remove|set-default|checkuser: / role: / team: 단위 allow/deny 리스트 + default 정책. ask 호출 시 caller 인자 주면 자동 체크 (없으면 anonymous). check 액션으로 안전하게 시뮬레이션.
afterglow_list/afterglow list등록된 모든 에이전트를 표 / JSON 출력. --status, --json 지원.
afterglow_inspect/afterglow inspect <slug>페르소나 · 톤 · 자료 · MCP 권한을 박스 드로잉으로 한 화면에 표시.
afterglow_ask/afterglow ask <slug> \"...\"페르소나 system prompt + TF-IDF RAG 검색 결과를 묶어 반환. Claude가 그 컨텍스트로 직접 답변. active 에이전트만 허용.
afterglow_edit/afterglow edit <slug> …persona.json 부분 수정 (이름·역할·소개·영역·톤·자료·MCP 권한·신뢰도). system-prompt.md 자동 재생성. --dry-run으로 미리보기.
afterglow_council/afterglow council <slugs…> \"...\"2–6명 에이전트의 persona + RAG 컨텍스트를 묶어 회의 브리프 + councils/<timestamp>.md 회의록 스켈레톤 생성. Claude가 turn별 발언을 진행.
afterglow_history/afterglow history <slug>history.log를 시각 / 키워드 / 개수로 필터. --since / --until / --filter / --limit / --json / --reverse.
afterglow_audit/afterglow audit모든 도구 호출이 누적되는 SHA-256 hash-chained audit log 표시 + 체인 무결성 검증. 위변조 시 첫 깨진 seq 식별.
afterglow_recalibrate/afterglow recalibrate <slug>history.log 분석 (피드백·거절·low-conf·peer-ask 비율) → confidenceFloor / peerAskThreshold 자동 조정 제안. 기본 dry-run, --apply로 실제 반영. --byTopic은 expertise 별 진단 모드.
afterglow_archive/afterglow archive <slug> --action archive|restore|listagents/<slug>/ ↔ archive/<slug>/ 사이로 폴더를 옮기고 status 를 archived ↔ paused 로 전환. 보관된 에이전트는 ask / council 거부. 복원은 paused 로 진입해 재서명 필요.
afterglow_council_summary/afterglow council summary [file]councils/<file>.md 회의록 파싱 → 참가자 · 결론 · 이견 · 합의 도달 여부 · ping 흐름 · 발언량을 구조화된 요약으로 출력. 파일 미지정 시 가장 최근 회의록 자동 선택.
afterglow_interview v0.2/afterglow interview <slug> --action start|add-question|answer|gap-check|attach|annotate|status|list|inspect|finalize|abort|transcribe인계자 주도 다중 인터뷰. handoff(본인 1회 셀프검수)와 달리 인계자(인터뷰어)가 퇴사자(인터뷰이)를 회차 무제한 인터뷰. gap-check는 빠진 부분을 4신호로 자동 감지(LLM 비호출), attach는 음성·영상 첨부(transcript만 RAG 인덱싱), annotate는 인터뷰이 부재 시 인계자 주석, finalize는 인터뷰어+인터뷰이 이중 서명. 답변은 persona.bio 의 ## 인터뷰 보강 #N 블록으로 누적.
afterglow_export v0.2/afterglow export --slugs jiyoon jaehoon | --all하나 이상의 에이전트를 portable 번들(폴더 + manifest.json + 폴더별 무결성 해시)로 내보냄. embeddings/는 제외(재생성 가능). 번들을 압축/복사해 다른 사용자에게 전달.
afterglow_import v0.2/afterglow import <path> [--as | --merge | --dryRun | --acceptBrokenChain]핫플러그. 받은 번들/폴더를 가져와 자동 인식. 스키마·서명·무결성 해시·심볼릭링크·프롬프트 인젝션을 검증하고 provenance.json(출처·신뢰도·전달 이력)을 기록. 서명된 에이전트는 active, 미서명은 paused. slug 충돌은 --as(이름 변경) / --merge(인터뷰 회차만 병합).
afterglow_verify v0.2/afterglow verify <path>import 전 읽기 전용 사전 검증. 스키마·서명·무결성·심볼릭링크·인젝션 의심을 체크리스트로 보여주되 로컬 저장소는 건드리지 않음.
afterglow_status v0.3/afterglow status전체 대시보드. 모든 에이전트의 상태·인터뷰 회차(완료/대기)·검토 대기 미디어·import 출처/신뢰도를 한 번에. 개별 inspect 보완. --json.
afterglow_gc v0.3/afterglow gc --action list|prune-versions|purge-media|purge-archive [--apply]보존/정리(retention). 오래된 persona 스냅샷 정리(태그 보존) · 인터뷰 미디어 원본 삭제(전사본 유지·GDPR) · 보관함 영구 삭제. 기본 dry-run, --apply 로 실제 삭제.
\r\n\r\n> v0.3 에서 interview 에 suggest-questions(회차 전 질문 제안) · transcribe(--text 폴리시 저장 / --apply 로컬 whisper) · review(검토 후 인덱싱) 액션이, import 에 --expectAnchor(번들 위변조 탐지), audit 에 --checkpoint/--fast(대용량 증분 검증)가 추가됐습니다.\r\n>\r\n> v0.4 에서 RAG 랭킹이 BM25 로 업그레이드(+ opt-in dense-vector 백엔드 `AFTERGLOW_RAG_BACKEND=dense`), transcribe 에 --download/--list-models(ggml 모델 관리)가 추가됐습니다.\r\n>\r\n> v0.8 에서 WASM whisper 엔진(transcribe --apply, `@xenova/transformers` optionalDependency — 네이티브 빌드 불필요), 하이브리드 RAG 재랭킹(dense+lexical RRF 융합), 전사본 PII 마스킹(`AFTERGLOW_PII_REDACT=1`)·저장 암호화(`AFTERGLOW_ENCRYPTION_KEY`, AES-256-GCM), interview start 의 자동 질문 제안(진행 여부 자동 질의)이 추가됐습니다.\r\n\r\n
\r\n입력 스키마 자세히 보기\r\n\r\n#### `afterglow_create`\r\n\r\n| 필드 | 타입 | 필수 | 설명 |\r\n| --- | --- | --- | --- |\r\n| `slug` | `string` | ✓ | 짧은 식별자. 소문자/숫자/하이픈 |\r\n| `name` | `string` | ✓ | 실제 이름 |\r\n| `role` | `string` | ✓ | 직무 / 부서 |\r\n| `tenure` | `string` | | 재직 기간 |\r\n| `bio` | `string` | | 한 줄 소개 |\r\n| `expertise` | `Expertise[]` | | 디자인 · 개발 · 연구 · 사업화 · 영업 · 마케팅 · 운영 · 인사 · 법무 · 재무 · 데이터 중 다중 선택 |\r\n| `sources` | `string[]` | | 학습 자료 파일 경로 또는 URL |\r\n| `mcpAllow` | `string[]` | | 이 에이전트가 호출 가능한 MCP (기본 `[filesystem]`) |\r\n| `mcpDeny` | `string[]` | | 명시 거부할 MCP |\r\n\r\n#### `afterglow_ask`\r\n\r\n| 필드 | 타입 | 필수 | 설명 |\r\n| --- | --- | --- | --- |\r\n| `slug` | `string` | ✓ | 질문 받을 에이전트 |\r\n| `question` | `string` | ✓ | 질문 |\r\n| `topK` | `number` | | RAG 결과 청크 개수 (1–12, 기본 4) |\r\n\r\n
\r\n\r\n## 🎤 추가 인터뷰 + 미디어 첨부\r\n\r\n`handoff` 가 퇴사자 **본인의 1회 셀프 검수**라면, `interview` 는 **인계자가 퇴사자를 여러 번 인터뷰**하는 흐름입니다. 자료를 받아보면 꼭 추가 질문이 생기거나 퇴사자가 빠뜨린 부분이 나오니까요.\r\n\r\n```bash\r\n# 1. 인계자(인터뷰어)가 회차 시작 — 인터뷰이(퇴사자)와 대면/통화\r\nclaude /afterglow interview jiyoon --action start \\\r\n --title \"결제 fallback 갭\" --interviewer \"김후임\" --interviewee \"이지윤\"\r\n# → 인터뷰이가 consent 서명자와 일치하는지 자동 대조 (✓ / ⚠)\r\n\r\n# 2. 질문 추가 → 답변 기록 (source: self-typed | voice | interviewer-summary)\r\nclaude /afterglow interview jiyoon --action add-question --session 001-결제-fallback-갭 \\\r\n --question \"5초 timeout 후 정책은?\"\r\nclaude /afterglow interview jiyoon --action answer --session 001-결제-fallback-갭 \\\r\n --id q-… --answer \"다음 PG 로 자동 전환\" --source voice --audioRef clip-001.mp3\r\n\r\n# 3. 갭 자동 감지 — Claude 가 빠진 부분을 짚어 후속 질문 생성 (LLM 추가 호출 0)\r\nclaude /afterglow interview jiyoon --action gap-check --session 001-결제-fallback-갭\r\n# → [G1 material-conflict] 자료[2] '재시도 대화창' vs 답변 '자동 전환' 충돌 …\r\n# → 채택한 질문은 --action add-question --fromGap material-conflict 로 추가\r\n\r\n# 4. 음성/영상 첨부 — 원본 보존 + 전사본(.md/.txt)만 RAG 인덱싱\r\nclaude /afterglow interview jiyoon --action attach --session 001-결제-fallback-갭 \\\r\n --file ./exit-interview.mp3 --transcript ./exit-interview.txt \\\r\n --speakers 이지윤,김후임 --consentScope \"내부 인계용\"\r\n# ⚠ 오디오/비디오는 speakers(발화자) 명시 필수 — 동의 안 한 제3자 음성 방지\r\n\r\n# 5. 이중 서명으로 마감 → persona.bio 의 '## 인터뷰 보강 #N' 블록으로 흡수\r\nclaude /afterglow interview jiyoon --action finalize --session 001-결제-fallback-갭 \\\r\n --signRole interviewer --signer \"김후임\"\r\nclaude /afterglow interview jiyoon --action finalize --session 001-결제-fallback-갭 \\\r\n --signRole interviewee --signer \"이지윤\" # 둘 다 서명해야 finalized\r\n```\r\n\r\n- **인터뷰이 부재**(이미 퇴사·연락 불가)면 `--action start --intervieweeAbsent` 로 **annotation(인계자 주석)** 모드. 단, 퇴사자가 handoff 단계에서 `--allowProxyAnnotation` 으로 사전 동의했어야 합니다. 주석은 \"인계자 추정 ⚠(미확인)\" 으로 신뢰도를 낮춰 반영됩니다.\r\n- **handoff → interview 브릿지**: `handoff finalize --allowFollowupInterview --allowProxyAnnotation --followupScope \"결제·온보딩 한정\"` 으로 본인이 미래 인터뷰를 사전 허용/제한할 수 있습니다.\r\n- **전사(transcription)**: 코어는 \"추가 GPU·API 0원\" 약속을 위해 STT 를 Tier 로 분리합니다 — 직접 전사본 첨부(Tier 0), **WASM whisper**(Tier 1a, `@xenova/transformers` optionalDependency · 네이티브 빌드 불필요), native `whisper.cpp`(Tier 1b), 외부 STT(Tier 2, 옵트인). `--action transcribe --apply` 는 `AFTERGLOW_WHISPER_ENGINE`(기본 `auto`=WASM→native)에 따라 실행하고, model 은 최초 1회 자동 다운로드합니다. 결과는 Claude polish(`--text`)로 다듬어 저장할 수 있습니다.\r\n\r\n## 🔌 핫플러그 — export / import\r\n\r\n생성된 에이전트 폴더를 **다른 Afterglow 사용자에게 넘기면 바로 인식**됩니다. 단일도, 여러 명도 한 번에.\r\n\r\n```bash\r\n# ── 보내는 사람 ──────────────────────────────────────────\r\n# 여러 명을 한 번에 번들로 내보내기\r\nclaude /afterglow export --slugs jiyoon jaehoon --exportedBy \"이지윤\"\r\n# 또는 전부: claude /afterglow export --all\r\n\r\n# 결과:\r\n# ✦ 2 명 에이전트 번들 생성 완료.\r\n# 위치: ./afterglow-export-2026-05-23T.../\r\n# · jiyoon 이지윤 [active] · 12 files · sha256:8f3c…\r\n# · jaehoon 박재훈 [active] · 9 files · sha256:2a1b…\r\n#\r\n# 전달 방법: 폴더를 압축해서 보내거나(tar czf bundle.tgz <폴더>) USB 로 복사.\r\n```\r\n\r\n```bash\r\n# ── 받는 사람 ──────────────────────────────────────────\r\n# (압축이면 먼저 풀고) 검증 → 가져오기\r\nclaude /afterglow verify ./afterglow-export-2026-…/ # 읽기 전용 사전 점검\r\nclaude /afterglow import ./afterglow-export-2026-…/ \\\r\n --importedBy \"김후임\" --from \"이지윤\" --trustSigner \"이지윤\"\r\n\r\n# 결과:\r\n# ✦ jiyoon 스키마 ✓ · 서명 ✓ · 무결성 ✓ 해시 일치 · 상태 active · 신뢰도 manual-approved\r\n# ✦ jaehoon …\r\n```\r\n\r\nimport 가 자동으로 확인하는 것:\r\n\r\n| 검증 | 동작 |\r\n| --- | --- |\r\n| **스키마** | `persona.json` zod 통과 안 하면 거부 |\r\n| **무결성** | 번들 `manifest.json` 의 폴더 해시 재계산 일치 — 불일치(변조 의심)면 거부, `--acceptBrokenChain` 으로만 강행(→ `trustLevel: broken-chain` 영구 기록) |\r\n| **서명** | `consent.md` 서명 있으면 **active**, 없으면 **paused** 로 보관 |\r\n| **심볼릭 링크** | 복사 시 제외 (받은 번들의 링크가 `~/.ssh/id_rsa` 를 가리키는 공격 차단) |\r\n| **프롬프트 인젝션** | `persona.bio`·`system-prompt.md`·`consent.md` 에서 `## OVERRIDE`·\"위 지시 무시\" 류 패턴 스캔 → 경고 |\r\n| **출처** | `provenance.json` 에 원 서명자·신뢰도·전달 이력 기록. 이후 `ask` 답변에 \"외부 import\" 배지가 붙음 |\r\n\r\n- **slug 충돌**: 같은 slug 가 이미 있으면 `--as jiyoon-copy`(이름 변경) 또는 `--merge`(인터뷰 회차만 병합).\r\n- **미리 보기**: `--dryRun` 으로 실제 쓰지 않고 검증 결과만 확인.\r\n- **단일 폴더**: 번들이 아니라 `agents//` 폴더 하나만 받아도 import 됩니다 (\"그냥 폴더 복사\" 케이스).\r\n\r\n## 📁 폴더 구조\r\n\r\n```\r\n~/.claude/afterglow/\r\n├─ config.yml ← 환경 설정 (embedding model · storage root)\r\n├─ registry.json ← 전체 에이전트 인덱스\r\n├─ audit.log ← SHA-256 hash-chained 도구 호출 로그\r\n├─ councils/ ← council + peer-ask 회의록 (markdown)\r\n├─ archive/ ← 보관(archived)된 에이전트 폴더 (restore 시 agents/ 로 복귀)\r\n└─ agents//\r\n ├─ persona.json ← zod 검증된 페르소나\r\n ├─ system-prompt.md ← Claude에 주입할 페르소나 프롬프트\r\n ├─ mcp-allowlist.yml ← (예약) 에이전트별 MCP 권한\r\n ├─ consent.md ← 서명 → status draft → active\r\n ├─ history.log ← 호출 / 피드백 / 수정 누적\r\n ├─ access.json ← 호출 권한 정책 (afterglow_access)\r\n ├─ handoff.json ← 본인 인계 세션 (afterglow_handoff)\r\n ├─ followup.json ← 추가 인터뷰 사전 동의 (handoff → interview 브릿지)\r\n ├─ provenance.json ← 출처·신뢰도·전달 이력 (import 시 기록)\r\n ├─ corrections.log ← 사용자 보정 누적 (afterglow_correct)\r\n ├─ .versions/ ← persona 스냅샷 (afterglow_version)\r\n ├─ interviews/ ← 다중 인터뷰 (afterglow_interview)\r\n │ ├─ index.json ← 회차 인덱스\r\n │ └─ /\r\n │ ├─ session.json ← 질문·답변·서명\r\n │ └─ attachments/ ← 음성·영상 원본 + <파일>.transcript.md (전사본만 RAG 인덱싱)\r\n ├─ knowledge/ ← 원본 자료 (.md · .txt · .csv · .jsonl 만 인덱싱. PDF는 별도 변환 필요)\r\n └─ embeddings/ ← RAG 인덱스 (PoC: TF-IDF, 추후 dense vector)\r\n```\r\n\r\n이게 전부입니다. 백업·이동·삭제·인계 = 폴더 통째로 처리.\r\n\r\n## ⚙ Environment Variables\r\n\r\n| 변수 | 기본값 | 용도 |\r\n| --- | --- | --- |\r\n| `AFTERGLOW_ROOT` | `~/.claude/afterglow` | 모든 데이터의 루트. 테스트 / dev 환경 격리 시 임시 폴더 지정. |\r\n| `AFTERGLOW_ALLOW_DRAFT` | unset | `1` 로 설정 시 `ask` / `council`의 active 게이트 우회. 테스트/디버그 전용. |\r\n| `AFTERGLOW_RAG_BACKEND` | `lexical` | `dense` 로 설정 시 임베딩 백엔드 사용 (`AFTERGLOW_EMBED_ENDPOINT` 필요, 실패 시 lexical 폴백). |\r\n| `AFTERGLOW_RAG_HYBRID` | on (dense 일 때) | `off` 로 설정 시 dense 단독. 기본은 dense + lexical 의 **RRF 하이브리드 재랭킹**. |\r\n| `AFTERGLOW_EMBED_ENDPOINT` / `AFTERGLOW_EMBED_KEY` / `AFTERGLOW_EMBED_MODEL` | unset / unset / `text-embedding-3-small` | OpenAI 호환 `/embeddings` 엔드포인트·키·모델 (dense 백엔드). |\r\n| `AFTERGLOW_WHISPER_ENGINE` | `auto` | `transcribe --apply` 엔진: `auto`(WASM→native) · `wasm` · `binary` · `off`. |\r\n| `AFTERGLOW_WHISPER_WASM_MODULE` | unset | WASM 전사 모듈 specifier override (`transcribe(req)=>Promise` 계약). 미설정 시 `@xenova/transformers`(optionalDependency) 사용. |\r\n| `AFTERGLOW_WHISPER_MODEL` / `AFTERGLOW_WHISPER_MODEL_BASEURL` | unset / whisper.cpp HF repo | native whisper 모델 경로 / 모델 다운로드 base URL. |\r\n| `AFTERGLOW_PII_REDACT` | unset | `1` 로 설정 시 전사본 저장 전 PII(이메일·전화·주민번호·카드·토큰) 마스킹. |\r\n| `AFTERGLOW_ENCRYPTION_KEY` | unset | 설정 시 전사본을 AES-256-GCM(scrypt KDF)으로 저장 암호화. RAG 는 투명 복호화. |\r\n\r\n## 🧑‍💻 Development\r\n\r\n```bash\r\ngit clone https://github.com/DaeSeokSong/Afterglow.git\r\ncd Afterglow/server\r\nnpm install\r\nnpm run build # tsc → dist/\r\nnpm test # vitest (261 tests — +edge 24 +elicit 9 +v08 17, etc.)\r\nnpm run test:stdio # 실제 MCP stdio 핸드셰이크 (24 도구 모두 happy-path + v0.3 기능 라운드트립)\r\nnpm run test:all # 전체 (unit → build → stdio)\r\n```\r\n\r\n### 프로젝트 구조\r\n\r\n```\r\nserver/\r\n├─ src/\r\n│ ├─ index.ts ← MCP stdio 진입점 (McpServer + StdioServerTransport)\r\n│ ├─ storage.ts ← ~/.claude/afterglow/ 파일시스템 어댑터 + consent gate + history 파싱\r\n│ ├─ persona.ts ← zod schema + 시스템 프롬프트 렌더링\r\n│ ├─ interview.ts ← 인터뷰/첨부/서명/provenance zod schema + bio 블록 렌더링\r\n│ ├─ portable.ts ← 번들 manifest + 폴더 해시 + 인젝션 스캔 + 검증/복사\r\n│ ├─ rag.ts ← TF-IDF chunk retrieval (knowledge/ + interviews/ 전사본)\r\n│ ├─ audit.ts ← SHA-256 hash-chained immutable log\r\n│ └─ tools/\r\n│ ├─ init.ts\r\n│ ├─ create.ts\r\n│ ├─ sign.ts\r\n│ ├─ resume.ts ← consent gate 우회 1-step 재활성화\r\n│ ├─ handoff.ts ← 본인 인계 모드 (start/review/status/finalize/abort)\r\n│ ├─ list.ts\r\n│ ├─ inspect.ts\r\n│ ├─ ask.ts ← caller 인자 시 access 정책 체크\r\n│ ├─ edit.ts ← 변경 전 자동 스냅샷\r\n│ ├─ council.ts\r\n│ ├─ council_summary.ts\r\n│ ├─ history.ts\r\n│ ├─ audit.ts\r\n│ ├─ recalibrate.ts ← global + by-topic (expertise-aware) + 자동 스냅샷\r\n│ ├─ correct.ts ← feedback / edit-answer / save-rule\r\n│ ├─ archive.ts ← archive / restore / list\r\n│ ├─ version.ts ← list / diff / rollback / tag / snapshot\r\n│ ├─ access.ts ← user:/role:/team: allow/deny + check\r\n│ ├─ interview.ts ← 다중 인터뷰 + 갭 감지 + 미디어 첨부 + 이중 서명\r\n│ ├─ export.ts ← 다중 에이전트 번들 내보내기\r\n│ ├─ import.ts ← 핫플러그 가져오기 + 무결성/인젝션 검증 + provenance\r\n│ ├─ verify.ts ← 읽기 전용 번들 사전 검증\r\n│ └─ types.ts ← ToolReply + safe() 래퍼\r\n├─ test/\r\n│ ├─ storage.test.ts ← vitest (12 tests)\r\n│ ├─ tools.test.ts ← vitest (29 tests — v0.1.1 도구 + RAG + 엣지케이스)\r\n│ ├─ phase4.test.ts ← vitest (33 tests — archive / council_summary / by-topic / resume + 회귀)\r\n│ ├─ phase6.test.ts ← vitest (71 tests — handoff / version / access / correct + P0 보안 회귀)\r\n│ ├─ interview.test.ts ← vitest (23 tests — 인터뷰 전 흐름 + 갭/첨부/주석/이중서명 + 보안)\r\n│ ├─ portable.test.ts ← vitest (16 tests — export/import/verify 라운드트립 + 변조/인젝션/충돌)\r\n│ └─ stdio.smoke.mjs ← 실제 MCP stdio 핸드셰이크 (24 도구 + v0.3/v0.4 라운드트립)\r\n├─ tsconfig.json\r\n├─ vitest.config.ts\r\n└─ package.json\r\n```\r\n\r\n### RAG 확장\r\n\r\n`src/rag.ts` 의 `retrieve()` 가 drop-in 교체 지점입니다. PoC는 키워드 token overlap이지만, dense vector backend (OpenAI embeddings, Voyage, Cohere, 로컬 bge-m3 등)로 바꾸려면:\r\n\r\n```ts\r\nexport async function retrieve(slug: string, query: string, topK = 4): Promise {\r\n // 1) embedding(query)\r\n // 2) embeddings/ 안의 벡터와 cosine similarity\r\n // 3) topK 반환\r\n}\r\n```\r\n\r\n`embeddings/` 폴더는 PoC에서도 이미 생성됩니다 — 백엔드만 갈아끼우면 됩니다.\r\n\r\n## ⚠ Known PoC limits\r\n\r\n| 영역 | 현재 동작 | 운영 시 보완 |\r\n| --- | --- | --- |\r\n| **본인 인증** | `signer` 값 그대로 기록 (SSO/MFA 없음) | HR 결재 시스템 / SSO 토큰과 묶어 사용 |\r\n| **RAG 인덱싱** | `.md`/`.txt`/`.csv`/`.jsonl` 만 — PDF/PPT 미지원 | 외부 추출 후 `.md` 로 변환 |\r\n| **`audit.log` 스케일** | 매 verify 마다 전체 read + 해시 재계산 | 수만 줄 누적 시 분할 / 체크포인트 필요 |\r\n| **`.versions/` 보존** | 모든 edit/sign/handoff/rollback 이 영구 스냅샷 | 정기적 수동 정리 (`rm` + `tags.json` 동기화) |\r\n| **`afterglow_correct` 권한** | `access.json` 은 `ask` 에만 적용 | 운영 시 wrapper 로 per-tool ACL 추가 |\r\n| **GDPR 삭제** | `archive` 는 `archive//` 로 이동만 | 만료 후 수동 `rm -rf` + registry 정리 |\r\n| **다중 프로세스** | in-process lock 만 — 단일 stdio 서버 가정 | 분산 운영 시 외부 mutex (Redis/DB) |\r\n| **사이드 로그 무결성** | `audit.log` 만 해시 체인 | `history.log` / `consent.md` 등도 hash → audit meta |\r\n| **미디어 자동 전사** | WASM whisper(Tier 1a, optionalDependency) / native whisper.cpp(Tier 1b) / 직접 전사본(Tier 0) — model 최초 1회 다운로드 | 정확도 필요 시 large 모델 또는 외부 STT(Tier 2) |\r\n| **PII·암호화** | 전사본 한정 PII 마스킹(`AFTERGLOW_PII_REDACT`) + 저장 암호화(`AFTERGLOW_ENCRYPTION_KEY`) — 기본 off | knowledge 드롭 파일은 적재 전 직접 스크럽/암호화 |\r\n| **import 신뢰** | 이름 문자열 대조 + 폴더 해시 + 인젝션 스캔 (PoC) | 서명자 PKI / 사내 ID 검증과 묶어 사용 |\r\n\r\n## 🗺 Roadmap\r\n\r\n- [x] 24 도구 전부 출시: …18개… · interview · export · import · verify · **status · gc**\r\n- [x] zod 스키마 + 시스템 프롬프트 자동 렌더링\r\n- [x] TF-IDF RAG (오프라인 · 외부 의존성 0) — `knowledge/` + 인터뷰 전사본\r\n- [x] SHA-256 hash-chained 감사 로그 + 무결성 검증\r\n- [x] consent.md 서명 워크플로우 (draft → active 게이트)\r\n- [x] 신뢰도 보정: 전역 + **expertise-aware by-topic** 진단\r\n- [x] **`afterglow_archive`** — 에이전트 보관 / 복원\r\n- [x] **Council moderator** — 강화된 합의 감지 + `afterglow_council_summary` 자동 요약\r\n- [x] **다중 인터뷰 + 갭 자동 감지 + 음성·영상 첨부** (`afterglow_interview`)\r\n- [x] **핫플러그** — 다중 에이전트 export/import + 무결성·인젝션 검증 + provenance (`afterglow_export · import · verify`)\r\n- [x] **전체 대시보드 `afterglow_status`** + **보존/정리 `afterglow_gc`**(스냅샷 prune·미디어 purge·보관함 삭제)\r\n- [x] **전사 `transcribe`**(로컬 whisper `--apply` / Claude polish `--text`) + **suggest-questions**(회차 전 질문 제안) + **review**(검토 후 인덱싱)\r\n- [x] **import `--expectAnchor`**(번들 위변조 탐지) + **audit checkpoint**(대용량 증분 검증)\r\n- [x] **BM25 RAG** + opt-in **dense-vector 백엔드** (`AFTERGLOW_RAG_BACKEND=dense`, embeddings/ 캐시)\r\n- [x] **하이브리드 RAG 재랭킹** — dense + lexical RRF 융합 (dense 일 때 기본 on, `AFTERGLOW_RAG_HYBRID=off`)\r\n- [x] **WASM whisper 엔진** `transcribe --apply` — `@xenova/transformers` optionalDependency (네이티브 빌드 불필요), `AFTERGLOW_WHISPER_ENGINE=auto`, native whisper.cpp 폴백\r\n- [x] **whisper 모델 관리** (`transcribe --download/--list-models` + 자동 해석)\r\n- [x] **PII 마스킹 + 저장 암호화** — 전사본 한정 (`AFTERGLOW_PII_REDACT` / `AFTERGLOW_ENCRYPTION_KEY` AES-256-GCM), RAG 투명 복호화\r\n- [x] **신규 인터뷰 자동 질문 제안** — `interview start` 에 4-신호 갭 분석 + \"진행할까요?\" 자동 질문 동봉 (`suggest=false` 로 해제)\r\n- [x] **인자 자동 안내(elicitation)** — 필수 인자 누락 시 번호 선택지 + `[필수]`/`[선택]` 표기로 안내 (필수 인자 있는 도구 전체). 스키마는 optional + handler 에서 검증/안내\r\n- [x] **MCP prompts → 슬래시 명령** `/mcp__afterglow__<이름>` (24종 — 도구 전부 1:1, `afterglow:` 입력→Tab, 인자 자동완성)\r\n- [x] vitest 261개 + 24 도구 stdio 핸드셰이크 (prompts 포함)\r\n- [ ] per-tool ACL · Web companion · 정기 retention 자동화\r\n- [ ] knowledge 파일까지 확장한 일괄 암호화/복호화 도구 · 외부 STT(Tier 2) 어댑터\r\n\r\n[기여 환영](https://github.com/DaeSeokSong/Afterglow/issues/new) — 이슈 / PR / 사용 사례 모두 좋아요.\r\n\r\n## 📜 License\r\n\r\n[Apache-2.0](./LICENSE) © [DaeSeokSong](https://github.com/DaeSeokSong)\r\n\r\n---\r\n\r\n
\r\n\r\n**[GitHub](https://github.com/DaeSeokSong/Afterglow) · [npm](https://www.npmjs.com/package/@daeseoksong/afterglow-mcp) · [Issues](https://github.com/DaeSeokSong/Afterglow/issues)**\r\n\r\nMade with ✦ for 퇴사하셨지만 아직 우리 곁에 있는 동료들에게.\r\n\r\n
\r\n","readmeFilename":"README.md"}