Check proposed changes against project decisions. Keep specs and archives in OpenSpec.
How OpenSpec + Archcore work together
OpenSpec + Archcore connects a proposed change to the project decisions behind
it. OpenSpec keeps the proposal, design, specs and tasks together. Archcore gives
the agent the decisions to check before it touches code, and a place to record
new ones after you approve the design.
Say a request to simplify price math conflicts with an accepted rule about exact
money arithmetic. The agent shows you the conflict during design, while you can
still keep the rule or change it.
OpenSpec и Archcore связывают предложенное изменение с решениями проекта, которые
за ним стоят. OpenSpec держит вместе предложение, проектное решение,
спецификации и задачи. Archcore даёт агенту решения, которые надо сверить до
правки кода, и место для новых решений после того, как вы одобрите проект.
Допустим, запрос упростить расчёт цены спорит с принятым правилом о точной
арифметике с деньгами. Агент показывает вам это противоречие ещё на этапе
проектирования, пока правило можно оставить или поменять.
Keeps project decisions and rules in Git so your agent can check proposed changes against them. Хранит решения и правила проекта в Git, чтобы агент сверял с ними предлагаемые изменения.
The agent reads the relevant Archcore decisions and OpenSpec files first. If your request conflicts with an accepted decision, you settle it before work goes on.
02
Review the proposal
OpenSpec keeps the proposal, specs, design and tasks. You review the saved design; after you approve it, the agent records new decisions as draft ADRs (architecture decision records) linked to those files.
03
Build, archive and pick up later
The agent follows the OpenSpec tasks, syncs the specs and archives the change. A later session reads the specs and records and says which decisions are still drafts.
Both tools must already be set up. OpenSpec keeps the feature work; Archcore records link to it.
Request Introduce coupon discounts in this quotation library. Use floating-point arithmetic for the monetary intermediate values. Check existing project decisions and report any conflict before implementing.
01
Archcore: The agent finds the accepted integer-cents decision, reports the conflict with the float request and stops before changing any file.
02
OpenSpec: You keep integer cents, and the agent writes the proposal, design, specs and tasks in OpenSpec's folders, then waits for your review.
03
Archcore: After you approve the design, its decisions become draft ADRs linked to the OpenSpec files.
04
OpenSpec: The agent works through the tasks, runs the tests, syncs the specs and archives the change.
05
Agent:
A new session answers from the saved files: 13 cents off and 612 cents total for one tea with SAVE10, plus which decisions are still drafts.
This is what the instructions ask for, not a recorded run. An earlier revision completed this scenario twice; this one has not run yet.
Benefits & limits
Review changes with their project context.
You review a proposal next to the decisions it must respect, and the reasons behind new decisions stay in Git for later work.
A request conflicts with an existing decision
In both runs, the agent raised the conflict before changing code and kept the accepted decision once the owner settled it.
The benchmark asked for the conflict check, so detection without that prompt was not tested.
Picking up work in another session
A later session recovered the coupon behavior and told accepted decisions from drafts.
This was a scripted step in the same working tree, not proof for every later session.
Start with Archcore.
Keep your project decisions ready for the next task.