synthesis coding
49 articles
“Not found” is not “does not exist”
Check “not found” with bounded search, positive controls and complete output. A withdrawn-draft case separates editorial status from deployment history.
I cut my agent’s instruction file by 62% and kept every rule
How I cut an agent instruction file from 54,825 to 21,026 bytes while preserving its rules, with a migration method and a workbook for checking their new homes.
What My Checks Missed After an AI Agent Deleted 474 Files
My first checks of a bookmark cleanup passed. A second extraction found 196 missing URLs. The case shows how to check preservation against the source inventory.
When a Commit Guard Cannot Run, It Must Block
A missing Python dependency let my commit guard pass without scanning. Distinguish clean results from broken checks, test exceptions and monitor guard health.
I told a sub-agent to check before committing. Minutes later, I didn't.
Three multi-agent coding incidents taught me to inspect the shared Git index, write concrete briefs, and keep untested claims visible through every handoff.
Your Coding Agent Should Watch Its Own Work Run
Use authorized browser actions, screenshots and state checks to test a coding change in the running app, keeping visual and behavioral evidence distinct.
Prompt discipline is engineering infrastructure
Prompt discipline is engineering infrastructure: a forbidden-phrase catalog, hooks, and enforcement that catch AI coding agents dressing shortcuts as judgment.
One context file carried a redesign across eight AI sessions
A single CONTEXT.md carried an editor redesign across eight AI coding sessions. The ownership split that made it work: humans direct, the AI keeps the record.
Three Ragbot releases, one architectural shift
How Ragbot’s three releases joined local models, tools, skills, memory and policy into a conversational runtime, with the engineering choices behind the shift.
Every bug report is now a patch-or-redesign decision
The minimal patch is a habit from when understanding was expensive. AI coding agents ended that economy, and most of us never consciously make the choice.
Postel's Law for AI-Written Documents
Three bugs in my daily-plan dashboard led to shared vocabulary and tolerant rendering. The case shows where strict contracts belong and how to check both sides.
Demo mode as a pattern for software
Build demo mode into software so users can explore it with realistic sample data. A console case shows the design, testing, privacy and onboarding choices.
Synthesis Console: open-source tooling for synthesis engineering
I built a local console for projects, lessons and daily plans. File conventions, a small dependency budget and portable configuration shape its architecture.
Transferable Knowledge: The Fifth Pillar of Synthesis Coding
Transferable Knowledge makes AI-assisted work useful across people, tools, crafts, time and organizations through shared decisions and maintainable code.
When All Tests Pass, Check the Whole Change
A missing field survived 1,297 passing tests. Trace it from request to database, check each service and use seven review passes to find incomplete changes.
Stop asking me: Claude Code permissions for authorized work
Reduce repeated prompts with a scoped Claude Code permission policy, distinguishing allowed commands, sandbox limits and actions that still need authorization.
The blast radius principle: checking targets before destructive commands
Use path checks, previews and a tested recovery plan to limit AI-generated cleanup commands, with a complete exercise that removes no files.
Managing AI agent skills at scale: a three-repo architecture
A three-repository architecture for public, private and team AI skills, with provenance, dependency boundaries and a method for merging local improvements.
Synthesis Skills: install methodology directly into your AI workflow
Install reusable Synthesis Skills for code review, writing, and project continuity, with current setup guidance and the lessons behind the original release.
Synthesis merging: what happens after the first PR
Integrate overlapping pull requests in dependency order, check the combined result, credit contributors and help the team take ownership of integration.
Turning code review findings into a tested upgrade plan
Turn code review findings into an upgrade plan that preserves domain behavior, addresses urgent risks and defines evidence for each change before work begins.
What reviewing real codebases taught me about code review
Reviewing the wrong branch led to better baselines, closer test inspection and clearer reports. See what comparisons prove, and what they leave unknown.
Recommend A, implement A: checking an AI agent’s work against the plan
Check whether AI-generated code follows the agreed plan and whether that plan meets the requirements, using filename collisions to test both independently.
When Someone Else Contributes to Your Synthesis-Coded Project
Review contributions against your current architecture, adapt what needs changing, and build the shared standards that let good work merge with less rework.
Verifying AI-Written Code with Independent Checks
Use independent expectations, parser comparisons, staged probes and reviewed dry runs to find mistakes in AI-written code before acting on its output.
Bidirectional Learning in Synthesis Coding: When Human and AI Teach Each Other
Bidirectional learning in synthesis coding: humans teach AI through context, prompts, and review; AI teaches back by surfacing blind spots and edge cases.
The research lineage from recursive neural networks to human-AI collaborative development
Richard Socher's work on representations and language-based tasks suggests five research questions for building reliable software with human-AI collaboration.
From learned representations to engineered context: what Richard Socher's research tells us about working with AI
Richard Socher's work on reusable representations offers a practical lens for persistent AI coding context, architectural foundations and disciplined review.
Code Review That Scales: Choosing Review Depth by Risk
Use a tiered code-review runbook to choose review depth, override the tier for consequential risks, and record what was checked, excluded or left unverified.
Why Engineering Judgment Matters More With AI
AI makes engineering judgment more valuable. Four experiences show how faster implementation changes refactoring, verification and what we choose to build.
Diagnosing Retrieval Failures in a RAG Application
Use Ragbot’s biography lookup to separate routing, tokenization and ranking, then trace a context-budget change through five defaults from UI to retrieval.
Data Format Contracts for AI Pipelines
Timestamp, pagination, rate-limit and configuration failures taught me to define explicit data contracts, then test what each component sends and accepts.
Keeping Claude Code Refactors Consistent Across Long Sessions
Keep a long Claude Code refactor aligned with its conventions through instruction-loading checks, scoped code review and tests of the behavior being changed.
Build the Foundation Before Scaling AI Coding
Set architectural direction, build a complete reference feature and test the next addition. A worked API example shows what coding agents should extend.
How Claude Code Uses CLAUDE.md and Memory
Claude Code loads project instructions and saved memory under different rules. Check what survives compaction and whether the code follows your guidance.
What OpenAI's Sora Build Teaches Us About Synthesis Coding
What OpenAI's Sora Android case teaches about synthesis coding: give agents context, establish patterns, plan changes, and lead the work as it scales.
Scaling Synthesis Coding in Your Organization
Scale AI coding through a phased team rollout, role-specific training, quality standards and practical measures that build lasting engineering capability.
Building ownwords: A Synthesis Coding Case Study
How I built ownwords to manage 53 articles in Markdown, with deliberate architecture, publishing checks and runnable conversion and permission examples.
Why Synthesis Coding Still Writes Code in the Age of LLMs
Why better AI strengthens the case for code, shared understanding and review, with a family math puzzle, a runnable median example and three practical prompts.
Vibe Coding and Synthesis Coding: Two Complementary Approaches
Use conversational exploration to test ideas and synthesis coding to build software people can depend on, with practical guidance for moving between the two.
Polyrepo Synthesis: Working Across Repositories with Claude Code and VS Code
Configure Claude Code and VS Code for cross-repository work, map shared dependencies, and test both direct and indexed consumers after a schema change.
Modernizing a 17-Year-Old WordPress Plugin with Claude Code
A 2025 modernization of Blogroll Links: WordPress security and compatibility work with Claude Code, and why maintaining open-web software still matters.
Build a self-improving AI coding practice
Improve AI coding through project context, skills, instructions, and practice. A team account and CSV exercise show how to carry useful lessons into later work.
Understanding the AI-generated code you ship
Understand AI-generated code well enough to debug and change it. A cache example connects comprehension, review, and tests to sustained development speed.
Quality standards for AI-generated code
Design a testing strategy, review generated code, and connect passing checks to real requirements. An empty-response example shows how a green suite can fail.
Human architectural authority in AI-assisted development
How engineers keep AI-assisted development coherent: own architectural decisions, record their rationale, and use shared constraints to reduce costly rework.
Reviewing Claude Code’s Work: Security and Performance
Four Claude Code cases show how engineering review improves authentication, caching, async calls, and security findings, with runnable local Python examples.
The synthesis coding framework: building production software with AI
Five connected pillars turn AI-assisted coding into an organizational practice, with project cases, planning guidance, and a path to production software.
Synthesis coding: a professional practice for AI-assisted development
Architectural judgment, systematic quality, and shared project knowledge make AI-assisted development a professional practice with lasting value for teams.