@thedecipherist/claude-packs 0.0.0-stage → 1.0.0

package/configurations/cpp/config.json

@@ -0,0 +1,92 @@
+{
+  "name": "cpp",
+  "description": "Any C++ project that is not a synth: universal engineering and the cpp pack, with what is repeated made one template.",
+  "packs": {
+    "always": [
+      "base",
+      "writing",
+      "hook-proof"
+    ],
+    "choose": [
+      "cpp",
+      "docker",
+      "shell-hooks",
+      "python",
+      "shell",
+      "ci",
+      "go",
+      "reverse-engineering",
+      "midi",
+      "sound-design"
+    ],
+    "default": [
+      "cpp"
+    ]
+  },
+  "layout": {
+    "folders": {
+      "docs": {
+        "path": "docs",
+        "purpose": "spec, laws, licences, work orders, decisions"
+      },
+      "src": {
+        "path": "src",
+        "purpose": "all source code, only inside the subfolders below"
+      },
+      "tests": {
+        "path": "tests",
+        "purpose": "unit tests, gates with planted faults, golden files"
+      },
+      "tools": {
+        "path": "tools",
+        "purpose": "scripts and research tooling (not shipped)"
+      }
+    },
+    "kinds": {
+      "tests": {
+        "what": "tests, gates with planted faults, golden renders",
+        "in": "tests",
+        "concepts": [
+          "tests"
+        ],
+        "files": [
+          "**/*_test.*",
+          "**/*Test.cpp",
+          "**/*Tests.cpp",
+          "**/test_*.*",
+          "**/*.test.*"
+        ]
+      },
+      "docs": {
+        "what": "the spec, laws.md, decisions, research, work orders",
+        "in": "docs",
+        "concepts": [
+          "docs-folder"
+        ],
+        "files": [
+          "**/laws.md",
+          "**/*-spec.md"
+        ]
+      },
+      "tools": {
+        "what": "scripts and research tools that never ship",
+        "in": "tools"
+      }
+    }
+  },
+  "preamble": {
+    "always": [
+      "Ask the user before inventing a new folder. A new folder goes into `.claude/layout.json` first.",
+      "When a hook, check or guard blocks work that is correct, stop and report its exact message. A blocking hook is a red check: fix the hook first, with a selftest, then continue.",
+      "When a command is refused or fails, the step fails loudly. Never report a refused write or a failed command as done.",
+      "claude-packs (`~/projects/claude-packs`) is the source of truth for every rule, check, hook and skill this project's configuration installs. A fix to one of them is made there with its test, committed, pushed and released as a new version, then taken in with `npx --no-install @thedecipherist/claude-packs update`. A project edits its installed copy only to try a fix before it goes into the kit."
+    ],
+    "never": [
+      "Create source files outside these folders, or put a kind of thing anywhere but its place. The folder-law and placement-law hooks refuse both.",
+      "Edit files in `.claude/rules`, `.claude/checks` or `.claude/hooks` to get past a block. Fix the code, or ask the user to change the law.",
+      "Route around a block: no override variables, no writing through the shell after a refusal, no parking files in a scratchpad, no putting new code into an unrelated existing file.",
+      "Point at a document by line number. Cite a fixed anchor (`{#id}`) or a symbol name; lines move."
+    ]
+  },
+  "sourceFiles": "\\.(?:c|cc|cpp|cxx|h|hh|hpp|mm)$"
+}

package/configurations/full-stack/config.json

@@ -0,0 +1,152 @@
+{
+  "name": "full-stack",
+  "description": "A web service: a Fastify API and a Next.js web app in one repo, Zod 4 schemas in one shared folder, one database gateway, one error contract.",
+  "packs": {
+    "always": [
+      "base",
+      "full-stack",
+      "http-api",
+      "fastify",
+      "zod",
+      "docker",
+      "writing",
+      "hook-proof"
+    ],
+    "choose": [
+      "js-ts",
+      "stored-text",
+      "ui-craft",
+      "shell",
+      "react",
+      "multi-tenant",
+      "websocket",
+      "ci",
+      "dynamic-data",
+      "mongo",
+      "ai",
+      "nginx",
+      "content-site"
+    ],
+    "default": [
+      "js-ts",
+      "stored-text",
+      "ui-craft"
+    ]
+  },
+  "layout": {
+    "folders": {
+      "core": {
+        "path": "packages/core/src",
+        "purpose": "shared code the API and the web app both import"
+      },
+      "schemas": {
+        "path": "packages/core/src/schemas",
+        "purpose": "every Zod 4 schema: requests, responses, records, forms, the error contract"
+      },
+      "api": {
+        "path": "api/src",
+        "purpose": "the Fastify API: buildServer(), env.ts, the error handler, plugins"
+      },
+      "routes": {
+        "path": "api/src/routes",
+        "purpose": "thin routes: method, path, schemas, one handler call"
+      },
+      "handlers": {
+        "path": "api/src/handlers",
+        "purpose": "the work of each route, through adapters"
+      },
+      "adapters": {
+        "path": "api/src/adapters",
+        "purpose": "the one database gateway and every other outside service"
+      },
+      "auth": {
+        "path": "api/src/auth",
+        "purpose": "authentication and the request's identity (the chain keys come from here)"
+      },
+      "api-tests": {
+        "path": "api/test",
+        "purpose": "API tests through inject()"
+      },
+      "channel": {
+        "path": "channel",
+        "purpose": "the Next.js web app"
+      },
+      "docs": {
+        "path": "docs",
+        "purpose": "the spec, decisions, versions.md"
+      },
+      "tools": {
+        "path": "tools",
+        "purpose": "scripts that never ship"
+      }
+    },
+    "concepts": {
+      "js": [
+        "core",
+        "api",
+        "channel",
+        "api-tests"
+      ]
+    },
+    "kinds": {
+      "schema": {
+        "what": "a Zod schema (z.object) and the error contract",
+        "in": "schemas",
+        "concepts": [
+          "schemas",
+          "env"
+        ],
+        "content": "\\bz\\.(?:object|strictObject|looseObject)\\s*\\(",
+        "extensions": [
+          ".ts",
+          ".tsx",
+          ".mts",
+          ".cts",
+          ".js",
+          ".jsx",
+          ".mjs",
+          ".cjs"
+        ]
+      },
+      "db-gateway": {
+        "what": "the database driver and its one gateway",
+        "in": "adapters",
+        "concepts": [
+          "adapters",
+          "api-tests"
+        ],
+        "content": "\\bfrom\\s+['\"](?:mongodb|pg|mysql2|mongoose|@prisma/client|drizzle-orm[^'\"]*|ioredis|redis)['\"]",
+        "extensions": [
+          ".ts",
+          ".tsx",
+          ".mts",
+          ".cts",
+          ".js",
+          ".jsx",
+          ".mjs",
+          ".cjs"
+        ]
+      },
+      "api-test": {
+        "what": "API tests (inject(), never a bound port)",
+        "in": "api-tests"
+      }
+    }
+  },
+  "sourceFiles": "\\.(?:ts|tsx|mts|cts|js|jsx|mjs|cjs)$",
+  "preamble": {
+    "always": [
+      "Ask the user before inventing a new folder. A new folder goes into `.claude/layout.json` first.",
+      "When a hook, check or guard blocks work that is correct, stop and report its exact message. A blocking hook is a red check: fix the hook first, with a selftest, then continue.",
+      "When a command is refused or fails, the step fails loudly. Never report a refused write or a failed command as done.",
+      "claude-packs (`~/projects/claude-packs`) is the source of truth for every rule, check, hook and skill this project's configuration installs. A fix to one of them is made there with its test, committed, pushed and released as a new version, then taken in with `npx --no-install @thedecipherist/claude-packs update`. A project edits its installed copy only to try a fix before it goes into the kit."
+    ],
+    "never": [
+      "Create source files outside these folders, or put a kind of thing anywhere but its place. The folder-law and placement-law hooks refuse both.",
+      "Put a database call outside the adapters, a Zod schema outside the schemas folder, or business rules in a route.",
+      "Edit files in `.claude/rules`, `.claude/checks` or `.claude/hooks` to get past a block. Fix the code, or ask the user to change the law.",
+      "Route around a block: no override variables, no writing through the shell after a refusal, no parking files in a scratchpad, no putting new code into an unrelated existing file.",
+      "Point at a document by line number. Cite a fixed anchor (`{#id}`) or a symbol name; lines move."
+    ]
+  }
+}

package/configurations/go/config.json

@@ -0,0 +1,96 @@
+{
+  "name": "go",
+  "description": "Go projects: universal engineering and the go pack.",
+  "packs": {
+    "always": [
+      "base",
+      "writing",
+      "hook-proof"
+    ],
+    "choose": [
+      "go",
+      "shell",
+      "docker",
+      "http-api",
+      "multi-tenant",
+      "websocket",
+      "host-agent",
+      "ci",
+      "js-ts",
+      "python",
+      "dynamic-data",
+      "web",
+      "ui-craft",
+      "content-site"
+    ],
+    "default": [
+      "go"
+    ]
+  },
+  "layout": {
+    "folders": {
+      "docs": {
+        "path": "docs",
+        "purpose": "spec, laws, licences, work orders, decisions"
+      },
+      "src": {
+        "path": "src",
+        "purpose": "all source code, only inside the subfolders below"
+      },
+      "tests": {
+        "path": "tests",
+        "purpose": "unit tests, gates with planted faults, golden files"
+      },
+      "tools": {
+        "path": "tools",
+        "purpose": "scripts and research tooling (not shipped)"
+      }
+    },
+    "kinds": {
+      "tests": {
+        "what": "tests, gates with planted faults, golden renders",
+        "in": "tests",
+        "concepts": [
+          "tests"
+        ],
+        "files": [
+          "**/*_test.*",
+          "**/*Test.cpp",
+          "**/*Tests.cpp",
+          "**/test_*.*",
+          "**/*.test.*"
+        ]
+      },
+      "docs": {
+        "what": "the spec, laws.md, decisions, research, work orders",
+        "in": "docs",
+        "concepts": [
+          "docs-folder"
+        ],
+        "files": [
+          "**/laws.md",
+          "**/*-spec.md"
+        ]
+      },
+      "tools": {
+        "what": "scripts and research tools that never ship",
+        "in": "tools"
+      }
+    }
+  },
+  "preamble": {
+    "always": [
+      "Ask the user before inventing a new folder. A new folder goes into `.claude/layout.json` first.",
+      "When a hook, check or guard blocks work that is correct, stop and report its exact message. A blocking hook is a red check: fix the hook first, with a selftest, then continue.",
+      "When a command is refused or fails, the step fails loudly. Never report a refused write or a failed command as done.",
+      "claude-packs (`~/projects/claude-packs`) is the source of truth for every rule, check, hook and skill this project's configuration installs. A fix to one of them is made there with its test, committed, pushed and released as a new version, then taken in with `npx --no-install @thedecipherist/claude-packs update`. A project edits its installed copy only to try a fix before it goes into the kit."
+    ],
+    "never": [
+      "Create source files outside these folders, or put a kind of thing anywhere but its place. The folder-law and placement-law hooks refuse both.",
+      "Edit files in `.claude/rules`, `.claude/checks` or `.claude/hooks` to get past a block. Fix the code, or ask the user to change the law.",
+      "Route around a block: no override variables, no writing through the shell after a refusal, no parking files in a scratchpad, no putting new code into an unrelated existing file.",
+      "Point at a document by line number. Cite a fixed anchor (`{#id}`) or a symbol name; lines move."
+    ]
+  },
+  "sourceFiles": "\\.go$"
+}

package/configurations/node/config.json

@@ -0,0 +1,100 @@
+{
+  "name": "node",
+  "description": "A Node.js or TypeScript service, web app, CLI, library, MCP server or edge proxy: base, plus the packs its stack needs (js-ts, mongo, fastify, ai, docker, shell-hooks, html-ui, web, tui, nginx). The presets pick them.",
+  "packs": {
+    "always": [
+      "base",
+      "writing",
+      "hook-proof"
+    ],
+    "choose": [
+      "js-ts",
+      "mongo",
+      "fastify",
+      "ai",
+      "docker",
+      "shell-hooks",
+      "html-ui",
+      "web",
+      "tui",
+      "nginx",
+      "stored-text",
+      "ui-craft",
+      "python",
+      "shell",
+      "cpp",
+      "http-api",
+      "react",
+      "multi-tenant",
+      "websocket",
+      "host-agent",
+      "go",
+      "ci",
+      "dynamic-data",
+      "zod",
+      "content-site"
+    ],
+    "default": [
+      "js-ts"
+    ]
+  },
+  "layout": {
+    "folders": {
+      "docs": {
+        "path": "docs",
+        "purpose": "spec, decisions, versions.md"
+      },
+      "src": {
+        "path": "src",
+        "purpose": "the code: the entry, routes, handlers, the database gateway, schemas"
+      },
+      "test": {
+        "path": "test",
+        "purpose": "tests"
+      },
+      "tools": {
+        "path": "tools",
+        "purpose": "scripts that never ship"
+      }
+    },
+    "kinds": {
+      "tests": {
+        "what": "tests",
+        "in": "test",
+        "concepts": [
+          "js-tests"
+        ],
+        "files": [
+          "**/*.test.*",
+          "**/*.spec.*"
+        ]
+      },
+      "docs": {
+        "what": "the spec, decisions, research, versions.md",
+        "in": "docs",
+        "concepts": [
+          "docs-folder"
+        ]
+      },
+      "tools": {
+        "what": "scripts that never ship",
+        "in": "tools"
+      }
+    }
+  },
+  "sourceFiles": "\\.(?:ts|tsx|mts|cts|js|jsx|mjs|cjs)$",
+  "preamble": {
+    "always": [
+      "Ask the user before inventing a new folder. A new folder goes into `.claude/layout.json` first.",
+      "When a hook, check or guard blocks work that is correct, stop and report its exact message. A blocking hook is a red check: fix the hook first, with a selftest, then continue.",
+      "When a command is refused or fails, the step fails loudly. Never report a refused write or a failed command as done.",
+      "claude-packs (`~/projects/claude-packs`) is the source of truth for every rule, check, hook and skill this project's configuration installs. A fix to one of them is made there with its test, committed, pushed and released as a new version, then taken in with `npx --no-install @thedecipherist/claude-packs update`. A project edits its installed copy only to try a fix before it goes into the kit."
+    ],
+    "never": [
+      "Create source files outside these folders, or put a kind of thing anywhere but its place. The folder-law and placement-law hooks refuse both.",
+      "Edit files in `.claude/rules`, `.claude/checks` or `.claude/hooks` to get past a block. Fix the code, or ask the user to change the law.",
+      "Route around a block: no override variables, no writing through the shell after a refusal, no parking files in a scratchpad, no putting new code into an unrelated existing file.",
+      "Point at a document by line number. Cite a fixed anchor (`{#id}`) or a symbol name; lines move."
+    ]
+  }
+}

package/configurations/python/config.json

@@ -0,0 +1,97 @@
+{
+  "name": "python",
+  "description": "Python projects: universal engineering and the python pack.",
+  "packs": {
+    "always": [
+      "base",
+      "writing",
+      "hook-proof"
+    ],
+    "choose": [
+      "python",
+      "shell",
+      "docker",
+      "ai",
+      "mongo",
+      "js-ts",
+      "cpp",
+      "http-api",
+      "multi-tenant",
+      "ci",
+      "go",
+      "dynamic-data",
+      "web",
+      "ui-craft",
+      "content-site"
+    ],
+    "default": [
+      "python"
+    ]
+  },
+  "layout": {
+    "folders": {
+      "docs": {
+        "path": "docs",
+        "purpose": "spec, laws, licences, work orders, decisions"
+      },
+      "src": {
+        "path": "src",
+        "purpose": "all source code, only inside the subfolders below"
+      },
+      "tests": {
+        "path": "tests",
+        "purpose": "unit tests, gates with planted faults, golden files"
+      },
+      "tools": {
+        "path": "tools",
+        "purpose": "scripts and research tooling (not shipped)"
+      }
+    },
+    "kinds": {
+      "tests": {
+        "what": "tests, gates with planted faults, golden renders",
+        "in": "tests",
+        "concepts": [
+          "tests"
+        ],
+        "files": [
+          "**/*_test.*",
+          "**/*Test.cpp",
+          "**/*Tests.cpp",
+          "**/test_*.*",
+          "**/*.test.*"
+        ]
+      },
+      "docs": {
+        "what": "the spec, laws.md, decisions, research, work orders",
+        "in": "docs",
+        "concepts": [
+          "docs-folder"
+        ],
+        "files": [
+          "**/laws.md",
+          "**/*-spec.md"
+        ]
+      },
+      "tools": {
+        "what": "scripts and research tools that never ship",
+        "in": "tools"
+      }
+    }
+  },
+  "preamble": {
+    "always": [
+      "Ask the user before inventing a new folder. A new folder goes into `.claude/layout.json` first.",
+      "When a hook, check or guard blocks work that is correct, stop and report its exact message. A blocking hook is a red check: fix the hook first, with a selftest, then continue.",
+      "When a command is refused or fails, the step fails loudly. Never report a refused write or a failed command as done.",
+      "claude-packs (`~/projects/claude-packs`) is the source of truth for every rule, check, hook and skill this project's configuration installs. A fix to one of them is made there with its test, committed, pushed and released as a new version, then taken in with `npx --no-install @thedecipherist/claude-packs update`. A project edits its installed copy only to try a fix before it goes into the kit."
+    ],
+    "never": [
+      "Create source files outside these folders, or put a kind of thing anywhere but its place. The folder-law and placement-law hooks refuse both.",
+      "Edit files in `.claude/rules`, `.claude/checks` or `.claude/hooks` to get past a block. Fix the code, or ask the user to change the law.",
+      "Route around a block: no override variables, no writing through the shell after a refusal, no parking files in a scratchpad, no putting new code into an unrelated existing file.",
+      "Point at a document by line number. Cite a fixed anchor (`{#id}`) or a symbol name; lines move."
+    ]
+  },
+  "sourceFiles": "\\.(?:py|pyi)$"
+}

package/configurations/synth-creator/config.json

@@ -0,0 +1,148 @@
+{
+  "name": "synth-creator",
+  "description": "JUCE synths and effects units: realtime audio, the sound engines, the Dawn GPU painter, Stellix. Everything the kit installed before configurations existed.",
+  "packs": {
+    "always": [
+      "base",
+      "synth-creator",
+      "writing",
+      "hook-proof"
+    ],
+    "choose": [
+      "cpp",
+      "audio-core",
+      "gpu-painter",
+      "stellix",
+      "python",
+      "shell",
+      "ci",
+      "reverse-engineering",
+      "midi",
+      "sound-design",
+      "instrument-shell"
+    ],
+    "default": [
+      "cpp",
+      "audio-core"
+    ]
+  },
+  "layout": {
+    "folders": {
+      "docs": {
+        "path": "docs",
+        "purpose": "spec, laws, licences, work orders, decisions"
+      },
+      "src": {
+        "path": "src",
+        "purpose": "all source code, only inside the subfolders below"
+      },
+      "tests": {
+        "path": "tests",
+        "purpose": "unit tests, gates with planted faults, golden files"
+      },
+      "tools": {
+        "path": "tools",
+        "purpose": "scripts and research tooling (not shipped)"
+      }
+    },
+    "kinds": {
+      "tests": {
+        "what": "tests, gates with planted faults, golden renders",
+        "in": "tests",
+        "concepts": [
+          "tests"
+        ],
+        "files": [
+          "**/*_test.*",
+          "**/*Test.cpp",
+          "**/*Tests.cpp",
+          "**/test_*.*",
+          "**/*.test.*"
+        ]
+      },
+      "docs": {
+        "what": "the spec, laws.md, decisions, research, work orders",
+        "in": "docs",
+        "concepts": [
+          "docs-folder"
+        ],
+        "files": [
+          "**/laws.md",
+          "**/*-spec.md"
+        ]
+      },
+      "tools": {
+        "what": "scripts and research tools that never ship",
+        "in": "tools"
+      }
+    }
+  },
+  "hookOrder": {
+    "PreToolUse Write|Edit|MultiEdit|NotebookEdit|Bash": [
+      "lesson-checks.mjs",
+      "file-size-guard.mjs",
+      "frozen-files.mjs",
+      "placement-law.mjs",
+      "protect-vendor.mjs",
+      "spec-lock.mjs",
+      "folder-law.mjs",
+      "shape-law.mjs",
+      "brief-guard.mjs",
+      "once-only.mjs",
+      "secrets-guard.mjs",
+      "untrusted-boundary.mjs",
+      "realtime-guard.mjs",
+      "browser-guard.py",
+      "no-shipped-images.mjs"
+    ],
+    "PreToolUse Agent|Task": [
+      "brief-guard.mjs"
+    ],
+    "PreToolUse Bash": [
+      "stage-guard.mjs",
+      "git-guard.mjs",
+      "build-guard.mjs"
+    ],
+    "PreToolUse *": [
+      "time-guard.mjs"
+    ],
+    "PostToolUse *": [
+      "time-guard.mjs"
+    ],
+    "Stop": [
+      "idle-wake.mjs",
+      "making-check.mjs",
+      "git-guard.mjs"
+    ],
+    "SessionStart compact": [
+      "user-asks.mjs"
+    ],
+    "SessionStart": [
+      "build-sweep.mjs"
+    ],
+    "SubagentStop": [
+      "build-sweep.mjs"
+    ],
+    "UserPromptSubmit": [
+      "making.mjs"
+    ],
+    "PostToolUse Write|Edit|MultiEdit|NotebookEdit|Bash": [
+      "param-id-lock.mjs"
+    ]
+  },
+  "preamble": {
+    "always": [
+      "Ask the user before inventing a new folder. A new folder goes into `.claude/layout.json` first.",
+      "When a hook, check or guard blocks work that is correct, stop and report its exact message. A blocking hook is a red check: fix the hook first, with a selftest, then continue.",
+      "When a command is refused or fails, the step fails loudly. Never report a refused write or a failed command as done.",
+      "claude-packs (`~/projects/claude-packs`) is the source of truth for every rule, check, hook and skill used to build synths. A fix to one of them, or a lesson that should hold in every synth, is made there with its test, committed, pushed and released as a new version, then taken in with `npx --no-install @thedecipherist/claude-packs update`, so every synth gets it. A project edits its installed copy only to try a fix before it goes into the kit."
+    ],
+    "never": [
+      "Create source files outside these folders, or put a kind of thing anywhere but its place. The folder-law and placement-law hooks refuse both.",
+      "Put drawing code in audio or world folders, or audio and world logic in the painter or UI folders.",
+      "Edit files in `.claude/rules`, `.claude/checks` or `.claude/hooks` to get past a block. Fix the code, or ask the user to change the law.",
+      "Route around a block: no override variables, no writing through the shell after a refusal, no parking files in a scratchpad, no putting new code into an unrelated existing file.",
+      "Point at a document by line number. Cite a fixed anchor (`{#id}`) or a symbol name; lines move."
+    ]
+  }
+}