Skip to content

Instantly share code, notes, and snippets.

View OmerFarukOruc's full-sized avatar
🏠
Working from home

Omer Faruk Oruc OmerFarukOruc

🏠
Working from home
View GitHub Profile
@OmerFarukOruc
OmerFarukOruc / mirror-protocol.md
Last active July 13, 2026 23:49
The Mirror Protocol, hardened for Claude Fable 5: user-text-only sweeps (accurate counts), resumable state across compaction, hard phase gates, reproducible receipts.

The Mirror Protocol

You are Claude Code (or any capable coding agent) running on my machine. My global agent rules (CLAUDE.md and the like) layer on top of this prompt: they win on style and tool choice, this prompt wins on process and sequence. Home directory for the protocol: `~/mirror/`. All artifacts live there: `evidence.md`, `mirror.md`, `roadmap.md`, and `.scratch/` for projections. Within a phase, once you have enough information to act, act. Deliberate only where the evidence genuinely underdetermines the choice; do not re-derive facts already established or re-litigate decisions already made. People lie in journals. They perform in therapy. Nobody performs for a coding agent. On this machine sits the most honest record of my mind that has ever existed: every session I have run with AI agents. What I build, what I abandon, what I ask for three times and never automate, what I circle and never touch. You are intelligent enough to read that record and see the shape o
@OmerFarukOruc
OmerFarukOruc / README.md
Last active June 16, 2026 00:02
Repo Audit & Improvement Plan — /repo-audit slash command for Claude Code (parallel subagents, adversarially verified findings, agent-executable task plan)

/repo-audit — a Claude Code slash command

A principal-engineer-grade repository audit, tuned for Claude's latest models running inside Claude Code.

It maps the repo, fans out parallel subagents (one per audit dimension, plus git-history mining for churn × complexity hotspots), adversarially verifies every Critical/High finding against the actual code before reporting it, runs the repo's own lint/type-check/test commands instead of guessing at health, and writes a single AUDIT.md containing:

  • Executive Summary — health grade A–F, top 3 risks, top 3 opportunities
  • Repo Map
  • Severity-rated findings (file:line cited, facts separated from judgments)
  • Improvement strategy — the 3–5 themes behind the findings, with measurable "done" signals
@OmerFarukOruc
OmerFarukOruc / SKILL.md
Created April 10, 2026 18:10
deslop skill by @i_am_brennan
name deslop
description Run a multi-agent review-readiness pass on a nearly finished change before commit; fan out parallel review agents across rule conformance, type safety, and overengineering, then synthesize and apply the worthwhile fixes.

Deslop

Use this skill after the change is functionally correct and before commit. The PR should be describing already-deslopped code, not code that still needs cleanup.

@OmerFarukOruc
OmerFarukOruc / batch-command.md
Created March 29, 2026 11:24
Claude Code bundled skills — /batch and /simplify prompts extracted from binary (v2.1.87)

Claude Code /batch Command — Extracted from Binary

Source: /home/oruc/.local/share/claude/versions/2.1.87 (compiled ELF, JS bundle embedded) Extracted: 2026-03-29


Command Registration

@OmerFarukOruc
OmerFarukOruc / README.md
Last active March 17, 2026 22:41
📖 Pandoc Markdown Viewer — Render .md files as styled HTML with a Typewriter dark theme

📖 Pandoc Markdown Viewer

Render markdown files as beautifully styled HTML in your browser — using pandoc with a custom Typewriter dark theme (inspired by the Obsidian Typewriter theme).

Warm sepia palette · Clean typography · JetBrains Mono code · No animations

Preview

Feature Details
@OmerFarukOruc
OmerFarukOruc / oc-cleanup
Last active March 24, 2026 18:14
oc-cleanup — Find and kill orphaned OpenCode processes on Linux (workaround for issue #15348)
#!/usr/bin/env bash
# oc-cleanup — Find and kill orphaned opencode processes (no TTY)
# Usage:
# oc-cleanup → list orphans only (dry run)
# oc-cleanup kill → kill them all
# oc-cleanup watch → show live opencode resource usage
# oc-cleanup guard → continuous watchdog (default: 1024MB threshold, 60s interval)
# oc-cleanup guard 512 → custom RAM threshold in MB
# oc-cleanup guard 512 30 → custom threshold + check interval in seconds
@OmerFarukOruc
OmerFarukOruc / qmd_finetune_lfm2_v2.ipynb
Created February 19, 2026 18:54
QMD Query Expansion: Fine-tune LiquidAI LFM2-1.2B (v2 - fixed overfitting)
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
@OmerFarukOruc
OmerFarukOruc / qmd_finetune_lfm2.ipynb
Created February 19, 2026 15:14
QMD Query Expansion: Fine-tune LiquidAI LFM2-1.2B on free Google Colab T4 (~2.5h)
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
@OmerFarukOruc
OmerFarukOruc / fdm-install-fedora.sh
Last active July 17, 2026 20:30
Install Free Download Manager on Fedora (converts .deb to .rpm using alien)
#!/bin/bash
# Free Download Manager Installer for Fedora
# Extracts .deb directly (avoids alien dependency issues)
set -e
FDM_URL="https://files2.freedownloadmanager.org/6/latest/freedownloadmanager.deb"
WORK_DIR=$(mktemp -d)
cd "$WORK_DIR"
@OmerFarukOruc
OmerFarukOruc / claude.md
Last active July 8, 2026 15:46
AI Agent Workflow Orchestration Guidelines

AI Coding Agent Guidelines (claude.md)

These rules define how an AI coding agent should plan, execute, verify, communicate, and recover when working in a real codebase. Optimize for correctness, minimalism, and developer experience.


Operating Principles (Non-Negotiable)

  • Correctness over cleverness: Prefer boring, readable solutions that are easy to maintain.
  • Smallest change that works: Minimize blast radius; don't refactor adjacent code unless it meaningfully reduces risk or complexity.