Living architecture remembers why

说明与用途

代理可以通过引用明确的设计原则和归档的推理来安全地修改代码，降低错误风险。

问题

Agents need to understand why code exists to safely modify it.

结果

Agents can safely modify code by consulting explicit design documents and archived reasoning, reducing errors and aligning changes with current architecture.

工作流

• Identify affected modules via LikeC4 model
• Retrieve .arc42.md design principles for those modules
• If no relevant principles, fetch archived OpenSpec docs from PR history
• Analyze reasoning behind original code changes
• Determine which of the three cases applies (core design, legacy reason, or arbitrary choice)
• Proceed with code modification respecting the identified case
• Merge PR and archive new OpenSpec change
• Update design principles if necessary

证据

The core normative design principles of a module are spelled out explicitly by the human in an .arc42.md document attached to the respective node

来源

Each PR workflow interviews the human about corner cases and design choices, and creates a complete set of OpenSpec artefacts, scenarios, design doc, and all

来源