Knowledge

Practical articles and working notes.

Short, specific writing on software delivery, architecture, quality, automation, and AI-assisted development practice.

Tech

Weekly Governance Reports and Meta-Review: Humans Above the Autonomous System

After removing all human approvals from an AI-agent system, drift is handled by a weekly governance report and a five-step meta-review. This post covers the three report chapters, the three hard rules, the four editable system assets, and the notification discipline that keeps humans out of the task loop.

Tech

Why AI Ships Great Work Sometimes: A Nine-Step Flow for Consistent Output

AI task quality varies run to run because the execution path is never written down. This article details a reusable four-layer structure — a nine-step workflow, type-routed guidelines, deterministic scripts, and an independent review loop with a code-change-mandates-re-review exit rule — plus a reusable checklist.

Tech

Recurring Loops: How an Unattended System Keeps Itself Running

A catalogue of the eight recurring loops that keep a launched, unattended system alive — daily triage and PR review, biweekly releases and reports, a weekly governance report, and a resident sentinel — plus three design rules: separate loop from schedule, keep jobs off the task board, and close loops in two phases.

Tech

Agent Artifact Contracts: A 13-Stage Lifecycle Type System for Multi-Agent Work

Multi-agent handoffs are a type problem. This article presents the full Idea-to-Production mechanism: the A–M artifact chain across thirteen stages, dependency enforcement at the claim lock (P3 rule), two-bat dispatch at artifact boundaries, doc-first discipline, and the two gates that keep an unattended chain trustworthy.

Tech

Nine Roles, One Org Chart: Decision Ownership for Multi-Agent Systems

A working nine-role agent org chart where every role owns exactly one block of decision rights: dispatch authority has a single source, quality is dissolved into checkpoints and release gates, rollbacks follow written-down standards, and a 1:1 vocabulary discipline keeps naming from drifting.

Tech

Model Name Is Not Experience: Qoder's Free Tier in Review

A real task on Qoder's free Qwen3.8-Flash tier ignored every workflow rule and reported false success. Cross-checking the same model on Trae and Qoder's paid tier isolates host and tier as the variable, with runtime configuration — not weights — the likely cause.

Tech

Rethink Your Software Manual for the Age of AI Agents

99% of software manuals are written only for humans, which causes parameter hallucinations and endless retries in AI agents. This article covers dual-track documentation, six AI-specific modules, and two rollout options.

Tech

AI Is the Engine. The Program Manager Is the Wheel.

AI made software execution cheap and project direction expensive. Splitting engineering roles into producing and orchestrating types shows why the Program Manager and Product Manager become the core leverage of an AI-native team.

Tech

Stop AI from Treating Skills as Background Reading

Tasks run through a workflow that chains multiple skills, but some skills never get executed. This article shares three mechanical guardrails that make every model run them consistently.

Tech

AI Skill Splitting Principles

A practical decision framework for AI Skill splitting: 3 iron rules (single responsibility, independent evolution, clean loading) that tell you exactly when one Skill should become two, 6 engineering rules for Skill quality, and the critical distinction between Skills and Workflows.

Tech

The Infinite Loop Trap: 3 Defenses That Make Your AI Agent Stop Early

An agent stuck in an infinite loop is mostly an Agent-system (prompt / workflow) problem: the model only emits thinking text and never issues a structured tool call, so Loop detection force-interrupts it. Three coexisting defenses — prompt dual-constraint, retry/dedup cap, platform Loop detection — turn unbounded token burn into predictable convergence, critical for unattended overnight runs.

Tech

Pilot Before You Scale: Controlling Rework in AI Batch Workflows

How to roll out an AI pipeline over a batch of inputs without paying for full rework: pilot one representative input end to end, roll out vertically per input, and only batch or automate once acceptance assertions lock the process down.

Tech

1.39 Billion Tokens, ¥197: A Two-Lens Audit of One Month of AI Usage

A month-long audit cross-referencing platform billing with local session logs: 75.8% of compute was silently subsidized, 93.46% of tokens were cache re-reads priced at 1/30 of standard input, and the top 20 of 204 sessions drove 81.2% of usage. Includes verification math, data caveats, and a monthly reproduction checklist.

Tech

The Three-Options Tradeoff: Don't Let AI Replace Your Thinking

Asking AI for a single answer quietly erodes your judgment. This article gives a reusable method — the Three-Options Tradeoff — where you give direction, AI returns Top 3 options with pros/cons, and you decide. Includes a decision matrix and a reproduction checklist.

Tech

Pre-refine Your Prompt: Cut AI Errors at Near-Zero Cost

A minimal pre-refinement workflow: before running any serious task, use a chat model to polish your raw idea into a structured instruction, then hand it to the execution model. Near-zero cost, but it visibly lowers rework on expensive tasks.

Tech

Why AI Frameworks Need Native Workflow: From Unpredictable Planning to Deterministic Delivery

AI coding agents like Claude Code and Codex excel at individual tasks but consistently fail at multi-step engineering workflows. This article examines the uncertainty defects of pure LLM dynamic planning, argues that Workflow must be a first-class native extension primitive, proposes a hybrid paradigm of rigid Workflow constraints plus flexible agent reasoning, and presents a pluggable Workflow technical design fully compatible with existing frameworks.

IndieDev

Why I Started a Blog After One Month as an Indie Developer

After one month as a solo indie developer, I couldn't name what I'd shipped. Here's the full itemized breakdown of real work, why losing corporate accountability is the hardest transition, and the two-cadence public dev log I'm starting now.