feat: Phase 8+9 — self-improvement system and documentation rewrite

Phase 8 — Self-Improvement:
- Add maxsim-capture-learnings.ts: Stop hook capturing session learnings
  to .claude/agent-memory/maxsim-learner/MEMORY.md (git log, commits)
- Register in install/hooks.ts + tsdown.config.ts (6th hook bundle)
- Add templates/references/self-improvement.md: Git-as-Memory, Verify+Guard,
  bounded iterations, stuck detection

Phase 9 — Documentation:
- Rewrite USER-GUIDE.md: 509 lines, all v6 commands/workflow/config
- Rewrite INTERNALS.md: 572 lines, from actual source code
- Update README.md: Claude Code only, 14 skills, 3 profiles, v6 config
  schema, correct hooks (6), remove tokenburner/multi-runtime refs
- Update CONTRIBUTING.md: fix lint command, add upstream repo URL
- Update GitHub templates: version 6.0.0, remove AI Runtime dropdown
- Update 10 website docs: remove fictional commands/flags, fix config
  schema, correct plan-phase/discuss-phase titles
- Add deprecation notes to context-monitor.md, multi-runtime-architecture.md

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: maystudios

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -49,7 +49,7 @@ body:
     attributes:
       label: maxsimcli Version
       description: Run `npx maxsimcli@latest --version` or check your package.json
-      placeholder: "3.10.3"
+      placeholder: "6.0.0"
     validations:
       required: true
 
@@ -74,20 +74,6 @@ body:
     validations:
       required: true
 
-  - type: dropdown
-    id: runtime
-    attributes:
-      label: AI Runtime
-      description: Which AI runtime are you installing MAXSIM into?
-      options:
-        - Claude Code
-        - OpenCode
-        - Gemini CLI
-        - Codex
-        - Other / Not applicable
-    validations:
-      required: true
-
   - type: textarea
     id: additional
     attributes:

.github/ISSUE_TEMPLATE/feature_request.yml

@@ -37,7 +37,7 @@ body:
       description: Which part of MAXSIM does this affect?
       options:
         - CLI / install
-        - Commands (templates/commands/)
+        - Commands (packages/cli/src/commands/ or templates/)
         - Workflows (templates/workflows/)
         - Agents (templates/agents/)
         - Dashboard

CONTRIBUTING.md

@@ -5,7 +5,7 @@ Thank you for your interest in contributing! This guide covers everything you ne
 ## Development Setup
 
 ```bash
-# 1. Fork and clone the repo
+# 1. Fork https://github.com/maystudios/maxsimcli, then clone your fork
 git clone https://github.com/<your-username>/maxsimcli.git
 cd maxsimcli
 
@@ -75,8 +75,8 @@ git commit -m "feat!: rename STATE.md fields — breaks existing projects"
 This project uses **[Biome](https://biomejs.dev/)** for linting and formatting.
 
 ```bash
-npm run lint        # Check
-npm run lint --fix  # Auto-fix
+npm run lint             # Check
+npm run lint -- --fix    # Auto-fix (passes --fix through to Biome)
 ```
 
 Biome runs automatically on CI. PRs with lint failures will not be merged.

INTERNALS.md

@@ -1,5 +1,9 @@
 # Context Window Monitor
 
+> **Removed in v6.** The standalone context monitor hook has been replaced by the `capture-learnings` hook, which handles end-of-session state saving without requiring a bridge file or statusline integration. This document is retained for historical reference only.
+
+---
+
 A PostToolUse hook that warns the agent when context window usage is high.
 
 ## Problem

README.md

@@ -1,6 +1,8 @@
 # Multi-Runtime Adapter Architecture
 
-> **Status:** This document describes the multi-runtime adapter system as it existed before non-Claude runtimes were removed. It serves as a reference for future developers who might re-add multi-runtime support.
+> **REMOVED FEATURE — MaxsimCLI v6 supports Claude Code only.**
+>
+> This document describes the multi-runtime adapter system that was removed in v6. OpenCode, Gemini CLI, and Codex support no longer exist in the codebase. This document is retained as a reference for developers who might re-add multi-runtime support in the future. Do not rely on any of the interfaces or file paths described here — they have been deleted.
 
 ## Overview
 

docs/USER-GUIDE.md

@@ -0,0 +1,107 @@
+/**
+ * Stop hook — capture session learnings into agent memory.
+ *
+ * Behaviour:
+ *  - Reads the Stop event JSON from stdin (includes cwd, session_id).
+ *  - Checks if a MaxsimCLI project exists in cwd (.claude/maxsim/config.json).
+ *  - If yes: reads the last 5 git commits to summarise what was done.
+ *  - Appends a dated learning entry to .claude/agent-memory/maxsim-learner/MEMORY.md.
+ *  - Creates the directory structure if it does not exist.
+ *  - Always exits 0 — never blocks the user.
+ */
+
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { spawnSync } from 'node:child_process';
+import { readStdinJson, CLAUDE_DIR } from './shared.js';
+
+interface StopInput {
+  cwd?: string;
+  session_id?: string;
+  stop_reason?: string;
+  [key: string]: unknown;
+}
+
+/** Returns true when .claude/maxsim/config.json exists in the given directory. */
+function isMaxsimProject(projectDir: string): boolean {
+  try {
+    return fs.existsSync(path.join(projectDir, CLAUDE_DIR, 'maxsim', 'config.json'));
+  } catch {
+    return false;
+  }
+}
+
+/** Reads the last N git commits as oneline strings. Returns empty array on failure. */
+function recentCommits(projectDir: string, n = 5): string[] {
+  try {
+    const result = spawnSync(
+      'git',
+      ['log', `--oneline`, `-${n}`],
+      {
+        cwd: projectDir,
+        encoding: 'utf8',
+        timeout: 4000,
+        stdio: ['ignore', 'pipe', 'ignore'],
+        windowsHide: true,
+      },
+    );
+    if (result.status !== 0) return [];
+    return (result.stdout ?? '')
+      .split('\n')
+      .map((l) => l.trim())
+      .filter(Boolean);
+  } catch {
+    return [];
+  }
+}
+
+/** Formats today's date as YYYY-MM-DD. */
+function today(): string {
+  return new Date().toISOString().slice(0, 10);
+}
+
+/** Appends a learning entry to the MEMORY.md file, creating dirs as needed. */
+function appendLearning(memoryPath: string, sessionId: string | undefined, commits: string[]): void {
+  const dir = path.dirname(memoryPath);
+  fs.mkdirSync(dir, { recursive: true });
+
+  const sessionLabel = sessionId ? ` (${sessionId.slice(0, 8)})` : '';
+  const commitLines =
+    commits.length > 0
+      ? commits.map((c) => `- commit: ${c}`).join('\n')
+      : '- no commits recorded this session';
+
+  const entry = [
+    `## Session ${today()}${sessionLabel}`,
+    `- ${commits.length} commit(s) made this session`,
+    commitLines,
+    '',
+  ].join('\n');
+
+  fs.appendFileSync(memoryPath, `\n${entry}`, 'utf8');
+}
+
+readStdinJson<StopInput>((input) => {
+  try {
+    const projectDir = input.cwd ?? process.cwd();
+
+    if (!isMaxsimProject(projectDir)) {
+      process.exit(0);
+    }
+
+    const memoryPath = path.join(
+      projectDir,
+      CLAUDE_DIR,
+      'agent-memory',
+      'maxsim-learner',
+      'MEMORY.md',
+    );
+
+    const commits = recentCommits(projectDir, 5);
+    appendLearning(memoryPath, input.session_id, commits);
+  } catch {
+    // Never crash — always let the Stop event complete cleanly
+  }
+
+  process.exit(0);
+});