opencode-plugin-mimic 0.1.5 → 0.1.6

package/README.ko.md

@@ -11,22 +11,27 @@ Mimic은 작업 방식을 관찰하고, 세션 간 기억을 유지하며, 반
 
 ## 기능
 
-- **패턴 감지**: 반복되는 도구 사용, 파일 편집, git 커밋 메시지 감지
-- **세션 기억**: 관찰/마일스톤을 세션 간 보존
+- **패턴 감지**: 반복되는 도구 사용, 파일 편집, git 커밋 메시지 및 채팅 패턴 감지
+- **본능 학습(Instinct Learning)**: 프로젝트 히스토리로부터 행동 "본능"(휴리스틱)을 학습
+- **아이덴티티 진화(Identity Evolution)**: 사용자에 대해 더 많이 배울수록 플러그인이 자체적인 성격과 통계를 개발
+- **세션 기억**: 장기적인 컨텍스트와 함께 세션 간 관찰 및 마일스톤 보존
 - **여정 기록**: 프로젝트의 진화를 내러티브로 정리
-- **Git 히스토리 분석**: 커밋 메시지/변경 파일 분석
-- **스마트 제안**: 반복 행동에 대한 지름길 제안
-- **프로젝트별 상태**: 프로젝트마다 독립적인 패턴/상태 저장
+- **스킬 생성**: 프로젝트 컨텍스트를 기반으로 선언적 스킬(.agent/skills) 자동 생성
+- **Git & VCS 통합**: 브랜치, 커밋 메시지, 파일 변경 사항 분석
+- **스마트 제안**: 반복 행동에 대한 지름길 생성 또는 기능 진화 제안
+- **프로젝트별 상태**: 프로젝트마다 독립적인 패턴과 본능 저장
 - **설정 가능**: 학습/제안 활성화, 임계치 조정
 - **다국어**: 사용자 설정에 따라 영어/한국어 출력
 
 ## 동작 방식
 
-1. **추적**: 도구 호출/파일 편집/git 히스토리 추적
-2. **감지**: 패턴 유형별 분류 (tool/file/commit)
-3. **기억**: 관찰과 마일스톤을 여정에 기록
-4. **제안**: 임계치 도달 시 제안 표면화 및 도구/훅 진화 가능
-5. **지속**: 모든 상태를 `.opencode/mimic/`에 저장
+1. **추적**: 도구 호출, 파일 편집, git 히스토리, 그리고 사용자 프롬프트까지 추적
+2. **감지**: 패턴 유형별 분류 (tool, file, commit, prompt)
+3. **관찰**: 배경 관찰자(Background Observer)가 행동 패턴을 기록하고 분석
+4. **학습**: 반복되는 행동을 프로젝트별 규칙인 **본능(Instincts)**으로 정립
+5. **적용**: 새로운 세션 시작 시 본능을 자동으로 적용하여 컨텍스트 유지
+6. **진화**: 패턴이 임계치에 도달하면 전용 도구나 스킬로 진화 제안
+7. **아이덴티티**: 작업이 계속됨에 따라 Mimic의 프로젝트 아이덴티티가 성숙해지며 성격을 얻고 "각성"함
 
 ## 설치
 
@@ -72,31 +77,119 @@ mimic:configure({ minPatternCount: 5 })
 
 ## 사용법
 
+### 커스텀 도구
+
 Mimic은 다음 도구들을 제공합니다:
 
-- `mimic:init`
-- `mimic:status`
-- `mimic:journey`
-- `mimic:patterns`
-- `mimic:observe`
-- `mimic:milestone`
-- `mimic:stats`
-- `mimic:configure`
-- `mimic:surface`
-- `mimic:reset`
-- `mimic:grow`
-- `mimic:evolve`
-- `mimic:level`
-- `mimic:focus`
-- `mimic:mcp-search`
-- `mimic:mcp`
-- `mimic:capabilities`
-
-> 참고:
-> - `mimic:evolve` 수락 시 프로젝트에 파일이 생성됩니다 (`.opencode/plugins/`, `.opencode/agents/`) 또는 `opencode.json`이 업데이트됩니다.
-> - `mimic:mcp-search`는 mcpmarket.com 검색 링크와 인기 MCP 서버 목록을 제공합니다.
-> - `mimic:mcp`는 **프로젝트 루트**의 `opencode.json`에 MCP 설정을 추가합니다.
-> - `mimic:level`은 상태에 저장되어 개인화에 사용됩니다.
+#### `mimic:init`
+
+프로젝트를 위해 Mimic을 초기화하거나 깨웁니다. 세션 통계, 최근 관찰 사항, 그리고 잠재적인 연속성 힌트가 포함된 환영 메시지를 표시합니다.
+
+#### `mimic:status`
+
+세션 수, 패턴 통계, 최근 수정된 파일, 활성 제안 등을 포함한 현재 상태를 확인합니다.
+
+#### `mimic:journey`
+
+마일스톤, 최근 관찰 사항, git 활동을 포함하여 프로젝트 진화의 내러티브 이야기를 확인합니다.
+
+#### `mimic:patterns`
+
+유형 및 빈도별로 정리된 모든 감지된 패턴(도구, 파일, 커밋 등)을 확인합니다.
+
+#### `mimic:instincts`
+
+학습된 행동 본능을 확인합니다. 본능은 사용자의 작업 스타일로부터 Mimic이 배운 "프로젝트별 규칙"입니다.
+
+#### `mimic:apply`
+
+최근 도구, 수정된 파일 등을 기반으로 현재 컨텍스트에 어떤 본능이 적용되는지 수동으로 확인합니다.
+
+#### `mimic:identity`
+
+성격 유형, "각성" 날짜 및 학습 통계를 포함한 Mimic의 프로젝트 아이덴티티를 확인합니다.
+
+#### `mimic:sequences`
+
+자주 사용되는 도구 시퀀스를 확인하여 일반적인 워크플로 패턴을 파악합니다.
+
+#### `mimic:observations`
+
+현재 프로젝트의 하위 수준 관찰 로그(도구, 파일, 세션)를 확인합니다.
+
+#### `mimic:observe`
+
+수동으로 관찰 사항 추가:
+
+```
+mimic:observe({ observation: "보안 강화를 위해 인증 모듈 리팩터링 완료" })
+```
+
+#### `mimic:milestone`
+
+프로젝트 마일스톤 기록:
+
+```
+mimic:milestone({ milestone: "v1.0.0 릴리스" })
+```
+
+#### `mimic:stats`
+
+상세 통계 확인: 총 세션, 도구 호출, 패턴/마일스톤 수, 학습 상태 등.
+
+#### `mimic:configure`
+
+Mimic의 행동 조정:
+
+```
+mimic:configure({ learningEnabled: false })     # 학습 중지
+mimic:configure({ suggestionEnabled: false })   # 제안 중지
+mimic:configure({ minPatternCount: 5 })         # 최소 반복 횟수를 5회로 설정
+```
+
+#### `mimic:surface`
+
+패턴을 인지됨/표면화됨 상태로 표시합니다.
+
+#### `mimic:reset`
+
+현재 프로젝트의 모든 학습된 데이터를 삭제합니다.
+
+#### `mimic:grow`
+
+활동 로그를 기반으로 프로젝트의 방향성과 성장 기회를 분석합니다.
+
+#### `mimic:evolve`
+
+반복된 패턴을 기반으로 새로운 기능(Shortcuts, Hooks, Commands, Agents, MCP) 진화를 제안하고 생성합니다.
+
+#### `mimic:generate-skills`
+
+프로젝트 컨텍스트를 분석하고 향후 세션의 정확도를 높이기 위한 `.agent/skills`를 자동으로 생성합니다.
+
+#### `mimic:export` / `mimic:import`
+
+학습된 본능을 JSON 파일로 내보내거나 다른 프로젝트에서 가져옵니다.
+
+#### `mimic:session-context`
+
+세션 간 컨텍스트 요약 및 연속성 힌트를 확인합니다.
+
+#### `mimic:level`
+
+숙련도 수준(technical, semi-technical, non-technical, chaotic)을 설정하여 Mimic의 피드백을 개인화합니다.
+
+#### `mimic:focus`
+
+현재 프로젝트의 집중 분야 또는 기술 스택을 설정합니다.
+
+#### `mimic:mcp-search` / `mimic:mcp`
+
+MCP 서버를 검색하고 프로젝트 설정에 추가합니다.
+
+#### `mimic:capabilities`
+
+진화된 모든 기능 목록을 확인합니다.
 
 ## 패턴 임계치
 
@@ -111,14 +204,21 @@ Mimic은 다음 도구들을 제공합니다:
 
 ## 자동 동작
 
-- **세션 시작**: 세션 카운트 증가, 장기 이탈 감지
-- **도구 실행**: 도구 호출 패턴 추적
-- **파일 편집**: 파일 수정 빈도 추적
-- **세션 유휴**: 커밋/파일 패턴 분석 및 제안 출력
-- **세션 종료**: 집중 세션/대규모 리팩터링 기록
+- **세션 시작**: 세션 카운트 증가, 최근 세션 이후 시간 분석, 그리고 **학습된 본능을 자동으로 적용**하여 컨텍스트를 설정합니다.
+- **도구 실행**: 패턴 및 시퀀스 감지를 위해 모든 도구 호출을 추적합니다.
+- **파일 편집**: 파일 수정 빈도를 추적합니다.
+- **배경 관찰(Background Observation)**: 주기적으로 관찰자(Observer)를 실행하여 패턴을 행동 본능으로 정립합니다.
+- **자동 진화**: 특정 도메인에서 높은 신뢰도의 패턴이 나타나면 기능을 자동으로 진화시킵니다.
+- **스킬 생성**: 새로운 기능이 진화될 때 자동으로 새로운 스킬을 생성합니다.
+- **세션 유휴**: 패턴을 분석하고 토스트 메시지를 통해 제안을 표시합니다.
+- **세션 종료**: 세션 요약을 기록하고, 다음 세션을 위한 연속성 메모리를 생성하며, 주요 마일스톤을 기록합니다.
 
 > Git 기반 기능은 git 저장소가 필요합니다. 저장소가 없으면 관련 섹션이 비어 보일 수 있습니다.
 
+## 영감 (Inspiration)
+
+이 프로젝트는 [Homunculus](https://github.com/humanplane/homunculus)의 컨셉에서 깊은 영감을 받아 제작되었습니다.
+
 ## 라이선스
 
 MIT

package/README.md

@@ -11,22 +11,28 @@ Mimic watches how you work, remembers across sessions, and suggests actions base
 
 ## Features
 
-- **Pattern Detection**: Automatically detects repeated tool usage, file edits, and git commit messages
-- **Session Memory**: Remembers observations and milestones across sessions
+- **Pattern Detection**: Automatically detects repeated tool usage, file edits, git commit messages, and chat patterns
+- **Instinct Learning**: Learns behavioral "instincts" (rules of thumb) from your project history
+- **Identity Evolution**: The plugin develops its own personality and stats as it learns more about you
+- **Session Memory**: Remembers observations and milestones across sessions with long-term context
 - **Journey Tracking**: Narrative storytelling of your project's evolution
-- **Git History Analysis**: Analyzes commit messages and file modifications
-- **Smart Suggestions**: Offers to create shortcuts for repeated actions
-- **Per-Project State**: Each project gets its own learned patterns
+- **Skill Generation**: Automatically creates declarative skills based on project context
+- **Git & VCS Integration**: Analyzes branches, commit messages, and file modifications
+- **Smart Suggestions**: Offers to create shortcuts or evolve capabilities for repeated actions
+- **Per-Project State**: Each project gets its own learned patterns and instincts
 - **Configurable**: Enable/disable learning and suggestions, adjust thresholds
 - **Internationalization**: English or Korean UI based on user config
 
 ## How It Works
 
-1. **Track**: Mimic tracks tool calls, file edits, and analyzes git history
-2. **Detect**: Patterns are categorized by type (tool, file, commit)
-3. **Remember**: Observations and milestones are recorded for your project's journey
-4. **Suggest**: When patterns reach thresholds, Mimic surfaces suggestions and can evolve them into tools/hooks
-5. **Persist**: All state persists in `.opencode/mimic/`
+1. **Track**: Mimic tracks tool calls, file edits, git history, and even user prompts
+2. **Detect**: Patterns are categorized by type (tool, file, commit, prompt)
+3. **Observe**: Behavioral patterns are logged and analyzed by a background observer
+4. **Learn**: Recurring behaviors are distilled into **Instincts** - project-specific rules of thumb
+5. **Apply**: Instincts are automatically applied to new sessions to maintain continuity
+6. **Evolve**: When patterns reach thresholds, Mimic can evolve them into dedicated tools or skills
+7. **Identity**: As you work, Mimic's project identity matures, gaining personality and "awakening" over time
+
 
 ## Installation
 
@@ -78,33 +84,39 @@ Mimic adds the following tools to OpenCode:
 
 #### `mimic:init`
 
-Initialize or wake up Mimic for this project. Shows welcome message with session stats and recent observations.
+Initialize or wake up Mimic for this project. Shows welcome message with session stats, recent observations, and potential continuity hints.
 
 #### `mimic:status`
 
-Check current status including:
-
-- Session count and pattern stats
-- Recently modified files (from git)
-- Recent commits
-- Active suggestions
+Check current status including session count, pattern stats, recently modified files, and active suggestions.
 
 #### `mimic:journey`
 
-View the narrative story of your project's evolution:
-
-- Milestones achieved
-- Recent observations
-- Git activity timeline
+View the narrative story of your project's evolution, including milestones, recent observations, and git activity.
 
 #### `mimic:patterns`
 
-View all detected patterns organized by type:
+View all detected patterns (Tool, File, Commit, etc.) organized by type and frequency.
+
+#### `mimic:instincts`
+
+View learned behavioral instincts. Instincts are "rules of thumb" that Mimic has learned from your work style.
+
+#### `mimic:apply`
+
+Manually check which instincts apply to the current context (recent tools, modified files, etc.).
 
-- **Tool patterns**: Frequently used tools
-- **File patterns**: Frequently modified files
-- **Commit patterns**: Repeated commit messages
-- **Sequence patterns**: Reserved for future detection
+#### `mimic:identity`
+
+Check Mimic's project identity, including its personality trait, "awakened" date, and learning stats.
+
+#### `mimic:sequences`
+
+View frequently used tool sequences to understand your common cross-tool workflows.
+
+#### `mimic:observations`
+
+View low-level observation logs (tools, files, sessions) for the current project.
 
 #### `mimic:observe`
 
@@ -124,12 +136,7 @@ mimic:milestone({ milestone: "v1.0.0 released" })
 
 #### `mimic:stats`
 
-View detailed statistics:
-
-- Total sessions and tool calls
-- Pattern and milestone counts
-- Session records
-- Configuration status
+View detailed statistics: total sessions, tool calls, pattern/milestone counts, and learning status.
 
 #### `mimic:configure`
 
@@ -143,48 +150,43 @@ mimic:configure({ minPatternCount: 5 })         # Require 5 repetitions
 
 #### `mimic:surface`
 
-Mark a pattern as acknowledged:
-
-```
-mimic:surface({ patternId: "pattern-uuid" })
-```
+Mark a pattern as acknowledged/surfaced.
 
 #### `mimic:reset`
 
-Clear all learned data:
-
-```
-mimic:reset({ confirm: true })
-```
+Clear all learned data for the current project.
 
 #### `mimic:grow`
 
-Analyze project direction and growth opportunities.
+Analyze project direction and growth opportunities based on activity logs.
 
 #### `mimic:evolve`
 
-Suggest and create new capabilities based on detected patterns.
+Suggest and create new capabilities (Shortcuts, Hooks, Commands, Agents, MCP) based on repeated patterns.
+
+#### `mimic:generate-skills`
+
+Analyze project context and automatically generate `.agent/skills` to improve accuracy for future sessions.
 
-> When you accept a suggestion, Mimic writes files into your project:
-> - `shortcut` / `command` / `hook` / `skill`: `.opencode/plugins/<name>.js`
-> - `agent`: `.opencode/agents/<name>.md`
-> - `mcp`: updates `opencode.json`
+#### `mimic:export` / `mimic:import`
+
+Export your learned instincts to a JSON file or import them from another project.
+
+#### `mimic:session-context`
+
+View cross-session context summary and continuity hints.
 
 #### `mimic:level`
 
-Set your technical level (technical, semi-technical, non-technical, chaotic). This is stored in state and used for personalization.
+Set your technical level (technical, semi-technical, non-technical, chaotic) to personalize Mimic's feedback.
 
 #### `mimic:focus`
 
 Set current project focus or tech stack.
 
-#### `mimic:mcp-search`
-
-Returns a search link to mcpmarket.com and a list of popular MCP servers.
+#### `mimic:mcp-search` / `mimic:mcp`
 
-#### `mimic:mcp`
-
-Add an MCP server configuration to the **project-level** `opencode.json`.
+Search for MCP servers and add them to project configuration.
 
 #### `mimic:capabilities`
 
@@ -203,11 +205,14 @@ List all evolved capabilities.
 
 ## Automatic Behaviors
 
-- **Session Start**: Increments session count, detects long breaks
-- **Tool Execution**: Tracks every tool call for pattern detection
-- **File Edit**: Tracks file modification frequency
-- **Session Idle**: Analyzes commit/file patterns and surfaces suggestions
-- **Session End**: Records intensive sessions, major refactoring milestones
+- **Session Start**: Increments session count, analyzes time since last session, and **automatically applies learned instincts** to set the context.
+- **Tool Execution**: Tracks every tool call for pattern and sequence detection.
+- **File Edit**: Tracks file modification frequency.
+- **Background Observation**: Periodically runs an observer to distill patterns into behavioral instincts.
+- **Automatic Evolution**: Automatically evolves capabilities when high-confidence patterns emerge in specific domains.
+- **Skill Generation**: Automatically generates new skills when new capabilities are evolved.
+- **Session Idle**: Analyzes patterns and surfaces suggestions via toasts.
+- **Session End**: Records session summary, records continuity memory for next session, and logs major milestones.
 
 > Git-based insights require a git repository. If none is available, git sections will be empty.
 
@@ -219,6 +224,10 @@ pnpm run build
 pnpm run dev  # watch mode
 ```
 
+## Inspiration
+
+Heavily inspired by the concepts of [Homunculus](https://github.com/humanplane/homunculus).
+
 ## License
 
 MIT