Four spec standards, one baseline, two different decisions

Описание и применение

В статье описывается, как автор использовал ИИ для генерации спецификаций в четырёх форматах и выбрал OpenSpec для приложения (потенциальный дрейф) и Spec Kit для игры (не закрываемые задачи). Это позволило поддерживать документацию актуальной и уменьшить ручную работу.

Задача

Side projects often lack consistent documentation, leading to drift or unfinished work. The developer needed a way to keep specs aligned with reality without excessive discipline.

Результат

The app now stays aligned with its baseline, eliminating drift. The game maintains a single open milestone at a time, preventing endless open work. Both projects benefit from automated spec updates and reduced manual documentation effort.

Рабочий процесс

• 1. Use AI assistant to rewrite baseline spec in four formats.
• 2. Evaluate each format against project risks.
• 3. Select OpenSpec for the app (drift risk) and Spec Kit for the game (closure risk).
• 4. Augment chosen format with Constitution Check and ADR log.
• 5. Adopt spec → plan → tasks cycle with gates for the game.
• 6. Update specs automatically as new items arise, ensuring spec precedes code changes.
• 7. Record tuning parameters and decisions in the spec to avoid back‑documentation.

Доказательства

I wrote the same baseline four times

Источник

OpenSpec makes discipline unnecessary: the current specs are the truth

Источник

Spec Kit answers that with two constraints… one open milestone at a time

Источник