Stop Letting AI Code From Stale Docs

刘吉祥 — Tue, 05 May 2026 10:42:19 +0000

AI coding tools are getting better, but long-running AI-assisted projects have a new bottleneck: project memory.

After a few sessions, agents may not know which docs are current, which plans were abandoned, which features are actually in scope, and which code changes require documentation updates.

AgentLockDoc is a small docs-as-code template designed to solve that problem. It gives coding agents a durable project memory:

AGENTS.md tells agents where to start.
SESSION.md records verified current reality, not wishes.
feature-registry keeps scope, status, docs, code entrypoints, and validation in one place.
doc-code-map connects code paths to authority docs.
conventions.md defines Status / Track / Risk / front-matter rules.
profiles help trim the template for CLI tools, Web SaaS, SDKs, Agent Platforms, and Software Automation projects.
Quick start:

cp -R templates/en-US/. /path/to/your-project/
cd /path/to/your-project
node scripts/validate-docs.mjs
Chinese template is also included under templates/zh-CN.

GitHub: https://github.com/yjfkpyu/AgentLock

DEV Community: 刘吉祥

Stop Letting AI Code From Stale Docs