Skip to content

v1.0.0 — first public release

Choose a tag to compare

View all tags
@googlarz googlarz released this 28 Apr 19:52
· 12 commits to main since this release
v1.0.0
98d83c3

First public release of deep-context — a Claude Code skill that turns a folder into a verified, comprehensive context pack with citations, contradiction detection, self-test calibration, and a one-page actionable digest.

What's in v1.0

Workflow modes

  • build — full scan with verification ceremony
  • build with anchors — anchor-question driven, verifies each is HIGH-confidence answerable
  • ask — query the cached pack with dual citations (note + source)
  • diff — incremental rebuild on changed files; auto-invalidates dependent notes when a referenced file changes
  • link — cross-link two existing packs; surfaces shared entities + cross-pack conflicts

Quality gates (coverage: 100 requires all of these)

  • Mandatory source citations on every claim — format per file type (line/page/cell)
  • Spot-check audit ≥ 95% pass rate
  • Independent red-team re-read ≥ 90% pass rate (subagent for ≥10 files; inline for smaller corpora, flagged)
  • Self-test calibration ≥ 90% empirical accuracy
  • Anchor questions all answerable from notes alone
  • For PDFs: pdfinfo page-count probe + explicit page chunking + end-of-document signature check + pages_read == pages_total
  • Citation-format violations bar coverage: 100

Outputs (.context/)

  • INDEX.md — structural map + verification report
  • DIGEST.md — one-page TL;DR with aggregated numbers, timeline, decision points, risks, next steps
  • Per-file notes with two-pass extraction (extract → self-verify)
  • CONFLICTS.md, GLOSSARY.md, RED_TEAM.md, SELF_TEST.md
  • manifest.json (SHA-256 hashes + run metadata) + index.json (machine-readable summary)

Domain templates (additive, optional via --domain=...)

  • legal, code, sales, research, finance
  • medical — defaults to redacting PHI/PII; user is asked once with redact-by-default; DIGEST/JSON sidecars always redact regardless of choice

Safety

  • Hard cap: 200 files per pack
  • Never writes outside .context/
  • Never modifies source files
  • PHI/PII never leaks into shareable artifacts (DIGEST, GLOSSARY, JSON) without explicit per-run override

Provenance

Built incrementally through a long-form session, refined through one real run on a 7-PDF German legal corpus. The first run surfaced four spec bugs that v0 missed (PDF skip rule, citation format, red-team threshold, anchor prompt) — all fixed in this release.

A subsequent Codex adversarial review caught four more (PHI leak in medical mode, stale dependent notes in diff mode, wrong subagent skill path, PDF citation gate mismatch) — all also fixed before this release.

Install

git clone https://github.com/googlarz/deep-context.git ~/.claude/skills/deep-context

Then in any Claude Code session: pass a folder path with phrasing like "scan this folder" or "build context for <path>".

See README for full usage.

Limitations

  • ≤200 files per pack (beyond that, use a retrieval-based approach)
  • PDF support requires pdfinfo (poppler-utils) — brew install poppler on macOS
  • Quality depends on the model running the skill

What's next

The spec is at the point of diminishing returns from desk design. Next improvements should come from running on different corpus types (code, transcripts, research notes), not more spec edits. PRs welcome.

Assets 2
Loading