diff --git a/.github/workflows/deploy-pages.yml b/.github/workflows/deploy-pages.yml new file mode 100644 index 0000000..df9adde --- /dev/null +++ b/.github/workflows/deploy-pages.yml @@ -0,0 +1,41 @@ +name: Deploy GitHub Pages + +on: + push: + branches: + - main + paths: + - docs/** + - .github/workflows/deploy-pages.yml + workflow_dispatch: + +permissions: + contents: read + pages: write + id-token: write + +concurrency: + group: github-pages + cancel-in-progress: true + +jobs: + deploy: + environment: + name: github-pages + url: ${{ steps.deployment.outputs.page_url }} + runs-on: ubuntu-latest + steps: + - name: Checkout + uses: actions/checkout@v4 + + - name: Configure GitHub Pages + uses: actions/configure-pages@v5 + + - name: Upload Pages artifact + uses: actions/upload-pages-artifact@v3 + with: + path: docs + + - name: Deploy GitHub Pages + id: deployment + uses: actions/deploy-pages@v4 diff --git a/docs/.nojekyll b/docs/.nojekyll new file mode 100644 index 0000000..8b13789 --- /dev/null +++ b/docs/.nojekyll @@ -0,0 +1 @@ + diff --git a/docs/index.html b/docs/index.html new file mode 100644 index 0000000..39351b4 --- /dev/null +++ b/docs/index.html @@ -0,0 +1,442 @@ + + + + + +Caveman | Lithic Token Compression + + + + + + + +
+
+
+ +
+
STATUS: OPTIMIZED
+
PHYSICAL_IMPACTS: 0
+
TOKENS_PURGED: ~75%
+
+ +
+
+ + + JuliusBrussee / caveman + +

Few tokens.
Do trick.

+

A semantic constraint engine for Claude Code & Codex. Forces agentic communication into minimal-token lithic structures. Retain 100% technical accuracy while destroying up to 87% of output latency.

+ +
+ ❯ + npx skills add JuliusBrussee/caveman + +
+
+
+ +
+
+
+
+ +
+ 01 // Compression Matrix +

The Lithic Payload Diff

+

Visualize the exact tokens purged by the Caveman protocol. Technical imperatives are retained; conversational padding is annihilated.

+ +
+
+ Payload: React Re-render Diagnosis + 69 Tokens → 19 Tokens +
+
+ "The reason your React component is re-rendering is likely because you're creating a New object reference on each render cycle. When you pass an inline object as a prop, React's shallow comparison sees it as a different object every time, which triggers a = new ref = re-render. I'd recommend using Wrap in useMemo to memoize the object." +
+
+ + +
+
+
+ +
+ 02 // Empirical Data +

Token Latency Reduction

+

Average reduction of 65% across standard software engineering tasks. Reasoning tokens remain unaffected; only the output payload is compressed.

+ +
+
+
Explain React re-render bug
+
+
+
159/1180 87%
+
+
+
+
Fix auth token expiry
+
+
+
121/704 83%
+
+
+
+
Debug PostgreSQL race condition
+
+
+
232/1200 81%
+
+
+
+
Explain git rebase vs merge
+
+
+
292/702 58%
+
+
+
+
Review PR for security
+
+
+
398/678 41%
+
+
+
+
+ +
+ 03 // Lexical Ruleset +

Execution Architecture

+ +
+
+
💀
+
Pleasantry Annihilation
+
Standard LLMs waste compute on sycophantic hedging: "I'd be happy to help," or "It might be worth considering." Caveman protocol identifies and destroys these patterns at the generation layer.
+
+
+
✍️
+
Code Preservation
+
Code blocks, Git commits, and PR descriptions bypass the lithic filter. Caveman writes normal code.
+
+
+
🧠
+
Nomenclature Integrity
+
Technical jargon is retained precisely. "Polymorphism" remains "polymorphism." Caveman not stupid. Caveman efficient.
+
+
+
🔬
+
Scientific Backing
+
Based on the March 2026 paper "Brevity Constraints Reverse Performance Hierarchies in Language Models". Forcing brevity improves accuracy by 26 percentage points on key benchmarks. Less word = more correct.
+
+
+
+ +
+ 04 // Interface +

Initialize Protocol

+ +
+
+
+
+
+
System ready. Establishing connection to Claude Code Env...
+
Installing plugins via marketplace...
+
claude plugin install caveman@caveman
+
Trigger the protocol:
+
/caveman
+
Me ready.
+ +
+ ❯ + +
+
+
+
+ + + + + + \ No newline at end of file