결론
Keystone의 공개 웹사이트는 keystone-portfolio 하나로 수렴합니다.
내부 운영 원천은 별도로 유지하고, 공개 사이트에는 공개 가능한 정제본만 게시합니다.
저장소 역할
| 저장소 | 공개 범위 | 책임 |
|---|---|---|
ai-rules | private | 에이전트 행동 규칙, 커맨드, 스킬, 문서화 정책의 원천 |
pkb-wiki | private | Memory Bank 이후 선별한 결정, 실패 학습, 운영 노하우 |
keystone-hub | private | 훅, settings, 로컬/회사/머신별 배포 자산 |
ai-rules-public | public | 배포 가능한 ai-rules 패키지, 공개 예제, OSS 문서 |
keystone-portfolio | public | 공개 가능한 운영 철학, 아키텍처, 사례, 포트폴리오 |
왜 하나의 공개 사이트인가
별도 ai-rules-astro 사이트를 유지하면 공개 문서 작성 위치가 둘로 갈라집니다.
Keystone Portfolio가 이미 Astro 기반 문서 사이트이므로, 공개 해설과 포트폴리오 콘텐츠는 이곳으로 모읍니다.
대신 내부 정책 원천은 공개 저장소로 옮기지 않습니다.
게시 흐름
flowchart TD
A["Private work<br/>ai-rules / pkb-wiki / keystone-hub"]
B["Curation<br/>remove secrets, local paths, client names, raw logs"]
C["Public package<br/>keystone-portfolio"]
D["OSS source<br/>ai-rules-public when reusable as a product"]
A --> B --> C
B --> D
공개 가능한 것
- 운영 철학과 의사결정 방식
- 추상화된 agent rules
- Memory Bank와 PKB의 역할 분리 원칙
- 실패를 규칙과 자동화로 승격하는 사례
- 공개 가능한 시스템 다이어그램
- OSS로 배포 가능한 템플릿과 예제
공개하지 않는 것
- 로컬 경로와 개인 머신 정보
- 토큰, 계정, webhook, 외부 통합 세부값
- 회사/고객명과 내부 프로젝트명
- raw session transcript
- 보안 우회 절차와 내부 스케줄러 상세
- 아직 검증되지 않은 내부 아이디어
운영 원칙
공개 사이트는 원천이 아니라 전시 계층입니다. 운영 정책은 먼저 내부 원천에서 확정하고, 공개할 가치가 있는 내용만 짧게 다시 씁니다.