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 software 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 happens when later code changes gradually stop reflecting an engineering decision that the team still considers valid. 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 Coding agents often reverse valid architectural decisions because the rationale and rejected alternatives are missing from the task context. 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 Negative decisions document approaches a team deliberately rejected so people and coding agents do not repeatedly reintroduce them. https://asdecided.com/notes/repository-as-system-of-record-for-ai-agents https://asdecided.com/notes/repository-as-system-of-record-for-ai-agents Mon, 03 Aug 2026 07:00:00 GMT Repository-local decisions travel with the code, inherit review and remain available across agent vendors and execution environments. 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 Use layered instructions, repository decision records and deterministic retrieval to give coding agents persistent context without one enormous prompt. 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 AGENTS.md and CLAUDE.md guide particular coding agents; ADRs preserve durable decisions. They solve related but different problems. https://asdecided.com/notes/project-instructions-are-not-enforcement https://asdecided.com/notes/project-instructions-are-not-enforcement Mon, 03 Aug 2026 07:00:00 GMT Agent instruction files shape model behaviour, but they do not prove that a patch complies with an engineering decision. 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 ADRs become more useful to coding agents when they are validated, discoverable by task language, lifecycle-aware and connected to 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 RAG is flexible for broad knowledge discovery; deterministic retrieval is useful when engineering decisions need reproducible results and citations. https://asdecided.com/notes/why-read-only-mcp-matters-for-engineering-decisions https://asdecided.com/notes/why-read-only-mcp-matters-for-engineering-decisions Mon, 03 Aug 2026 07:00:00 GMT A read-only MCP boundary lets coding agents discover and cite accepted decisions without silently changing the authority they depend on. 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 Requirements as code makes important product constraints versioned, validated, discoverable and testable alongside the implementation. 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 Enforce an architectural decision in CI by translating one objective consequence into a deterministic check linked to the accepted record. https://asdecided.com/notes/deterministic-agent-governance-without-an-llm-judge https://asdecided.com/notes/deterministic-agent-governance-without-an-llm-judge Mon, 03 Aug 2026 07:00:00 GMT Deterministic checks make agent governance reproducible by evaluating explicit constraints without asking another model for a compliance opinion. https://asdecided.com/notes/soft-delete-decision-example-for-coding-agents https://asdecided.com/notes/soft-delete-decision-example-for-coding-agents Mon, 03 Aug 2026 07:00:00 GMT A worked example showing how to record, retrieve and enforce a 30-day account-restoration decision for coding agents. https://asdecided.com/notes/coding-agent-decision-checklist https://asdecided.com/notes/coding-agent-decision-checklist Mon, 03 Aug 2026 07:00:00 GMT Use this checklist to assess whether a repository gives coding agents durable decisions, reproducible retrieval and honest enforcement. https://asdecided.com/notes/how-coding-agents-remember-architectural-decisions https://asdecided.com/notes/how-coding-agents-remember-architectural-decisions Mon, 03 Aug 2026 07:00:00 GMT Coding agents remember architectural decisions reliably only when the repository can retrieve a current, cited record for each task. https://asdecided.com/notes/stop-ai-agents-repeating-failed-approaches https://asdecided.com/notes/stop-ai-agents-repeating-failed-approaches Mon, 03 Aug 2026 07:00:00 GMT Record rejected approaches with scope, evidence and reconsideration conditions so coding agents do not rediscover the same failure. https://asdecided.com/notes/share-decisions-between-cursor-claude-code-codex https://asdecided.com/notes/share-decisions-between-cursor-claude-code-codex Mon, 03 Aug 2026 07:00:00 GMT Keep decisions in one vendor-neutral repository record and use each agent's instruction file only as a route into that shared authority. https://asdecided.com/notes/agents-md-examples-for-software-teams https://asdecided.com/notes/agents-md-examples-for-software-teams Mon, 03 Aug 2026 07:00:00 GMT A practical AGENTS.md should teach Codex how to work in a repository while routing durable engineering decisions to their authoritative records. https://asdecided.com/notes/claude-md-examples-for-architecture-rules https://asdecided.com/notes/claude-md-examples-for-architecture-rules Mon, 03 Aug 2026 07:00:00 GMT Use CLAUDE.md to route Claude Code toward current architecture decisions, not to duplicate an entire decision history. https://asdecided.com/notes/adr-template-for-ai-assisted-development https://asdecided.com/notes/adr-template-for-ai-assisted-development Mon, 03 Aug 2026 07:00:00 GMT An agent-ready ADR adds explicit scope, lifecycle, rejected alternatives, retrieval terms and machine-checkable consequences. https://asdecided.com/notes/prevent-agents-changing-database-conventions https://asdecided.com/notes/prevent-agents-changing-database-conventions Mon, 03 Aug 2026 07:00:00 GMT Record the database convention, expose its rationale before planning, and enforce only the structural consequences that CI can prove. https://asdecided.com/notes/keep-multiple-coding-agents-consistent https://asdecided.com/notes/keep-multiple-coding-agents-consistent Mon, 03 Aug 2026 07:00:00 GMT Multiple agents stay consistent when they share authority, retrieval and verification—not when prompts happen to resemble one another. https://asdecided.com/notes/rag-vs-repository-native-context-for-coding-agents https://asdecided.com/notes/rag-vs-repository-native-context-for-coding-agents Mon, 03 Aug 2026 07:00:00 GMT Repository-native context is the safer authority layer for engineering decisions; RAG remains useful for broader discovery across large, mixed corpora. https://asdecided.com/notes/test-ai-agent-followed-project-instructions https://asdecided.com/notes/test-ai-agent-followed-project-instructions Mon, 03 Aug 2026 07:00:00 GMT Test observable outcomes—decision retrieval, citations, commands, policy results and patch behaviour—rather than asking the agent whether it complied. https://asdecided.com/notes/migrate-engineering-decisions-between-repositories https://asdecided.com/notes/migrate-engineering-decisions-between-repositories Mon, 03 Aug 2026 07:00:00 GMT Migrate decisions by preserving identifiers and provenance, then deliberately rescoping, accepting or rejecting them in the destination repository. https://asdecided.com/notes/decision-provenance-for-ai-generated-code https://asdecided.com/notes/decision-provenance-for-ai-generated-code Mon, 03 Aug 2026 07:00:00 GMT Decision provenance links an AI-assisted change to the reviewed records, repository state and evidence that governed it. https://asdecided.com/notes/coding-agent-governance-tools-compared https://asdecided.com/notes/coding-agent-governance-tools-compared Mon, 03 Aug 2026 07:00:00 GMT Instruction files, ADRs, MCP servers, RAG and CI policy engines govern different stages; dependable systems combine them without confusing guidance with proof. https://asdecided.com/notes/benchmark-project-instructions-vs-enforced-decisions https://asdecided.com/notes/benchmark-project-instructions-vs-enforced-decisions Mon, 03 Aug 2026 07:00:00 GMT A reproducible benchmark can measure whether instructions improve agent behaviour and whether deterministic checks catch the violations that remain. https://asdecided.com/notes/architectural-decision-control-plane-for-ai-agents https://asdecided.com/notes/architectural-decision-control-plane-for-ai-agents Mon, 03 Aug 2026 07:00:00 GMT An architectural decision control plane connects reviewed decisions, agent context, code changes and deterministic verification without replacing Git or CI. https://asdecided.com/notes/scope-resolver-for-architectural-decisions https://asdecided.com/notes/scope-resolver-for-architectural-decisions Mon, 03 Aug 2026 07:00:00 GMT Resolve applicable decisions with deterministic repository and path signals first, then use semantic signals only to improve discovery. https://asdecided.com/notes/decision-citations-for-ai-generated-code https://asdecided.com/notes/decision-citations-for-ai-generated-code Mon, 03 Aug 2026 07:00:00 GMT Decision citations should identify the exact reviewed record, its repository revision, applicability and the files or claims it influenced. https://asdecided.com/notes/decision-aware-planning-for-coding-agents https://asdecided.com/notes/decision-aware-planning-for-coding-agents Mon, 03 Aug 2026 07:00:00 GMT Make applicable decisions, conflicts, required checks and citations visible in an agent plan before implementation begins. https://asdecided.com/notes/architectural-decision-exception-workflow https://asdecided.com/notes/architectural-decision-exception-workflow Mon, 03 Aug 2026 07:00:00 GMT Treat architectural exceptions as scoped, approved and expiring records instead of disabled checks or permanent temporary workarounds. https://asdecided.com/notes/architectural-decision-health-monitoring https://asdecided.com/notes/architectural-decision-health-monitoring Mon, 03 Aug 2026 07:00:00 GMT Monitor whether accepted decisions remain owned, retrievable, enforced where claimed and aligned with the code they govern. https://asdecided.com/notes/audit-evidence-for-ai-assisted-code-changes https://asdecided.com/notes/audit-evidence-for-ai-assisted-code-changes Mon, 03 Aug 2026 07:00:00 GMT Preserve repository state, retrieved decisions, citations, check results, approvals and exceptions as an inspectable evidence chain. https://asdecided.com/notes/structured-schema-for-agent-readable-decisions https://asdecided.com/notes/structured-schema-for-agent-readable-decisions Mon, 03 Aug 2026 07:00:00 GMT Add stable identity, lifecycle, scope, agent instructions and enforcement references to human-readable decision records. https://asdecided.com/notes/link-adrs-to-policy-as-code https://asdecided.com/notes/link-adrs-to-policy-as-code Mon, 03 Aug 2026 07:00:00 GMT Connect each deterministic policy rule to the reviewed architectural decision that explains its purpose, scope and remediation. https://asdecided.com/notes/multi-repository-decision-governance https://asdecided.com/notes/multi-repository-decision-governance Mon, 03 Aug 2026 07:00:00 GMT Combine local repository authority with explicit organisation-level decisions, versioned distribution and deterministic precedence.