arcane-cli 1.3.0 → 1.3.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md
CHANGED
|
@@ -247,7 +247,7 @@ Unlike spells, agent files are never delivered by `spell init` or `spell update`
|
|
|
247
247
|
|
|
248
248
|
```jsonc
|
|
249
249
|
// .arcane.json
|
|
250
|
-
{ "spell_scope": "user" } // absent, or "repo", means this repository carries its own spells
|
|
250
|
+
{ "spell_scope": "user" } // absent, or "repo", means this repository carries its own spells and agents
|
|
251
251
|
```
|
|
252
252
|
|
|
253
253
|
```bash
|
|
@@ -125,7 +125,12 @@ Arcane spells ship to other repositories and, eventually, open source. Keep them
|
|
|
125
125
|
hand. Relative links inside a spell resolve from `.arcane/spells/`, two levels below the repo
|
|
126
126
|
root (`../../.arcane/governance/…`, `../../README.md`); refer to a sibling spell as
|
|
127
127
|
`spell-x.md`. Enforcement: executable check (ARC-023) — `npm run check:self-host-parity`
|
|
128
|
-
re-renders every shim from its canonical file and fails CI on any byte of difference.
|
|
128
|
+
re-renders every shim from its canonical file and fails CI on any byte of difference. **A spell
|
|
129
|
+
may also be installed once per machine** at `~/.arcane/spells/<id>.md` (ARC-045 decision 3), where
|
|
130
|
+
a `../../` link has no repository to resolve against: write a spell so that a broken context link
|
|
131
|
+
degrades to a named, skippable step rather than a dead end, which D2 Gold already asks for in its
|
|
132
|
+
"works in a vanilla consuming repo with no Arcane context files present" bar. Enforcement:
|
|
133
|
+
explicitly advisory prose (ARC-023) — nothing resolves a spell's links from the user tier.
|
|
129
134
|
- **Never hard-code** an org name, person, venture, product, or machine name. Use a documented
|
|
130
135
|
`{UPPER_SNAKE}` placeholder: `{ADO_ORG}`, `{ADO_PROJECT}`, `{BUSINESS_NAME}`, `{OPERATOR_NAME}`.
|
|
131
136
|
Enforcement: executable check (ARC-023) — same mechanism as D2 Bronze above: the `org-token-lint`
|
|
@@ -160,4 +160,8 @@ client through a separate mechanism: one canonical source per spell at `.arcane/
|
|
|
160
160
|
(ARC-045), from which three thin shims are generated — `.github/prompts/*.prompt.md` for Copilot,
|
|
161
161
|
`.claude/commands/*.md` for Claude Code, and `.agents/skills/*/SKILL.md` for Codex (CS-01) — never
|
|
162
162
|
hand-authored per client. A shim carries no workflow of its own: when a spell must be read in full,
|
|
163
|
-
read the canonical file.
|
|
163
|
+
read the canonical file. Both spells and the agent roster can instead be installed once per machine,
|
|
164
|
+
at `~/.arcane` (ARC-045 decision 3, ARC-047); a repository with `spell_scope: "user"` in `.arcane.json`
|
|
165
|
+
carries neither its own spell files nor its own `.github/agents/*.agent.md`, and every client reads
|
|
166
|
+
the machine-wide copies instead. This table is unaffected either way — standing instructions never
|
|
167
|
+
move tier.
|