docs: overhaul design to 'Information Architect' style

- Redesign tables (no stripes, transparent headers)

- Fix mermaid diagram rendering

- Fix navigation styling and structure

- Switch GH Pages workflow to mdbook

Author: skew202

.agent/workflows/convert-to-antislop.md

@@ -2,7 +2,7 @@
 description: Convert any agent instruction files (CLAUDE.md, cursor rules, AGENTS.md, codex.toml, etc.) to antislop profiles
 ---
 
-# Convert Agent Instructions to Antislop Profiles
+# Convert Agent Instructions to AntiSlop Profiles
 
 This skill teaches you how to find and convert AI coding agent instruction files into antislop detection profiles.
 
@@ -62,7 +62,7 @@ ls -la .cursor/ .claude/ .agent/ .gemini/ .openai/ 2>/dev/null
 
 Look for these keywords in the instruction files:
 
-| Keyword | Meaning | Antislop Severity |
+| Keyword | Meaning | AntiSlop Severity |
 |---------|---------|-------------------|
 | **MUST** | Required | high |
 | **NEVER** | Forbidden | critical |

.agent/workflows/hygiene-check.md

@@ -46,11 +46,11 @@ Check for:
 | **husky** | `.husky/` |
 | **lefthook** | `lefthook.yml` |
 
-## Antislop's Unique Value (MECE)
+## AntiSlop's Unique Value (MECE)
 
 Report what antislop catches that these tools DON'T:
 
-| Category | What Antislop Catches | Standard Tools Miss |
+| Category | What AntiSlop Catches | Standard Tools Miss |
 |----------|----------------------|---------------------|
 | **Stubs** | `todo!()`, `pass`, `NotImplementedError` | Some catch syntax, not intent |
 | **Deferrals** | "for now", "temporary", "quick hack" | Never caught |
@@ -72,7 +72,7 @@ After surveying, generate a report:
 - [ ] CI: <platform>
 - [ ] Pre-commit: <name>
 
-## Antislop Unique Value
+## AntiSlop Unique Value
 Based on your setup, antislop will catch:
 - ✅ Stub implementations (`todo!()`, `pass`)
 - ✅ Deferral language ("for now", "temporary")

.antislop/profiles/antislop-standard.toml

@@ -1,4 +1,4 @@
-# Antislop Standard
+# AntiSlop Standard
 #
 # Recommended baseline configuration for agentic AI engineers.
 # Extends Core with common deferral, hedging, and stub patterns.

.antislop/profiles/antislop-strict.toml

@@ -1,4 +1,4 @@
-# Antislop Strict
+# AntiSlop Strict
 #
 # Maximum coverage - all patterns enabled.
 # Use when you want to catch EVERYTHING.

.github/workflows/pages.yml

@@ -1,12 +1,13 @@
-name: Pages
+name: Deploy mdBook to GitHub Pages
 
 on:
   push:
-    branches: [main]
+    branches:
+      - main
   workflow_dispatch:
 
 permissions:
-  contents: write
+  contents: read
   pages: write
   id-token: write
 
@@ -16,32 +17,28 @@ concurrency:
 
 jobs:
   deploy:
-    runs-on: ubuntu-latest
     environment:
       name: github-pages
       url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
     steps:
-      - name: Checkout
-        uses: actions/checkout@v6
+      - uses: actions/checkout@v4
 
-      - name: Install Rust
-        uses: dtolnay/rust-toolchain@stable
-
-      - name: Build documentation
-        run: cargo doc --all-features --no-deps
-        env:
-          RUSTDOCFLAGS: -Dwarnings
+      - name: Install mdBook
+        uses: peaceiris/actions-mdbook@v2
+        with:
+          mdbook-version: "latest"
 
-      - name: Create index redirect
-        run: echo "<meta http-equiv=refresh content=0;url=antislop/index.html>" > target/doc/index.html
+      - name: Build Book
+        run: mdbook build
 
       - name: Setup Pages
         uses: actions/configure-pages@v5
 
       - name: Upload artifact
-        uses: actions/upload-pages-artifact@v4
+        uses: actions/upload-pages-artifact@v3
         with:
-          path: target/doc
+          path: "./book"
 
       - name: Deploy to GitHub Pages
         id: deployment

CONTRIBUTING.md

@@ -1,6 +1,6 @@
-# Contributing to Antislop
+# Contributing to AntiSlop
 
-Thank you for your interest in contributing to Antislop!
+Thank you for your interest in contributing to AntiSlop!
 
 ## Development Setup
 

Cargo.toml

@@ -6,7 +6,7 @@ resolver = "2"
 name = "antislop"
 version = "0.3.0"
 description = "A blazing-fast, multi-language linter for detecting AI-generated code slop"
-authors = ["Antislop Contributors"]
+authors = ["AntiSlop Contributors"]
 license = "MIT OR Apache-2.0"
 repository = "https://github.com/skew202/antislop"
 homepage = "https://github.com/skew202/antislop"

Dockerfile

@@ -23,7 +23,7 @@ RUN apt-get update && \
     rm -rf /var/lib/apt/lists/* /tmp/* /var/tmp/* /usr/share/doc/* /usr/share/man/*
 
 # Create non-root user for security
-RUN useradd -m -u 1000 -s /usr/sbin/nologin -c "Antislop user" antislop
+RUN useradd -m -u 1000 -s /usr/sbin/nologin -c "AntiSlop user" antislop
 
 # Copy binary from builder and set permissions
 COPY --from=builder --chown=antislop:antislop /usr/src/antislop/target/release/antislop /usr/local/bin/antislop

QA_STRATEGY.md

@@ -20,10 +20,10 @@ We follow a multi-layered testing pyramid with emphasis on:
 
 We adhere to a Mutually Exclusive, Collectively Exhaustive (MECE) strategy with standard linters.
 
-**Rule:** Use Antislop ONLY for patterns missed by standard linter defaults.
+**Rule:** Use AntiSlop ONLY for patterns missed by standard linter defaults.
 - **Static Analysis**: `scripts/check_overlap.py` ensures no pattern regex overlaps with standard linter defaults.
-- **Dynamic Verification**: `scripts/verify_hygiene.sh` runs real linters (Pylint, ESLint, Clippy) against `examples/` to prove Antislop finds unique issues.
-- **Goal**: Antislop only flags "AI Slop" (intent/laziness), leaving syntax/style to specialized tools.
+- **Dynamic Verification**: `scripts/verify_hygiene.sh` runs real linters (Pylint, ESLint, Clippy) against `examples/` to prove AntiSlop finds unique issues.
+- **Goal**: AntiSlop only flags "AI Slop" (intent/laziness), leaving syntax/style to specialized tools.
 
 ---
 

README.md

@@ -1,4 +1,4 @@
-# antislop
+# AntiSlop
 
 [![CI](https://github.com/skew202/antislop/actions/workflows/ci.yml/badge.svg)](https://github.com/skew202/antislop/actions/workflows/ci.yml)
 [![Crates.io](https://img.shields.io/crates/v/antislop.svg)](https://crates.io/crates/antislop)
@@ -8,11 +8,11 @@
 
 **A blazing-fast, multi-language linter for detecting AI-generated code slop.**
 
-Antislop helps you maintain code quality by identifying lazily generated code, deferrals, hedging, and placeholders often left behind by AI coding assistants.
+AntiSlop helps you maintain code quality by identifying lazily generated code, deferrals, hedging, and placeholders often left behind by AI coding assistants.
 
 ## What is Slop?
 
-AI models often produce code that works but is littered with signs of hesitation or incompleteness. Antislop detects:
+AI models often produce code that works but is littered with signs of hesitation or incompleteness. AntiSlop detects:
 
 - **Placeholders**: `TODO`, `FIXME`, `HACK`, `XXX` comments
 - **Deferrals**: "for now", "temporary fix", "quick implementation"
@@ -22,7 +22,7 @@ AI models often produce code that works but is littered with signs of hesitation
 
 ## Philosophy
 
-Antislop is built on **First Principles**:
+AntiSlop is built on **First Principles**:
 1.  **Code is Liability**: Every line of code is a future maintenance cost.
 2.  **Intent != Implementation**: Comments like `TODO` or `for now` signal a gap between what was intended and what was built.
 3.  **Speed is a Feature**: Verification must be instant to be useful.
@@ -32,13 +32,13 @@ We believe that AI generated code should be treated with **Zero Trust**. Verify
 ### Pattern Hygiene (MECE)
 
 We follow a **Mutually Exclusive, Collectively Exhaustive** strategy with standard linters like MegaLinter.
-*   **Antislop**: Detects AI shortcuts (stubs, hallucinated API usage, hedging).
+*   **AntiSlop**: Detects AI shortcuts (stubs, hallucinated API usage, hedging).
 *   **Standard Linters**: Detect syntax errors, style issues, and bugs.
-*   **Rule**: If `eslint` or `clippy` catches it by default, Antislop will **not** cover it (unless explicitly whitelisted).
+*   **Rule**: If `eslint` or `clippy` catches it by default, AntiSlop will **not** cover it (unless explicitly whitelisted).
 
 ## Comparison
 
-| Feature | Antislop | Standard Linters (ESLint/Clippy) | AI Refactors |
+| Feature | AntiSlop | Standard Linters (ESLint/Clippy) | AI Refactors |
 |:--------|:---------|:---------------------------------|:-------------|
 | **Focus** | **Intent & Completeness** | Syntax & Best Practices | Improvements |
 | **Speed** | **Milliseconds** | Seconds/Minutes | Slow |
@@ -58,7 +58,7 @@ def calculate_user_metrics(user_id: str) -> dict:
     return {"score": 42, "level": "gold"}  # Placeholder values
 ```
 
-**Antislop catches what linters miss:**
+**AntiSlop catches what linters miss:**
 
 ```
 $ antislop --profile antislop-standard api/
@@ -105,11 +105,11 @@ api/metrics.py 5:47: HIGH [stub]
 ⚠⚠⚠ High slop detected - AI shortcuts found!
 ```
 
-**Zero false positives. Maximum signal.** Antislop finds the intent gaps that syntax checkers can't see.
+**Zero false positives. Maximum signal.** AntiSlop finds the intent gaps that syntax checkers can't see.
 
 ## Performance
 
-Antislop uses tree-sitter AST parsing for accurate detection. Regex-only mode is ~10x faster.
+AntiSlop uses tree-sitter AST parsing for accurate detection. Regex-only mode is ~10x faster.
 
 | Language | Mode | Time | Throughput |
 |:---------|:-----|:-----|:-----------|
@@ -175,7 +175,7 @@ antislop --hygiene-survey
 
 ### Profiles
 
-Antislop follows a **Zero False Positive** philosophy for its default core.
+AntiSlop follows a **Zero False Positive** philosophy for its default core.
 
 - **Core** (Default): Critical stubs & placeholders only. Zero false positives.
 - **trict** (`--profile antislop-strict`): Maximum coverage. Detects all forms of slop.
@@ -203,15 +203,15 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
-      - name: Install Antislop
+      - name: Install AntiSlop
         run: curl -sSf https://raw.githubusercontent.com/skew202/antislop/main/install.sh | sh
       - name: Run Scan
         run: antislop --profile antislop-standard .
 ```
 
 ## Installation Options
 
-Antislop is modular. You can optimize for binary size by choosing specific languages:
+AntiSlop is modular. You can optimize for binary size by choosing specific languages:
 
 ```bash
 # Default (Standard Languages)