archcore
Star Install
Menu
Experimental

Archcore + Superpowers

Give Superpowers your project’s decisions. Keep new decisions in Git with Archcore.

How Archcore + Superpowers work together

Start with either tool. These instructions tell your agent to read existing project decisions before design work and save new decisions in Archcore. Superpowers keeps its own plans; Archcore documents reference them.

Archcore ↗
Keeps project decisions, rules, and specs in Git for your agent to use.
Superpowers ↗
Guides design and implementation through its own skills and plans.

From a new idea to the next session

The instructions ask your agent to:

  1. Read existing decisions

    At the start of brainstorming, the agent searches Archcore for decisions and rules that apply to your task.

  2. Review the design before code

    Superpowers guides the design. If the task conflicts with an accepted decision, the agent asks you how to proceed.

  3. Keep the decisions you approve

    After design approval, the agent records decisions as draft architecture decision records (ADRs) in Archcore. Accepting an ADR needs your explicit approval.

  4. Continue with project context

    The next session can find the saved design and decisions. Superpowers keeps its implementation plans in the repository.

Starting with /archcore:plan? That command finishes first. Superpowers can pick up design or execution work it leaves open.

See benefits and limits →

Connect the two tools

1. Install Archcore and Superpowers

Install Archcore and Superpowers in the agent you use for this project.

2. Add instructions

CLAUDE.md / AGENTS.md / GEMINI.md 
### Archcore + Superpowers

Applies when both plugins are loaded. An instruction naming only Archcore tools applies in any session with those tools.

1. When the user names a skill or `/archcore:*` command, load that skill's own instructions and follow them rather than a summary.
2. After `/archcore:plan`, `/archcore:document`, `/archcore:review`, or `/archcore:init` is invoked, let that command finish before invoking `superpowers:brainstorming`.
3. When an `/archcore:*` command reports missing design or execution work, you may invoke the matching Superpowers skill with the command's prepared inputs.
4. When the user starts through a Superpowers skill, keep to that skill's steps instead of an `/archcore:*` command.
5. At the start of `superpowers:brainstorming`, call `search_documents` on the task topic before reading any repository file.
6. During `superpowers:brainstorming`, write no code, tests, or `.archcore/` records until the user approves a design file under `docs/superpowers/specs/`.
7. When `superpowers:brainstorming` writes a design file in a project with `.archcore/`, record the decisions it settles as `.archcore/**/*.adr.md`.
8. When `superpowers:writing-plans` covers work an `.archcore/**/*.spec.md` describes, set the plan's `Spec:` field to that path.
9. If a `docs/superpowers/plans/*.md` tracks the tasks of an `.archcore/**/*.plan.md`, report the overlap in the task result.
10. If a `docs/superpowers/plans/*.md` tracks the tasks of an `.archcore/**/*.plan.md`, keep the `.archcore/` plan as written.
11. When prior work in the task answers a question the active skill asks, do not ask it again.
12. If supplied material leaves a required input unanswered, ask for that input before writing the artifact.
13. Before recording a decision in `.archcore/`, call `search_documents` for an existing record.
14. Create every `.archcore/**/*.md` record with status `draft`.
15. Set status `accepted` on an `.archcore/**/*.md` record only after the user's explicit acceptance in the task.
16. If a task conflicts with an `accepted` `.archcore/**/*.adr.md`, report the conflict and stop for the user's decision.
17. If a document carries `read_only: true`, name its owning project instead of writing to it.
18. If more than one writable `.archcore/` is present, confirm the target project before writing a record.
19. If the project has no `.archcore/`, do not call `init_project` without the user's request.
20. If a Superpowers skill or Archcore tool the user names is unavailable, name the missing contribution in the task result.
21. If another connected recipe's instruction conflicts with an instruction here, report the conflict and preserve that recipe's applicable contribution.

3. Check in a new session

Start a new session in this project and ask your agent:

Confirm you can use Archcore and Superpowers, and have read this project’s cooperation instructions.

If the agent reports a missing tool or instruction file, finish that setup before starting work.

Benefits & limits

Catch conflicts before code.

The instructions bring existing project decisions into design work. You resolve conflicts before implementation and approve new decisions before they become accepted records.

Design with project context

Brainstorming starts with a search for relevant decisions and rules.

You approve the design before code is written.

Conflicting or shared decisions

A conflict with an accepted decision needs your input. Read-only documents stay with their owning project.

If several projects are writable, the agent confirms where to save a record.

A new session

Saved designs and decisions give the next session context to continue.

Unanswered design questions still need your input.

Two implementation plans

Superpowers keeps its detailed execution plan. The Archcore plan stays as written.

You maintain any overlapping tasks across the two plans.

Starting with /archcore:plan

The command finishes before brainstorming begins.

Superpowers can take on design or execution work the command leaves open.

Start with Archcore.

Keep your project decisions ready for the next task.

Install Archcore →See how it works

Archcore + Superpowers

Source & verification

Category
Workflow skills
Instruction revision
6a803fd32956
Source
Plugin repository · AGENTS.md · This revision is not published yet.
Maintainer
Archcore maintainers
Page updated
September 9, 2026

Verification

No joint run has been recorded for this instruction revision.

  • Instructions are copied from the Archcore + Superpowers section of AGENTS.md. CLAUDE.md imports that file.
  • This instruction revision has no linked verification record.
  • The recipe source is unpublished, so the text is pinned by digest rather than by an upstream revision.
  • Setup steps are written for five agents and checked on none of them.
  • Superpowers is not installed by this recipe. It has to be present and callable already.
  • This pair only. Two working pairs do not make a working triple.

Update or disconnect

To update, review changes to the instructions before replacing your copy. To disconnect, remove the added instructions from your project file. Both tools and their documents stay in place.