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.
- package/dist/assets/.arcane/governance/agent-work-queue-model.md +13 -13
- package/dist/assets/.arcane/governance/decision-documentation-standard.md +18 -18
- package/dist/assets/.arcane/governance/framework-decisions.md +71 -0
- package/dist/assets/.arcane/governance/git-conventions.md +1 -1
- package/dist/assets/.github/prompts/spell-todo.prompt.md +1 -1
- package/dist/index.js +8 -1
- package/dist/index.js.map +1 -1
- package/package.json +2 -1
|
@@ -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
|
|
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
|
|
35
|
-
|
|
36
|
-
| Queue ID
|
|
37
|
-
| Business
|
|
38
|
-
| Repo
|
|
39
|
-
| DevOps Item
|
|
40
|
-
| Priority
|
|
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
|
|
43
|
-
| Execution Host | Atlas, Voyager, Nimbus
|
|
44
|
-
| Approval Gate
|
|
45
|
-
| Exit Criteria
|
|
46
|
-
| Status
|
|
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
|
|
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-
|
|
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
|
|
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-
|
|
242
|
-
- [[DECISIONS#ADR-
|
|
243
|
-
- [[DECISIONS#ADR-
|
|
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
|
|
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-
|
|
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-
|
|
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",
|