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

Источник