Writing

Notes on AGENTS.md, context engineering, and the failure modes that taught us each lesson.

September 17, 2026 · How-to · EN

Task Decomposition for Multiple Coding Agents

Split software work into independently verifiable outcomes, stabilize shared contracts, model producer-consumer dependencies, and launch only the coding-agent tasks that are genuinely ready.

September 10, 2026 · How-to · EN

How to Prepare Your Repository for OpenAI Codex in 2026

Configure Codex with layered AGENTS.md instructions, trusted project settings, sandbox and approval boundaries, executable rules, repository skills, MCP servers, and clean-session proof.

September 8, 2026 · How-to · EN

How to Prepare Your Repository for Claude Code in 2026

Use CLAUDE.md as the Claude Code entry point, import portable AGENTS.md instructions, scope local rules, share project settings, enforce hard boundaries with permissions and hooks, and verify everything in a clean session.

September 1, 2026 · How-to · EN

How to Resolve Merge Conflicts Between Coding Agents

Resolve textual, contract, generated-output, behavior, migration, and authority conflicts with stable checkpoints, explicit ownership, source-first repair, and combined proof.

August 15, 2026 · How-to · EN

How to Set Up a Four-Role Codex Room

Install an isolated Supervisor, Lead, Peer, and Review Codex room through Paseo: share one operator login, keep four runtimes apart, and leave ~/.codex under the operator’s control.

July 9, 2026 · How-to · EN

AGENTS.md for Backend/API Repos vs Frontend Repos

Backend and frontend repositories need different AGENTS.md instructions. This guide shows what to include for APIs, services, UI apps, design systems, and full-stack projects.

July 7, 2026 · How-to · EN

How to Maintain AGENTS.md as Your Repository Evolves

AGENTS.md is not a one-time setup file. This guide shows when to update it, what to review, and how to keep coding-agent instructions aligned with tests, architecture, tools, and releases.

June 30, 2026 · How-to · EN

10 AGENTS.md Mistakes That Break Coding Agent Sessions

Most AGENTS.md files fail because they are too vague, stale, or unverifiable. Here are 10 mistakes that break Claude Code, Codex, Cursor, and other coding agents — and how to fix each one.

June 25, 2026 · Examples · EN

10 Real-World AGENTS.md Examples (With Analysis)

Ten real AGENTS.md files from public open-source repositories, each annotated for what works, what does not, and what to copy. The fastest way to learn AGENTS.md is to read the best ones.

September 15, 2026 · Comparison · EN

Coding-Agent Context Files in 2026: AGENTS.md vs CLAUDE.md

A current, official-docs comparison of AGENTS.md, CLAUDE.md, Cursor Rules, Copilot instructions, GEMINI.md, Aider, and OpenCode — including discovery, precedence, and a one-contract migration plan.

May 24, 2026 · Introduction · EN

What Is an Agent-Ready Repository?

An agent-ready repository gives coding agents the instructions, architecture context, validation rules, and decision history they need to make useful, reviewable changes.

May 23, 2026 · Document · EN

AGENTS.md Template

A practical template for agent-ready repositories — copy and adapt for Claude Code, Codex, Cursor, and other coding agents.

May 20, 2026 · Document · EN

Supported harness patterns

A working harness combines tests, docs, scripts, conventions, fixtures, examples, and decision records.