Skip to content

Instantly share code, notes, and snippets.

View mmizutani's full-sized avatar

Minoru Mizutani mmizutani

  • Tokyo
  • 12:19 (UTC +09:00)
View GitHub Profile
@OmerFarukOruc
OmerFarukOruc / claude.md
Last active February 7, 2026 01:20
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.
@miklschmidt
miklschmidt / README.md
Last active February 5, 2026 06:13
Experimental codex collab/agent orchestration

How to use:

  1. Clone https://github.com/miklschmidt/codex and build codex yourself.
    • i've added devenv in my fork, you can try devenv shell nix build .#packages.<system>.codex-rs (eg. devenv shell nix build .#packages.x86_64-linux.codex-rs)
    • when built, symlink the binary to ~/.local/bin/codex: ln -s $(pwd)/result/bin/codex ~/.local/bin/codex
  2. Add the instructions (.md files) from this gist to .codex/ in the project where you want to test it.
  3. Launch codex --profile orchestrator and ask it to do something.

Claude Agent SDK Technical Specification

Version: 1.0.0 Protocol Version: 2024-11-05 Last Updated: 2026-01-10

Table of Contents

  1. Overview
  2. Architecture
@awni
awni / open_code_mlx.md
Last active February 5, 2026 12:39
OpenCode with MLX

The following guide will show you how to connect a local model served with MLX to OpenCode for local coding.

1. Install OpenCode

curl -fsSL https://opencode.ai/install | bash

2. Install mlx-lm

@mizchi
mizchi / rag.ts
Last active August 3, 2025 08:55
My Portable RAG
/**
* My Portable RAG
* $ pnpm add sqlite-vec @ai-sdk/google ai
* SQLite Vector Search + Google AI Embeddings
*
* Required environment variables:
* GOOGLE_GENERATIVE_AI_API_KEY=your-api-key
*
* Usage:
* # Index text content
@wong2
wong2 / claude-code-tools.md
Last active February 3, 2026 11:33
Tools and system prompt of Claude Code

Task

Launch a new agent that has access to the following tools: Bash, Glob, Grep, LS, exit_plan_mode, Read, Edit, MultiEdit, Write, NotebookRead, NotebookEdit, WebFetch, TodoRead, TodoWrite, WebSearch. When you are searching for a keyword or file and are not confident that you will find the right match in the first few tries, use the Agent tool to perform the search for you.

When to use the Agent tool:

  • If you are searching for a keyword like "config" or "logger", or for questions like "which file does X?", the Agent tool is strongly recommended

When NOT to use the Agent tool:

  • If you want to read a specific file path, use the Read or Glob tool instead of the Agent tool, to find the match more quickly
  • If you are searching for a specific class definition like "class Foo", use the Glob tool instead, to find the match more quickly
  • If you are searching for code within a specific file or set of 2-3 files, use the Read tool instead of the Agent tool, to find the match more quickly
export const requireComment = {
meta: {
type: "suggestion",
docs: {
description: "useEffectにはコメントでの説明が必須です。",
},
schema: [],
messages: {
requireCommentOnUseEffect: `useEffectにはコメントでの説明が必須です。
@awni
awni / l3min.py
Last active January 25, 2025 21:30
A minimal, fast implementation of Llama 3.1 in MLX.
"""
A minimal, fast example generating text with Llama 3.1 in MLX.
To run, install the requirements:
pip install -U mlx transformers fire
Then generate text with:
python l3min.py "How tall is K2?"
@veekaybee
veekaybee / normcore-llm.md
Last active February 6, 2026 19:48
Normcore LLM Reads

Anti-hype LLM reading list

Goals: Add links that are reasonable and good explanations of how stuff works. No hype and no vendor content if possible. Practical first-hand accounts of models in prod eagerly sought.

Foundational Concepts

Screenshot 2023-12-18 at 10 40 27 PM

Pre-Transformer Models

@jvelezmagic
jvelezmagic / main.py
Last active July 17, 2025 02:39
QA Chatbot streaming with source documents example using FastAPI, LangChain Expression Language, OpenAI, and Chroma.
"""QA Chatbot streaming using FastAPI, LangChain Expression Language , OpenAI, and Chroma.
Features
--------
- Persistent Chat Memory:
Stores chat history in a local file.
- Persistent Vector Store:
Stores document embeddings in a local vector store.
- Standalone Question Generation:
Rephrases follow-up questions to standalone questions in their original language.