@cr8rcho/alkahest 0.1.75 → 0.1.76

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/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@cr8rcho/alkahest",
3
- "version": "0.1.75",
3
+ "version": "0.1.76",
4
4
  "publishConfig": {
5
5
  "access": "public"
6
6
  },
@@ -3,15 +3,15 @@
3
3
 
4
4
  This repo keeps **as-built documentation** under `docs/` (four layers: system / components /
5
5
  features / modules — see docs/README.md) and **ADRs** under `docs/decisions/`. The writing
6
- instructions live in the account skills `as-built-docs` and `adr` — read them via the
6
+ instructions live in the account skills `alkahest/as-built-docs` and `alkahest/adr` — read them via the
7
7
  alkahest MCP `skills` tool before writing docs.
8
8
 
9
9
  1. **After finishing any code change, update the affected docs in the same session.**
10
- The layer mapping and the update checklist are in the `as-built-docs` skill. Write an
10
+ The layer mapping and the update checklist are in the `alkahest/as-built-docs` skill. Write an
11
11
  ADR only for decisions whose "why" a code diff cannot reconstruct (criteria and the
12
- template are in the `adr` skill).
12
+ template are in the `alkahest/adr` skill).
13
13
  2. **First documentation pass (repo has no docs yet)?** Follow the bootstrap protocol in
14
- the `as-built-docs` skill: one system map + 2–3 core modules + ADR-001 (architecture
14
+ the `alkahest/as-built-docs` skill: one system map + 2–3 core modules + ADR-001 (architecture
15
15
  snapshot) — small first, then mirror and hand the user the note-map link. Grow the rest
16
16
  incrementally with later work.
17
17
  3. **After changing `docs/`, mirror it to the hosted note maps** by running
@@ -3,8 +3,8 @@
3
3
  "name": "as-built docs",
4
4
  "description": "Living as-built documentation + an ADR log, written by your agent and mirrored to note maps.",
5
5
  "skills": [
6
- { "name": "as-built-docs", "file": "skills/as-built-docs.md" },
7
- { "name": "adr", "file": "skills/adr.md" }
6
+ { "name": "alkahest/as-built-docs", "file": "skills/as-built-docs.md" },
7
+ { "name": "alkahest/adr", "file": "skills/adr.md" }
8
8
  ],
9
9
  "scaffold": "scaffold",
10
10
  "snippet": "CLAUDE-snippet.md",
@@ -2,7 +2,7 @@
2
2
 
3
3
  This directory holds this repository's **as-built documentation** — documents that record
4
4
  how the system is actually built (never plans or PRDs). Writing instructions live in the
5
- `as-built-docs` account skill (read it via the alkahest MCP `skills` tool).
5
+ `alkahest/as-built-docs` account skill (read it via the alkahest MCP `skills` tool).
6
6
 
7
7
  ## Layers
8
8
 
@@ -2,7 +2,7 @@
2
2
 
3
3
  This folder collects **Architecture Decision Records** — the why / alternatives /
4
4
  trade-offs of decisions, frozen at decision time. Writing instructions and the template
5
- live in the `adr` account skill (read it via the alkahest MCP `skills` tool).
5
+ live in the `alkahest/adr` account skill (read it via the alkahest MCP `skills` tool).
6
6
 
7
7
  Quick rules:
8
8
 
@@ -1,4 +1,4 @@
1
- # adr — decision records
1
+ # alkahest/adr — decision records
2
2
 
3
3
  ADRs (`docs/decisions/NNN-kebab-title.md`) record the **why** of decisions: context,
4
4
  alternatives, trade-offs. They are a separate axis from as-built docs — as-built documents
@@ -1,4 +1,4 @@
1
- # as-built-docs — writing instructions
1
+ # alkahest/as-built-docs — writing instructions
2
2
 
3
3
  You are maintaining this repository's **as-built documentation**: documents that record how
4
4
  the system **is actually built**. Never plans, PRDs, or aspirations — present tense, code as
@@ -25,7 +25,7 @@ summary + link in the other.
25
25
  Title each document with a **classed H1**: `# System — <name>`, `# Component — <name>`,
26
26
  `# Feature — <name>`, `# Module — <name>`. The note-map mirror strips the class prefix,
27
27
  so the hosted note is titled just `<name>` while the file stays unambiguous in the repo.
28
- (ADRs have their own H1 shape — see the `adr` skill.)
28
+ (ADRs have their own H1 shape — see the `alkahest/adr` skill.)
29
29
 
30
30
  ## Bootstrap — when the repo has no docs yet
31
31
 
@@ -35,7 +35,7 @@ the user sees a map fast:
35
35
  1. `docs/system/<app>.md` — one system map: layers, data flow, key dependencies, honest
36
36
  Known Limitations.
37
37
  2. Two or three `docs/modules/*.md` for the load-bearing modules only.
38
- 3. One decision record (see the `adr` skill): **ADR-001, an architecture snapshot** — the
38
+ 3. One decision record (see the `alkahest/adr` skill): **ADR-001, an architecture snapshot** — the
39
39
  decisions already embedded in the current code.
40
40
  4. Add each document to the index in `docs/README.md`, then **mirror to the note maps and
41
41
  hand the user the map link** (the mirroring rule lives in this repo's CLAUDE.md).
@@ -52,7 +52,7 @@ code changes touch.
52
52
  - **As-built, present tense** — "this is how it is built." Cite real file paths, function
53
53
  names, and constants so readers can jump straight to code.
54
54
  - **Decision history is a separate axis** — why / alternatives / trade-offs belong in ADRs
55
- (`docs/decisions/`, see the `adr` skill), not in these documents.
55
+ (`docs/decisions/`, see the `alkahest/adr` skill), not in these documents.
56
56
  - **Known Limitations, honestly** — the most valuable section of a post-hoc document.
57
57
  Remove limitations you fixed; add the ones you introduced.
58
58
  - **Overwrite freely** — these documents always describe the present. (ADRs are the
@@ -4,7 +4,7 @@
4
4
  "id": "as-built",
5
5
  "name": "as-built docs",
6
6
  "description": "Living as-built documentation + an ADR log, written by your agent and mirrored to note maps.",
7
- "skills": ["as-built-docs", "adr"],
7
+ "skills": ["alkahest/as-built-docs", "alkahest/adr"],
8
8
  "maps": ["as-built", "adr"],
9
9
  "contents": ["skills", "scaffold", "claude-snippet", "sync-script"]
10
10
  }