arcane-cli 0.15.5 → 0.15.6

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.
@@ -9,7 +9,7 @@ tags: [governance, queue, agents, work-management]
9
9
 
10
10
  # Agent Work Queue Model
11
11
 
12
- Defines a single markdown-first queue for assigning work across businesses, while keeping Azure DevOps at Story-level visibility per [[DECISIONS#ADR-015|ADR-015]].
12
+ Defines a single markdown-first queue for assigning work across businesses, while keeping Azure DevOps at Story-level visibility for human milestone tracking.
13
13
 
14
14
  ## Executive Summary
15
15
 
@@ -31,19 +31,19 @@ Defines a single markdown-first queue for assigning work across businesses, whil
31
31
 
32
32
  ## Canonical Fields
33
33
 
34
- | Field | Description |
35
- |------|-------------|
36
- | Queue ID | Unique work identifier |
37
- | Business | `acme-store`, `example-app`, etc. |
38
- | Repo | Target repo name |
39
- | DevOps Item | Story/Task/Bug link or ID |
40
- | Priority | Critical / High / Medium / Low |
34
+ | Field | Description |
35
+ | -------------- | ---------------------------------------------- |
36
+ | Queue ID | Unique work identifier |
37
+ | Business | `acme-store`, `example-app`, etc. |
38
+ | Repo | Target repo name |
39
+ | DevOps Item | Story/Task/Bug link or ID |
40
+ | Priority | Critical / High / Medium / Low |
41
41
  | Assigned Agent | {AGENT_NAME}, Lafayette, Mercurio, Lince, etc. |
42
- | Power Level | Apprentice/Wizard/Sorcerer/Magus/Archmage |
43
- | Execution Host | Atlas, Voyager, Nimbus |
44
- | Approval Gate | Required reviewer and checkpoint |
45
- | Exit Criteria | Objective definition of done |
46
- | Status | Backlog / Ready / In Progress / Blocked / Done |
42
+ | Power Level | Apprentice/Wizard/Sorcerer/Magus/Archmage |
43
+ | Execution Host | Atlas, Voyager, Nimbus |
44
+ | Approval Gate | Required reviewer and checkpoint |
45
+ | Exit Criteria | Objective definition of done |
46
+ | Status | Backlog / Ready / In Progress / Blocked / Done |
47
47
 
48
48
  ---
49
49
 
@@ -26,10 +26,10 @@ This document defines how significant decisions are documented in this repositor
26
26
 
27
27
  Arcane separates framework-level decisions from org-specific ones using two prefixes:
28
28
 
29
- | Prefix | File | Scope |
30
- | --------- | --------------------- | ------------------------------------------------------------------------------------ |
31
- | `ADR-NNN` | `DECISIONS.md` | Org-specific decisions (ventures, infrastructure, runtime config, org conventions) |
32
- | `ARC-NNN` | `arcane/DECISIONS.md` | Arcane framework decisions (spell library, CLI, agent system, governance templates) |
29
+ | Prefix | File | Scope |
30
+ | --------- | --------------------- | ----------------------------------------------------------------------------------- |
31
+ | `ADR-NNN` | `DECISIONS.md` | Org-specific decisions (ventures, infrastructure, runtime config, org conventions) |
32
+ | `ARC-NNN` | `arcane/DECISIONS.md` | Arcane framework decisions (spell library, CLI, agent system, governance templates) |
33
33
 
34
34
  **Rules:**
35
35
 
@@ -99,7 +99,7 @@ This check was added after [[governance/rcas/RCA-001-naming-collision|RCA-001]]
99
99
  **Create a companion doc if:**
100
100
 
101
101
  - Decision justification exceeds 5 bullets in "Reasoning" section
102
- - Multiple ADRs share a common theme (e.g., authentication strategy covers ADR-007, ADR-008, ADR-009, ADR-017)
102
+ - Multiple ADRs share a common theme (e.g., several authentication decisions belong in one authentication strategy)
103
103
  - Implementation has significant gotchas or edge cases
104
104
  - Decision has ongoing review/maintenance requirements (quarterly audits, version compatibility)
105
105
  - You anticipate "why did we do this?" questions from future team members or external auditors
@@ -115,13 +115,13 @@ This check was added after [[governance/rcas/RCA-001-naming-collision|RCA-001]]
115
115
 
116
116
  Use existing folder structure; **do not create `deep-dives/` or `DECISIONS-details/` folders**.
117
117
 
118
- | Decision Theme | Location | Example |
119
- | ------------------------------------ | ------------------ | --------------------------------------------------------------------------------------- |
120
- | Authentication, credentials, keys | `security/` | [security/authentication-strategy.md](../security/authentication-strategy.md) |
121
- | Hardware, OS, dual-boot | `infrastructure/` | [infrastructure/compute-architecture.md](../infrastructure/compute-architecture.md) |
122
- | Agent runtime config, agent policies | `agents/` | [agents/architecture-decisions.md](../agents/architecture-decisions.md) |
123
- | Git, naming, documentation standards | `governance/` | This file |
124
- | Business-specific operations | `ventures/{name}/` | `ventures/acme-store/DECISIONS.md`, `ventures/example-app/operations-model.md` |
118
+ | Decision Theme | Location | Example |
119
+ | ------------------------------------ | ------------------ | ----------------------------------------------------------------------------------- |
120
+ | Authentication, credentials, keys | `security/` | [security/authentication-strategy.md](../security/authentication-strategy.md) |
121
+ | Hardware, OS, dual-boot | `infrastructure/` | [infrastructure/compute-architecture.md](../infrastructure/compute-architecture.md) |
122
+ | Agent runtime config, agent policies | `agents/` | [agents/architecture-decisions.md](../agents/architecture-decisions.md) |
123
+ | Git, naming, documentation standards | `governance/` | This file |
124
+ | Business-specific operations | `ventures/{name}/` | `ventures/acme-store/DECISIONS.md`, `ventures/example-app/operations-model.md` |
125
125
 
126
126
  **Rationale:** Keeps security knowledge with security docs, infrastructure with infrastructure, etc. Easier to discover via folder browsing.
127
127
 
@@ -131,7 +131,7 @@ Use existing folder structure; **do not create `deep-dives/` or `DECISIONS-detai
131
131
 
132
132
  - ✅ `security/authentication-strategy.md` — covers SSH, PATs, API keys, tokens (multiple ADRs)
133
133
  - ✅ `infrastructure/compute-architecture.md` — covers dual-boot, Ubuntu choice, hardware sizing
134
- - ❌ `security/ADR-008-deep-dive.md` — Forces 1:1 mapping, harder to group related decisions
134
+ - ❌ `security/ADR-NNN-deep-dive.md` — Forces 1:1 mapping, harder to group related decisions
135
135
 
136
136
  **Filename format:** `{topic-slug}.md` (lowercase, hyphen-separated)
137
137
 
@@ -214,7 +214,7 @@ Add this section **after Reasoning, before Rejected alternatives** in the ADR:
214
214
  **Deep dive:** [[security/authentication-strategy|Authentication Strategy]]
215
215
  ```
216
216
 
217
- **Example from ADR-017:**
217
+ **Example from an authentication ADR:**
218
218
 
219
219
  ```markdown
220
220
  **Reasoning:**
@@ -238,12 +238,12 @@ Create "Related ADRs" section at the top of every companion doc:
238
238
  ```markdown
239
239
  ## Related ADRs
240
240
 
241
- - [[DECISIONS#ADR-007|ADR-007: Runtime Gateway Security]]
242
- - [[DECISIONS#ADR-008|ADR-008: Inter-Machine Communication]]
243
- - [[DECISIONS#ADR-017|ADR-017: Git SSH Authentication]]
241
+ - [[DECISIONS#ADR-NNN|Runtime Gateway Security decision]]
242
+ - [[DECISIONS#ADR-NNN|Inter-Machine Communication decision]]
243
+ - [[DECISIONS#ADR-NNN|Git SSH Authentication decision]]
244
244
  ```
245
245
 
246
- **Rationale:** Creates bidirectional graph edges in Obsidian visualization. Clicking ADR-017 shows link to authentication-strategy.md; clicking authentication-strategy.md shows all related ADRs.
246
+ **Rationale:** Creates bidirectional graph edges in Obsidian visualization. Clicking an ADR shows its authentication strategy companion; the companion links back to each related ADR.
247
247
 
248
248
  ---
249
249
 
@@ -0,0 +1,71 @@
1
+ ---
2
+ title: Legacy Framework Decision Reference
3
+ audience: both
4
+ status: active
5
+ distributable: true
6
+ tags: [decisions, adr, framework, references]
7
+ ---
8
+
9
+ # Legacy Framework Decision Reference
10
+
11
+ Arcane framework decisions now use the `ARC-NNN` sequence. The entries below preserve the legacy `ADR-NNN` identifiers still cited by distributed governance and spells so every installed citation resolves offline. Consumer repository decisions remain in the root `DECISIONS.md` and use their own local sequence.
12
+
13
+ ## ADR-002 — Documentation in Markdown and Git
14
+
15
+ Keep operational documentation in reviewable, version-controlled Markdown alongside the work it governs.
16
+
17
+ ## ADR-011 — Troubleshooting Standard
18
+
19
+ Troubleshooting guidance uses Symptom, Cause, Fix, Verify, and Prevention sections so remediation is reproducible.
20
+
21
+ ## ADR-019 — Spell Prompt Naming
22
+
23
+ Arcane workflow prompts use the `spell-` prefix to make their purpose and invocation surface explicit.
24
+
25
+ ## ADR-028 — Agent Git Attribution Model
26
+
27
+ The content producer is the commit author, the approving operator is the committer, and agent-authored commits carry attribution trailers.
28
+
29
+ ## ADR-029 — Canonical Commit Metadata Schema
30
+
31
+ Agent commits use stable `Agent`, `Model`, and `Provider` trailers, with optional role, task, channel, and approval metadata.
32
+
33
+ ## ADR-031 — Agent Role Consolidation
34
+
35
+ Agent identities represent durable roles rather than framework-specific technology stacks.
36
+
37
+ ## ADR-032 — Context-Dependent Agent Power Levels
38
+
39
+ Agent autonomy is assigned per agent and repository through the Spectator-to-Archmage ladder.
40
+
41
+ ## ADR-034 — Actionable Recommendation Guardrails
42
+
43
+ Recommendations involving cost, accounts, subscriptions, or irreversible action require disclosure, current verification, alternatives, and proportionate approval.
44
+
45
+ ## ADR-048 — Code Versus Docs Branch Policy
46
+
47
+ Code repositories use protected integration branches and reviewed PRs. A genuinely local-only documentation repository may integrate a reviewed docs change with a local fast-forward when no remote PR path exists.
48
+
49
+ ## ADR-049 — Spell Loop
50
+
51
+ Arcane's lifecycle is plan, architect, implement, test, review, and ship, with session and operational spells supporting the loop.
52
+
53
+ ## ADR-050 — Testing Standards
54
+
55
+ Projects select stack-appropriate test tooling and enforce coverage and critical-path evidence before shipping.
56
+
57
+ ## ADR-051 — Infrastructure Agent Ownership
58
+
59
+ The infrastructure role owns CI/CD, deployment automation, and platform operations while remaining subject to repository authority gates.
60
+
61
+ ## ADR-052 — Product Excellence Standards
62
+
63
+ PRD enhancement uses explicit quality dimensions and profile-dependent Bronze, Silver, and Gold targets.
64
+
65
+ ## ADR-061 — Arcane Framework Identity
66
+
67
+ Arcane is a four-layer methodology composed of Spells, Governance, Agents, and the CLI.
68
+
69
+ ## ADR-068 — Root Cause Analysis Standard
70
+
71
+ Material incidents receive structured root cause analysis with evidence, corrective actions, prevention, and follow-up ownership.
@@ -167,7 +167,7 @@ Use `git add -p` or selective staging to separate unrelated changes that were ed
167
167
  ```bash
168
168
  # Stage only the files related to one logical change
169
169
  git add governance/new-standard.md DECISIONS.md CLAUDE.md
170
- git commit -m "docs(governance): add new-standard with ADR-053"
170
+ git commit -m "docs(governance): add new-standard with ADR-NNN"
171
171
 
172
172
  # Then stage the unrelated fix
173
173
  git add README.md
@@ -67,7 +67,7 @@ Expand the idea into one or more concrete TODO items. Each item must:
67
67
 
68
68
  If the idea naturally decomposes into multiple sub-items (e.g., "build dashboard" → design, implement, deploy, document), list them individually — do not bundle vague compound items.
69
69
 
70
- If the idea is an `adr-candidate`, also draft a one-sentence ADR title suggestion (e.g., `ADR-027: Use GitHub Actions for CI instead of Azure Pipelines`).
70
+ If the idea is an `adr-candidate`, also draft a one-sentence ADR title suggestion (e.g., `ADR-NNN: Use GitHub Actions for CI instead of Azure Pipelines`).
71
71
 
72
72
  ## Step 3 — Route to the Right Document
73
73
 
package/dist/index.js CHANGED
@@ -134,7 +134,7 @@ var PROFILE_CONFIGS = [
134
134
  id: "lite",
135
135
  displayName: "Essentials",
136
136
  description: "Spells + core governance \u2014 fast start",
137
- components: ["spell-prompts", "claude-commands", "agent-output-instructions", "git-conventions", "testing-standards", "session-continuity"]
137
+ components: ["spell-prompts", "claude-commands", "agent-output-instructions", "git-conventions", "testing-standards", "framework-decisions", "session-continuity"]
138
138
  },
139
139
  {
140
140
  id: "methodology",
@@ -146,6 +146,7 @@ var PROFILE_CONFIGS = [
146
146
  "agent-output-instructions",
147
147
  "git-conventions",
148
148
  "testing-standards",
149
+ "framework-decisions",
149
150
  "session-continuity",
150
151
  "decision-documentation-standard",
151
152
  "agent-work-queue-model",
@@ -161,6 +162,7 @@ var PROFILE_CONFIGS = [
161
162
  "agent-output-instructions",
162
163
  "git-conventions",
163
164
  "testing-standards",
165
+ "framework-decisions",
164
166
  "decision-documentation-standard",
165
167
  "agent-work-queue-model",
166
168
  "naming-conventions",
@@ -203,6 +205,11 @@ var COMPONENTS = [
203
205
  description: "Testing framework selection, coverage thresholds, and CI gates",
204
206
  files: [".arcane/governance/testing-standards.md"]
205
207
  },
208
+ {
209
+ name: "framework-decisions",
210
+ description: "Offline reference for legacy framework ADR citations",
211
+ files: [".arcane/governance/framework-decisions.md"]
212
+ },
206
213
  {
207
214
  name: "decision-documentation-standard",
208
215
  description: "ADR format and decision-logging conventions",