arcane-cli 0.34.0 → 0.34.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.
|
@@ -72,7 +72,7 @@ Arcane separates framework-level decisions from org-specific ones using two pref
|
|
|
72
72
|
2. Confirms no collision with other entities
|
|
73
73
|
3. Identifies any docs, scripts, or prompts that reference the old name
|
|
74
74
|
|
|
75
|
-
This check was added after [[
|
|
75
|
+
This check was added after [[docs/rcas/RCA-001-naming-collision|RCA-001]] discovered that ADR-061 named a product without checking whether the ops repo already used that name. **Enforcement: explicitly advisory prose (ARC-023) — no script or spell gate verifies that an ADR introducing a new name actually contains a "Naming impact" section or performed its three checks; `spell-scry` can run the grep-and-collision check manually, but nothing requires it before such an ADR is written.**
|
|
76
76
|
|
|
77
77
|
### Tier 2: Companion Detail Docs
|
|
78
78
|
|
|
@@ -38,7 +38,7 @@ An RCA is **recommended** (but optional) for:
|
|
|
38
38
|
|
|
39
39
|
## RCA Template
|
|
40
40
|
|
|
41
|
-
**Every RCA follows this structure. Artifacts are stored in `
|
|
41
|
+
**Every RCA follows this structure. Artifacts are stored in `docs/rcas/` with the filename `RCA-NNN-short-slug.md` (sequential numbering, matching the related ADR when applicable). Enforcement: explicitly advisory prose (ARC-023) — no script validates RCA filenames, sequential numbering, or template structure.**
|
|
42
42
|
|
|
43
43
|
```markdown
|
|
44
44
|
---
|
|
@@ -104,7 +104,7 @@ Bullet points — what the team now knows that it didn't before.
|
|
|
104
104
|
### 1. Initiate
|
|
105
105
|
|
|
106
106
|
When a trigger condition is met:
|
|
107
|
-
- Create the RCA artifact file in `
|
|
107
|
+
- Create the RCA artifact file in `docs/rcas/`
|
|
108
108
|
- Fill in the Incident Summary and Timeline sections
|
|
109
109
|
- Record the ADR that establishes the RCA (if applicable)
|
|
110
110
|
|
|
@@ -147,13 +147,13 @@ RCAs do not have formal severity levels. The trigger conditions above determine
|
|
|
147
147
|
## Artifact Location
|
|
148
148
|
|
|
149
149
|
```
|
|
150
|
-
|
|
150
|
+
docs/
|
|
151
151
|
rcas/
|
|
152
152
|
RCA-001-naming-collision.md
|
|
153
153
|
RCA-002-...
|
|
154
154
|
```
|
|
155
155
|
|
|
156
|
-
**Why `governance/rcas/`?** RCAs are governance artifacts (process improvement
|
|
156
|
+
**Why `docs/rcas/`, not `governance/rcas/`?** RCAs are project/domain documents (a record of what happened in *this* repository), not a framework-managed standard — [[portable-bootstrap#where-documents-live|portable-bootstrap.md's "Where Documents Live"]] reserves `.arcane/governance/` for framework-managed standards and explicitly forbids a duplicate root `governance/` tree; `docs/` is the same explicit-descriptive-path convention it names for project/domain documents. RCAs remain governance artifacts in *purpose* (process improvement, not a journal or a decision) — they complement ADRs by explaining *how a decision failed* rather than *what was decided* — just not in *filesystem location*. Enforcement: explicitly advisory prose (ARC-023) — no script checks that an RCA file actually lives under `docs/rcas/` rather than elsewhere.
|
|
157
157
|
|
|
158
158
|
## Maintenance
|
|
159
159
|
|