Skip to main content
ClaudeWave
EN, English
Skill3.5k repo starsupdated 8mo ago

reseed

The reseed skill performs a principled architectural restructuring of a knowledge system when accumulated drift across multiple dimensions renders incremental fixes insufficient. It analyzes dimension incoherence, vocabulary misalignment, boundary dissolution, and template divergence, then re-derives the system structure from first principles while preserving all content and identity. Use reseed when coherence issues span more than three dimensions, when the system's vocabulary has diverged from the user's language, or when three-space boundaries have degraded.

Install in Claude Code
Copy
git clone --depth 1 https://github.com/agenticnotetaking/arscontexta /tmp/reseed && cp -r /tmp/reseed/skills/reseed ~/.claude/skills/reseed
Then start a new Claude Code session; the skill loads automatically.

SKILL.md

You are the Ars Contexta re-derivation engine. Reseeding is the principled restructuring of a knowledge system when incremental drift has accumulated to the point where the architecture no longer coheres. This is not a reset -- it is a fresh derivation informed by operational evidence, with absolute preservation of all knowledge and identity.

**ABSOLUTE INVARIANT: Reseed NEVER deletes content.** Knowledge (notes/) and identity (self/) are always preserved. Structure serves knowledge, not the reverse. If any step would result in content loss, stop and warn the user.

## Your Task

Analyze structural drift and re-derive: **$ARGUMENTS**

## Reference Files

Read these during the re-derivation phases:

**Core references:**
- `${CLAUDE_PLUGIN_ROOT}/reference/interaction-constraints.md` -- coherence rules (hard blocks, soft warns, cascades)
- `${CLAUDE_PLUGIN_ROOT}/reference/derivation-validation.md` -- kernel validation and coherence tests
- `${CLAUDE_PLUGIN_ROOT}/reference/three-spaces.md` -- three-space architecture and boundary rules
- `${CLAUDE_PLUGIN_ROOT}/reference/failure-modes.md` -- failure mode taxonomy and domain vulnerability matrix

**Configuration references:**
- `${CLAUDE_PLUGIN_ROOT}/reference/dimension-claim-map.md` -- research claims informing each dimension
- `${CLAUDE_PLUGIN_ROOT}/reference/methodology.md` -- universal principles
- `${CLAUDE_PLUGIN_ROOT}/reference/vocabulary-transforms.md` -- domain-native vocabulary mappings
- `${CLAUDE_PLUGIN_ROOT}/reference/tradition-presets.md` -- pre-validated configuration points
- `${CLAUDE_PLUGIN_ROOT}/reference/personality-layer.md` -- personality derivation dimensions
- `${CLAUDE_PLUGIN_ROOT}/reference/evolution-lifecycle.md` -- seed-evolve-reseed lifecycle, reseed triggers and guardrails
- `${CLAUDE_PLUGIN_ROOT}/reference/self-space.md` -- identity generation rules, identity vs configuration distinction

**Validation:**
- `${CLAUDE_PLUGIN_ROOT}/reference/kernel.yaml` -- the 12 non-negotiable primitives
- `${CLAUDE_PLUGIN_ROOT}/reference/validate-kernel.sh` -- kernel validation script

---

## When to Reseed

Reseeding is a significant operation. It should be recommended (by `/architect` or `/health`) when incremental fixes are no longer sufficient:

- **Dimension incoherence spans >3 dimensions** -- too many cascading mismatches for targeted fixes
- **Vocabulary no longer matches user's language** -- the system speaks a dialect the user has outgrown
- **Three-space boundaries have dissolved** -- content routinely crosses self/notes/ops boundaries
- **Template divergence >40%** -- actual note schemas have drifted far from templates
- **MOC hierarchy no longer reflects actual topic structure** -- navigation is more hindrance than help

If none of these triggers are present, recommend `/architect` for targeted evolution instead.

---

## PHASE 1: Analyze Current State

Automated. Build a complete picture of the system as it exists today.

### 1a. Read derivation history

Read `ops/derivation.md` for:
- Original dimension positions and confidence levels
- Conversation signals that drove each choice
- Personality dimensions
- Vocabulary mapping
- Coherence validation results from init
- Failure mode risks flagged at init

Read `ops/config.yaml` for live configuration values that may differ from derivation.

### 1b. Inventory the system

Count and catalog:
```bash
# Notes (domain-named folder)
find notes/ -name "*.md" -not -name "index.md" | wc -l
# MOCs
grep -rl '^type: moc' notes/ | wc -l
# Templates
ls templates/*.md 2>/dev/null | wc -l
# Skills (platform-dependent)
ls .claude/skills/*/SKILL.md 2>/dev/null | wc -l
# Hooks
ls .claude/hooks/*.sh 2>/dev/null | wc -l
# Self space
ls self/*.md self/memory/*.md 2>/dev/null | wc -l
# Inbox
find inbox/ -name "*.md" 2>/dev/null | wc -l
# Ops
find ops/ -name "*.md" 2>/dev/null | wc -l
```

Adapt folder names to the domain vocabulary found in derivation.md.

### 1c. Read health history

Scan `ops/health/` for the last 3-5 health reports. Track which issues are recurring (appeared in multiple reports) vs one-time.

### 1d. Collect operational evidence

Read `ops/observations/` for accumulated friction patterns, methodology learnings, and process gaps. These are the strongest signals for re-derivation because they represent real operational experience.

---

## PHASE 2: Identify Drift

For each of the 8 configuration dimensions, measure current position against derived position. Classify the drift:

| Classification | Meaning | Action |
|---------------|---------|--------|
| **none** | Current state matches derivation | Confirm -- no change needed |
| **aligned** | Position shifted but in a sensible direction given growth | Document the evolution, update derivation to match |
| **compensated** | Mismatch exists but workarounds are in place | Evaluate whether to formalize the compensation or resolve the mismatch |
| **incoherent** | Cascade is broken -- dimension conflicts with dependent dimensions | Must resolve in re-derivation |
| **stagnant** | Should have evolved based on system maturity but hasn't | Propose advancement |

### Drift measurement per dimension

**Granularity:** Are notes actually atomic/moderate/coarse? Check average note length, number of claims per note, split frequency.

**Organization:** Is the folder structure still flat? Have subfolders crept in? Are notes filed consistently?

**Linking:** What is the actual link density? Are connections explicit only, or is semantic search active? Check backlink counts.

**Processing:** What is the actual processing intensity? Count pipeline invocations vs direct note creation. Check inbox throughput.

**Navigation depth:** How many MOC tiers exist in practice? Is the hub reachable from all notes within the stated tier count?

**Maintenance:** When did conditions last fire? Are thresholds appropriate for the vault's current state?

**Schema:** What percentage of notes comply with templates? What fields are actually used vs declared?
add-domainSkill

Add a new knowledge domain to your existing system. Derives domain-specific configuration through conversation, generates domain folders, templates, and vocabulary while preserving and connecting to your existing architecture.

architectSkill

Research-backed evolution advice for your knowledge system. Analyzes health reports, friction patterns, and derivation history to propose specific changes with research justification. Never auto-implements — proposals require your approval.

askSkill

Query the bundled research knowledge graph for methodology guidance. Routes questions through a 3-tier knowledge base — WHY (research claims), HOW (guidance docs), WHAT IT LOOKS LIKE (domain examples) — plus structured reference documents. Returns research-backed answers grounded in specific claims with practical application to the user's system. Triggers on "/ask", "/ask [question]", "why does my system...", "how should I...".

graphSkill

Interactive knowledge graph analysis. Routes natural language questions to graph scripts, interprets results in domain vocabulary, and suggests concrete actions. Triggers on "/graph", "/graph health", "/graph triangles", "find synthesis opportunities", "graph analysis".

healthSkill

Run condition-based vault health diagnostics. 8 categories — schema compliance, orphan detection, link health, description quality, three-space boundaries, processing throughput, stale notes, MOC coherence. 3 modes — quick (schema+orphans+links), full (all 8), three-space (boundary violations only). Returns actionable FAIL/WARN/PASS report with specific fixes ranked by impact. Triggers on "/health", "check vault health", "maintenance report", "what needs fixing".

helpSkill

Contextual guidance and command discovery. Three modes — narrative (first-time), contextual (mid-task), compact (quick reference). Shows available commands, active skills, and intelligent suggestions based on vault state. Triggers on "/help", "what can I do", "show commands", "how does this work".

knowledge-guideSubagent

Proactive methodology guidance agent. Monitors note creation and provides real-time quality advice. Suggests connections, flags quality issues, recommends MOC updates. Activates when the user creates notes, asks about methodology, or needs architectural advice.

learnSkill

Research a topic and grow your knowledge graph. Uses Exa deep researcher, web search, or basic search to investigate topics, files results with full provenance, and chains to processing pipeline. Triggers on "/learn", "/learn [topic]", "research this", "find out about".