@the-bearded-bear/claude-craft 7.35.0 → 8.1.0

package/Dev/scripts/install-php-rules.sh

@@ -12,7 +12,7 @@ I18N_DIR="$(dirname "$SCRIPT_DIR")/i18n"
 TECH_NAME="PHP"
 TECH_DISPLAY_NAME="PHP"
 TECH_NAMESPACE="php"
-DEFAULT_STACK="PHP 8.3+, Composer, PSR Standards, PHPUnit"
+DEFAULT_STACK="PHP 8.5, Composer, PSR Standards, Pest 4, PHPUnit 12"
 
 # --- TCL version ---
 source "${SCRIPT_DIR}/tcl-common.sh"

package/Dev/scripts/validate-skills-spec.sh

@@ -0,0 +1,121 @@
+#!/usr/bin/env bash
+# validate-skills-spec.sh — Verify all .claude/skills/* conform to Anthropic Agent Skills spec.
+# v8.0.0+ : failure blocks CI.
+#
+# Spec: https://github.com/anthropics/skills/blob/main/spec/agent-skills-spec.md
+# Rules enforced:
+#   1. Each skill is a directory under .claude/skills/
+#   2. Each skill has a SKILL.md file at its root
+#   3. SKILL.md starts with YAML frontmatter (---)
+#   4. Frontmatter contains `name:` (matches dir name) and `description:` (non-empty)
+#   5. No absolute paths (/home/, /Users/, C:\) in any skill file
+#   6. Skill name is lowercase kebab-case
+
+set -euo pipefail
+
+SKILLS_DIR="${1:-.claude/skills}"
+ERRORS=0
+WARNINGS=0
+
+fail() {
+  echo "❌ FAIL: $1" >&2
+  ERRORS=$((ERRORS + 1))
+}
+
+warn() {
+  echo "⚠️  WARN: $1" >&2
+  WARNINGS=$((WARNINGS + 1))
+}
+
+pass() {
+  echo "✅ $1"
+}
+
+if [[ ! -d "$SKILLS_DIR" ]]; then
+  fail "Skills directory not found: $SKILLS_DIR"
+  exit 1
+fi
+
+echo "🔍 Validating skills in $SKILLS_DIR"
+echo ""
+
+SKILL_COUNT=0
+for skill_path in "$SKILLS_DIR"/*/; do
+  [[ -d "$skill_path" ]] || continue
+  skill_name=$(basename "$skill_path")
+  SKILL_COUNT=$((SKILL_COUNT + 1))
+
+  # Rule 6: kebab-case
+  if [[ ! "$skill_name" =~ ^[a-z0-9]+(-[a-z0-9]+)*$ ]]; then
+    fail "[$skill_name] name must be lowercase kebab-case"
+    continue
+  fi
+
+  skill_md="${skill_path}SKILL.md"
+
+  # Rule 2: SKILL.md exists
+  if [[ ! -f "$skill_md" ]]; then
+    fail "[$skill_name] missing SKILL.md"
+    continue
+  fi
+
+  # Rule 3: starts with ---
+  first_line=$(head -1 "$skill_md")
+  if [[ "$first_line" != "---" ]]; then
+    fail "[$skill_name] SKILL.md must start with --- (YAML frontmatter)"
+    continue
+  fi
+
+  # Extract frontmatter (between first two --- lines)
+  frontmatter=$(awk '/^---$/{c++; next} c==1{print} c==2{exit}' "$skill_md")
+
+  # Rule 4a: name field present
+  if ! echo "$frontmatter" | grep -q "^name:"; then
+    fail "[$skill_name] frontmatter missing 'name:' field"
+    continue
+  fi
+
+  declared_name=$(echo "$frontmatter" | grep "^name:" | head -1 | sed 's/^name:[[:space:]]*//' | tr -d '"' | tr -d "'")
+  if [[ "$declared_name" != "$skill_name" ]]; then
+    fail "[$skill_name] frontmatter name '$declared_name' does not match directory name"
+    continue
+  fi
+
+  # Rule 4b: description field present and non-empty
+  if ! echo "$frontmatter" | grep -q "^description:"; then
+    fail "[$skill_name] frontmatter missing 'description:' field"
+    continue
+  fi
+
+  description=$(echo "$frontmatter" | grep "^description:" | head -1 | sed 's/^description:[[:space:]]*//')
+  if [[ -z "$description" ]]; then
+    fail "[$skill_name] description is empty"
+    continue
+  fi
+
+  # Warn if description too short (< 30 chars) — won't help Claude decide
+  if [[ ${#description} -lt 30 ]]; then
+    warn "[$skill_name] description too short (${#description} chars). Aim for >= 80 chars with 'Use when...'"
+  fi
+
+  # Rule 5: no absolute paths in any file of the skill
+  if grep -rn "/home/\|/Users/\|C:\\\\" "$skill_path" 2>/dev/null | grep -v '\.git' | head -1 &>/dev/null; then
+    fail "[$skill_name] contains absolute path (forbidden by spec)"
+    continue
+  fi
+
+  pass "[$skill_name]"
+done
+
+echo ""
+echo "───────────────────────────────────────────"
+echo "Summary: $SKILL_COUNT skills | $ERRORS errors | $WARNINGS warnings"
+echo "───────────────────────────────────────────"
+
+if [[ "$ERRORS" -gt 0 ]]; then
+  echo "❌ Validation FAILED"
+  exit 1
+fi
+
+echo "✅ All skills conform to Anthropic Agent Skills spec"
+exit 0

package/README.md

@@ -6,14 +6,16 @@
 
 A comprehensive framework for AI-assisted development with [Claude Code](https://claude.ai/code). Install standardized rules, agents, and commands for your projects across multiple technology stacks.
 
-## What's New in v7.28
-
-- **Claude Code v2.1.107 compatibility** -- 45 new versions (v2.1.63-v2.1.107) fully documented
-- **Auto Mode** -- AI-powered permission classifier replacing `--dangerously-skip-permissions`
-- **New commands** -- /loop, /effort, /context, /powerup, /proactive, /team-onboarding
-- **8 new hook events** -- PostCompact, StopFailure, TaskCreated, CwdChanged, FileChanged, PermissionDenied, Elicitation, ElicitationResult
-- **MCP Tool Search** -- lazy loading reduces context usage by 95%
-- **Security hardening** -- 7 CVE fixes, subprocess sandboxing, source code leak incident documented
+## What's New in v8.0 (Breaking — Spec Anthropic)
+
+- **Strict alignment to Anthropic Agent Skills spec** -- 41/41 skills conformes, validation CI (`Dev/scripts/validate-skills-spec.sh`)
+- **5 new skills** (v7.31-v7.32) -- `atomic-tasks` (GSD), `design-md-convention`, `architect`, `debug-methodical`, `socratic-brainstorm`
+- **4 new agents** (v7.34) -- `@security-auditor`, `@data-analyst`, `@migration-specialist`, `@cost-optimizer`
+- **2 new commands** (v7.33-v7.34) -- `/common:pack-repo` (Repomix wrapper + fallback shell), `/uiux:generate-design-md`
+- **Memory lifecycle hooks** (v7.35) -- 5 hooks + SQLite local, inspired by claude-mem
+- **Rule 23 Karpathy** (v7.31) -- principes AI-first development
+- **Convention DESIGN.md** (v7.31) -- template AI-friendly + `/uiux:generate-design-md`
+- **Migration guide** -- [docs/MIGRATION-v7-to-v8.md](docs/MIGRATION-v7-to-v8.md)
 - See [CHANGELOG](CHANGELOG.md) for full details
 
 ## Install and First Result
@@ -118,7 +120,7 @@ These are the commands you'll use most:
 | `/common:ralph-run "task"` | Run Claude in continuous loop until task is done |
 | `/qa:recette` | Automated acceptance testing via Chrome |
 
-See [CLI Reference](docs/CLI-REFERENCE.md) for all 204 commands across 26 namespaces.
+See [CLI Reference](docs/CLI-REFERENCE.md) for all 214 commands across 27 namespaces.
 
 ## Installation
 
@@ -183,8 +185,8 @@ Context usage is optimized: ~3,500 tokens always loaded vs ~70,000 if everything
 | [Installation](docs/INSTALLATION.md) | All installation methods |
 | [Configuration](docs/CONFIGURATION.md) | Project configuration |
 | [CLI Reference](docs/CLI-REFERENCE.md) | Full CLI documentation |
-| [Commands](docs/COMMANDS.md) | All 204 commands |
-| [Agents](docs/AGENTS.md) | All 63 agents |
+| [Commands](docs/COMMANDS.md) | All 214 commands |
+| [Agents](docs/AGENTS.md) | All 67 agents |
 | [Skills](docs/SKILLS.md) | Best practices reference |
 | [Technologies](docs/TECHNOLOGIES.md) | Stack-specific guides |
 | [BMAD Guide](docs/BMAD-PRACTICAL-GUIDE.md) | Project management framework |

package/cli/index.js

@@ -38,6 +38,7 @@ import { runCheck } from './lib/check.js';
 import { runList } from './lib/list.js';
 import { runDoctor } from './lib/doctor.js';
 import { runUpdate } from './lib/update.js';
+import { runKanban } from './lib/kanban.js';
 
 // Flattener module
 import { flatten as flattenCodebaseFn } from './flattener.js';
@@ -204,6 +205,11 @@ class ClaudeCraftCLI {
         await runRalph(this, args.slice(1), options, ctx);
         break;
 
+      case 'kanban':
+        printBanner(VERSION);
+        await runKanban({ targetPath: this.config.targetPath, options });
+        break;
+
       case 'help':
       case '--help':
       case '-h':

package/cli/kanban/client/index.html

@@ -0,0 +1,17 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <title>claude-craft kanban</title>
+    <meta
+      http-equiv="Content-Security-Policy"
+      content="default-src 'self'; script-src 'self'; style-src 'self' 'unsafe-inline'; img-src 'self' data:; connect-src 'self';"
+    />
+    <link rel="stylesheet" href="./src/app.css" />
+  </head>
+  <body>
+    <div id="app"></div>
+    <script type="module" src="./src/main.js"></script>
+  </body>
+</html>

package/cli/kanban/client/src/App.svelte

@@ -0,0 +1,106 @@
+<script>
+  import { onMount, onDestroy } from 'svelte';
+  import { route } from './lib/router.svelte.js';
+  import { store, loadStories, loadSprint, connectEvents, disconnectEvents, dismissToast } from './lib/store.svelte.js';
+  import KanbanView from './views/KanbanView.svelte';
+  import BacklogView from './views/BacklogView.svelte';
+  // Lazy-loaded : pulls heavy viz libs (uPlot, Cytoscape, marked+dompurify).
+  const lazyBurndown = () => import('./views/BurndownView.svelte');
+  const lazyDeps = () => import('./views/DepsView.svelte');
+  const lazyDocs = () => import('./views/DocsView.svelte');
+
+  onMount(async () => {
+    await Promise.all([loadStories(), loadSprint()]);
+    connectEvents();
+  });
+
+  onDestroy(() => disconnectEvents());
+
+  const navItems = [
+    { path: '/kanban', label: 'Kanban' },
+    { path: '/backlog', label: 'Backlog' },
+    { path: '/burndown', label: 'Burndown' },
+    { path: '/deps', label: 'Dependencies' },
+    { path: '/docs', label: 'Docs' },
+  ];
+
+  function currentPath() {
+    return '/' + (route.parts[0] ?? 'kanban');
+  }
+
+  let sprintLabel = $derived(store.sprint ? `${store.sprint.name} (${store.sprint.sprint_id})` : 'no sprint');
+</script>
+
+<div class="app-shell">
+  <aside class="sidebar" aria-label="Navigation">
+    <h1>claude-craft</h1>
+    <nav class="nav" aria-label="Views">
+      {#each navItems as item}
+        <a
+          href={'#' + item.path}
+          aria-current={currentPath() === item.path ? 'page' : undefined}
+        >{item.label}</a>
+      {/each}
+    </nav>
+
+    <h1>Sprint</h1>
+    <div style="font-size:12px; color: var(--fg-dim); padding: 0 10px;">
+      {sprintLabel}
+    </div>
+  </aside>
+
+  <header class="topbar" role="banner">
+    <div class="title">
+      {#if store.sprint}
+        {store.sprint.goal || store.sprint.name}
+      {:else}
+        Kanban
+      {/if}
+    </div>
+    <div class="status {store.connected ? 'connected' : 'disconnected'}" aria-live="polite">
+      {store.connected ? '● live' : '○ offline'}
+    </div>
+  </header>
+
+  <main class="main" id="main">
+    {#if store.error && store.stories.length === 0}
+      <div class="empty">
+        <strong>Cannot reach server.</strong><br/>
+        {store.error}
+      </div>
+    {:else if currentPath() === '/kanban'}
+      <KanbanView />
+    {:else if currentPath() === '/backlog'}
+      <BacklogView />
+    {:else if currentPath() === '/burndown'}
+      {#await lazyBurndown()}
+        <div class="empty">Loading…</div>
+      {:then mod}
+        {@const Comp = mod.default}
+        <Comp />
+      {/await}
+    {:else if currentPath() === '/deps'}
+      {#await lazyDeps()}
+        <div class="empty">Loading…</div>
+      {:then mod}
+        {@const Comp = mod.default}
+        <Comp />
+      {/await}
+    {:else if currentPath() === '/docs'}
+      {#await lazyDocs()}
+        <div class="empty">Loading…</div>
+      {:then mod}
+        {@const Comp = mod.default}
+        <Comp />
+      {/await}
+    {/if}
+  </main>
+</div>
+
+<div class="toast-layer" aria-live="polite">
+  {#each store.toasts as t (t.id)}
+    <div class="toast {t.kind}" role="status" onclick={() => dismissToast(t.id)}>
+      {t.message}
+    </div>
+  {/each}
+</div>

package/cli/kanban/client/src/app.css

@@ -0,0 +1,175 @@
+:root {
+  color-scheme: light dark;
+  --bg: #fafafa;
+  --bg-elev: #ffffff;
+  --bg-sidebar: #f3f3f5;
+  --fg: #1a1a1a;
+  --fg-dim: #6b7280;
+  --border: #e4e4e7;
+  --accent: #7c3aed;
+  --accent-fg: #ffffff;
+  --danger: #dc2626;
+  --warn: #d97706;
+  --ok: #16a34a;
+  --info: #0284c7;
+  --shadow: 0 1px 2px rgba(0, 0, 0, 0.05);
+  --radius: 6px;
+  --font: 'Inter', system-ui, -apple-system, 'Segoe UI', sans-serif;
+  --mono: 'JetBrains Mono', ui-monospace, 'SF Mono', monospace;
+}
+
+@media (prefers-color-scheme: dark) {
+  :root {
+    --bg: #0f0f11;
+    --bg-elev: #1a1a1d;
+    --bg-sidebar: #141417;
+    --fg: #f4f4f5;
+    --fg-dim: #a1a1aa;
+    --border: #27272a;
+    --accent: #a78bfa;
+    --shadow: 0 1px 2px rgba(0, 0, 0, 0.3);
+  }
+}
+
+* {
+  box-sizing: border-box;
+}
+
+html,
+body,
+#app {
+  margin: 0;
+  padding: 0;
+  height: 100%;
+  background: var(--bg);
+  color: var(--fg);
+  font-family: var(--font);
+  font-size: 14px;
+  line-height: 1.45;
+}
+
+button,
+input,
+select {
+  font: inherit;
+  color: inherit;
+}
+
+a {
+  color: var(--accent);
+  text-decoration: none;
+}
+
+.app-shell {
+  display: grid;
+  grid-template-columns: 240px 1fr;
+  grid-template-rows: 48px 1fr;
+  grid-template-areas:
+    'sidebar topbar'
+    'sidebar main';
+  height: 100vh;
+}
+
+.sidebar {
+  grid-area: sidebar;
+  background: var(--bg-sidebar);
+  border-right: 1px solid var(--border);
+  padding: 16px 12px;
+  overflow-y: auto;
+}
+
+.sidebar h1 {
+  font-size: 13px;
+  font-weight: 700;
+  margin: 0 0 12px;
+  color: var(--fg-dim);
+  letter-spacing: 0.04em;
+  text-transform: uppercase;
+}
+
+.nav {
+  display: flex;
+  flex-direction: column;
+  gap: 2px;
+  margin-bottom: 20px;
+}
+
+.nav a {
+  padding: 6px 10px;
+  border-radius: var(--radius);
+  color: var(--fg);
+  font-weight: 500;
+}
+.nav a:hover {
+  background: var(--border);
+}
+.nav a[aria-current='page'] {
+  background: var(--accent);
+  color: var(--accent-fg);
+}
+
+.topbar {
+  grid-area: topbar;
+  background: var(--bg-elev);
+  border-bottom: 1px solid var(--border);
+  padding: 0 20px;
+  display: flex;
+  align-items: center;
+  gap: 16px;
+}
+
+.topbar .title {
+  font-weight: 600;
+  flex: 1;
+}
+
+.topbar .status {
+  color: var(--fg-dim);
+  font-size: 12px;
+  font-family: var(--mono);
+}
+.topbar .status.connected {
+  color: var(--ok);
+}
+.topbar .status.disconnected {
+  color: var(--danger);
+}
+
+.main {
+  grid-area: main;
+  overflow: auto;
+  padding: 20px;
+}
+
+.empty {
+  text-align: center;
+  padding: 80px 20px;
+  color: var(--fg-dim);
+}
+
+.toast-layer {
+  position: fixed;
+  bottom: 20px;
+  right: 20px;
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+  z-index: 1000;
+}
+.toast {
+  background: var(--bg-elev);
+  border: 1px solid var(--border);
+  border-radius: var(--radius);
+  padding: 10px 14px;
+  box-shadow: var(--shadow);
+  max-width: 360px;
+}
+.toast.error {
+  border-left: 3px solid var(--danger);
+}
+.toast.success {
+  border-left: 3px solid var(--ok);
+}
+.toast.info {
+  border-left: 3px solid var(--info);
+}

package/cli/kanban/client/src/lib/router.svelte.js

@@ -0,0 +1,19 @@
+// Minimal hash-based router using Svelte 5 runes.
+// Routes : #/kanban, #/backlog, #/burndown, #/deps, #/docs[/<path>]
+
+function parse() {
+  const raw = window.location.hash.slice(1) || '/kanban';
+  const [pathname, query = ''] = raw.split('?');
+  const parts = pathname.split('/').filter(Boolean);
+  return { pathname, parts, query };
+}
+
+export const route = $state(parse());
+
+window.addEventListener('hashchange', () => {
+  Object.assign(route, parse());
+});
+
+export function navigate(path) {
+  window.location.hash = path.startsWith('#') ? path : `#${path}`;
+}

package/cli/kanban/client/src/lib/store.svelte.js

@@ -0,0 +1,132 @@
+// Central store for the Kanban UI, backed by Svelte 5 runes.
+// Normalized caches + SSE-driven invalidation.
+
+export const store = $state({
+  stories: [],
+  epics: [],
+  sprint: null,
+  burndown: null,
+  connected: false,
+  loading: false,
+  error: null,
+  toasts: [],
+});
+
+let es = null;
+let toastSeq = 0;
+
+export function toast({ kind = 'info', message, ttl = 3500 }) {
+  const id = ++toastSeq;
+  store.toasts.push({ id, kind, message });
+  setTimeout(() => {
+    const idx = store.toasts.findIndex((t) => t.id === id);
+    if (idx >= 0) store.toasts.splice(idx, 1);
+  }, ttl);
+}
+
+export function dismissToast(id) {
+  const idx = store.toasts.findIndex((t) => t.id === id);
+  if (idx >= 0) store.toasts.splice(idx, 1);
+}
+
+async function request(url, init = {}) {
+  const res = await fetch(url, {
+    ...init,
+    headers: { 'Content-Type': 'application/json', ...(init.headers ?? {}) },
+  });
+  if (!res.ok) {
+    let body;
+    try {
+      body = await res.json();
+    } catch {
+      body = { error: res.statusText };
+    }
+    const err = new Error(body.error || `HTTP ${res.status}`);
+    err.status = res.status;
+    err.body = body;
+    throw err;
+  }
+  return res.json();
+}
+
+export async function loadStories() {
+  store.loading = true;
+  try {
+    const data = await request('/api/stories');
+    store.stories = data.stories;
+    store.epics = data.epics;
+    store.error = null;
+  } catch (err) {
+    store.error = err.message;
+    toast({ kind: 'error', message: `Failed to load stories: ${err.message}` });
+  } finally {
+    store.loading = false;
+  }
+}
+
+export async function loadSprint() {
+  try {
+    const data = await request('/api/sprints/current');
+    store.sprint = data.sprint;
+    store.burndown = data.burndown;
+  } catch (err) {
+    if (err.status !== 404) toast({ kind: 'error', message: `Sprint load failed: ${err.message}` });
+    store.sprint = null;
+    store.burndown = null;
+  }
+}
+
+export async function patchStatus(id, body) {
+  const prev = store.stories.find((s) => s.id === id);
+  if (!prev) throw new Error('story not found');
+  // Optimistic update on structural transitions (skip on blocked without reason)
+  const idx = store.stories.findIndex((s) => s.id === id);
+  const before = { ...prev };
+  store.stories[idx] = { ...prev, status: body.status };
+  try {
+    const data = await request(`/api/stories/${id}/status`, {
+      method: 'PATCH',
+      body: JSON.stringify(body),
+    });
+    store.stories[idx] = data.story;
+    toast({ kind: 'success', message: `${id} -> ${data.story.status}` });
+    return data.story;
+  } catch (err) {
+    store.stories[idx] = before;
+    const details = err.body?.missing?.length ? ` (${err.body.missing.join(', ')})` : '';
+    toast({ kind: 'error', message: `Transition failed: ${err.body?.reason ?? err.message}${details}`, ttl: 5000 });
+    throw err;
+  }
+}
+
+export function connectEvents() {
+  if (es) return;
+  es = new EventSource('/api/events');
+  es.addEventListener('open', () => {
+    store.connected = true;
+  });
+  es.addEventListener('error', () => {
+    store.connected = false;
+  });
+  es.addEventListener('story:updated', async () => {
+    await loadStories();
+  });
+  es.addEventListener('file:changed', async (e) => {
+    try {
+      const { payload } = JSON.parse(e.data);
+      if (payload?.category === 'story' || payload?.category === 'task' || payload?.category === 'epic') {
+        await loadStories();
+      }
+    } catch {
+      await loadStories();
+    }
+  });
+}
+
+export function disconnectEvents() {
+  if (es) {
+    es.close();
+    es = null;
+    store.connected = false;
+  }
+}

package/cli/kanban/client/src/main.js

@@ -0,0 +1,6 @@
+import { mount } from 'svelte';
+import App from './App.svelte';
+
+const app = mount(App, { target: document.getElementById('app') });
+
+export default app;