docs: move deep docs into docs/ and tidy README

Author: AI Assistant

.claude/decisions/2026-01-15-multi-model-routing.md

@@ -205,8 +205,8 @@ model_usage:
 
 - [Anthropic Model Pricing](https://www.anthropic.com/pricing)
 - [Claude API Documentation](https://docs.anthropic.com/en/api/messages)
-- [PRODREADY_ARCHITECTURE.md](../../PRODREADY_ARCHITECTURE.md#multi-model-routing-strategy)
-- [MULTI_MODEL_ROUTING_STRATEGY.md](../../MULTI_MODEL_ROUTING_STRATEGY.md)
+- [PRODREADY_ARCHITECTURE.md](../../docs/PRODREADY_ARCHITECTURE.md#multi-model-routing-strategy)
+- [MULTI_MODEL_ROUTING_STRATEGY.md](../../docs/MULTI_MODEL_ROUTING_STRATEGY.md)
 
 ---
 

.claude/decisions/2026-01-15-prompt-caching.md

@@ -494,8 +494,8 @@ session_cache_performance:
 
 - [Anthropic Prompt Caching Documentation](https://docs.anthropic.com/en/docs/build-with-claude/prompt-caching)
 - [Anthropic Pricing](https://www.anthropic.com/pricing)
-- [PROMPT_CACHING_STRATEGY.md](../../PROMPT_CACHING_STRATEGY.md) — Full specification
-- [PRODREADY_ARCHITECTURE.md](../../PRODREADY_ARCHITECTURE.md) — Core architecture
+- [PROMPT_CACHING_STRATEGY.md](../../docs/PROMPT_CACHING_STRATEGY.md) — Full specification
+- [PRODREADY_ARCHITECTURE.md](../../docs/PRODREADY_ARCHITECTURE.md) — Core architecture
 - [Multi-Model Routing Strategy](./2026-01-15-multi-model-routing.md) — Complementary optimization
 
 ---

.claude/diagrams/USER_INTERACTION_FLOW.md

@@ -959,7 +959,7 @@ Next Steps:
 - 2026-01-16: Initial version (Phase 0 complete)
 
 **Related Documents:**
-- [PRODREADY_ARCHITECTURE.md](../../PRODREADY_ARCHITECTURE.md)
-- [MULTI_MODEL_ROUTING_STRATEGY.md](../../MULTI_MODEL_ROUTING_STRATEGY.md)
-- [PROMPT_CACHING_STRATEGY.md](../../PROMPT_CACHING_STRATEGY.md)
-- [START_HERE_IMPLEMENTATION.md](../../START_HERE_IMPLEMENTATION.md)
+- [PRODREADY_ARCHITECTURE.md](../../docs/PRODREADY_ARCHITECTURE.md)
+- [MULTI_MODEL_ROUTING_STRATEGY.md](../../docs/MULTI_MODEL_ROUTING_STRATEGY.md)
+- [PROMPT_CACHING_STRATEGY.md](../../docs/PROMPT_CACHING_STRATEGY.md)
+- [START_HERE_IMPLEMENTATION.md](../../docs/START_HERE_IMPLEMENTATION.md)

.eslintrc.cjs

@@ -0,0 +1,18 @@
+/** @type {import("eslint").Linter.Config} */
+module.exports = {
+  root: true,
+  env: {
+    node: true,
+    es2022: true,
+  },
+  parser: "@typescript-eslint/parser",
+  plugins: ["@typescript-eslint"],
+  extends: ["eslint:recommended", "plugin:@typescript-eslint/recommended"],
+  ignorePatterns: ["dist/**", "node_modules/**"],
+  rules: {
+    // This repo is early-stage; keep lint useful but not blocking.
+    "@typescript-eslint/no-explicit-any": "off",
+    "@typescript-eslint/no-unused-vars": ["warn", { argsIgnorePattern: "^_" }],
+  },
+};
+

.github/workflows/prodready-ci.yml

@@ -5,15 +5,20 @@ on:
     branches: [main]
   pull_request:
 
+env:
+  # GitHub-hosted runners will default JavaScript actions to Node 24 starting 2026-06-02.
+  # Opt in early to avoid surprise breakage and remove Node 20 deprecation warnings.
+  FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: "true"
+
 jobs:
   test:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
-        uses: actions/checkout@v4
+        uses: actions/checkout@v6
 
       - name: Setup Node.js
-        uses: actions/setup-node@v4
+        uses: actions/setup-node@v6
         with:
           node-version: "20"
           cache: npm

README.md

@@ -151,6 +151,10 @@ prodready cycle --all
 
 ---
 
+## Documentation
+
+Deeper implementation notes and strategy docs live in [`docs/`](docs/README.md).
+
 ## Architecture
 
 ### Multi-Model Routing
@@ -280,15 +284,16 @@ npm run format        # Prettier
 
 ## Architecture Decisions
 
-See [.claude/decisions/](c:\Users\georg\claude-code-project\AI-test-suite\.claude\decisions) for detailed ADRs:
+See [.claude/decisions/](.claude/decisions/) for detailed ADRs:
 
 - [2026-01-15-prompt-caching.md](.claude/decisions/2026-01-15-prompt-caching.md)
 
 See architecture documents:
-- [START_HERE_IMPLEMENTATION.md](START_HERE_IMPLEMENTATION.md)
-- [PRODREADY_ARCHITECTURE.md](PRODREADY_ARCHITECTURE.md)
-- [MULTI_MODEL_ROUTING_STRATEGY.md](MULTI_MODEL_ROUTING_STRATEGY.md)
-- [PROMPT_CACHING_STRATEGY.md](PROMPT_CACHING_STRATEGY.md)
+- [docs/README.md](docs/README.md)
+- [START_HERE_IMPLEMENTATION.md](docs/START_HERE_IMPLEMENTATION.md)
+- [PRODREADY_ARCHITECTURE.md](docs/PRODREADY_ARCHITECTURE.md)
+- [MULTI_MODEL_ROUTING_STRATEGY.md](docs/MULTI_MODEL_ROUTING_STRATEGY.md)
+- [PROMPT_CACHING_STRATEGY.md](docs/PROMPT_CACHING_STRATEGY.md)
 
 ---