# OpenSpec assets

This package ships a `review-gated` OpenSpec schema/profile asset set.

The assets encode the package workflow contract:

- use codebase-memory-first discovery before ordinary subagent discovery;
- treat codebase-memory MCP as required for the full workflow and use exact file reads as degraded fallback only when codebase-memory is unavailable;
- run one holistic planning review before implementation;
- keep implementation review separate and explicit, with specialist review skills available as opt-in deep dives;
- stop implementation before explicit generated OpenSpec archive and never include git commit as a workflow step;
- reuse OpenSpec-generated sync/archive behavior instead of adding an archive wrapper skill;
- update or recommend codebase-memory ADR after landed changes with durable architecture impact.

## Architecture memory ownership

OpenSpec artifacts in `openspec/changes/**` are canonical for change-scoped proposal, requirements, design, and tasks. Keeping them in canonical paths also keeps them indexable by codebase-memory.

codebase-memory ADR owns durable project-level architecture summaries and conventions. ADR entries should summarize landed decisions and link to the relevant OpenSpec artifacts instead of copying change-scoped content.

Path-scoped guidance remains optional. Use it only when subtree-local conventions are not captured well by codebase-memory ADR.