@negikirin/repo-pattern 0.1.1

package/.claude/CLAUDE.md

@@ -0,0 +1,61 @@
+# CLAUDE.md
+
+Behavioral guidelines to reduce common LLM coding mistakes. Merge with project-specific instructions as needed.
+
+**Tradeoff:** These guidelines bias toward caution over speed. For trivial tasks, use judgment.
+
+## 1. Think Before Coding
+
+**Don't assume. Don't hide confusion. Surface tradeoffs.**
+
+Before implementing:
+- State your assumptions explicitly. If uncertain, ask.
+- If multiple interpretations exist, present them - don't pick silently.
+- If a simpler approach exists, say so. Push back when warranted.
+- If something is unclear, stop. Name what's confusing. Ask.
+
+## 2. Simplicity First
+
+**Minimum code that solves the problem. Nothing speculative.**
+
+- No features beyond what was asked.
+- No abstractions for single-use code.
+- No "flexibility" or "configurability" that wasn't requested.
+- No error handling for impossible scenarios.
+- If you write 200 lines and it could be 50, rewrite it.
+
+Ask yourself: "Would a senior engineer say this is overcomplicated?" If yes, simplify.
+
+## 3. Surgical Changes
+
+**Touch only what you must. Clean up only your own mess.**
+
+When editing existing code:
+- Don't "improve" adjacent code, comments, or formatting.
+- Don't refactor things that aren't broken.
+- Match existing style, even if you'd do it differently.
+- If you notice unrelated dead code, mention it - don't delete it.
+
+When your changes create orphans:
+- Remove imports/variables/functions that YOUR changes made unused.
+- Don't remove pre-existing dead code unless asked.
+
+The test: Every changed line should trace directly to the user's request.
+
+## 4. Goal-Driven Execution
+
+**Define success criteria. Loop until verified.**
+
+Transform tasks into verifiable goals:
+- "Add validation" → "Write tests for invalid inputs, then make them pass"
+- "Fix the bug" → "Write a test that reproduces it, then make it pass"
+- "Refactor X" → "Ensure tests pass before and after"
+
+For multi-step tasks, state a brief plan:
+```
+1. [Step] → verify: [check]
+2. [Step] → verify: [check]
+3. [Step] → verify: [check]
+```
+
+Strong success criteria let you loop independently. Weak criteria ("make it work") require constant clarification.

package/.claude/settings.example.json

@@ -0,0 +1,40 @@
+{
+  "$schema": "https://json.schemastore.org/claude-code-settings.json",
+  "hooks": {},
+  "attribution": {
+    "commit": ""
+  },
+  "permissions": {
+    "deny": [
+      "Read(.env)",
+      "Read(.env.*)",
+      "Read(**/.env)",
+      "Read(**/.env.*)",
+      "Read(secrets/**)",
+      "Read(private/**)",
+      "Read(**/*.pem)",
+      "Read(**/*.key)",
+      "Read(**/id_rsa)",
+      "Read(**/id_ed25519)",
+      "Read(~/.ssh/**)",
+      "Read(~/.aws/**)",
+      "Read(~/.config/gcloud/**)",
+      "Bash(rm -rf /)",
+      "Bash(rm -rf ~)"
+    ],
+    "ask": [
+      "Bash(git push *)",
+      "Bash(git reset *)",
+      "Bash(git clean *)",
+      "Bash(rm *)",
+      "Bash(sudo *)",
+      "Bash(chmod *)",
+      "Bash(chown *)"
+    ],
+    "defaultMode": "default",
+    "disableBypassPermissionsMode": "disable"
+  },
+  "enabledMcpjsonServers": [],
+  "respectGitignore": true,
+  "autoUpdatesChannel": "stable"
+}

package/.claude/settings.local.example.json

@@ -0,0 +1,24 @@
+{
+  "$schema": "https://json.schemastore.org/claude-code-settings.json",
+  "model": "opus",
+  "fallbackModel": ["sonnet", "haiku"],
+  "effortLevel": "high",
+  "alwaysThinkingEnabled": true,
+  "autoCompactEnabled": true,
+  "autoCompactWindow": 180000,
+  "preferredNotifChannel": "terminal_bell",
+  "showTurnDuration": true,
+  "spinnerTipsEnabled": true,
+  "fileCheckpointingEnabled": true,
+  "env": {
+    "ENABLE_TOOL_SEARCH": "auto:5",
+    "ANTHROPIC_BASE_URL": "https://example.com/v1",
+    "ANTHROPIC_AUTH_TOKEN": "replace-with-your-token-in-settings.local.json",
+    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-8",
+    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-6",
+    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5",
+    "API_TIMEOUT_MS": "300000",
+    "BASH_DEFAULT_TIMEOUT_MS": "300000",
+    "MCP_TOOL_TIMEOUT": "600000"
+  }
+}

package/.github/workflows/nodejs-package.yml

@@ -0,0 +1,60 @@
+# This workflow runs tests and publishes this package to npmjs
+# when a GitHub Release is created.
+
+name: Node.js Package
+
+on:
+  release:
+    types: [created]
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run tests
+        run: npm test
+
+      - name: Verify package contents
+        run: npm pack --dry-run
+
+  publish-npm:
+    needs: build
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js for npmjs
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          registry-url: https://registry.npmjs.org/
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Verify package contents
+        run: npm pack --dry-run
+
+      - name: Publish to npmjs
+        run: npm publish
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

package/.repo-pattern.json

@@ -0,0 +1,25 @@
+{
+  "version": "2.0.0",
+  "workflow": "ecc-native",
+  "mode": "template",
+  "runtime": {
+    "localSkills": false,
+    "localCommands": false,
+    "localHooks": false,
+    "localScripts": false,
+    "localRules": false,
+    "vendoredEccRules": false
+  },
+  "ecc": {
+    "installMode": "plugin",
+    "rulesSync": "repo-pattern-auto-cache",
+    "hooks": "plugin-managed",
+    "copyRuntimeSurfaces": false,
+    "rulesProfile": "auto",
+    "rulesScope": "project"
+  },
+  "mcp": {
+    "profile": "web",
+    "generated": true
+  }
+}

package/.repo-pattern.lock.json

@@ -0,0 +1,23 @@
+{
+  "repoPattern": {
+    "version": "2.0.0",
+    "lastProvisionRun": null,
+    "lastDoctorRun": null
+  },
+  "ecc": {
+    "installMode": "plugin",
+    "status": "not-run",
+    "rulesSyncedBy": "repo-pattern-auto-cache",
+    "hooks": "plugin-managed",
+    "syncedAt": null,
+    "rulesScope": "project",
+    "recommendedRules": [],
+    "appliedRules": [],
+    "detectedStack": null,
+    "rulesAppliedAt": null
+  },
+  "mcp": {
+    "profile": "web",
+    "generatedAt": "2026-06-23T01:58:20.499Z"
+  }
+}

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 NegiKirin
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,145 @@
+# repo-pattern
+
+<p align="center">
+  <img alt="Repo Pattern" src="https://img.shields.io/badge/repo--pattern-ECC--first-blue">
+  <img alt="Claude Code" src="https://img.shields.io/badge/Claude%20Code-ready-black">
+  <img alt="MCP Profiles" src="https://img.shields.io/badge/MCP-profiles-green">
+  <img alt="License" src="https://img.shields.io/badge/license-MIT-lightgrey">
+</p>
+
+**A clean Claude Code setup and migrator in one command.**
+
+`repo-pattern` initializes or migrates a project into an ECC-first (Everything Claude Code) workspace with safe defaults, MCP profiles, and zero vendored runtime clutter.
+
+## Why use it?
+
+- **Start fast** — generate `.claude/`, `.mcp.json`, and repo-pattern metadata.
+- **Stay clean** — no local skills, commands, hooks, scripts, or duplicated templates by default.
+- **Use MCP profiles** — choose `minimal`, `web`, `backend`, `research`, `full`, or `custom`.
+- **ECC-first** — `setup` runs or attempts Everything Claude Code setup automatically.
+- **Migrate safely** — audit, cleanup, doctor, and `setup --migrate` are built in.
+
+## Install
+
+Use directly with `npx`:
+
+```bash
+npx @negikirin/repo-pattern setup --profile web --yes
+```
+
+Or install the CLI:
+
+```bash
+npm install -g @negikirin/repo-pattern
+repo-pattern setup --profile web --yes
+```
+
+By default, commands target the current directory. To work on another project, add `--target /path/to/project`.
+
+## Quick start
+
+Interactive setup:
+
+```bash
+repo-pattern setup
+```
+
+Scriptable setup:
+
+```bash
+repo-pattern setup --profile web --yes
+```
+
+Migrate an existing project:
+
+```bash
+repo-pattern audit
+repo-pattern setup --profile web --migrate --yes
+repo-pattern doctor
+```
+
+## Commands
+
+| Command | Purpose |
+| --- | --- |
+| `repo-pattern help` | Show CLI help. |
+| `repo-pattern setup` | Initialize or migrate a Claude Code setup. |
+| `repo-pattern audit` | Inspect current Claude Code/ECC state. |
+| `repo-pattern doctor` | Validate the generated setup. |
+| `repo-pattern mcp --profile web` | Regenerate `.mcp.json` from an MCP profile. |
+| `repo-pattern rules` | Apply or refresh project-local ECC rules. |
+| `repo-pattern cleanup` | Archive old local Claude runtime surfaces. |
+| `repo-pattern ecc` | Run or attempt ECC setup manually. |
+
+Common options:
+
+```bash
+--target /path/to/project  # default: current directory
+--profile web              # default MCP profile
+--with-rules               # opt in to .claude/rules/ecc
+--with-skill ui-ux-pro-max # optional UI/UX skill; requires Python 3.x
+--with-skills impeccable,huashu-design # optional design QA/media skills
+--migrate                  # take over legacy/local Claude runtime surfaces
+--dry-run                  # preview mutating commands
+--yes                      # non-interactive setup
+```
+
+## MCP profiles
+
+| Profile | Use when |
+| --- | --- |
+| `minimal` | You want only essential docs/filesystem tooling. |
+| `web` | You build web apps and want browser/docs helpers. |
+| `backend` | You focus on server-side projects. |
+| `research` | You need search and extraction tooling. |
+| `full` | You want every bundled MCP server enabled. |
+| `custom` | You want to choose exact MCP servers interactively; not available with `--yes`. |
+
+When selected, Context7 and Tavily prompts include dashboard links for getting API keys.
+
+## What it creates
+
+```text
+target-project/
+├── CLAUDE.md                     # created empty if missing
+├── .claude/
+│   ├── CLAUDE.md
+│   ├── settings.json             # copied from example, gitignored
+│   └── settings.local.json       # when local settings are provided, gitignored
+├── .mcp.json                     # generated, gitignored
+├── .repo-pattern.json
+└── .repo-pattern.lock.json
+```
+
+`repo-pattern` preserves an existing root `CLAUDE.md` and keeps machine-local values out of git.
+
+## Safety defaults
+
+- `.mcp.json` is gitignored because it may contain local values.
+- `.claude/settings.local.json` is gitignored.
+- `.claude/settings.json` keeps `hooks: {}` and disables commit attribution by default; interactive setup can turn it on or use a custom trailer.
+- No vendored ECC skills, commands, hooks, scripts, or rules are installed unless explicitly requested.
+- Karpathy-inspired Claude Code guidelines are included in `.claude/CLAUDE.md` from `multica-ai/andrej-karpathy-skills` (MIT).
+- Optional external skills are user opt-in only: `--with-skill taste`, `--with-skill document-specialist`, `--with-skill ui-ux-pro-max`, `--with-skill impeccable`, `--with-skill huashu-design`, or interactive setup.
+
+## External guidance and skills
+
+| Name | Integrated as | Source | License |
+| --- | --- | --- | --- |
+| `karpathy-guidelines` | Built-in `.claude/CLAUDE.md` guidance | https://github.com/multica-ai/andrej-karpathy-skills | MIT |
+| `taste` | Optional `.claude/skills/` install via `--with-skill taste` | https://github.com/Leonxlnx/taste-skill/ | MIT |
+| `document-specialist` | Optional `.claude/skills/` install via `--with-skill document-specialist` | https://github.com/SpillwaveSolutions/document-specialist-skill/ | NOASSERTION — no upstream license declared during review on 2026-07-06 |
+| `ui-ux-pro-max` | Optional `.claude/skills/` install via `--with-skill ui-ux-pro-max` (requires Python 3.x) | https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/ | MIT |
+| `impeccable` | Optional `.claude/skills/` skill-only install via `--with-skill impeccable` (scripts require Node >=24) | https://github.com/pbakaus/impeccable/ | Apache-2.0 |
+| `huashu-design` | Optional `.claude/skills/` install via `--with-skill huashu-design` (multimedia scripts may need Playwright/Python/ffmpeg; install can take ~10 minutes, so opt in deliberately) | https://github.com/alchaincyf/huashu-design/ | MIT |
+
+## Learn more
+
+Full setup details live in [docs/repo-pattern/setup-guide.md](docs/repo-pattern/setup-guide.md).
+Third-party license notices are listed in [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md).
+
+From a source checkout, replace `repo-pattern` with:
+
+```bash
+node scripts/repo-pattern.mjs
+```

package/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,51 @@
+# Third-party notices
+
+## ECC
+
+repo-pattern integrates with ECC (Everything Claude Code) by referencing the official ECC plugin and, when explicitly requested by the user, syncing ECC rule packs from the upstream repository.
+
+Source: https://github.com/affaan-m/ECC  
+License: MIT  
+Copyright (c) 2026 Affaan Mustafa
+
+repo-pattern does not vendor ECC skills, commands, hooks, scripts, or runtime surfaces by default.
+
+## Karpathy-inspired guidelines
+
+repo-pattern includes Claude Code behavioral guidelines from `multica-ai/andrej-karpathy-skills` in `.claude/CLAUDE.md`.
+
+- Source: https://github.com/multica-ai/andrej-karpathy-skills
+- License: MIT
+
+## Optional external skills
+
+Optional skills are not bundled with repo-pattern. When explicitly selected by the user, repo-pattern downloads them from their upstream repositories into the target project's `.claude/skills/` directory.
+
+### taste-skill
+
+- Source: https://github.com/Leonxlnx/taste-skill/
+- License: MIT
+- Copyright (c) 2026 Leonxlnx
+
+### document-specialist-skill
+
+- Source: https://github.com/SpillwaveSolutions/document-specialist-skill/
+- License: NOASSERTION — no license was declared in the visible repository metadata during review on 2026-07-06. Use only when you accept that upstream source.
+
+### ui-ux-pro-max
+
+- Source: https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/
+- License: MIT
+- Copyright (c) 2024 Next Level Builder
+
+### impeccable
+
+- Source: https://github.com/pbakaus/impeccable/
+- License: Apache-2.0
+- Copyright 2025 Paul Bakaus
+
+### huashu-design
+
+- Source: https://github.com/alchaincyf/huashu-design/
+- License: MIT
+- Copyright (c) 2026 alchaincyf (花叔 · 花生)