docs: consolidate to user-facing guide only (removes duplicates and legacy flat docs)

.github/docs-pipeline-contract.md

@@ -0,0 +1,57 @@
+# RTK Documentation — Interface Contract
+
+This directory contains user-facing documentation for the RTK website.
+It feeds `rtk-ai/rtk-website` via the `prepare-docs.mjs` pipeline.
+
+**Scope**: `docs/guide/` is website content only. Technical and contributor documentation
+lives in the codebase (distributed, co-located pattern):
+- `ARCHITECTURE.md` — System design, ADRs, filtering strategies
+- `CONTRIBUTING.md` — Design philosophy, PR process, TOML vs Rust
+- `SECURITY.md` — Vulnerability policy
+- `src/*/README.md` — Per-module implementation docs
+- `hooks/README.md` — Hook system and agent integrations
+
+## Structure
+
+```
+docs/
+  README.md      <- This file (interface contract — do not remove)
+  guide/         -> User-facing documentation (website "Guide" tab)
+    index.md
+    getting-started/
+      installation.md
+      quick-start.md
+      supported-agents.md
+    what-rtk-covers.md
+    analytics/
+      gain.md
+    configuration.md
+    troubleshooting.md
+```
+
+## Frontmatter (required on every .md)
+
+Every markdown file under `docs/guide/` must include:
+
+```yaml
+---
+title: string          # Page title (used in sidebar + search)
+description: string    # One-line summary for search results and SEO
+sidebar:
+  order: number        # Position within the sidebar group (1 = first)
+---
+```
+
+The `prepare-docs.mjs` pipeline validates this at build time and fails fast
+if frontmatter is missing or malformed.
+
+## Conventions
+
+- **Filenames**: kebab-case, `.md` only
+- **Subdirectories**: become sidebar groups in Starlight
+- **Internal links**: relative (`./foo.md`, `../configuration.md`)
+- **Diagrams**: Mermaid in fenced code blocks
+- **Code samples**: always specify the language (`rust`, `toml`, `bash`)
+- **Language**: English only
+- **No `rtk <cmd>` syntax**: users never type `rtk` — hooks rewrite commands transparently.
+  Only `rtk gain`, `rtk init`, `rtk verify`, and `rtk proxy` appear as user-typed commands.

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.34.1"
+  ".": "0.34.3"
 }

CHANGELOG.md

@@ -5,6 +5,37 @@ All notable changes to rtk (Rust Token Killer) will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.34.3](https://github.com/rtk-ai/rtk/compare/v0.34.2...v0.34.3) (2026-04-02)
+
+
+### Bug Fixes
+
+* **automod:** add auto discovery for cmds ([234909d](https://github.com/rtk-ai/rtk/commit/234909d2c754ade2fdc939b0a1435a8e34ffc305))
+* **ci:** fix validate-docs.sh broken module count check ([bbe3da6](https://github.com/rtk-ai/rtk/commit/bbe3da642b5fc4b065b13a65647ea0ebf5264e65))
+* **cleaning:** constant extract ([aabc016](https://github.com/rtk-ai/rtk/commit/aabc0167bc013fd2d0c61a687580f6e69305500a))
+* **cmds:** migrate remaining exit_code to exit_code_from_output ([ba9fa34](https://github.com/rtk-ai/rtk/commit/ba9fa345f3d1d14bd0af236ec9aa8a9a0e5581d6))
+* **cmds:** more covering for run_filtered ([e48485a](https://github.com/rtk-ai/rtk/commit/e48485adc6a33d12b70664598020595cf7dfcd7e))
+* **docs:** add documentation ([2f7278a](https://github.com/rtk-ai/rtk/commit/2f7278ac5992bf2e84b763fb05642d89900ba495))
+* **docs:** add maintainers docs ([14265b4](https://github.com/rtk-ai/rtk/commit/14265b48c3a15e459a31da11250a51ab5830a508))
+* **refacto-p1:** unified cmds execution flow  (+ rm dead code) ([75bd607](https://github.com/rtk-ai/rtk/commit/75bd607d55235f313855f5fe8c9eceafd73700a7))
+* **refacto-p2:** more standardize ([47a76ea](https://github.com/rtk-ai/rtk/commit/47a76ea35ed2fe02a3600792163f727fa3a94ff2))
+* **refacto-p2:** more standardize ([92c671a](https://github.com/rtk-ai/rtk/commit/92c671a175a5e2bf09720fd1a8591140bcb473a0))
+* **refacto:** wrappers for standardization, exit codes lexer tokenizer, constants, code clean ([bff0258](https://github.com/rtk-ai/rtk/commit/bff02584243f1b73418418b0c05365acf56fbb36))
+* **registry:** quoted env prefix + inline regex cleanup + routing docs ([f3217a4](https://github.com/rtk-ai/rtk/commit/f3217a467b543a3181605b257162f2b3ab5d5df0))
+* **review:** address PR [#910](https://github.com/rtk-ai/rtk/issues/910) review feedback ([0a8b8fd](https://github.com/rtk-ai/rtk/commit/0a8b8fd0693fa504f376146cbbcafe9ddf4632c8))
+* **review:** PR [#934](https://github.com/rtk-ai/rtk/issues/934) ([5bd35a3](https://github.com/rtk-ai/rtk/commit/5bd35a33ad6abe5278749726bed19912664531c2))
+* **review:** PR [#934](https://github.com/rtk-ai/rtk/issues/934) ([bae7930](https://github.com/rtk-ai/rtk/commit/bae79301194bbb48d1cbb39554096c3225f7cb73))
+* **rules:** add wc RtkRule with pattern field for develop compat ([d75e864](https://github.com/rtk-ai/rtk/commit/d75e864f20451a5e17918c75f2ea32672f65e1f4))
+* **standardize:** git+kube sub wrappers run_filtered ([7fd221f](https://github.com/rtk-ai/rtk/commit/7fd221f44660bcf411aa333d2c35a49ff89e7961))
+* **standardize:** merge pattern into rues ([08aabb9](https://github.com/rtk-ai/rtk/commit/08aabb95c3ae6e0b734f696264e1e1a8c0f0b22e))
+
+## [0.34.2](https://github.com/rtk-ai/rtk/compare/v0.34.1...v0.34.2) (2026-03-30)
+
+
+### Bug Fixes
+
+* **emots:** replace 📊 with "Summary:" ([495a152](https://github.com/rtk-ai/rtk/commit/495a152059feabc7b516b96e804757608b87a10a))
+* **refacto-codebase:** technical docs & sub folders ([927daef](https://github.com/rtk-ai/rtk/commit/927daef49b8f771d195201d196378e27e0ee8a2b))
 ## [Unreleased]
 
 ### Features

Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "rtk"
-version = "0.34.1"
+version = "0.34.3"
 edition = "2021"
 authors = ["Patrick Szymkowiak"]
 description = "Rust Token Killer - High-performance CLI proxy to minimize LLM token consumption"