v2.0.0

WISCI 2.0.0 — structured store, deterministic staleness, closed-loop sessions

Breaking release. scratchpad/ is replaced by the structured .wisci/ store. Migration:

mkdir -p .wisci/context .wisci/handoff
git mv scratchpad/handoff*.md .wisci/handoff/ 2>/dev/null || true
git mv scratchpad/*.md .wisci/context/ 2>/dev/null || true
rmdir scratchpad 2>/dev/null || true

Highlights

• .wisci/ store — context/ (knowledge, merge-semantics), handoff/ (per-stream work state), script-generated handoff.md index, cached primer.md. Hidden from accidental file sweeps; context enters sessions only through /select, validated.
• Deterministic staleness engine (scripts/wisci.py, python3 stdlib) — commit-hash anchored (rebase-proof), detects uncommitted working-tree changes, classifies fresh/stale/broken in one call. Replaces the old model-executed prose procedure and fixes two correctness bugs.
• Per-stream handoffs — each work stream gets its own leaf file; parallel sessions structurally cannot clobber each other. Index derived from leaf frontmatter — can never drift.
• Cached codebase primer — bare /select loads instantly; regenerates only when referenced configs or directory structure change (structure-hash tracked).
• Proactive hooks (Claude Code) — session start announces store state; PreCompact preserves paths/decisions/next-steps; post-compaction sessions prompted to /compress.
• /isolate is now flow-aware — checks the store before re-researching, routes codebase vs web agents, auto-persists durable findings via /write.
• Eval harness — trigger evals (should/should-not fire, train/validation splits) + end-to-end task assertions against fixture repos + blind-judge version comparison. python3 evals/run.py --help.
• Modernized skills — spec-portable frontmatter (compatibility, string allowed-tools), relative links instead of ${CLAUDE_SKILL_DIR}, dynamic state injection, disable-model-invocation on /commit.

Requirements

git + python3 (stdlib only). Hooks and dynamic injection are Claude Code features; skills degrade gracefully on Gemini CLI / Codex CLI / Cursor.

Full diff: v1.3.0...v2.0.0

v1.3.0

What's Changed

Flatten plugin structure from marketplace to single plugin

• Removed the wisci-plugin/ wrapper directory and marketplace.json
• Skills now live at repo root skills/
• Plugin manifest at .claude-plugin/plugin.json
• Simplified installation to claude plugin add ph3on1x/wisci

Full Changelog: v1.2.1...v1.3.0

v1.2.1

What's New

• /commit push — New optional push argument for the /commit skill. When push is the first word in arguments, commits and pushes in one operation. Includes automatic upstream detection and never force-pushes.

Examples

• /commit push — auto-generate message, commit, and push
• /commit push feat: add auth — commit with message and push
• /commit feat: add auth — commit only (backward compatible)

WISCI v1.2.0

Cross-Platform Compatibility

WISCI skills now work across multiple AI coding agents via the Agent Skills open standard.

New

• Gemini CLI support — gemini-extension.json manifest enables gemini extensions install from the Extensions Gallery
• Codex CLI & Cursor support — scripts/setup-platforms.sh creates symlinks into .agents/skills/ and .gemini/skills/ for platform discovery
• Broadened doc discovery — /select bare mode now checks for AGENTS.md, GEMINI.md, and .cursor/rules/ alongside CLAUDE.md
• Expanded AI Context Paths — /commit now tracks Gemini CLI files (GEMINI.md, .gemini/**) and .cursor/rules/**

Platform Support

Platform	Installation
Claude Code (primary)	/plugin marketplace add ph3on1x/wisci then /plugin install wisci@wisci-framework
Gemini CLI	gemini extensions install <github-url>
Codex CLI	Clone repo, run ./scripts/setup-platforms.sh
Cursor	Auto-discovers .claude/skills/ — no setup needed with Claude Code plugin installed

Note: /isolate uses Claude Code's subagent spawning. On other platforms, research runs in a single agent — functional, but without parallel exploration.

Unchanged

All existing Claude Code functionality is fully preserved. ${CLAUDE_SKILL_DIR}, allowed-tools, $ARGUMENTS, and tool names in skill bodies are untouched.

WISCI v1.1.0

What's New

/commit — Context-Enriched Committer (Helper Command)

New helper command that enriches git commits with a Context: section tracking AI-layer file changes, turning git log into long-term queryable memory.

• Conventional commit format with automatic prefix detection
• Conditional Context: section logs changes to scratchpad files, rules, commands, and instructions
• Selective staging — never uses git add -A or stages sensitive files
• Auto-generates commit messages from diffs when no message provided

Other Changes

• Plugin description reframed as "four primary commands plus helpers"

WISCI v1.0.0

WISCI v1.0.0 — Initial Release

Context Engineering Framework for Claude Code. Four slash commands for proactive LLM context management.

Commands

• /write — Externalize context to persistent scratchpad files with section-level merge
• /select — Load context with automatic git-based staleness detection and stripping
• /isolate — Delegate research to 1-3 subagents with isolated context windows
• /compress — Create compressed handoff documents for session transitions

Installation

/plugin marketplace add ph3on1x/wisci
/plugin install wisci@wisci-marketplace

Key Features

• Git-based staleness detection via ## References manifests
• Automatic stripping of stale content (no passive warnings)
• Section-level merge preserving exact facts, file paths, and decisions
• Topic-based storage in scratchpad/
• Addresses all 4 context engineering failure modes: poisoning, distraction, confusion, clash