Long-form essays on engineering decisions — how to structure them, score evidence, and stop forgetting why they were made.https://forgeplan.dev/https://forgeplan.dev/blog/how-to-use-fpf/https://forgeplan.dev/blog/how-to-use-fpf/Three steps to try Anatoly Levenchuk's pattern language on your own project. With two Name Card examples and a list of traps that are easy to fall into when working with an LLM.Tue, 26 May 2026 00:00:00 GMThttps://forgeplan.dev/blog/what-is-fpf/https://forgeplan.dev/blog/what-is-fpf/Anatoly Levenchuk's pattern language for teams with humans and AI agents - in plain English with examples for PMs, engineers, and everyday people.Tue, 26 May 2026 00:00:00 GMThttps://forgeplan.dev/blog/where-fpf-helps/https://forgeplan.dev/blog/where-fpf-helps/From a payments API to a family decision about moving countries - concrete situations where Anatoly Levenchuk's FPF patterns turn confusion into working structure. Each case maps to a specific FPF pattern.Tue, 26 May 2026 00:00:00 GMThttps://forgeplan.dev/blog/process-over-model/https://forgeplan.dev/blog/process-over-model/Three aphorisms I repeat more than the rest: 'PRD = WHAT, not HOW', 'CLAUDE.md is one agent's constitution, BMAD is the team's', 'without a process, AI raises code complexity'. The last one isn't rhetoric - MSR 2026 gives numbers: 42.7% of agent commits raise cyclomatic complexity, 56.1% lower the Maintainability Index, +39% cognitive complexity over time.Mon, 25 May 2026 00:00:00 GMThttps://forgeplan.dev/blog/full-cycle-on-one-feature/https://forgeplan.dev/blog/full-cycle-on-one-feature/Six months ago, one line in chat: 'we need streaming for model responses.' Today, a connected set of six files marked active, with measured trust and explicit review conditions. The series capstone: the path from that line to a decision, in seven steps on one real task.Sun, 24 May 2026 00:00:00 GMThttps://forgeplan.dev/blog/forgeplan-pos-terminal/https://forgeplan.dev/blog/forgeplan-pos-terminal/A waiter doesn't keep the price list, dish ingredients, taxes, and loyalty points in their head. They press buttons on a terminal, and the terminal remembers everything. Forgeplan is a POS terminal for methodologies: four ways of working in one plane, so you pick the content and the mechanics stay out of the way.Sat, 23 May 2026 00:00:00 GMThttps://forgeplan.dev/blog/spec-vs-prd-tasting-test/https://forgeplan.dev/blog/spec-vs-prd-tasting-test/A recipe can sound delicious and still be unworkable. The final taste of a dish is only verified by eating it. A PRD is the recipe. A Specification is the taste test: verifiable system behavior, a delta format for changes like commit messages, a dependency graph between related specs.Fri, 22 May 2026 00:00:00 GMThttps://forgeplan.dev/blog/architect-doesnt-start-with-blueprints/https://forgeplan.dev/blog/architect-doesnt-start-with-blueprints/Between a one-line Slack message and a working feature there are four phases: expanding the solution space, breaking it into parts and edge cases, choosing an option, writing the contract document. The only question is whether a team runs these phases in a document in one day - or in code over two weeks of untangling consequences.Thu, 21 May 2026 00:00:00 GMThttps://forgeplan.dev/blog/decision-record-with-expiry/https://forgeplan.dev/blog/decision-record-with-expiry/A judge writes which evidence was considered, which was rejected, and why - so the case can be reopened a year later. Architectural decisions need exactly the same discipline. I break down the six sections of a DDR, with special attention to the one that's skipped most often: conditions for reopening.Tue, 19 May 2026 00:00:00 GMThttps://forgeplan.dev/blog/averages-lie-trust-calculus/https://forgeplan.dev/blog/averages-lie-trust-calculus/A vendor whitepaper and a Slack screenshot from a trusted colleague can score the same 'average quality' - but betting a decision on one vs the other is a different risk entirely. I break down R_eff: three axes of evidence, the weakest-link rule, context matching - and why one benchmark you ran yourself beats ten blog posts from strangers.Mon, 18 May 2026 00:00:00 GMThttps://forgeplan.dev/blog/before-fixing-write-three-versions/https://forgeplan.dev/blog/before-fixing-write-three-versions/A good detective doesn't lock onto the first version of events. They propose three or four, describe what evidence each predicts, then go check. The same move - ADI - turns the hasty wrong fix into ten minutes of honest diagnosis. I walk through two real cases: a conversion drop and a slow search.Sat, 16 May 2026 00:00:00 GMThttps://forgeplan.dev/blog/decision-graveyard/https://forgeplan.dev/blog/decision-graveyard/Teams accumulate invisible debt not in their code, but in forgotten architectural decisions. Notion and Confluence don't fix this - you need a different format. I break down what this debt looks like on real cases and what a decision format must contain to still be useful a year later.Thu, 14 May 2026 00:00:00 GMThttps://forgeplan.dev/blog/r-eff-weakest-link/https://forgeplan.dev/blog/r-eff-weakest-link/ForgePlan scores every decision with R_eff = min(evidence_scores) - never the average. This post unpacks why the minimum, how individual evidence scores are computed, and how to read a real R_eff number in forgeplan score.Tue, 12 May 2026 00:00:00 GMThttps://forgeplan.dev/blog/markdown-source-of-truth/https://forgeplan.dev/blog/markdown-source-of-truth/How ForgePlan's load-bearing ADR-003 invariant got compile-time-enforced: 4 audit rounds, 56 findings, a pub(crate) lockdown across 32 call sites, and why the boring discipline matters more than clever architecture.Sun, 10 May 2026 00:00:00 GMThttps://forgeplan.dev/blog/harness-engineering-for-ai-agents/https://forgeplan.dev/blog/harness-engineering-for-ai-agents/If your AI agent ships a feature with the wrong logic and a green test suite, the failure is in the harness - not the prompt. A walkthrough of the five harness subsystems using ForgePlan as a concrete implementation, with code examples and honest gap list.Fri, 08 May 2026 00:00:00 GMThttps://forgeplan.dev/blog/git-for-decisions/https://forgeplan.dev/blog/git-for-decisions/Six months of dogfooding ForgePlan - a local-first CLI that treats engineering decisions like first-class artifacts. Honest report: the methodology, a war story about a tool that lied, and what AI-native actually means in practice.Tue, 05 May 2026 00:00:00 GMThttps://forgeplan.dev/blog/forgeplan-rust-lancedb/https://forgeplan.dev/blog/forgeplan-rust-lancedb/Forgeplan is a local-first Rust CLI + MCP server that constrains where an AI coding agent can write, what state it must read, what evidence it must produce, and what gates it must pass. Markdown source of truth, compile-enforced invariant, weakest-link trust scoring, hint protocol contract.Sun, 03 May 2026 00:00:00 GMThttps://forgeplan.dev/blog/forgeplan-as-agent-harness/https://forgeplan.dev/blog/forgeplan-as-agent-harness/Six months of building a decision framework - then realising I'd built an agent harness. How ForgePlan maps to the five harness subsystems, the PROB-034 bug that taught me a harness must catch itself lying, and three honest gaps still on the roadmap.Tue, 28 Apr 2026 00:00:00 GMThttps://forgeplan.dev/blog/decisions-not-prompts/https://forgeplan.dev/blog/decisions-not-prompts/When AI breaks something, the problem almost never is the model. The problem is that the model has nowhere to put the decision. Six months of practice with ForgePlan: four ideas, three gaps, one star on GitHub.Wed, 22 Apr 2026 00:00:00 GMThttps://forgeplan.dev/blog/building-an-agent-harness/https://forgeplan.dev/blog/building-an-agent-harness/A harness is everything around the model except its weights. Six months of open ForgePlan development: five harness subsystems, how ADR-003 almost killed markdown as source of truth, and three roadmap holes I'm calling out publicly.Wed, 15 Apr 2026 00:00:00 GMThttps://forgeplan.dev/blog/where-team-decisions-live/https://forgeplan.dev/blog/where-team-decisions-live/Six months of open development on a tool that turns team decisions into first-class git artefacts. What a decision graveyard is, how ForgePlan works, and why the repo has one star on GitHub - an honest report.Sun, 05 Apr 2026 00:00:00 GMThttps://forgeplan.dev/blog/welcome/https://forgeplan.dev/blog/welcome/This blog will document decisions, releases, and methodology insights from Forgeplan development.Wed, 25 Mar 2026 00:00:00 GMT