Spec Kit + Archcore
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 specification and implementation plan to the decisions already made in your project. Spec Kit organizes the feature work. Archcore supplies relevant decisions and keeps new decision records linked to the feature files.
For example, a feature plan may introduce a calculation method that contradicts an accepted project decision. The instructions ask the agent to surface the conflict while you can still change the plan. Once you approve the design, new architectural decisions are recorded as drafts for separate acceptance.
The instructions also address stale status statements found in the pilot’s plans and research. Read the pilot findings and instruction changes for the measured scope. For native commands and installation, see the Spec Kit project.
Как Spec Kit и Archcore работают вместе
Spec Kit и Archcore связывают спецификацию функции и план реализации с решениями, уже принятыми в проекте. Spec Kit ведёт работу над функцией. Archcore даёт подходящие решения и держит новые записи решений связанными с файлами функции.
Например, план функции может ввести способ расчёта, который противоречит принятому решению проекта. Инструкции просят агента показать противоречие, пока план ещё можно изменить. После того как вы согласуете проект, новые архитектурные решения записываются черновиками и принимаются отдельно.
Инструкции также закрывают устаревшие утверждения о состоянии, найденные в планах и материалах исследования пилота. Измеренные границы описаны в выводах пилота и изменениях инструкций. О собственных командах Spec Kit и установке смотрите проект Spec Kit.
- Archcore ↗
- Keeps project decisions and rules in Git so your agent can check feature plans against them.
- Spec Kit ↗
- 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:
-
Read the principles and decisions
The agent checks the feature specification and Spec Kit constitution against relevant Archcore decisions. The constitution is the project's agreed set of principles. A missing or blank one is reported for your decision.
-
Review the feature plan
Spec Kit keeps the specification, plan and supporting design files. You review them before implementation, with conflicts and open assumptions made explicit.
-
Link the new decisions
After design approval, the agent checks for existing decisions before creating draft ADRs in Archcore. Each architecture decision record links to the native feature files and distinguishes approved choices from assumptions.
-
Implement from the native tasks
The agent follows Spec Kit's task list, checks code against the approved specification and contracts, and updates current status statements in the plan and research.
-
Resume with the saved feature context
A later session reads the feature files and decision records before repeating requirements questions. It reports unfinished work and separates draft decisions from accepted ones.
Spec Kit keeps the feature specification, plan and tasks. The integration asks Archcore to reference those files when recording decisions.
One request, start to finish
Request Introduce coupon discounts in this quotation library. Use floating-point arithmetic for the monetary intermediate values. Use the installed Spec Kit specify, plan, tasks and implement workflow. Check existing project decisions and report any conflict before implementing.
-
Archcore: Before planning, the agent searches the project records and compares them with the request. It finds the accepted decision on integer cents, reports the conflict with the float request and stops. No file has changed.
-
Spec Kit: You keep integer cents. The agent writes the specification and plan where Spec Kit expects them, marks open points as assumptions, and stops at the saved design for your review.
-
Archcore: You approve the design. The decisions it settles become draft ADRs linked to the feature files by path. The money decision stays as it was.
-
Spec Kit: You ask for the implementation. The agent works through the task list, runs the tests, and brings the status lines in the plan and research up to date with the records that now exist.
-
Agent: A new session reads the feature files and the decision records and answers from them: the coupon contract, 13 cents off and 612 cents total for one tea with SAVE10, and 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 in Claude Code with a blank constitution; see the pilot note. This revision has not had a joint run.
Benefits & limits
Keep feature plans connected to project decisions.
You can review the proposed implementation alongside existing decisions, then keep the reasons for new choices linked to the feature files as work proceeds.
- A feature conflicts with an accepted decision
-
In both pilot runs with the earlier recipe, the agent reported the conflict before planning or implementation and preserved the accepted decision after the owner's resolution.
The benchmark explicitly requested the conflict check. Both runs used project instructions and the accepted ADR because the constitution was blank.
- Specifications, tasks and decisions stay connected
-
Both runs kept feature files in Spec Kit's native locations and created linked draft ADRs in Archcore. Code passed the benchmark's six primary and four additional contract checks.
Plan and research sections still contained stale claims about which records existed. Passing code tests did not make those documents consistent.
- A later session reviews the result
-
The recorded recall answers recovered the coupon behavior, draft ADR status and document disagreements from the saved feature work.
Some assumptions had been described as settled decisions. The revised instructions explicitly separate assumptions from owner approval.
Start with Archcore.
Keep your project decisions ready for the next task.