kodelyth-ecc 1.2.0

package/wiki/Agent-Reference.md

@@ -0,0 +1,199 @@
+# Agent Reference
+
+53 specialist agents — each one a decade-experienced engineer in a specific domain.
+
+---
+
+## Kodelyth Exclusive (6 agents)
+
+These agents exist only in Kodelyth ECC.
+
+### `kodelyth-advisor` — The Master Guide
+
+Reads your situation, understands what you're struggling with, and gives you the exact tool or approach needed. No hand-holding, no noise — direct senior-grade direction.
+
+```
+use kodelyth-advisor
+```
+
+Best for: "I don't know where to start", picking the right agent, unclear problems.
+
+---
+
+### `debug-detective` — The Root Cause Hunter
+
+Never guesses. Traces every bug to its exact origin through a structured hypothesis protocol. Binary search debug, git bisect, minimal reproducers, advanced tracing.
+
+```
+use debug-detective
+```
+
+Best for: Hard bugs, intermittent failures, "I've tried everything" situations.
+
+---
+
+### `ux-reviewer` — The Interface Guardian
+
+Reviews frontend code for usability, interaction logic, and WCAG 2.1 AA accessibility. **Never touches design aesthetic** — only behavior.
+
+```
+use ux-reviewer
+```
+
+Best for: Before shipping any frontend feature, accessibility audits.
+
+---
+
+### `api-guardian` — The Contract Protector
+
+Detects breaking API changes before they ship. Classifies every change as BREAKING / SAFE / WARN, generates consumer impact reports, enforces versioning and deprecation headers.
+
+```
+use api-guardian
+```
+
+Best for: API changes, version bumps, public endpoint modifications.
+
+---
+
+### `pair-programmer` — The Pre-Code Thinker
+
+The engineer who sits next to you before you start coding. Catches the wrong approach, over-engineering, missed edge cases — before a single line is written.
+
+```
+use pair-programmer
+```
+
+Best for: Before starting any feature, evaluating approaches.
+
+---
+
+### `migration-guide` — The Migration Specialist
+
+Full migration playbooks: React 18→19, Next.js 12→15, Python 2→3, Node.js 14→22, TypeScript 4→5, Java 8→21. Phase by phase: audit → blast radius → phased plan → execute → validate.
+
+```
+use migration-guide
+```
+
+Best for: Framework upgrades, language version migrations.
+
+---
+
+## Code Review (10 agents)
+
+| Agent | Language / Domain |
+|-------|------------------|
+| `code-reviewer` | General — quality, patterns, best practices |
+| `typescript-reviewer` | TypeScript + JavaScript |
+| `python-reviewer` | Python — PEP 8, type hints, security |
+| `go-reviewer` | Go — idiomatic patterns, concurrency |
+| `rust-reviewer` | Rust — ownership, lifetimes, unsafe |
+| `java-reviewer` | Java + Spring Boot |
+| `kotlin-reviewer` | Kotlin + Android + KMP |
+| `cpp-reviewer` | C++ — memory safety, modern idioms |
+| `csharp-reviewer` | C# + .NET — async, nullable, security |
+| `flutter-reviewer` | Flutter + Dart — widget best practices |
+
+---
+
+## Build Fixers (8 agents)
+
+| Agent | Platform |
+|-------|---------|
+| `build-error-resolver` | TypeScript / general |
+| `go-build-resolver` | Go |
+| `rust-build-resolver` | Rust + Cargo |
+| `java-build-resolver` | Java + Maven + Gradle |
+| `kotlin-build-resolver` | Kotlin + Gradle |
+| `cpp-build-resolver` | C++ + CMake |
+| `dart-build-resolver` | Dart + Flutter |
+| `pytorch-build-resolver` | PyTorch + CUDA |
+
+---
+
+## Planning & Architecture (6 agents)
+
+| Agent | Purpose |
+|-------|---------|
+| `planner` | Feature implementation plans |
+| `architect` | System design, scalability decisions |
+| `code-architect` | Blueprints from existing codebase patterns |
+| `code-explorer` | Deep codebase analysis and dependency mapping |
+| `chief-of-staff` | Communication triage — email, Slack, LINE |
+| `pair-programmer` | Pre-code thinking partner |
+
+---
+
+## Security (3 agents)
+
+| Agent | Purpose |
+|-------|---------|
+| `security-reviewer` | OWASP Top 10, secrets, injection, SSRF |
+| `healthcare-reviewer` | HIPAA, PHI, clinical safety |
+| `api-guardian` | Breaking changes, versioning, contracts |
+
+---
+
+## Quality & Performance (5 agents)
+
+| Agent | Purpose |
+|-------|---------|
+| `refactor-cleaner` | Dead code removal, knip, depcheck |
+| `code-simplifier` | Clarity and consistency |
+| `performance-optimizer` | Bottlenecks, bundle size, render perf |
+| `type-design-analyzer` | Type safety and invariant design |
+| `silent-failure-hunter` | Swallowed errors, bad fallbacks |
+
+---
+
+## Testing (3 agents)
+
+| Agent | Purpose |
+|-------|---------|
+| `tdd-guide` | Write tests first, 80%+ coverage |
+| `e2e-runner` | E2E tests with Playwright |
+| `pr-test-analyzer` | PR test coverage review |
+
+---
+
+## Documentation (3 agents)
+
+| Agent | Purpose |
+|-------|---------|
+| `doc-updater` | CODEMAPS, READMEs, guides |
+| `docs-lookup` | Context7 — library docs and API examples |
+| `comment-analyzer` | Comment accuracy and rot detection |
+
+---
+
+## Open Source (3 agents)
+
+| Agent | Purpose |
+|-------|---------|
+| `opensource-forker` | Fork and strip secrets for public release |
+| `opensource-sanitizer` | Verify fork is clean before release |
+| `opensource-packager` | CLAUDE.md, setup.sh, README, LICENSE, templates |
+
+---
+
+## Specialized (6 agents)
+
+| Agent | Purpose |
+|-------|---------|
+| `debug-detective` | Root cause hunting |
+| `ux-reviewer` | UX + accessibility |
+| `seo-specialist` | Technical SEO, Core Web Vitals, schema |
+| `database-reviewer` | PostgreSQL — queries, schema, Supabase |
+| `comment-analyzer` | Comment accuracy |
+| `kodelyth-advisor` | Master guide |
+
+---
+
+## GAN Harness (3 agents)
+
+| Agent | Purpose |
+|-------|---------|
+| `gan-planner` | Expand a prompt into a full product spec |
+| `gan-generator` | Implement features, iterate on feedback |
+| `gan-evaluator` | Test the live app via Playwright, score against rubric |

package/wiki/FAQ.md

@@ -0,0 +1,142 @@
+# FAQ
+
+---
+
+## General
+
+### Is this really free?
+
+Yes. MIT license. No paid tier, no API key required, no usage limits. The tool itself is free — you pay only for whatever AI platform you use (Claude Code, Antigravity, etc.) through Anthropic or Google directly.
+
+### Does it work with any language?
+
+Yes. The agents are language-agnostic. There are also language-specific rule bundles (TypeScript, Python, Go, Rust, Java, Kotlin, C++, Dart, PHP, Swift, Perl, web) that can be installed via profiles.
+
+### How is this different from just using Claude Code alone?
+
+Out of the box, Claude Code is a general-purpose assistant. Kodelyth ECC adds:
+- 53 specialist agents that are deeply opinionated in their domains
+- Automated hooks that run quality checks without you asking
+- Slash commands for repeatable workflows
+- Domain knowledge skills that stay active for the session
+- Always-on principles (no emoji, budget-first model selection, SVG over decoration)
+
+---
+
+## Installation
+
+### Install fails with "permission denied"
+
+```bash
+chmod +x install.sh
+./install.sh
+```
+
+### Install fails on Windows
+
+Use PowerShell (not Command Prompt):
+
+```powershell
+Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
+.\install.ps1
+```
+
+### How do I update to a new version?
+
+```bash
+cd kodelyth-ecc
+git pull
+./install.sh
+```
+
+The install script is idempotent — safe to run multiple times.
+
+### How do I uninstall?
+
+Claude Code:
+```bash
+rm -rf ~/.claude/agents ~/.claude/skills ~/.claude/hooks ~/.claude/commands ~/.claude/rules
+```
+
+Antigravity:
+```bash
+rm -rf your-project/.agent/
+```
+
+---
+
+## Agents
+
+### How do I use an agent?
+
+```
+use agent-name
+```
+
+Example:
+```
+use debug-detective
+use kodelyth-advisor
+use security-reviewer
+```
+
+### Which agent should I use first?
+
+If you're not sure, always start with:
+
+```
+use kodelyth-advisor
+```
+
+It will assess your situation and direct you to the right agent or skill.
+
+### Can I use multiple agents in one session?
+
+Yes. You can delegate to agents sequentially or in parallel. Example:
+
+```
+use pair-programmer    ← think through the approach first
+use tdd-guide          ← write tests
+use code-reviewer      ← review the implementation
+use security-reviewer  ← check for vulnerabilities
+```
+
+---
+
+## Google Antigravity
+
+### Do hooks work in Antigravity?
+
+Antigravity does not have a hook execution engine. Hook behavior is approximated via `.agent/rules/kodelyth-always-on.md` which auto-loads every session and enforces the same principles (test reminders, branch naming, model selection).
+
+### Do I need to say anything to Antigravity to activate ECC?
+
+No. After install, `.agent/rules/kodelyth-always-on.md` is loaded automatically every session. ECC is always active.
+
+### Which Antigravity model should I use for daily work?
+
+**Gemini 3.1 Pro (Low)** for everyday coding tasks. Switch to **Gemini 3.1 Pro (High)** for complex features or multi-file refactoring. Use **Claude Sonnet 4.6 Thinking** for agent-heavy or reasoning tasks.
+
+---
+
+## Contributing
+
+### How do I contribute a new agent?
+
+See [CONTRIBUTING.md](https://github.com/sifxprime/kodelyth-ecc/blob/main/CONTRIBUTING.md).
+
+Agents must follow the Kodelyth Standard:
+- GOD-level persona (decade-experienced specialist)
+- Model-agnostic (no model field in frontmatter)
+- Production-grade examples
+- No emoji in output — SVG badges or plain text only
+
+### How do I report a security issue?
+
+Email **sifxprime@kodelyth.com** with subject `[SECURITY] kodelyth-ecc — <description>`.
+
+See [SECURITY.md](https://github.com/sifxprime/kodelyth-ecc/blob/main/SECURITY.md) for full policy.
+
+---
+
+## Built and maintained by [Kodelyth](https://github.com/sifxprime) — [@sifxprime](https://github.com/sifxprime)

package/wiki/Home.md

@@ -0,0 +1,50 @@
+# Kodelyth ECC — Wiki
+
+> Production-grade AI coding agent toolkit for Claude Code, Google Antigravity, Cursor, Codex, and OpenCode.
+
+**Version:** 1.1.0 | **License:** MIT | **Author:** [Kodelyth / @sifxprime](https://github.com/sifxprime)
+
+---
+
+## Quick Navigation
+
+| Page | Description |
+|------|-------------|
+| [Installation Guide](Installation-Guide) | Install on any platform in 30 seconds |
+| [Agent Reference](Agent-Reference) | All 53 specialist agents explained |
+| [Skill Reference](Skill-Reference) | All 185 skills and how to load them |
+| [Hook Reference](Hook-Reference) | 18+ automated hooks that run in background |
+| [Platform Support](Platform-Support) | Claude Code, Antigravity, Cursor, Codex, OpenCode |
+| [FAQ](FAQ) | Common questions answered |
+
+---
+
+## What is Kodelyth ECC?
+
+Kodelyth ECC is a collection of 53 specialist AI agents, 185 knowledge skills, 79 slash commands, and 18+ automated hooks — all free, all open source, MIT licensed.
+
+Instead of one generic AI assistant doing everything, you get a team:
+
+- A **debugger** that never guesses and traces every bug to its root cause
+- A **security reviewer** that catches OWASP Top 10 before you commit
+- A **UX reviewer** that enforces WCAG 2.1 AA without touching your design
+- A **pair programmer** that catches the wrong approach before you write a line
+- A **migration guide** with full playbooks for React, Next.js, Python, Node, TypeScript, Java
+
+All working together. All free.
+
+---
+
+## Install
+
+```bash
+git clone https://github.com/sifxprime/kodelyth-ecc.git
+cd kodelyth-ecc
+./install.sh
+```
+
+See [Installation Guide](Installation-Guide) for full options.
+
+---
+
+Built with care. Powered by **Kodelyth**.

package/wiki/Hook-Reference.md

@@ -0,0 +1,101 @@
+# Hook Reference
+
+Hooks run automatically in the background after install. Zero configuration required.
+
+---
+
+## How Hooks Work
+
+Hooks are lifecycle triggers that fire before or after Claude Code actions:
+
+| Type | When it fires |
+|------|--------------|
+| `PreToolUse` | Before a tool executes |
+| `PostToolUse` | After a tool executes |
+| `Stop` | When the session ends |
+
+Hooks never block the user — they run async and notify when relevant.
+
+---
+
+## Core Hooks (always active)
+
+| Hook | Trigger | What it does |
+|------|---------|-------------|
+| Session start | Session begins | Loads context from previous session |
+| Pre-commit | `git commit` | Catches `console.log`, secrets, bad commit messages |
+| Quality gate | After any file edit | Runs type checks + formatting |
+| Git push reminder | Before `git push` | Prompts for review |
+| Config protection | Config file edits | Blocks weakening linter/formatter settings |
+| Cost tracker | End of session | Logs token usage per session |
+| Desktop notify | Long task completes | macOS notification when Claude finishes |
+| MCP health check | Before MCP call | Validates MCP servers are reachable |
+
+---
+
+## Kodelyth Hooks (v1.1.0)
+
+### `test-reminder`
+
+**Trigger:** After any code file is edited without touching a test file
+
+**What it does:** Flags that tests may need to be written or updated
+
+```
+[test-reminder] Code edited but no test file was touched.
+Consider: Does this change need test coverage?
+```
+
+---
+
+### `smart-suggest`
+
+**Trigger:** After each Claude Code response
+
+**What it does:** Detects signals in the session and suggests the next logical agent
+
+Examples:
+- Sees a bug → suggests `debug-detective`
+- Sees API changes → suggests `api-guardian`
+- Sees frontend code → suggests `ux-reviewer`
+- Sees security-sensitive code → suggests `security-reviewer`
+
+---
+
+### `branch-name-check`
+
+**Trigger:** Before `git checkout -b` (creating a new branch)
+
+**What it does:** Blocks branches that don't follow the naming convention
+
+**Valid patterns:**
+```
+feat/add-user-auth
+fix/login-redirect-loop
+chore/update-dependencies
+refactor/extract-payment-service
+docs/api-reference-update
+test/coverage-auth-module
+```
+
+**Blocked patterns:**
+```
+my-branch
+update
+wip
+temp123
+NEW_FEATURE
+```
+
+---
+
+## Hook File Location
+
+After install:
+
+```
+~/.claude/hooks/hooks.json     ← Claude Code
+.agent/rules/                  ← Google Antigravity (rules-based, no hook engine)
+```
+
+Note: Google Antigravity does not have a hook execution engine. Hook behavior for Antigravity is approximated via always-on rules in `.agent/rules/kodelyth-always-on.md`.

package/wiki/Installation-Guide.md

@@ -0,0 +1,126 @@
+# Installation Guide
+
+---
+
+## Claude Code
+
+### macOS / Linux (one-liner)
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/sifxprime/kodelyth-ecc/main/install.sh | bash
+```
+
+### Or clone and install manually
+
+```bash
+git clone https://github.com/sifxprime/kodelyth-ecc.git
+cd kodelyth-ecc
+./install.sh
+```
+
+### Windows (PowerShell)
+
+```powershell
+git clone https://github.com/sifxprime/kodelyth-ecc.git
+cd kodelyth-ecc
+.\install.ps1
+```
+
+When complete, you will see:
+
+```
+ARMED AND OPERATIONAL.
+```
+
+Agents are now available globally in every Claude Code session.
+
+---
+
+## Google Antigravity
+
+```bash
+git clone https://github.com/sifxprime/kodelyth-ecc.git
+cd kodelyth-ecc
+./install.sh --target antigravity
+```
+
+This installs everything into your project's `.agent/` directory:
+
+```
+your-project/
+└── .agent/
+    ├── rules/       ← coding standards + always-on ECC behavior
+    ├── workflows/   ← 79 slash commands
+    └── skills/      ← all 53 agents
+```
+
+The file `.agent/rules/kodelyth-always-on.md` loads ECC behavior automatically every session — no prompt required.
+
+---
+
+## Other Platforms
+
+| Platform | Command |
+|----------|---------|
+| Cursor | `./install.sh --target cursor-project` |
+| Codex CLI | `./install.sh --target codex-home` |
+| OpenCode | `./install.sh --target opencode` |
+
+---
+
+## Install Profiles (Language Bundles)
+
+Pre-built rule bundles for common stacks:
+
+```bash
+./install.sh --profile nextjs      # TypeScript + React + Next.js
+./install.sh --profile python-api  # Python + Django/FastAPI
+./install.sh --profile fullstack   # TypeScript + Python + Go
+./install.sh --profile mobile      # Kotlin + Swift
+./install.sh --profile backend     # Go + Python + Java
+```
+
+---
+
+## After Install — First Steps
+
+### Claude Code
+
+```
+/kodelyth-quickstart
+```
+
+This loads the plain-language getting-started guide.
+
+### Google Antigravity
+
+Type in any project:
+
+```
+/kodelyth-quickstart
+```
+
+Or just start working — kodelyth-always-on.md auto-loads ECC behavior every session.
+
+---
+
+## What Gets Installed
+
+### Claude Code (`~/.claude/`)
+
+| Source | Destination |
+|--------|------------|
+| `agents/` | `~/.claude/agents/` |
+| `skills/` | `~/.claude/skills/` |
+| `hooks/hooks.json` | `~/.claude/hooks/` |
+| `rules/` | `~/.claude/rules/` |
+| `commands/` | `~/.claude/commands/` |
+
+### Antigravity (`.agent/` in project root)
+
+| Source | Destination |
+|--------|------------|
+| `agents/` | `.agent/skills/` |
+| `commands/` | `.agent/workflows/` |
+| `rules/` | `.agent/rules/` |
+| Kodelyth skills (flattened) | `.agent/rules/` |