mirror of
https://github.com/affaan-m/everything-claude-code.git
synced 2026-03-30 13:43:26 +08:00
5818e8adc7
* feat: add project-scoped instinct isolation * fix(continuous-learning-v2): harden instinct loading and promotion safety; sync v2.1 command docs * fix(ci): make copilot-setup-steps a valid GitHub Actions workflow * fix(hooks): stabilize docs warning inline JS regex parsing
115 lines
2.8 KiB
Markdown
115 lines
2.8 KiB
Markdown
---
|
|
name: instinct-import
|
|
description: Import instincts from file or URL into project/global scope
|
|
command: true
|
|
---
|
|
|
|
# Instinct Import Command
|
|
|
|
## Implementation
|
|
|
|
Run the instinct CLI using the plugin root path:
|
|
|
|
```bash
|
|
python3 "${CLAUDE_PLUGIN_ROOT}/skills/continuous-learning-v2/scripts/instinct-cli.py" import <file-or-url> [--dry-run] [--force] [--min-confidence 0.7] [--scope project|global]
|
|
```
|
|
|
|
Or if `CLAUDE_PLUGIN_ROOT` is not set (manual installation):
|
|
|
|
```bash
|
|
python3 ~/.claude/skills/continuous-learning-v2/scripts/instinct-cli.py import <file-or-url>
|
|
```
|
|
|
|
Import instincts from local file paths or HTTP(S) URLs.
|
|
|
|
## Usage
|
|
|
|
```
|
|
/instinct-import team-instincts.yaml
|
|
/instinct-import https://github.com/org/repo/instincts.yaml
|
|
/instinct-import team-instincts.yaml --dry-run
|
|
/instinct-import team-instincts.yaml --scope global --force
|
|
```
|
|
|
|
## What to Do
|
|
|
|
1. Fetch the instinct file (local path or URL)
|
|
2. Parse and validate the format
|
|
3. Check for duplicates with existing instincts
|
|
4. Merge or add new instincts
|
|
5. Save to inherited instincts directory:
|
|
- Project scope: `~/.claude/homunculus/projects/<project-id>/instincts/inherited/`
|
|
- Global scope: `~/.claude/homunculus/instincts/inherited/`
|
|
|
|
## Import Process
|
|
|
|
```
|
|
📥 Importing instincts from: team-instincts.yaml
|
|
================================================
|
|
|
|
Found 12 instincts to import.
|
|
|
|
Analyzing conflicts...
|
|
|
|
## New Instincts (8)
|
|
These will be added:
|
|
✓ use-zod-validation (confidence: 0.7)
|
|
✓ prefer-named-exports (confidence: 0.65)
|
|
✓ test-async-functions (confidence: 0.8)
|
|
...
|
|
|
|
## Duplicate Instincts (3)
|
|
Already have similar instincts:
|
|
⚠️ prefer-functional-style
|
|
Local: 0.8 confidence, 12 observations
|
|
Import: 0.7 confidence
|
|
→ Keep local (higher confidence)
|
|
|
|
⚠️ test-first-workflow
|
|
Local: 0.75 confidence
|
|
Import: 0.9 confidence
|
|
→ Update to import (higher confidence)
|
|
|
|
Import 8 new, update 1?
|
|
```
|
|
|
|
## Merge Behavior
|
|
|
|
When importing an instinct with an existing ID:
|
|
- Higher-confidence import becomes an update candidate
|
|
- Equal/lower-confidence import is skipped
|
|
- User confirms unless `--force` is used
|
|
|
|
## Source Tracking
|
|
|
|
Imported instincts are marked with:
|
|
```yaml
|
|
source: inherited
|
|
scope: project
|
|
imported_from: "team-instincts.yaml"
|
|
project_id: "a1b2c3d4e5f6"
|
|
project_name: "my-project"
|
|
```
|
|
|
|
## Flags
|
|
|
|
- `--dry-run`: Preview without importing
|
|
- `--force`: Skip confirmation prompt
|
|
- `--min-confidence <n>`: Only import instincts above threshold
|
|
- `--scope <project|global>`: Select target scope (default: `project`)
|
|
|
|
## Output
|
|
|
|
After import:
|
|
```
|
|
✅ Import complete!
|
|
|
|
Added: 8 instincts
|
|
Updated: 1 instinct
|
|
Skipped: 3 instincts (equal/higher confidence already exists)
|
|
|
|
New instincts saved to: ~/.claude/homunculus/instincts/inherited/
|
|
|
|
Run /instinct-status to see all instincts.
|
|
```
|