https://asdecided.com/notes Engineering decisions, persistent agent context and deterministic enforcement. en-gb Mon, 03 Aug 2026 07:00:00 GMT https://asdecided.com/notes/decision-infrastructure-for-coding-agents https://asdecided.com/notes/decision-infrastructure-for-coding-agents Mon, 03 Aug 2026 07:00:00 GMT Decision infrastructure gives coding agents a durable, reviewable and enforceable record of what a team has already decided. https://asdecided.com/notes/decision-drift-in-ai-assisted-development https://asdecided.com/notes/decision-drift-in-ai-assisted-development Mon, 03 Aug 2026 07:00:00 GMT Decision drift is the mismatch between accepted engineering decisions and the behaviour later code changes produce. https://asdecided.com/notes/why-coding-agents-rewrite-architectural-decisions https://asdecided.com/notes/why-coding-agents-rewrite-architectural-decisions Mon, 03 Aug 2026 07:00:00 GMT Agents optimise the local change they can see, not the historical constraint they cannot. https://asdecided.com/notes/how-to-record-negative-engineering-decisions https://asdecided.com/notes/how-to-record-negative-engineering-decisions Mon, 03 Aug 2026 07:00:00 GMT Record deliberately rejected approaches so people and agents do not repeatedly reintroduce them. https://asdecided.com/notes/persistent-context-for-coding-agents https://asdecided.com/notes/persistent-context-for-coding-agents Mon, 03 Aug 2026 07:00:00 GMT Layer instructions, versioned decisions, deterministic retrieval and objective checks. https://asdecided.com/notes/agents-md-vs-claude-md-vs-adrs https://asdecided.com/notes/agents-md-vs-claude-md-vs-adrs Mon, 03 Aug 2026 07:00:00 GMT Agent instruction files and architectural decision records solve related but different problems. https://asdecided.com/notes/architecture-decision-records-for-coding-agents https://asdecided.com/notes/architecture-decision-records-for-coding-agents Mon, 03 Aug 2026 07:00:00 GMT Make ADRs validated, task-discoverable, lifecycle-aware and connected to honest checks. https://asdecided.com/notes/deterministic-retrieval-vs-rag-for-engineering-decisions https://asdecided.com/notes/deterministic-retrieval-vs-rag-for-engineering-decisions Mon, 03 Aug 2026 07:00:00 GMT Choose retrieval based on the cost of nondeterminism and the need for reproducible citations. https://asdecided.com/notes/requirements-as-code-for-ai-agents https://asdecided.com/notes/requirements-as-code-for-ai-agents Mon, 03 Aug 2026 07:00:00 GMT Keep important requirements versioned, validated, discoverable and testable beside the code. https://asdecided.com/notes/enforce-architectural-decisions-in-ci https://asdecided.com/notes/enforce-architectural-decisions-in-ci Mon, 03 Aug 2026 07:00:00 GMT Translate one objective consequence into a deterministic check linked to the accepted record. https://asdecided.com/notes/how-coding-agents-remember-architectural-decisionshttps://asdecided.com/notes/how-coding-agents-remember-architectural-decisionsMon, 03 Aug 2026 07:00:00 GMTGive coding agents durable memory through versioned, task-relevant and cited repository decisions. https://asdecided.com/notes/stop-ai-agents-repeating-failed-approacheshttps://asdecided.com/notes/stop-ai-agents-repeating-failed-approachesMon, 03 Aug 2026 07:00:00 GMTPreserve important rejections with evidence, scope and reconsideration conditions. https://asdecided.com/notes/share-decisions-between-cursor-claude-code-codexhttps://asdecided.com/notes/share-decisions-between-cursor-claude-code-codexMon, 03 Aug 2026 07:00:00 GMTUse tool-specific instructions as thin adapters to one vendor-neutral source of authority. https://asdecided.com/notes/agents-md-examples-for-software-teamshttps://asdecided.com/notes/agents-md-examples-for-software-teamsMon, 03 Aug 2026 07:00:00 GMTWrite concise, executable Codex instructions that route durable choices to decision records. https://asdecided.com/notes/claude-md-examples-for-architecture-ruleshttps://asdecided.com/notes/claude-md-examples-for-architecture-rulesMon, 03 Aug 2026 07:00:00 GMTRoute Claude Code toward current architecture decisions without duplicating decision history. https://asdecided.com/notes/adr-template-for-ai-assisted-developmenthttps://asdecided.com/notes/adr-template-for-ai-assisted-developmentMon, 03 Aug 2026 07:00:00 GMTAdd scope, lifecycle, retrieval terms and explicit enforcement classification to ADRs. https://asdecided.com/notes/prevent-agents-changing-database-conventionshttps://asdecided.com/notes/prevent-agents-changing-database-conventionsMon, 03 Aug 2026 07:00:00 GMTCombine recorded database intent with deterministic checks for objective consequences. https://asdecided.com/notes/keep-multiple-coding-agents-consistenthttps://asdecided.com/notes/keep-multiple-coding-agents-consistentMon, 03 Aug 2026 07:00:00 GMTShare authority, retrieval, citations and verification across different coding agents. https://asdecided.com/notes/rag-vs-repository-native-context-for-coding-agentshttps://asdecided.com/notes/rag-vs-repository-native-context-for-coding-agentsMon, 03 Aug 2026 07:00:00 GMTUse repository-native records for authority and RAG for broader discovery. https://asdecided.com/notes/test-ai-agent-followed-project-instructionshttps://asdecided.com/notes/test-ai-agent-followed-project-instructionsMon, 03 Aug 2026 07:00:00 GMTTest retrieval, citations, commands, policy results and patch behaviour as observable evidence. https://asdecided.com/notes/migrate-engineering-decisions-between-repositorieshttps://asdecided.com/notes/migrate-engineering-decisions-between-repositoriesMon, 03 Aug 2026 07:00:00 GMTPreserve provenance and deliberately re-establish authority in the destination repository. https://asdecided.com/notes/decision-provenance-for-ai-generated-codehttps://asdecided.com/notes/decision-provenance-for-ai-generated-codeMon, 03 Aug 2026 07:00:00 GMTLink AI-assisted changes to governing decisions, repository state and validation evidence. https://asdecided.com/notes/coding-agent-governance-tools-comparedhttps://asdecided.com/notes/coding-agent-governance-tools-comparedMon, 03 Aug 2026 07:00:00 GMTCompare instruction files, ADRs, MCP, RAG and CI policy by the jobs they actually perform. https://asdecided.com/notes/benchmark-project-instructions-vs-enforced-decisionshttps://asdecided.com/notes/benchmark-project-instructions-vs-enforced-decisionsMon, 03 Aug 2026 07:00:00 GMTMeasure instruction following, decision discovery and deterministic enforcement under controlled conditions. https://asdecided.com/notes/architectural-decision-control-plane-for-ai-agentshttps://asdecided.com/notes/architectural-decision-control-plane-for-ai-agentsMon, 03 Aug 2026 07:00:00 GMTConnect reviewed decisions, agent context, code changes and deterministic verification. https://asdecided.com/notes/scope-resolver-for-architectural-decisionshttps://asdecided.com/notes/scope-resolver-for-architectural-decisionsMon, 03 Aug 2026 07:00:00 GMTResolve applicable decisions with deterministic scope before semantic discovery. https://asdecided.com/notes/decision-citations-for-ai-generated-codehttps://asdecided.com/notes/decision-citations-for-ai-generated-codeMon, 03 Aug 2026 07:00:00 GMTUse stable decision IDs, repository revisions and explicit applicability. https://asdecided.com/notes/decision-aware-planning-for-coding-agentshttps://asdecided.com/notes/decision-aware-planning-for-coding-agentsMon, 03 Aug 2026 07:00:00 GMTExpose decisions, conflicts, checks and citations before implementation. https://asdecided.com/notes/architectural-decision-exception-workflowhttps://asdecided.com/notes/architectural-decision-exception-workflowMon, 03 Aug 2026 07:00:00 GMTTreat architectural exceptions as scoped, approved and expiring records. https://asdecided.com/notes/architectural-decision-health-monitoringhttps://asdecided.com/notes/architectural-decision-health-monitoringMon, 03 Aug 2026 07:00:00 GMTMonitor ownership, retrieval, enforcement, exceptions and decision drift. https://asdecided.com/notes/audit-evidence-for-ai-assisted-code-changeshttps://asdecided.com/notes/audit-evidence-for-ai-assisted-code-changesMon, 03 Aug 2026 07:00:00 GMTPreserve repository state, decisions, checks, approvals and exceptions. https://asdecided.com/notes/structured-schema-for-agent-readable-decisionshttps://asdecided.com/notes/structured-schema-for-agent-readable-decisionsMon, 03 Aug 2026 07:00:00 GMTAdd machine-readable identity, lifecycle, scope and enforcement references to ADRs. https://asdecided.com/notes/link-adrs-to-policy-as-codehttps://asdecided.com/notes/link-adrs-to-policy-as-codeMon, 03 Aug 2026 07:00:00 GMTConnect deterministic checks to the reviewed decisions that explain them. https://asdecided.com/notes/multi-repository-decision-governancehttps://asdecided.com/notes/multi-repository-decision-governanceMon, 03 Aug 2026 07:00:00 GMTCombine local authority with versioned shared decisions and explicit precedence.