blamcode 0.4.0__tar.gz

blamcode-0.4.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 zyvo9
+
+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.

blamcode-0.4.0/PKG-INFO

@@ -0,0 +1,62 @@
+Metadata-Version: 2.4
+Name: blamcode
+Version: 0.4.0
+Summary: BLAMCODE — AI coding CLI for Termux. Your app, BLAM, done!
+Author: zyvo9
+License: MIT
+Keywords: ai,cli,terminal,termux,coding-agent,android
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Operating System :: MacOS
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Software Development
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# BLAMCODE
+
+**Your app, BLAM, done!** — AI coding CLI for Termux.
+
+## Install
+
+**Termux (Android):**
+```bash
+curl -fsSL https://raw.githubusercontent.com/zyvo9/blamcode/main/install.sh | bash
+```
+
+**PyPI (any platform):**
+```bash
+pip install blamcode
+```
+
+Then run:
+```bash
+blamcode
+```
+
+## Features
+
+- **Zero config** — installs and works in one command, free AI models included
+- **Native Android** — built for Termux, ARM64, no root, no proot
+- **Talks plainly** — describe what you want in plain words, it builds the whole thing
+- **Builds complete projects** — websites, apps, bots, scripts — end to end
+- **Sees images and videos** — drop a screenshot or clip, it understands it
+- **Live preview** — `blamcode preview` opens your site on the phone with a public link
+- **Projects stay separate** — `blamcode <name>` gives each idea its own folder and chat history
+- **Ask mode** — `/ask` makes the AI check in with you before every big step
+
+## Daily commands
+
+| Command | What it does |
+|---|---|
+| `blamcode` | start (opens your `default/` project) |
+| `blamcode coffee-shop` | open/create a project folder |
+| `blamcode session` | list projects |
+| `blamcode preview` | local + public live preview |
+| `blamcode update` | delta update (0 MB if the core is unchanged) |
+| `blamcode doctor` | health check |
+| `blamcode uninstall` | remove (keeps your projects) |

blamcode-0.4.0/README.md

@@ -0,0 +1,43 @@
+# BLAMCODE
+
+**Your app, BLAM, done!** — AI coding CLI for Termux.
+
+## Install
+
+**Termux (Android):**
+```bash
+curl -fsSL https://raw.githubusercontent.com/zyvo9/blamcode/main/install.sh | bash
+```
+
+**PyPI (any platform):**
+```bash
+pip install blamcode
+```
+
+Then run:
+```bash
+blamcode
+```
+
+## Features
+
+- **Zero config** — installs and works in one command, free AI models included
+- **Native Android** — built for Termux, ARM64, no root, no proot
+- **Talks plainly** — describe what you want in plain words, it builds the whole thing
+- **Builds complete projects** — websites, apps, bots, scripts — end to end
+- **Sees images and videos** — drop a screenshot or clip, it understands it
+- **Live preview** — `blamcode preview` opens your site on the phone with a public link
+- **Projects stay separate** — `blamcode <name>` gives each idea its own folder and chat history
+- **Ask mode** — `/ask` makes the AI check in with you before every big step
+
+## Daily commands
+
+| Command | What it does |
+|---|---|
+| `blamcode` | start (opens your `default/` project) |
+| `blamcode coffee-shop` | open/create a project folder |
+| `blamcode session` | list projects |
+| `blamcode preview` | local + public live preview |
+| `blamcode update` | delta update (0 MB if the core is unchanged) |
+| `blamcode doctor` | health check |
+| `blamcode uninstall` | remove (keeps your projects) |

blamcode-0.4.0/blamcode.egg-info/PKG-INFO

@@ -0,0 +1,62 @@
+Metadata-Version: 2.4
+Name: blamcode
+Version: 0.4.0
+Summary: BLAMCODE — AI coding CLI for Termux. Your app, BLAM, done!
+Author: zyvo9
+License: MIT
+Keywords: ai,cli,terminal,termux,coding-agent,android
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Operating System :: MacOS
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Software Development
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# BLAMCODE
+
+**Your app, BLAM, done!** — AI coding CLI for Termux.
+
+## Install
+
+**Termux (Android):**
+```bash
+curl -fsSL https://raw.githubusercontent.com/zyvo9/blamcode/main/install.sh | bash
+```
+
+**PyPI (any platform):**
+```bash
+pip install blamcode
+```
+
+Then run:
+```bash
+blamcode
+```
+
+## Features
+
+- **Zero config** — installs and works in one command, free AI models included
+- **Native Android** — built for Termux, ARM64, no root, no proot
+- **Talks plainly** — describe what you want in plain words, it builds the whole thing
+- **Builds complete projects** — websites, apps, bots, scripts — end to end
+- **Sees images and videos** — drop a screenshot or clip, it understands it
+- **Live preview** — `blamcode preview` opens your site on the phone with a public link
+- **Projects stay separate** — `blamcode <name>` gives each idea its own folder and chat history
+- **Ask mode** — `/ask` makes the AI check in with you before every big step
+
+## Daily commands
+
+| Command | What it does |
+|---|---|
+| `blamcode` | start (opens your `default/` project) |
+| `blamcode coffee-shop` | open/create a project folder |
+| `blamcode session` | list projects |
+| `blamcode preview` | local + public live preview |
+| `blamcode update` | delta update (0 MB if the core is unchanged) |
+| `blamcode doctor` | health check |
+| `blamcode uninstall` | remove (keeps your projects) |

blamcode-0.4.0/blamcode.egg-info/SOURCES.txt

@@ -0,0 +1,60 @@
+LICENSE
+README.md
+pyproject.toml
+blamcode.egg-info/PKG-INFO
+blamcode.egg-info/SOURCES.txt
+blamcode.egg-info/dependency_links.txt
+blamcode.egg-info/entry_points.txt
+blamcode.egg-info/top_level.txt
+python/blamcode/__init__.py
+python/blamcode/cli.py
+python/blamcode/layer/README.md
+python/blamcode/layer/install.sh
+python/blamcode/layer/config/opencode.json
+python/blamcode/layer/config/tui.json
+python/blamcode/layer/config/agent/build.md
+python/blamcode/layer/config/agent/debugger.md
+python/blamcode/layer/config/agent/designer.md
+python/blamcode/layer/config/agent/vision.md
+python/blamcode/layer/config/agent/writer.md
+python/blamcode/layer/config/command/ask.md
+python/blamcode/layer/config/command/blam.md
+python/blamcode/layer/config/command/explore.md
+python/blamcode/layer/config/command/fix.md
+python/blamcode/layer/config/command/open.md
+python/blamcode/layer/config/command/review.md
+python/blamcode/layer/config/themes/bangladeshi.json
+python/blamcode/layer/config/themes/blamcode.json
+python/blamcode/layer/scripts/blamcode
+python/blamcode/layer/scripts/blamcode-browser
+python/blamcode/layer/scripts/blamcode-menu
+python/blamcode/layer/scripts/blamcode-uninstall
+python/blamcode/layer/scripts/blamcode-vision
+python/blamcode/layer/scripts/oc-settings.sh
+python/blamcode/layer/scripts/patch-brand.py
+python/blamcode/layer/scripts/__pycache__/patch-brand.cpython-312.pyc
+python/blamcode/layer/skills/android-app/SKILL.md
+python/blamcode/layer/skills/api-integration/SKILL.md
+python/blamcode/layer/skills/bash-cli-expert/SKILL.md
+python/blamcode/layer/skills/bot-development/SKILL.md
+python/blamcode/layer/skills/clean-code-performance/SKILL.md
+python/blamcode/layer/skills/database/SKILL.md
+python/blamcode/layer/skills/debugging-fixes/SKILL.md
+python/blamcode/layer/skills/deploy-hosting/SKILL.md
+python/blamcode/layer/skills/docker/SKILL.md
+python/blamcode/layer/skills/firebase-supabase/SKILL.md
+python/blamcode/layer/skills/git-workflow/SKILL.md
+python/blamcode/layer/skills/lets-scroll/SKILL.md
+python/blamcode/layer/skills/lets-scroll/references/index-template.html
+python/blamcode/layer/skills/lets-scroll/references/knockout.py
+python/blamcode/layer/skills/lets-scroll/references/pipeline.md
+python/blamcode/layer/skills/lets-scroll/references/prompts.md
+python/blamcode/layer/skills/lets-scroll/references/scrub-engine.js
+python/blamcode/layer/skills/project-structure/SKILL.md
+python/blamcode/layer/skills/python-automation/SKILL.md
+python/blamcode/layer/skills/react-next-best-practices/SKILL.md
+python/blamcode/layer/skills/security-review/SKILL.md
+python/blamcode/layer/skills/seo-basics/SKILL.md
+python/blamcode/layer/skills/testing/SKILL.md
+python/blamcode/layer/skills/ui-ux-responsive/SKILL.md
+python/blamcode/layer/skills/website-builder/SKILL.md

blamcode-0.4.0/blamcode.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

blamcode-0.4.0/blamcode.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+blamcode-boot = blamcode.cli:main

blamcode-0.4.0/blamcode.egg-info/top_level.txt

@@ -0,0 +1 @@
+blamcode

blamcode-0.4.0/pyproject.toml

@@ -0,0 +1,35 @@
+[build-system]
+requires = ["setuptools>=61"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "blamcode"
+version = "0.4.0"
+description = "BLAMCODE — AI coding CLI for Termux. Your app, BLAM, done!"
+readme = "README.md"
+requires-python = ">=3.8"
+license = { text = "MIT" }
+authors = [{ name = "zyvo9" }]
+keywords = ["ai", "cli", "terminal", "termux", "coding-agent", "android"]
+classifiers = [
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: POSIX :: Linux",
+    "Operating System :: MacOS",
+    "Programming Language :: Python :: 3",
+    "Topic :: Software Development",
+]
+dependencies = []
+
+[project.scripts]
+blamcode-boot = "blamcode.cli:main"
+
+[tool.setuptools]
+packages = ["blamcode"]
+
+[tool.setuptools.package-dir]
+blamcode = "python/blamcode"
+
+[tool.setuptools.package-data]
+blamcode = ["layer/**/*"]

blamcode-0.4.0/python/blamcode/__init__.py

@@ -0,0 +1,9 @@
+"""BLAMCODE — ready-to-use AI coding CLI (OpenCode) for Termux.
+
+This pip package bundles the full BLAMCODE layer (scripts + config +
+skills + installer). Running `blamcode` unpacks the layer locally and
+hands over to the real installer (install.sh) which does everything
+else (core engine, deps, single-line live progress).
+"""
+
+__version__ = "0.3.1"

blamcode-0.4.0/python/blamcode/cli.py

@@ -0,0 +1,122 @@
+"""blamcode — command-line bootstrap for installing BLAMCODE from PyPI.
+
+`pip install blamcode` gives you the `blamcode-boot` command (the name is
+deliberately NOT `blamcode`: on Termux pip writes scripts to $PREFIX/bin,
+where the real installer also puts its `blamcode` wrapper — an alias would
+collide with it). Running it installs the BLAMCODE layer (scripts + config +
+skills + installer) from the wheel's own bundled copy — no network fetch
+for the layer — then hands over to the real installer, which downloads
+the core engine with a single live progress line.
+
+Design: the pip package bundles the layer and acts as the launcher;
+all real logic lives in install.sh, so curl-install and pip-install
+behave identically (pip just skips the layer download).
+"""
+
+import argparse
+import os
+import shutil
+import subprocess
+import sys
+
+from . import __version__
+
+# bundled layer lives inside the installed package (setuptools package-data)
+_LAYER_SRC = os.path.join(os.path.dirname(__file__), "layer")
+BOOT_DIR = os.path.join(os.path.expanduser("~"), ".local", "blamcode", "boot")
+
+
+def _extract_layer(dest):
+    """Copy the bundled layer into dest (keeps file modes via copytree)."""
+    os.makedirs(dest, exist_ok=True)
+    for entry in os.listdir(_LAYER_SRC):
+        src = os.path.join(_LAYER_SRC, entry)
+        shutil.copy2(src, dest, follow_symlinks=True) if os.path.isfile(src) else shutil.copytree(
+            src, os.path.join(dest, entry), dirs_exist_ok=True
+        )
+
+
+def _jump_to_installer(boot):
+    """Run the real installer with the boot layer as the layer source."""
+    installer = os.path.join(boot, "install.sh")
+    if not os.path.isfile(installer):
+        sys.exit(
+            "error: boot layer is incomplete (missing install.sh);\n"
+            "       rerun:  blamcode-boot install"
+        )
+    if not os.access(installer, os.X_OK):
+        os.chmod(installer, 0o755)
+    # prefer bash when available (install.sh animates; POSIX sh works too)
+    shell = "bash" if shutil.which("bash") else "sh"
+    env = dict(os.environ, BLAMCODE_BOOT=boot)
+    print("\nblamcode: layer ready — starting the core installer…\n")
+    sys.exit(subprocess.call([shell, installer], env=env))
+
+
+def _configure_rc():
+    """Make sure the shell rc points at the boot scripts dir."""
+    rc = os.path.join(os.path.expanduser("~"), ".bashrc")
+    if not os.path.exists(rc):
+        return
+    with open(rc, "r", encoding="utf-8", errors="ignore") as f:
+        content = f.read()
+    marker = "# BLAMCODE PATH"
+    if marker in content:
+        return
+    boot_bin = os.path.join(BOOT_DIR, "scripts")
+    with open(rc, "a", encoding="utf-8") as f:
+        f.write('\n# BLAMCODE PATH\ncase ":$PATH:" in *":{}:"*) ;; *) export PATH="{}:$PATH";; esac\n'.format(
+            boot_bin, boot_bin
+        ))
+    print("blamcode: added BLAMCODE PATH to {}".format(rc))
+
+
+def cmd_install(args):
+    # always refresh: a stale boot layer (older install.sh) must never
+    # survive an upgrade — wipe and re-extract every run (180KB, instant)
+    if os.path.isfile(os.path.join(BOOT_DIR, "install.sh")):
+        print("blamcode: refreshing layer ({} → {})".format("old", __version__))
+    shutil.rmtree(BOOT_DIR, ignore_errors=True)
+    print("blamcode: writing layer to {}".format(BOOT_DIR))
+    _extract_layer(BOOT_DIR)
+    _configure_rc()
+    _jump_to_installer(BOOT_DIR)
+    return 0
+
+
+def cmd_uninstall(args):
+    if os.path.isdir(BOOT_DIR):
+        shutil.rmtree(BOOT_DIR)
+        print("blamcode: removed layer {}".format(BOOT_DIR))
+    else:
+        print("blamcode: no layer found at {}".format(BOOT_DIR))
+    print("blamcode: done — your projects and files were left untouched")
+    return 0
+
+
+def cmd_version(args):
+    print("blamcode-bootstrap {}".format(__version__))
+    return 0
+
+
+def main(argv=None):
+    parser = argparse.ArgumentParser(
+        prog="blamcode",
+        description="Install BLAMCODE (AI coding CLI for Termux).",
+    )
+    sub = parser.add_subparsers(dest="command")
+    sub.add_parser("install", help="install the BLAMCODE layer + core engine")
+    sub.add_parser("uninstall", help="remove the downloaded layer only")
+    sub.add_parser("version", help="print the bootstrap version")
+    args = parser.parse_args(argv)
+
+    if args.command == "uninstall":
+        return cmd_uninstall(args)
+    if args.command == "version":
+        return cmd_version(args)
+    # default (no command, or "install") → full install
+    return cmd_install(args)
+
+
+if __name__ == "__main__":
+    sys.exit(main())

blamcode-0.4.0/python/blamcode/layer/README.md

@@ -0,0 +1,43 @@
+# BLAMCODE
+
+**Your app, BLAM, done!** — AI coding CLI for Termux.
+
+## Install
+
+**Termux (Android):**
+```bash
+curl -fsSL https://raw.githubusercontent.com/zyvo9/blamcode/main/install.sh | bash
+```
+
+**PyPI (any platform):**
+```bash
+pip install blamcode
+```
+
+Then run:
+```bash
+blamcode
+```
+
+## Features
+
+- **Zero config** — installs and works in one command, free AI models included
+- **Native Android** — built for Termux, ARM64, no root, no proot
+- **Talks plainly** — describe what you want in plain words, it builds the whole thing
+- **Builds complete projects** — websites, apps, bots, scripts — end to end
+- **Sees images and videos** — drop a screenshot or clip, it understands it
+- **Live preview** — `blamcode preview` opens your site on the phone with a public link
+- **Projects stay separate** — `blamcode <name>` gives each idea its own folder and chat history
+- **Ask mode** — `/ask` makes the AI check in with you before every big step
+
+## Daily commands
+
+| Command | What it does |
+|---|---|
+| `blamcode` | start (opens your `default/` project) |
+| `blamcode coffee-shop` | open/create a project folder |
+| `blamcode session` | list projects |
+| `blamcode preview` | local + public live preview |
+| `blamcode update` | delta update (0 MB if the core is unchanged) |
+| `blamcode doctor` | health check |
+| `blamcode uninstall` | remove (keeps your projects) |

blamcode-0.4.0/python/blamcode/layer/config/agent/build.md

@@ -0,0 +1,118 @@
+---
+description: BLAMCODE full-power build agent — plan, execute, verify, finish. The default agent for all work.
+mode: primary
+temperature: 0.5
+---
+
+You are BLAMCODE's FULL-POWER build agent. Users are mostly beginners, often
+working from a phone (Termux). Work at maximum capability — never lazy,
+never half-done.
+
+## Communication
+- Talk in clear, simple English
+- Before starting non-trivial work: state the plan in 2-3 lines
+- After finishing: short summary — what was built, where it is, how to run
+  or view it. One line.
+
+## YOLO mode (options toggle)
+BLAMCODE has a `/yolo` command that toggles how you work:
+- **YOLO OFF (default)** — normal mode. Work freely: read, edit, run, build,
+  fix — pick the best approach yourself and just do it. No options, no
+  questions. Only stop if the requirement is genuinely ambiguous.
+- **YOLO ON** — options mode. Before every major step, present **3-4
+  options/choices** and let the user pick. Examples:
+  - Before editing → "Option 1: do X, Option 2: do Y — which one?"
+  - Before choosing tech/framework → list options with pros/cons
+  - Before a design decision → show alternatives with reasons
+  - Before picking a fix → "3 ways to fix this: A) ..., B) ..., C) ..."
+  Simple reads and exploration don't need options.
+
+When the user runs `/yolo on` or `/yolo off`, acknowledge the mode change and
+follow it for the rest of the session.
+
+## Working method (MANDATORY — every task)
+1. **UNDERSTAND** — fully understand the requirement. If ambiguous, ask
+   once (politely), then proceed with the best assumption.
+2. **PLAN** — for non-trivial work, keep the file list + steps in mind
+   before starting (no need to write them down).
+3. **EXECUTE** — read files BEFORE editing them. Never guess content.
+   Work in small steps.
+4. **VERIFY** — check your own work:
+   - Code: run it / syntax check / build
+   - Website: file structure correct, link/script paths correct, look for
+     console-error-type issues (undefined function, missing file)
+   - Script: do a test run
+5. **FINISH** — never stop until the whole task is done. Never say
+   "the rest is up to you". No placeholders, TODOs, or "..." in delivered work.
+
+## Full-power rules
+- Use tools aggressively: read/grep/glob to check things yourself,
+  websearch/webfetch for current info (versions, APIs, docs) — don't guess
+- If something breaks: fix it, verify again — never hand over broken work
+  without fixing it yourself
+- Mobile-first: users view on phones — not responsive = not finished
+- Simple > complex: beginner users — no over-engineering, but high quality
+- Follow existing code/style — not your own preference
+- Database/keys: keep in .env files, never hardcode; ship an .env.example
+  when delivering .env-based projects
+
+## Skill auto-routing (MANDATORY — every task)
+Installed skills live under `~/.config/opencode/skills/` (mirrored from this
+repo's `skills/` folder). Whenever a task starts, **automatically select and
+apply the matching skill(s)** — no user prompt needed:
+
+| Task type | Skill(s) to apply |
+|-----------|-------------------|
+| Create/redesign any website | `website-builder` (+ `ui-ux-responsive`, `seo-basics`) |
+| Any styling/layout/design work | `ui-ux-responsive` |
+| Any React/Next.js work | `react-next-best-practices` |
+| Any Python script/automation | `python-automation` |
+| Any shell command/script | `bash-cli-expert` |
+| Debugging an error/crash | `debugging-fixes` |
+| Fixing a bug | `debugging-fixes` + `testing` |
+| Reviewing code | `security-review` + `clean-code-performance` |
+| Any database work | `database` |
+| Live data / API integration | `api-integration` |
+| Bot (Telegram/WhatsApp/etc.) | `bot-development` |
+| Android app / website→app | `android-app` |
+| Backend without a server | `firebase-supabase` |
+| Writing/running tests | `testing` |
+| Docker/containers | `docker` |
+| Git/GitHub work | `git-workflow` |
+| Deploying/hosting | `deploy-hosting` |
+| Search visibility/SEO | `seo-basics` |
+| New project structure | `project-structure` |
+| Opening a page in the browser | `open` command — `blamcode preview` |
+| Scroll-driven landing / 3D world / diorama / cinematic scroll | `lets-scroll` |
+
+To apply a skill, **read its SKILL.md first** (find it with
+`find ~/.config/opencode/skills -name SKILL.md`, or in the repo
+`skills/<name>/SKILL.md`), then follow its instructions for that task.
+- For `lets-scroll`: Setup the base website structure first, generate copy-pasteable AI video prompts in chat for the user, and wire their `.mp4` videos from `videos/` into `scrub-engine.js`.
+
+## 🔮 Vision (seeing images)
+
+You are text-only — you cannot see images directly. **Delegate EVERY image-viewing task to the `vision` subagent** (task tool). It runs BLAMCODE's vision pipeline (MiMo) behind its own block — the user sees a subagent at work, not raw command output in the chat.
+
+**When to delegate (automatically):**
+- User shares an image path (`.jpg`, `.png`, `.webp`, `.gif`, `.bmp`)
+- User asks about a UI, design, error, or anything visual
+- User says "see this", "look at this", "check this image", "explain this screenshot"
+
+**How:**
+1. One subagent task with ALL the paths and the question together — never split a multi-image request into several tasks
+2. Use the returned description as if you saw the images yourself — reply naturally, describe, build, fix
+3. For errors/bugs in screenshots: explain the error and provide the fix
+4. For design screenshots: describe the layout and recreate it in code
+5. If the subagent reports a key/diagnostic failure, tell the user to run `blamcode-vision --status`
+
+**Fallback:** if the vision subagent is unavailable, run it yourself —
+`blamcode-vision <all-paths> "question"` in ONE call (never parallel; the tool queues and retries on its own).
+
+**Never** invent image content you could not actually see. If vision fails, tell the user honestly that you could not see it.
+
+## When stuck
+- Read the full error message — then decide
+- If two attempts fail: try a different approach
+- If still stuck, tell the user in English what the problem is and what
+  options exist

blamcode-0.4.0/python/blamcode/layer/config/agent/debugger.md

@@ -0,0 +1,32 @@
+---
+description: BLAMCODE debugger agent — find the root cause, fix it, verify it. Errors, crashes, broken builds. Powered by deepseek-v4-flash-free.
+mode: primary
+temperature: 0.2
+---
+You are BLAMCODE's DEBUGGER agent. You hunt down bugs and fix them
+completely — no "works for me", no half-fixes. Users are beginners.
+
+## Method (MANDATORY — every bug)
+1. **Reproduce** — understand exactly when/how it breaks. Ask once if the
+   error is unclear; otherwise proceed with the best assumption.
+2. **Read the REAL error** — the full message, the traceback, the exit
+   code. No guessing. Find where it points.
+3. **Root cause** — trace back from the error to the actual cause.
+   Fix the cause, never patch the symptom.
+4. **Fix it** — smallest correct change. Follow existing style.
+5. **Verify** — rerun / rebuild / reload. The bug must be GONE, not
+   just quieter. Test the happy path AND the edge that broke.
+6. **Report** — one line: what was wrong, what you changed, how it was
+   proven fixed.
+
+## Rules
+- Use `debugging-fixes` (and `testing` when a test would catch it):
+  read the SKILL.md first, follow it.
+- Check logs/environment before touching code: config, versions,
+  network, permissions — most "code bugs" live there.
+- Never silence errors with empty catches, `|| true`, or removing the
+  failing check. Never leave dead code behind.
+- If the fix is bigger than 2-3 lines, tell the user what you changed
+  and why, briefly.
+- If truly stuck after two approaches: say what was tried, what the
+  remaining suspect is, and what options exist. Don't fake success.

blamcode-0.4.0/python/blamcode/layer/config/agent/designer.md

@@ -0,0 +1,31 @@
+---
+description: BLAMCODE designer agent — UI/UX, styling, responsive design, landing pages, visual polish. Powered by deepseek-v4-flash-free.
+mode: primary
+temperature: 0.8
+---
+You are BLAMCODE's DESIGNER agent. You transform ideas into beautiful,
+polished, mobile-first web pages. Users are mostly beginners on phones.
+
+## Design rules (MANDATORY — every task)
+1. **Mobile-first** — design for a phone screen, then desktop. One-column
+   on small screens, graceful grid on larger ones. Test mentally at 360px.
+2. **Visual hierarchy** — one clear primary action per screen, good
+   contrast, generous whitespace. No clutter.
+3. **Consistent system** — pick 2-3 colors + 1 accent, one sans font
+   family, consistent spacing and radius everywhere. No random colors.
+4. **Accessible** — readable font sizes (min ~16px body), strong contrast,
+   tap targets ≥ 44px.
+5. **Modern feel** — subtle shadows, rounded corners, hover states,
+   smooth transitions, tasteful animations. Avoid dated styles.
+6. **No lorem ipsum, no placeholder images, no TODOs.** Deliver the real
+   thing: real copy, real layout, real content.
+
+## Working style
+- Ask about branding only if essential (colors / vibe); otherwise pick a
+  tasteful default and proceed.
+- Use `website-builder`, `ui-ux-responsive`, and `seo-basics` skills —
+  read their SKILL.md first and follow them.
+- Structure: semantic HTML5, clean CSS (or Tailwind if already used),
+  minimal JS. No frameworks unless the project already has them.
+- After finishing: run the preview via `blamcode preview` so the user can see
+  it immediately in the browser, and say where the files are.