Plan features against existing decisions. Keep Spec Kit specs and tasks linked to Archcore records.
How Spec Kit + Archcore work together
Spec Kit + Archcore connects a feature’s spec and plan to the decisions your
project already made. Spec Kit organizes the feature work. Archcore supplies the
relevant decisions and keeps new decision records linked to the feature files.
Say a feature plan brings in a calculation method that contradicts an accepted
decision. The agent shows you the conflict while the plan can still change, and
records new decisions as drafts once you approve the design.
Spec Kit и Archcore связывают спецификацию и план функции с решениями, которые
в проекте уже приняты. Spec Kit ведёт работу над функцией. Archcore даёт нужные
решения и привязывает новые записи к файлам функции.
Допустим, план функции вводит способ расчёта, который спорит с принятым
решением. Агент показывает вам противоречие, пока план ещё можно поменять, а
новые решения записывает черновиками после того, как вы одобрите проект.
Keeps project decisions and rules in Git so your agent can check feature plans against them. Хранит решения и правила проекта в Git, чтобы агент сверял с ними планы функций.
Guides work from project principles through a feature specification, implementation plan, tasks and code. Ведёт работу от принципов проекта через спецификацию функции, план реализации и задачи к коду.
From a feature specification to checked implementation
The instructions ask your agent to:
01
Read the principles and decisions
The agent checks the feature spec and the Spec Kit constitution (the project's agreed principles) against Archcore decisions. If the constitution is missing or blank, it tells you.
02
Review the plan, then link decisions
Spec Kit keeps the spec, plan and design files, and you review them before any code. After you approve, the agent saves new decisions as draft ADRs (architecture decision records) linked to those files.
03
Build and pick up later
The agent follows Spec Kit's task list and keeps the plan's status lines current. A later session reads the feature files and records before it asks you anything again.
Spec Kit keeps the spec, plan and tasks; Archcore records point to those files.
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
Spec Kit: You keep integer cents, and the agent writes the spec and plan where Spec Kit expects them, marks open points as assumptions and waits for your review.
03
Archcore: After you approve the design, its decisions become draft ADRs linked to the feature files.
04
Spec Kit: The agent works through the task list, runs the tests and updates the status lines in the plan.
05
Agent:
A new session answers from the saved files: 13 cents off and 612 cents total for one tea with SAVE10, plus where the documents disagree with the code.
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
Keep feature plans connected to project decisions.
You review a feature plan next to the decisions it must respect, and the reasons for new choices stay linked to the feature files.
A feature conflicts with an accepted decision
In both runs, the agent reported the conflict before planning and kept the accepted decision after the owner settled it.
The benchmark asked for the conflict check, and a filled-in constitution was not tested.
Specifications, tasks and decisions stay connected
Both runs kept the files where Spec Kit expects them and created linked draft ADRs, and the code passed all ten checks.
The plan still held stale claims about which records existed, which the revised text now checks.
Start with Archcore.
Keep your project decisions ready for the next task.